Skip to main content

Rudder

Prerequisites

Centreon Plugin

Install this plugin on each needed poller:

yum install centreon-plugin-Applications-Rudder-Restapi

API token

A token needs to be created to acces the API.

To do so, follow the official documentation here : https://docs.rudder.io/api/#api-_-Authentication.

Centreon Configuration

Create hosts using the appropriate template

The Rudder instance can be monitored as a host to get global statuses and statistics.

A dedicated host template can also be added to any Centreon host to monitor its Rudder compliance.

Rudder instance

Go to Configuration > Hosts and click Add. Then, fill the form as shown by the following table:

FieldValue
NameName of the Rudder instance
AliasDescription
IP Address / DNSIP address of the Rudder instance (or localhost)
Monitored fromPoller used to monitor
TemplatesApp-Rudder-Restapi-custom

The following host macros should be set as shown:

MacroValue
RUDDERAPIHOSTNAMERudder instance hostname or IP address
RUDDERAPIURLPATHURL path of the Rudder instance API
RUDDERAPIPORTPort of the Rudder instance API
RUDDERAPIPROTOProtocol used by the Rudder API
RUDDERAPITOKENToken used to access the Rudder API

Check the Create Services linked to the Template too box and click on the Save button.

The following services will be created:

  • Global-Compliance
  • Nodes-Overall-Compliance
  • Statistics

The following rules are linked to this host template:

  • App-Rudder-Restapi-Nodes
  • App-Rudder-Restapi-Rules

Host

Go to Configuration > Hosts and click Add. Then, fill the form as shown by the following table:

FieldValue
NameHostname
AliasDescription
IP Address / DNSIP address of the host
Monitored fromPoller used to monitor
TemplatesApp-Rudder-Node-Compliance-Restapi-custom

The following host macros should be set as shown:

MacroValue
RUDDERAPIHOSTNAMERudder instance hostname or IP address
RUDDERAPIURLPATHURL path of the Rudder instance API
RUDDERAPIPORTPort of the Rudder instance API
RUDDERAPIPROTOProtocol used by the Rudder API
RUDDERAPITOKENToken used to access the Rudder API
RUDDERNODENAMEHostname (or name as registered in Rudder)

Check the Create Services linked to the Template too box and click on the Save button.

The following service will be created:

  • Node-Compliance