[comment]: # attributes: notoc [comment]: # ({4963afdf-4963afdf}) # 6 Zabbix Agent 2 (Windows) [comment]: # ({/4963afdf-4963afdf}) [comment]: # ({00c81087-9fe069f9}) ### Übersicht Zabbix Agent 2 ist eine neue Generation des Zabbix Agent und kann anstelle von Zabbix Agent verwendet werden. Die von der Windows-Konfigurationsdatei des Zabbix Agent 2 (zabbix\_agent2.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](#alias)|Legt einen Alias für einen Datenpunkt-Schlüssel fest.| |[AllowKey](#allowkey)|Erlaubt die Ausführung derjenigen Datenpunkt-Schlüssel, die einem Muster entsprechen.| |[BufferSend](#buffersend)|Daten nicht länger als N Sekunden im Puffer behalten.| |[BufferSize](#buffersize)|Die maximale Anzahl von Werten im Speicherpuffer.| |[ControlSocket](#controlsocket)|Der Steuersocket, der zum Senden von Laufzeitbefehlen mit der Option '-R' verwendet wird.| |[DebugLevel](#debuglevel)|Die Debug-Ebene.| |[DenyKey](#denykey)|Verweigert die Ausführung derjenigen Datenpunkt-Schlüssel, die einem Muster entsprechen.| |[EnablePersistentBuffer](#enablepersistentbuffer)|Aktiviert die Verwendung eines lokalen persistenten Speichers für aktive Datenpunkte.| |[ForceActiveChecksOnStart](#forceactivechecksonstart)|Führt aktive Prüfungen unmittelbar nach dem Neustart für die zuerst empfangene Konfiguration aus.| |[HeartbeatFrequency](#heartbeatfrequency)|Die Häufigkeit der Heartbeat-Meldungen in Sekunden.| |[HostInterface](#hostinterface)|Ein optionaler Parameter, der die Host-Schnittstelle definiert.| |[HostInterfaceItem](#hostinterfaceitem)|Ein optionaler Parameter, der einen Datenpunkt definiert, der zum Abrufen der Host-Schnittstelle verwendet wird.| |[HostMetadata](#hostmetadata)|Ein optionaler Parameter, der die Host-Metadaten definiert.| |[HostMetadataItem](#hostmetadataitem)|Ein optionaler Parameter, der einen Zabbix Agent-Datenpunkt definiert, der zum Abrufen der Host-Metadaten verwendet wird.| |[Hostname](#hostname)|Ein optionaler Parameter, der den Hostnamen definiert.| |[HostnameItem](#hostnameitem)|Ein optionaler Parameter, der einen Zabbix Agent-Datenpunkt definiert, der zum Abrufen des Hostnamens verwendet wird.| |[Include](#include)|Sie können einzelne Dateien oder alle Dateien in einem Verzeichnis in die Konfigurationsdatei einbinden.| |[ListenIP](#listenip)|Eine durch Kommas getrennte Liste von IP-Adressen, auf denen der Agent lauschen soll.| |[ListenPort](#listenport)|Der Agent lauscht auf diesem Port auf Verbindungen vom Server.| |[LogFile](#logfile)|Der Name der Protokolldatei.| |[LogFileSize](#logfilesize)|Die maximale Größe der Protokolldatei.| |[LogType](#logtype)|Der Typ der Protokollausgabe.| |[PersistentBufferFile](#persistentbufferfile)|Die Datei, in der Zabbix Agent 2 die SQLite-Datenbank speichern soll.| |[PersistentBufferPeriod](#persistentbufferperiod)|Der Zeitraum, für den Daten gespeichert werden sollen, wenn keine Verbindung zum Server oder Proxy besteht.| |[Plugins..System.Capacity](#plugins.systemcapacity)|Das Limit der Prüfungen pro Plugin, die gleichzeitig ausgeführt werden können.| |[Plugins.Log.MaxLinesPerSecond](#plugins.log.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.| |[Plugins.SystemRun.LogRemoteCommands](#plugins.systemrun.logremotecommands)|Aktiviert die Protokollierung der ausgeführten Shell-Befehle als Warnungen.| |[PluginSocket](#pluginsocket)|Der Pfad zur Windows-Named-Pipe für die Kommunikation mit ladbaren Plugins.| |[PluginTimeout](#plugintimeout)|Das Zeitlimit für Verbindungen mit ladbaren Plugins in Sekunden.| |[PerfCounter](#perfcounter)|Definiert einen neuen Parameter , der den Durchschnittswert für den Systemleistungszähler für den angegebenen Zeitraum (in Sekunden) darstellt.| |[PerfCounterEn](#perfcounteren)|Definiert einen neuen Parameter , der den Durchschnittswert für den Systemleistungszähler für den angegebenen Zeitraum (in Sekunden) darstellt. Im Vergleich zu PerfCounter müssen die perfcounter-Pfade auf Englisch angegeben sein.| |[RefreshActiveChecks](#refreshactivechecks)|Wie oft die Liste der aktiven Prüfungen aktualisiert wird.| |[Server](#server)|Eine durch Kommas getrennte Liste von IP-Adressen, optional in CIDR-Notation, oder DNS-Namen von Zabbix Servern und Zabbix Proxys.| |[ServerActive](#serveractive)|Die Adresse des Zabbix Server/Proxy oder die Cluster-Konfiguration, von der aktive Prüfungen abgerufen werden.| |[SourceIP](#sourceip)|Die Quell-IP-Adresse.| |[StatusPort](#statusport)|Wenn gesetzt, lauscht der Agent auf diesem Port auf HTTP-Statusanfragen (http://localhost:/status).| |[Timeout](#timeout)|Gibt an, wie viele Sekunden beim Aufbau der Verbindung und beim Datenaustausch mit dem Zabbix Proxy oder Server gewartet werden soll.| |[TLSAccept](#tlsaccept)|Welche eingehenden Verbindungen akzeptiert werden sollen.| |[TLSCAFile](#tlscafile)|Der vollständige Pfad zu einer Datei mit den Zertifikaten der obersten CA(s) zur Überprüfung von Peer-Zertifikaten, verwendet für verschlüsselte Kommunikation zwischen Zabbix-Komponenten.| |[TLSCertFile](#tlscertfile)|Der vollständige Pfad zu einer Datei mit dem Agent-Zertifikat oder der Zertifikatskette, verwendet für verschlüsselte Kommunikation zwischen Zabbix-Komponenten.| |[TLSCipherAll13](#tlscipherall13)|Die OpenSSL-Cipher-String (TLS 1.3). Überschreibt die standardmäßigen Auswahlkriterien für die Cipher-Suite bei zertifikats- und PSK-basierter Verschlüsselung.| |[TLSCipherCert13](#tlsciphercert13)|Die OpenSSL-Cipher-String (TLS 1.3). Überschreibt die standardmäßigen Auswahlkriterien für die Cipher-Suite bei zertifikatsbasierter Verschlüsselung.| |[TLSCipherPSK13](#tlscipherpsk13)|Die OpenSSL-Cipher-String (TLS 1.3). Überschreibt die standardmäßigen Auswahlkriterien für die Cipher-Suite bei PSK-basierter Verschlüsselung.| |[TLSConnect](#tlsconnect)|Wie der Agent eine Verbindung zum Zabbix Server oder Proxy herstellen soll.| |[TLSCRLFile](#tlscrlfile)|Der vollständige Pfad zu einer Datei mit widerrufenen Zertifikaten. Dieser Parameter wird für verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet.| |[TLSKeyFile](#tlskeyfile)|Der vollständige Pfad zu einer Datei mit dem privaten Schlüssel des Agent, verwendet für verschlüsselte Kommunikation zwischen Zabbix-Komponenten.| |[TLSPSKFile](#tlspskfile)|Der vollständige Pfad zu einer Datei mit dem vorab gemeinsam genutzten Schlüssel des Agent, verwendet für verschlüsselte Kommunikation mit dem Zabbix Server.| |[TLSPSKIdentity](#tlspskidentity)|Die Identitätszeichenfolge des vorab gemeinsam genutzten Schlüssels, verwendet für verschlüsselte Kommunikation mit dem Zabbix Server.| |[TLSServerCertIssuer](#tlsservercertissuer)|Der zulässige Aussteller des Server-(Proxy-)Zertifikats.| |[TLSServerCertSubject](#tlsservercertsubject)|Der zulässige Betreff des Server-(Proxy-)Zertifikats.| |[UnsafeUserParameters](#unsafeuserparameters)|Erlaubt, dass alle Zeichen in Argumenten an benutzerdefinierte Parameter übergeben werden.| |[UserParameter](#userparameter)|Ein benutzerdefinierter Parameter zur Überwachung.| |[UserParameterDir](#userparameterdir)|Der Standard-Suchpfad für UserParameter-Befehle.| Alle Parameter sind optional, sofern nicht ausdrücklich angegeben ist, dass der Parameter obligatorisch ist. Beachten Sie: - Die Standardwerte spiegeln die Prozess-Standardeinstellungen wider, nicht die Werte in den mitgelieferten Konfigurationsdateien; - Zabbix unterstützt Konfigurationsdateien nur in UTF-8-Kodierung ohne [BOM](https://en.wikipedia.org/wiki/Byte_order_mark); - Kommentare, die mit "\#" beginnen, werden nur am Zeilenanfang unterstützt.
[comment]: # ({/00c81087-9fe069f9}) [comment]: # ({8085875f-324d4c30}) ### Parameterdetails [comment]: # ({/8085875f-324d4c30}) [comment]: # ({0e8f6372-fa6993fd}) ##### 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. ```default 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. ```default 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](/manual/discovery/low_level_discovery)-Regeln, die dieselben Discovery-Elemente verarbeiten. ```default 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. [comment]: # ({/0e8f6372-fa6993fd}) [comment]: # ({3ed0c834-e05b8a23}) ##### 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 nacheinander entsprechend ihrer Reihenfolge verarbeitet. Siehe auch: [Restricting agent checks](/manual/config/items/restrict_checks). [comment]: # ({/3ed0c834-e05b8a23}) [comment]: # ({fc56d912-5d573779}) ##### BufferSend Das Zeitintervall in Sekunden, das bestimmt, wie oft Werte aus dem Puffer an den Zabbix Server gesendet werden.
Beachten Sie, dass die Daten früher gesendet werden, wenn der Puffer voll ist. Standard: `5`
Bereich: 1-3600 [comment]: # ({/fc56d912-5d573779}) [comment]: # ({bd027b5f-adbf2018}) ##### 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.
Dieser Parameter sollte nur verwendet werden, wenn der persistente Puffer deaktiviert ist (*EnablePersistentBuffer=0*). Standard: `1000`
Bereich: 2-65535 [comment]: # ({/bd027b5f-adbf2018}) [comment]: # ({78069119-dee4d084}) ##### ControlSocket Der Control-Socket, der zum Senden von Laufzeitbefehlen mit der Option '-R' verwendet wird. Standard: `\\.\pipe\agent.sock` [comment]: # ({/78069119-dee4d084}) [comment]: # ({9c071f70-74594585}) ##### DebugLevel Geben Sie die Debug-Stufe an:
*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 [comment]: # ({/9c071f70-74594585}) [comment]: # ({26eddabd-ad027e43}) ##### DenyKey Verweigert die Ausführung derjenigen Datenpunkt-Schlüssel, die einem Muster entsprechen. Das Schlüssel-Muster ist ein Wildcard-Ausdruck, der das Zeichen "\*" unterstützt, um eine beliebige Anzahl beliebiger Zeichen zu matchen.
Mehrere Regeln für die Schlüsselübereinstimmung können in Kombination mit AllowKey definiert werden. Die Parameter werden nacheinander entsprechend ihrer Reihenfolge verarbeitet. Siehe auch: [Restricting agent checks](/manual/config/items/restrict_checks). [comment]: # ({/26eddabd-ad027e43}) [comment]: # ({ae3ff74a-d9d538db}) ##### 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 [comment]: # ({/ae3ff74a-d9d538db}) [comment]: # ({da2ce1bd-1970c2c5}) ##### 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 [comment]: # ({/da2ce1bd-1970c2c5}) [comment]: # ({70ff69c8-bce527af}) ##### HeartbeatFrequency Die Frequenz der Heartbeat-Nachrichten in Sekunden. Wird zur Überwachung der Verfügbarkeit aktiver Prüfungen verwendet.
0 - Heartbeat-Nachrichten deaktiviert. Standard: `60`
Bereich: 0-3600 [comment]: # ({/70ff69c8-bce527af}) [comment]: # ({cd35abda-9d3624af}) ##### HostInterface Ein optionaler Parameter, der die Host-Schnittstelle (IP-Adresse oder DNS-Name) definiert, die während des [Autoregistrierungs](/manual/discovery/auto_registration)-Prozesses 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 [Using DNS as default interface](/manual/discovery/auto_registration#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 das Limit von 255 Zeichen überschreitet. Bereich: 0-255 Zeichen [comment]: # ({/cd35abda-9d3624af}) [comment]: # ({dc29c465-7378e07f}) ##### HostInterfaceItem Ein optionaler Parameter, der einen Datenpunkt definiert, der verwendet wird, um die Host-Schnittstelle (IP-Adresse oder DNS-Name) während des [Autoregistrierungs](/manual/discovery/auto_registration)-Prozesses des Hosts zu bestimmen. Dieser Wert wird nur verwendet, wenn HostInterface nicht definiert ist. Weitere Informationen finden Sie unter [Using DNS as default interface](/manual/discovery/auto_registration#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 [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run)-Datenpunkt wird unabhängig von den AllowKey/DenyKey-Einstellungen unterstützt. [comment]: # ({/dc29c465-7378e07f}) [comment]: # ({ed067cab-3b42353f}) ##### HostMetadata Ein optionaler Parameter, der die [Metadaten](/manual/discovery/auto_registration#using-host-metadata) definiert, die verwendet werden, um den Host während des Host-[Autoregistrierung](/manual/discovery/auto_registration)-Prozesses (aktiver Agent) zu identifizieren oder zu unterscheiden. HostMetadata ermöglicht die Unterscheidung zwischen Hosts über den Hostnamen hinaus. Wenn nicht definiert, wird der Wert aus HostMetadataItem übernommen. Der Agent gibt einen Fehler aus und startet nicht, wenn der angegebene Wert die Grenze von 2034 Bytes überschreitet oder eine Nicht-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 IPs 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. Bereich: 0-2034 Bytes [comment]: # ({/ed067cab-3b42353f}) [comment]: # ({1ef8844f-eff97518}) ##### HostMetadataItem Ein optionaler Parameter, der einen Zabbix Agent-Datenpunkt definiert, der zum Abrufen von [Host-Metadaten](/manual/discovery/auto_registration#using-host-metadata) verwendet wird. Diese Option wird nur verwendet, wenn HostMetadata nicht definiert ist. Der Wert von HostMetadataItem wird bei jedem [Autoregistrierungs](/manual/discovery/auto_registration)-Versuch abgerufen und nur im Autoregistrierungsprozess des Hosts verwendet (aktiver Agent). HostMetadataItem ermöglicht die Unterscheidung zwischen Hosts über den Hostnamen hinaus. Benutzerdefinierte Parameter und Aliase werden unterstützt. Der [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run)-Datenpunkt wird unabhängig von den AllowKey/DenyKey-Einstellungen unterstützt. Während einer Autoregistrierungsanforderung protokolliert der Agent eine Warnmeldung, wenn der vom angegebenen Datenpunkt zurückgegebene Wert das Limit von 65535 UTF-8-Codepunkten überschreitet. Der vom Datenpunkt zurückgegebene Wert muss eine UTF-8-Zeichenkette sein, andernfalls wird er ignoriert. Wenn ein Parameter eine IP-Adresse oder einen DNS-Namen erwartet, werden Werte, die zwar gültiges UTF-8 sind, aber keine gültigen IPs 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. [comment]: # ({/1ef8844f-eff97518}) [comment]: # ({39406dda-542b591a}) ##### Hostname Eine Liste kommagetrennter, eindeutiger, groß-/kleinschreibungsabhängiger Hostnamen. 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 [comment]: # ({/39406dda-542b591a}) [comment]: # ({77a62307-085b8ddc}) ##### HostnameItem Ein optionaler Parameter, der einen Datenpunkt definiert, der zum Abrufen des Hostnamens verwendet wird. Diese Option wird nur verwendet, wenn Hostname nicht definiert ist. Benutzerparameter oder Aliase werden nicht unterstützt, aber der Datenpunkt [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) wird unabhängig von den AllowKey/DenyKey-Werten unterstützt. Standard: `system.hostname` [comment]: # ({/77a62307-085b8ddc}) [comment]: # ({183802f3-d06cc342}) ##### Einbinden Sie können einzelne Dateien oder alle Dateien in einem Verzeichnis in die Konfigurationsdatei einbinden (standardmäßig unter `C:\Program Files\Zabbix Agent 2`, wenn der Zabbix Agent mit Windows-MSI-Installationspaketen installiert wurde; im bei 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. Der Pfad kann relativ zum Speicherort der Datei *zabbix_agent2.conf* sein (z. B. `Include=.\zabbix_agent2.d\plugins.d\*.conf`).
Um nur relevante Dateien im angegebenen Verzeichnis einzubinden, wird das Platzhalterzeichen Sternchen für die Mustererkennung unterstützt.
Siehe [besondere Hinweise](special_notes_include) zu Einschränkungen. Beispiel: ```default Include=C:\Program Files\Zabbix Agent2\zabbix_agent2.d\*.conf ``` [comment]: # ({/183802f3-d06cc342}) [comment]: # ({43e741ee-21abf7b1}) ##### ListenIP Eine Liste durch Kommas getrennter IP-Adressen, auf denen der Agent lauschen soll. 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` [comment]: # ({/43e741ee-21abf7b1}) [comment]: # ({5f95bc53-2f2c8140}) ##### ListenPort Der Agent lauscht auf diesem Port auf Verbindungen vom Server. Standard: `10050`
Bereich: 1024-32767 [comment]: # ({/5f95bc53-2f2c8140}) [comment]: # ({d3241aab-988826b6}) ##### LogFile Der Name der Agent-Logdatei. Standard: `c:\zabbix_agent2.log`
Erforderlich: Ja, wenn LogType auf *file* gesetzt ist; andernfalls nein [comment]: # ({/d3241aab-988826b6}) [comment]: # ({f7604f8f-ae05fc8d}) ##### LogFileSize Die maximale Größe einer Protokolldatei in MB.
0 - automatische Protokollrotation deaktivieren.
*Hinweis*: Wenn das Größenlimit 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 [comment]: # ({/f7604f8f-ae05fc8d}) [comment]: # ({4226072e-e8dc6df9}) ##### LogType Der Typ der Protokollausgabe:
*file* - Protokoll in die durch den Parameter LogFile angegebenen Datei schreiben;
*console* - Protokoll in die Standardausgabe schreiben. Standardwert: `file` [comment]: # ({/4226072e-e8dc6df9}) [comment]: # ({357a4f09-dde3e6b9}) ##### PersistentBufferFile Die Datei, in der Zabbix Agent 2 die SQLite-Datenbank speichern soll. Es muss ein vollständiger Dateiname angegeben werden. Dieser Parameter wird nur verwendet, wenn der persistente Puffer aktiviert ist (*EnablePersistentBuffer=1*). [comment]: # ({/357a4f09-dde3e6b9}) [comment]: # ({2937cc76-379dc265}) ##### PersistentBufferPeriod Der Zeitraum, für den Daten gespeichert werden sollen, wenn keine Verbindung zum Server oder Proxy besteht. Ältere Daten gehen verloren. Logdaten bleiben erhalten. Dieser Parameter wird nur verwendet, wenn der persistente Puffer aktiviert ist (*EnablePersistentBuffer=1*). Standard: `1h`
Bereich: 1m-365d [comment]: # ({/2937cc76-379dc265}) [comment]: # ({9b0fb2d6-a2a522ee}) ##### Plugins..System.Capacity {#plugins.systemcapacity} Die Obergrenze für Prüfungen pro ``-Plugin, die gleichzeitig ausgeführt werden können. Standard: `1000` Bereich: 1-1000 [comment]: # ({/9b0fb2d6-a2a522ee}) [comment]: # ({99218c04-c6daef84}) ##### Plugins.Log.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 in Protokolleinträgen nach der erforderlichen Zeichenfolge zu suchen. Standard: `20`
Bereich: 1-1000 [comment]: # ({/99218c04-c6daef84}) [comment]: # ({487e5b60-d7133c6e}) ##### 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 [comment]: # ({/487e5b60-d7133c6e}) [comment]: # ({e879decb-c712bfb8}) ##### PluginSocket Der Pfad zur Windows-Named-Pipe für die Kommunikation mit ladbaren Plugins. Standard: `\\.\pipe\agent.plugin.sock` [comment]: # ({/e879decb-c712bfb8}) [comment]: # ({14afe8ce-1db534a6}) ##### PluginTimeout Das Zeitlimit für Verbindungen mit ladbaren Plugins, in Sekunden. Standard: `Timeout`
Bereich: 1-30 [comment]: # ({/14afe8ce-1db534a6}) [comment]: # ({444f6259-69cf2ccd}) ##### PerfCounter Definiert einen neuen Parameter , der den Durchschnittswert des Systemleistungsindikators für den angegebenen Zeitraum (in Sekunden) darstellt.
Syntax: ,"", Wenn Sie beispielsweise die durchschnittliche Anzahl der Prozessorinterrupts pro Sekunde für die letzte Minute erhalten möchten, können Sie einen neuen Parameter "interrupts" wie folgt definieren:
```default 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. Beispiele 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. [comment]: # ({/444f6259-69cf2ccd}) [comment]: # ({c2cc7bf4-e983c97e}) ##### PerfCounterEn Definiert einen neuen Parameter , der den Durchschnittswert des Systemleistungsindikators für den angegebenen Zeitraum (in Sekunden) liefert. Im Vergleich zu PerfCounter müssen die perfcounter-Pfade auf Englisch angegeben werden. Nur unter **Windows Server 2008/Vista** und höher unterstützt.
Syntax: ,"", Wenn Sie beispielsweise den durchschnittlichen Wert der Prozessorunterbrechungen pro Sekunde für die letzte Minute erhalten möchten, können Sie einen neuen Parameter "interrupts" wie folgt definieren:
```default 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. Für die Berechnung des Durchschnittswerts werden jede Sekunde Stichproben 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`. [comment]: # ({/c2cc7bf4-e983c97e}) [comment]: # ({3d47a4c2-25e3871b}) ##### RefreshActiveChecks Wie oft die Liste der aktiven Prüfungen aktualisiert wird, in Sekunden. Beachten Sie, dass nach einem fehlgeschlagenen Versuch, die aktiven Prüfungen zu aktualisieren, der nächste Aktualisierungsversuch in 60 Sekunden erfolgt. Standard: `5`
Bereich: 1-86400 [comment]: # ({/3d47a4c2-25e3871b}) [comment]: # ({bb2bfe8d-0ad80cbc}) ##### Server Eine Liste durch Kommas getrennter 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, 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. Wenn dieser Parameter nicht angegeben wird, werden passive Prüfungen deaktiviert, und der Agent lauscht auf keinem TCP-Port. Beispiel: ```default Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com ``` [comment]: # ({/bb2bfe8d-0ad80cbc}) [comment]: # ({56b8410d-0d31e03a}) ##### ServerActive Die Adresse des Zabbix-Servers/-Proxys oder die Clusterkonfiguration, von der aktive Prüfungen abgerufen werden. Die Adresse des Servers/Proxys ist eine IP-Adresse oder ein DNS-Name, optional mit 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 einen Zabbix-Proxy: ```default 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: ```default ServerActive=127.0.0.1:20051,zabbix.domain,\[::1\]:30051,::1,\[12fc::1\] ``` Beispiel für Hochverfügbarkeit: ```default ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3 ``` Beispiel für Hochverfügbarkeit mit zwei Clustern und einem Server: ```default ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain ``` [comment]: # ({/56b8410d-0d31e03a}) [comment]: # ({76194937-f96761ad}) ##### SourceIP Die Quell-IP-Adresse für: - ausgehende Verbindungen zum Zabbix-Server oder Zabbix-Proxy; - Verbindungen, die beim Ausführen bestimmter Datenpunkte hergestellt werden (web.page.get, net.tcp.port usw.). [comment]: # ({/76194937-f96761ad}) [comment]: # ({7d3f343b-8b9a658a}) ##### StatusPort Wenn gesetzt, lauscht der Agent auf diesem Port auf HTTP-Statusanfragen (http://localhost:/status). Bereich: 1024-32767 [comment]: # ({/7d3f343b-8b9a658a}) [comment]: # ({37e987ac-baa42b03}) ##### Timeout Gibt an, wie lange beim Aufbau der Verbindung und beim Austausch von Daten mit dem Zabbix Proxy oder Server gewartet werden soll (in Sekunden).
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](/manual/appendix/items/activepassive#active-checks); - Abrufen von Protokolldaten über die Überwachung von Logdateien oder Windows-Ereignisprotokollen; - Senden von Heartbeat-Nachrichten; - maximale Dauer für `vfs.*`-Prüfungen; - dient als Fallback in Szenarien, in denen ein Server oder Proxy älter als Version 7.0 Prüfungen ohne Timeouts sendet. Dieses Timeout wird **nicht** für jene Agent-Prüfungen verwendet, die in der Frontend konfigurierbare Timeout-Einstellungen haben (auf globaler Ebene, auf Proxy-Ebene oder auf Datenpunktebene). Standard: `3`
Bereich: 1-30 [comment]: # ({/37e987ac-baa42b03}) [comment]: # ({2200adc7-5fffe23e}) ##### TLSAccept Die eingehenden Verbindungen, die akzeptiert werden sollen. Wird für passive Prüfungen verwendet. Mehrere Werte können durch Komma getrennt angegeben werden:
*unencrypted* - Verbindungen ohne Verschlüsselung akzeptieren (Standard)
*psk* - Verbindungen mit TLS und einem vorab gemeinsam genutzten Schlüssel (PSK) akzeptieren
*cert* - Verbindungen mit TLS und einem Zertifikat akzeptieren Pflicht: ja, wenn TLS-Zertifikat- oder PSK-Parameter definiert sind (auch für *unencrypted* Verbindungen); andernfalls nein [comment]: # ({/2200adc7-5fffe23e}) [comment]: # ({65d07bda-01a58fb9}) ##### TLSCAFile Der vollständige Pfadname der Datei, 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. [comment]: # ({/65d07bda-01a58fb9}) [comment]: # ({005f60f1-64ff2b38}) ##### TLSCertFile Der vollständige Pfadname der Datei, die das Agent-Zertifikat oder die Zertifikatskette enthält und für verschlüsselte Kommunikation mit Zabbix-Komponenten verwendet wird. [comment]: # ({/005f60f1-64ff2b38}) [comment]: # ({a467b58d-fd228a11}) ##### TLSCipherAll13 Die OpenSSL-Cipher-String (TLS 1.3). Überschreibt die standardmäßigen Auswahlkriterien für die Ciphersuite bei zertifikats- und PSK-basierter Verschlüsselung. Beispiel: ```default TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 ``` Dieser Parameter wird seit Zabbix 7.0.4 unterstützt. [comment]: # ({/a467b58d-fd228a11}) [comment]: # ({8e8a68b3-2900b2ec}) ##### TLSCipherCert13 Die OpenSSL-Cipher-String (TLS 1.3). Überschreibt 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. Dieser Parameter wird seit Zabbix 7.0.4 unterstützt. [comment]: # ({/8e8a68b3-2900b2ec}) [comment]: # ({6cb7784a-e8316817}) ##### TLSCipherPSK13 Die OpenSSL-Cipher-String (TLS 1.3). Überschreibt die standardmäßigen Auswahlkriterien für die Ciphersuite bei PSK-basierter Verschlüsselung. Beispiel: ```default TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 ``` Dieser Parameter wird seit Zabbix 7.0.4 unterstützt. [comment]: # ({/6cb7784a-e8316817}) [comment]: # ({e2ebc18f-0c14341a}) ##### 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 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 [comment]: # ({/e2ebc18f-0c14341a}) [comment]: # ({ad4dc889-353fa6b2}) ##### TLSCRLFile Der vollständige Pfadname der Datei, die widerrufene Zertifikate enthält. Dieser Parameter wird für verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet. [comment]: # ({/ad4dc889-353fa6b2}) [comment]: # ({c2aa4315-40db7da5}) ##### TLSKeyFile Der vollständige Pfadname der Datei, die den privaten Schlüssel des Agent enthält und für verschlüsselte Kommunikation zwischen Zabbix-Komponenten verwendet wird. [comment]: # ({/c2aa4315-40db7da5}) [comment]: # ({11defa44-216346d5}) ##### TLSPSKFile Der vollständige Pfadname der Datei, die den vorab gemeinsam genutzten Schlüssel des Agent enthält und für verschlüsselte Kommunikation mit dem Zabbix Server verwendet wird. [comment]: # ({/11defa44-216346d5}) [comment]: # ({92d3eff0-d9d037af}) ##### TLSPSKIdentity Der Identitätsstring des vorab gemeinsam genutzten Schlüssels, der für verschlüsselte Kommunikation mit dem Zabbix-Server verwendet wird. [comment]: # ({/92d3eff0-d9d037af}) [comment]: # ({ae5c568f-4a08c667}) ##### TLSServerCertIssuer Der zulässige Zertifikatsaussteller des Servers (Proxy). [comment]: # ({/ae5c568f-4a08c667}) [comment]: # ({fb69617f-6446ac76}) ##### TLSServerCertSubject Das zulässige Zertifikats-Subject des Servers (Proxy). [comment]: # ({/fb69617f-6446ac76}) [comment]: # ({8fffe818-42a95de3}) ##### 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 [comment]: # ({/8fffe818-42a95de3}) [comment]: # ({e817d9a2-cba7618d}) ##### UserParameter Ein benutzerdefinierter Parameter zur Überwachung. Es können mehrere benutzerdefinierte Parameter vorhanden sein.
Format: UserParameter=,
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: ```default UserParameter=system.test,dir /b | find /c /v "" UserParameter=check_cpu,.\custom\_script.bat ``` [comment]: # ({/e817d9a2-cba7618d}) [comment]: # ({c9cc7c82-f6be7620}) ##### UserParameterDir Der standardmäßige Suchpfad für UserParameter-Befehle. 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: ```default UserParameterDir=C:\opt\myscripts ``` [comment]: # ({/c9cc7c82-f6be7620})