9 Usługa web Zabbix
Przegląd
Usługa internetowa Zabbix to proces używany do komunikacji z zewnętrznymi usługami internetowymi.
Parametry obsługiwane przez plik konfiguracyjny usługi internetowej Zabbix (zabbix_web_service.conf) zostały wymienione w tej sekcji.
Parametry są wymienione bez dodatkowych informacji. Kliknij parametr, aby wyświetlić pełne szczegóły.
| Parameter | Description |
|---|---|
| AllowedIP | Lista adresów IP oddzielonych przecinkami, opcjonalnie w notacji CIDR, lub nazw DNS serwerów Zabbix i proxy Zabbix. |
| DebugLevel | Poziom debugowania. |
| IgnoreURLCertErrors | Określa sposób obsługi błędów walidacji certyfikatu TLS podczas uzyskiwania dostępu do adresu URL frontendu. |
| Include | Umożliwia dołączenie do pliku konfiguracyjnego pojedynczych plików lub wszystkich plików z katalogu. |
| ListenPort | Usługa będzie nasłuchiwać na tym porcie połączeń z serwera. |
| LogFile | Nazwa pliku dziennika. |
| LogFileSize | Maksymalny rozmiar pliku dziennika. |
| LogType | Typ danych wyjściowych dziennika. |
| Timeout | Maksymalny czas (w sekundach) przeznaczony na formatowanie raportu PDF raportu pulpitu nawigacyjnego. |
| TLSAccept | Typ akceptowanych połączeń przychodzących. |
| TLSCAFile | Pełna ścieżka do pliku zawierającego certyfikaty głównego urzędu certyfikacji (CA) używane do weryfikacji certyfikatów równorzędnych podczas 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 podczas szyfrowanej komunikacji między komponentami Zabbix. |
| TLSKeyFile | Pełna ścieżka do pliku zawierającego klucz prywatny usługi używany podczas szyfrowanej komunikacji między komponentami Zabbix. |
Wszystkie parametry są nieobowiązkowe, chyba że wyraźnie zaznaczono, że dany parametr jest obowiązkowy.
Należy pamiętać, że:
- Wartości domyślne odzwierciedlają wartości domyślne procesu, a nie wartości w dostarczonych plikach konfiguracyjnych;
- 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 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
Includenatychmiast 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.
- Uważaj na kopie zapasowe, które niektóre edytory tekstu tworzą automatycznie (np. edycja
include/my_specific.confmoż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 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
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ę 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 na standardowe wyjście.
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.