Wtyczka MySQL

Omówienie

Parametry konfiguracyjne umożliwiają dostosowanie działania wtyczki MySQL.

Zaleca się określanie ich w osobnym pliku konfiguracyjnym (np. mysql.conf), a nie w pliku konfiguracyjnym agent 2. Następnie należy użyć dyrektywy Include, aby dołączyć ten plik do konfiguracji Zabbix agent 2.

Wszystkie parametry są opcjonalne, chyba że wyraźnie zaznaczono, że dany parametr jest obowiązkowy.

Należy pamiętać, że:

  • Wartości domyślne odzwierciedlają domyślne ustawienia procesu, a nie wartości w dostarczonych plikach konfiguracyjnych;
  • Wartości obsługują zmienne środowiskowe;
  • Zabbix obsługuje pliki konfiguracyjne wyłącznie w kodowaniu UTF-8 bez BOM;
  • Komentarze zaczynające się od "#" są obsługiwane tylko na początku wiersza.

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

Parametry

Parameter Mandatory Range Default Description
Plugins.Mysql.CallTimeout no 1-30 global timeout Maksymalny czas oczekiwania w sekundach na zakończenie żądania.
Plugins.Mysql.CustomQueriesPath no /usr/local/share/zabbix/custom-queries/mysql dla systemów Unix

*:\Program Files\Zabbix Agent 2\Custom Queries\Mysql dla systemów Windows, gdzie * jest nazwą dysku z zmiennej środowiskowej ProgramFiles
Pełna ścieżka do katalogu zawierającego pliki .sql z niestandardowymi zapytaniami.
Plugins.Mysql.CustomQueriesEnabled no false Jeśli ustawione, włącza wykonywanie klucza pozycji mysql.custom.query. Jeśli wyłączone, żadne zapytania nie będą ładowane z katalogu niestandardowych zapytań.
Plugins.Mysql.Default.Password no Domyślne hasło do łączenia z MySQL; używane, jeśli w kluczu pozycji lub nazwanej sesji nie podano żadnej wartości.
Plugins.Mysql.Default.TLSCAFile no
(yes, if Plugins.Mysql.Default.TLSConnect is set to verify_ca or verify_full)
Pełna ścieżka do pliku zawierającego certyfikaty głównych urzędów CA do weryfikacji certyfikatu drugiej strony w szyfrowanej komunikacji między Zabbix agent 2 a monitorowanymi bazami danych; używane, jeśli w nazwanej sesji nie podano żadnej wartości.
Plugins.Mysql.Default.TLSCertFile no
(yes, if Plugins.Mysql.Default.TLSConnect is set to verify_ca or verify_full)
Pełna ścieżka do pliku zawierającego certyfikat agenta lub łańcuch certyfikatów do szyfrowanej komunikacji między Zabbix agent 2 a monitorowanymi bazami danych; używane, jeśli w nazwanej sesji nie podano żadnej wartości.
Plugins.Mysql.Default.TLSConnect no Typ szyfrowania komunikacji między Zabbix agent 2 a monitorowanymi bazami danych; używane, jeśli w nazwanej sesji nie podano żadnej wartości.

Obsługiwane wartości:
required - wymagaj połączenia TLS;
verify_ca - weryfikuj certyfikaty;
verify_full - weryfikuj certyfikaty i adres IP.
Plugins.Mysql.Default.TLSKeyFile no
(yes, if Plugins.Mysql.Default.TLSConnect is set to verify_ca or verify_full)
Pełna ścieżka do pliku zawierającego klucz prywatny bazy danych do szyfrowanej komunikacji między Zabbix agent 2 a monitorowanymi bazami danych; używane, jeśli w nazwanej sesji nie podano żadnej wartości.
Plugins.Mysql.Default.Uri no tcp://localhost:3306 Domyślny URI do łączenia z MySQL; używane, jeśli w kluczu pozycji lub nazwanej sesji nie podano żadnej wartości.

Nie powinien zawierać osadzonych poświadczeń (zostaną zignorowane).
Musi być zgodny z formatem URI.
Obsługiwane schematy: tcp, unix; schemat można pominąć.
Port można pominąć (domyślnie=3306).
Przykłady: tcp://localhost:3306
localhost
unix:/var/run/mysql.sock
Plugins.Mysql.Default.User no Domyślna nazwa użytkownika do łączenia z MySQL; używane, jeśli w kluczu pozycji lub nazwanej sesji nie podano żadnej wartości.
Plugins.Mysql.KeepAlive no 60-900 300 Maksymalny czas oczekiwania (w sekundach) przed zamknięciem nieużywanych połączeń wtyczki.
Plugins.Mysql.Sessions.<SessionName>.Password no Hasło nazwanej sesji.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.Mysql.Sessions.<SessionName>.TLSCAFile no
(yes, if Plugins.Mysql.Sessions.<SessionName>.TLSConnect is set to verify_ca or verify_full)
Pełna ścieżka do pliku zawierającego certyfikaty głównych urzędów CA do weryfikacji certyfikatu drugiej strony, używana do szyfrowanej komunikacji między Zabbix agent 2 a monitorowanymi bazami danych.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.Mysql.Sessions.<SessionName>.TLSCertFile yes, if Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile is specified Pełna ścieżka do pliku zawierającego certyfikat agenta lub łańcuch certyfikatów, używana do szyfrowanej komunikacji między Zabbix agent 2 a monitorowanymi bazami danych.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.Mysql.Sessions.<SessionName>.TLSConnect no Typ szyfrowania komunikacji między Zabbix agent 2 a monitorowanymi bazami danych.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.

Obsługiwane wartości:
required - wymagaj połączenia TLS;
verify_ca - weryfikuj certyfikaty;
verify_full - weryfikuj certyfikaty i adres IP.
Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile yes, if Plugins.Mysql.Sessions.<SessionName>.TLSCertFile is specified Pełna ścieżka do pliku zawierającego prywatny klucz bazy danych używany do szyfrowanej komunikacji między Zabbix agent 2 a monitorowanymi bazami danych.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.Mysql.Sessions.<SessionName>.Uri no Łańcuch połączenia nazwanej sesji.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.

Nie powinien zawierać osadzonych poświadczeń (zostaną zignorowane).
Musi być zgodny z formatem URI.
Obsługiwane schematy: tcp, unix; schemat można pominąć.
Port można pominąć (domyślnie=3306).
Przykłady: tcp://localhost:3306
localhost
unix:/var/run/mysql.sock
Plugins.Mysql.Sessions.<SessionName>.User no Nazwa użytkownika nazwanej sesji.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.Mysql.Timeout no 1-30 global timeout Maksymalny czas oczekiwania w sekundach na nawiązanie połączenia.

Zobacz także: