Parametry konfiguracji: Zabbix web service

Omówienie

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.

Parameter Description
AllowedIP Lista adresów IP rozdzielonych przecinkami, opcjonalnie w notacji CIDR, lub nazw DNS serwerów Zabbixa i proxy Zabbixa.
DebugLevel Poziom debugowania.
IgnoreURLCertErrors Określa sposób obsługi błędów weryfikacji certyfikatu TLS podczas uzyskiwania dostępu do URL frontend.
Include Możesz dołączyć pojedyncze pliki lub wszystkie pliki w katalogu do pliku konfiguracyjnego.
ListenPort Usługa będzie nasłuchiwać na tym porcie na połączenia z serwera.
LogFile Nazwa pliku dziennika.
LogFileSize Maksymalny rozmiar pliku dziennika.
LogType Typ wyjścia dziennika.
Timeout Maksymalny czas (w sekundach) poświęcony na formatowanie raportu PDF report pulpitu.
TLSAccept Jakie połączenia przychodzące akceptować.
TLSCAFile Pełna ścieżka do pliku zawierającego certyfikaty głównych urzędów CA do weryfikacji certyfikatu peer, używane do szyfrowanej komunikacji między komponentami Zabbixa.
TLSCertFile Pełna ścieżka do pliku zawierającego certyfikat usługi lub łańcuch certyfikatów, używane do szyfrowanej komunikacji między komponentami Zabbixa.
TLSKeyFile Pełna ścieżka do pliku zawierającego prywatny klucz usługi, używane do szyfrowanej komunikacji między komponentami Zabbixa.

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

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 parametru

AllowedIP

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 pozwoli na dowolny adres IPv4 lub IPv6. 0.0.0.0/0 można użyć, aby zezwolić 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śl 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 sposób obsługi błędów weryfikacji certyfikatu TLS podczas uzyskiwania dostępu do URL frontend:
0 - nie ignoruj błędów certyfikatu;
1 - ignoruj błędy certyfikatu.

Domyślnie: 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 dołączanych plików:

  • Każdy plik musi być czytelny.
  • 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 (np. pliki nie są dołączane alfabetycznie).
  • Nie definiuj tego samego parametru w więcej niż jednym dołączonym pliku (np. aby nadpisać ustawienie ogólne ustawieniem szczegółowym), ponieważ nie można przewidzieć, która wartość zostanie użyta.
  • Zwracaj uwagę na kopie zapasowe, które niektóre edytory tekstu tworzą automatycznie (np. edycja include/my_specific.conf może utworzyć include/my_specific.conf.BAK), ponieważ oba pliki zostaną dołączone.

Aby dołączyć 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 na połączenia z serwera.

Domyślnie: 10053
Zakres: 1024-32767

LogFile

Nazwa pliku dziennika.

Przykład:

/tmp/zabbix_web_service.log

Wymagane: Tak, jeśli LogType jest ustawione na 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

LogType

Typ wyjścia logu:

  • file - zapisuj log do pliku określonego parametrem LogFile;
  • system - zapisuj log do sysloga;
  • console - zapisuj log do standardowego wyjścia.

Domyślnie: file

Limit czasu

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

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 głównych urzędów CA do weryfikacji certyfikatu partnera, używana 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żywany 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.