9 Zabbix-Webservice

Ü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.

Parameter Beschreibung
AllowedIP Eine Liste durch Kommas getrennter IP-Adressen, optional in CIDR-Notation, oder DNS-Namen von Zabbix-Servern und Zabbix-Proxys.
DebugLevel Die Debug-Stufe.
IgnoreURLCertErrors Legt die Behandlung von TLS-Zertifikatsvalidierungsfehlern beim Zugriff auf die Frontend-URL fest.
Include Sie können einzelne Dateien oder alle Dateien in einem Verzeichnis in die Konfigurationsdatei einbinden.
ListenPort Der Dienst lauscht auf 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 Pfad zu einer Datei mit den Zertifikaten der obersten CA(s) zur Überprüfung von Peer-Zertifikaten, verwendet für verschlüsselte Kommunikation zwischen Zabbix-Komponenten.
TLSCertFile Der vollständige Pfad zu einer Datei mit dem Dienstzertifikat oder der Zertifikatskette, verwendet für verschlüsselte Kommunikation zwischen Zabbix-Komponenten.
TLSKeyFile Der vollständige Pfad zu einer Datei mit dem privaten Schlüssel des Dienstes, verwendet für verschlüsselte Kommunikation zwischen Zabbix-Komponenten.

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;
  • Werte unterstützen Umgebungsvariablen;
  • Zabbix unterstützt Konfigurationsdateien nur in UTF-8-Kodierung ohne BOM;
  • Kommentare, die mit # beginnen, werden nur am Zeilenanfang 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 die Debug-Stufe an:

  • 0 - grundlegende Informationen zum Starten und Stoppen von Zabbix-Prozessen;
  • 1 - kritische Informationen;
  • 2 - Fehlerinformationen;
  • 3 - Warnungen;
  • 4 - zum Debuggen (liefert viele Informationen);
  • 5 - erweitertes Debugging (liefert noch mehr Informationen).

Standard: 3
Bereich: 0-5

IgnoreURLCertErrors

Gibt die Behandlung von TLS-Zertifikatvalidierungsfehlern beim Zugriff auf die Frontend-URL an:
0 - Zertifikatfehler nicht ignorieren;
1 - Zertifikatfehler ignorieren.

Standard: 0
Bereich: 0-1

Include

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

Der Pfad kann relativ zum Speicherort der Datei zabbix_web_service.conf sein.
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 eingebundenen Dateien müssen eine korrekte Syntax haben; andernfalls wird der Agent nicht gestartet.
Alle eingebundenen Dateien müssen lesbar sein.

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

Wenn ein Verzeichnis eingebunden wird, achten Sie auf Sicherungskopien von Dateien, die von einigen Texteditoren automatisch erstellt werden. Beim Bearbeiten der Datei include/my_specific.conf kann beispielsweise eine Sicherungskopie include/my_specific_conf.BAK erzeugt werden; beide Dateien werden dann eingebunden. Verwenden Sie unter Linux den Befehl ls -al, um den Inhalt des Verzeichnisses include auf unnötige Dateien zu überprüfen.

Um nur relevante Dateien aus dem angegebenen Verzeichnis einzubinden, 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.

Standardwert: 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:

  • 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.