Oracle 插件

概述

配置参数可用于自定义 Oracle 插件的行为。

建议将这些参数指定在它们自己的配置文件中（例如 oracle.conf），而不是放在 agent 2 配置文件中。然后使用 Include 指令将此文件包含到 Zabbix agent 2 配置中。

除非明确说明该参数为必填，否则所有参数均为可选。

本页结构如下：

• 参数概览（要查看某个参数的完整详情，请单击其名称）
• 参数详情

请注意：

• 默认值反映的是进程默认值，而不是随软件包提供的配置文件中的值。
• 值支持环境变量。
• Zabbix 仅支持 UTF-8 编码且不带 BOM 的配置文件。
• 以 "#" 开头的注释仅支持位于行首。

参数详情

Plugins.Oracle.CallTimeout

指定请求完成的最大等待时间（秒）。

默认值：default timeout
范围：1-30

插件.Oracle.ConnectTimeout

指定建立连接的最大等待时间（秒）。

默认值：default timeout
范围：1-30

Plugins.Oracle.CustomQueriesPath

指定包含自定义查询 .sql 文件的目录完整路径。

默认值：
/usr/local/share/zabbix/custom-queries/oracle - 适用于 Unix 系统，
*:\Program Files\Zabbix Agent 2\Custom Queries\Oracle - 适用于 Windows 系统（其中 * 是 ProgramFiles 环境变量中的驱动器名称）

示例：

/etc/zabbix/oracle/sql

Plugins.Oracle.CustomQueriesEnabled

启用 oracle.custom.query 监控项键的执行。
如果禁用，则不会从自定义查询目录路径加载任何查询。

默认值：false
范围：true/false

Plugins.Oracle.Default.Password

指定用于连接 Oracle 的默认密码。
当监控项键或命名会话中未指定值时使用。

插件.Oracle.Default.Service

指定用于连接 Oracle 的默认服务名称（不支持 SID）。
当监控项键或命名会话中未指定值时使用。

Plugins.Oracle.Default.Uri

指定用于连接 Oracle 的默认 URI。
当监控项键值或命名会话中未指定值时使用。
嵌入的凭据将被忽略。
必须符合 URI 格式。
支持的 scheme：tcp、tcps
可以省略 schema。
可以省略端口（默认值=1521）。
也可以将 TNS key 或 TNS value 作为连接字符串指定。TNS value 必须在不包含空白字符的情况下组成。

示例：

tcp://127.0.0.1:1521
localhost
zbx_tns_example (TNS key)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (TNS value)

插件.Oracle.Default.User

指定用于连接 Oracle 的默认用户名。
当监控项键或命名会话中未指定值时使用。

Plugins.Oracle.KeepAlive

设置在关闭未使用的插件连接之前的最长等待时间（秒）。

默认值：300
范围：60-900

Plugins.Oracle.ResolveTNS

指定如何解释用于连接 Oracle 服务器的连接字符串（ConnString）。
如果将其设置为 false，则会向 ConnString 添加默认协议和端口（如果缺失）。
如果将该选项设置为 true，则会省略默认协议和端口（除非在 ConnString 中明确指定），并且 ConnString 将按原样传递给 Oracle 客户端。如果 Oracle 客户端在 tnsnames.ora 文件中找到 ConnString，则将使用找到的连接描述来连接 Oracle 服务器。

默认值：true
范围：true/false

Plugins.Oracle.Sessions.<SessionName>.Password

指定用于连接 Oracle 的命名会话密码。
<SessionName> - 定义一个会话名称，用于监控项键中。

Plugins.Oracle.Sessions.<SessionName>.Service

指定用于连接 Oracle 的命名会话服务名（不支持 SID）。
<SessionName> - 定义一个会话名称，用于监控项键中。

Plugins.Oracle.Sessions.<SessionName>.Uri

指定用于连接 Oracle 的命名会话 URI。
<SessionName> - 定义一个会话名称，用于监控项键值中。
嵌入的凭据将被忽略。
必须符合 URI 格式。
支持的 scheme：tcp、tcps
可以省略 schema。
可以省略端口（默认值=1521）。
也可以将 TNS key 或 TNS value 作为连接字符串指定。TNS value 必须在不包含空白字符的情况下组成。

示例：

tcp://127.0.0.1:1521
localhost
zbx_tns_example (TNS key)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (TNS value)

Plugins.Oracle.Sessions.<SessionName>.User

指定用于连接 Oracle 的命名会话用户名。
<SessionName> - 定义一个会话名称，用于监控项键中。

另请参阅

• 常规 Zabbix agent 2 配置参数说明：Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
• 配置 插件 的说明