Konfigurationsparameter: Zabbix Agent (Windows)
Übersicht
Konfigurationsparameter ermöglichen die Anpassung des Verhaltens des Zabbix Agent unter Windows.
Geben Sie die Parameterwerte in der Konfigurationsdatei (zabbix_agentd.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.
| 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. |
| AllowKeyRegexp | Erlaubt die Ausführung von Datenpunkt-Schlüsseln, die einem auf regulären Ausdrücken basierenden 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. |
| DebugLevel | Legt die Debug-Ebene fest. |
| DenyKey | Verweigert die Ausführung derjenigen Datenpunkt-Schlüssel, die einem Muster entsprechen. |
| DenyKeyRegexp | Verweigert die Ausführung von Datenpunkt-Schlüsseln, die einem auf regulären Ausdrücken basierenden Muster entsprechen. |
| EnableRemoteCommands | Erlaubt Remote-Befehle vom Zabbix Server. |
| 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. |
| ListenBacklog | Legt die maximale Anzahl ausstehender Verbindungen in der TCP-Warteschlange fest. |
| 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. |
| LogRemoteCommands | Aktiviert die Protokollierung ausgeführter Shell-Befehle als Warnungen. |
| LogType | Gibt den Typ der Protokollausgabe an. |
| MaxLinesPerSecond | Legt die maximale Anzahl neuer Zeilen pro Sekunde fest, die bei der Verarbeitung aktiver Prüfungen log, logrt oder eventlog an den Zabbix Server/Proxy gesendet werden. |
| 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. |
| 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 perfcounter-Pfade auf Englisch angegeben werden. |
| RefreshActiveChecks | Gibt die Häufigkeit der Aktualisierung der Liste aktiver Prüfungen an. |
| Server | Gibt die IP-Adressen oder DNS-Namen der Zabbix Server/Proxies 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. |
| StartAgents | Legt die Anzahl der vorab erzeugten Instanzen von zabbix_agentd für die Verarbeitung passiver Prüfungen fest. |
| 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 die für eingehende Verbindungen erforderliche Verschlüsselungsstufe an. |
| TLSCAFile | Gibt den vollständigen Pfadnamen der 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 wird. |
| TLSCertFile | Gibt den vollständigen Pfadnamen der Datei mit dem Zertifikat oder der Zertifikatskette des Agent an, die für verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet wird. |
| TLSConnect | Gibt die für Verbindungen zum Zabbix Server oder Proxy erforderliche Verschlüsselungsstufe an. |
| TLSCRLFile | Gibt den vollständigen Pfadnamen der Datei mit widerrufenen Zertifikaten an. Dieser Parameter wird für verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet. |
| TLSKeyFile | Gibt den vollständigen Pfadnamen der Datei mit dem privaten Schlüssel des Agent an, die für verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet wird. |
| TLSPSKFile | Gibt den vollständigen Pfadnamen der Datei mit dem vorab gemeinsam genutzten Schlüssel des Agent an, die für verschlüsselte Kommunikation mit dem Zabbix Server oder Proxy verwendet wird. |
| TLSPSKIdentity | Gibt 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 | Gibt den zulässigen Aussteller des Serverzertifikats (Proxyzertifikats) an. |
| TLSServerCertSubject | Gibt den zulässigen Betreff des Serverzertifikats (Proxyzertifikats) 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 Standardwerte des Daemons 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 Anfang der Zeile unterstützt.
Parameterdetails
Alias
Einen Alias für einen item key festlegen.
Er kann verwendet werden, um einen langen und komplexen item key durch einen kürzeren und einfacheren zu ersetzen.
Es können mehrere Alias-Parameter vorhanden sein.
Mehrere Parameter mit demselben Alias-Key sind nicht zulässig.
Unterschiedliche Alias-Keys können auf denselben item key verweisen.
Aliases können in HostMetadataItem verwendet werden, jedoch nicht in HostnameItem oder im PerfCounter-Parameter.
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 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 DenyKey, AllowKeyRegexp und DenyKeyRegexp 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.
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 übereinstimmende Regel Vorrang hat.
Siehe auch: Einschränken 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).
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.
Standard: 100
Bereich: 2-65535
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 das Debugging (liefert viele Informationen);
- 5 - erweitertes Debugging (liefert noch mehr Informationen).
Standard: 3
Bereich: 0-5
DenyKey
Verweigert die Ausführung derjenigen Datenpunkt-Schlüssel, die mit einem Muster übereinstimmen.
Das Schlüsselmuster ist ein Platzhalterausdruck, der das Zeichen * unterstützt, um eine beliebige Anzahl beliebiger Zeichen zu matchen.
Mehrere Schlüssel-Matching-Regeln 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.
EnableRemoteCommands
Erlaubt Remote-Befehle vom Zabbix-Server.
Dieser Parameter ist veraltet. Verwenden Sie stattdessen AllowKey=system.run[*] oder DenyKey=system.run[*].
Es handelt sich um einen internen Alias für die Parameter AllowKey/DenyKey in Abhängigkeit vom Wert:
- 0 -
DenyKey=system.run[*] - 1 -
AllowKey=system.run[*]
Standard: 0
Werte: 0 - nicht erlauben, 1 - erlauben
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 die explizite Konfiguration entweder einer IP- oder DNS-Adresse. Weitere Informationen finden Sie unter Using DNS as default interface.
Wenn nicht definiert, wird der Wert aus HostInterfaceItem übernommen.
Der Agent gibt einen Fehler aus und startet nicht, wenn der Wert die Grenze von 255 Zeichen überschreitet.
Bereich: 0-255 Zeichen
HostInterfaceItem
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 die Grenze 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 es sich um eine Nicht-UTF-8-Zeichenkette handelt. Wenn ein Parameter eine IP-Adresse oder einen DNS-Namen erwartet, werden auch Werte abgelehnt und als ungültig gemeldet, die zwar gültiges UTF-8 sind, aber keine gültigen IPs oder DNS-Namen darstellen.
Mehrzeilige Metadaten werden nicht unterstützt — die Ausgabe wird an der ersten Zeilenumbruchstelle abgeschnitten.
Bereich: 0-2034 Bytes
HostMetadataItem
Geben Sie einen Zabbix-Agent-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 im Autoregistrierungsprozess des Hosts verwendet (aktiver Agent).
HostMetadataItem ermöglicht die Unterscheidung zwischen Hosts über den Hostnamen hinaus.
Benutzerdefinierte Parameter, Performance-Zähler 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 IP-Adressen oder DNS-Namen darstellen, ebenfalls abgelehnt und als ungültig gemeldet.
Mehrzeilige Metadaten werden nicht unterstützt — die Ausgabe wird an der ersten Zeilenumbruchsmarke 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: alphanumerisch, '.', ' ', '_' und '-'.
Maximale Länge: 128 Zeichen pro Hostname, 2048 Zeichen für die gesamte Zeile.
Standard: Durch HostnameItem festgelegt
HostnameItem
Geben Sie einen Zabbix Agent-Datenpunkt an, um den Hostnamen abzurufen.
Diese Option wird nur verwendet, wenn Hostname nicht definiert ist.
Benutzerparameter, Leistungsindikatoren oder Aliase werden nicht unterstützt, aber der system.run[] Datenpunkt wird unabhängig von den Werten AllowKey/DenyKey unterstützt.
Siehe auch eine detailliertere Beschreibung.
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, wenn Zabbix Agent mit Windows-MSI-Installationspaketen installiert wurde; im während der Installation angegebenen Ordner, wenn 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 Platzhalterzeichen Sternchen für die Mustererkennung unterstützt.
Siehe besondere Hinweise zu Einschränkungen.
Beispiel:
Include=C:\Program Files\Zabbix Agent\zabbix_agentd.d\*.conf
ListenBacklog
Legt die maximale Anzahl ausstehender Verbindungen in der TCP-Warteschlange fest.
Der Standardwert ist eine fest codierte 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 „implementationsspezifische Maximum“ gekürzt werden.
Standard: SOMAXCONN
Bereich: 0 - INT_MAX
ListenIP
Geben Sie die IP-Adresse an, auf der der Agent Verbindungen vom Server/Proxy entgegennimmt. Eine durch Kommas getrennte Liste.
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: c:\zabbix_agentd.log
Erforderlich: Ja, wenn LogType auf file gesetzt ist; andernfalls nein
LogFileSize
Legt die maximale Größe der Protokolldatei fest (in MB).
0 - automatische Protokollrotation deaktivieren.
Hinweis: Wenn das Limit für die Größe der Protokolldatei erreicht wird und die Dateirotation aus irgendeinem Grund fehlschlägt, wird die vorhandene Protokolldatei abgeschnitten und neu begonnen.
Standard: 1
Bereich: 0-1024
LogRemoteCommands
Aktivieren Sie 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
Geben Sie den Typ der Protokollausgabe an:
- file - schreibt das Protokoll in die durch den Parameter
LogFileangegebene Datei; - system - schreibt das Protokoll in das Windows-Ereignisprotokoll;
- console - schreibt das Protokoll in die Standardausgabe.
Standardwert: file
MaxLinesPerSecond
Legt die maximale Anzahl neuer Zeilen pro Sekunde fest, die beim Verarbeiten von aktiven Prüfungen log, logrt oder eventlog an den Zabbix Server/Proxy gesendet werden.
Der angegebene Wert wird durch den Parameter maxlines überschrieben, der im log, logrt oder eventlog Datenpunkt-Schlü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
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 von 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.
Stichproben zur 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 als item key verwendet, wenn ein Datenpunkt erstellt wird.
Beispielwerte zur Berechnung des Durchschnittswerts 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.
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 in 60 Sekunden unternommen wird.
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.
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 und ::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.
Beachten Sie, dass "IPv4-kompatible IPv6-Adressen" (0000::/96-Präfix) unterstützt werden, aber gemäß RFC4291 veraltet sind.
Leerzeichen sind zulässig.
Beispiel:
Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com
Erforderlich: ja, wenn StartAgents nicht explizit auf 0 gesetzt ist
ServerActive
Geben Sie die Adresse des Zabbix-Servers/Proxy oder die Clusterkonfiguration an, von der aktive Prüfungen abgerufen werden sollen.
Die Adresse des Servers/Proxy ist eine IP-Adresse oder ein DNS-Name mit optionalem Port, getrennt durch einen Doppelpunkt.
Die Clusterkonfiguration ist eine oder mehrere Adressen von Mitgliedern einer Server- oder Proxygruppe, getrennt durch Semikolon.
Mehrere Zabbix-Server/Cluster und Zabbix-Proxys können 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/das 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
Bereich: Die Anzahl der in ServerActive aufgeführten aktiven Server plus die Anzahl der für passive Prüfungen in StartAgents angegebenen vorab erzeugten Instanzen muss kleiner als 64 sein.
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.portusw.) hergestellt werden.
StartAgents
Legt die Anzahl der vorab erzeugten Instanzen von zabbix_agentd für die Verarbeitung passiver Prüfungen fest.
Wenn auf 0 gesetzt, sind passive Prüfungen deaktiviert und der Agent lauscht auf keinem TCP-Port.
Standard: 10
Bereich: 0-100 (*)
Timeout
Geben Sie an, wie viele Sekunden beim Aufbau der Verbindung und beim Austausch von Daten 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 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;
- 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, Proxy-Ebene oder auf Datenpunktebene).
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 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.
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 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 erlaubt: \ ' " ` * ? [ ] { } \~ $ ! & ; ( ) < > | # @ %
Zusätzlich sind Zeilenumbrüche 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 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=C:\opt\myscripts