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

Określ katalog lub pojedyncze pliki, które mają zostać dołączone do pliku konfiguracyjnego.
Podczas instalacji Zabbix ten parametr jest ustawiany na /usr/local/etc, chyba że zmienisz to podczas kompilacji.

Ogólne zasady dla parametru Include:

• Ścieżka może być względna względem lokalizacji pliku zabbix_web_service.conf.
• W jednym pliku konfiguracyjnym można określić wiele parametrów Include.
• Zabbix przetwarza parametr Include natychmiast po jego odczytaniu, więc warto umieścić go na końcu pliku konfiguracyjnego.

Zasady dotyczące plików dołączanych:

• Każdy plik musi być możliwy do odczytu.
• Każdy plik musi mieć poprawną składnię. W przeciwnym razie komponent nie uruchomi się.

Zasady dotyczące dołączania katalogów lub wzorców plików:

• Nie zakładaj żadnej kolejności dołączania (na przykład pliki nie są dołączane alfabetycznie).
• Nie definiuj tego samego parametru w więcej niż jednym dołączonym pliku (na przykład, aby nadpisać ustawienie ogólne ustawieniem szczegółowym), ponieważ nie można przewidzieć, która wartość zostanie użyta.
• Uważaj na kopie zapasowe, które niektóre edytory tekstu tworzą automatycznie (na przykład edycja include/my_specific.conf może utworzyć include/my_specific.conf.BAK), ponieważ oba pliki zostaną dołączone.

Aby dołączać tylko odpowiednie pliki z katalogu, użyj symbolu wieloznacznego (*) do dopasowywania wzorca.

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.