- 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
- Parametri
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:3306localhostunix:/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:3306localhostunix:/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:
- Descrizione dei parametri di configurazione generali di Zabbix agent 2: Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
- Istruzioni per configurare i plugins