Debugging¶
Pfade¶
Linux¶
/etc/openitcockpit-agent/
/var/log/openitcockpit-agent/
macOS¶
/Applications/openitcockpit-agent/
/Library/Logs/openitcockpit-agent/
Windows¶
C:\Program Files\it-novum\openitcockpit-agent
Registry:
HKEY_LOCAL_MACHINE\SOFTWARE\it-novum\
Im Vordergrund starten¶
Linux¶
sudo systemctl stop openitcockpit-agent
sudo /usr/bin/openitcockpit-agent --config /etc/openitcockpit-agent/config.ini --log /tmp/agent.log --verbose --debug
macOS¶
sudo su
/bin/launchctl stop com.it-novum.openitcockpit.agent
/Applications/openitcockpit-agent/openitcockpit-agent --config /Applications/openitcockpit-agent/config.ini --log /tmp/agent.log --verbose --debug
Windows¶
Öffnen Sie ein neues PowerShell
-Fenster. Administratorrechte sind nicht erforderlich, aber empfohlen. Bitte lesen Sie Windows-Dienstkonfiguration, wie Sie die Optionen Verbose
und Debug
aktivieren.
cd "C:\Program Files\it-novum\openitcockpit-agent"
Stop-Service -Name openITCOCKPITAgent
$env:OITC_AGENT_DEBUG="1"
.\openitcockpit-agent.exe -c "$PWD\config.ini" -l "$env:TEMP\agent.log" --debug --verbose
Den Agent abfragen - Pull-Modus mit aktiviertem AutoTLS¶
Sie können diesen curl-Befehl auf dem openITCOCKPIT Monitoring Server ausführen, um eine Anfrage an den Agent zu senden.
curl -k -v https://xxx.xxx.xxx.xxx:3333 --cacert /opt/openitc/agent/server_ca.pem --key /opt/openitc/agent/server_ca.key --cert /opt/openitc/agent/server_ca.pem
Manuelle Abfrage und Verarbeiten der Check-Ergebnisse - Pull-Modus¶
Sie können diesen Befehl auf dem openITCOCKPIT Monitoring Server ausführen, um eine Anfrage an den Agent zu senden und alle Check-Ergebnisse an die Monitoring-Engine weiterzuleiten.
/opt/openitc/receiver/bin/poller.php poller -H <Host-UUID> -c /opt/openitc/receiver/etc/production.json --verbose
Wenn Sie die Check-Ergebnisse nicht an die Monitoring-Engine weiterleiten möchten, fügen Sie die Option --dryrun
hinzu.
Übermittelte Daten abrufen - Push-Modus¶
Öffnen Sie die openITCOCKPIT-Weboberfläche und navigieren Sie zu openITCOCKPIT Agent -> Agents Overview -> Push
und wählen Sie Show received data
aus dem Dropdown-Menü aus.
Wenn der gesamte Agent in der Liste fehlt, überprüfen Sie bitte die Protokolldatei des Agents auf Fehler.
Windows Management Instrumentation (WMI)¶
Auf Windows-Systemen nutzt der openITCOCKPIT Monitoring Agent WMI, um Systemmetriken abzufragen. Es ist wichtig, dass WMI aktiviert und betriebsbereit ist (Standardverhalten).
In seltenen Fällen treten Fehler wie "Win32_PerfFormattedData_PerfOS_Processor: WMI: Ungültige Klasse" auf.
Zuerst sollten Sie versuchen, WMI manuell über PowerShell abzufragen.
Get-WmiObject Win32_PerfFormattedData_PerfOS_Processor
Wenn dies mit einer Fehlermeldung fehlschlägt, können Sie die Einstellungen der Windows Performance Counter auf die Standardeinstellungen zurücksetzen.
-
Öffnen Sie eine CMD.
-
Stellen Sie die Einstellungen der Windows Performance Counter wieder her.
lodctr /R
-
Synchronisieren Sie die Performance Counter mit Windows Management Instrumentation (WMI):
WINMGMT /RESYNCPERF
-
Starten Sie den openITCOCKPIT Monitoring Agent Dienst neu.