3 Zabbix agent (UNIX)
Przegląd
Parametry obsługiwane przez plik konfiguracyjny agenta Zabbix (zabbix_agentd.conf) są wymienione w tej sekcji.
Parametry są podane bez dodatkowych informacji. Kliknij parametr, aby zobaczyć pełne szczegóły.
| Parameter | Description |
|---|---|
| Alias | Ustawia alias dla klucza pozycji. |
| AllowKey | Zezwala na wykonywanie tych kluczy pozycji, które pasują do wzorca. |
| AllowRoot | Zezwala agentowi działać jako 'root'. |
| BufferSend | Nie przechowuje danych w buforze dłużej niż N sekund. |
| BufferSize | Maksymalna liczba wartości w buforze pamięci. |
| DebugLevel | Poziom debugowania. |
| DenyKey | Odmowa wykonywania tych kluczy pozycji, które pasują do wzorca. |
| EnableRemoteCommands | Określa, czy dozwolone są zdalne polecenia z serwera Zabbix. |
| HeartbeatFrequency | Częstotliwość komunikatów heartbeat w sekundach. |
| HostInterface | Opcjonalny parametr definiujący interfejs hosta. |
| HostInterfaceItem | Opcjonalny parametr definiujący pozycję używaną do pobierania interfejsu hosta. |
| HostMetadata | Opcjonalny parametr definiujący metadane hosta. |
| HostMetadataItem | Opcjonalny parametr definiujący pozycję agenta Zabbix używaną do pobierania metadanych hosta. |
| Hostname | Opcjonalny parametr definiujący nazwę hosta. |
| HostnameItem | Opcjonalny parametr definiujący pozycję agenta Zabbix używaną do pobierania nazwy hosta. |
| Include | W pliku konfiguracyjnym można dołączać pojedyncze pliki lub wszystkie pliki z katalogu. |
| ListenBacklog | Maksymalna liczba oczekujących połączeń w kolejce TCP. |
| ListenIP | Lista adresów IP rozdzielonych przecinkami, na których agent ma nasłuchiwać. |
| ListenPort | Agent będzie nasłuchiwał na tym porcie połączeń z serwera. |
| LoadModule | Moduł do załadowania podczas uruchamiania agenta. |
| LoadModulePath | Pełna ścieżka do lokalizacji modułów agenta. |
| LogFile | Nazwa pliku dziennika. |
| LogFileSize | Maksymalny rozmiar pliku dziennika. |
| LogRemoteCommands | Włącza rejestrowanie wykonywanych poleceń powłoki jako ostrzeżeń. |
| LogType | Typ wyjścia dziennika. |
| MaxLinesPerSecond | Maksymalna liczba nowych linii, które agent będzie wysyłał na sekundę do serwera Zabbix lub proxy podczas przetwarzania aktywnych kontroli 'log' i 'logrt'. |
| PidFile | Nazwa pliku PID. |
| RefreshActiveChecks | Jak często odświeżana jest lista aktywnych kontroli. |
| Server | Lista adresów IP rozdzielonych przecinkami, opcjonalnie w notacji CIDR, lub nazw DNS serwerów Zabbix i proxy Zabbix. |
| ServerActive | Adres serwera Zabbix/proxy lub konfiguracja klastra, z którego mają być pobierane aktywne kontrole. |
| SourceIP | Źródłowy adres IP. |
| StartAgents | Liczba wstępnie utworzonych instancji zabbix_agentd, które przetwarzają pasywne kontrole. |
| Timeout | Określa, jak długo czekać (w sekundach) na nawiązanie połączenia i wymianę danych z proxy lub serwerem Zabbix. |
| TLSAccept | Wymagany poziom szyfrowania dla połączeń przychodzących. |
| TLSCAFile | Pełna ścieżka do pliku zawierającego certyfikaty głównego urzędu CA, używane do weryfikacji certyfikatu peer w szyfrowanej komunikacji między komponentami Zabbix. |
| TLSCertFile | Pełna ścieżka do pliku zawierającego certyfikat agenta lub łańcuch certyfikatów, używane do szyfrowanej komunikacji między komponentami Zabbix. |
| TLSCipherAll | Ciąg priorytetów GnuTLS lub ciąg szyfrów OpenSSL (TLS 1.2). Zastępuje domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na certyfikatach i PSK. |
| TLSCipherAll13 | Ciąg szyfrów dla OpenSSL 1.1.1 lub nowszego w TLS 1.3. Zastępuje domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na certyfikatach i PSK. |
| TLSCipherCert | Ciąg priorytetów GnuTLS lub ciąg szyfrów OpenSSL (TLS 1.2). Zastępuje domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na certyfikatach. |
| TLSCipherCert13 | Ciąg szyfrów dla OpenSSL 1.1.1 lub nowszego w TLS 1.3. Zastępuje domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na certyfikatach. |
| TLSCipherPSK | Ciąg priorytetów GnuTLS lub ciąg szyfrów OpenSSL (TLS 1.2). Zastępuje domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na PSK. |
| TLSCipherPSK13 | Ciąg szyfrów dla OpenSSL 1.1.1 lub nowszego w TLS 1.3. Zastępuje domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na PSK. |
| TLSConnect | Wymagany poziom szyfrowania dla połączeń agenta z serwerem Zabbix lub proxy. |
| TLSCRLFile | Pełna ścieżka do pliku zawierającego certyfikaty unieważnione. Ten parametr jest używany do szyfrowanej komunikacji między komponentami Zabbix. |
| TLSKeyFile | Pełna ścieżka do pliku zawierającego prywatny klucz agenta, używany do szyfrowanej komunikacji między komponentami Zabbix. |
| TLSPSKFile | Pełna ścieżka do pliku zawierającego współdzielony wcześniej klucz agenta, używany do szyfrowanej komunikacji z serwerem Zabbix. |
| TLSPSKIdentity | Ciąg identyfikatora współdzielonego wcześniej klucza, używany do szyfrowanej komunikacji z serwerem Zabbix. |
| TLSServerCertIssuer | Dozwolony wystawca certyfikatu serwera (proxy). |
| TLSServerCertSubject | Dozwolony podmiot certyfikatu serwera (proxy). |
| UnsafeUserParameters | Zezwala na przekazywanie wszystkich znaków w argumentach do parametrów zdefiniowanych przez użytkownika. |
| User | Obniża uprawnienia do określonego, istniejącego użytkownika w systemie. |
| UserParameter | Parametr zdefiniowany przez użytkownika do monitorowania. |
| UserParameterDir | Domyślna ścieżka wyszukiwania dla poleceń UserParameter. |
Wszystkie parametry są opcjonalne, chyba że wyraźnie zaznaczono, że parametr jest obowiązkowy.
Należy pamiętać, że:
- Wartości domyślne odzwierciedlają domyślne ustawienia demona, a nie wartości w dostarczonych plikach konfiguracyjnych;
- 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.
Szczegóły parametru
Alias
Ustawia alias dla klucza pozycja.
Może być używany do zastąpienia długiego i złożonego klucza pozycja krótszym i prostszym.
Może być obecnych wiele parametrów Alias.
Wiele parametrów z tym samym kluczem Alias nie jest dozwolone.
Różne klucze Alias mogą odwoływać się do tego samego klucza pozycja.
Aliasów można używać w HostMetadataItem, ale nie w parametrze HostnameItem.
Przykład 1: Pobieranie identyfikatora użytkownika zabbix.
Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1]
Teraz można użyć skróconego klucza zabbix.userid, aby pobrać dane.
Przykład 2: Pobieranie użycia CPU z domyślnymi i niestandardowymi parametrami.
Alias=cpu.util:system.cpu.util
Alias=cpu.util[*]:system.cpu.util[*]
Umożliwia to użycie klucza cpu.util do pobierania procentowego użycia CPU z domyślnymi parametrami, a także użycie cpu.util[all, idle, avg15] do pobierania konkretnych danych o użyciu CPU.
Przykład 3: Uruchamianie wielu reguł low-level discovery przetwarzających te same elementy wykrywania.
Alias=vfs.fs.discovery[*]:vfs.fs.discovery
Teraz można skonfigurować kilka reguł wykrywania, używając vfs.fs.discovery z różnymi parametrami dla każdej reguły, np. vfs.fs.discovery[foo], vfs.fs.discovery[bar] itd.
AllowKey
Zezwalaj na wykonywanie tych kluczy pozycji, które pasują do wzorca.
Wzorzec klucza jest wyrażeniem wieloznacznym, które obsługuje znak * do dopasowania dowolnej liczby dowolnych znaków.
Można zdefiniować wiele reguł dopasowywania kluczy w połączeniu z DenyKey.
Parametry są przetwarzane jeden po drugim zgodnie z kolejnością ich występowania.
Zobacz także: Ograniczanie sprawdzeń agenta.
AllowRoot
Zezwalaj agentowi na uruchamianie się jako 'root'. Jeśli ta opcja jest wyłączona, a agent został uruchomiony przez użytkownika 'root', agent spróbuje przełączyć się na użytkownika 'zabbix'. Nie ma to wpływu, jeśli został uruchomiony przez zwykłego użytkownika.
Domyślnie: 0
Wartości: 0 - nie zezwalaj; 1 - zezwalaj
BufferSend
Nie przechowuj danych w buforze dłużej niż N sekund.
Domyślnie: 5
Zakres: 1-3600
BufferSize
Maksymalna liczba wartości w buforze pamięci. Agent wyśle wszystkie zebrane dane do serwera Zabbix lub proxy, jeśli bufor zostanie zapełniony.
Domyślnie: 100
Zakres: 2-65535
DebugLevel
Określa poziom debugowania:
- 0 - podstawowe informacje o uruchamianiu i zatrzymywaniu procesów Zabbix;
- 1 - informacje krytyczne;
- 2 - informacje o błędach;
- 3 - ostrzeżenia;
- 4 - do debugowania (generuje dużo informacji);
- 5 - rozszerzone debugowanie (generuje jeszcze więcej informacji).
Domyślnie: 3
Zakres: 0-5
DenyKey
Zabrania wykonywania tych kluczy pozycji, które pasują do wzorca.
Wzorzec klucza jest wyrażeniem wieloznacznym, które obsługuje znak * do dopasowania dowolnej liczby dowolnych znaków.
W połączeniu z AllowKey można zdefiniować wiele reguł dopasowywania kluczy.
Parametry są przetwarzane jeden po drugim zgodnie z kolejnością ich występowania.
Zobacz także: Ograniczanie sprawdzeń agent.
EnableRemoteCommands
Zezwalaj na zdalne polecenia z serwera Zabbix.
Ten parametr jest przestarzały; zamiast niego użyj AllowKey=system.run[*] lub DenyKey=system.run[*].
Jest to wewnętrzny alias parametrów AllowKey/DenyKey zależnie od wartości:
- 0 -
DenyKey=system.run[*] - 1 -
AllowKey=system.run[*]
Domyślnie: 0
Wartości: 0 - nie zezwalaj, 1 - zezwalaj
HeartbeatFrequency
Częstotliwość wiadomości heartbeat w sekundach.
Używana do monitorowania dostępności aktywnych kontroli.
0 - wiadomości heartbeat wyłączone.
Domyślnie: 60
Zakres: 0-3600
HostInterface
Opcjonalny parametr definiujący interfejs hosta (adres IP lub nazwa DNS) używany podczas procesu autorejestracji hosta. Ta wartość zostanie użyta do wypełnienia interfejsu w nowo utworzonym hoście i umożliwia jawne skonfigurowanie adresu IP lub DNS. Więcej informacji można znaleźć w sekcji Using DNS as default interface.
Jeśli nie zostanie zdefiniowana, wartość zostanie pobrana z HostInterfaceItem.
agent zgłosi błąd i nie uruchomi się, jeśli wartość przekroczy limit 255 znaków.
Zakres: 0-255 znaków
HostInterfaceItem
Opcjonalny parametr, który definiuje pozycję używaną do określenia interfejsu hosta (adresu IP lub nazwy DNS) podczas procesu automatycznej rejestracji hosta.
Ta wartość jest używana tylko wtedy, gdy HostInterface nie jest zdefiniowany.
Więcej informacji można znaleźć w sekcji Using DNS as default interface.
Podczas żądania automatycznej rejestracji agent zapisze komunikat ostrzegawczy, jeśli wartość zwrócona przez określoną pozycję przekroczy limit 255 znaków.
Pozycja system.run[] jest obsługiwana niezależnie od ustawień AllowKey/DenyKey.
HostMetadata
Opcjonalny parametr definiujący metadane używane do identyfikacji lub rozróżniania hosta podczas procesu autorejestracji hosta (agent aktywny).
HostMetadata umożliwia rozróżnianie hostów nie tylko na podstawie nazwy hosta.
Jeśli nie zostanie zdefiniowany, wartość zostanie pobrana z HostMetadataItem.
Agent zgłosi błąd i nie uruchomi się, jeśli określona wartość przekroczy limit 2034 bajtów lub będzie ciągiem innym niż UTF-8. Gdy parametr oczekuje adresu IP lub nazwy DNS, wartości poprawne w UTF-8, ale niebędące prawidłowymi adresami IP ani nazwami DNS, również zostaną odrzucone i zgłoszone jako nieprawidłowe.
Metadane wielowierszowe nie są obsługiwane — wynik zostanie obcięty przy pierwszym znaku podziału wiersza.
Zakres: 0-2034 bajty
HostMetadataItem
Opcjonalny parametr, który definiuje pozycję agenta Zabbix używaną do pobierania metadanych hosta.
Ta opcja jest używana tylko wtedy, gdy HostMetadata nie jest zdefiniowany.
Wartość HostMetadataItem jest pobierana przy każdej próbie autorejestracji i jest używana wyłącznie w procesie autorejestracji hosta (agent aktywny).
HostMetadataItem umożliwia rozróżnianie hostów nie tylko na podstawie nazwy hosta.
Obsługiwane są parametry użytkownika i aliasy.
Pozycja system.run[] jest obsługiwana niezależnie od ustawień AllowKey/DenyKey.
Podczas żądania autorejestracji agent zapisze komunikat ostrzegawczy, jeśli wartość zwrócona przez określoną pozycję przekroczy limit 65535 punktów kodowych UTF-8. Wartość zwrócona przez pozycję musi być ciągiem UTF-8, w przeciwnym razie zostanie zignorowana. Gdy parametr oczekuje adresu IP lub nazwy DNS, wartości poprawne w UTF-8, ale niebędące prawidłowymi adresami IP ani nazwami DNS, również zostaną odrzucone i zgłoszone jako nieprawidłowe.
Metadane wielowierszowe nie są obsługiwane — wynik zostanie obcięty przy pierwszym znaku podziału wiersza.
Nazwa hosta
Lista unikalnych nazw hostów rozdzielonych przecinkami, rozróżniających wielkość liter.
Wymagane dla aktywnych kontroli i musi odpowiadać nazwom hostów skonfigurowanym na serwerze.
Wartość jest pobierana z HostnameItem, jeśli nie została zdefiniowana.
Dozwolone znaki: alfanumeryczne, '.', ' ', '_' i '-'.
Maksymalna długość: 128 znaków na nazwę hosta, 2048 znaków dla całego wiersza.
Domyślnie: ustawiane przez HostnameItem
HostnameItem
Opcjonalny parametr, który definiuje pozycję agenta Zabbix używaną do pobierania nazwy hosta.
Ta opcja jest używana tylko wtedy, gdy Hostname nie jest zdefiniowany.
Parametry użytkownika ani aliasy nie są obsługiwane, ale pozycja system.run[] jest obsługiwana niezależnie od wartości AllowKey/DenyKey.
Domyślnie: system.hostname
Dołączanie
Możesz dołączyć pojedyncze pliki lub wszystkie pliki w katalogu do pliku konfiguracyjnego.
Aby dołączyć tylko odpowiednie pliki w określonym katalogu, do dopasowywania wzorców obsługiwany jest symbol wieloznaczny gwiazdki.
Zobacz uwagi specjalne dotyczące ograniczeń.
Przykład:
Include=/absolute/path/to/config/files/*.conf
ListenBacklog
Maksymalna liczba oczekujących połączeń w kolejce TCP.
Wartość domyślna jest zakodowaną na stałe stałą i zależy od systemu.
Maksymalna obsługiwana wartość również zależy od systemu; zbyt wysokie wartości mogą zostać bez ostrzeżenia obcięte do „maksimum określonego przez implementację”.
Domyślnie: SOMAXCONN
Zakres: 0 - INT_MAX
ListenIP
Lista adresów IP rozdzielonych przecinkami, na których agent powinien nasłuchiwać.
Domyślnie: 0.0.0.0
ListenPort
Agent będzie nasłuchiwał na tym porcie na połączenia z serwera.
Domyślnie: 10050
Zakres: 1024-32767
LoadModule
Moduł do załadowania podczas uruchamiania agenta.
Moduły służą do rozszerzania funkcjonalności agenta.
Moduł musi znajdować się w katalogu określonym przez LoadModulePath albo ścieżka musi poprzedzać nazwę modułu.
Jeśli poprzedzająca ścieżka jest bezwzględna (zaczyna się od /), LoadModulePath jest ignorowany.
Formaty:
LoadModule=<module.so>LoadModule=<path/module.so>LoadModule=</abs_path/module.so>
Dozwolone jest użycie wielu parametrów LoadModule.
LoadModulePath
Pełna ścieżka do lokalizacji modułów agenta. Domyślna wartość zależy od opcji kompilacji.
LogFile
Nazwa pliku dziennika.
Obowiązkowe: Tak, jeśli LogType ma ustawioną wartość file; w przeciwnym razie nie
LogFileSize
Maksymalny rozmiar pliku dziennika w MB.
0 - wyłącza automatyczną rotację dziennika.
Uwaga: Jeśli zostanie osiągnięty limit rozmiaru pliku dziennika i rotacja pliku nie powiedzie się z jakiegokolwiek powodu, istniejący plik dziennika zostanie obcięty i utworzony od nowa.
Domyślnie: 1
Zakres: 0-1024
LogRemoteCommands
Włącz rejestrowanie wykonywanych poleceń powłoki jako ostrzeżeń.
Polecenia będą rejestrowane tylko wtedy, gdy zostaną wykonane zdalnie.
Wpisy dziennika nie będą tworzone, jeśli system.run[] zostanie uruchomione lokalnie przez parametry HostMetadataItem, HostInterfaceItem lub HostnameItem.
Domyślnie: 0
Wartości: 0 - wyłączone, 1 - włączone
LogType
Typ wyjścia logu:
- file - zapisuj log do pliku określonego parametrem
LogFile; - system - zapisuj log do syslog;
- console - zapisuj log do standardowego wyjścia.
Domyślnie: file
MaxLinesPerSecond
Maksymalna liczba nowych wierszy, jaką agent będzie wysyłać na sekundę do serwera Zabbix lub proxy podczas przetwarzania aktywnych kontroli log i logrt.
Podana wartość zostanie zastąpiona przez parametr maxlines, określony w kluczu pozycji log lub logrt.
Uwaga: Zabbix będzie przetwarzać 10 razy więcej nowych wierszy niż ustawiono w MaxLinesPerSecond, aby wyszukać wymagany ciąg w pozycjach dziennika.
Domyślnie: 20
Zakres: 1-1000
PidFile
Nazwa pliku PID.
Domyślnie: /tmp/zabbix_agentd.pid
RefreshActiveChecks
Jak często lista aktywnych kontroli jest odświeżana, w sekundach. Należy pamiętać, że po nieudanej próbie odświeżenia aktywnych kontroli następna próba zostanie podjęta po 60 sekundach.
Domyślnie: 5
Zakres: 1-86400
Serwer
Lista adresów IP rozdzielonych przecinkami, opcjonalnie w notacji CIDR, lub nazw DNS serwerów Zabbix i proxy Zabbix.
Połączenia przychodzące będą akceptowane tylko od hostów wymienionych tutaj.
Jeśli obsługa IPv6 jest włączona, to 127.0.0.1, ::127.0.0.1, ::ffff:127.0.0.1 są traktowane jednakowo, a ::/0 zezwoli na dowolny adres IPv4 lub IPv6.
0.0.0.0/0 można użyć, aby zezwolić na dowolny adres IPv4.
Należy pamiętać, że "IPv4-compatible IPv6 addresses" (0000::/96 prefix) są obsługiwane, ale przestarzałe zgodnie z RFC4291.
Dozwolone są spacje.
Przykład:
Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com
Obowiązkowe: tak, jeśli StartAgents nie jest jawnie ustawione na 0
ServerActive
Adres serwera/proxy Zabbix lub konfiguracja klastra, z którego mają być pobierane aktywne kontrole.
Adres serwera/proxy jest adresem IP lub nazwą DNS oraz opcjonalnym portem oddzielonym dwukropkiem.
Konfiguracja klastra to jeden lub więcej adresów członków grupy serwera lub proxy oddzielonych średnikiem.
Można podać wiele serwerów/klastrów Zabbix oraz proxy Zabbix, oddzielając je przecinkami.
Jeśli nie są używane grupy proxy, z każdego serwera/klastra Zabbix nie należy podawać więcej niż jednego proxy Zabbix.
Jeśli podano proxy Zabbix, nie należy podawać serwera/klastra Zabbix dla tego proxy.
Można podać wiele adresów rozdzielonych przecinkami, aby używać kilku niezależnych serwerów Zabbix równolegle.
Dozwolone są spacje.
Jeśli port nie zostanie określony, używany jest port domyślny.
Adresy IPv6 muszą być ujęte w nawiasy kwadratowe, jeśli dla tego hosta określono port.
Jeśli port nie jest określony, nawiasy kwadratowe dla adresów IPv6 są opcjonalne.
Jeśli ten parametr nie zostanie określony, aktywne kontrole są wyłączone.
Przykład dla proxy Zabbix:
ServerActive=127.0.0.1:10051
Przykład dla grupy proxy Zabbix:
ServerActive=proxy1.example.com;proxy2.example.com;proxy3.example.com;proxy4.example.com;proxy5.example.com
Przykład dla wielu serwerów:
ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1]
Przykład dla wysokiej dostępności:
ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3
Przykład dla wysokiej dostępności z dwoma klastrami i jednym serwerem:
ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain
SourceIP
Adres IP źródłowy dla:
- połączeń wychodzących do serwera Zabbix lub proxy Zabbix;
- nawiązywania połączeń podczas wykonywania niektórych pozycji (
web.page.get,net.tcp.portitp.).
StartAgents
Liczba wcześniej utworzonych instancji zabbix_agentd, które obsługują pasywne sprawdzenia.
Jeśli ustawiono 0, pasywne sprawdzenia są wyłączone, a agent nie będzie nasłuchiwał na żadnym porcie TCP.
Domyślnie: 10
Zakres: 0-100
Limit czasu
Określa, jak długo należy czekać (w sekundach) na nawiązanie połączenia i wymianę danych z proxy lub serwerem Zabbix.
Ten parametr definiuje czas trwania różnych operacji komunikacyjnych, w tym:
- oczekiwanie na odpowiedź z serwera Zabbix;
- wysyłanie żądań do serwera Zabbix, w tym żądań konfiguracji pozycji i danych pozycji w active checks;
- pobieranie danych dziennika za pomocą logfile;
- wysyłanie komunikatów heartbeat;
- maksymalny czas trwania dla kontroli
vfs.*; - używanie przez moduły agent Zabbix;
- działanie jako wartość awaryjna w scenariuszach, w których serwer lub proxy w wersji starszej niż 7.0 wysyła kontrole bez limitów czasu.
Ten limit czasu nie będzie używany dla tych kontroli agenta, które mają konfigurowalne ustawienia limitu czasu we frontendzie (na poziomie globalnym, proxy lub pojedynczej pozycji).
Domyślnie: 3
Zakres: 1-30
TLSAccept
Poziom szyfrowania wymagany dla połączeń przychodzących.
Używane dla kontroli pasywnych.
Można określić wiele wartości, oddzielając je przecinkiem:
- unencrypted - akceptuj połączenia bez szyfrowania (domyślnie);
- psk - akceptuj połączenia z TLS i wstępnie współdzielonym kluczem (PSK);
- cert - akceptuj połączenia z TLS i certyfikatem.
Obowiązkowe: tak, jeśli zdefiniowano parametry certyfikatu TLS lub PSK (nawet dla połączenia unencrypted); w przeciwnym razie nie
TLSCAFile
Pełna ścieżka do pliku zawierającego certyfikaty głównych urzędów CA używane do weryfikacji certyfikatu peer, stosowane w szyfrowanej komunikacji między komponentami Zabbixa.
TLSCertFile
Pełna ścieżka do pliku zawierającego certyfikat agent lub łańcuch certyfikatów, używanego do szyfrowanej komunikacji z komponentami Zabbix.
TLSCipherAll
Łańcuch priorytetów GnuTLS lub łańcuch szyfrów OpenSSL (TLS 1.2). Zastępuje domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na certyfikatach i PSK.
Przykład:
TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSCipherAll13
Łańcuch szyfrów dla OpenSSL 1.1.1 lub nowszego w TLS 1.3. Zastępuje domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na certyfikatach i PSK.
Przykład dla GnuTLS:
NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL::+SIGN-ALL:+CTYPE-X.509
Przykład dla OpenSSL:
EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128
TLSCipherCert
Ciąg priorytetów GnuTLS lub ciąg szyfrów OpenSSL (TLS 1.2). Zastępuje domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na certyfikatach.
Przykład dla GnuTLS:
NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509
Przykład dla OpenSSL:
EECDH+aRSA+AES128:RSA+aRSA+AES128
TLSCipherCert13
Łańcuch szyfrów dla OpenSSL 1.1.1 lub nowszego w TLS 1.3. Zastępuje domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na certyfikatach.
TLSCipherPSK
Ciąg priorytetów GnuTLS lub ciąg szyfrów OpenSSL (TLS 1.2). Zastępuje domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na PSK.
Przykład dla GnuTLS:
NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL
Przykład dla OpenSSL:
kECDHEPSK+AES128:kPSK+AES128
TLSCipherPSK13
Łańcuch szyfrów dla OpenSSL 1.1.1 lub nowszego w TLS 1.3. Zastępuje domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na PSK.
Przykład:
TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSConnect
Poziom szyfrowania wymagany dla połączeń agent z serwerem Zabbix lub proxy.
Używane dla aktywnych kontroli.
Można określić tylko jedną wartość:
- unencrypted - połączenie bez szyfrowania (domyślnie);
- psk - połączenie z użyciem TLS i współdzielonego klucza wstępnego (PSK);
- cert - połączenie z użyciem TLS i certyfikatu.
Wymagane: tak, jeśli zdefiniowano parametry certyfikatu TLS lub PSK (nawet dla połączenia unencrypted); w przeciwnym razie nie
TLSCRLFile
Pełna ścieżka do pliku zawierającego unieważnione certyfikaty. Ten parametr jest używany do szyfrowanej komunikacji między komponentami Zabbixa.
TLSKeyFile
Pełna ścieżka do pliku zawierającego prywatny klucz agenta, używany do szyfrowanej komunikacji między komponentami Zabbix.
TLSPSKFile
Pełna ścieżka do pliku zawierającego współdzielony klucz agenta, używany do szyfrowanej komunikacji z serwerem Zabbix.
TLSPSKIdentity
Łańcuch tożsamości klucza współdzielonego, używany do szyfrowanej komunikacji z serwerem Zabbix.
TLSServerCertIssuer
Dozwolony wystawca certyfikatu serwera (proxy).
TLSServerCertSubject
Dozwolony subject certyfikatu serwera (proxy).
UnsafeUserParameters
Zezwalaj na przekazywanie wszystkich znaków w argumentach do parametrów zdefiniowanych przez użytkownika.
Następujące znaki są niedozwolone: \ ' " ` * ? [ ] { } \~ $ ! & ; ( ) < > | # @
Dodatkowo znaki nowej linii są niedozwolone.
Domyślnie: 0
Wartości: 0 - nie zezwalaj, 1 - zezwalaj
Użytkownik
Obniża uprawnienia do określonego, istniejącego użytkownika w systemie.
Ma efekt tylko wtedy, gdy jest uruchamiany jako root i AllowRoot jest wyłączone.
Domyślnie: zabbix
UserParameter
Parametr zdefiniowany przez użytkownika do monitorowania.
Może istnieć kilka parametrów zdefiniowanych przez użytkownika.
Format: UserParameter=<key>,<shell command>
Należy pamiętać, że polecenie powłoki nie może zwracać pustego ciągu ani wyłącznie EOL.
Polecenia powłoki mogą używać ścieżek względnych, jeśli określono parametr UserParameterDir.
Przykład:
UserParameter=system.test,who|wc -l
UserParameter=check_cpu,./custom_script.sh
UserParameterDir
Domyślna ścieżka wyszukiwania dla poleceń UserParameter.
Jeśli jest używana, agent zmieni swój katalog roboczy na ten określony tutaj przed wykonaniem polecenia.
Dzięki temu polecenia UserParameter mogą używać względnego prefiksu ./ zamiast pełnej ścieżki.
Dozwolony jest tylko jeden wpis.
Przykład:
UserParameterDir=/opt/myscripts