Wie man die Überwachung von Windows-Hosts mit Zabbix zur Fehlerbehebung durchführt
Ganz ehrlich, wenn Sie schon einmal versucht haben, Zabbix zur Überwachung eines Windows-Rechners einzurichten und es dabei zu Problemen kam – beispielsweise fehlende Daten oder Berechtigungsprobleme –, sind Sie nicht allein. Manchmal verläuft die Installation reibungslos, manchmal ist es aber auch mühsam herauszufinden, warum Ihr Server den Agenten nicht erkennt oder die richtigen Daten nicht überwacht. Dieser Leitfaden hilft Ihnen, diese häufigen Probleme zu beheben, seien es Verbindungsprobleme, falsch konfigurierte Agentendateien oder Schwierigkeiten mit der TLS-Verschlüsselung. Das Ziel? Die Kommunikation zwischen Ihrem Windows-Host und Zabbix soll reibungslos funktionieren, damit Sie nicht im Dunkeln tappen.
Fehlerbehebung bei der Installation und Konnektivität des Zabbix-Agenten unter Windows
Prüfen Sie, ob der Zabbix-Agent-Dienst ausgeführt wird und ordnungsgemäß installiert ist.
- Wenn der Agent nicht als laufender Dienst angezeigt wird, wird nichts überwacht.Öffnen Sie die Dienste (drücken Sie Strg Win + R+Alt+ F, geben Sie „Zabbix Agent 2“ ein und drücken
services.mscSie die Eingabetaste) und suchen Sie nach „Zabbix Agent 2 “.Falls er nicht gestartet ist, klicken Sie mit der rechten Maustaste darauf und wählen Sie „Starten“. Stellen Sie ihn außerdem auf automatischen Start ein, damit er beim Systemstart ausgeführt wird. - Manchmal registriert das Installationsprogramm den Dienst nicht korrekt. Eine Neuinstallation kann das Problem beheben. Alternativ können Sie versuchen, den Dienst manuell über ein PowerShell-Fenster mit Administratorrechten zu installieren: `powershell cd ‚C:\Program Files\Zabbix Agent 2\‘.\zabbix_agent2.exe –install Start-Service ‚Zabbix Agent 2’`
Netzwerkverbindung prüfen
- Stellen Sie sicher, dass die IP-Adresse und der Port des Servers vom Windows-Host aus erreichbar sind.Öffnen Sie PowerShell und führen Sie folgenden Befehl aus: `powershell Test-NetConnection`
-Port 10051 - Falls ein Fehler angezeigt wird, überprüfen Sie Ihre Firewall-Regeln oder Netzwerk-ACLs. Möglicherweise blockiert die Windows-Firewall den Port, oder Ihr Server befindet sich hinter einem NAT oder VPN, dessen Zugriff erschwert ist.
- Bei manchen Konfigurationen müssen Sie möglicherweise eine eingehende Regel hinzufügen, um Datenverkehr über Port 10051 zuzulassen. Gehen Sie zu Windows Defender Firewall – Erweiterte Einstellungen – Eingehende Regeln und erstellen Sie dann eine neue Regel für TCP-Port 10051.
Stellen Sie sicher, dass die Agentenkonfigurationsdatei die korrekten Einstellungen enthält.
- Prüfen Sie, ob
C:\Program Files\Zabbix Agent 2\zabbix_agent2.confdie Serveradresse und der Hostname korrekt sind. Häufige Probleme sind ein nicht übereinstimmender Hostname oder eine falsche IP-Adresse in Server und ServerActive. - Überprüfen Sie, ob der Hostname mit dem in der Zabbix-Oberfläche festgelegten Wert übereinstimmt. Manchmal stimmt der Standard-Hostname nicht überein, und der Server verweigert die Datenannahme. Um das Problem zu beheben, legen Sie vorübergehend
Hostname=einen eindeutigen Hostnamen fest oder verwenden SieHostnameItem=system.hostnamedie automatische Hostnamenerkennung. - Stellen Sie bei der TLS-Verschlüsselung mit PSK sicher, dass der
TLSPSKFilePfad korrekt ist und die Schlüsseldatei existiert.Überprüfen Sie außerdem die Berechtigungen – der Agent muss diese Datei lesen können.
Versuchen Sie, TLS und Verschlüsselung vorübergehend zu deaktivieren.
- Bei fehlerhafter Verschlüsselungskonfiguration kommunizieren Agent und Server nicht. Deaktivieren Sie die Verschlüsselung vorübergehend in der Konfiguration: ini TLSConnect=unencrypted TLSAccept=unencrypted
- Starten Sie anschließend den Dienst neu: powershell Restart-Service ‚Zabbix Agent 2‘
- Testen Sie die Verbindung erneut mit
zabbix_get.exe. Das zeigt Ihnen, ob das Problem an der Verschlüsselung, dem Netzwerk oder der Konfiguration liegt.
Protokolle nach Hinweisen durchsuchen
- Die Protokolldatei
C:\Program Files\Zabbix Agent 2\zabbix_agent2.logist sehr hilfreich. Wenn der Agent keine Verbindung herstellt, geben die Protokolle oft Aufschluss über die Ursache – sei es ein TLS-Fehler, ein Problem mit dem Hostnamen oder eine Zugriffsverweigerung. - Achten Sie auf Fehlermeldungen wie „TLS-Handshake fehlgeschlagen“ oder „Verbindung zum Server nicht möglich“. Dies deutet auf Probleme mit der Verschlüsselungskonfiguration oder Netzwerkblockaden hin.
Behebung von Problemen beim Hinzufügen und der Kommunikation von Hosts in Zabbix
Den Host in Zabbix korrekt hinzufügen
- Stellen Sie sicher, dass der in Zabbix eingegebene Hostname
Hostname=exakt mit dem des Agenten übereinstimmt. Andernfalls empfängt der Server keine Daten. Auf manchen SystemenHostnameItem=system.hostnamehilft die Konfiguration, da sie dynamisch an die vom Betriebssystem gemeldeten Daten angepasst wird. - Befindet sich der Agent hinter einem NAT oder VPN, überprüfen Sie, ob die in Zabbix hinzugefügte IP-Adresse oder der DNS-Server dem tatsächlichen Standort entspricht, an dem der Agent erreichbar ist. Verwenden Sie die IP-Adresse, falls der DNS-Server nicht zuverlässig ist.
- Bei verschlüsselter Einrichtung stellen Sie sicher, dass Sie die PSK-Kennung und den PSK-Wert im Zabbix-Frontend unter den Verschlüsselungseinstellungen des Hosts hinzugefügt haben, sodass sie mit den Angaben in der Agentenkonfiguration übereinstimmen.
Warten auf Daten und Fehlerprüfungen
- Nach dem Erstellen oder Bearbeiten eines Hosts warten Sie bitte einige Minuten. Werden keine Daten angezeigt, gehen Sie zu „Überwachung“ → „Neueste Daten“ und filtern Sie nach Ihrem Host. Falls weiterhin keine Daten angezeigt werden, überprüfen Sie die Zabbix-Serverprotokolle oder die Agentenprotokolle auf Fehler.
- Häufig liegt das Problem fehlender Daten darin, dass der Agent nicht kommuniziert oder der Hostname nicht übereinstimmt.
Behebung von Problemen mit der Metrikensammlung und benutzerdefinierten Elementen
Stellen Sie sicher, dass Ihre benutzerdefinierten PowerShell-Prüfungen funktionieren
- Alles, was Sie hinzufügen,
UserParametermuss zuerst direkt auf dem Windows-Host getestet werden. Führen Sie Ihren PowerShell-Befehl manuell aus, um zu prüfen, ob er Daten korrekt ausgibt: `powershell powershell -NoProfile -ExecutionPolicy bypass -Command „(Get-NetTCPConnection -LocalPort 443|measure).count“` - Stellen Sie sicher, dass der Agent über die erforderlichen Berechtigungen zum Ausführen von Skripten oder Befehlen verfügt. Führen Sie PowerShell als Administrator aus und überprüfen Sie die Ausführungsrichtlinien, falls keine Daten zurückgegeben werden.
- Nach der Bearbeitung
zabbix_agent2.confmuss der Agentendienst neu gestartet werden: powershell Restart-Service ‚Zabbix Agent 2‘
Testen Sie die Ausgabe Ihres neuen Artikels.
- Verwenden Sie zabbix_get, um den benutzerdefinierten Schlüssel über die Befehlszeile zu überprüfen: powershell cd ‚C:\Program Files\Zabbix Agent 2\‘.\zabbix_get.exe -s 127.0.0.1 -p 10050 –tls-connect=psk –tls-psk-identity=“SRV01_PreShared_Key“ –tls-psk-file=“C:\Program Files\Zabbix Agent 2\psk.key“ -k ActiveWebSessions
- Wird eine Zahl angezeigt, funktioniert die Datenpipeline. Andernfalls überprüfen Sie Ihr Skript, die Konfiguration oder die Berechtigungen des Agenten.
Zusammenfassung
Die Überwachung von Windows-Hosts mit Zabbix verläuft nicht immer reibungslos, insbesondere am Anfang. Häufige Fehlerquellen sind Hostnamen-Fehler, Netzwerk-/Firewall-Blockaden oder TLS-Fehlkonfigurationen. Wichtig ist, alles Schritt für Schritt zu überprüfen: Läuft der Agentendienst? Ist der Netzwerkzugriff gewährleistet? Ist die Konfigurationsdatei korrekt? Sind die Verschlüsselungseinstellungen richtig? Die Protokolle geben oft Aufschluss über die Fehlerursache, und das manuelle Testen von Befehlen hilft bei der Fehlerbehebung in benutzerdefinierten Skripten.
Zusammenfassung
- Stellen Sie sicher, dass der Zabbix-Agent-Dienst ausgeführt wird und automatisch startet.
- Überprüfen Sie die Netzwerkverbindung mit Test-NetConnection.
- Überprüfen Sie die Agentenkonfiguration, den Hostnamen und die Server-IPs.
- Beginnen Sie mit einer unverschlüsselten Verbindung, falls TLS-Probleme auftreten.
- Durchforsten Sie die Protokolle nach Hinweisen auf Fehler.
- Testen Sie benutzerdefinierte PowerShell-Befehle manuell, bevor Sie sie als Elemente hinzufügen.
Abschluss
Die korrekte Kommunikation zwischen Windows-Hosts und Zabbix kann mitunter etwas Geduld erfordern, insbesondere bei TLS, Hostnamensauflösung oder Netzwerkproblemen. Mit Geduld, systematischem Testen jeder Komponente und sorgfältiger Protokollanalyse lässt sich das Problem in der Regel lösen. Sobald die Verbindung hergestellt ist, wird die Überwachung von Festplattenspeicher bis hin zu aktiven Sitzungen deutlich einfacher – und Sie erhalten endlich Einblick in die Windows-Rechner.