Skip to main content

Centreon Poller

Overview​

The Centreon Poller plugin pack will help you set up monitoring for your pollers. To be the most accurate, the pollers should be monitored by the Central server.

Pack Assets​

Templates​

The Centreon Plugin Pack Centreon Poller brings a host template:

  • App-Monitoring-Centreon-Poller-custom

It brings the following Service Templates:

Service AliasService TemplateService DescriptionDefault
Broker-StatsApp-Monitoring-Centreon-Broker-Stats-PollerCheck Centreon Broker processes statistics.X
proc-centengineApp-Monitoring-Centreon-Process-centengineCheck centengine process.X
proc-gorgonedApp-Monitoring-Centreon-Process-gorgonedCheck gorgoned process.X
proc-ntpdApp-Monitoring-Centreon-Process-ntpdCheck NTP process.X
proc-sshdApp-Monitoring-Centreon-Process-sshdCheck sshd process.X

Collected metrics & status​

Metric NameUnit
queued-eventsstring
speed-eventsstring
statusstring
unacknowledged-eventsstring

Prerequisites​

SNMP​

SNMP must be configured on each poller being monitored. You can refer to this documentation describing how to set up a quick SNMP configuration.

SSH key exchange​

One of the check coming along with the pack is performed through SSH, the Central server should be able to connect to each poller being monitored.

The Central server performs its checks while being centreon-engine user, and will log to the pollers as centreon user.

Follow below steps to exchange the SSH key:

  1. From the poller being monitored by the Central server, set a password for the centreon user:
passwd centreon
  1. From the Central server, create and copy the new centreon-user's SSH key on the poller:
su - centreon-engine
ssh-keygen -t ed25519 -a 100
ssh-copy-id -i ~/.ssh/id_ed25519.pub centreon@<IP_POLLER>

Setup​

  1. Install the Centreon Plugin package on the Central Server:
yum install centreon-plugin-Applications-Monitoring-Centreon-Poller centreon-plugin-Operatingsystems-Linux-Snmp
  1. On the Centreon Web interface, install the Centreon Poller Centreon Plugin Pack on the Configuration > Plugin Packs page.

Configuration​

Host​

  • Log into Centreon and add a new Host through Configuration > Hosts.
  • Fill the Name, Alias & IP Address/DNS fields according to your Centreon Poller server settings.
  • Select the App-Monitoring-Centreon-Poller-custom template to apply to the Host.
  • Once the template is applied, fill in the corresponding macros. Some macros are mandatory.
MandatoryNameDescription
MODULESTATSFILE(Default: '/var/lib/centreon-engine/*-module-stats.json')
EXTRAOPTIONSAny extra option you may want to add to every command_line (eg. a --verbose flag)

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

Once the plugin is installed, log into your Centreon Central Server CLI using the centreon-engine user account (su - centreon-engine) and test the Plugin by running the following command:

/usr/lib/centreon/plugins//centreon_centreon_central.pl \
--plugin=apps::centreon::local::plugin \
--hostname=10.0.0.1 \
--mode=broker-stats \
--broker-stats-file='/var/lib/centreon-engine/*-module-stats.json' \
--filter-name='' \
--warning-speed-events='' \
--critical-speed-events='' \
--warning-queued-events='' \
--critical-queued-events='' \
--warning-unacknowledged-events='' \
--critical-unacknowledged-events='' \
--warning-status='' \
--critical-status='%{type} eq "output" and %{queue_file_enabled} =~ /true/i' \
--verbose \
--remote \
--ssh-option='-l=centreon'

The expected command output is shown below:

OK:  Speed Events: %s/s Queued Events: %s Unacknowledged Events: %s | 

All available options for a given mode can be displayed by adding the --help parameter to the command:

/usr/lib/centreon/plugins//centreon_centreon_central.pl \
--plugin=apps::centreon::local::plugin \
--hostname=10.0.0.1 \
--help

All available options for a given mode can be displayed by adding the --list-mode parameter to the command:

/usr/lib/centreon/plugins//centreon_centreon_central.pl \
--plugin=apps::centreon::local::plugin \
--list-mode

Troubleshooting​

Please find all the troubleshooting documentation for the Centreon Plugins in the dedicated page.