MySQL 插件

概述

配置参数可用于自定义 MySQL plugin 的行为。

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

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

本页结构如下：

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

请注意：

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

参数详情

Plugins.Mysql.CallTimeout

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

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

Plugins.Mysql.CustomQueriesPath

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

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

Plugins.Mysql.CustomQueriesEnabled

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

默认值：false
范围：true/false

Plugins.Mysql.Default.Password

指定受保护的 MySQL 服务器的默认密码。

Plugins.Mysql.Default.TLSConnect

指定 Zabbix agent 2 与受监控数据库之间通信的默认加密级别。

范围：
required - 要求 TLS 连接；
verify_ca - 验证证书；
verify_full - 验证证书和 IP 地址

Plugins.Mysql.Default.TLSCAFile

指定包含用于对等证书验证的顶级 CA 证书的文件完整路径名，用于 Zabbix agent 2 与受监控数据库之间的加密通信。

必填：yes，如果 Plugins.Mysql.Default.TLSConnect 设置为 verify_ca 或 verify_full

Plugins.Mysql.Default.TLSCertFile

指定包含 agent 证书或证书链的文件完整路径，用于 Zabbix agent 2 与受监控数据库之间的加密通信。

必填：yes，如果已指定 Plugins.Mysql.Default.TLSKeyFile

Plugins.Mysql.Default.TLSKeyFile

指定包含数据库私钥的文件的完整路径名，用于 Zabbix agent 2 与被监控数据库之间的加密通信。

必填：如果指定了 Plugins.Mysql.Default.TLSCertFile，则为 yes

Plugins.Mysql.Default.Uri

指定用于连接 MySQL 服务器的默认 URI。
嵌入的凭据将被忽略。
支持的方案：tcp、unix
可以省略 schema。
可以省略端口（默认值=3306）。

示例：

tcp://localhost:3306
localhost
unix:/var/run/mysql.sock

Plugins.Mysql.Default.User

指定受保护的 MySQL 服务器的默认用户名。

Plugins.Mysql.KeepAlive

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

默认值：300
范围：60-900

Plugins.Mysql.Sessions.<SessionName>.Password

为受保护的 MySQL 服务器指定命名会话密码。
<SessionName> - 定义用于监控项键中的会话名称。

Plugins.Mysql.Sessions.<SessionName>.TLSConnect

指定 Zabbix agent 2 与被监控数据库之间通信所使用的命名会话加密级别。
<SessionName> - 定义用于监控项键中的会话名称。

范围：
required - 要求 TLS 连接；
verify_ca - 验证证书；
verify_full - 验证证书和 IP 地址

Plugins.Mysql.Sessions.<SessionName>.TLSCAFile

指定包含顶级 CA 证书的文件完整路径名，用于命名会话的对等证书验证，适用于 Zabbix agent 2 与被监控数据库之间的加密通信。
<SessionName> - 定义一个会话名称，用于监控项键值中。

必填：yes，如果 Plugins.Mysql.Sessions.<SessionName>.TLSConnect 设置为 verify_ca 或 verify_full

Plugins.Mysql.Sessions.<SessionName>.TLSCertFile

指定包含命名会话 agent 证书或证书链的文件完整路径，用于 Zabbix agent 2 与受监控数据库之间的加密通信。
<SessionName> - 定义一个会话名称，用于监控项键值中。

必需：yes，如果指定了 Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile

Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile

指定包含命名会话数据库私钥的文件完整路径，用于 Zabbix agent 2 与受监控数据库之间的加密通信。
<SessionName> - 定义一个会话名称，用于监控项键中。

必填：yes，如果已指定 Plugins.Mysql.Sessions.<SessionName>.TLSCertFile

Plugins.Mysql.Sessions.<SessionName>.Uri

指定用于连接 MySQL 服务器的命名会话 URI。
<SessionName> - 定义一个会话名称，用于监控项键值中。
嵌入的凭据将被忽略。
支持的 scheme：tcp、unix
可以省略 schema。
可以省略端口（默认值=3306）。

示例：

tcp://localhost:3306
localhost
unix:/var/run/mysql.sock

Plugins.Mysql.Sessions.<SessionName>.User

为受保护的 MySQL 服务器指定命名会话的用户名。
<SessionName> - 定义用于监控项键中的会话名称。

Plugins.Mysql.Timeout

设置建立连接时的最长等待时间（秒）。

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

另请参阅

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