9 Usługa internetowa Zabbix

Przegląd

Usługa webowa Zabbixa to proces używany do komunikacji z zewnętrznymi usługami webowymi.

Parametry obsługiwane przez plik konfiguracyjny usługi webowej Zabbixa (zabbix_web_service.conf) są wymienione w tej sekcji.

Parametry są podane bez dodatkowych informacji. Kliknij parametr, aby zobaczyć pełne szczegóły.

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 rozpoczynające się od # są obsługiwane tylko na początku wiersza.

Szczegóły parametrów

AllowedIP

Lista adresów IP oddzielonych 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, wtedy 127.0.0.1, ::127.0.0.1, ::ffff:127.0.0.1 są traktowane jednakowo, a ::/0 pozwoli na dowolny adres IPv4 lub IPv6. 0.0.0.0/0 może być użyte do zezwolenia na dowolny adres IPv4.

Przykład:

127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com

Wymagane: tak

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

IgnoreURLCertErrors

Określa obsługę błędów walidacji certyfikatu TLS podczas uzyskiwania dostępu do adresu URL frontendu:
0 - nie ignoruj błędów certyfikatu;
1 - ignoruj błędy certyfikatu.

Wartość domyślna: 0
Zakres: 0-1

Include

Można dołączyć pojedyncze pliki lub wszystkie pliki w katalogu do pliku konfiguracyjnego.

Ścieżka może być względna względem lokalizacji pliku zabbix_web_service.conf.
Podczas instalacji Zabbix utworzy katalog include w /usr/local, chyba że zostanie to zmodyfikowane podczas kompilacji.

Dyrektywa Include jest przetwarzana natychmiast po napotkaniu. Dla przewidywalnego działania zaleca się umieszczenie parametru Include na końcu pliku konfiguracyjnego.

W pliku konfiguracyjnym można określić wiele dyrektyw Include.

Wszystkie dołączone pliki muszą mieć poprawną składnię; w przeciwnym razie agent nie uruchomi się.
Wszystkie dołączone pliki muszą być czytelne.

Jeśli dołączany jest katalog lub pliki pasujące do wzorca, nie należy zakładać żadnej konkretnej kolejności dołączania (np. pliki nie są dołączane alfabetycznie). Dlatego nie należy definiować tego samego parametru w wielu dołączonych plikach (np. aby nadpisać ustawienie ogólne ustawieniem szczegółowym).

Jeśli dołączany jest katalog, należy uważać na kopie zapasowe plików automatycznie tworzone przez niektóre edytory tekstu. Na przykład edycja pliku include/my_specific.conf może spowodować utworzenie kopii zapasowej include/my_specific_conf.BAK; oba pliki zostaną wtedy dołączone. W systemie Linux użyj polecenia ls -al, aby sprawdzić zawartość katalogu include pod kątem niepotrzebnych plików.

Aby dołączyć tylko odpowiednie pliki z określonego katalogu, obsługiwany jest symbol wieloznaczny gwiazdki (*) do dopasowywania wzorców.

Przykład:

Include=/absolute/path/to/config/files/*.conf

ListenPort

Usługa będzie nasłuchiwać na tym porcie połączeń z serwera.

Domyślnie: 10053
Zakres: 1024-32767

LogFile

Nazwa pliku dziennika.

Przykład:

/tmp/zabbix_web_service.log

Obowiązkowe: Tak, jeśli LogType jest ustawione na file; w przeciwnym razie nie

LogFileSize

Maksymalny rozmiar pliku dziennika w MB.
0 - wyłącza automatyczną rotację logów.
Uwaga: Jeśli zostanie osiągnięty limit rozmiaru pliku dziennika, a rotacja pliku nie powiedzie się z jakiegokolwiek powodu, istniejący plik dziennika zostanie obcięty i rozpoczęty na nowo.

Wartość domyślna: 1
Zakres: 0-1024

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

Timeout

Maksymalny czas (w sekundach) poświęcony na formatowanie raportu PDF pulpitu.

Domyślnie: 10
Zakres: 1-30

TLSAccept

Jakie połączenia przychodzące akceptować:

• unencrypted - akceptuj połączenia bez szyfrowania (domyślnie);
• cert - akceptuj połączenia z TLS i certyfikatem.

Domyślnie: unencrypted

TLSCAFile

Pełna ścieżka do pliku zawierającego certyfikaty nadrzędnych urzędów certyfikacji (CA) do weryfikacji certyfikatu strony komunikacji, używanego do szyfrowanej komunikacji między komponentami Zabbix.

TLSCertFile

Pełna ścieżka do pliku zawierającego certyfikat usługi lub łańcuch certyfikatów, używanego do szyfrowanej komunikacji z komponentami Zabbix.

TLSKeyFile

Pełna ścieżka do pliku zawierającego prywatny klucz usługi, używany do szyfrowanej komunikacji między komponentami Zabbix.