Debugging

Table of contents

• Paths
• Start in foreground
• Query the Agent - Pull Mode with enabled AutoTLS
• Manual query and process check results - Pull Mode
• Access submitted data - Push Mode

Paths

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\

Start in foreground

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

Open a new PowerShell window. Administrator privileges are not required but recommended. Please see Windows Service Configuration how to enable Verbose and Debug options.

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

Query the Agent - Pull Mode with enabled AutoTLS

You can run this curl command on the openITCOCKPIT Monitoring Server to send an request to the Agent.

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

Manual query and process check results - Pull Mode

You can run this command on the openITCOCKPIT Monitoring Server to send an request to the Agent and pass all check results to the Monitoring Engine

/opt/openitc/receiver/bin/poller.php poller -H <Host-UUID> -c /opt/openitc/receiver/etc/production.json --verbose

If you don't want to pass the check results to the Monitoring Engine add the option --dryrun

Access submitted data - Push Mode

Open the openITCOCKPIT web interface and navigate to openITCOCKPIT Agent -> Agents Overview -> Push and select Show received data from the drop down menu.

If the entire Agent is missing from the list, please check the log file of the Agent for any errors.