Konfigurationsparameter: Zabbix Agent 2 (Windows)

Übersicht

Konfigurationsparameter ermöglichen die Anpassung des Verhaltens von Zabbix Agent 2 unter Windows.

Geben Sie die Parameterwerte in der Konfigurationsdatei (zabbix_agent2.win.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

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 Auslagerungsdatei-Auslastung in Prozent vom Server.

Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage]

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

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 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 mit einem Muster übereinstimmen. 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, AllowKeyRegexp und DenyKeyRegexp definiert werden. Die Parameter werden nacheinander entsprechend ihrer Reihenfolge verarbeitet. Die Reihenfolge bestimmt, welche übereinstimmende Regel Vorrang hat. Siehe auch: Restricting agent checks.

AllowKeyRegexp

Erlaubt die Ausführung derjenigen Datenpunkt-Schlüssel, die einem Muster entsprechen. Das Schlüssel-Muster ist ein regulärer Ausdruck.
Mehrere Regeln für die Schlüsselübereinstimmung können in Kombination mit DenyKeyRegexp, AllowKey und DenyKey definiert werden. Die Parameter werden nacheinander entsprechend ihrer Reihenfolge verarbeitet. Die Reihenfolge bestimmt, welche passende Regel Vorrang hat. Siehe auch: Einschränkung von Agent-Prüfungen.

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, der verwendet wird, um Laufzeitbefehle mit der Option -R zu senden.

Standard: \\.\pipe\agent.sock

DebugLevel

Legt den Debug-Level fest:

• 0 - grundlegende Informationen über das Starten und Beenden von Zabbix-Prozessen;
• 1 - kritische Informationen;
• 2 - Fehlerinformationen;
• 3 - Warnungen;
• 4 - für 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ü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, AllowKeyRegexp und DenyKeyRegexp definiert werden. Die Parameter werden nacheinander entsprechend ihrer Reihenfolge verarbeitet. Die Reihenfolge bestimmt, welche übereinstimmende Regel Vorrang hat. Siehe auch: Restricting agent checks.

DenyKeyRegexp

Verweigert die Ausführung derjenigen Datenpunkt-Schlüssel, die einem Muster entsprechen. Das Schlüsselmuster ist ein regulärer Ausdruck.
Mehrere Regeln für die Schlüsselübereinstimmung können in Kombination mit AllowKeyRegexp, AllowKey und DenyKey definiert werden. Die Parameter werden nacheinander entsprechend ihrer Reihenfolge verarbeitet. Die Reihenfolge bestimmt, welche übereinstimmende Regel Vorrang hat. 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ührt 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 (IP-Adresse oder DNS-Name) an, 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 es, entweder die IP- oder die DNS-Adresse explizit zu konfigurieren. Weitere Informationen finden Sie unter DNS als Standardschnittstelle verwenden.

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 Host 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 Datenpunkt system.run[] wird unabhängig von den Einstellungen AllowKey/DenyKey unterstützt.

HostMetadata

Geben Sie die Metadaten an, die verwendet werden, um den Host während der Host-Autoregistrierung (aktiver Agent) zu identifizieren oder zu unterscheiden. HostMetadata ermöglicht es, Hosts über den Hostnamen hinaus voneinander zu unterscheiden.

Wenn nicht definiert, wird der Wert aus HostMetadataItem bezogen.

Der Agent gibt einen Fehler aus und startet nicht, wenn der angegebene Wert die Grenze 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 nach dem ersten Zeilenumbruch abgeschnitten.

Bereich: 0-2034 Bytes

HostMetadataItem

Geben Sie einen Zabbix-Agent-Datenpunkt an, um Host-Metadaten zu ermitteln. Diese Option wird nur verwendet, wenn HostMetadata nicht definiert ist.

Der Wert von HostMetadataItem wird bei jedem Autoregistrierungs- Versuch abgerufen und nur im Host-Autoregistrierungsprozess verwendet (aktiver Agent). 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 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-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

Geben Sie eindeutige, groß-/kleinschreibungssensitive 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: alphanumerische Zeichen, '.', ' ', '_' und '-'. Maximale Länge: 128 Zeichen pro Hostname, 2048 Zeichen für die gesamte Zeile.

Standard: 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 system.run[] Datenpunkt wird unabhängig von den Werten AllowKey/DenyKey unterstützt.

Standard: system.hostname

Include

Geben Sie ein Verzeichnis oder einzelne Dateien an, die in die Konfigurationsdatei aufgenommen werden sollen (standardmäßig unter C:\Program Files\Zabbix Agent 2, wenn Zabbix Agent mit Windows-MSI-Installationspaketen installiert wurde; im während der Installation angegebenen Ordner, wenn Zabbix Agent als ZIP-Archiv installiert wurde). Während der Zabbix-Installation wird dieser Parameter auf /usr/local/etc gesetzt, sofern Sie dies nicht zur Kompilierzeit ändern.

Allgemeine Regeln für den Parameter Include:

• Der Pfad kann relativ zum Speicherort der Datei zabbix_agent2.win.conf angegeben werden (z. B. Include=.\zabbix_agent2.d\plugins.d\*.conf).
• Sie können mehrere Include-Parameter in einer Konfigurationsdatei angeben.
• Zabbix verarbeitet den Parameter Include sofort, sobald er ihn liest. Platzieren Sie ihn daher am besten am Ende der Konfigurationsdatei.

Regeln für eingebundene Dateien:

• Jede Datei muss lesbar sein.
• Jede Datei muss eine korrekte Syntax haben. Andernfalls wird die Komponente nicht gestartet.

Regeln für das Einbinden von Verzeichnissen oder Dateimustern:

• Verlassen Sie sich nicht auf eine bestimmte Reihenfolge der Einbindung (z. B. werden Dateien nicht in alphabetischer Reihenfolge eingebunden).
• Definieren Sie denselben Parameter nicht in mehr als einer eingebundenen Datei (z. B. um eine allgemeine Einstellung durch eine spezifische zu überschreiben), da Sie nicht vorhersagen können, welcher Wert verwendet wird.
• Achten Sie auf Sicherungskopien, die einige Texteditoren automatisch erstellen (z. B. kann beim Bearbeiten von include/my_specific.conf die Datei include/my_specific.conf.BAK erstellt werden), da beide Dateien eingebunden werden.

Um nur relevante Dateien aus einem Verzeichnis einzubinden, verwenden Sie den Platzhalter (*) für die Mustererkennung.

Beispiel:

Include=C:\Program Files\Zabbix Agent2\zabbix_agent2.d\*.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 Protokolldatei des Agent an.

Standard: c:\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 abgeschnitten 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;
• console - schreibt das Protokoll in die Standardausgabe.

Standardwert: file

PerfCounter

Definieren Sie einen neuen Parameter <parameter_name>, der den Durchschnittswert des Systemleistungsindikators <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 der Prozessorunterbrechungen 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 als Datenpunkt-Schlüssel zu verwenden, wenn ein Datenpunkt erstellt wird. Beispielwerte für die Berechnung des Durchschnittswerts werden jede Sekunde erfasst.
Sie können typeperf -qx ausführen, um die Liste aller in Windows verfügbaren Leistungsindikatoren anzuzeigen.

PerfCounterEn

Definieren Sie einen neuen Parameter <parameter_name>, der den Durchschnittswert des Systemleistungsindikators <perf_counter_path> für den angegebenen Zeitraum <period> (in Sekunden) liefert. Im Vergleich zu PerfCounter müssen die perfcounter-Pfade 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 der Prozessorunterbrechungen 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

Beachten Sie bitte die doppelten Anführungszeichen um den Pfad des Leistungsindikators. Der Parametername (interrupts) wird beim Erstellen eines Datenpunkts als item key verwendet. Die zur Berechnung des Durchschnittswerts verwendeten Samples werden jede Sekunde erfasst.
Die Liste der englischen Zeichenfolgen finden Sie, indem Sie den folgenden Registrierungsschlüssel anzeigen: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009.

PersistentBufferFile

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

PersistentBufferPeriod

Legt die Dauer fest, für die Daten gespeichert werden, wenn keine Verbindung zum Server oder Proxy besteht. Ältere Daten gehen verloren. Logdaten werden beibehalten.
Dieser Parameter wird nur verwendet, wenn der persistente Puffer aktiviert ist (EnablePersistentBuffer=1).

Standard: 1h
Bereich: 1m-365d

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 fest, 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, sofern dieser im log, logrt oder eventlog Datenpunkt-Schlü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

Aktivieren Sie 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 zur Windows-Named-Pipe für die Kommunikation mit ladbaren Plugins an.

Standard: \\.\pipe\agent.plugin.sock

PluginTimeout

Legt das Timeout für Verbindungen mit ladbaren Plugins in Sekunden fest.

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/Proxys an. Eine durch Kommas getrennte Liste.
Wenn der Parameter nicht angegeben ist, sind passive Prüfungen deaktiviert und der Agent lauscht auf keinem TCP-Port.
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.

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.
Wenn der Parameter nicht angegeben ist, sind aktive Prüfungen deaktiviert.

Die Adresse des Server/Proxy ist eine IP-Adresse oder ein DNS-Name mit optionalem Port, getrennt durch einen Doppelpunkt. 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.

Die Clusterkonfiguration besteht aus einer oder mehreren Adressen von Mitgliedern einer Server- oder Proxy-Gruppe, getrennt durch Semikolon.

Mehrere Zabbix Server/Cluster und Zabbix Proxies können angegeben werden, getrennt durch Komma.

Außer bei Verwendung von Proxy-Gruppen 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.

Mehrere durch Kommas getrennte Adressen können angegeben werden, um mehrere unabhängige Zabbix Server parallel zu verwenden. Leerzeichen sind erlaubt.

Beispiel für einen 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

Geben Sie die Quell-IP-Adresse an 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

Legt den Port fest, auf dem der Agent auf HTTP-Statusanfragen lauscht (http://localhost:<port>/status).

Bereich: 1024-32767

Timeout

Geben Sie an, wie lange in Sekunden auf den Aufbau der Verbindung und den Datenaustausch mit dem Zabbix Proxy oder Server gewartet werden soll.

Dieser Parameter definiert die Dauer verschiedener Kommunikationsvorgänge, einschließlich:

• Warten auf eine Antwort vom Zabbix Server;
• Senden von Anfragen an den Zabbix Server, einschließlich Anfragen zur Datenpunktkonfiguration und Datenpunktdaten in active checks;
• Abrufen von Protokolldaten über die Überwachung von Logdateien oder Windows-Ereignisprotokollen;
• Senden von Heartbeat-Nachrichten;
• maximale Dauer für vfs.*-Prüfungen;
• als Fallback in Szenarien zu dienen, 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 den für eingehende Verbindungen erforderlichen Verschlüsselungsgrad an.
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

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.

TLSCipherAll13

Geben Sie die OpenSSL-Cipher-String (TLS 1.3) 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

TLSCipherCert13

Geben Sie die OpenSSL-Cipher-String (TLS 1.3) 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.

TLSCipherPSK13

Geben Sie die OpenSSL-Cipher-String (TLS 1.3) an. Überschreiben Sie die standardmäßigen Auswahlkriterien für die Ciphersuite 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 und für verschlüsselte Kommunikation mit dem Zabbix-Server oder Proxy verwendet wird.

TLSPSKIdentity

Geben Sie die Identitätszeichenfolge des vorab gemeinsam genutzten Schlüssels an, die für verschlüsselte Kommunikation mit dem Zabbix-Server oder Proxy verwendet wird.

TLSServerCertIssuer

Geben Sie den zulässigen Aussteller des Server- (Proxy-) Zertifikats an.

TLSServerCertSubject

Geben Sie das zulässige Zertifikats-Subject des Servers (Proxy) an.

UnsafeUserParameters

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

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

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,dir /b | find /c /v ""
UserParameter=check_cpu,.\custom\_script.bat

UserParameterDir

Geben Sie den standardmäßigen Suchpfad für UserParameter-Befehle an. Wenn diese Option verwendet wird, 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