Documentation
Table of Contents
7 MySQL plugin
Overview
This section lists parameters supported in the MySQL Zabbix agent 2 plugin configuration file (mysql.conf). Note that:
- The default values reflect process defaults, not the values in the shipped configuration files;
- Zabbix supports configuration files only in UTF-8 encoding without BOM;
- Comments starting with "#" are only supported at the beginning of the line.
Parameters
| Parameter | Mandatory | Range | Default | Description |
|---|---|---|---|---|
| Plugins.Mysql.CallTimeout | no | 1-30 | global timeout | The maximum amount of time in seconds to wait for a request to be done. |
| Plugins.Mysql.KeepAlive | no | 60-900 | 300 | The maximum time of waiting (in seconds) before unused plugin connections are closed. |
| Plugins.Mysql.Sessions.<SessionName>.Password | no | Named session password. <SessionName> - name of a session for using in item keys. |
||
| Plugins.Mysql.Sessions.<SessionName>.TLSCAFile | no | Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification, used for encrypted communications between Zabbix agent 2 and monitored databases. <SessionName> - name of a session for using in item keys. |
||
| Plugins.Mysql.Sessions.<SessionName>.TLSCertFile | no | Full pathname of a file containing the agent certificate or certificate chain, used for encrypted communications between Zabbix agent 2 and monitored databases. <SessionName> - name of a session for using in item keys. |
||
| Plugins.Mysql.Sessions.<SessionName>.TLSConnect | no | Encryption type for communications between Zabbix agent 2 and monitored databases. <SessionName> - name of a session for using in item keys. Accepted values: required - require TLS connection; verify_ca - verify certificates; verify_full - verify certificates and IP address. |
||
| Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile | no | Full pathname of a file containing the database private key used for encrypted communications between Zabbix agent 2 and monitored databases. <SessionName> - name of a session for using in item keys. |
||
| Plugins.Mysql.Sessions.<SessionName>.Uri | no | tcp://localhost:3306 | Connection string of a named session. <SessionName> - name of a session for using in item keys. Should not include embedded credentials (they will be ignored). Must match the URI format. Supported schemes: tcp, unix; a scheme can be omitted (since version 5.2.3).A port can be omitted (default=3306). Examples: tcp://localhost:3306localhostunix:/var/run/mysql.sock |
|
| Plugins.Mysql.Sessions.<SessionName>.User | no | Named session username. <SessionName> - name of a session for using in item keys. |
||
| Plugins.Mysql.Timeout | no | 1-30 | global timeout | Request execution timeout (how long to wait for a request to complete before shutting it down). |
See also:
- Description of general Zabbix agent 2 configuration parameters: Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
- Instructions for configuring plugins