9 Zabbix web service
Übersicht
Der Zabbix-Webservice ist ein Prozess, der für die Kommunikation mit externen Webservices verwendet wird.
In diesem Abschnitt sind die von der Konfigurationsdatei des Zabbix-Webservice (zabbix_web_service.conf) unterstützten Parameter aufgeführt.
Die Parameter werden ohne zusätzliche Informationen aufgeführt. Klicken Sie auf den Parameter, um die vollständigen Details anzuzeigen.
| Parameter | Beschreibung |
|---|---|
| AllowedIP | Eine durch Kommas getrennte Liste von IP-Adressen, optional in CIDR-Notation, oder DNS-Namen von Zabbix-Servern und Zabbix-Proxys. |
| DebugLevel | Die Debug-Stufe. |
| IgnoreURLCertErrors | Gibt an, wie TLS-Zertifikatsvalidierungsfehler beim Zugriff auf die Frontend-URL behandelt werden. |
| Include | Sie können einzelne Dateien oder alle Dateien in einem Verzeichnis in die Konfigurationsdatei einbinden. |
| ListenPort | Der Service wartet an diesem Port auf Verbindungen vom Server. |
| LogFile | Der Name der Protokolldatei. |
| LogFileSize | Die maximale Größe der Protokolldatei. |
| LogType | Der Typ der Protokollausgabe. |
| Timeout | Die maximale Zeit (in Sekunden), die für die Formatierung des PDF-Berichts eines Dashboards aufgewendet wird. |
| TLSAccept | Welche eingehenden Verbindungen akzeptiert werden sollen. |
| TLSCAFile | Der vollständige Pfadname einer Datei, die die Zertifikate der übergeordneten Zertifizierungsstelle(n) zur Überprüfung von Peer-Zertifikaten enthält und für die verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet wird. |
| TLSCertFile | Der vollständige Pfadname einer Datei, die das Servicezertifikat oder die Zertifikatskette enthält und für die verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet wird. |
| TLSKeyFile | Der vollständige Pfadname einer Datei, die den privaten Servicesschlüssel enthält und für die verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet wird. |
Alle Parameter sind optional, sofern nicht ausdrücklich angegeben wird, dass der Parameter obligatorisch ist.
Beachten Sie Folgendes:
- Die Standardwerte spiegeln die Prozessstandards wider, nicht die Werte in den mitgelieferten Konfigurationsdateien.
- Zabbix unterstützt Konfigurationsdateien nur in UTF-8-Kodierung ohne BOM.
- Kommentare, die mit
#beginnen, werden nur am Anfang der Zeile unterstützt.
Parameterdetails
AllowedIP
Eine durch Kommas getrennte Liste von IP-Adressen, optional in CIDR-Notation, oder DNS-Namen von Zabbix-Servern und Zabbix-Proxys. Eingehende Verbindungen werden nur von den hier aufgeführten Hosts akzeptiert.
Wenn die IPv6-Unterstützung aktiviert ist, werden 127.0.0.1, ::127.0.0.1, ::ffff:127.0.0.1 gleich behandelt, und ::/0 erlaubt jede IPv4- oder IPv6-Adresse. 0.0.0.0/0 kann verwendet werden, um jede IPv4-Adresse zuzulassen.
Beispiel:
127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com
Verbindlich: ja
DebugLevel
Geben Sie den Debug-Level an:
- 0 - grundlegende Informationen über das Starten und Stoppen von Zabbix-Prozessen;
- 1 - kritische Informationen;
- 2 - Fehlerinformationen;
- 3 - Warnungen;
- 4 - für das Debugging (liefert viele Informationen);
- 5 - erweitertes Debugging (liefert noch mehr Informationen).
Standard: 3
Bereich: 0-5
IgnoreURLCertErrors
Legt die Behandlung von TLS-Zertifikatsvalidierungsfehlern beim Zugriff auf die Frontend-URL fest:
0 - Zertifikatsfehler nicht ignorieren;
1 - Zertifikatsfehler ignorieren.
Standard: 0
Bereich: 0-1
Include
Geben Sie ein Verzeichnis oder einzelne Dateien an, die in die Konfigurationsdatei aufgenommen werden sollen.
Während der Zabbix-Installation wird dieser Parameter auf /usr/local/etc gesetzt, sofern Sie dies nicht zur Kompilierzeit ändern.
Allgemeine Regeln für den Parameter Include:
- Der Pfad kann relativ zum Speicherort der Datei
zabbix_web_service.confangegeben werden. - Sie können mehrere
Include-Parameter in einer Konfigurationsdatei angeben. - Zabbix verarbeitet den Parameter
Includesofort, sobald er gelesen wird. Platzieren Sie ihn daher am besten am Ende der Konfigurationsdatei.
Regeln für eingebundene Dateien:
- Jede Datei muss lesbar sein.
- Jede Datei muss eine korrekte Syntax haben. Andernfalls wird die Komponente nicht gestartet.
Regeln für das Einbinden von Verzeichnissen oder Dateimustern:
- Verlassen Sie sich nicht auf eine bestimmte Reihenfolge beim Einbinden (z. B. werden Dateien nicht in alphabetischer Reihenfolge eingebunden).
- Definieren Sie denselben Parameter nicht in mehr als einer eingebundenen Datei (z. B. um eine allgemeine Einstellung durch eine spezifische zu überschreiben), da Sie nicht vorhersagen können, welcher Wert verwendet wird.
- Achten Sie auf Sicherungskopien, die einige Texteditoren automatisch erstellen (z. B. kann beim Bearbeiten von
include/my_specific.confdie Dateiinclude/my_specific.conf.BAKerstellt werden), da beide Dateien eingebunden werden.
Um nur relevante Dateien aus einem Verzeichnis einzubinden, verwenden Sie den Platzhalter (*) für die Mustererkennung.
Beispiel:
Include=/absolute/path/to/config/files/*.conf
ListenPort
Der Dienst lauscht auf diesem Port auf Verbindungen vom Server.
Standard: 10053
Bereich: 1024-32767
LogFile
Der Name der Protokolldatei.
Beispiel:
/tmp/zabbix_web_service.log
Erforderlich: Ja, wenn LogType auf file gesetzt ist; andernfalls nein
LogFileSize
Die maximale Größe einer Protokolldatei in MB.
0 - automatische Protokollrotation deaktivieren.
Hinweis: Wenn die Größenbegrenzung der Protokolldatei erreicht wird und die Dateirotation aus irgendeinem Grund fehlschlägt, wird die vorhandene Protokolldatei gekürzt und neu begonnen.
Standard: 1
Bereich: 0-1024
LogType
Der Typ der Protokollausgabe:
- file - Protokoll in die durch den Parameter
LogFileangegebene Datei schreiben; - system - Protokoll in syslog schreiben;
- console - Protokoll in die Standardausgabe schreiben.
Standard: file
Timeout
Die maximale Zeit (in Sekunden), die für die Formatierung des PDF-Berichts eines Dashboards aufgewendet wird.
Standard: 10
Bereich: 1-30
TLSAccept
Welche eingehenden Verbindungen akzeptiert werden sollen:
- unencrypted - Verbindungen ohne Verschlüsselung akzeptieren (Standard);
- cert - Verbindungen mit TLS und einem Zertifikat akzeptieren.
Standard: unencrypted
TLSCAFile
Der vollständige Pfadname der Datei, die die Zertifikate der CA(s) der obersten Ebene für die Verifizierung von Peer-Zertifikaten enthält und für die verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet wird.
TLSCertFile
Der vollständige Pfadname der Datei, die das Dienstzertifikat oder die Zertifikatskette enthält und für die verschlüsselte Kommunikation mit Zabbix-Komponenten verwendet wird.
TLSKeyFile
Der vollständige Pfadname der Datei, die den privaten Schlüssel des Dienstes enthält und für die verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet wird.