Skip to main content
Version: 23.04

InfluxDB 2 Metrics

The InfluxDB 2 Metrics stream connector allows you to send data from Centreon to InfluxDB 2 instances.

Before starting

  • In most cases, you will want to send data from the central server. It is also possible to send it from a remote server or a poller (e.g. if you want to avoid the central server being a SPOF, or if you are an MSP and you install the stream connector on a poller or a remote server within your customer's infrastructure).
  • By default, the InfluxDB 2 Metrics stream connector sends metrics from host_status and service_status Broker events. These metrics are contained in the perf_data field of the events. The event format is shown here.
  • These events are sent each time a host or a service is checked. Various parameters let you filter out events.

Installation

Perform the installation on the server that will send data to InfluxDB 2 (central server, remote server, poller).

  1. Login as root using your favorite SSH client.

  2. Run the following command:

dnf install centreon-stream-connector-influxdb

Configuring your InfluxDB 2 equipment

You may need to configure your InfluxDB 2 equipment so that it can receive data from Centreon. Please refer to the documentation of InfluxDB 2. Make sure InfluxDB 2 is able to receive data sent by Centreon: flows must not be blocked by the configuration of InfluxDB 2 or by a security equipment.

Configuring the stream connector in Centreon

  1. On your central server, go to Configuration > Pollers > Broker configuration.
  2. Click on central-broker-master (or the appropriate broker configuration if it is a poller or a remote server that will send events).
  3. On the Output tab, select Generic - Stream connector from the list and then click Add. A new output appears in the list.
  4. Fill in the fields as follows:
FieldValue
NameInfluxDB 2 metrics
Path/usr/share/centreon-broker/lua/influxdb2-metrics-apiv2.lua
Filter categoryNeb
  1. To enable Centreon to connect to your InfluxDB 2 equipment, fill in the following mandatory parameters. The fields for the first entry are already present. Click on the +Add a new entry link located below the Filter category table to add another one.
TypeNameValue explanationValue exemple
stringbucket_idThe ID of the bucket where metrics will be sent65f5f748e28c92f0
stringbucket_api_keyThe API key used to send data to the bucketOGwOM8nse3FHjxyGw5ODLWWXS1oEpcPsjLcRl09zmCEbBE0TKgAiJiKOyKOBUZxoo76qe6-PTPq-70ECCwA==
stringorg_nameThe name of the InfluxDB organizationcentreon
stringhttp_server_urlThe InfluxDB address with the port at the endhttps://myinfluxdb2.local:8086
  1. Fill in any optional parameters you want (using the +Add a new entry link):
TypeNameValue explanationdefault value
stringlogfileThe file in which logs are written/var/log/centreon-broker/influxdb2-metrics.log
numberlog_levelLogging level from 1 (errors) to 3 (debug)1
  1. Use the stream connector's optional parameters to filter or adapt the data you want Centreon to send to InfluxDB 2.

  2. Deploy the configuration.

  3. Restart centengine on all pollers:

    systemctl restart centengine

    InfluxDB 2 should now receive data from Centreon. To test if it is working, see Curl commands: testing the stream connector.

Filtering or adapting the data you want to send to InfluxDB 2

All stream connectors have a set of optional parameters, that allow you to filter the data you will send to your InfluxDB 2 device, to reformat the data, to define a proxy...

Each optional parameter has a default value, that is indicated in the corresponding documentation.

  • To override the default value of a parameter, click on the +Add a new entry link located below the Filter category table to add a custom parameter. For example, if you want to only send to InfluxDB 2 the events handled by a poller named "poller-1", enter:

    type = string
    name = accepted_pollers
    value = poller-1
  • For the InfluxDB 2 Metrics stream connector, the following values always override the default values, you do not need to define them in the interface.

TypeNameDefault value for the stream connector
stringinfluxdb2_api_endpoint/api/v2/write
stringinfluxdb2_precisions
stringaccepted_categoriesneb
stringaccepted_elementshost_status,service_status
numberhard_only0
numberenable_host_status_dedup0
numberenable_service_status_dedup0
stringmetric_name_regex([, =])
stringmetric_replacement_character\\%1
numberuse_deprecated_metric_system0

For metrics name and replacements see here.

Event bulking

This stream connector is compatible with event bulking. Meaning that it is able to send more that one event in each call to the InfluxDB 2 REST API.

To use this feature you must add the following parameter in your stream connector configuration.

TypeNameValue
numbermax_buffer_sizemore than one

According to best practice, max_buffer_size is set at 5000 lines by default. But you should lower this value to a few hundred if you have less than 10 000 services.

Event format

This stream connector will send events with the following format.

service_status event

rta,type=service,service.name=my_service,host.name=central,poller=Central,metric.unit=ms value=0.008 1694370951
pl,type=service,service.name=my_service,host.name=central,poller=Central,metric.unit=% value=0.0 1694370951

host_status event

rta,type=host,host.name=central,poller=Central,metric.unit=ms value=0.008 1694370951
pl,type=host,host.name=central,poller=Central,metric.unit=% value=0.0 1694370951

Custom event format

This stream connector is not compatible with custom event format.

Curl commands: testing the stream connector

Sending events

If you want to test that events are sent to InfluxDB 2 correctly:

  1. Log in to the server that you configured to send events to InfluxDB 2 (your central server, a remote server or a poller).

  2. Run the following command:

     curl -X POST -H 'content-type: text/plain; charset=utf-8' -H 'accept: application/json' -H 'Authorization: Token <bucket_api_key>' 'http://<http_server_url>/api/v2/write?bucket=<bucket_id>&org=<org_name>&precision=s' -d

    Replace all the <xxxx> inside the above command with the correct value. For instance, <bucket_id> may become something like 65f5f748e28c92f0.

  3. Check that the event has been received by InfluxDB 2.