4 Zabbix Agent 2 (UNIX)

Übersicht

Zabbix Agent 2 ist eine neue Generation des Zabbix Agent und kann anstelle des Zabbix Agent verwendet werden.

Die von der Konfigurationsdatei des Zabbix Agent 2 (zabbix_agent2.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
Alias Legt einen Alias für einen Datenpunkt-Schlüssel fest.
AllowKey Erlaubt die Ausführung derjenigen Datenpunkt-Schlüssel, die einem Muster entsprechen.
BufferSend Daten nicht länger als N Sekunden im Puffer behalten.
BufferSize Die maximale Anzahl von Werten im Speicherpuffer.
ControlSocket Der Steuersocket, der zum Senden von Laufzeitbefehlen mit der Option -R verwendet wird.
DebugLevel Die Debug-Stufe.
DenyKey Verweigert die Ausführung derjenigen Datenpunkt-Schlüssel, die einem Muster entsprechen.
EnablePersistentBuffer Aktiviert die Verwendung des lokalen persistenten Speichers für aktive Datenpunkte.
ForceActiveChecksOnStart Führt aktive Prüfungen unmittelbar nach dem Neustart für die zuerst empfangene Konfiguration aus.
HeartbeatFrequency Die Häufigkeit der Heartbeat-Nachrichten in Sekunden.
HostInterface Ein optionaler Parameter, der die Host-Schnittstelle definiert.
HostInterfaceItem Ein optionaler Parameter, der einen Datenpunkt definiert, der zum Abrufen der Host-Schnittstelle verwendet wird.
HostMetadata Ein optionaler Parameter, der die Host-Metadaten definiert.
HostMetadataItem Ein optionaler Parameter, der einen Zabbix Agent-Datenpunkt definiert, der zum Abrufen der Host-Metadaten verwendet wird.
Hostname Ein optionaler Parameter, der den Hostnamen definiert.
HostnameItem Ein optionaler Parameter, der einen Zabbix Agent-Datenpunkt definiert, der zum Abrufen des Hostnamens verwendet wird.
Include Sie können einzelne Dateien oder alle Dateien in einem Verzeichnis in die Konfigurationsdatei einbinden.
ListenIP Eine durch Kommas getrennte Liste von IP-Adressen, auf denen der Agent lauschen soll.
ListenPort Der Agent 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.
PersistentBufferFile Die Datei, in der Zabbix Agent 2 die SQLite-Datenbank speichern soll.
PersistentBufferPeriod Der Zeitraum, für den Daten gespeichert werden sollen, wenn keine Verbindung zum Server oder Proxy besteht.
PidFile Der Name der PID-Datei.
Plugins.<PluginName>.System.Capacity Das Limit der Prüfungen pro Plugin, die gleichzeitig ausgeführt werden können.
Plugins.Log.MaxLinesPerSecond Die maximale Anzahl neuer Zeilen, die der Agent pro Sekunde an den Zabbix Server oder Proxy sendet, wenn die aktiven Prüfungen 'log' und 'logrt' verarbeitet werden.
Plugins.SystemRun.LogRemoteCommands Aktiviert die Protokollierung der ausgeführten Shell-Befehle als Warnungen.
PluginSocket Der Pfad zum UNIX-Socket für die Kommunikation mit ladbaren Plugins.
PluginTimeout Das Zeitlimit für Verbindungen mit ladbaren Plugins, in Sekunden.
RefreshActiveChecks Wie oft die Liste der aktiven Prüfungen aktualisiert wird.
Server Eine durch Kommas getrennte Liste von IP-Adressen, optional in CIDR-Notation, oder DNS-Namen von Zabbix Servern und Zabbix Proxies.
ServerActive Die Adresse des Zabbix Server/Proxy oder die Cluster-Konfiguration, von der aktive Prüfungen abgerufen werden.
SourceIP Die Quell-IP-Adresse.
StatusPort Wenn gesetzt, lauscht der Agent auf diesem Port auf HTTP-Statusanfragen (http://localhost:<port>/status).
Timeout Gibt an, wie lange beim Aufbau der Verbindung und beim Datenaustausch mit dem Zabbix Proxy oder Server gewartet werden soll (in Sekunden).
TLSAccept Die für eingehende Verbindungen erforderliche Verschlüsselungsstufe.
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 Agent-Zertifikat oder der Zertifikatskette, verwendet für verschlüsselte Kommunikation zwischen Zabbix-Komponenten.
TLSCipherAll Die OpenSSL-Cipher-String (TLS 1.2). Überschreibt die Standardauswahlkriterien für Cipher Suites für zertifikats- und PSK-basierte Verschlüsselung.
TLSCipherAll13 Die OpenSSL-Cipher-String (TLS 1.3) für OpenSSL 1.1.1 oder neuer. Überschreibt die Standardauswahlkriterien für Cipher Suites für zertifikats- und PSK-basierte Verschlüsselung.
TLSCipherCert Die OpenSSL-Cipher-String (TLS 1.2). Überschreibt die Standardauswahlkriterien für Cipher Suites für zertifikatsbasierte Verschlüsselung.
TLSCipherCert13 Die OpenSSL-Cipher-String (TLS 1.3) für OpenSSL 1.1.1 oder neuer. Überschreibt die Standardauswahlkriterien für Cipher Suites für zertifikatsbasierte Verschlüsselung.
TLSCipherPSK Die OpenSSL-Cipher-String (TLS 1.2). Überschreibt die Standardauswahlkriterien für Cipher Suites für PSK-basierte Verschlüsselung.
TLSCipherPSK13 Die OpenSSL-Cipher-String (TLS 1.3) für OpenSSL 1.1.1 oder neuer. Überschreibt die Standardauswahlkriterien für Cipher Suites für PSK-basierte Verschlüsselung.
TLSConnect Die für Verbindungen des Agent zum Zabbix Server oder Proxy erforderliche Verschlüsselungsstufe.
TLSCRLFile Der vollständige Pfad zu einer Datei mit widerrufenen Zertifikaten. Dieser Parameter wird für verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet.
TLSKeyFile Der vollständige Pfad zu einer Datei mit dem privaten Schlüssel des Agent, verwendet für verschlüsselte Kommunikation zwischen Zabbix-Komponenten.
TLSPSKFile Der vollständige Pfad zu einer Datei mit dem vorab gemeinsam genutzten Schlüssel des Agent, verwendet für verschlüsselte Kommunikation mit dem Zabbix Server.
TLSPSKIdentity Die Identitätszeichenfolge des vorab gemeinsam genutzten Schlüssels, verwendet für verschlüsselte Kommunikation mit dem Zabbix Server.
TLSServerCertIssuer Der zulässige Aussteller des Server- (Proxy-) Zertifikats.
TLSServerCertSubject Der zulässige Betreff des Server- (Proxy-) Zertifikats.
UnsafeUserParameters Erlaubt, dass alle Zeichen in Argumenten an benutzerdefinierte Parameter übergeben werden.
UserParameter Ein zu überwachender benutzerdefinierter Parameter.
UserParameterDir Der standardmäßige Suchpfad für UserParameter-Befehle.

Alle Parameter sind nicht obligatorisch, sofern nicht ausdrücklich angegeben wird, 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

Alias

Legt einen Alias für einen Datenpunkt-Schlüssel fest. Er kann verwendet werden, um einen langen und komplexen Datenpunkt-Schlüssel durch einen kürzeren und einfacheren zu ersetzen.
Es können mehrere Alias-Parameter vorhanden sein. Mehrere Parameter mit demselben Alias-Schlüssel sind nicht zulässig.
Verschiedene Alias-Schlüssel können auf denselben Datenpunkt-Schlüssel verweisen.
Aliase können in HostMetadataItem verwendet werden, jedoch nicht im Parameter HostnameItem.

Beispiel 1: Abrufen der ID des Benutzers zabbix.

Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1]

Nun kann der Kurzschlüssel zabbix.userid verwendet werden, um Daten abzurufen.

Beispiel 2: Ermitteln der CPU-Auslastung mit Standard- und benutzerdefinierten Parametern.

Alias=cpu.util:system.cpu.util
Alias=cpu.util[*]:system.cpu.util[*]

Dadurch kann der Schlüssel cpu.util verwendet werden, um den CPU-Auslastungsprozentsatz mit Standardparametern abzurufen, sowie cpu.util[all, idle, avg15], um spezifische Daten zur CPU-Auslastung zu erhalten.

Beispiel 3: Ausführen mehrerer Low-Level-Discovery-Regeln, die dieselben Discovery-Elemente verarbeiten.

Alias=vfs.fs.discovery[*]:vfs.fs.discovery

Nun ist es möglich, mehrere Discovery-Regeln mit vfs.fs.discovery und unterschiedlichen Parametern für jede Regel einzurichten, z. B. vfs.fs.discovery[foo], vfs.fs.discovery[bar] usw.

AllowKey

Erlaubt die Ausführung derjenigen Datenpunkt-Schlüssel, die einem Muster entsprechen. Das Schlüsselmuster ist ein Wildcard-Ausdruck, der das Zeichen * unterstützt, um eine beliebige Anzahl beliebiger Zeichen abzugleichen.
Mehrere Regeln für den Schlüsselabgleich können in Kombination mit DenyKey definiert werden. Die Parameter werden nacheinander entsprechend ihrer Reihenfolge verarbeitet. Siehe auch: Einschränken von Agent-Prüfungen.

BufferSend

Das Zeitintervall in Sekunden, das bestimmt, wie oft Werte aus dem Puffer an den Zabbix Server gesendet werden. Beachten Sie, dass die Daten früher gesendet werden, wenn der Puffer voll ist.

Standard: 5
Bereich: 1-3600

BufferSize

Die maximale Anzahl von Werten im Speicherpuffer. Der Agent sendet alle gesammelten Daten an den Zabbix-Server oder Proxy, wenn der Puffer voll ist. Dieser Parameter sollte nur verwendet werden, wenn der persistente Puffer deaktiviert ist (EnablePersistentBuffer=0).

Standard: 1000
Bereich: 2-65535

ControlSocket

Der Control-Socket, der verwendet wird, um Laufzeitbefehle mit der Option -R zu senden.

Standard: /tmp/agent.sock

DebugLevel

Geben Sie den Debug-Level an:

  • 0 - grundlegende Informationen zum 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

DenyKey

Verweigert die Ausführung derjenigen Datenpunkt-Schlüssel, die einem Muster entsprechen.
Das Schlüssel-Muster ist ein Platzhalterausdruck, der das Zeichen * unterstützt, um eine beliebige Anzahl beliebiger Zeichen abzugleichen.
Mehrere Regeln für den Schlüsselabgleich können in Kombination mit AllowKey definiert werden. Die Parameter werden nacheinander entsprechend ihrer Reihenfolge verarbeitet. Siehe auch: Einschränken von Agent-Prüfungen.

EnablePersistentBuffer

Aktiviert die Verwendung des lokalen persistenten Speichers für aktive Datenpunkte. Wenn der persistente Speicher deaktiviert ist, wird der Speicherpuffer verwendet.

Standard: 0
Werte: 0 - deaktiviert, 1 - aktiviert

ForceActiveChecksOnStart

Aktive Prüfungen unmittelbar nach dem Neustart für die zuerst empfangene Konfiguration ausführen. Auch als Konfigurationsparameter pro Plugin verfügbar, zum Beispiel: Plugins.Uptime.System.ForceActiveChecksOnStart=1

Standard: 0
Werte: 0 - deaktiviert, 1 - aktiviert

HeartbeatFrequency

Die Häufigkeit von Heartbeat-Nachrichten in Sekunden. Wird zur Überwachung der Verfügbarkeit aktiver Checks verwendet.
0 - Heartbeat-Nachrichten deaktiviert.

Standard: 60
Bereich: 0-3600

HostInterface

Ein optionaler Parameter, der die Host-Schnittstelle (IP-Adresse oder DNS-Name) definiert, die während des Host-Autoregistrierungs-Prozesses verwendet wird. Dieser Wert wird verwendet, um die Schnittstelle im neu erstellten Host zu befüllen, und ermöglicht die explizite Konfiguration entweder einer IP- oder DNS-Adresse. Weitere Informationen finden Sie unter Using DNS as default interface.

Wenn nicht definiert, wird der Wert aus HostInterfaceItem übernommen.

Der Agent gibt einen Fehler aus und startet nicht, wenn der Wert die Grenze von 255 Zeichen überschreitet.

Bereich: 0-255 Zeichen

HostInterfaceItem

Ein optionaler Parameter, der einen Datenpunkt definiert, der verwendet wird, um die Host-Schnittstelle (IP-Adresse oder DNS-Name) während des Host-Autoregistrierungs-Prozesses zu bestimmen. Dieser Wert wird nur verwendet, wenn HostInterface nicht definiert ist. Weitere Informationen finden Sie unter DNS als Standard-Schnittstelle verwenden.

Während einer Autoregistrierungsanforderung protokolliert der Agent eine Warnmeldung, wenn der vom angegebenen Datenpunkt zurückgegebene Wert die Grenze von 255 Zeichen überschreitet.

Der Datenpunkt system.run[] wird unabhängig von den Einstellungen AllowKey/DenyKey unterstützt.

HostMetadata

Ein optionaler Parameter, der die Metadaten definiert, die verwendet werden, um den Host während des Host-Autoregistrierung-Prozesses zu identifizieren oder zu unterscheiden. HostMetadata ermöglicht die Unterscheidung zwischen Hosts über den Hostnamen hinaus.

Wenn nicht definiert, wird der Wert aus HostMetadataItem übernommen.

Der Agent gibt einen Fehler aus und startet nicht, wenn der angegebene Wert das Limit von 2034 Bytes überschreitet oder eine Nicht-UTF-8-Zeichenkette ist. Wenn ein Parameter eine IP-Adresse oder einen DNS-Namen erwartet, werden Werte, die zwar gültiges UTF-8 sind, aber keine gültigen IPs oder DNS-Namen darstellen, ebenfalls abgelehnt und als ungültig gemeldet.

Mehrzeilige Metadaten werden nicht unterstützt — die Ausgabe wird am ersten Zeilenumbruch abgeschnitten.

Bereich: 0-2034 Bytes

HostMetadataItem

Ein optionaler Parameter, der einen Zabbix Agent-Datenpunkt definiert, der zum Abrufen von Host-Metadaten verwendet wird. Diese Option wird nur verwendet, wenn HostMetadata nicht definiert ist.

Der Wert von HostMetadataItem wird bei jedem Autoregistrierungs-Versuch abgerufen und nur im Autoregistrierungsprozess des Hosts verwendet. HostMetadataItem ermöglicht es, Hosts über den Hostnamen hinaus zu unterscheiden.

Benutzerdefinierte Parameter und Aliase werden unterstützt. Der system.run[]-Datenpunkt wird unabhängig von den Einstellungen AllowKey/DenyKey unterstützt.

Während einer Autoregistrierungsanforderung protokolliert der Agent eine Warnmeldung, wenn der vom angegebenen Datenpunkt zurückgegebene Wert das Limit von 65535 UTF-8-Codepunkten überschreitet. Der vom Datenpunkt zurückgegebene Wert muss eine UTF-8-Zeichenkette sein, andernfalls wird er ignoriert. Wenn ein Parameter eine IP-Adresse oder einen DNS-Namen erwartet, werden Werte, die zwar gültiges UTF-8 sind, aber keine gültigen IPs oder DNS-Namen darstellen, ebenfalls abgelehnt und als ungültig gemeldet.

Mehrzeilige Metadaten werden nicht unterstützt — die Ausgabe wird nach dem ersten Zeilenumbruch abgeschnitten.

Hostname

Eine Liste durch Kommas getrennter, eindeutiger, groß-/kleinschreibungssensitiver Hostnamen. Erforderlich für aktive Prüfungen und muss mit den auf dem Server konfigurierten Hostnamen übereinstimmen. Der Wert wird aus HostnameItem übernommen, wenn er nicht definiert ist.
Zulässige Zeichen: alphanumerisch, '.', ' ', '_' und '-'. Maximale Länge: 128 Zeichen pro Hostname, 2048 Zeichen für die gesamte Zeile.

Standard: Durch HostnameItem festgelegt

HostnameItem

Ein optionaler Parameter, der einen Datenpunkt definiert, der zum Abrufen des Hostnamens verwendet wird. Diese Option wird nur verwendet, wenn Hostname nicht definiert ist. Benutzerparameter oder Aliase werden nicht unterstützt, aber der system.run[] Datenpunkt wird unabhängig von den Werten AllowKey/DenyKey unterstützt.

Standard: system.hostname

Include

Sie können einzelne Dateien oder alle Dateien in einem Verzeichnis in die Konfigurationsdatei aufnehmen. Während der Installation erstellt Zabbix das Include-Verzeichnis in /usr/local/etc, sofern dies nicht zur Kompilierzeit geändert wurde. Der Pfad kann relativ zum Speicherort der Datei zabbix_agent2.conf sein.
Um nur relevante Dateien im angegebenen Verzeichnis einzuschließen, wird das Platzhalterzeichen Sternchen für die Mustererkennung unterstützt.
Siehe besondere Hinweise zu den Einschränkungen.

Beispiel:

Include=/absolute/path/to/config/files/*.conf
ListenIP

Eine Liste von durch Kommas getrennten IP-Adressen, auf denen der Agent lauschen soll. Die erste IP-Adresse wird an den Zabbix Server gesendet, falls eine Verbindung zu ihm hergestellt wird, um die Liste der aktiven Prüfungen abzurufen.

Standard: 0.0.0.0

ListenPort

Der Agent lauscht auf diesem Port auf Verbindungen vom Server.

Standard: 10050
Bereich: 1024-32767

LogFile

Der Name der Protokolldatei.

Standard: /tmp/zabbix_agent2.log
Erforderlich: Ja, wenn LogType auf file gesetzt ist; andernfalls nein

LogFileSize

Die maximale Größe einer Logdatei in MB.
0 - automatische Logrotation deaktivieren.
Hinweis: Wenn die Größenbegrenzung der Logdatei erreicht wird und die Dateirotation aus irgendeinem Grund fehlschlägt, wird die vorhandene Logdatei 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

PersistentBufferFile

Die Datei, in der Zabbix Agent 2 die SQLite-Datenbank speichern soll. Es muss ein vollständiger Dateiname angegeben werden. Dieser Parameter wird nur verwendet, wenn der persistente Puffer aktiviert ist (EnablePersistentBuffer=1).

PersistentBufferPeriod

Der Zeitraum, für den Daten gespeichert werden sollen, wenn keine Verbindung zum Server oder Proxy besteht. Ältere Daten gehen verloren. Logdaten bleiben erhalten. Dieser Parameter wird nur verwendet, wenn der persistente Puffer aktiviert ist (EnablePersistentBuffer=1).

Standard: 1h
Bereich: 1m-365d

PidFile

Der Name der PID-Datei.

Standard: /tmp/zabbix_agent2.pid

Plugins.<PluginName>.System.Capacity

Das Limit für Prüfungen pro Plugin <PluginName>, die gleichzeitig ausgeführt werden können.

Standard: 1000 Bereich: 1-1000

Plugins.Log.MaxLinesPerSecond

Die maximale Anzahl neuer Zeilen, die der Agent pro Sekunde an den Zabbix Server oder Proxy sendet, wenn log- und logrt-aktive Prüfungen verarbeitet werden. Der angegebene Wert wird durch den Parameter maxlines überschrieben, der im log- und logrt-Datenpunktschlüssel angegeben ist.
Hinweis: Zabbix verarbeitet 10-mal mehr neue Zeilen als in MaxLinesPerSecond festgelegt, um in Log-Datenpunkten nach der erforderlichen Zeichenfolge zu suchen.

Standard: 20
Bereich: 1-1000

Plugins.SystemRun.LogRemoteCommands

Aktiviert die Protokollierung der ausgeführten Shell-Befehle als Warnungen.
Die Befehle werden nur protokolliert, wenn sie remote ausgeführt werden.
Protokolleinträge werden nicht erstellt, wenn system.run[] lokal über die Parameter HostMetadataItem, HostInterfaceItem oder HostnameItem gestartet wird.

Standard: 0
Werte: 0 - deaktiviert, 1 - aktiviert

PluginSocket

Der Pfad zum UNIX-Socket für die Kommunikation mit ladbaren Plugins.

Standard: /tmp/agent.plugin.sock

PluginTimeout

Das Zeitlimit für Verbindungen mit ladbaren Plugins, in Sekunden.

Standard: Timeout
Bereich: 1-30

RefreshActiveChecks

Wie oft die Liste der aktiven Prüfungen aktualisiert wird, in Sekunden. Beachten Sie, dass nach einem fehlgeschlagenen Aktualisieren der aktiven Prüfungen die nächste Aktualisierung in 60 Sekunden versucht wird.

Standard: 5
Bereich: 1-86400

Server

Eine Liste durch Kommas getrennter IP-Adressen, optional in CIDR-Notation, oder DNS-Namen von Zabbix-Servern oder 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. Leerzeichen sind erlaubt. Wenn dieser Parameter nicht angegeben ist, werden passive Prüfungen deaktiviert und der Agent lauscht auf keinem TCP-Port.

Beispiel:

Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com
ServerActive

Die Adresse des Zabbix Server/Proxy oder die Cluster-Konfiguration, von der aktive Prüfungen abgerufen werden. Die Server/Proxy-Adresse ist eine IP-Adresse oder ein DNS-Name sowie ein optionaler, durch einen Doppelpunkt getrennter Port.
Die Cluster-Konfiguration besteht aus einer oder mehreren, durch Semikolon getrennten Adressen von Mitgliedern einer Server- oder Proxy-Gruppe. Es können mehrere Zabbix Server/Cluster und Zabbix Proxys angegeben werden, getrennt durch Komma. Sofern keine Proxy-Gruppen verwendet werden, sollte von jedem Zabbix Server/Cluster nicht mehr als ein Zabbix Proxy angegeben werden. Wenn ein Zabbix Proxy angegeben ist, sollte der Zabbix Server/das Zabbix Cluster für diesen Proxy nicht angegeben werden.
Es können mehrere durch Komma getrennte Adressen angegeben werden, um mehrere unabhängige Zabbix Server parallel zu verwenden. Leerzeichen sind zulässig.
Wenn kein Port angegeben ist, wird der Standardport verwendet.
IPv6-Adressen müssen in eckige Klammern gesetzt werden, wenn für diesen Host ein Port angegeben ist. Wenn kein Port angegeben ist, sind eckige Klammern bei IPv6-Adressen optional.
Wenn dieser Parameter nicht angegeben ist, sind aktive Prüfungen deaktiviert.

Beispiel für Zabbix Proxy:

ServerActive=127.0.0.1:10051

Beispiel für eine Zabbix Proxy-Gruppe:

ServerActive=proxy1.example.com;proxy2.example.com;proxy3.example.com;proxy4.example.com;proxy5.example.com

Beispiel für mehrere Server:

ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1]

Beispiel für Hochverfügbarkeit:

ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3

Beispiel für Hochverfügbarkeit mit zwei Clustern und einem Server:

ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain
SourceIP

Die Quell-IP-Adresse für:

  • ausgehende Verbindungen zum Zabbix Server oder Zabbix Proxy.
  • Verbindungen, die beim Ausführen bestimmter Datenpunkte (web.page.get, net.tcp.port usw.) hergestellt werden.
StatusPort

Falls gesetzt, lauscht der Agent auf diesem Port auf HTTP-Statusanfragen (http://localhost:<port>/status).

Bereich: 1024-32767

Timeout

Gibt an, wie lange (in Sekunden) auf den Verbindungsaufbau und den Datenaustausch mit dem Zabbix Proxy oder Server gewartet wird.

Dieser Parameter definiert die Dauer verschiedener Kommunikationsvorgänge, darunter:

  • Warten auf eine Antwort vom Zabbix Server;
  • Senden von Anfragen an den Zabbix Server, einschließlich Anfragen zur Datenpunkt-Konfiguration und Datenpunkt-Daten bei aktiven Checks;
  • Abrufen von Log-Daten über logfile;
  • Senden von Heartbeat-Nachrichten;
  • maximale Dauer für vfs.*-Prüfungen;
  • Verwendung als Fallback in Szenarien, in denen ein Server oder Proxy älter als Version 7.0 Checks ohne Timeouts sendet.

Dieses Timeout wird nicht für jene Agent-Checks verwendet, deren Timeout-Einstellungen im Frontend konfigurierbar sind (global, auf Proxy-Ebene oder pro Datenpunkt).

Standard: 3
Bereich: 1-30

TLSAccept

Der für eingehende Verbindungen erforderliche Verschlüsselungsgrad. Wird für passive Prüfungen verwendet. Es können mehrere Werte angegeben werden, getrennt durch Kommas:

  • unencrypted - Verbindungen ohne Verschlüsselung akzeptieren (Standard);
  • psk - Verbindungen mit TLS und einem vorab gemeinsam genutzten Schlüssel (PSK) akzeptieren;
  • cert - Verbindungen mit TLS und einem Zertifikat akzeptieren.

Pflicht: ja, wenn TLS-Zertifikat- oder PSK-Parameter definiert sind (auch für eine unencrypted Verbindung); andernfalls nein

TLSCAFile

Der vollständige Pfadname der Datei, die die Zertifikate der obersten CA(s) 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 Agent-Zertifikat oder die Zertifikatskette enthält und für die verschlüsselte Kommunikation mit Zabbix-Komponenten verwendet wird.

TLSCipherAll

Die OpenSSL-Chiffrezeichenfolge (TLS 1.2). Überschreibt die standardmäßigen Auswahlkriterien für Chiffresuiten bei zertifikats- und PSK-basierter Verschlüsselung.

Beispiel:

EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128
TLSCipherAll13

Die OpenSSL-Chiffrezeichenfolge (TLS 1.3) für OpenSSL 1.1.1 oder neuer. Überschreibt die standardmäßigen Auswahlkriterien für Chiffriersuiten für zertifikats- und PSK-basierte Verschlüsselung.

Beispiel:

TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSCipherCert

Die OpenSSL-Cipher-String (TLS 1.2). Überschreiben Sie die standardmäßigen Auswahlkriterien für die Ciphersuite bei zertifikatsbasierter Verschlüsselung.

Beispiel:

EECDH+aRSA+AES128:RSA+aRSA+AES128

Beachten Sie, dass dieser Parameter nicht zusammen mit TLSAccept=cert,psk verwendet werden kann; für eine Zertifikatsverbindung (TLSConnect=cert) verwenden Sie stattdessen TLSCipherAll.

TLSCipherCert13

Die OpenSSL-Cipher-String (TLS 1.3) für OpenSSL 1.1.1 oder neuer. Überschreiben Sie die standardmäßigen Auswahlkriterien für die Cipher Suite bei zertifikatsbasierter Verschlüsselung.

Beachten Sie, dass dieser Parameter nicht zusammen mit TLSAccept=cert,psk verwendet werden kann; für eine Zertifikatsverbindung (TLSConnect=cert) verwenden Sie stattdessen TLSCipherAll13.

TLSCipherPSK

Die OpenSSL-Chiffrezeichenfolge (TLS 1.2). Überschreibt die standardmäßigen Auswahlkriterien der Chiffre-Suite für PSK-basierte Verschlüsselung.

Beispiel:

kECDHEPSK+AES128:kPSK+AES128
TLSCipherPSK13

Die OpenSSL-Chiffrezeichenfolge (TLS 1.3) für OpenSSL 1.1.1 oder neuer. Überschreibt die standardmäßigen Auswahlkriterien der Chiffriersuite für PSK-basierte Verschlüsselung.

Beispiel:

TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSConnect

Die für Verbindungen des Agent zu Zabbix Server oder Proxy erforderliche Verschlüsselungsstufe. Wird für aktive Prüfungen verwendet. Es kann nur ein Wert angegeben werden:

  • unencrypted - Verbindung ohne Verschlüsselung herstellen (Standard);
  • psk - Verbindung mit TLS und einem vorab gemeinsam genutzten Schlüssel (PSK) herstellen;
  • cert - Verbindung mit TLS und einem Zertifikat herstellen.

Pflicht: ja, wenn TLS-Zertifikat- oder PSK-Parameter definiert sind (auch für eine unencrypted Verbindung); andernfalls nein

TLSCRLFile

Der vollständige Pfadname der Datei, die gesperrte Zertifikate enthält. Dieser Parameter wird für die verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet.

TLSKeyFile

Der vollständige Pfadname der Datei, die den privaten Schlüssel des Agent enthält und für die verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet wird.

TLSPSKFile

Der vollständige Pfadname der Datei, die den vorab geteilten Schlüssel des Agent enthält und für die verschlüsselte Kommunikation mit dem Zabbix Server verwendet wird.

TLSPSKIdentity

Die Identitätszeichenfolge des vorab geteilten Schlüssels, die für die verschlüsselte Kommunikation mit dem Zabbix Server verwendet wird.

TLSServerCertIssuer

Der zulässige Aussteller des Server-(Proxy-)Zertifikats.

TLSServerCertSubject

Der zulässige Zertifikat-Betreff des Servers (Proxy).

UnsafeUserParameters

Erlaubt, dass alle Zeichen in Argumenten an benutzerdefinierte Parameter übergeben werden. Die folgenden Zeichen sind nicht erlaubt: \ ' " ` * ? [ ] { } \~ $ ! & ; ( ) < > | # @
Zusätzlich sind Zeilenumbrüche nicht erlaubt.

Standard: 0
Werte: 0 - nicht erlauben, 1 - erlauben

UserParameter

Ein benutzerdefinierter Parameter zur Überwachung. Es können mehrere benutzerdefinierte Parameter vorhanden sein.
Format: UserParameter=<key>,<shell command>
Beachten Sie, dass der Shell-Befehl keinen leeren String oder nur EOL zurückgeben darf. Shell-Befehle dürfen relative Pfade verwenden, wenn der Parameter UserParameterDir angegeben ist.

Beispiel:

UserParameter=system.test,who|wc -l
UserParameter=check_cpu,./custom_script.sh
UserParameterDir

Der standardmäßige Suchpfad für UserParameter-Befehle. Wenn diese Option verwendet wird, wechselt der Agent sein Arbeitsverzeichnis vor der Ausführung eines Befehls in das hier angegebene Verzeichnis. Dadurch können UserParameter-Befehle ein relatives Präfix ./ anstelle eines vollständigen Pfads verwenden.
Es ist nur ein Eintrag zulässig.

Beispiel:

UserParameterDir=/opt/myscripts