- Plugin MySQL
- Parameter details
- Plugins.Mysql.CallTimeout
- Plugins.Mysql.CustomQueriesPath
- Plugins.Mysql.CustomQueriesEnabled
- Plugins.Mysql.Default.Password
- Plugins.Mysql.Default.TLSConnect
- Plugins.Mysql.Default.TLSCAFile
- Plugins.Mysql.Default.TLSCertFile
- Plugins.Mysql.Default.TLSKeyFile
- Plugins.Mysql.Default.Uri
- Plugins.Mysql.Default.User
- Plugins.Mysql.KeepAlive
- Plugins.Mysql.Sessions.<SessionName>.Password
- Plugins.Mysql.Sessions.<SessionName>.TLSConnect
- Plugins.Mysql.Sessions.<SessionName>.TLSCAFile
- Plugins.Mysql.Sessions.<SessionName>.TLSCertFile
- Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile
- Plugins.Mysql.Sessions.<SessionName>.Uri
- Plugins.Mysql.Sessions.<SessionName>.User
- Plugins.Mysql.Timeout
- Parâmetros
Plugin MySQL
Visão geral
Os parâmetros de configuração permitem personalizar o comportamento do plugin MySQL.
Recomenda-se especificá-los em seu próprio arquivo de configuração (por exemplo, mysql.conf), em vez de no arquivo de configuração do agent 2. Em seguida, use a diretiva Include para incluir esse arquivo na configuração do Zabbix agent 2.
Todos os parâmetros são opcionais, a menos que seja explicitamente indicado que o parâmetro é obrigatório.
Observe que:
- Os valores padrão refletem os padrões do processo, não os valores nos arquivos de configuração fornecidos;
- Os valores suportam variáveis de ambiente;
- O Zabbix suporta arquivos de configuração somente em codificação UTF-8 sem BOM;
- Comentários que começam com "#" são suportados apenas no início da linha.
Parameter details
Plugins.Mysql.CallTimeout
Specify the maximum amount of time in seconds to wait for a request to be done.
Default: default timeout
Range: 1-30
Plugins.Mysql.CustomQueriesPath
Specify full pathname of the directory containing .sql files with custom queries.
Defaults:/usr/local/share/zabbix/custom-queries/mysql - for Unix systems,*:\Program Files\Zabbix Agent 2\Custom Queries\Mysql - for Windows systems (where * is the drive name from the ProgramFiles environment variable)
Plugins.Mysql.CustomQueriesEnabled
Enable execution of the mysql.custom.query item key.
If disabled, no queries will be loaded from the custom query directory path.
Default: false
Range: true/false
Plugins.Mysql.Default.Password
Specify the default password for a protected MySQL server.
Plugins.Mysql.Default.TLSConnect
Specify the default level of encryption for communications between Zabbix agent 2 and monitored databases.
Range:
required - require TLS connection;
verify_ca - verify certificates;
verify_full - verify certificates and IP address
Plugins.Mysql.Default.TLSCAFile
Specify full pathname of the file containing top-level CA(s) certificates for peer certificate verification, used for encrypted communications between Zabbix agent 2 and monitored databases.
Mandatory: yes, if Plugins.Mysql.Default.TLSConnect is set to verify_ca or verify_full
Plugins.Mysql.Default.TLSCertFile
Specify full pathname of the file containing the agent certificate or certificate chain, used for encrypted communications between Zabbix agent 2 and monitored databases.
Mandatory: yes, if Plugins.Mysql.Default.TLSKeyFile is specified
Plugins.Mysql.Default.TLSKeyFile
Specify full pathname of the file containing the database private key, used for encrypted communications between Zabbix agent 2 and monitored databases.
Mandatory: yes, if Plugins.Mysql.Default.TLSCertFile is specified
Plugins.Mysql.Default.Uri
Specify the default URI for connecting to MySQL server.
Embedded credentials will be ignored.
Supported schemes: tcp, unix
The schema can be omitted.
The port can be omitted (default=3306).
Examples:
tcp://localhost:3306
localhost
unix:/var/run/mysql.sock
Plugins.Mysql.Default.User
Specify the default username for a protected MySQL server.
Plugins.Mysql.KeepAlive
Specify the maximum time of waiting (in seconds) before unused plugin connections are closed.
Default: 300
Range: 60-900
Plugins.Mysql.Sessions.<SessionName>.Password
Specify the named session password for a protected MySQL server.
<SessionName> - define name of a session for using in item keys.
Plugins.Mysql.Sessions.<SessionName>.TLSConnect
Specify the level of named-session encryption for communications between Zabbix agent 2 and monitored databases.
<SessionName> - define name of a session for using in item keys.
Range:
required - require TLS connection;
verify_ca - verify certificates;
verify_full - verify certificates and IP address
Plugins.Mysql.Sessions.<SessionName>.TLSCAFile
Specify full pathname of the file containing top-level CA(s) certificates for named-session peer certificate verification, used for encrypted communications between Zabbix agent 2 and monitored databases.
<SessionName> - define name of a session for using in item keys.
Mandatory: yes, if Plugins.Mysql.Sessions.<SessionName>.TLSConnect is set to verify_ca or verify_full
Plugins.Mysql.Sessions.<SessionName>.TLSCertFile
Specify full pathname of the file containing the named-session agent certificate or certificate chain, used for encrypted communications between Zabbix agent 2 and monitored databases.
<SessionName> - define name of a session for using in item keys.
Mandatory: yes, if Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile is specified
Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile
Specify full pathname of the file containing the named-session database private key, used for encrypted communications between Zabbix agent 2 and monitored databases.
<SessionName> - define name of a session for using in item keys.
Mandatory: yes, if Plugins.Mysql.Sessions.<SessionName>.TLSCertFile is specified
Plugins.Mysql.Sessions.<SessionName>.Uri
Specify the named session URI for connecting to MySQL server.
<SessionName> - define name of a session for using in item keys.
Embedded credentials will be ignored.
Supported schemes: tcp, unix
The schema can be omitted.
The port can be omitted (default=3306).
Examples:
tcp://localhost:3306
localhost
unix:/var/run/mysql.sock
Plugins.Mysql.Sessions.<SessionName>.User
Specify the named session username for a protected MySQL server.
<SessionName> - define name of a session for using in item keys.
Plugins.Mysql.Timeout
Set the maximum time in seconds for waiting when a connection has to be established.
Default: default timeout
Range: 1-30
Parâmetros
| Parameter | Mandatory | Range | Default | Description |
|---|---|---|---|---|
| Plugins.Mysql.CallTimeout | no | 1-30 | global timeout | O tempo máximo, em segundos, para aguardar a conclusão de uma solicitação. |
| Plugins.Mysql.CustomQueriesPath | no | /usr/local/share/zabbix/custom-queries/mysql for Unix systems*:\Program Files\Zabbix Agent 2\Custom Queries\Mysql for Windows systems, where * is the drive name from the ProgramFiles environment variable |
Caminho completo de um diretório que contém arquivos .sql com consultas personalizadas. |
|
| Plugins.Mysql.CustomQueriesEnabled | no | false | Se definido, habilita a execução da chave de item mysql.custom.query. Se desabilitado, nenhuma consulta será carregada do caminho do diretório de consultas personalizadas. |
|
| Plugins.Mysql.Default.Password | no | Senha padrão para conexão com MySQL; usada se nenhum valor for especificado em uma chave de item ou sessão nomeada. | ||
| Plugins.Mysql.Default.TLSCAFile | no (yes, if Plugins.Mysql.Default.TLSConnect is set to verify_ca or verify_full) |
Caminho completo de um arquivo que contém os certificados da CA de nível superior para verificação do certificado do par em comunicações criptografadas entre o Zabbix agent 2 e os bancos de dados monitorados; usado se nenhum valor for especificado em uma sessão nomeada. | ||
| Plugins.Mysql.Default.TLSCertFile | no (yes, if Plugins.Mysql.Default.TLSConnect is set to verify_ca or verify_full) |
Caminho completo de um arquivo que contém o certificado do agent ou a cadeia de certificados para comunicações criptografadas entre o Zabbix agent 2 e os bancos de dados monitorados; usado se nenhum valor for especificado em uma sessão nomeada. | ||
| Plugins.Mysql.Default.TLSConnect | no | Tipo de criptografia para comunicações entre o Zabbix agent 2 e os bancos de dados monitorados; usado se nenhum valor for especificado em uma sessão nomeada. Valores suportados: required - exigir conexão TLS; verify_ca - verificar certificados; verify_full - verificar certificados e endereço IP. |
||
| Plugins.Mysql.Default.TLSKeyFile | no (yes, if Plugins.Mysql.Default.TLSConnect is set to verify_ca or verify_full) |
Caminho completo de um arquivo que contém a chave privada do banco de dados para comunicações criptografadas entre o Zabbix agent 2 e os bancos de dados monitorados; usado se nenhum valor for especificado em uma sessão nomeada. | ||
| Plugins.Mysql.Default.Uri | no | tcp://localhost:3306 | URI padrão para conexão com MySQL; usado se nenhum valor for especificado em uma chave de item ou sessão nomeada. Não deve incluir credenciais embutidas (elas serão ignoradas). Deve corresponder ao formato de URI. Esquemas suportados: tcp, unix; um esquema pode ser omitido.Uma porta pode ser omitida (padrão=3306). Exemplos: tcp://localhost:3306localhostunix:/var/run/mysql.sock |
|
| Plugins.Mysql.Default.User | no | Nome de usuário padrão para conexão com MySQL; usado se nenhum valor for especificado em uma chave de item ou sessão nomeada. | ||
| Plugins.Mysql.KeepAlive | no | 60-900 | 300 | O tempo máximo de espera (em segundos) antes que conexões de plugin não utilizadas sejam encerradas. |
| Plugins.Mysql.Sessions.<SessionName>.Password | no | Senha da sessão nomeada. <SessionName> - define o nome de uma sessão para uso em chaves de item. |
||
| Plugins.Mysql.Sessions.<SessionName>.TLSCAFile | no (yes, if Plugins.Mysql.Sessions.<SessionName>.TLSConnect is set to verify_ca or verify_full) |
Caminho completo de um arquivo que contém os certificados da CA de nível superior para verificação do certificado do par, usado para comunicações criptografadas entre o Zabbix agent 2 e os bancos de dados monitorados. <SessionName> - define o nome de uma sessão para uso em chaves de item. |
||
| Plugins.Mysql.Sessions.<SessionName>.TLSCertFile | yes, if Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile is specified | Caminho completo de um arquivo que contém o certificado do agent ou a cadeia de certificados, usado para comunicações criptografadas entre o Zabbix agent 2 e os bancos de dados monitorados. <SessionName> - define o nome de uma sessão para uso em chaves de item. |
||
| Plugins.Mysql.Sessions.<SessionName>.TLSConnect | no | Tipo de criptografia para comunicações entre o Zabbix agent 2 e os bancos de dados monitorados. <SessionName> - define o nome de uma sessão para uso em chaves de item. Valores suportados: required - exigir conexão TLS; verify_ca - verificar certificados; verify_full - verificar certificados e endereço IP. |
||
| Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile | yes, if Plugins.Mysql.Sessions.<SessionName>.TLSCertFile is specified | Caminho completo de um arquivo que contém a chave privada do banco de dados usada para comunicações criptografadas entre o Zabbix agent 2 e os bancos de dados monitorados. <SessionName> - define o nome de uma sessão para uso em chaves de item. |
||
| Plugins.Mysql.Sessions.<SessionName>.Uri | no | String de conexão de uma sessão nomeada. <SessionName> - define o nome de uma sessão para uso em chaves de item. Não deve incluir credenciais embutidas (elas serão ignoradas). Deve corresponder ao formato de URI. Esquemas suportados: tcp, unix; um esquema pode ser omitido.Uma porta pode ser omitida (padrão=3306). Exemplos: tcp://localhost:3306localhostunix:/var/run/mysql.sock |
||
| Plugins.Mysql.Sessions.<SessionName>.User | no | Nome de usuário da sessão nomeada. <SessionName> - define o nome de uma sessão para uso em chaves de item. |
||
| Plugins.Mysql.Timeout | no | 1-30 | global timeout | O tempo máximo, em segundos, de espera quando uma conexão precisa ser estabelecida. |
Veja também:
- Descrição dos parâmetros gerais de configuração do Zabbix agent 2: Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
- Instruções para configurar plugins