Konfigurationsparameter: Zabbix Agent 2
Übersicht
Konfigurationsparameter ermöglichen die Anpassung des Verhaltens von Zabbix agent 2.
Zabbix agent 2 ist eine neue Generation des Zabbix Agent und kann anstelle von Zabbix Agent verwendet werden.
Geben Sie die Parameterwerte in der Konfigurationsdatei (zabbix_agent2.conf) an. Alle Parameter sind optional, sofern nicht ausdrücklich angegeben ist, dass der Parameter obligatorisch ist.
Diese Seite ist wie folgt aufgebaut:
- Parameterübersicht (um die vollständigen Details eines Parameters anzuzeigen, klicken Sie auf seinen Namen)
- Parameterdetails
| 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 | Legt die Häufigkeit fest, mit der Werte aus dem Puffer an den Zabbix Server/Proxy gesendet werden. |
| BufferSize | Legt die maximale Anzahl von Werten im Speicherpuffer fest. |
| ControlSocket | Gibt den Steuer-Socket für das Senden von Laufzeitbefehlen mit der Option '-R' an. |
| DebugLevel | Legt den Debug-Level fest. |
| DenyKey | Verweigert die Ausführung derjenigen Datenpunkt-Schlüssel, die einem Muster entsprechen. |
| EnablePersistentBuffer | Aktiviert die Verwendung eines 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 | Legt die Häufigkeit von Heartbeat-Nachrichten in Sekunden fest. |
| HostInterface | Gibt die Host-Schnittstelle an. |
| HostInterfaceItem | Gibt einen Datenpunkt zum Abrufen der Host-Schnittstelle an. |
| HostMetadata | Gibt die Host-Metadaten an. |
| HostMetadataItem | Gibt einen Zabbix Agent-Datenpunkt zum Abrufen der Host-Metadaten an. |
| Hostname | Gibt den Hostnamen an. |
| HostnameItem | Gibt einen Zabbix Agent-Datenpunkt zum Abrufen des Hostnamens an. |
| Include | Gibt ein Verzeichnis oder einzelne Dateien an, die in die Konfigurationsdatei aufgenommen werden sollen. |
| ListenIP | Gibt die IP-Adresse an, auf der der Agent Verbindungen vom Server/Proxy entgegennimmt. |
| ListenPort | Gibt den Listen-Port des Agent an. |
| LogFile | Gibt die Protokolldatei des Agent an. |
| LogFileSize | Legt die maximale Größe der Protokolldatei fest. |
| LogType | Gibt den Typ der Protokollausgabe an. |
| PersistentBufferFile | Gibt die Datei zum Speichern der SQLite-Datenbank an. |
| PersistentBufferPeriod | Legt den Zeitraum fest, in dem Daten gespeichert werden, wenn keine Verbindung zum Zabbix Server oder Proxy besteht. |
| PidFile | Gibt die PID-Datei an. |
| Plugins.<PluginName>.System.Capacity | Legt das Limit der Prüfungen pro Plugin fest, die gleichzeitig ausgeführt werden können. |
| Plugins.Log.MaxLinesPerSecond | Legt die maximale Anzahl neuer Zeilen pro Sekunde fest, die beim Verarbeiten von aktiven log- oder logrt-Prüfungen an den Zabbix Server/Proxy gesendet werden. |
| Plugins.SystemRun.LogRemoteCommands | Aktiviert die Protokollierung der ausgeführten Shell-Befehle als Warnungen. |
| PluginSocket | Gibt den Pfad zum UNIX-Socket für die Kommunikation mit ladbaren Plugins an. |
| PluginTimeout | Legt das Timeout für Verbindungen zu ladbaren Plugins fest. |
| RefreshActiveChecks | Gibt die Häufigkeit der Aktualisierung der Liste aktiver Prüfungen an. |
| Server | Gibt die IP-Adressen oder DNS-Namen von Zabbix Servern/Proxys an. |
| ServerActive | Gibt die Adresse des Zabbix Server/Proxy oder die Cluster-Konfiguration an, von der aktive Prüfungen abgerufen werden. |
| SourceIP | Gibt die Quell-IP-Adresse an. |
| StatusPort | Gibt den Port für das Lauschen auf HTTP-Statusanfragen an (http://localhost:<port>/status). |
| Timeout | Gibt an, wie lange beim Aufbau der Verbindung und beim Datenaustausch mit dem Zabbix Server oder Proxy gewartet werden soll (in Sekunden). |
| TLSAccept | Gibt das für eingehende Verbindungen erforderliche Verschlüsselungsniveau an. |
| TLSCAFile | Gibt den vollständigen Pfad zur Datei mit den Zertifikaten der obersten CA(s) für die Überprüfung von Peer-Zertifikaten an, die für verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet werden. |
| TLSCertFile | Gibt den vollständigen Pfad zur Datei mit dem Agent-Zertifikat oder der Zertifikatskette an, die für verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet werden. |
| TLSCipherAll | Gibt die OpenSSL-Cipher-String (TLS 1.2) an. Überschreibt die Standardkriterien für die Auswahl der Cipher-Suite für zertifikats- und PSK-basierte Verschlüsselung. |
| TLSCipherAll13 | Gibt die OpenSSL-Cipher-String (TLS 1.3) für OpenSSL 1.1.1 oder neuer an. Überschreibt die Standardkriterien für die Auswahl der Cipher-Suite für zertifikats- und PSK-basierte Verschlüsselung. |
| TLSCipherCert | Gibt die OpenSSL-Cipher-String (TLS 1.2) an. Überschreibt die Standardkriterien für die Auswahl der Cipher-Suite für zertifikatsbasierte Verschlüsselung. |
| TLSCipherCert13 | Gibt die OpenSSL-Cipher-String (TLS 1.3) für OpenSSL 1.1.1 oder neuer an. Überschreibt die Standardkriterien für die Auswahl der Cipher-Suite für zertifikatsbasierte Verschlüsselung. |
| TLSCipherPSK | Gibt die OpenSSL-Cipher-String (TLS 1.2) an. Überschreibt die Standardkriterien für die Auswahl der Cipher-Suite für PSK-basierte Verschlüsselung. |
| TLSCipherPSK13 | Gibt die OpenSSL-Cipher-String (TLS 1.3) für OpenSSL 1.1.1 oder neuer an. Überschreibt die Standardkriterien für die Auswahl der Cipher-Suite für PSK-basierte Verschlüsselung. |
| TLSConnect | Gibt das für Verbindungen zum Zabbix Server oder Proxy erforderliche Verschlüsselungsniveau an. |
| TLSCRLFile | Gibt den vollständigen Pfad zur Datei mit widerrufenen Zertifikaten an. Dieser Parameter wird für verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet. |
| TLSKeyFile | Gibt den vollständigen Pfad zur Datei mit dem privaten Schlüssel des Agent an, der für verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet wird. |
| TLSPSKFile | Gibt den vollständigen Pfad zur Datei mit dem vorab gemeinsam genutzten Schlüssel des Agent an, der für verschlüsselte Kommunikation mit dem Zabbix Server verwendet wird. |
| TLSPSKIdentity | Gibt die Identitätszeichenfolge des vorab gemeinsam genutzten Schlüssels an, die für verschlüsselte Kommunikation mit dem Zabbix Server verwendet wird. |
| TLSServerCertIssuer | Gibt den zulässigen Aussteller des Server-(Proxy-)Zertifikats an. |
| TLSServerCertSubject | Gibt das zulässige Subject des Server-(Proxy-)Zertifikats an. |
| UnsafeUserParameters | Erlaubt, dass alle Zeichen in Argumenten an benutzerdefinierte Parameter übergeben werden. |
| UserParameter | Gibt einen zu überwachenden benutzerdefinierten Parameter an. |
| UserParameterDir | Gibt den standardmäßigen Suchpfad für UserParameter-Befehle an. |
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
Setzen Sie einen Alias für einen Datenpunkt-Schlüssel.
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üssel-Muster ist ein Wildcard-Ausdruck, der das Zeichen "*" unterstützt, um eine beliebige Anzahl beliebiger Zeichen zu matchen.
Mehrere Regeln für die Schlüsselübereinstimmung können in Kombination mit DenyKey definiert werden.
Die Parameter werden nacheinander entsprechend ihrer Reihenfolge verarbeitet.
Siehe auch: Restricting agent checks.
BufferSend
Legt die Häufigkeit fest, mit der Werte aus dem Puffer an den Zabbix-Server/Proxy gesendet werden (in Sekunden).
Beachten Sie, dass die Daten früher gesendet werden, wenn der Puffer voll ist.
Standard: 5
Bereich: 1-3600
BufferSize
Legt die maximale Anzahl von Werten im Speicherpuffer fest.
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
Geben Sie den Control-Socket an, um Laufzeitbefehle mit der Option -R zu senden.
Standard: /tmp/agent.sock
DebugLevel
Legt den Debug-Level fest:
0 - grundlegende Informationen zum Starten und Stoppen von Zabbix-Prozessen
1 - kritische Informationen;
2 - Fehlerinformationen;
3 - Warnungen;
4 - für die Fehlersuche (liefert viele Informationen);
5 - erweiterte Fehlersuche (liefert noch mehr Informationen).
Standard: 3
Bereich: 0-5
DenyKey
Verweigert 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 zu matchen.
Mehrere Regeln für die Schlüsselübereinstimmung 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
Führe aktive Prüfungen unmittelbar nach dem Neustart für die zuerst empfangene Konfiguration aus.
Auch als Konfigurationsparameter pro Plugin verfügbar, zum Beispiel: Plugins.Uptime.System.ForceActiveChecksOnStart=1
Standard: 0
Werte: 0 - deaktiviert, 1 - aktiviert
HeartbeatFrequency
Legt die Frequenz der Heartbeat-Nachrichten in Sekunden fest.
Wird zur Überwachung der Verfügbarkeit aktiver Checks verwendet.
0 - Heartbeat-Nachrichten deaktiviert.
Standard: 60
Bereich: 0-3600
HostInterface
Geben Sie die Host-Schnittstelle an (IP-Adresse oder DNS-Name), die während der Autoregistrierung des Hosts 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 einer 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
Geben Sie einen Datenpunkt an, um die Host-Schnittstelle (IP-Adresse oder DNS-Name) während der Autoregistrierung des Hosts zu bestimmen.
Dieser Wert wird nur verwendet, wenn HostInterface nicht definiert ist.
Weitere Informationen finden Sie unter Using DNS as default interface.
Während einer Autoregistrierungsanforderung protokolliert der Agent eine Warnmeldung, wenn der vom angegebenen Datenpunkt zurückgegebene Wert das Limit von 255 Zeichen überschreitet.
Der system.run[]-Datenpunkt wird unabhängig von den AllowKey/DenyKey-Einstellungen unterstützt.
HostMetadata
Geben Sie die Metadaten an, die verwendet werden, um den Host während der Host-Autoregistrierung 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 es sich um eine Nicht-UTF-8-Zeichenfolge handelt. 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.
Bereich: 0-2034 Bytes
HostMetadataItem
Geben Sie einen Datenpunkt an, um Host-Metadaten abzurufen.
Diese Option wird nur verwendet, wenn HostMetadata nicht definiert ist.
Der Wert von HostMetadataItem wird bei jedem Autoregistrierungs-Versuch abgerufen und nur während des Host-Autoregistrierungsprozesses verwendet. HostMetadataItem ermöglicht die Unterscheidung zwischen Hosts über den Hostnamen hinaus.
Benutzerdefinierte Parameter und Aliase werden unterstützt. Der system.run[]-Datenpunkt wird unabhängig von den AllowKey/DenyKey-Einstellungen 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 IP-Adressen 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
Geben Sie eindeutige, zwischen Groß- und Kleinschreibung unterscheidende Hostnamen an. Eine durch Kommas getrennte Liste.
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: Wird durch HostnameItem festgelegt
HostnameItem
Geben Sie einen Datenpunkt an, um den Hostnamen abzurufen.
Diese Option wird nur verwendet, wenn Hostname nicht definiert ist.
Benutzerparameter oder Aliase werden nicht unterstützt, aber der Datenpunkt system.run[] wird unabhängig von den AllowKey/DenyKey-Werten unterstützt.
Standard: system.hostname
Einbinden
Geben Sie ein Verzeichnis oder einzelne Dateien an, die in die Konfigurationsdatei eingebunden werden sollen.
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 einzubinden, wird das Platzhalterzeichen Stern (*) für die Mustererkennung unterstützt.
Siehe besondere Hinweise zu den Einschränkungen.
Beispiel:
Include=/absolute/path/to/config/files/*.conf
ListenIP
Geben Sie die IP-Adresse an, auf der der Agent Verbindungen vom Server/Proxy entgegennimmt. Eine durch Kommas getrennte Liste.
Die erste IP-Adresse wird an den Zabbix-Server gesendet, wenn eine Verbindung zu ihm hergestellt wird, um die Liste der aktiven Prüfungen abzurufen.
Standard: 0.0.0.0
ListenPort
Geben Sie den Listen-Port des Agent für Verbindungen vom Server/Proxy an.
Standard: 10050
Bereich: 1024-32767
LogFile
Geben Sie die Logdatei des Agent an.
Standard: /tmp/zabbix_agent2.log
Erforderlich: Ja, wenn LogType auf file gesetzt ist; andernfalls nein
LogFileSize
Setzen Sie die maximale Größe der 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
Geben Sie den Typ der Protokollausgabe an:
file - schreibt das Protokoll in die durch den Parameter LogFile angegebene Datei;
system - schreibt das Protokoll in syslog;
console - schreibt das Protokoll in die Standardausgabe
Standard: file
PersistentBufferFile
Geben Sie die Datei an, in der die SQLite-Datenbank gespeichert wird. Es muss ein vollständiger Dateiname sein.
Dieser Parameter wird nur verwendet, wenn der persistente Puffer aktiviert ist (EnablePersistentBuffer=1).
PersistentBufferPeriod
Legt den Zeitraum fest, für den Daten gespeichert werden, wenn keine Verbindung zum Zabbix 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
Geben Sie die PID-Datei an.
Standard: /tmp/zabbix_agent2.pid
Plugins.<PluginName>.System.Capacity
Legt das Limit der gleichzeitig ausführbaren Prüfungen pro <PluginName>-Plugin fest.
Standard: 1000
Bereich: 1-1000
Plugins.Log.MaxLinesPerSecond
Legt die maximale Anzahl neuer Zeilen pro Sekunde fest, die beim Verarbeiten aktiver log- oder logrt-Checks an den Zabbix Server/Proxy gesendet 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 die erforderliche Zeichenfolge in Log-Datenpunkten 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
Geben Sie den Pfad zum UNIX-Socket für die Kommunikation mit ladbaren Plugins an.
Standard: /tmp/agent.plugin.sock
PluginTimeout
Geben Sie das Timeout für Verbindungen zu ladbaren Plugins in Sekunden an.
Standard: Timeout
Bereich: 1-30
RefreshActiveChecks
Geben Sie die Häufigkeit der Aktualisierung der Liste der aktiven Prüfungen in Sekunden an.
Beachten Sie, dass nach einem fehlgeschlagenen Versuch, die aktiven Prüfungen zu aktualisieren, der nächste Aktualisierungsversuch nach 60 Sekunden erfolgt.
Standard: 5
Bereich: 1-86400
Server
Geben Sie die IP-Adressen, optional in CIDR-Notation, oder DNS-Namen von Zabbix-Servern/Proxies an. Eine durch Kommas getrennte Liste.
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' als 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 wird, 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
Geben Sie die Adresse des Zabbix Server/Proxy oder die Clusterkonfiguration an, von der aktive Prüfungen abgerufen werden sollen.
Die Adresse des Server/Proxy ist eine IP-Adresse oder ein DNS-Name mit optionalem, durch einen Doppelpunkt getrenntem Port.
Die Clusterkonfiguration ist eine oder mehrere Adressen von Mitgliedern einer Server- oder Proxygruppe, getrennt durch Semikolon.
Es können mehrere Zabbix Server/Cluster und Zabbix Proxies angegeben werden, getrennt durch Komma.
Sofern keine Proxygruppen verwendet werden, sollte von jedem Zabbix Server/Cluster nicht mehr als ein Zabbix Proxy angegeben werden.
Wenn ein Zabbix Proxy angegeben ist, darf der Zabbix Server/Cluster für diesen Proxy nicht angegeben werden.
Mehrere durch Kommas getrennte Adressen können angegeben werden, um mehrere unabhängige Zabbix Server parallel zu verwenden.
Leerzeichen sind zulässig.
Wenn der Port nicht 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 für 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 Proxygruppe:
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
Geben Sie die Quell-IP-Adresse an für:
- ausgehende Verbindungen zum Zabbix-Server oder Zabbix-Proxy.
- Verbindungen, die beim Ausführen bestimmter Datenpunkte hergestellt werden (web.page.get, net.tcp.port usw.).
StatusPort
Geben Sie den Port für das Lauschen auf HTTP-Statusanfragen an (http://localhost:<port>/status).
Bereich: 1024-32767
Timeout
Geben Sie an, wie viele Sekunden beim Aufbau der Verbindung und beim Datenaustausch mit dem Zabbix Proxy oder Server gewartet werden soll.
Dieser Parameter legt die Dauer verschiedener Kommunikationsvorgänge fest, einschließlich:
- Warten auf eine Antwort vom Zabbix Server;
- Senden von Anfragen an den Zabbix Server, einschließlich Anfragen zur Datenpunkt-Konfiguration und Datenpunkt-Daten in aktiven Prüfungen;
- Abrufen von Protokolldaten über logfile;
- Senden von Heartbeat-Nachrichten;
- maximale Dauer für
vfs.*-Prüfungen; - dient als Fallback in Szenarien, in denen ein Server oder Proxy älter als Version 7.0 Prüfungen ohne Timeouts sendet.
Dieses Timeout wird nicht für jene Agent-Prüfungen verwendet, die in der Frontend konfigurierbare Timeout-Einstellungen haben (auf globaler Ebene, auf Proxy-Ebene oder pro Datenpunkt).
Standard: 3
Bereich: 1-30
TLSAccept
Geben Sie das für eingehende Verbindungen erforderliche Verschlüsselungsniveau an.
Wird für passive Prüfungen verwendet.
Mehrere Werte können durch Komma getrennt angegeben werden:
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 unencrypted Verbindungen); andernfalls nein
TLSCAFile
Geben Sie den vollständigen Pfadnamen der Datei an, die die Zertifikate der obersten CA(s) für die Überprüfung von Peer-Zertifikaten enthält und für verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet wird.
TLSCertFile
Geben Sie den vollständigen Pfadnamen der Datei an, die das Agent-Zertifikat oder die Zertifikatskette enthält und für verschlüsselte Kommunikation mit Zabbix-Komponenten verwendet wird.
TLSCipherAll
Geben Sie die OpenSSL-Cipher-String (TLS 1.2) an. Überschreiben Sie die standardmäßigen Auswahlkriterien für die Ciphersuite für zertifikats- und PSK-basierte Verschlüsselung.
Beispiel:
EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128
TLSCipherAll13
Geben Sie den OpenSSL-Cipher-String (TLS 1.3) für OpenSSL 1.1.1 oder neuer an. Überschreiben Sie die standardmäßigen Auswahlkriterien für die Ciphersuite für zertifikats- und PSK-basierte Verschlüsselung.
Beispiel:
TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSCipherCert
Geben Sie die OpenSSL-Cipher-String (TLS 1.2) an. Ü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
Geben Sie die OpenSSL-Cipher-String (TLS 1.3) für OpenSSL 1.1.1 oder neuer an. Überschreiben Sie die standardmäßigen Auswahlkriterien für die Ciphersuite 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
Geben Sie die OpenSSL-Cipher-String (TLS 1.2) an. Überschreiben Sie die standardmäßigen Auswahlkriterien für die Ciphersuite für PSK-basierte Verschlüsselung.
Beispiel:
kECDHEPSK+AES128:kPSK+AES128
TLSCipherPSK13
Geben Sie den OpenSSL-Cipher-String (TLS 1.3) für OpenSSL 1.1.1 oder neuer an. Überschreiben Sie die standardmäßigen Auswahlkriterien für die Cipher Suite bei PSK-basierter Verschlüsselung.
Beispiel:
TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSConnect
Geben Sie die für Agent-Verbindungen zum Zabbix-Server oder Proxy erforderliche Verschlüsselungsstufe an.
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
Geben Sie den vollständigen Pfadnamen der Datei an, die widerrufene Zertifikate enthält. Dieser Parameter wird für verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet.
TLSKeyFile
Geben Sie den vollständigen Pfadnamen der Datei an, die den privaten Schlüssel des Agent enthält und für verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet wird.
TLSPSKFile
Geben Sie den vollständigen Pfadnamen der Datei an, die den vorab gemeinsam genutzten Schlüssel des Agent enthält, der für verschlüsselte Verbindungen mit dem Zabbix Server verwendet wird.
TLSPSKIdentity
Geben Sie die Identitätszeichenfolge des Pre-Shared Keys an, die für verschlüsselte Kommunikation mit dem Zabbix Server verwendet wird.
TLSServerCertIssuer
Geben Sie den zulässigen Aussteller des Server- (Proxy-) Zertifikats an.
TLSServerCertSubject
Geben Sie den zulässigen Zertifikatsbetreff des Servers (Proxy) an.
UnsafeUserParameters
Erlaubt, dass alle Zeichen in Argumenten an benutzerdefinierte Parameter übergeben werden.
Die folgenden Zeichen sind nicht zulässig: \ ' " ` * ? [ ] { } \~ $ ! & ; ( ) < > | # @ %
Zusätzlich sind Zeilenumbrüche nicht zulässig.
Standard: 0
Werte: 0 - nicht zulassen, 1 - zulassen
UserParameter
Geben Sie einen benutzerdefinierten Parameter an, der überwacht werden soll.
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
Geben Sie den standardmäßigen Suchpfad für UserParameter-Befehle an.
Wenn diese Option verwendet wird, ändert 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