9 Zabbix web service

Übersicht

Der Zabbix web service ist ein Prozess, der für die Kommunikation mit externen Webdiensten verwendet wird.

Die von der Konfigurationsdatei des Zabbix web service (zabbix_web_service.conf) unterstützten Parameter sind in diesem Abschnitt aufgeführt.

Die Parameter werden ohne zusätzliche Informationen aufgelistet. Klicken Sie auf den Parameter, um die vollständigen Details anzuzeigen.

Alle Parameter sind optional, sofern nicht ausdrücklich angegeben ist, dass der Parameter obligatorisch ist.

Beachten Sie:

• Die Standardwerte spiegeln die Prozess-Standardeinstellungen 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

Sie können einzelne Dateien oder alle Dateien in einem Verzeichnis in die Konfigurationsdatei einbeziehen.

Der Pfad kann relativ zum Speicherort der Datei zabbix_web_service.conf angegeben werden.
Während der Installation erstellt Zabbix das Include-Verzeichnis in /usr/local, sofern dies nicht zur Kompilierzeit geändert wurde.

Die Anweisung Include wird sofort verarbeitet, sobald sie gefunden wird. Für ein vorhersehbares Verhalten wird empfohlen, den Parameter Include am Ende der Konfigurationsdatei zu platzieren.

In einer Konfigurationsdatei können mehrere Include-Anweisungen angegeben werden.

Alle einbezogenen Dateien müssen eine korrekte Syntax haben; andernfalls wird der Agent nicht gestartet.
Alle einbezogenen Dateien müssen lesbar sein.

Wenn ein Verzeichnis oder Dateien, die einem Muster entsprechen, einbezogen werden, sollte keine bestimmte Reihenfolge der Einbeziehung angenommen werden (z. B. werden Dateien nicht in alphabetischer Reihenfolge einbezogen). Definieren Sie daher denselben Parameter nicht in mehreren einbezogenen Dateien (z. B. um eine allgemeine Einstellung mit einer spezifischen zu überschreiben).

Wenn ein Verzeichnis einbezogen wird, achten Sie auf Sicherungskopien von Dateien, die von einigen Texteditoren automatisch erstellt werden. Wenn Sie beispielsweise die Datei include/my_specific.conf bearbeiten, kann eine Sicherungskopie include/my_specific_conf.BAK erzeugt werden; beide Dateien werden dann einbezogen. Unter Linux können Sie mit dem Befehl ls -al den Inhalt des Verzeichnisses include auf unnötige Dateien überprüfen.

Um nur relevante Dateien aus dem angegebenen Verzeichnis einzubeziehen, wird das Platzhalterzeichen Sternchen (*) für die Mustererkennung unterstützt.

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 LogFile angegebene 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.