Monitoring through openITCOCKPIT Monitoring Agent - Push Mode



Push Mode is the perfect fit to monitor systems that are not reachable from the monitoring system. For example if the target system is behind a NAT or a Firewall not under your control.

The communication is encrypted by default through HTTPS.

Download and install openITCOCKPIT Monitoring Agent

Before you start please install the openITCOCKPIT Monitoring Agent on the target system you like to monitor.

We recommend to get the latest version from the official download page.

Monitor a host through openITCOCKPIT Monitoring Agent - Push Mode

In the context menu of hosts select the option openITCOCKPIT Monitoring Agent discovery

A wizard based configuration process will guide you through all steps. Select Push Mode to continue.

The second step is basically an graphical configuration generator to modify the config file of the openITCOCKPIT Monitoring Agent. Select the operating system you like to monitor.

Set the public ip address or FQDN of your openITCOCKPIT Server at openITCOCKPIT Server Address and specify an API key the agent should use at openITCOCKPIT API Key.

Click on Next to continue.

The third step tells you where to download and put the configuration file for the openITCOCKPIT Monitoring Agent.

Copy the shown configuration file to the shown location and restart the openITCOCKPIT Monitoring Agent service. The commands and file locations are depending on the operating system. Click on Next to continue.

Every Agent sends an unique identifier to the openITCOCKPIT Server. To avoid that unauthorized system can push check results to the openITCOCKPIT Server, all Agents operating in Push Mode have to be mapped to a host manually. Click on Next to continue.

The system will pick up basic health metrics like CPU, memory and SWAP usage by default. In addition you can select which process or services you like to monitor. If you are done, press Finish to finalize the openITCOCKPIT Monitoring Agent setup.

Due to the Agent is running in Push Mode it is possible that openITCOCKPIT did not receive any data yet and therefore can not display any services. If this happens on your system click on to go the the previous step, wait 30 seconds and click on Next again.

The last step reminds you to refresh your monitoring configuration to apply the new configuration changes.

Please click on Refresh monitoring configuration.

This button is also always available as shortcut in the top menu bar.

Press Launch refresh to apply the new configuration.

After a few seconds the system will start to monitor the selected services and also generate charts whenever possible.

Determining the host status (Optional but recommended)

By default, openITCOCKPIT will send an ping to the target host to determining the host status. In most cases when the Push Mode gets used it is not possible to send a ping to the target device.

Edit the host and select the host template openITCOCKPIT Agent - Push and save. Don't forget to refresh the monitoring configuration.

openITCOCKPIT will now evaluate the timestamp of the last received message from the openITCOCKPIT Monitoring Agent to determine if the host is up or down.

For more information please see the documentation: https://github.com/it-novum/openitcockpit-agent-go/wiki/Determining-the-host-status