Skip to main content

RRDtool

Monitoring Connector Assets

Monitored Objects

The Monitoring Connector includes monitoring of Query.

Collected Metrics

Metric nameDescriptionUnit
dsname#datasource.value.minimum.countMinimun value on timeframe
dsname#datasource.value.average.countAverage value on timeframe
dsname#datasource.value.maximum.countMaximul value on timeframe

Prerequisites

The plugin support query with:

  • rrdtool cli (executed locally or through ssh)
  • perl binding (executed locally only)

rrdcached is not supported (yet).

Setup

  1. Install the Centreon Plugin on every Poller:
yum install centreon-plugin-Applications-Databases-Rrdtool
  1. On the Centreon Web interface in Configuration > Monitoring Connector Manager, install the RRDtool Monitoring Connector

Service configuration

  • Create a service and apply the App-DB-Rrdtool-Local-Query service template.

Once the template applied, some Macros have to be configured:

MandatoryNameDescription
XRRDFILErrd file to query
XDSNAMEDatasource to query (Default: 'value')
XTIMEFRAMESet timeframe in seconds (E.g '3600' to check last 60 minutes) (Default: 600)

FAQ

How to check in the CLI that the configuration is OK and what are the main options for ?

Once the Plugin installed, log into your poller using the centreon-engine user account and test by running the following command:

/usr/lib/centreon/plugins/centreon_rrdtool.pl \
--plugin=database::rrdtool::local::plugin \
--custommode=perlmod \
--mode=query \
--rrd-file='/var/lib/centreon/metrics/1490.rrd' \
--ds-name='value' \
--timeframe='3600' \
--warning-value-maximum=50 \
--critical-value-maximum=100

Output example:

OK: datasource 'value': 3.12 (min), 4.52 (avg), 5.13 (max) | 'value#datasource.value.minimum.count'=3.12;;;; 'value#datasource.value.average.count'=4.52;;;; 'value#datasource.value.maximum.count'=5.13;0:50;0:100;;

The command above monitors rrdtool (--mode=query) database /var/lib/centreon/metrics/1490.rrd (found Centreon metrics file in interface: Administration > Parameters > Data).

It check the datasource value (--ds-name='value'. Centreon always use value. Otherwise use command to find datasource name: rrdtool info /var/lib/centreon/metrics/1490.rrd) during the last hour (--timeframe='3600').

This command would trigger a WARNING alert if maximum value is over 50 (--warning-value-maximum=50) and a CRITICAL alarm over 100 (--critical-value-maximum=100).

All the options that can be used with this plugin can be found over the --help command:

/usr/lib/centreon/plugins/centreon_rrdtool.pl \
--plugin=database::rrdtool::local::plugin \
--custommode=perlmod \
--help