Monitoring through openITCOCKPIT Agent



Monitoring the basic parameters of a host should not be a challenging or annoying task. The openITCOCKPIT Monitoring Agent is available for Windows, Linux and macOS and capable of collecting basic metrics like CPU, memory and disk usages, networking status, temperatures etc. out of the box.

To be extendable and customizable the openITCOCKPIT Agent is 100% compatible with the Nagios Plugin API. So no additional software (like NRPE or check_by_ssh) is required to execute plugins on the target system.

The communication is done via HTTP/s.

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.

The source code is available through the GitHub repository: https://github.com/it-novum/openitcockpit-agent

Monitor a host through openITCOCKPIT Monitoring Agent

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

A wizard based configuration process will guide you through all steps.

Main differences between Pull and Push mode

In the first step you have to decide if you want to monitor the system via Pull or Push mode.

In Pull mode openITCOCKPIT will frequently connect via HTTP/s on port 3333 to the Agent and fetch all check results.

In Push mode the openITCOCKPIT Agent will frequently connect to the openITCOCKPIT Server and push all check results via HTTPS on port 443.

Both modes are easy to setup. For this tutorial we will continue using Pull mode.

The second step is basically an graphical configuration generator to modify the config file of the openITCOCKPIT Monitoring Agent. You only have to select the operating system you like to monitor and continue by pressing on Save configuration.

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

For this tutorial you can continue by using the default configuration. Please go to the next step by clicking on I have installed the Agent.

openITCOCKPIT will connect to the openITCOCKPIT Monitoring Agent to get a list of services that are running on the target system.

The system will pick 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 Create Services to finalize the openITCOCKPIT Agent setup.

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.