Quelltext der Seite Zabbix: Agent 2 auf Linux und Windows ausrollen

{{Steckbrief
| gilt_fuer   = Zabbix Agent 2 (7.0 LTS bzw. 7.4) auf Debian/Ubuntu und Windows Server 2016–2025; Zabbix-Server bzw. -Proxy 7.0/7.4; Vorlagen „Linux by Zabbix agent active“ und „Windows by Zabbix agent active“
| bereich     = Server-Software
| dauer       = Einrichtung der automatischen Registrierung ca. 30 Minuten; je Server ca. 5 Minuten bzw. automatisch per Softwareverteilung
| rechte      = Zabbix-Administrator; Root bzw. lokaler Administrator auf den Servern; für die Verteilung Administrator der Gruppenrichtlinien bzw. von Intune
| stand       = Oktober 2026
}}
'''Den Zabbix Agent 2 ausrollen''' ist der wichtigste Schritt, um Server zu überwachen: Der Agent liefert CPU, Speicher, Laufwerke, Dienste, Prozesse, Ereignisprotokolle und Anwendungswerte, die SNMP oder reine Erreichbarkeitsprüfungen nicht sehen. Mit '''aktiven Checks''' und '''automatischer Registrierung''' melden sich neue Server selbst beim Zabbix-Server, werden mit der passenden Vorlage verknüpft und verschlüsselt angebunden – ohne dass Firewalls Verbindungen zu jedem Server öffnen müssen. Diese Anleitung zeigt die Einrichtung für Linux und Windows einschließlich PSK-Verschlüsselung und Verteilung per MSI.

[[Datei:Zabbix-Agent.png|thumb|center|750px|Zabbix Agent 2: aktive Checks – der Agent verbindet sich zum Server bzw. Proxy auf Port 10051, holt seine Prüfliste und sendet Werte, puffert bei Ausfall; passive Checks – der Server fragt den Agenten auf Port 10050 ab; automatische Registrierung anhand von HostMetadata wie linux oder windows mit Aktion, die Host anlegt, Gruppe und Vorlage zuweist; Verschlüsselung mit Pre-Shared Key (PSK); Verteilung unter Windows per MSI mit SERVER, SERVERACTIVE, HOSTMETADATA, TLSPSKIDENTITY und TLSPSKVALUE, unter Linux per Paket und Konfigurationsmanagement.]]

== Zabbix Agent 2 statt Agent ==
* '''Zabbix Agent 2''' ist in Go geschrieben, erweiterbar über Plugins (z. B. für Docker, PostgreSQL, MySQL, MongoDB, Redis, Zertifikate, Ceph), kann aktive Werte bei Verbindungsabbruch in einer lokalen Datenbank puffern und ist der empfohlene Agent für neue Installationen.
* Der klassische Agent (C) wird weiter gepflegt und ist für sehr alte Systeme oder Spezialfälle sinnvoll.
* Agenten dürfen '''älter''' sein als der Server; der Server sollte aber nicht älter als die Agenten sein.

== Aktive oder passive Checks? ==
{| class="wikitable"
! Art !! Verbindung !! Vorteil !! Nachteil
|-
| '''Aktiv''' || Agent → Server/Proxy, Port 10051 || nur ausgehende Verbindungen von den Servern; Puffer bei Ausfall; skaliert besser || Erreichbarkeit des Agenten muss separat geprüft werden (Vorlage enthält „nodata“-Trigger)
|-
| '''Passiv''' || Server → Agent, Port 10050 || einfache Fehlersuche, Server bestimmt Takt || eingehender Port auf jedem Server
|}
'''Empfehlung''': aktive Checks mit den Vorlagen ''Linux by Zabbix agent active'' bzw. ''Windows by Zabbix agent active''. Passive Checks nur, wenn benötigt (z. B. für Fernbefehle oder spontane Abfragen).

== Schritt 1: Automatische Registrierung vorbereiten ==
# '''PSK für die Registrierung''': ''Administration › General › Autoregistration'' – Verschlüsselungsstufe ''PSK'', Identität (z. B. <code>autoreg-firma</code>) und einen Schlüssel mit 64 Hex-Zeichen (<code>openssl rand -hex 32</code>) eintragen.
# '''Aktion anlegen''': ''Alerts › Actions › Autoregistration actions › Create action''
#* Bedingung: ''Host metadata'' ''contains'' <code>linux</code>
#* Operationen: ''Add host'', ''Add to host groups'' ''Server/Linux'', ''Link templates'' ''Linux by Zabbix agent active''
# Eine zweite Aktion für <code>windows</code> mit Gruppe ''Server/Windows'' und Vorlage ''Windows by Zabbix agent active''.
Weitere Unterscheidungen sind über die Metadaten möglich, z. B. <code>linux;db;hamburg</code> für Datenbankserver am Standort Hamburg.

== Schritt 2: Linux-Server ==
<syntaxhighlight lang="bash">
# Repository wie beim Server einbinden (siehe Installationsartikel), dann:
sudo apt install zabbix-agent2 zabbix-agent2-plugin-*
openssl rand -hex 32 | sudo tee /etc/zabbix/zabbix_agent2.psk
sudo chown zabbix:zabbix /etc/zabbix/zabbix_agent2.psk && sudo chmod 600 /etc/zabbix/zabbix_agent2.psk
</syntaxhighlight>
<code>/etc/zabbix/zabbix_agent2.conf</code>:
<syntaxhighlight lang="ini">
Server=zabbix.firma.lan
ServerActive=zabbix.firma.lan
Hostname=srv-web01
HostMetadata=linux
TLSConnect=psk
TLSAccept=psk
TLSPSKIdentity=autoreg-firma
TLSPSKFile=/etc/zabbix/zabbix_agent2.psk
</syntaxhighlight>
* Für die Registrierung muss Identität und Schlüssel mit den Werten unter ''Autoregistration'' übereinstimmen. Danach kann jedem Host in seiner Konfiguration (Reiter ''Encryption'') ein eigener PSK zugewiesen werden.
* Statt fester <code>Hostname</code> geht auch <code>HostnameItem=system.hostname</code>.
* Hinter einem Proxy zeigen <code>Server</code> und <code>ServerActive</code> auf den Proxy, siehe [[Zabbix: Proxys und Proxy-Gruppen für Standorte]].
* <code>sudo systemctl restart zabbix-agent2</code> – nach spätestens einigen Minuten erscheint der Host unter ''Data collection › Hosts''.
* Für viele Server die Konfiguration per Ansible, Salt oder Puppet verteilen.

== Schritt 3: Windows-Server per MSI ==
Das MSI-Paket „Zabbix agent 2 … windows-amd64-openssl.msi“ von zabbix.com unterstützt alle wichtigen Einstellungen als Parameter:
<syntaxhighlight lang="bat">
msiexec.exe /l*v "C:\Windows\Temp\zabbix_agent2.log" /i zabbix_agent2-7.0.31-windows-amd64-openssl.msi /qn ^
  SERVER=zabbix.firma.lan SERVERACTIVE=zabbix.firma.lan ^
  HOSTNAMEITEM=system.hostname HOSTMETADATA=windows ^
  TLSCONNECT=psk TLSACCEPT=psk TLSPSKIDENTITY=autoreg-firma TLSPSKVALUE=<64-Hex-Zeichen>
</syntaxhighlight>
* '''Verteilung''' per Gruppenrichtlinie (Startskript), Intune (Win32-App) oder Softwareverteilung. Den PSK nicht im Klartext in öffentlich lesbaren Freigaben ablegen.
* Das MSI legt standardmäßig eine Ausnahme in der Windows-Firewall an (mit <code>SKIP=fw</code> abschaltbar); für reine aktive Checks ist kein eingehender Port nötig.
* Werte der Windows-Vorlage: CPU, Speicher, Laufwerke, Netzwerk, Dienste mit Starttyp „Automatisch“, Ereignisprotokolle; für Rollen wie Active Directory, DNS, IIS oder MS SQL zusätzliche Vorlagen verknüpfen.

== Schritt 4: Prüfen und anpassen ==
* ''Monitoring › Latest data'': Werte des neuen Hosts kontrollieren.
* Die Spalte ''Availability'' bei ''Data collection › Hosts'' zeigt den Agentenstatus.
* '''Makros''' der Vorlagen anpassen, z. B. Schwellen für freien Plattenplatz (<code>{$VFS.FS.PUSED.MAX.WARN}</code>) oder auszuschließende Dateisysteme – am besten auf Ebene der Hostgruppe bzw. per eigener Vorlage, nicht in der mitgelieferten Vorlage.
* '''Eigene Werte''' über <code>UserParameter</code> bzw. Plugins ergänzen; Fernbefehle (<code>system.run</code>) bleiben aus Sicherheitsgründen gesperrt, solange sie nicht ausdrücklich erlaubt werden.

== Hinweise ==
* '''Zertifikate statt PSK''' sind bei großen Umgebungen mit vorhandener PKI möglich (<code>TLSCertFile</code>, <code>TLSCAFile</code>).
* '''Updates''': Agenten über die Paketverwaltung bzw. neue MSI-Versionen aktualisieren; sie müssen nicht im Gleichschritt mit dem Server erneuert werden.
* Bei der Ausbringung von Monitoring-Agenten und dem laufenden Betrieb unterstützen Sie die [https://www.max-it.de/it-services/managed-services/ Managed Services von m.a.x. it].

== Siehe auch ==
* [[Zabbix]] – Überblick und alle Artikel der Reihe
* [[Zabbix: Installation mit PostgreSQL und TimescaleDB]]
* [[OPNsense - Zabbix-Agent]]
* [[Monitoring]]

== Links und Quellen ==
* [https://www.zabbix.com/documentation/7.0/en/manual/installation/install_from_packages/win_msi Zabbix-Dokumentation: Windows agent installation from MSI]
* [https://www.max-it.de/it-services/managed-services/ Managed Services von m.a.x. it]

{{Uebermax}}
[[Kategorie:Server-Software]]