Plugin MySQL

Panoramica

I parametri di configurazione consentono di personalizzare il comportamento del plugin MySQL.

Si consiglia di specificarli in un file di configurazione separato (ad esempio mysql.conf), anziché nel file di configurazione di agent 2. Quindi usare la direttiva Include per includere questo file nella configurazione di Zabbix agent 2.

Tutti i parametri sono opzionali, a meno che non sia esplicitamente indicato che il parametro è obbligatorio.

Si noti che:

  • I valori predefiniti riflettono i valori predefiniti del processo, non i valori presenti nei file di configurazione forniti;
  • I valori supportano le variabili di ambiente;
  • Zabbix supporta i file di configurazione solo in codifica UTF-8 senza BOM;
  • I commenti che iniziano con "#" sono supportati solo all'inizio della riga.

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

Parametri

Parameter Mandatory Range Default Description
Plugins.Mysql.CallTimeout no 1-30 global timeout Il tempo massimo, in secondi, di attesa affinché una richiesta venga completata.
Plugins.Mysql.CustomQueriesPath no /usr/local/share/zabbix/custom-queries/mysql per sistemi Unix

*:\Program Files\Zabbix Agent 2\Custom Queries\Mysql per sistemi Windows, dove * è il nome dell'unità dalla variabile di ambiente ProgramFiles
Percorso completo di una directory contenente file .sql con query personalizzate.
Plugins.Mysql.CustomQueriesEnabled no false Se impostato, abilita l'esecuzione della chiave item mysql.custom.query. Se disabilitato, non verrà caricato alcun query dalla directory delle query personalizzate.
Plugins.Mysql.Default.Password no Password predefinita per la connessione a MySQL; usata se non viene specificato alcun valore in una chiave item o in una sessione denominata.
Plugins.Mysql.Default.TLSCAFile no
(yes, if Plugins.Mysql.Default.TLSConnect is set to verify_ca or verify_full)
Percorso completo di un file contenente i certificati della CA di livello superiore per la verifica del certificato del peer nelle comunicazioni cifrate tra Zabbix agent 2 e i database monitorati; usato se non viene specificato alcun valore in una sessione denominata.
Plugins.Mysql.Default.TLSCertFile no
(yes, if Plugins.Mysql.Default.TLSConnect is set to verify_ca or verify_full)
Percorso completo di un file contenente il certificato dell'agent o la catena di certificati per le comunicazioni cifrate tra Zabbix agent 2 e i database monitorati; usato se non viene specificato alcun valore in una sessione denominata.
Plugins.Mysql.Default.TLSConnect no Tipo di cifratura per le comunicazioni tra Zabbix agent 2 e i database monitorati; usato se non viene specificato alcun valore in una sessione denominata.

Valori supportati:
required - richiede una connessione TLS;
verify_ca - verifica i certificati;
verify_full - verifica i certificati e l'indirizzo IP.
Plugins.Mysql.Default.TLSKeyFile no
(yes, if Plugins.Mysql.Default.TLSConnect is set to verify_ca or verify_full)
Percorso completo di un file contenente la chiave privata del database per le comunicazioni cifrate tra Zabbix agent 2 e i database monitorati; usato se non viene specificato alcun valore in una sessione denominata.
Plugins.Mysql.Default.Uri no tcp://localhost:3306 URI predefinito per la connessione a MySQL; usato se non viene specificato alcun valore in una chiave item o in una sessione denominata.

Non deve includere credenziali incorporate (verranno ignorate).
Deve corrispondere al formato URI.
Schemi supportati: tcp, unix; uno schema può essere omesso.
Una porta può essere omessa (default=3306).
Esempi: tcp://localhost:3306
localhost
unix:/var/run/mysql.sock
Plugins.Mysql.Default.User no Nome utente predefinito per la connessione a MySQL; usato se non viene specificato alcun valore in una chiave item o in una sessione denominata.
Plugins.Mysql.KeepAlive no 60-900 300 Il tempo massimo di attesa, in secondi, prima che le connessioni del plugin non utilizzate vengano chiuse.
Plugins.Mysql.Sessions.<SessionName>.Password no Password della sessione denominata.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi item.
Plugins.Mysql.Sessions.<SessionName>.TLSCAFile no
(yes, if Plugins.Mysql.Sessions.<SessionName>.TLSConnect is set to verify_ca or verify_full)
Percorso completo di un file contenente i certificati della CA di livello superiore per la verifica del certificato del peer, usato per le comunicazioni cifrate tra Zabbix agent 2 e i database monitorati.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi item.
Plugins.Mysql.Sessions.<SessionName>.TLSCertFile yes, if Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile is specified Percorso completo di un file contenente il certificato dell'agent o la catena di certificati, usato per le comunicazioni cifrate tra Zabbix agent 2 e i database monitorati.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi item.
Plugins.Mysql.Sessions.<SessionName>.TLSConnect no Tipo di cifratura per le comunicazioni tra Zabbix agent 2 e i database monitorati.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi item.

Valori supportati:
required - richiede una connessione TLS;
verify_ca - verifica i certificati;
verify_full - verifica i certificati e l'indirizzo IP.
Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile yes, if Plugins.Mysql.Sessions.<SessionName>.TLSCertFile is specified Percorso completo di un file contenente la chiave privata del database usata per le comunicazioni cifrate tra Zabbix agent 2 e i database monitorati.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi item.
Plugins.Mysql.Sessions.<SessionName>.Uri no Stringa di connessione di una sessione denominata.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi item.

Non deve includere credenziali incorporate (verranno ignorate).
Deve corrispondere al formato URI.
Schemi supportati: tcp, unix; uno schema può essere omesso.
Una porta può essere omessa (default=3306).
Esempi: tcp://localhost:3306
localhost
unix:/var/run/mysql.sock
Plugins.Mysql.Sessions.<SessionName>.User no Nome utente della sessione denominata.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi item.
Plugins.Mysql.Timeout no 1-30 global timeout Il tempo massimo, in secondi, di attesa quando è necessario stabilire una connessione.

Vedi anche: