3 Zabbix Agent (UNIX)

Übersicht

Die von der Zabbix-Agent-Konfigurationsdatei (zabbix_agentd.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 Datenpunktschlüssel fest.
AllowKey Erlaubt die Ausführung derjenigen Datenpunktschlüssel, die einem Muster entsprechen.
AllowRoot Erlaubt, dass der Agent als 'root' ausgeführt wird.
BufferSend Daten nicht länger als N Sekunden im Puffer behalten.
BufferSize Die maximale Anzahl von Werten im Speicherpuffer.
DebugLevel Die Debug-Stufe.
DenyKey Verweigert die Ausführung derjenigen Datenpunktschlüssel, die einem Muster entsprechen.
EnableRemoteCommands Ob Remote-Befehle vom Zabbix Server erlaubt sind.
HeartbeatFrequency Die Häufigkeit von Heartbeat-Nachrichten in Sekunden.
HostInterface Ein optionaler Parameter, der die Host-Schnittstelle definiert.
HostInterfaceItem Ein optionaler Parameter, der einen Datenpunkt definiert, der zum Ermitteln 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 Ermitteln 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 Ermitteln des Hostnamens verwendet wird.
Include Sie können einzelne Dateien oder alle Dateien in einem Verzeichnis in die Konfigurationsdatei einbinden.
ListenBacklog Die maximale Anzahl ausstehender Verbindungen in der TCP-Warteschlange.
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.
LoadModule Das Modul, das beim Start des Agent geladen wird.
LoadModulePath Der vollständige Pfad zum Speicherort der Agent-Module.
LogFile Der Name der Protokolldatei.
LogFileSize Die maximale Größe der Protokolldatei.
LogRemoteCommands Aktiviert die Protokollierung ausgeführter Shell-Befehle als Warnungen.
LogType Der Typ der Protokollausgabe.
MaxLinesPerSecond Die maximale Anzahl neuer Zeilen, die der Agent pro Sekunde an den Zabbix Server oder Proxy sendet, wenn aktive Prüfungen vom Typ 'log' und 'logrt' verarbeitet werden.
PidFile Der Name der PID-Datei.
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 Proxys.
ServerActive Die Adresse des Zabbix Servers/Proxy oder die Cluster-Konfiguration, von der aktive Prüfungen abgerufen werden.
SourceIP Die Quell-IP-Adresse.
StartAgents Die Anzahl der vorab geforkten Instanzen von zabbix_agentd, die passive Prüfungen verarbeiten.
Timeout Gibt an, wie lange (in Sekunden) auf den Verbindungsaufbau und den Datenaustausch mit Zabbix Proxy oder Server gewartet wird.
TLSAccept Welche eingehenden Verbindungen akzeptiert werden.
TLSCAFile Der vollständige Pfadname einer Datei, die die Zertifikate der obersten CA(s) für die Verifizierung von Peer-Zertifikaten enthält und für verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet wird.
TLSCertFile Der vollständige Pfadname einer Datei, die das Agent-Zertifikat oder die Zertifikatskette enthält und für verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet wird.
TLSCipherAll Die GnuTLS-Prioritätszeichenfolge oder die OpenSSL-Cipher-Zeichenfolge (TLS 1.2). Überschreibt die Standardkriterien zur Auswahl der Cipher-Suite für zertifikats- und PSK-basierte Verschlüsselung.
TLSCipherAll13 Die Cipher-Zeichenfolge für OpenSSL 1.1.1 oder neuer in TLS 1.3. Überschreibt die Standardkriterien zur Auswahl der Cipher-Suite für zertifikats- und PSK-basierte Verschlüsselung.
TLSCipherCert Die GnuTLS-Prioritätszeichenfolge oder die OpenSSL-Cipher-Zeichenfolge (TLS 1.2). Überschreibt die Standardkriterien zur Auswahl der Cipher-Suite für zertifikatsbasierte Verschlüsselung.
TLSCipherCert13 Die Cipher-Zeichenfolge für OpenSSL 1.1.1 oder neuer in TLS 1.3. Überschreibt die Standardkriterien zur Auswahl der Cipher-Suite für zertifikatsbasierte Verschlüsselung.
TLSCipherPSK Die GnuTLS-Prioritätszeichenfolge oder die OpenSSL-Cipher-Zeichenfolge (TLS 1.2). Überschreibt die Standardkriterien zur Auswahl der Cipher-Suite für PSK-basierte Verschlüsselung.
TLSCipherPSK13 Die Cipher-Zeichenfolge für OpenSSL 1.1.1 oder neuer in TLS 1.3. Überschreibt die Standardkriterien zur Auswahl der Cipher-Suite für PSK-basierte Verschlüsselung.
TLSConnect Wie der Agent eine Verbindung zum Zabbix Server oder Proxy herstellen soll.
TLSCRLFile Der vollständige Pfadname einer Datei, die gesperrte Zertifikate enthält. Dieser Parameter wird für verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet.
TLSKeyFile Der vollständige Pfadname einer Datei, die den privaten Schlüssel des Agent enthält und für verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet wird.
TLSPSKFile Der vollständige Pfadname einer Datei, die den vorinstallierten Schlüssel des Agent enthält und für verschlüsselte Kommunikation mit dem Zabbix Server verwendet wird.
TLSPSKIdentity Die Identitätszeichenfolge des vorinstallierten 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 für benutzerdefinierte Parameter übergeben werden.
User Legt die Berechtigungen auf einen bestimmten, vorhandenen Benutzer des Systems ab.
UserParameter Ein benutzerdefinierter Parameter zur Überwachung.
UserParameterDir Der Standardsuchpfad für UserParameter-Befehle.

Alle Parameter sind optional, sofern nicht ausdrücklich angegeben ist, dass ein Parameter verpflichtend ist.

Beachten Sie:

  • Die Standardwerte entsprechen den Daemon-Standardwerten, nicht den Werten 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 Anfang der Zeile unterstützt.

Details zu den Parametern

Alias

Legt einen Alias für einen Datenpunktschlüssel fest. Er kann verwendet werden, um einen langen und komplexen Datenpunktschlü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 Datenpunktschlüssel verweisen.
Aliasse können in HostMetadataItem, jedoch nicht im Parameter HostnameItem verwendet werden.

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 zum Abrufen von Daten verwendet werden.

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

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

Dies ermöglicht die Verwendung des Schlüssels cpu.util, um den prozentualen Wert der CPU-Auslastung mit Standardparametern abzurufen, sowie die Verwendung von cpu.util[all, idle, avg15], um spezifische Daten zur CPU-Auslastung zu erhalten.

Beispiel 3: Ausführen mehrerer Regeln zur Low-Level-Discovery, die dieselben Discovery-Datenpunkte 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 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 DenyKey definiert werden. Die Parameter werden einzeln entsprechend ihrer Reihenfolge des Auftretens verarbeitet. Siehe auch: Einschränken von Agent-Prüfungen.

AllowRoot

Erlaubt dem Agent, als „root“ zu laufen. Wenn deaktiviert und der Agent von „root“ gestartet wird, versucht der Agent stattdessen, zum Benutzer „zabbix“ zu wechseln. Hat keine Auswirkung, wenn er unter einem normalen Benutzer gestartet wird.

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

BufferSend

Daten nicht länger als N Sekunden im Puffer behalten.

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.

Standard: 100
Bereich: 2-65535

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 - zum Debuggen (erzeugt viele Informationen);
5 - erweitertes Debugging (erzeugt 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 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 einzeln entsprechend ihrer Reihenfolge ihres Auftretens verarbeitet. Siehe auch: Einschränken von Agent-Prüfungen.

EnableRemoteCommands

Ob Remote-Befehle vom Zabbix Server erlaubt sind. Dieser Parameter ist veraltet; verwenden Sie stattdessen AllowKey=system.run[*] oder DenyKey=system.run[*].
Er ist ein interner Alias für die Parameter AllowKey/DenyKey, abhängig vom Wert:
0 - DenyKey=system.run[*]
1 - AllowKey=system.run[*]

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

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 Prozesses 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 Details finden Sie unter DNS als Standardschnittstelle verwenden.

Falls nicht definiert, wird der Wert von HostInterfaceItem übernommen.

Der Agent gibt einen Fehler aus und startet nicht, wenn der Wert das Limit 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 Prozesses der Host-Autoregistrierung zu bestimmen. Dieser Wert wird nur verwendet, wenn HostInterface nicht definiert ist. Weitere Details finden Sie unter DNS als Standardschnittstelle verwenden.

Während einer Autoregistrierungsanfrage protokolliert der Agent eine Warnmeldung, wenn der vom angegebenen Datenpunkt zurückgegebene Wert das Limit von 255 Zeichen überschreitet.

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

HostMetadata

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

Falls nicht definiert, wird der Wert von HostMetadataItem übernommen.

Der Agent gibt einen Fehler aus und startet nicht, wenn der angegebene Wert das Limit von 2034 Byte überschreitet oder keine 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 IP-Adressen oder DNS-Namen darstellen, ebenfalls zurückgewiesen und als ungültig gemeldet.

Bereich: 0-2034 Byte

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 Versuch der Autoregistrierung abgerufen und nur im Prozess der Host-Autoregistrierung verwendet (aktiver Agent). HostMetadataItem ermöglicht es, zwischen Hosts über den Hostnamen hinaus zu unterscheiden.

Benutzerparameter und Aliasse werden unterstützt. Der Datenpunkt system.run[] wird unabhängig von den Einstellungen für AllowKey/DenyKey unterstützt.

Während einer Autoregistrierungsanfrage 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-Zeichenfolge 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 zurückgewiesen und als ungültig gemeldet.

Hostname

Eine Liste von durch Kommas getrennten, eindeutigen, groß-/kleinschreibungssensitiven Hostnamen. Erforderlich für aktive Prüfungen und muss mit den auf dem Server konfigurierten Hostnamen übereinstimmen. Der Wert wird von HostnameItem übernommen, wenn er nicht definiert ist.
Zulässige Zeichen: alphanumerische Zeichen, '.', ' ', '_' 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 Zabbix-Agent-Datenpunkt definiert, der zum Abrufen des Hostnamens verwendet wird.
Diese Option wird nur verwendet, wenn Hostname nicht definiert ist.
Benutzerparameter oder Aliasse werden nicht unterstützt, aber der Datenpunkt system.run[] wird unabhängig von den Werten von AllowKey/DenyKey unterstützt.

Standard: system.hostname

Include

Sie können einzelne Dateien oder alle Dateien in einem Verzeichnis in die Konfigurationsdatei einbinden. Um nur relevante Dateien im angegebenen Verzeichnis einzubinden, wird das Asterisk-Platzhalterzeichen für den Musterabgleich unterstützt.
Siehe besondere Hinweise zu Einschränkungen.

Beispiel:

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

Die maximale Anzahl ausstehender Verbindungen in der TCP-Warteschlange.
Der Standardwert ist eine fest kodierte Konstante, die vom System abhängt.
Der maximal unterstützte Wert hängt ebenfalls vom System ab; zu hohe Werte können stillschweigend auf das „implementierungsspezifische Maximum“ gekürzt werden.

Standard: SOMAXCONN
Bereich: 0 - INT_MAX

ListenIP

Eine Liste von durch Kommas getrennten IP-Adressen, auf denen der Agent lauschen soll.

Standard: 0.0.0.0

ListenPort

Der Agent lauscht auf diesem Port auf Verbindungen vom Server.

Standard: 10050
Bereich: 1024-32767

LoadModule

Das Modul, das beim Start des Agent geladen werden soll. Module werden verwendet, um die Funktionalität des Agent zu erweitern. Das Modul muss sich in dem durch LoadModulePath angegebenen Verzeichnis befinden, oder dem Modulnamen muss der Pfad vorangestellt werden. Wenn der vorangestellte Pfad absolut ist (beginnt mit '/'), wird LoadModulePath ignoriert.
Formate:
LoadModule=<module.so>
LoadModule=<path/module.so>
LoadModule=</abs_path/module.so>
Es ist zulässig, mehrere LoadModule-Parameter anzugeben.

LoadModulePath

Der vollständige Pfad zum Speicherort der Agent-Module. Der Standardwert hängt von den Kompilierungsoptionen ab.

LogFile

Der Name der Protokolldatei.

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

LogRemoteCommands

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

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

LogType

Der Typ der Protokollausgabe:
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

MaxLinesPerSecond

Die maximale Anzahl neuer Zeilen, die der Agent pro Sekunde an den Zabbix Server oder Proxy sendet, wenn aktive Prüfungen vom Typ „log“ und „logrt“ verarbeitet werden. Der angegebene Wert wird durch den Parameter „maxlines“ überschrieben, der im Datenpunkt-Schlüssel „log“ oder „logrt“ 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

PidFile

Der Name der PID-Datei.

Standard: /tmp/zabbix_agentd.pid

RefreshActiveChecks

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

Standard: 5
Bereich: 1-86400

Server

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, dann 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. Beachten Sie, dass „IPv4-kompatible IPv6-Adressen“ (Präfix 0000::/96) unterstützt werden, aber durch RFC4291 als veraltet eingestuft sind. Leerzeichen sind erlaubt.

Beispiel:

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

Verpflichtend: ja, wenn StartAgents nicht explizit auf 0 gesetzt ist

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 mit einem optionalen, durch einen Doppelpunkt getrennten 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 nicht mehr als ein Zabbix Proxy von jedem Zabbix Server/Cluster angegeben werden. Wenn ein Zabbix Proxy angegeben ist, sollte der Zabbix Server/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;
  • den Verbindungsaufbau bei der Ausführung einiger Datenpunkte (web.page.get, net.tcp.port usw.).
StartAgents

Die Anzahl der vorab geforkten Instanzen von zabbix_agentd, die passive Prüfungen verarbeiten. Wenn auf 0 gesetzt, sind passive Prüfungen deaktiviert und der Agent lauscht auf keinem TCP-Port.

Standard: 10
Bereich: 0-100

Timeout

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

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

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

Dieser Timeout wird nicht für jene Agent-Prüfungen verwendet, die im Frontend konfigurierbare Timeout-Einstellungen haben (auf globaler, Proxy- oder Datenpunkt-Ebene).

Standard: 3
Bereich: 1-30

TLSAccept

Welche eingehenden Verbindungen akzeptiert werden sollen. Wird für passive Prüfungen verwendet. Mehrere Werte können angegeben werden, durch Komma getrennt:
unencrypted - Verbindungen ohne Verschlüsselung akzeptieren (Standard)
psk - Verbindungen mit TLS und einem vorinstallierten Schlüssel (PSK) akzeptieren
cert - Verbindungen mit TLS und einem Zertifikat akzeptieren

Verbindlich: ja, wenn TLS-Zertifikats- 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

Der GnuTLS-Prioritätsstring oder der OpenSSL-(TLS 1.2)-Cipher-String.
Überschreibt die standardmäßigen Auswahlkriterien der Cipher-Suite für zertifikats- und PSK-basierte Verschlüsselung.

Beispiel:

TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSCipherAll13

Die Chiffrenzeichenfolge für OpenSSL 1.1.1 oder neuer in TLS 1.3. Überschreibt die standardmäßigen Auswahlkriterien der Chiffriersuite für zertifikat- und PSK-basierte Verschlüsselung.

Beispiel für GnuTLS:

NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL::+SIGN-ALL:+CTYPE-X.509

Beispiel für OpenSSL:

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

Der GnuTLS-Prioritäts-String oder der OpenSSL-(TLS 1.2)-Cipher-String. Überschreibt die standardmäßigen Auswahlkriterien der Cipher-Suite für zertifikatsbasierte Verschlüsselung.

Beispiel für GnuTLS:

NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509

Beispiel für OpenSSL:

EECDH+aRSA+AES128:RSA+aRSA+AES128
TLSCipherCert13

Die Chiffrezeichenfolge für OpenSSL 1.1.1 oder neuer in TLS 1.3. Überschreibt die standardmäßigen Auswahlkriterien für Chiffriersuiten bei zertifikatsbasierter Verschlüsselung.

TLSCipherPSK

Der GnuTLS-Prioritätsstring oder der OpenSSL-Cipher-String (TLS 1.2). Überschreibt die standardmäßigen Auswahlkriterien der Cipher-Suite für PSK-basierte Verschlüsselung.

Beispiel für GnuTLS:

NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL

Beispiel für OpenSSL:

kECDHEPSK+AES128:kPSK+AES128
TLSCipherPSK13

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

Beispiel:

TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSConnect

Wie der Agent eine Verbindung zum Zabbix Server oder Proxy herstellen soll. Wird für aktive Prüfungen verwendet. Es kann nur ein Wert angegeben werden:
unencrypted - Verbindung ohne Verschlüsselung herstellen (Standard)
psk - Verbindung über TLS und mit einem vorab geteilten Schlüssel (PSK) herstellen
cert - Verbindung über TLS und mit einem Zertifikat herstellen

Verbindlich: ja, wenn TLS-Zertifikats- oder PSK-Parameter definiert sind (auch bei einer 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 Zertifikatbetreff des Servers (Proxy).

UnsafeUserParameters

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

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

Benutzer

Privilegien auf einen bestimmten, auf dem System vorhandenen Benutzer reduzieren.
Wirkt sich nur aus, wenn als 'root' ausgeführt wird und AllowRoot deaktiviert ist.

Standard: zabbix

UserParameter

Ein benutzerdefinierter Parameter zur Überwachung. Es kann mehrere benutzerdefinierte Parameter geben.
Format: UserParameter=<key>,<shell command>
Beachten Sie, dass der Shell-Befehl keine leere Zeichenfolge oder nur ein Zeilenende zurückgeben darf. Shell-Befehle können relative Pfade haben, 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. Falls verwendet, wechselt der Agent vor der Ausführung eines Befehls in das hier angegebene Arbeitsverzeichnis. 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

Siehe auch

  1. Unterschiede in der Konfiguration des Zabbix Agent für aktive und passive Prüfungen ab Version 2.0.0