11 Oracle 插件

概述

本节列出了 Oracle Zabbix agent 2 插件配置文件（oracle.conf）中支持的参数。

请注意：

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

参数

Parameter Mandatory Range Default Description
Plugins.Oracle.CallTimeout no 1-30 global timeout 请求完成前的最长等待时间（秒）。
Plugins.Oracle.ConnectTimeout no 1-30 global timeout 建立连接前的最长等待时间（秒）。
Plugins.Oracle.CustomQueriesPath no Unix 系统为 /usr/local/share/zabbix/custom-queries/oracle

Windows 系统为 *:\Program Files\Zabbix Agent 2\Custom Queries\Oracle，其中 * 是 ProgramFiles 环境变量中的驱动器名称		 包含自定义查询 .sql 文件的目录完整路径。
示例：/etc/zabbix/oracle/sql
Plugins.Oracle.CustomQueriesEnabled no false 如果设置，则启用 oracle.custom.query 监控项键的执行。若禁用，则不会从自定义查询目录路径加载任何查询。
Plugins.Oracle.Default.Password no 连接 Oracle 的默认密码；如果监控项键或命名会话中未指定值，则使用此密码。
Plugins.Oracle.Default.Service no 连接 Oracle 的默认服务名（不支持 SID）；如果监控项键或命名会话中未指定值，则使用此服务名。
Plugins.Oracle.Default.Uri no tcp://localhost:1521 连接 Oracle 的默认 URI；如果监控项键或命名会话中未指定值，则使用此 URI。

不应包含内嵌凭据（它们将被忽略）。
必须符合 URI 格式。
仅支持 tcp scheme；scheme 可以省略。
端口可以省略（默认值=1521）。
自 Zabbix 7.4.3 起，也可以将 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.Default.User no 连接 Oracle 的默认用户名；如果监控项键或命名会话中未指定值，则使用此用户名。
Plugins.Oracle.KeepAlive no 60-900 300 关闭未使用的插件连接前的最长等待时间（秒）。
Plugins.Oracle.ResolveTNS no true / false false 该选项指定在指标键 commonParams 中如何解释用于连接 Oracle 服务器的连接字符串（ConnString）。
如果设置为 false，则会向 ConnString 添加默认 schema 和端口（如果缺失）。如果设置为 true，则默认 schema 和端口将被省略（除非在 ConnString 中显式指定），并且 ConnString 将原样传递给 Oracle 客户端。如果 Oracle 客户端在 tnsnames.ora 文件中找到 ConnString，则会使用找到的连接描述来连接 Oracle 服务器。
此参数自 Zabbix 7.4.3 起受支持。
Plugins.Oracle.Sessions.<SessionName>.Password no 命名会话密码。
<SessionName> - 定义用于监控项键中的会话名称。
Plugins.Oracle.Sessions.<SessionName>.Service no 用于连接的命名会话服务名（不支持 SID）。
<SessionName> - 定义用于监控项键中的会话名称。
Plugins.Oracle.Sessions.<SessionName>.Uri no Oracle 的命名会话连接字符串。
<SessionName> - 定义用于监控项键中的会话名称。

不应包含内嵌凭据（它们将被忽略）。
必须符合 URI 格式。
仅支持 tcp scheme；scheme 可以省略。
端口可以省略（默认值=1521）。
自 Zabbix 7.4.3 起，也可以将 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 no 命名会话用户名。
<SessionName> - 定义用于监控项键中的会话名称。

另请参阅：