[comment]: # ({d60be363-d60be363})
# 3 Agent 2

[comment]: # ({/d60be363-d60be363})

[comment]: # ({72fba9e6-734dc3ed})
#### Übersicht

Zabbix Agent 2 ist eine neue Generation des [Zabbix Agent](/manual/concepts/agent), geschrieben in Go (wobei ein Teil des C-Codes aus dem Zabbix Agent wiederverwendet wird).
Er ist dafür konzipiert,:

-   Die Anzahl der TCP-Verbindungen zu reduzieren;
-   Eine verbesserte [Parallelität von Prüfungen](#check-concurrency) bereitzustellen;
-   Sich mithilfe von [Plugins](/manual/extensions/plugins) leicht erweitern zu lassen, die einfache Prüfungen mit minimalem Code bereitstellen und komplexe Prüfungen unterstützen, die aus lang laufenden Skripten und eigenständiger Datenerfassung mit periodischer Berichterstattung bestehen;
-   Als Ersatz für Zabbix Agent zu fungieren und alle bisherigen Funktionen zu unterstützen.

Alle von Zabbix Agent 2 unterstützten Metriken werden von Plugins erfasst.

[comment]: # ({/72fba9e6-734dc3ed})

[comment]: # ({c03d41e5-eaa0f2bb})
##### Passive und aktive Prüfungen

Zabbix Agent 2 unterstützt [passive und aktive Prüfungen](/manual/concepts/agent#passive-and-active-checks) ähnlich wie Zabbix Agent.
Zusätzlich unterstützen aktive Prüfungen von Zabbix Agent 2 [flexible/planungsbasierte Intervalle](/manual/config/items/item/custom_intervals) und [Prüfungsparallelität](#check-concurrency) innerhalb eines aktiven Servers.

::: noteclassic
Standardmäßig plant Zabbix Agent 2 nach einem Neustart die erste Datenerfassung für aktive Prüfungen zu einem bedingt zufälligen Zeitpunkt innerhalb des Aktualisierungsintervalls des Datenpunkts, um Spitzen bei der Ressourcennutzung zu vermeiden.
Um aktive Prüfungen, die kein *Scheduling*-[Aktualisierungsintervall](/manual/config/items/item/custom_intervals#scheduling-intervals) haben, unmittelbar nach dem Neustart des Agent auszuführen, setzen Sie den Parameter `ForceActiveChecksOnStart` (auf globaler Ebene) oder `Plugins.<Plugin name>.System.ForceActiveChecksOnStart` (wirkt sich nur auf Prüfungen des jeweiligen Plugins aus) in der [Konfigurationsdatei](/manual/appendix/config/zabbix_agent2) fest.
Ein Parameter auf Plugin-Ebene überschreibt, falls gesetzt, den globalen Parameter.
:::

[comment]: # ({/c03d41e5-eaa0f2bb})

[comment]: # ({c777f783-05ea1336})
##### Prüfkonkurrenz

Prüfungen aus verschiedenen Plugins können gleichzeitig ausgeführt werden.
Die Anzahl der gleichzeitigen Prüfungen innerhalb eines Plugins ist durch die Einstellung der Plugin-Kapazität begrenzt.
Jedes Plugin kann eine fest codierte Kapazitätseinstellung haben (`1000` ist standardmäßig der Wert), die mit der Einstellung `Plugins.<PluginName>.System.Capacity=N` im Konfigurations-[Parameter](#configuration-file) `Plugins` verringert werden kann.

[comment]: # ({/c777f783-05ea1336})

[comment]: # ({ec9f8f5e-a2064519})
#### Unterstützte Plattformen

Informationen zu unterstützten Plattformen finden Sie auf der Seite [Anforderungen](/manual/installation/requirements#supported-platforms).

[comment]: # ({/ec9f8f5e-a2064519})

[comment]: # ({138e3f53-72764340})
#### Agent 2 auf Unix-ähnlichen Systemen

Der Zabbix Agent 2 auf Unix-ähnlichen Systemen wird auf dem überwachten Host ausgeführt.

[comment]: # ({/138e3f53-72764340})

[comment]: # ({67720010-cabc0f5f})
##### Installation

Zabbix Agent 2 kann auf Linux-basierten Systemen mit einer der folgenden Methoden installiert werden:

-   [Zabbix-Pakete](https://www.zabbix.com/download?zabbix=7.0) - wählen Sie nach Auswahl Ihrer Zabbix-Version, Ihrer OS-Distribution und Ihrer OS-Version die Komponente Agent 2 aus und folgen Sie den Anweisungen;
-   [Zabbix-Quellen](https://www.zabbix.com/download_sources#70LTS) - laden Sie die Quelldateien herunter und kompilieren Sie den Agent durch [Konfigurieren](/manual/installation/install#configure-the-sources) mit der Option `--enable-agent2`.

::: noteclassic
Die Überwachungsfunktionen von Zabbix Agent 2 können mit ladbaren Plugins erweitert werden, die separat verfügbar sind.
Weitere Informationen finden Sie unter [Ladbare Plugins](/manual/extensions/plugins#loadable-plugins).
:::

::: noteimportant
Seit Zabbix 7.0.5 sind Zabbix Agent 2-Pakete für [RHEL 6](https://repo.zabbix.com/zabbix/6.0/rhel/6/x86_64/) nicht mehr verfügbar, da Go 1.22 (und neuer) nicht mit GCC 4.4.7 kompatibel ist, das von RHEL 6 bereitgestellt wird, was zu Kompilierungsfehlern führt.
Beachten Sie jedoch, dass [Zabbix-Agent-Pakete](/manual/installation/install_from_packages/rhel) weiterhin unterstützt werden.
:::

[comment]: # ({/67720010-cabc0f5f})

[comment]: # ({f46eec4a-8b65e9b6})
##### Wenn als Paket installiert

Zabbix Agent 2 läuft als Vordergrundprozess und ist für die Ausführung im Hintergrund auf einen externen Dienstmanager (z. B. systemd) angewiesen.
Zabbix Agent 2 verfügt unter Linux nicht über eine integrierte Unterstützung für die Daemonisierung.

Der Agent kann mit folgendem Befehl gestartet werden:

```bash
systemctl start zabbix-agent2
```

Zum Stoppen, Neustarten oder Prüfen des Status von Zabbix Agent 2 verwenden Sie die folgenden Befehle:

```bash
systemctl stop zabbix-agent2
systemctl restart zabbix-agent2
systemctl status zabbix-agent2
```

[comment]: # ({/f46eec4a-8b65e9b6})

[comment]: # ({d6099b39-8774d810})
##### Manuell starten

Sie können den Zabbix Agent starten, indem Sie die Binärdatei `zabbix_agent2` suchen und direkt ausführen; zum Beispiel:

```bash
zabbix_agent2
```

[comment]: # ({/d6099b39-8774d810})

[comment]: # ({27b40128-802c2766})
#### Agent 2 auf Windows-Systemen

Zabbix Agent 2 wird als eigenständiger Prozess ausgeführt; er kann jedoch auch als Windows-Dienst ausgeführt werden.

[comment]: # ({/27b40128-802c2766})

[comment]: # ({f2597865-e7f8f342})
##### Installation

Zabbix Agent 2 kann unter Windows mit einer der folgenden Methoden installiert werden:

-   [Vorkompilierte Zabbix-Agent-Binärdateien](https://www.zabbix.com/download_agents?version=7.0+LTS) - laden Sie das MSI-Installationspaket des Agents herunter und folgen Sie den Anweisungen auf der Seite [Windows-Agent-Installation aus MSI](/manual/installation/install_from_packages/win_msi);
-   [Zabbix-Quellen](https://www.zabbix.com/download_sources#70LTS) - laden Sie die Quelldateien herunter und folgen Sie den Anweisungen auf der Seite [Zabbix Agent 2 unter Windows kompilieren](/manual/installation/install/building_zabbix_agent_2_on_windows).

::: noteclassic
Die Überwachungsfunktionen von Zabbix Agent 2 können mit ladbaren Plugins erweitert werden, die separat verfügbar sind.
Weitere Details finden Sie unter [Ladbare Plugins](/manual/extensions/plugins#loadable-plugins).
:::

Weitere Informationen zur Installation von Zabbix Agent 2 (aus einem ZIP-Archiv) als Windows-Dienst finden Sie auf der Seite [Zabbix Agent unter Microsoft Windows](/manual/appendix/install/windows_agent#installing-agent-as-windows-service).

[comment]: # ({/f2597865-e7f8f342})

[comment]: # ({b596fdca-45c02f12})
#### Optionen

Die folgenden Befehlszeilenparameter können mit Zabbix Agent 2 verwendet werden:

|Parameter|Beschreibung|
|--|--------|
|**UNIX- und Windows-Agent**|<|
|`-c --config <config-file>`|Pfad zur [Konfigurationsdatei](/manual/concepts/agent2#configuration-file).<br>Sie können diese Option verwenden, um eine Konfigurationsdatei anzugeben, die nicht die Standarddatei ist.|
|`-f --foreground`|Zabbix Agent im Vordergrund ausführen (Standard: true).|
|`-p --print`|Bekannte Datenpunkte ausgeben und beenden.<br>Beachten Sie, dass Sie die Konfigurationsdatei angeben müssen, wenn Sie auch Ergebnisse von [Benutzerparametern](/manual/config/items/userparameters) zurückgeben möchten (falls sie sich nicht am Standardpfad befindet).|
|`-t --test <item key>`|Den angegebenen Datenpunkt testen und beenden.<br>Beachten Sie, dass Sie die Konfigurationsdatei angeben müssen, wenn Sie auch Ergebnisse von [Benutzerparametern](/manual/config/items/userparameters) zurückgeben möchten (falls sie sich nicht am Standardpfad befindet).|
|`-T --test-config`|Konfigurationsdatei validieren und beenden.|
|`-h --help`|Hilfsinformationen ausgeben und beenden.|
|`-v --verbose`|Debugging-Informationen ausgeben. Verwenden Sie diese Option zusammen mit den Optionen `-p` und `-t`.|
|`-V --version`|Version und Lizenzinformationen des Agenten ausgeben.|
|`-R --runtime-control <option>`|Administrative Funktionen ausführen. Siehe [Runtime-Steuerung](/manual/concepts/agent2#runtime-control).|
|**Nur Windows-Agent**|<|
|`-m --multiple-agents`|Mehrere Agent-Instanzen verwenden (mit den Optionen `-i`, `-d`, `-s`, `-x`).<br>Um Dienstnamen von Instanzen zu unterscheiden, enthält jeder Dienstname den Hostname-Wert aus der angegebenen Konfigurationsdatei.|
|`-S --startup-type <value>`|Den Starttyp des Zabbix Windows-Agent-Dienstes festlegen. Zulässige Werte:<br>`automatic` - *(Standard)* den Dienst automatisch beim Windows-Start starten;<br>`delayed` - den Start des Dienstes verzögern, nachdem die automatisch gestarteten Dienste ihren Start abgeschlossen haben;<br>`manual` - den Dienst manuell starten (durch einen Benutzer oder eine Anwendung);<br>`disabled` - den Dienst deaktivieren, sodass er nicht durch einen Benutzer oder eine Anwendung gestartet werden kann.<br>Sie können diese Option zusammen mit der Option `-i` verwenden oder separat, um den Starttyp eines bereits installierten Dienstes zu ändern.|
|`-i --install`|Zabbix Windows-Agent als Dienst installieren.|
|`-d --uninstall`|Zabbix Windows-Agent-Dienst deinstallieren.|
|`-s --start`|Zabbix Windows-Agent-Dienst starten.|
|`-x --stop`|Zabbix Windows-Agent-Dienst stoppen.|


Spezifische Beispiele für die Verwendung von Befehlszeilenparametern:

-   Alle integrierten Agent-Datenpunkte mit Werten ausgeben.
-   Einen Benutzerparameter mit dem Schlüssel `mysql.ping` testen, der in der angegebenen Konfigurationsdatei definiert ist.
-   Einen Zabbix Agent-Dienst für Windows unter Verwendung des Standardpfads zur Konfigurationsdatei `C:\\Program Files\\Zabbix Agent 2\\zabbix_agent2.conf` installieren.
-   Den Starttyp eines installierten Zabbix Agent-Dienstes für Windows mithilfe der Konfigurationsdatei `zabbix_agent2.conf` ändern, die sich im selben Ordner wie die Agent-Programmdatei befindet.

```bash
zabbix_agent2 --print
zabbix_agent2 -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf
zabbix_agent2.exe -i
zabbix_agent2.exe -c zabbix_agent2.conf -S delayed
```

[comment]: # ({/b596fdca-45c02f12})

[comment]: # ({2b7c1741-11aa0de0})
##### Runtime control

Runtime control bietet einige Optionen für die Fernsteuerung.

|Option|Description|
|--|--------|
|`log_level_increase`|Log-Level erhöhen.|
|`log_level_decrease`|Log-Level verringern.|
|`metrics`|Verfügbare Metriken auflisten.|
|`version`|Agent-Version anzeigen.|
|`userparameter_reload`|Werte der Optionen `UserParameter` und `Include` aus der aktuellen Konfigurationsdatei neu laden.|
|`help`|Hilfsinformationen zur Laufzeitsteuerung anzeigen.|

Beispiele:

-   Log-Level für Agent 2 erhöhen.
-   Optionen der Laufzeitsteuerung ausgeben.

```bash
zabbix_agent2 -R log_level_increase
zabbix_agent2 -R help
```

Seit Zabbix 7.0.17 schreiben Befehle zur Laufzeitsteuerung von Agent 2 die Ausgabe nach `stdout` (Standardausgabe) statt nach `stderr` (Standardfehlerausgabe).

[comment]: # ({/2b7c1741-11aa0de0})

[comment]: # ({2d620e96-77e9b590})
#### Konfigurationsdatei

Der Standardpfad zur Konfigurationsdatei ist:

-   Unter UNIX ist der Standard `/usr/local/etc/zabbix_agent2.conf` oder der über Variablen zur [Kompilierzeit](/manual/installation/install#configure-the-sources) festgelegte Wert `--sysconfdir` oder `--prefix`.
-   Unter Windows ist der Standard `C:\\Program Files\\Zabbix Agent 2\\zabbix_agent2.conf`.

Wenn auf einem Host eine einzelne Instanz des Agent ausgeführt wird, kann sie die Standardkonfigurationsdatei oder eine auf der [Befehlszeile](/manual/concepts/agent2#options) angegebene Konfigurationsdatei verwenden.
Bei mehreren Instanzen muss jede Agent-Instanz über ihre eigene Konfigurationsdatei verfügen (eine der Instanzen kann die Standardkonfigurationsdatei verwenden).

Die Konfigurationsparameter von Zabbix Agent 2 entsprechen größtenteils denen von Zabbix Agent, mit einigen Ausnahmen:

|Parameters|<|Description|
|-|---------|----------|
|Zabbix agent 2-specific configuration parameters|<|<|
| |`ControlSocket`|Der Pfad zum Laufzeit-Steuerungssocket. Zabbix Agent 2 verwendet einen Steuerungssocket für [Laufzeitbefehle](#runtime-control).|
| |`EnablePersistentBuffer`,<br>`PersistentBufferFile`,<br>`PersistentBufferPeriod`|Diese Parameter werden verwendet, um den persistenten Speicher auf Zabbix Agent 2 für aktive Datenpunkte zu konfigurieren.|
| |`ForceActiveChecksOnStart`|Legt fest, ob der Agent aktive Prüfungen unmittelbar nach dem Neustart ausführen oder gleichmäßig über die Zeit verteilen soll.|
| |`Plugins`|Plugins können eigene Parameter im Format `Plugins.<Plugin name>.<Parameter>=<value>` haben. Ein gängiger Plugin-Parameter ist `System.Capacity`, der das Limit für gleichzeitig ausführbare Prüfungen festlegt.|
| |`StatusPort`|Der Port, auf dem Zabbix Agent 2 auf HTTP-Statusanfragen lauscht und eine Liste der konfigurierten Plugins sowie einiger interner Parameter anzeigt.|
|Zabbix agent-specific configuration parameters not supported on Zabbix agent 2|<|<|
| |`AllowRoot`,<br>`User`|Auf Zabbix Agent 2 nicht unterstützt, da keine Daemonisierung unterstützt wird.|
| |`EnableRemoteCommands`|Veraltet; stattdessen werden in beiden Agenten die Parameter `AllowKey` und `DenyKey` verwendet.|
| |`ListenBacklog`|Wird in Zabbix Agent verwendet, um die maximale Anzahl ausstehender Verbindungen in der TCP-Warteschlange festzulegen. Auf Zabbix Agent 2 nicht unterstützt.|
| |`LoadModule`,<br>`LoadModulePath`|Ladbare Module werden in Zabbix Agent 2 nicht unterstützt.|
| |`MaxLinesPerSecond`,<br>`LogRemoteCommands`|In Zabbix Agent 2 werden stattdessen `Plugins.Log.MaxLinesPerSecond` und `Plugins.SystemRun.LogRemoteCommands` verwendet.|
| |`StartAgents`|Dieser Parameter wird in Zabbix Agent verwendet, um die Parallelität passiver Prüfungen zu erhöhen oder diese zu deaktivieren. In Zabbix Agent 2 wird die Parallelität auf Plugin-Ebene konfiguriert und kann durch eine Kapazitätseinstellung begrenzt werden. Passive Prüfungen sind in Zabbix Agent 2 deaktiviert, wenn der Parameter `Server` nicht angegeben ist.|

Weitere Informationen finden Sie in den Optionen der Konfigurationsdatei für [Zabbix agent2](/manual/appendix/config/zabbix_agent2).

[comment]: # ({/2d620e96-77e9b590})

[comment]: # ({76a6838b-472820ac})
#### Exit-Codes

Zabbix Agent 2 kann auch mit älteren OpenSSL-Versionen (1.0.1, 1.0.2) kompiliert werden.

In diesem Fall stellt Zabbix Mutexes für das Locking in OpenSSL bereit.
Wenn das Sperren oder Entsperren eines Mutex fehlschlägt, wird eine Fehlermeldung in den Standardfehlerstrom (STDERR) ausgegeben und Agent 2 beendet sich mit dem Rückgabecode `2` bzw. `3`.

[comment]: # ({/76a6838b-472820ac})