Complemento de MySQL

Resumen

Los parámetros de configuración permiten personalizar el comportamiento del plugin de MySQL.

Se recomienda especificarlos en su propio archivo de configuración (por ejemplo, mysql.conf), en lugar de en el archivo de configuración de agent 2. Luego use la directiva Include para incluir este archivo en la configuración de Zabbix agent 2.

Todos los parámetros son opcionales, salvo que se indique explícitamente que el parámetro es obligatorio.

Tenga en cuenta lo siguiente:

  • Los valores predeterminados reflejan los valores predeterminados del proceso, no los valores de los archivos de configuración suministrados;
  • Los valores admiten variables de entorno;
  • Zabbix solo admite archivos de configuración en codificación UTF-8 sin BOM;
  • Los comentarios que comienzan con "#" solo se admiten al principio de la línea.

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 El tiempo máximo, en segundos, que se esperará a que se complete una solicitud.
Plugins.Mysql.CustomQueriesPath no /usr/local/share/zabbix/custom-queries/mysql para sistemas Unix

*:\Program Files\Zabbix Agent 2\Custom Queries\Mysql para sistemas Windows, donde * es el nombre de la unidad de la variable de entorno ProgramFiles
Ruta completa de un directorio que contiene archivos .sql con consultas personalizadas.
Plugins.Mysql.CustomQueriesEnabled no false Si se establece, habilita la ejecución de la clave de item mysql.custom.query. Si está deshabilitado, no se cargarán consultas desde la ruta del directorio de consultas personalizadas.
Plugins.Mysql.Default.Password no Contraseña predeterminada para conectarse a MySQL; se usa si no se especifica ningún valor en una clave de item o sesión con nombre.
Plugins.Mysql.Default.TLSCAFile no
(yes, if Plugins.Mysql.Default.TLSConnect is set to verify_ca or verify_full)
Ruta completa de un archivo que contiene los certificados de la(s) CA de nivel superior para la verificación del certificado del par en comunicaciones cifradas entre Zabbix agent 2 y las bases de datos monitorizadas; se usa si no se especifica ningún valor en una sesión con nombre.
Plugins.Mysql.Default.TLSCertFile no
(yes, if Plugins.Mysql.Default.TLSConnect is set to verify_ca or verify_full)
Ruta completa de un archivo que contiene el certificado del agent o la cadena de certificados para comunicaciones cifradas entre Zabbix agent 2 y las bases de datos monitorizadas; se usa si no se especifica ningún valor en una sesión con nombre.
Plugins.Mysql.Default.TLSConnect no Tipo de cifrado para las comunicaciones entre Zabbix agent 2 y las bases de datos monitorizadas; se usa si no se especifica ningún valor en una sesión con nombre.

Valores admitidos:
required - requiere conexión TLS;
verify_ca - verificar certificados;
verify_full - verificar certificados y dirección IP.
Plugins.Mysql.Default.TLSKeyFile no
(yes, if Plugins.Mysql.Default.TLSConnect is set to verify_ca or verify_full)
Ruta completa de un archivo que contiene la clave privada de la base de datos para comunicaciones cifradas entre Zabbix agent 2 y las bases de datos monitorizadas; se usa si no se especifica ningún valor en una sesión con nombre.
Plugins.Mysql.Default.Uri no tcp://localhost:3306 URI predeterminada para conectarse a MySQL; se usa si no se especifica ningún valor en una clave de item o sesión con nombre.

No debe incluir credenciales incrustadas (se ignorarán).
Debe coincidir con el formato URI.
Esquemas admitidos: tcp, unix; se puede omitir un esquema.
Se puede omitir un puerto (predeterminado=3306).
Ejemplos: tcp://localhost:3306
localhost
unix:/var/run/mysql.sock
Plugins.Mysql.Default.User no Nombre de usuario predeterminado para conectarse a MySQL; se usa si no se especifica ningún valor en una clave de item o sesión con nombre.
Plugins.Mysql.KeepAlive no 60-900 300 Tiempo máximo de espera (en segundos) antes de cerrar las conexiones del plugin que no se estén utilizando.
Plugins.Mysql.Sessions.<SessionName>.Password no Contraseña de la sesión con nombre.
<SessionName> - define el nombre de una sesión para usarlo en las claves de item.
Plugins.Mysql.Sessions.<SessionName>.TLSCAFile no
(yes, if Plugins.Mysql.Sessions.<SessionName>.TLSConnect is set to verify_ca or verify_full)
Ruta completa de un archivo que contiene los certificados de la(s) CA de nivel superior para la verificación del certificado del par, usado para comunicaciones cifradas entre Zabbix agent 2 y las bases de datos monitorizadas.
<SessionName> - define el nombre de una sesión para usarlo en las claves de item.
Plugins.Mysql.Sessions.<SessionName>.TLSCertFile yes, if Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile is specified Ruta completa de un archivo que contiene el certificado del agent o la cadena de certificados, usado para comunicaciones cifradas entre Zabbix agent 2 y las bases de datos monitorizadas.
<SessionName> - define el nombre de una sesión para usarlo en las claves de item.
Plugins.Mysql.Sessions.<SessionName>.TLSConnect no Tipo de cifrado para las comunicaciones entre Zabbix agent 2 y las bases de datos monitorizadas.
<SessionName> - define el nombre de una sesión para usarlo en las claves de item.

Valores admitidos:
required - requiere conexión TLS;
verify_ca - verificar certificados;
verify_full - verificar certificados y dirección IP.
Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile yes, if Plugins.Mysql.Sessions.<SessionName>.TLSCertFile is specified Ruta completa de un archivo que contiene la clave privada de la base de datos usada para comunicaciones cifradas entre Zabbix agent 2 y las bases de datos monitorizadas.
<SessionName> - define el nombre de una sesión para usarlo en las claves de item.
Plugins.Mysql.Sessions.<SessionName>.Uri no Cadena de conexión de una sesión con nombre.
<SessionName> - define el nombre de una sesión para usarlo en las claves de item.

No debe incluir credenciales incrustadas (se ignorarán).
Debe coincidir con el formato URI.
Esquemas admitidos: tcp, unix; se puede omitir un esquema.
Se puede omitir un puerto (predeterminado=3306).
Ejemplos: tcp://localhost:3306
localhost
unix:/var/run/mysql.sock
Plugins.Mysql.Sessions.<SessionName>.User no Nombre de usuario de la sesión con nombre.
<SessionName> - define el nombre de una sesión para usarlo en las claves de item.
Plugins.Mysql.Timeout no 1-30 global timeout El tiempo máximo, en segundos, de espera cuando se debe establecer una conexión.

Ver también: