9 MySQL 插件

概述

Zabbix agent 2 的配置文件用于配置插件。以下 Zabbix agent 2 配置参数支持用于运行 MySQL 插件。

建议在其各自的配置文件中指定这些参数（例如 mysql.conf），然后使用 Include 指令将此文件添加到 Zabbix agent 2 配置中。

请注意：

  • 默认值反映的是进程默认值，而不是随附配置文件中的值；
  • 这些值支持环境变量；
  • Zabbix 仅支持采用 UTF-8 编码且不带 BOM 的配置文件；
  • 仅支持以“#”开头且位于行首的注释。

参数

Parameter Mandatory Range Default Description
Plugins.Mysql.CallTimeout 否 1-30 全局超时 等待请求完成的最长时间（秒）。
Plugins.Mysql.CustomQueriesPath 否 Unix 系统为 /usr/local/share/zabbix/custom-queries/mysql

Windows 系统为 *:\Program Files\Zabbix Agent 2\Custom Queries\Mysql，其中 * 是来自 ProgramFiles 环境变量的驱动器名称		 包含自定义查询 .sql 文件的目录的完整路径名。
Plugins.Mysql.CustomQueriesEnabled 否 false 如果设置，则启用 mysql.custom.query 监控项键的执行。如果禁用，则不会从自定义查询目录路径加载任何查询。
Plugins.Mysql.Default.Password 否 连接到 MySQL 的默认密码；如果在监控项键或命名会话中未指定值，则使用该值。
Plugins.Mysql.Default.TLSCAFile 否
（如果 Plugins.Mysql.Default.TLSConnect 设置为 verify_ca 或 verify_full，则为是）		 包含顶级 CA 证书的文件的完整路径名，用于对等证书验证，以实现 Zabbix agent 2 与被监控数据库之间加密通信；如果在命名会话中未指定值，则使用该值。
Plugins.Mysql.Default.TLSCertFile 否
（如果 Plugins.Mysql.Default.TLSConnect 设置为 verify_ca 或 verify_full，则为是）		 包含 agent 证书或证书链的文件的完整路径名，用于 Zabbix agent 2 与被监控数据库之间的加密通信；如果在命名会话中未指定值，则使用该值。
Plugins.Mysql.Default.TLSConnect 否 Zabbix agent 2 与被监控数据库之间通信的加密类型；如果在命名会话中未指定值，则使用该值。

支持的值：
required - 要求使用 TLS 连接；
verify_ca - 验证证书；
verify_full - 验证证书和 IP 地址。
Plugins.Mysql.Default.TLSKeyFile 否
（如果 Plugins.Mysql.Default.TLSConnect 设置为 verify_ca 或 verify_full，则为是）		 包含数据库私钥的文件的完整路径名，用于 Zabbix agent 2 与被监控数据库之间的加密通信；如果在命名会话中未指定值，则使用该值。
Plugins.Mysql.Default.Uri 否 tcp://localhost:3306 连接到 MySQL 的默认 URI；如果在监控项键或命名会话中未指定值，则使用该值。

不应包含嵌入式凭据（它们将被忽略）。
必须符合 URI 格式。
支持的方案：tcp、unix；方案可省略。
端口可省略（默认值 = 3306）。
示例：tcp://localhost:3306
localhost
unix:/var/run/mysql.sock
Plugins.Mysql.Default.User 否 连接到 MySQL 的默认用户名；如果在监控项键或命名会话中未指定值，则使用该值。
Plugins.Mysql.KeepAlive 否 60-900 300 未使用的插件连接在关闭前的最长等待时间（秒）。
Plugins.Mysql.Sessions.<SessionName>.Password 否 命名会话密码。
<SessionName> - 定义用于监控项键中的会话名称。
Plugins.Mysql.Sessions.<SessionName>.TLSCAFile 否
（如果 Plugins.Mysql.Sessions.<SessionName>.TLSConnect 设置为 verify_ca 或 verify_full，则为是）		 包含顶级 CA 证书的文件的完整路径名，用于对等证书验证，以实现 Zabbix agent 2 与被监控数据库之间的加密通信。
<SessionName> - 定义用于监控项键中的会话名称。
Plugins.Mysql.Sessions.<SessionName>.TLSCertFile 是，如果指定了 Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile 包含 agent 证书或证书链的文件的完整路径名，用于 Zabbix agent 2 与被监控数据库之间的加密通信。
<SessionName> - 定义用于监控项键中的会话名称。
Plugins.Mysql.Sessions.<SessionName>.TLSConnect 否 Zabbix agent 2 与被监控数据库之间通信的加密类型。
<SessionName> - 定义用于监控项键中的会话名称。

支持的值：
required - 要求使用 TLS 连接；
verify_ca - 验证证书；
verify_full - 验证证书和 IP 地址。
Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile 是，如果指定了 Plugins.Mysql.Sessions.<SessionName>.TLSCertFile 包含数据库私钥的文件的完整路径名，用于 Zabbix agent 2 与被监控数据库之间的加密通信。
<SessionName> - 定义用于监控项键中的会话名称。
Plugins.Mysql.Sessions.<SessionName>.Uri 否 命名会话的连接字符串。
<SessionName> - 定义用于监控项键中的会话名称。

不应包含嵌入式凭据（它们将被忽略）。
必须符合 URI 格式。
支持的方案：tcp、unix；方案可省略。
端口可省略（默认值 = 3306）。
示例：tcp://localhost:3306
localhost
unix:/var/run/mysql.sock
Plugins.Mysql.Sessions.<SessionName>.User 否 命名会话用户名。
<SessionName> - 定义用于监控项键中的会话名称。
Plugins.Mysql.Timeout 否 1-30 全局超时 建立连接时的最长等待时间（秒）。

另请参见：