Zabbix: Agent 2 auf Linux und Windows ausrollen

Aus maxTechCorner
(Weitergeleitet von Zabbix Autoregistrierung)

Auf einen Blick

Gilt fürZabbix 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“
BereichServer-Software
DauerEinrichtung der automatischen Registrierung ca. 30 Minuten; je Server ca. 5 Minuten bzw. automatisch per Softwareverteilung
RechteZabbix-Administrator; Root bzw. lokaler Administrator auf den Servern; für die Verteilung Administrator der Gruppenrichtlinien bzw. von Intune
StandOktober 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.

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?

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

  1. PSK für die Registrierung: Administration › General › Autoregistration – Verschlüsselungsstufe PSK, Identität (z. B. autoreg-firma) und einen Schlüssel mit 64 Hex-Zeichen (openssl rand -hex 32) eintragen.
  2. Aktion anlegen: Alerts › Actions › Autoregistration actions › Create action
    • Bedingung: Host metadata contains linux
    • Operationen: Add host, Add to host groups Server/Linux, Link templates Linux by Zabbix agent active
  3. Eine zweite Aktion für windows mit Gruppe Server/Windows und Vorlage Windows by Zabbix agent active.

Weitere Unterscheidungen sind über die Metadaten möglich, z. B. linux;db;hamburg für Datenbankserver am Standort Hamburg.

Schritt 2: Linux-Server

# 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

/etc/zabbix/zabbix_agent2.conf: 

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
  • 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 Hostname geht auch HostnameItem=system.hostname.
  • Hinter einem Proxy zeigen Server und ServerActive auf den Proxy, siehe Zabbix: Proxys und Proxy-Gruppen für Standorte.
  • sudo systemctl restart zabbix-agent2 – 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: 

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>
  • 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 SKIP=fw 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 ({$VFS.FS.PUSED.MAX.WARN}) oder auszuschließende Dateisysteme – am besten auf Ebene der Hostgruppe bzw. per eigener Vorlage, nicht in der mitgelieferten Vorlage.
  • Eigene Werte über UserParameter bzw. Plugins ergänzen; Fernbefehle (system.run) 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 (TLSCertFile, TLSCAFile).
  • 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 Managed Services von m.a.x. it.

Siehe auch

Links und Quellen


Über m.a.x. it Die m.a.x. Informationstechnologie AG ist seit über 30 Jahren IT-Partner mittelständischer und großer Unternehmen in München und bietet maßgeschneiderte Lösungen und Services in den Bereichen Cloud, Cybersecurity, Netzwerk, Windows, Linux und Softwareentwicklung. Sie haben eine Frage zu diesem Artikel oder brauchen Unterstützung? Kontakt aufnehmen

Abgerufen von „http://techcorner.max-it.de/index.php?title=Zabbix:_Agent_2_auf_Linux_und_Windows_ausrollen&oldid=5096“