[comment]: # translation:outdated

[comment]: # ({new-f957ad95})
# 7 MySQL plugin

[comment]: # ({/new-f957ad95})

[comment]: # ({7e8aa5c3-7e8aa5c3})
#### 概述

本节列出了Zabbix agent 2的MySQL插件配置文件(mysql.conf)中所有支持的参数。请注意：

- 默认值表示的是进程默认值，而不是附带的配置文件中的值；
- Zabbix 仅支持不带[BOM](https://en.wikipedia.org/wiki/Byte_order_mark)的 UTF-8 编码的配置文件；
- 仅支持在行首以"\#"开头的注释。

[comment]: # ({/7e8aa5c3-7e8aa5c3})

[comment]: # ({bebe09e4-b9c98913})
#### 参数

|参数|是否必须|范围|默认值|描述|
|---------|--------|--------|-------|--------|
|Plugins.Mysql.CallTimeout|否|1-30|全局超时时间|等待请求完成的最长时间（秒）。|
|Plugins.Mysql.KeepAlive|否|60-900|300|在关闭未使用的插件连接之前等待的最长时间（以秒为单位）。|
|Plugins.Mysql.Sessions.<SessionName>.Password|否|<|<|设置会话的密码。<br>**<SessionName>** - 在监控项键值中使用的会话名称|
|Plugins.Mysql.Sessions.<SessionName>.TLSCAFile|否|<|<|包含用于对等证书验证的顶级 CA 证书的文件的完整路径名，用于 Zabbix agent 2 和受监控数据库之间的加密通信。<br>**<SessionName>** - 在监控项键值中使用的会话名称。|
|Plugins.Mysql.Sessions.<SessionName>.TLSCertFile|否|<|<|包含代理证书或证书链的文件的完整路径名，用于 Zabbix agent 2 和受监控数据库之间的加密通信。<br>**<SessionName>** - 在监控项键值中使用的会话名称。|
|Plugins.Mysql.Sessions.<SessionName>.TLSConnect|否|<|<|Zabbix agent 2 和被监控数据库之间通信的加密类型。<br>**<SessionName>** - 在监控项键值中使用的会话名称。<br><br>接受值:<br>*required* - 需要 TLS 连接；<br>*verify\_ca* - 验证证书；<br>*verify\_full* - 验证证书和 IP 地址。|
|Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile|否|<|<|包含数据库私钥的文件的完整路径名，用于Zabbix agent 2和受监控数据库之间的加密通信。<br>**<SessionName>** - 在监控项键值中使用的会话名称。|
|Plugins.Mysql.Sessions.<SessionName>.Uri|否|<|tcp://localhost:3306|设置会话的连接字符串。<br>**<SessionName>** - 在监控项键值中使用的会话名称。<br><br>不应包含嵌入的凭据（它们将被忽略）。<br>必须与 URI 格式匹配。<br>支持的协议：`tcp`、`unix`；可以省略协议（自版本5.2.3起）。<br>可以省略端口(default=3306)。<br>示例：`tcp://localhost:3306`<br>`localhost`<br>`unix:/var/run/mysql.sock`|
|Plugins.Mysql.Sessions.<SessionName>.User|否|<|<|设置会话的用户名。<br>**<SessionName>** - 在监控项键值中使用的会话名称。|
|Plugins.Mysql.Timeout|否|1-30|全局超时时间|请求执行超时（在关闭之前等待请求完成的时间）。|

另请参阅：

-   通用Zabbix agent 2配置参数说明:
    [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /
    [Zabbix agent 2 (Windows)](/manual/appendix/config/zabbix_agent2_win)
-   配置[插件](/manual/config/items/plugins)的说明

[comment]: # ({/bebe09e4-b9c98913})
