Wtyczka Redis

Omówienie

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

Zaleca się określanie ich we własnym pliku konfiguracyjnym (np. redis.conf), a nie w pliku konfiguracyjnym agenta 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 zawarte w dostarczonych plikach konfiguracyjnych.
  • Wartości obsługują zmienne środowiskowe.
  • Zabbix obsługuje pliki konfiguracyjne wyłącznie w kodowaniu UTF-8 bez BOM.
  • Komentarze rozpoczynające się od "#" są obsługiwane tylko na początku wiersza.

Parameter details

Plugins.Redis.Default.Password

Specify the default password for connecting to Redis.
Used if no value is specified in an item key or named session.

Plugins.Redis.Default.TLSConnect

Specify the level of encryption required for Zabbix agent 2 communications.
An empty or unset value is treated as no TLS.

Range: required - encrypted, unverified (only for testing), verify_ca - encrypted, server certificate, verify_full - encrypted, server certificate and server name verified with SAN

Plugins.Redis.Default.TLSCAFile

Specify full pathname of the file containing the top-level CA(s) certificates.

Plugins.Redis.Default.TLSCertFile

Specify full pathname of the file containing the agent certificate.

Plugins.Redis.Default.TLSKeyFile

Specify full pathname of the file containing the agent private key.

Plugins.Redis.Default.Uri

Specify the default URI for connecting to Redis.
Used if no value is specified in an item key or named session.
Embedded credentials will be ignored. Must match the URI format.
Supported schemes: tcp, unix
A scheme can be omitted.
A port can be omitted (default=6379).

Default: tcp://localhost:6379

Examples:

tcp://localhost:6379
localhost
unix:/var/run/redis.sock
Plugins.Redis.Default.User

Specify the default username for connecting to Redis.
Used if no value is specified in an item key or named session.

Default: default

Plugins.Redis.KeepAlive

Set the maximum time of waiting (in seconds) before unused plugin connections are closed.

Default: 300 Range: 60-900

Plugins.Redis.Sessions.<SessionName>.Password

Specify the named session password for connecting to Redis.
<SessionName> - define the session name to be used in item keys.

Plugins.Redis.Sessions.<SessionName>.TLSConnect

Specify the level of encryption required for Zabbix agent 2 communications for named session.
<SessionName> - define the session name to be used in item keys.
An empty or unset value is treated as no TLS.

Range: required - encrypted, unverified (only for testing), verify_ca - encrypted, server certificate, verify_full - encrypted, server certificate and server name verified with SAN

Plugins.Redis.Sessions.<SessionName>.TLSCAFile

Specify full pathname of the file containing the top-level CA(s) certificates for named session.
<SessionName> - define the session name to be used in item keys.

Mandatory: yes, if Plugins.Redis.Sessions.<SessionName>.TLSConnect is set to verify_ca or verify_full

Plugins.Redis.Sessions.<SessionName>.TLSCertFile

Specify full pathname of the file containing containing the agent certificate for named session.
<SessionName> - define the session name to be used in item keys.

Plugins.Redis.Sessions.<SessionName>.TLSKeyFile

Specify full pathname of the file containing the agent private key for named session.
<SessionName> - define the session name to be used in item keys.

Plugins.Redis.Sessions.<SessionName>.Uri

Specify the named session URI for connecting to Redis.
<SessionName> - define the session name to be used in item keys.
Embedded credentials will be ignored. Must match the URI format.
Supported schemes: tcp, unix
A scheme can be omitted.
A port can be omitted (default=6379).

Default: tcp://localhost:6379

Examples:

tcp://localhost:6379
localhost
unix:/var/run/redis.sock
Plugins.Redis.Sessions.<SessionName>.User

Specify the named session username for connecting to Redis.
<SessionName> - define the session name to be used in item keys.

Plugins.Redis.Timeout

Set the request execution timeout (the duration, in seconds, to wait for a request to complete before shutting it down).

Default: global timeout Range: 1-30

Parametry

Parameter Mandatory Range Default Description
Plugins.Redis.Default.Password no Domyślne hasło do łączenia z Redis; używane, jeśli w kluczu pozycji lub nazwanej sesji nie określono żadnej wartości.
Plugins.Redis.Default.TLSConnect no Wymaganie weryfikacji TLS po stronie klienta (Zabbix agent 2).

Obsługiwane wartości:
required - szyfrowane, nieweryfikowane (tylko do testów)
verify_ca - szyfrowane, certyfikat serwera
verify_full - szyfrowane, certyfikat serwera i nazwa serwera zweryfikowana za pomocą SAN
Pusta lub nieustawiona wartość jest traktowana jako brak TLS.
Plugins.Redis.Default.TLSCAFile no Domyślna pełna ścieżka do pliku zawierającego certyfikaty głównego urzędu CA.
Plugins.Redis.Default.TLSCertFile no Domyślna pełna ścieżka do pliku zawierającego certyfikat agenta.
Plugins.Redis.Default.TLSKeyFile no Domyślna pełna ścieżka do pliku zawierającego prywatny klucz agenta.
Plugins.Redis.Default.Uri no tcp://localhost:6379 Domyślny URI do łączenia z Redis; używany, jeśli w kluczu pozycji lub nazwanej sesji nie określono żadnej wartości.

Nie powinien zawierać osadzonych poświadczeń (zostaną zignorowane).
Musi odpowiadać formatowi URI.
Obsługiwane schematy: tcp, unix; schemat może zostać pominięty.
Port może zostać pominięty (domyślnie=6379).
Przykłady: tcp://localhost:6379
localhost
unix:/var/run/redis.sock
Plugins.Redis.Default.User no default Domyślny użytkownik wysyłany do chronionego serwera Redis; używany, jeśli w kluczu pozycji lub nazwanej sesji nie określono żadnej wartości.
Plugins.Redis.KeepAlive no 60-900 300 Maksymalny czas oczekiwania (w sekundach) przed zamknięciem nieużywanych połączeń wtyczki.
Plugins.Redis.Sessions.<SessionName>.Password no Hasło nazwanej sesji.
<SessionName> - zdefiniuj nazwę sesji, która ma być używana w kluczach pozycji.
Plugins.Redis.Sessions.<SessionName>.TLSConnect no Wymaganie weryfikacji TLS po stronie klienta (Zabbix agent 2).
<SessionName> - zdefiniuj nazwę sesji, która ma być używana w kluczach pozycji.

Obsługiwane wartości:
required - szyfrowane, nieweryfikowane (tylko do testów)
verify_ca - szyfrowane, certyfikat serwera
verify_full - szyfrowane, certyfikat serwera i nazwa serwera zweryfikowana za pomocą SAN
Pusta lub nieustawiona wartość jest traktowana jako brak TLS.
Plugins.Redis.Sessions.<SessionName>.TLSCAFile no
(yes, if TLSConnect is verify_ca or verify_full)		 Pełna ścieżka do pliku zawierającego certyfikaty głównego urzędu CA do weryfikacji certyfikatu serwera Redis.
<SessionName> - zdefiniuj nazwę sesji, która ma być używana w kluczach pozycji.
Plugins.Redis.Sessions.<SessionName>.TLSCertFile no Pełna ścieżka do pliku zawierającego certyfikat agenta do uwierzytelniania klienta.
<SessionName> - zdefiniuj nazwę sesji, która ma być używana w kluczach pozycji.
Plugins.Redis.Sessions.<SessionName>.TLSKeyFile no Pełna ścieżka do pliku zawierającego prywatny klucz agenta do uwierzytelniania klienta.
<SessionName> - zdefiniuj nazwę sesji, która ma być używana w kluczach pozycji.
Plugins.Redis.Sessions.<SessionName>.Uri no localhost:6379 Ciąg połączenia nazwanej sesji.
<SessionName> - zdefiniuj nazwę sesji, która ma być używana w kluczach pozycji.

Nie powinien zawierać osadzonych poświadczeń (zostaną zignorowane).
Musi odpowiadać formatowi URI.
Obsługiwane schematy: tcp, unix; schemat może zostać pominięty.
Port może zostać pominięty (domyślnie=6379).
Przykłady: tcp://localhost:6379
localhost
unix:/var/run/redis.sock
Plugins.Redis.Sessions.<SessionName>.User no default Użytkownik wysyłany do chronionego serwera Redis.
<SessionName> - zdefiniuj nazwę sesji, która ma być używana w kluczach pozycji.
Plugins.Redis.Timeout no 1-30 global timeout Limit czasu wykonania żądania (czas w sekundach oczekiwania na zakończenie żądania przed jego przerwaniem).

Zobacz także: