5 Zabbix Agent (Windows)
Übersicht
Die von der Windows-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. |
| 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. |
| 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. |
| PerfCounter | Definiert einen neuen Parameter <parameter_name>, der den Durchschnittswert des Systemleistungszählers <perf_counter_path> für den angegebenen Zeitraum <period> (in Sekunden) darstellt. |
| PerfCounterEn | Definiert einen neuen Parameter <parameter_name>, der den Durchschnittswert des Systemleistungszählers <perf_counter_path> für den angegebenen Zeitraum <period> (in Sekunden) darstellt. Im Vergleich zu PerfCounter müssen die perfcounter-Pfade auf Englisch sein. |
| 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/Proxys 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 dem Zabbix-Proxy oder -Server gewartet wird. |
| TLSAccept | Welche eingehenden Verbindungen akzeptiert werden sollen. |
| TLSCAFile | Der vollständige Pfadname einer Datei, die die Zertifikate der obersten CA(s) zur 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. |
| TLSConnect | Wie der Agent eine Verbindung zum Zabbix-Server oder Proxy herstellen soll. |
| TLSCRLFile | Der vollständige Pfadname einer Datei, die widerrufene 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 vorab geteilten Schlüssel des Agent enthält und für verschlüsselte Kommunikation mit dem Zabbix-Server verwendet wird. |
| TLSPSKIdentity | Die Identitätszeichenfolge des vorab geteilten Schlüssels, die für verschlüsselte Kommunikation mit dem Zabbix-Server verwendet wird. |
| TLSServerCertIssuer | Der zulässige Aussteller des Server-(Proxy-)Zertifikats. |
| TLSServerCertSubject | Das zulässige Subjekt des Server-(Proxy-)Zertifikats. |
| UnsafeUserParameters | Erlaubt, alle Zeichen in Argumenten für benutzerdefinierte Parameter zu übergeben. |
| UserParameter | Ein benutzerdefinierter Parameter zur Überwachung. |
| UserParameterDir | Der Standard-Suchpfad 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.
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.
Aliasse können in HostMetadataItem verwendet werden, jedoch nicht im Parameter HostnameItem oder PerfCounter.
Beispiel 1: Abrufen der Auslagerungsdateinutzung in Prozent vom Server.
Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage]
Nun kann der Kurzschlüssel pg_usage zum Abrufen von Daten verwendet werden.
Beispiel 2: Abrufen der CPU-Auslastung mit Standard- und benutzerdefinierten Parametern.
Alias=cpu.load:system.cpu.load
Alias=cpu.load[*]:system.cpu.load[*]
Dies ermöglicht die Verwendung des Schlüssels cpu.load, um die CPU-Auslastung mit Standardparametern abzurufen, sowie die Verwendung von cpu.load[percpu,avg15], um spezifische Daten zur CPU-Auslastung abzurufen.
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 verarbeitet.
Siehe auch: Einschränken von Agent-Prüfungen.
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 entsprechend ihrer Reihenfolge des Auftretens nacheinander 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 Host-Autoregistrierung 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 AllowKey/DenyKey unterstützt.
HostMetadata
Ein optionaler Parameter, der die Metadaten definiert, die verwendet werden, um den Host während des Autoregistrierungs-Prozesses des Hosts (aktiver Agent) zu identifizieren oder zu unterscheiden. HostMetadata ermöglicht es, zwischen Hosts über den Hostnamen hinaus zu unterscheiden.
Falls nicht definiert, wird der Wert von HostMetadataItem bezogen.
Der Agent gibt einen Fehler aus und startet nicht, wenn der angegebene Wert das Limit von 2034 Byte überschreitet oder keine UTF-8-Zeichenfolge 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.
Mehrzeilige Metadaten werden nicht unterstützt — die Ausgabe wird beim ersten Zeilenumbruch abgeschnitten.
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 die Unterscheidung zwischen Hosts über den Hostnamen hinaus.
Benutzerparameter, Leistungsindikatoren und Aliase werden unterstützt. Der Datenpunkt system.run[] wird unabhängig von den Einstellungen 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.
Mehrzeilige Metadaten werden nicht unterstützt — die Ausgabe wird am ersten Zeilenumbruch abgeschnitten.
Hostname
Eine Liste von durch Kommas getrennten, eindeutigen Hostnamen, bei denen Groß- und Kleinschreibung beachtet wird.
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 Host-Namens verwendet wird.
Diese Option wird nur verwendet, wenn Hostname nicht definiert ist.
Benutzerparameter, Leistungsindikatoren oder Aliase werden nicht unterstützt, aber der Datenpunkt system.run[] wird unabhängig von den Werten von AllowKey/DenyKey unterstützt.
Siehe auch eine detailliertere Beschreibung.
Standard: system.hostname
Include
Sie können einzelne Dateien oder alle Dateien in einem Verzeichnis in die Konfigurationsdatei einbinden (standardmäßig unter C:\Program Files\Zabbix Agent, wenn der Zabbix Agent mit Windows-MSI-Installer-Paketen installiert wurde; im während der Installation angegebenen Ordner, wenn der Zabbix Agent als ZIP-Archiv installiert wurde).
Alle eingebundenen Dateien müssen eine
korrekte Syntax haben, andernfalls wird der Agent nicht gestartet.
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=C:\Program Files\Zabbix Agent\zabbix_agentd.d\*.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
LogFile
Der Name der Agent-Protokolldatei.
Standard: c:\zabbix_agentd.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
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 das Windows-Ereignisprotokoll;
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“, „logrt“ und „eventlog“ verarbeitet werden.
Der angegebene Wert wird durch den Parameter „maxlines“ überschrieben, der im Datenpunkt-Schlüssel „log“, „logrt“ oder „eventlog“ angegeben ist.
Hinweis: Zabbix verarbeitet 10-mal mehr neue Zeilen als in MaxLinesPerSecond festgelegt, um die erforderliche Zeichenfolge in Log-Datenpunkten zu finden.
Standard: 20
Bereich: 1-1000
PerfCounter
Definiert einen neuen Parameter <parameter_name>, der den Durchschnittswert für den Systemleistungsindikator <perf_counter_path> für den angegebenen Zeitraum <period> (in Sekunden) darstellt.
Syntax: <parameter_name>,"<perf_counter_path>",<period>
Wenn Sie beispielsweise die durchschnittliche Anzahl von Prozessor-Interrupts pro Sekunde für die letzte Minute erhalten möchten, können Sie einen neuen Parameter "interrupts" wie folgt definieren:
PerfCounter = interrupts,"\Processor(0)\Interrupts/sec",60
Bitte beachten Sie die doppelten Anführungszeichen um den Pfad des Leistungsindikators.
Der Parametername (interrupts) ist beim Erstellen eines Datenpunkts als Datenpunktschlüssel zu verwenden.
Für die Berechnung des Durchschnittswerts werden jede Sekunde Stichproben erfasst.
Sie können "typeperf -qx" ausführen, um die Liste aller in Windows verfügbaren Leistungsindikatoren abzurufen.
PerfCounterEn
Definiert einen neuen Parameter <parameter_name>, der den Durchschnittswert für den Systemleistungsindikator <perf_counter_path> für den angegebenen Zeitraum <period> (in Sekunden) darstellt.
Im Vergleich zu PerfCounter müssen die Pfade der Leistungsindikatoren bei perfcounter auf Englisch angegeben werden.
Wird nur unter Windows Server 2008/Vista und höher unterstützt.
Syntax: <parameter_name>,"<perf_counter_path>",<period>
Wenn Sie beispielsweise die durchschnittliche Anzahl von Prozessor-Interrupts pro Sekunde für die letzte Minute erhalten möchten, können Sie einen neuen Parameter "interrupts" wie folgt definieren:
PerfCounterEn = interrupts,"\Processor(0)\Interrupts/sec",60
Bitte beachten Sie die doppelten Anführungszeichen um den Pfad des Leistungsindikators.
Der Parametername (interrupts) ist beim Erstellen eines Datenpunkts als Schlüssel des Datenpunkts zu verwenden.
Für die Berechnung des Durchschnittswerts werden jede Sekunde Stichproben genommen.
Die Liste der englischen Zeichenfolgen finden Sie, indem Sie den folgenden Registrierungsschlüssel anzeigen: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009.
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 von durch Kommas getrennten 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, 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
Verbindlich: 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 sowie optional ein 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/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
Bereich: (*)
SourceIP
Die Quell-IP-Adresse für:
- ausgehende Verbindungen zum Zabbix Server oder Zabbix Proxy;
- das Herstellen von Verbindungen 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:
- 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 Prüfungen;
- Abrufen von Protokolldaten über die Überwachung von Logdateien oder Windows-Ereignisprotokollen;
- Senden von Heartbeat-Nachrichten;
- maximale Dauer für
vfs.*-Prüfungen; - Verwendung durch Zabbix Agent-Module;
- Verwendung 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 im Frontend konfigurierbare Timeout-Einstellungen haben (auf globaler Ebene, Proxy-Ebene oder pro Datenpunkt).
Standard: 3
Bereich: 1-30
TLSAccept
Die eingehenden Verbindungen, die 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 vorab geteilten 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 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 Agent-Zertifikat oder die Zertifikatskette enthält und für die verschlüsselte Kommunikation mit Zabbix-Komponenten verwendet wird.
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 mit TLS und einem Pre-Shared Key (PSK) herstellen
cert - Verbindung mit TLS und 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 Zertifikat-Betreff 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
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,dir /b | find /c /v ""
UserParameter=check_cpu,.\custom\_script.bat
UserParameterDir
Der Standard-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=C:\opt\myscripts
(*) Die Anzahl der in ServerActive aufgeführten aktiven Server plus die Anzahl der in StartAgents angegebenen vorab geforkten Instanzen für passive Prüfungen muss kleiner als 64 sein.