[comment]: # ({0f9ecee9-0f9ecee9})
# 2 Agent

[comment]: # ({/0f9ecee9-0f9ecee9})

[comment]: # ({10b26f52-f5143fcc})
#### Übersicht

Der Zabbix Agent wird auf einem zu überwachenden Zielsystem installiert, um lokale Ressourcen und Anwendungen aktiv zu überwachen (Festplatten, Speicher, Prozessorstatistiken usw.).

Der Agent sammelt Betriebsinformationen lokal und meldet Daten an den Zabbix Server zur weiteren Verarbeitung.
Im Falle von Ausfällen (z. B. wenn eine Festplatte voll läuft oder ein Dienstprozess abstürzt) kann der Zabbix Server die Administratoren des jeweiligen Rechners, der den Ausfall gemeldet hat, aktiv benachrichtigen.

Zabbix Agents sind sehr effizient, da sie für die Erfassung statistischer Informationen native Systemaufrufe verwenden.

Es ist möglich, mehrere Instanzen des Agents auf einem Host auszuführen.

[comment]: # ({/10b26f52-f5143fcc})

[comment]: # ({dc947f39-41e6af7c})
##### Passive und aktive Prüfungen

Zabbix Agenten können passive und aktive Prüfungen durchführen:

-   [Passive Prüfungen](/manual/appendix/items/activepassive#passive-checks) - Der Zabbix Agent antwortet auf eine Anfrage vom Zabbix Server (oder Proxy).
Zum Beispiel fordert der Server Daten an (z. B. CPU-Auslastung), und der Agent gibt das Ergebnis zurück.
-   [Aktive Prüfungen](/manual/appendix/items/activepassive#active-checks) - Der Zabbix Agent sammelt und sendet Daten, ohne auf eine Anfrage vom Zabbix Server (oder Proxy) zu warten.
Zuerst ruft er eine Liste von Überwachungsdatenpunkten vom Server ab (CPU-Auslastung, verfügbarer Speicher usw.), sammelt dann die erforderlichen Daten und sendet regelmäßig neue Werte zurück.

Der Typ der Agent-Prüfung wird durch Auswahl des entsprechenden Überwachungs-[Datenpunkttyps](/manual/config/items/itemtypes/zabbix_agent) konfiguriert.
Der Zabbix Agent verarbeitet Datenpunkte vom Typ *Zabbix agent* oder *Zabbix agent (active)*.

[comment]: # ({/dc947f39-41e6af7c})

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

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

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

[comment]: # ({2e2acc1c-5bbb67d9})
#### Agent auf Unix-ähnlichen Systemen

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

[comment]: # ({/2e2acc1c-5bbb67d9})

[comment]: # ({32a80a93-32937b35})
##### Installation

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

-   [Zabbix-Pakete](https://www.zabbix.com/download?zabbix=7.4) - wählen Sie nach Auswahl Ihrer Zabbix-Version, OS-Distribution und OS-Version die Komponente Agent aus und folgen Sie den bereitgestellten Anweisungen;
-   [Zabbix-Quellen](https://www.zabbix.com/download_sources#74) - laden Sie die Quelldateien herunter und kompilieren Sie den Zabbix Agent, indem Sie die [Quellen konfigurieren](/manual/installation/install) und die Option `--enable-agent` verwenden.

::: noteimportant
Im Allgemeinen funktionieren 32-Bit-Zabbix-Agenten auf 64-Bit-Systemen, können jedoch in einigen Fällen fehlschlagen.
:::

::: noteclassic
Vorkompilierte Binärdateien des Zabbix Agent sind für [den Download](https://www.zabbix.com/download_agents?version=7.4&os=macOS) für macOS, IBM AIX, FreeBSD, OpenBSD und Solaris verfügbar.
Legacy-Binärdateien, die mit der aktuellen Zabbix Server/Proxy-Version kompatibel sind, sind für [NetBSD](https://www.zabbix.com/download_agents?os=NetBSD&show_legacy=1) und [HP-UX](https://www.zabbix.com/download_agents?os=HPUX&show_legacy=1) verfügbar.
:::

[comment]: # ({/32a80a93-32937b35})

[comment]: # ({e1bcff86-99f37c64})
##### Wenn als Paket installiert

Der Zabbix Agent läuft als Daemon-Prozess.
Der Agent kann mit folgendem Befehl gestartet werden:

```bash
systemctl start zabbix-agent
```

Dies funktioniert auf den meisten GNU/Linux-Systemen.
Auf anderen Systemen müssen Sie möglicherweise Folgendes ausführen:

```default
/etc/init.d/zabbix-agent start
```

Um den Zabbix Agent zu stoppen, neu zu starten oder seinen Status zu prüfen, verwenden Sie die folgenden Befehle:

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

[comment]: # ({/e1bcff86-99f37c64})

[comment]: # ({5478d496-5e83177d})
##### Manuell starten

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

```bash
zabbix_agentd
```

[comment]: # ({/5478d496-5e83177d})

[comment]: # ({f276f35a-f276f35a})
#### Agent auf Windows-Systemen

Der Zabbix Agent wird unter Windows als Windows-Dienst ausgeführt.

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

[comment]: # ({9a5d7521-af2aa3a5})
##### Installation

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

-   [Vorkompilierte Zabbix Agent-Binärdateien](https://www.zabbix.com/download_agents?version=7.4) - laden Sie das Zabbix Agent MSI-Installationspaket 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#74) - laden Sie die Quelldateien herunter und folgen Sie den Anweisungen auf der Seite [Zabbix Agent unter Windows kompilieren](/manual/installation/install/win_agent).

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

[comment]: # ({/9a5d7521-af2aa3a5})

[comment]: # ({c2144b71-fa025a89})
#### Optionen

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

|Parameter|Beschreibung|
|--|--------|
|**UNIX and Windows agent**|<|
|`-c --config <config-file>`|Pfad zur [Konfigurationsdatei](/manual/concepts/agent#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 anzeigen.|
|`-V --version`|Versionsnummer anzeigen.|
|**UNIX agent only**|<|
|`-R --runtime-control <option>`|Administrative Funktionen ausführen. Siehe [Runtime-Steuerung](/manual/concepts/agent#runtime-control).|
|**Windows agent only**|<|
|`-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 Wert Hostname 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 (verfügbar unter Windows Server 2008/Vista und späteren Versionen);<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` oder separat verwenden, 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.|

Konkrete Beispiele für die Verwendung von Befehlszeilenparametern:

-   Ausgabe aller integrierten Agent-Datenpunkte mit Werten.
-   Testen eines Benutzerparameters mit dem Schlüssel `mysql.ping`, der in der angegebenen Konfigurationsdatei definiert ist.
-   Installieren eines Zabbix Agent-Dienstes für Windows unter Verwendung des Standardpfads zur Konfigurationsdatei `C:\\Program Files\\Zabbix Agent\\zabbix_agentd.conf`.
-   Installieren eines Zabbix Agent \[Hostname\]-Dienstes für Windows unter Verwendung der Konfigurationsdatei `zabbix_agentd.conf`, die sich im selben Ordner wie die Agent-Programmdatei befindet, und eindeutiges Benennen des Dienstes durch Erweiterung um den Hostname-Wert aus der Konfigurationsdatei.
-   Ändern des Starttyps eines installierten Zabbix Agent-Dienstes für Windows unter Verwendung der Konfigurationsdatei `zabbix_agentd.conf`, die sich im selben Ordner wie die Agent-Programmdatei befindet.

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

[comment]: # ({/c2144b71-fa025a89})

[comment]: # ({fb1bdff2-6ad4cc3c})
##### Laufzeitsteuerung

Mit den Optionen der Laufzeitsteuerung können Sie die Protokollstufe von Agent-Prozessen ändern.

|Option|Description|Target|
|--|------|------|
|`log_level_increase[=<target>]`|Protokollstufe erhöhen.<br>Wenn kein Ziel angegeben ist, sind alle Prozesse betroffen.|Das Ziel kann wie folgt angegeben werden:<br>**Prozesstyp** - alle Prozesse des angegebenen Typs (z. B. `listener`)<br>Siehe alle [Agent-Prozesstypen](#agent-process-types).<br>**Prozesstyp,N** - Prozesstyp und Nummer (z. B. `listener,3`)<br>**pid** - Prozesskennung (`1` bis `65535`). Für größere Werte geben Sie das Ziel als 'Prozesstyp,N' an.|
|`log_level_decrease[=<target>]`|Protokollstufe verringern.<br>Wenn kein Ziel angegeben ist, sind alle Prozesse betroffen.|^|
|`userparameter_reload`|Lädt die Werte der Optionen `UserParameter` und `Include` aus der aktuellen Konfigurationsdatei neu.| |

Beispiele:

-   Protokollstufe aller Prozesse erhöhen
-   Protokollstufe des dritten Listener-Prozesses erhöhen
-   Protokollstufe des Prozesses mit PID 1234 erhöhen
-   Protokollstufe aller aktiven Prüfprozesse verringern


```bash
zabbix_agentd -R log_level_increase
zabbix_agentd -R log_level_increase=listener,3
zabbix_agentd -R log_level_increase=1234
zabbix_agentd -R log_level_decrease="active checks"
```

::: noteclassic
Die Laufzeitsteuerung wird unter OpenBSD, NetBSD und Windows nicht unterstützt.
:::

[comment]: # ({/fb1bdff2-6ad4cc3c})

[comment]: # ({6eff0f17-929667fd})
#### Agent-Prozesstypen

Agent-Prozesstypen sind wie folgt:

-   `active checks` - Prozess zur Durchführung aktiver Prüfungen;
-   `collector` - Prozess zur Datenerfassung;
-   `listener` - Prozess zum Abhören passiver Prüfungen.

Die Agent-Logdatei kann verwendet werden, um diese Prozesstypen zu beobachten.

Seit Zabbix 7.4.6 wird die Agent-Logdatei mit Lese- und Schreibberechtigungen nur für den Dateieigentümer erstellt.
Zusätzlich ist die Datei für die Eigentümergruppe lesbar.
Alle anderen Berechtigungen sind verweigert.

[comment]: # ({/6eff0f17-929667fd})

[comment]: # ({e08842cb-18ab16f1})
#### Prozessbenutzer

Der Zabbix Agent unter UNIX ist dafür ausgelegt, als Benutzer ohne Root-Rechte ausgeführt zu werden.
Er wird unter genau dem Benutzer ohne Root-Rechte ausgeführt, mit dem er gestartet wurde.
Sie können den Agent daher problemlos als jeden Benutzer ohne Root-Rechte ausführen.

Wenn Sie versuchen, ihn als `root` auszuführen, wechselt er zu einem fest codierten Benutzer `zabbix`, der auf Ihrem System vorhanden sein muss.
Sie können den Agent nur dann als `root` ausführen, wenn Sie den Parameter `AllowRoot` in der Konfigurationsdatei des Agent entsprechend anpassen.

[comment]: # ({/e08842cb-18ab16f1})

[comment]: # ({697331c0-fc6b2c61})
#### Konfigurationsdatei

Der Standardpfad zur Konfigurationsdatei ist:

-   Unter UNIX ist der Standard `/usr/local/etc/zabbix_agentd.conf` oder wird durch Variablen zur [Kompilierzeit](/manual/installation/install#configure-the-sources) `--sysconfdir` oder `--prefix` festgelegt.
-   Unter Windows ist der Standard `C:\\Program Files\\Zabbix Agent\\zabbix_agentd.conf`.

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

Weitere Informationen zur Konfiguration des Zabbix Agent finden Sie in den Optionen der Konfigurationsdatei für den [Unix Zabbix Agent](/manual/appendix/config/zabbix_agentd) oder den [Windows Zabbix Agent](/manual/appendix/config/zabbix_agentd_win).

[comment]: # ({/697331c0-fc6b2c61})

[comment]: # ({87186bfa-7c3bd34c})
#### Locale

Beachten Sie, dass der Agent ein UTF-8-Locale benötigt, damit einige textuelle Agent-Datenpunkte den erwarteten Inhalt zurückgeben können.
Die meisten modernen Unix-ähnlichen Systeme verwenden standardmäßig ein UTF-8-Locale, jedoch gibt es einige Systeme, bei denen dies ausdrücklich festgelegt werden muss.

[comment]: # ({/87186bfa-7c3bd34c})

[comment]: # ({4d6a8dc1-5581c546})
#### Exit-Code

Der Zabbix Agent gibt `0` bei erfolgreichem Beenden und `1` bei einem Fehler zurück.

[comment]: # ({/4d6a8dc1-5581c546})