Vous êtes sur la page 1sur 228

Centreon Documentation

Version 2.6.4

Centreon

17 December 2015
Table des matires

i
ii
Centreon est un logiciel open source qui vous permet de superviser lensemble des lments appartenant votre
systme dinformations.
Sommaire :

Table des matires 1


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
2 Table des matires
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
CHAPITRE 1

A propos

Centreon est un logiciel libre de supervision Open Source, dit par la socit franaise Centreon. Il mesure la dispo-
nibilit et la performance des couches applicatives, du service utilisateur jusquaux ressources matrielles.
Centreon est un puissant outillage destin aux administrateurs et exploitants du service de supervision. Il intgre depuis
2012 son propre moteur de collecte (Centreon Engine) et gestionnaire dvnements (Centreon Broker).
Au-del des concepts de configuration qui sont les plus volus dans lcosystme Nagios, Centreon apporte de nom-
breuses fonctionnalits telles que la consultation de ltat des services et des machines superviss, la mtrologie, le
reporting, laccs aux vnements de supervision, la gestion avance des utilisateurs via des listes de contrle daccs
(ACL), etc.
Des modules complmentaires issus de la communaut et de lditeur permettent galement dtendre les fonctions.
On trouve par exemple un outil de BI, de la cartographie et de nombreuses API permettant dinteragir avec Centreon,
comme lautomatisation de la gestion de configuration.
Solution mature, fiable et innovante, Centreon se dmarque notamment par sa capacit offrir un socle de fonctions
adaptes la vision mtier exige par les responsables, en structurant des donnes IT essentielles et stratgiques
(disponibilit, capacit, maintenabilit, fiabilit).
La distribution sans limite et la performance du systme de collecte de donnes sont galement des points forts de la
suite logicielle. Centreon rpond aux contraintes de monte en charge, de cloisonnement rseau, de sites gographi-
quement clats et de bande passantes limites.

3
4 Chapitre 1. A propos
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
CHAPITRE 2

Notes de version

Ce chapitre est une reprise sans traduction de la documentation anglaise.

2.1 Centreon 2.4

2.1.1 Whats new

Better integration with Centreon Engine and Centreon Broker

The installation process has been reviewed : it is now possible to specify the monitoring engine (Centreon Engine or
Nagios) and the event broker module (Centreon Broker or NDOUtils). All you need to do right after a fresh installation
is export your configuration files, then reload your monitoring engine and the monitoring system should be up and
running !
This version offers the possibility to define the connectors for Centreon Engine. Obviously, you do not need to confi-
gure these connectors if you are still using Nagios.
Its been said that Centreon Broker can be cumbersome to configure, especially if you are not familiar with its func-
tioning. Centreon 2.4 offers a configuration wizard now !

Custom views

This new page enables users to make their own views with various widgets and they are able to share their custom
views with their colleagues !
See the user guide to learn more about this feature.

Support for multiple LDAP servers

The LDAP authentication system is much more robust than before. Indeed, it is now possible to have multiple LDAP
configurations on top of the failover system. The LDAP import form will let you choose the LDAP server to import
from.
Make sure that all your LDAP parameters are correctly imported after an upgrade.

5
New autologin mechanism

A better autologin mechanism has been introduced in this version. Now using randomly generated keys, it allows you
to access specific pages without beeing prompted for a username and a password.

Database indexes verification tool

If you upgrade from an old version of Centreon, now you can check the existence of all database indexes to ensure
maximum performance

2.1.2 Important notes

Administration

Communication with pollers

The default system user used by Centcore to communicate with pollers has changed from nagios to centreon.
See ces :pollers_basic_conf for more information.

Plugins

For better performances, we advise you to use check_icmp instead of check_ping if you are in an IPv4 net-
work, that is (check_icmp is not yet compatible with IPv6). Switching from check_ping to check_icmp should
be quite simple as the plugins take the same parameters. All you have to do is change the check commands :
check_centreon_ping, check_host_alive and all the commands that call check_ping.

Web interface

Autologin

A new autologin mechanism has been added in Centreon 2.4. More secured than the previous one, it will soon replace
it. If you currently use this feature, we recommend upgrading to the new one as soon as you can.

Centreon Broker init script

If you are using Centreon Broker, make sure to fill the Start script for broker daemon parameter in Administration
> Options > Monitoring. RRD graphs cannot be rebuilt if this parameter is omitted !

Centcore options

Two parameters have been added into the Administration > Options > Monitoring page :
Enable Perfdata Synchronisation (Centcore)
Enable Logs Synchronisation (Centcore)
For performance issues, these options must be disabled if your monitoring system is running with Centreon Broker.

6 Chapitre 2. Notes de version


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Resource.cfg and CGI.cfg

The resource and CGI configuration objects are now specific to each monitoring poller. The values of $USERx$
macros can be different from one poller to another.

Interval length

The interval_length is now a global parameter that you have to set in Administration > Options >
Monitoring, although it should be left at 60 seconds in most cases.

Centstorage

Supported data source types

Centreon Broker now supports all of the RRDtool data source types (COUNTER, GAUGE, DERIVE and ABSO-
LUTE). This support will not be added to Centstorage as it will soon be replaced by Centreon Broker.
See the Centreon Broker documentation to learn how you can convert your existing plugins.

2.2 Centreon 2.4.1

2.2.1 Important notes

Connectors

If you are already using the Centreon Connectors, please note that the connector path is no longer called with user
variable $USER3$. It is instead in the Configuration > Centreon > Pollers > Centreon Connector
path. In that regard, be sure to fill this field and update the connector command line in Configuration >
Commands > Connectors by removing the $USER3$ prefix.
i.e : : $USER3$/centreon_connector_perl
should become : : centreon_connector_perl
Once youre done with updating those configurations, you may delete the former $USER3$ as it will be no longer
used.

2.3 Centreon 2.4.4

2.3.1 Important notes

Graphs

It is now possible to set RRD graphs to DERIVE and ABSOLUTE type. In order to do so go to Administration
> Options > CentStorage > Manage, then click on the metric you would like to update. In the More actions toolbar,
you will now see the new data source types.

2.2. Centreon 2.4.1 7


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Monitoring consoles

A new option is available, allowing you to choose the display order of the monitored resources. The new option is
available in Administration > Options , in the Problem display properties section.

2.4 Centreon 2.4.5

2.4.1 Important notes

Connector

You can now linked a command to a connector from the connector form in Configuration > Commands > Connectors.

Centreon Broker

Centreon 2.4.x branch is now compatible with Centreon Broker 2.5.x branch. Also several options have been added in
Centreon Broker configuration form accessible in Configuration > Centreon > Configuration (Below Centreon-Broker
label in the left panel). Here the new options :
Write timestamp in General tab : To enable or disbale timestamp logging in each log line (disable this option
is useful with when Centreon-Broker is used with Nagios)
Write thread id in General tab : To enable or disable thread id logging in each log line
Write metrics in Output tab with RRD - RRD file generator : To enable or disable the update of the perfor-
mance graph
Write status in Output tab with RRD - RRD file generator : To enable or disable the update of the status
graph
Store performance data in data_bin in Output tab with Storage - Perfdata Generator (Centreon Storage) : To
enable or disable insertion of performance data in data_bin table
Insert in index data in Output tab with Storage - Perfdata Generator (Centreon Storage) : Allow Centreon-
Broker to create entries in index_data table (use with caution)

2.5 Centreon 2.5

2.5.1 WARNING

If you are upgrading from Centreon 2.4.x make sure to read the following. As usual, database backups are to be
made before going any further. Then, follow these procedures in order to ensure the integrity of the RRD graphs. Not
following this may cause your graphs to malfunction !

If you are using Centreon Broker

Check right of conf.pm file. Apache must have the right to modify conf.pm file
Stop all the centreon-engine services
Stop the centreon-broker daemon
Upgrade Centreon-Broker on all the pollers
Restart all the engines
Upgrade Centreon (web install)
Execute /path/to/centreon/bin/changeRrdDsName.pl
Check that your graphs are showing properly on the web interface
Start the centreon-broker daemon

8 Chapitre 2. Notes de version


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
If you are using NDO

Stop centstorage
Upgrade Centreon (web install)
Execute /path/to/centreon/bin/changeRrdDsName.pl
Start centstorage

2.5.2 Whats new

ACL on configuration objects

ACL rules are now applied to configuration objects. For more information regarding this feature, be sure to checkout
our blog post : http://blog.centreon.com/configuration-acl-with-centreon-2-5-2/

UI and sound notifications

It is now possible to get UI and sound notifications on Centreon, you can set your preferences in your profile page. A
quick overview there : http://blog.centreon.com/centreon-ui-notification-system/
Only available if you are using Centreon Broker as of now.

New system with SNMP traps

Centreon has evolved with a eaysiest way to handle SNMP traps. Some advantages of the new system :
No more snmptt
More advanced configuration in SQL Database
Local database (sqlite) on Pollers
You have to look on the centreon documentation in order to configure Centreon using this new system. Go in section :
User guide > Advanced > SNMP TRAPS

2.5.3 Important notes

Centcore is now mandatory

External commands are now sent to centcore regardless of whether the poller is local or not. So be sure to have it
running all the time from now on.

2.6 Centreon 2.5.1

2.6.1 WARNING

If you are upgrading from Centreon 2.5.0 make sure to read the following.
If you are upgrading from a version prior to 2.5.0, just skip this notice and follow this procedure instead :
https://blog.centreon.com/centreon-2-5-0-release/.
As usual, database backups are to be made before going any further.
It does not matter whether you run the commands below before or after the web upgrade ; do note that those scripts
may take some execution time depending on the size of your log tables.

2.6. Centreon 2.5.1 9


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
2.6.2 You are using NDOUtils

If you are using NDOUtils, chances are that you have plenty of duplicate entries in your log table. Follow the procedure
in order to re insert the logs :
Copy all the log files from the remote pollers to the local poller in /var/lib/centreon/log/POLLERID/. To know the
POLLERID of each of your pollers, execute the following request against the MySQL server (centreon database) :
mysql> SELECT id, name FROM nagios_server;

Then, execute the following script :


/path/to/centreon/cron/logAnalyser -a

2.6.3 You are upgrading from Centreon 2.5.0

There was a bug in Centreon 2.5.0 that probably messed up your reporting data, you will have to recover by running
these commands :
/path/to/centreon/cron/eventReportBuilder -r

/path/to/centreon/cron/dashboardBuilder -r -s <start_date> -e <end_date>

start_date and end_date must be formatted like this yyyy-mm-dd ; they refer to the time period you wish to
rebuild your dashboard on.

2.7 Centreon 2.5.2

2.7.1 Notice

If you are upgrading from a version prior to 2.5.1, make sure to go through all the release notes available here.

2.7.2 CHANGELOG

#5593 : Fixes a bug where trap advanced matching rules were not working
#5600 : Fixes a bug where it was impossible to add or modify a poller
#5533 : Fixes a bug where it was impossible to update the severity level of a service
#5307 : Tooltips messages were not translated in the Broker configuration form
#5664 : Enhances loading time of the service detail page
#5439 : Enhances loading time of the meta service page

2.8 Centreon 2.5.3

2.8.1 Warning

This version include a couple of security fixes. Please proceed to the update of your platform if your centreon is not in
version 2.5.3 at least. If youre using Debian or Suse before doing the update, you need to install php5-sqlite package.
The update can take some times due to the update to UTF-8 format (#5609)

10 Chapitre 2. Notes de version


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
2.8.2 Notice

If you are upgrading from a version prior to 2.5.2, make sure to go through all the release notes available here.

2.8.3 CHANGELOG

#5895 : Security Issues : CVE-2014-3828 & CVE-2014-3829


#5888 : Differences between update and fresh install for Insert in index data field
#5829 : Add config file in parameters for all crons of Centreon in order to install centreon on different directo-
ries
#5852 : Fix problem with massive change for Inherit contacts from host in service form
#5841 : Empty dependences are now remove automaticaly
#5840 : Fix problem with host duplication when this host has a in the alias
#5790 & #5813 & #5750 : Fix problems on Tactical Overview
#5786 : Fix problem when generating correlation config file.
#5756 : Fix problem with centstorage => Table log is growing to much
#5609 : Push Centreon Broker table to UTF-8
#5589 : Fix problem with Contact inheritance between service and its template who doesnt work
#4865 : Fix problem with search in Eventlog

2.9 Centreon 2.5.4

2.9.1 Notice

If you are upgrading from a version prior to 2.5.3, make sure to go through all the release notes available here.

2.9.2 CHANGELOG

Bug fixes

#5458 : Display problem with host groups


#5924 : Generation of service configuration files does not work when service_inherit_contacts_from_host is
not enabled
#5926 : Centreon-Broker-2.7.x compatibility
#5929 : Fix problem in import service groups by cfg file
#5942 : Fix compatibility with IE
#5946 : Problem in reporting due to acknowledgement
#5986 : Sessions Id does not change after logout

Features

#5433 : Argument column larger in service configuration


#5944 : Services inherit criticality from hosts

2.9. Centreon 2.5.4 11


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
2.10 Centreon 2.6.0

2.10.1 Notice

If you are upgrading from a version prior to 2.5.4, make sure to go through all the release notes available here.

2.10.2 Whats new ?

Compatibility with PHP 5.4.x

Centreon is now compatible with PHP in version 5.4.x. So, you do not need to downgrade to PHP 5.3.x version when
you install it on Debian 6, Ubuntu 13.04, Redhat 7 and CentOS 7.
Centreon proprietary module (Centreon BAM, Centreon BI, Centreon MAP, Centreon KB) is not compatible as yet
with this PHP version.

New options for Centreontrapd

Its now possible with Centreontrapd to :


Filter services on same host ;
Transform output (to remove pipe for example) ;
Skip trap for hosts in downtime ;
Add custom code execution ;
Put unknown trap in another file.

ACL and configuration modification with admin users

ACL management has been improved to allow for a greater number of simultaneous sysadmin users to work on the
same monitoring platform.
The synchronisation is more efficient in configuration page between admin and normal users.

Partial rebuild of events information

Its now possible to partially rebuild events information with eventsRebuild script. You can now use option -s when
rebuilding and the rebuild will start from this date.
Before, you had to rebuild from the beginning of the related data.

Criticality inheritance

Centreon 2.6 introduces a capability for the dependent services of a host to automatically inherit its configured critica-
lity. Its also possible to define the levels of global criticality of a particular host and dependent services cluster thanks
to the use of templates.

Integration of Centreon new logo

The new Centreon logo has been integrated into this new version.

12 Chapitre 2. Notes de version


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
2.10.3 CHANGELOG

Bug fixes

#5655 : Changing Host Templates doesnt delete services


#5782 : Warning daemon_dumps_core variable ignored
#5795 : ACL and configuration modification with admin users
#5868 : Generation of services groups isnt correct for poller
#6052 : Month_cycle option in recurring downtime is not properly set
#6119 : Filter doesnt work on many pages in Administration -> Log
#6163 : A template should not be able to inherit from itself
#6336 : Problem with schedule downtime when using different timezones

Features

#3239 : PHP-5.4 Compatibility


#5238 : Criticality inheritance
#5334, #6114, #6120 : Optimisation and customization on Centreontrapd
#5952 : Add possibility to rebuild partially Events information
#6160 : New Centreon logo

2.11 Centreon 2.6.1

2.11.1 Notice

If you are upgrading from a version prior to 2.6.0, make sure to go through all the release notes available here.

2.11.2 CHANGELOG

Bug fixes

#5655 : Changing Host Templates doesnt delete services


#5925 : Popup Dialogs (Acknowledge, Downtimes etc.) not working with Internet Explorer
#6224 : Special characters in LDAP are replaced by underscore
#6358 : Its possible to bypass ACLs on Event Logs page
#6375 : servicegroups empty into servicegroups.cfg but ok in DB
#6377 : PHP logs are too much verbose with PHP 5.4
#6378 : PHP logs are too much verbose with PHP 5.3
#6383 : Random severity on services
#6390 : Escalations with contact groups containing space
#6391 : Some traps are skipped
#6396 : Warning and critical threshold display in centreon graph
#6399 : Wrong condition in centreonLDAP.class.php
#6410 : Do not limit to 20 the number of trap rules or macro in host and services config pages

Features

#6035 : Removing Centreon Broker local module


#6366 : New option for Centreon Engine log

2.11. Centreon 2.6.1 13


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
#6392 : Block choice of Nagios and NDO in installation processus

2.12 Centreon 2.6.2

2.12.1 Notice

If you are upgrading from a version prior to 2.6.0, make sure to go through all the release notes available here.

2.12.2 CHANGELOG

Features

Modules can extend actions after restart/reload pollers

Security fixes

#2979 : Secure the type of media which file can be uploaded (ZSL-2015-5264)
Fix some SQL injections (ZSL-2015-5265)

Bug fixes

#3559 : Fix query with MariaDB / MySQL configure in STRICT_TRANS_TABLES


#3554 : Can send acknowledgement with multiline from monitoring page
#3397 : Fix display graph with unicode characters in metric name
#2362 : Correct value when use index_data inserted by Centreon Broker in configuration
#1195 : Display correct number of pollers in status bar
#196 : Display all columns when filter is applied on Monitoring services unhandled view

2.13 Centreon 2.6.3

2.13.1 Notice

If you are upgrading from a version prior to 2.6.0, make sure to go through all the release notes available here.

2.13.2 CHANGELOG

Bug fixes

#564 : Filter field does not work in service groups monitoring screen
#1000 : Services of service groups are dispatched on many pages
#3782 : SQL Keyswords
#3783 : index_data switch in option form
#3788 : Problem with static keywords

14 Chapitre 2. Notes de version


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
2.14 Centreon 2.6.4

2.14.1 Notice

If you are upgrading from a version prior to 2.6.0, make sure to go through all the release notes available here.

2.14.2 CHANGELOG

Bug fixes

#3793 : Porblem when creating an empty hostgroup with non admin user
#3795 : Update Centreon Administration About page (forge -> Github)
#3796 : Problem when connect two time with same user in API
#3797 : Password in macro
#3800 : Current State Duration isnt displayed
#3803 : ACL : Manage multiple Resources group on the same ACL user group
#3807 : Unable to enable status option on main.cfg

2.15 Centreon 2.6.5

2.15.1 Notice

If you are upgrading from a version prior to 2.6.0, make sure to go through all the release notes available here.

2.15.2 CHANGELOG

Security fixes

#3831 : XSS injection in object lists (ZSL-2015-5266)


#3835 : CRSF Issues on Centreon (ZSL-2015-5263)

Bug fixes

#3821 : Upgrade from 2.6.1 to 2.6.3 kill Centreon Frontend


#3826 : Split Component and zoom doesnt work
#3827 : Service Group Details page isnt displayed for non admin in Centreon 2.6.3
#3837 : Relation of passive service with SNMP traps problem with multihost link
#3842 : Full logs display on event logs page for a non admin user

2.16 Centreon 2.6.6

Released October 29, 2015

2.16.1 Notice

If you are upgrading from a version prior to 2.6.0, make sure to go through all the release notes available here.

2.14. Centreon 2.6.4 15


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
2.16.2 CHANGELOG

Bug fixes

#3812 : [2.6.3] Strange display of service group details page


#3824 : PHP Warning : array_map() : Argument #2 should be an array
#3840 : [2.6.4] Wrong reporting graph data with default user language fr_FR.UTF-8
#3846 : [2.6.5] CRSF Token critical : Impossible to upgrade a plugin
#3847 : [2.6.5] split component switch
#3852 : [2.6.5] CSRF error appears in user massive change form
#3854 : Cannot add new macro after deleting all macros already created
#3855 : Cannot add new host template to host after deleting all templates
#3861 : Comments shows only A
#3864 : [2.6.5] CSRF when trying to upload a SNMP MiB

16 Chapitre 2. Notes de version


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
CHAPITRE 3

Architectures proposes

3.1 Architecture simple

3.1.1 Fonctionnement

Larchitecture simple consiste avoir toutes les entits de supervision au sein du mme serveur, savoir :
Linterface web de Centreon
La base de donnes (MySQL + RRD)
Le moteur de supervision
Le broker
Cette architecture est la plus simple quun utilisateur peut rencontrer.

3.1.2 Entits

Plusieurs entits servent mettre en place cette architecture :


Le serveur Apache est charg dhberger linterface web de Centreon
Plusieurs bases de donnes MySQL sont charges de stocker la configuration de Centreon, les informations de
supervision ainsi que les donnes de performances
Le moteur de supervision supervise le systme dinformations
Les informations de supervision sont envoyes via cbmod Centreon Broker SQL
Centreon Broker SQL est charg dinsrer les donnes de supervision en base de donnes et de transmettre les
donnes de performances Centreon Broker RRD
Centreon Broker RRD est charg de gnrer les fichiers RRD (qui servent gnrer les graphiques de perfor-
mances)

3.1.3 Architecture

Le schma ci-dessous rsume le fonctionnement de larchitecture :

17
3.2 Architecture distribue

3.2.1 Fonctionnement

Larchitecture distribue consiste avoir deux types dentits :


Le serveur central qui centralise les informations de supervision
Un ou plusieurs serveurs satellites qui sont chargs de la supervision des quipements
Le serveur central regroupe les lments suivants :
Linterface web de Centreon
La base de donnes (MySQL + RRD)
Le moteur de supervision
Le broker
Le serveur satellite a les lments suivants :
Le moteur de supervision
Le module de broker qui permet lenvoi des informations de supervision vers le serveur central
Cette architecture a plusieurs intrts :
Elle permet la rpartition de la charge de supervision entre plusieurs serveurs de supervision

18 Chapitre 3. Architectures proposes


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Isolation des flux rseaux : si votre infrastructure de supervision est charge de superviser une DMZ, il est plus
simple (et scurisant) de placer un serveur satellite sur le rseau DMZ

3.2.2 Entits

Serveur central

Le serveur central fonctionne de la manire suivante :


Le serveur Apache est charg dhberger linterface web de Centreon
Plusieurs bases de donnes MySQL sont charges de stocker la configuration de Centreon, les informations de
supervision ainsi que les donnes de performances
Le service CentCore est charg dexporter la configuration des moteurs de supervision vers le serveur central
et satellites ainsi que du redmarrage des moteurs de supervision
Le moteur de supervision supervise le systme dinformations
Les informations de supervision sont envoyes via cbmod Centreon Broker SQL
Centreon Broker SQL est charg dinsrer les donnes de supervision en base de donnes et de transmettre les
donnes de performances Centreon Broker RRD
Centreon Broker RRD est charg de gnrer les fichiers RRD (qui servent gnrer les graphiques de perfor-
mances)

Serveur satellite

Le serveur satellite fonctionne de la manire suivante :


Le moteur de supervision supervise le systme dinformations
Les informations de supervision sont envoyes via cbmod au service Centreon Broker SQL hberg sur le
serveur Central
Centreon Broker SQL est charg dinsrer les donnes de supervision en base de donnes et de transmettre les
donnes de performances Centreon Broker RRD
Centreon Broker RRD est charg de gnrer les fichiers RRD (qui servent gnrer les graphiques de perfor-
mances)

3.2.3 Architecture

Le schma ci-dessous rsume le fonctionnement de larchitecture :

3.2. Architecture distribue 19


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
3.3 Architecture distribue et base de donnes dporte

3.3.1 Fonctionnement

Larchitecture distribue avec base de donnes dporte consiste avoir trois types dentits :
Le serveur central qui centralise les informations de supervision
Un serveur de base de donnes charge de stocker toutes les bases de donnes
Un ou plusieurs serveurs satellites qui sont chargs de la supervision des quipements
Le serveur central regroupe les lments suivants :
Linterface web de Centreon
Le moteur de supervision
Le broker
Les fichiers RRD
Le serveur de base de donnes est charg de stocker la base de donnes MySQL.
Le serveur satellite a les lments suivants :
Le moteur de supervision

20 Chapitre 3. Architectures proposes


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Le module de broker qui permet lenvoi des informations de supervision vers le serveur central
Cette architecture a plusieurs intrts :
Elle permet la rpartition de la charge de supervision entre plusieurs serveurs de supervision
Isolation des flux rseaux : si votre infrastructure de supervision est charge de superviser une DMZ, il est plus
simple (et scurisant) de placer un serveur satellite sur le rseau DMZ
Avoir une base de donnes MySQL externalise

3.3.2 Entits

Serveur de base de donnes

Le serveur de base de donnes sert uniquement stocker la configuration de Centreon, les informations de supervision
ainsi que les donnes de performances au sein de la base de donnes MySQL.

Serveur central

Le serveur central fonctionne de la manire suivante :


Le serveur Apache est charg dhberger linterface web de Centreon
Le serveur central rcupre la configuration ainsi que les informations de supervision en se connectant au
serveur de base de donnes
Le service CentCore est charg dexporter la configuration des moteurs de supervision vers le serveur central
et satellites ainsi que du redmarrage des moteurs de supervision
Le moteur de supervision supervise le systme dinformations
Les informations de supervision sont envoyes via cbmod Centreon Broker SQL
Centreon Broker SQL est charg dinsrer les donnes de supervision en base de donnes et de transmettre les
donnes de performances Centreon Broker RRD
Centreon Broker RRD est charg de gnrer les fichiers RRD (qui servent gnrer les graphiques de perfor-
mances)

Serveur satellite

Le serveur satellite fonctionne de la manire suivante :


Le moteur de supervision supervise le systme dinformations
Les informations de supervision sont envoyes via cbmod au service Centreon Broker SQL hberg sur le
serveur Central
Centreon Broker SQL est charg dinsrer les donnes de supervision en base de donnes et de transmettre les
donnes de performances Centreon Broker RRD
Centreon Broker RRD est charg de gnrer les fichiers RRD (qui servent gnrer les graphiques de perfor-
mances)

3.3.3 Architecture

Le schma ci-dessous rsume le fonctionnement de larchitecture :

3.3. Architecture distribue et base de donnes dporte 21


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
3.4 Architecture distribue redondante

3.4.1 Fonctionnement

Larchitecture distribue redondante consiste avoir deux types dentits :


Le serveur central qui centralise les informations de supervision
Un ou plusieurs serveurs satellites qui sont chargs de la supervision des quipements
Afin dassurer une redondance, le serveur central est rpliqu lidentique.
Les serveurs centraux regroupent les lments suivants :
Linterface web de Centreon
Le moteur de supervision
Le broker
Les bases de donnes (MySQL + RRD)
Le serveur satellite contient les lments suivants :
Le moteur de supervision
Le module de broker qui permet lenvoi des informations de supervision vers le serveur central
Cette architecture a plusieurs intrts :
Elle permet la rpartition de la charge de supervision entre plusieurs serveurs de supervision
Isolation des flux rseaux : si votre infrastructure de supervision est charge de superviser une DMZ, il est plus
simple (et scurisant) de placer un serveur satellite sur le rseau DMZ
Avoir une redondance au niveau des serveurs Centraux, si un serveur central tombe alors le second serveur
central existe toujours et permet dassurer une continuit de service

22 Chapitre 3. Architectures proposes


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
3.4.2 Entits

Serveur centraux

Il existe deux types de serveur central :


Un master qui fonctionne normalement
Un slave qui est configur de la mme manire que le serveur master mais qui na dmarr que les services
Centreon Broker RRD et MySQL
Le serveur central master fonctionne normalement :
Le serveur Apache est charg dhberger linterface web de Centreon
Plusieurs bases de donnes MySQL sont charges de stocker la configuration de Centreon, les informations de
supervision ainsi que les donnes de performances
Le service CentCore est charg dexporter la configuration des moteurs de supervision vers le serveur central
et satellites ainsi que du redmarrage des moteurs de supervision
Le moteur de supervision supervise le systme dinformations
Les informations de supervision sont envoyes via cbmod Centreon Broker SQL
Centreon Broker SQL est charg dinsrer les donnes de supervision en base de donnes et de transmettre les
donnes de performances aux 2 services Centreon Broker RRD (le premier se situe sur le master et lautre sur
le slave)
Centreon Broker RRD est charg de gnrer les fichiers RRD (qui servent gnrer les graphiques de perfor-
mances)
Une rplication MySQL bidirectionnelle permet de conserver la configuration de Centreon, les informations de super-
vision ainsi que les donnes de performances entre les deux serveurs centraux.
Le serveur slave lui est uniquement charg de gnrer les fichiers RRD.
En cas de panne du master, on dmarre les services : Apache, CentCore, Centreon Engine ainsi que Centreon Broker
SQL sur le serveur slave. Le serveur slave remplace le serveur master.
La bascule master/slave ainsi que le dmarrage et larrt des services sont grs par le couple Corosync + Pacemaker.

Serveur satellite

Le serveur satellite fonctionne de la manire suivante :


Le moteur de supervision supervise le systme dinformations
Les informations de supervision sont envoyes via cbmod ladresse IP virtuel qui factorise les deux serveurs
centraux. En fonction du serveur actif, ces informations sont envoyes un des deux services Centreon Broker
SQL.
Centreon Broker SQL est charg dinsrer les donnes de supervision en base de donnes et de transmettre les
donnes de performances aux 2 services Centreon Broker RRD (le premier se situe sur le master et lautre sur
le slave)
Centreon Broker RRD est charg de gnrer les fichiers RRD (qui servent gnrer les graphiques de perfor-
mances)

3.4.3 Architecture

Le schma ci-dessous rsume le fonctionnement de larchitecture :

3.4. Architecture distribue redondante 23


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
3.5 Architecture redondante + interface graphique

3.5.1 Fonctionnement

Larchitecture distribue redondante consiste avoir deux types dentits :


Le serveur central qui centralise les informations de supervision
Un ou plusieurs serveurs satellites qui sont chargs de la supervision des quipements
Afin dassurer une redondance, le serveur central est rpliqu lidentique. Ce type darchitecture permet galement
davoir une interface web Centreon minimaliste prsente sur chaque serveur satellite. Il est alors possible de se connec-
ter via cette interface web sur chaque serveur satellite afin de visualiser les lments superviss par celui-ci.
Les serveurs centraux regroupent les lments suivants :
Linterface web de Centreon
Le moteur de supervision
Le broker
Les bases de donnes (MySQL + RRD)
Le serveur satellite contient les lments suivants :
Le moteur de supervision

24 Chapitre 3. Architectures proposes


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Une interface web de Centreon minimaliste
Les bases de donnes (MySQL + RRD)
Le module de broker qui permet lenvoi des informations de supervision vers le serveur central et vers le
serveur satellite mme
Cette architecture a plusieurs intrts :
Elle permet la rpartition de la charge de supervision entre plusieurs serveurs de supervision
Isolation des flux rseaux : si votre infrastructure de supervision est charge de superviser une DMZ, il est plus
simple (et scurisant) de placer un serveur satellite sur le rseau DMZ
Avoir une redondance au niveau des serveurs Centraux, si un serveur central tombe alors le second serveur
central existe toujours et permet dassurer une continuit de service
Disposer dune interface web afin de pouvoir consulter les lments superviss par chaque serveur satellite

3.5.2 Entits

Serveur centraux

Il existe deux types de serveur central :


Un master qui fonctionne normalement
Un slave qui est configur de la mme manire que le serveur master mais qui na dmarr que les services
Centreon Broker RRD et MySQL
Le serveur central master fonctionne normalement :
Le serveur Apache est charg dhberger linterface web de Centreon
Plusieurs bases de donnes MySQL sont charges de stocker la configuration de Centreon, les informations de
supervision ainsi que les donnes de performances
Le service CentCore est charg dexporter la configuration des moteurs de supervision vers le serveur central
et satellites ainsi que du redmarrage des moteurs de supervision
Le moteur de supervision supervise le systme dinformations
Les informations de supervision sont envoyes via cbmod Centreon Broker SQL
Centreon Broker SQL est charg dinsrer les donnes de supervision en base de donnes et de transmettre les
donnes de performances aux 2 services Centreon Broker RRD (le premier se situe sur le master et lautre sur
le slave)
Centreon Broker RRD est charg de gnrer les fichiers RRD (qui servent gnrer les graphiques de perfor-
mances)
Une rplication MySQL bidirectionnelle permet de conserver la configuration de Centreon, les informations de super-
vision ainsi que les donnes de performances entre les deux serveurs centraux.
Le serveur slave lui est uniquement charg de gnrer les fichiers RRD.
En cas de panne du master, on dmarre les services : Apache, CentCore, Centreon Engine ainsi que Centreon Broker
SQL sur le serveur slave. Le serveur slave remplace le serveur master.
La bascule master/slave ainsi que le dmarrage et larrt des services sont grs par le couple Corosync + Pacemaker.

Serveur satellite

Le serveur satellite fonctionne de la manire suivante :


Le moteur de supervision supervise le systme dinformations
Les informations de supervision sont envoyes via cbmod ladresse IP virtuel qui factorise les deux serveurs
centraux. En fonction du serveur actif, ces informations sont envoyes un des deux services Centreon Broker
SQL. Les informations de supervision sont galement envoyes au serveur satellite mme qui les traite en
utilisant galement Centreon Broker SQL.
Centreon Broker SQL est charg dinsrer les donnes de supervision en base de donnes (du serveur central
et du serveur satellite) et de transmettre les donnes de performances tous les services Centreon Broker RRD
(celui du serveur central master et slave ainsi que celui du serveur satellite)

3.5. Architecture redondante + interface graphique 25


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Centreon Broker RRD est charg de gnrer les fichiers RRD (qui servent gnrer les graphiques de perfor-
mances)

3.5.3 Architecture

Le schma ci-dessous rsume le fonctionnement de larchitecture :

26 Chapitre 3. Architectures proposes


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
CHAPITRE 4

Installation

4.1 Tlchargements

4.1.1 Formats

De manire gnrale, les logiciels Open Sources fournis par Centreon sont disponibles sous 3 formats :
paquets RPM (recommand)
archives contenant les sources
dpts git
Les paquets RPM sont le meilleur format pour obtenir nos logiciels. Ces derniers ont t packags par des experts
Centreon et permettent de ne pas se soucier du processus dinstallation.
Si votre plate-forme ne supporte pas les paquets RPMs, vous devrez utiliser les archives contenant les sources des
versions stables de nos logiciels et installer ces derniers manuellement. La compilation manuelle de certains paquets
peut tre complexe.

Note : Centreon recommande lutilisation de la version package Centreon Enterprise Server. Linstallation est d-
taille au chapitre Premier pas avec CES 3.2

Le dernier format disponible est orient pour les dveloppeurs ou les bta-testeurs. Aucun support officiel ne pourra
tre dlivr sur ces versions logicielles considres comme en cours de dveloppement. Vous pouvez tlcharger les
sources de nos produits ici

4.2 A partir de CES

4.2.1 Pourquoi choisir Centreon Engine et Broker ?

Performances

Les diffrents tests effectus par les quipes de Centreon et quelques utilisateurs indpendants dmontrent sans
quivoque que le couple Centreon Engine et Centreon Broker est 8 9 fois plus performants que le couple Na-
gios/NDOUtils. Ainsi cette version de CES ne propose plus linstallation du couple Nagios/NDOUtils pair.

Meilleure intgration Centreon

Linterface de Centreon est de plus en plus oriente vers lutilisation du broker, Centreon Broker. Quelques exemples :
Il existe un assistant de configuration pour Centreon Broker

27
Les performances daffichage sont grandement amliores
Certains filtres de slection ne sont disponibles quavec le broker, Centreon Broker

Nouvelles fonctionnalits

Plusieurs nouvelles fonctionnalits font leurs apparitions avec Centreon Broker :


Possibilit de chiffrer les donnes de supervision qui remontent vers le serveur Central
Possibilit de compresser les donnes de supervision afin de ne pas surcharger la bande passante
Utilisation dun nouveau protocole dencodage des donnes (Le protocole BBDO) plus performant que le
protocole NDO
Possibilit de filtrer le type de flux entre les composants de Centreon Broker pour diminuer la charge et la
bande passante
Possibilit de flux unidirectionnels entre le serveur Centreon et ses collecteurs (uniquement des flux LAN vers
DMZ par exemple)

Prrequis

Le tableau ci-dessous donne les prrequis pour linstallation de CES 3.2 :


Nombre de services Architecture conseille Serveur central Serveur(s) de collecte
< 500 1 central 1 vCPU / 1 Go
500 - 2000 1 central 2 vCPU / 2 Go
2000 - 10000 1 central + 1 satellite 4 vCPU / 4 Go 1 vCPU / 2 Go
10000 - 20000 1 central + 1 satellite 4 vCPU / 8 Go 2 vCPU / 2 Go
20000 - 50000 1 central + 2 satellite 4 vCPU / 8 Go 4 vCPU / 2 Go
50000 - 100000 1 central + 3 satellite 4 vCPU / 8 Go 4 vCPU / 2 Go
Note : Ces informations tiennent compte du fait que toutes les optimisations aient t ralises pour lordonnan-
ceur Centreon Engine, que les transactions aient t actives dans Centreon Broker et que les optimisations aient t
ralises pour le SGBD MariaDB.
En cas darchitecture non virtualise, une frquence minimale de 2.5 Ghz au niveau de CPU est recommande.
La charge du serveur central dpend du nombre dutilisateurs connects simultanment, du contenu des pages consul-
tes ainsi que de la frquence de rafraichissement des pages. Nos tudes ont t faites avec 15 utilisateurs simultanes
sur la page de monitoring de centreon avec 60 s de rafrachissement.Ces informations tiennent compte du fait que
toutes les optimisations aient t ralises pour lordonnanceur Centreon Engine, que les transactions aient t acti-
ves dans Centreon Broker et que les optimisations aient t ralises pour le SGBD MariaDB.

Installation

4.2.2 Etape 1 : Dmarrage

Afin dinstaller, dmarrez votre serveur sur le support (cr partir du fichier ISO) de Centreon Enterprise Server.
Dmarrez avec loption Install or upgrade an existing system

28 Chapitre 4. Installation
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Cliquez sur Next

4.2.3 Etape 2 : Choix de la langue

Choisissez votre langue et cliquez sur Next.

4.2. A partir de CES 29


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Slectionnez le clavier utilis par votre systme puis cliquez sur Suivant.

4.2.4 Etape 3 : Configuration gnrale

En fonction du type de stockage dsir, choisissez les options ncessaires pour disposer du partitionnement qui vous
convient le mieux.

30 Chapitre 4. Installation
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Un message davertissement peut apparatre

Choisissez le nom dhte de votre machine et cliquez sur Configurer le rseau afin de pouvoir modifier les paramtres
de votre carte rseau.
Slectionnez la carte rseau que vous souhaitez configurer et rendez-vous dans longlet Paramtres IPv4 ou Pa-
ramtres IPv6 (en fonction du besoin) afin de configurer ladresse IP des interfaces. Cliquez sur Appliquer... afin
denregistrer les modifications.

4.2. A partir de CES 31


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Cliquez sur Fermer puis sur Suivant afin de continuer.
Slectionnez votre fuseau horaire puis cliquez sur Suivant.

Entrez le mot de passe dsir du compte root, puis cliquez sur Suivant.
Slectionnez les options de partitionnement qui vous conviennent le mieux. Puis validez.

32 Chapitre 4. Installation
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
4.2.5 Etape 4 : Slection des composants

Choix du type de serveur

Il est possible de choisir diffrentes options la question Which server type would you like to install ? :

Central server with database : Installe Centreon (interface web + base de donnes) ainsi que lordonnanceur et
le broker

4.2. A partir de CES 33


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Central server without database : Installe Centreon (interface web uniquement) ainsi que lordonnanceur et le
broker
Poller server : Installe le serveur satellite (ordonnanceur et broker uniquement)
Database server : Installe le serveur de base de donnes (utilis en complment avec loption Central server
without database)
Une fois toutes ces options choisies, linstallation dmarre.

Lorsque linstallation est termine, cliquez sur Redmarrer.

34 Chapitre 4. Installation
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Configuration

4.2.6 Via linterface web

Connectez-vous linterface web via http://[ADRESSE_IP_DE_VOTRE_SERVEUR]/centreon. Lassistant de fin


dinstallation de Centreon saffiche, cliquez sur Next.

Lassistant de fin dinstallation de Centreon contrle la disponibilit des modules, cliquez sur Next.

Choisissez loption centreon-engine.

Cliquez sur Next.

4.2. A partir de CES 35


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Lors du choix du broker, choisissez centreon-broker.

Cliquez sur Next.

Dfinissez les informations concernant lutilisateur admin, cliquez sur Next.

36 Chapitre 4. Installation
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Par dfaut, le serveur localhost est dfini et le mot de passe root est vide. Si vous utilisez un serveur de base de
donnes dport, il convient de modifier ces deux informations. Dans notre cas, nous avons uniquement besoin de
dfinir un mot de passe pour lutilisateur accdant aux bases de donnes Centreon, savoir centreon, cliquez sur
Next.

Si le message derreur suivant apparait : Add innodb_file_per_table=1 in my.cnf file under the [mysqld] section
and restart MySQL Server. Effectuez lopration ci-dessous :
1. Connectez-vous avec lutilisateur root sur votre serveur
2. Editez le fichier suivant
/etc/my.cnf

3. Ajoutez la ligne suivante au fichier

[mysqld]
innodb_file_per_table=1

4. Redmarrez le service mysql

/etc/init.d/mysql restart

5. Cliquez sur Refresh

4.2. A partir de CES 37


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Lassistant de fin dinstallation configure les bases de donnes, cliquez sur Next.

Linstallation est termine, cliquez sur Finish.

Vous pouvez maintenant vous connecter.

4.2.7 Configuration de base

Dans un premier temps, il est ncessaire de passer linterface en version franaise. Pour cela :
1. Connectez-vous avec lutilisateur root sur votre serveur
2. Installez le paquet de traduction en langue franaise avec la commande suivante

38 Chapitre 4. Installation
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
yum -y install centreon-lang-fr_FR

3. Rendez-vous dans le menu Administration ==> Options


4. Dans le menu de gauche cliquez sur My Account
5. Dans le champ Language, remplacez en_US par fr_FR.UTF-8
6. Cliquez sur Save

4.2.8 Dmarrer la supervision

Pour dmarrer lordonnanceur de supervision :


1. Sur linterface web, rendez-vous dans le menu Configuration ==> Moteur de supervision
2. Laissez les options par dfaut, et cliquez sur Exporter
3. Dcochez Gnrer les fichiers de configuration et Lancer le dbogage du moteur de supervision (-v)
4. Cochez Dplacer les fichiers gnrs ainsi que Redmarrer lordonnanceur
5. Cliquez nouveau sur Exporter
6. Connectez-vous avec lutilisateur root sur votre serveur
7. Dmarrez le composant Centreon Broker :
/etc/init.d/cbd start

La supervision est maintenant oprationnelle.

4.2.9 Dcouverte de linterface web

Linterface web de Centreon est compose de plusieurs menus, chaque menu une fonction bien prcise :

Le menu Accueil permet daccder au premier cran daccueil aprs stre connect. Il rsume ltat gnral
de la supervision.
Le menu Supervision regroupe ltat de tous les lments superviss en temps rel et en diffr au travers de
la visualisation des logs
Le menu Vues permet de visualiser et de configurer les graphiques de performances pour chaque lment du
systme dinformations
Le menu Rapports permet de visualiser de manire intuitive (via des diagrammes) lvolution de la supervision
sur une priode donne

4.2. A partir de CES 39


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Le menu Configuration permet de configurer lensemble des lments superviss ainsi que linfrastructure de
supervision
Le menu Administration permet de configurer linterface web Centreon ainsi que de visualiser ltat gnral
des serveurs

4.2.10 Avant daller plus loin

Avant daller plus loin, il est ncessaire de faire une mise jour du serveur CES 3.2. Pour cela :
1. Connectez-vous en tant que root sur le serveur central
2. Tapez la commande
yum -y update

Laissez la mise jour se faire puis redmarrer le serveur dans le cas dune mise jour du noyau.
Vous pouvez commencer la configuration en cliquant ici.

4.3 A partir des dpts

Centreon fournit RPM pour ses produits au travers de la solution Centreon Entreprise Server (CES) en version Open
Sources et disponible gratuitement sur notre dpt.
Ces paquets ont t tests avec succs sur les environnements CentOS et Red Hat en version 5.x et 6.x.

4.3.1 Prrequis

Afin dinstaller les logiciels Centreon partir des dpts CES, vous devez au pralable installer le fichier li au dpt.
Excuter la commande suivante partir dun utilisateur possdant les droits suffisants :

$ wget http://yum.centreon.com/standard/3.0/stable/ces-standard.repo -O /etc/yum.repos.d/ces-sta

Le dpt est maintenant install.

Pour tous les OS

SELinux doit tre dsactiv. Pour cela vous devez modifier le fichier /etc/sysconfig/selinux et remplacer enforcing
par disabled comme dans lexemple suivant :
SELINUX=disabled
La timezone par dfaut de PHP doit tre configure. Pour cela, aller dans le rpertoire /etc/php.d et crer un fichier
nomm php-timezone.ini contenant la ligne suivante :
date.timezone = Europe/Paris
Aprs avoir sauvegard le fichier, noubliez pas de redmarrer le service apache de votre serveur.
La base de donnes MySQL doit tre disponible pour pouvoir continuer linstallation (localement ou non). Pour
information nous recommandons MariaDB.

Installer un serveur central

Ce chapitre dcrit linstallation dun serveur central Centreon.

40 Chapitre 4. Installation
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Installation du serveur avec le moteur Centreon Engine

Excutez la commande :

$ yum install centreon-base-config-centreon-engine centreon

Suivez la procdure dinstallation web ici.

Installer un collecteur

Ce chapitre dcrit linstallation dun collecteur.

Installation du serveur avec le moteur Centreon Engine

Excutez la commande :

$ yum install centreon-poller-centreon-engine

Configuration basique dun collecteur

La communication entre le serveur central et un collecteur se fait via SSH.


Vous devez changer les cls SSH entre les serveurs.
Si vous navez pas de cl SSH privs sur le serveur central pour lutilisateur centreon :

$ su - centreon
$ ssh-keygen -t rsa

Vous devez copier cette cl sur le collecteur :

$ ssh-copy-id centreon@your_poller_ip

4.4 A partir des sources

4.4.1 Prrequis

CentOS

Warning : Cette procdure na pas t teste sur les versions 6.x des environnements CentOS et RHEL. Cependant
cette dernire doit tre compatible en modifiant les noms des paquets pour les adapter la version 6.

Les environnements CentOS et RHEL ne possdent pas en standard sur dpts lintgralit des dpendances nces-
saires linstallation de Centreon. Vous devez ajouter le dpt RPM Forge
Systme 32-bits :

$ wget http://packages.sw.be/rpmforge-release/rpmforge-release-0.5.1-1.el5.rf.i386.rpm
$ wget http://dag.wieers.com/rpm/packages/RPM-GPG-KEY.dag.txt

Systme 64-bits :

4.4. A partir des sources 41


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
$ wget http://packages.sw.be/rpmforge-release/rpmforge-release-0.5.1-1.el5.rf.x86_64.rpm
$ wget http://dag.wieers.com/rpm/packages/RPM-GPG-KEY.dag.txt

Utilisez votre diteur de texte favori et supprimez la premire ligne du fichier RPM-GPG-KEY.dag.txt. La premire
ligne doit contenir :

"-----BEGIN PGP PUBLIC KEY BLOCK-----"

Puis excutez les commandes suivantes :

$ rpm --import RPM-GPG-KEY.dag.txt


$ rpm -Uvh rpmforge-release-0.5.1-1.el5.rf.i386.rpm

Vous pouvez maintenant installer les dpendances ncessaires :

$ yum update
$ yum upgrade
$ yum install httpd gd fontconfig-devel libjpeg-devel libpng-devel gd-devel perl-GD \
openssl-devel perl-DBD-MySQL mysql-server mysql-devel php php-mysql php-gd php-ldap php-xml
perl-Config-IniFiles perl-DBI perl-DBD-MySQL rrdtool perl-rrdtool perl-Crypt-DES perl-Digest
perl-Digest-HMAC net-snmp-utils perl-Socket6 perl-IO-Socket-INET6 net-snmp net-snmp-libs php
dmidecode lm_sensors perl-Net-SNMP net-snmp-perl fping cpp gcc gcc-c++ libstdc++ glib2-devel
php-pear

Des commandes additionnelles sont ncessaires pour configurer correctement lenvironnement :

$ usermod -U apache
$ pear channel-update pear.php.net

Si vous ne pouvez pas accder directement Internet directement mais passer par un proxy, excutez la commande
suivante :

$ pear config-set http_proxy http://my_proxy.com:port

Puis excutez :

$ pear upgrade-all

Debian / Ubuntu

Installez les dpendances ncessaires :

$ apt-get install sudo tofrodos bsd-mailx lsb-release mysql-server libmysqlclient15-dev libdatet


apache2 apache2-mpm-prefork php5 php5-mysql php-pear php5-ldap php5-snmp php5-gd php5-sqlite
rrdtool librrds-perl libconfig-inifiles-perl libcrypt-des-perl libdigest-hmac-perl \
libdigest-sha1-perl libgd-gd2-perl snmp snmpd libnet-snmp-perl libsnmp-perl

Pour finir, vous devez installer des MIBs SNMP. En raison dun problme de licence, les fichiers MIBs ne sont pas
disponibles par dfaut sous Debian. Pour les ajouter, modifiez le fichier /etc/apt/sources.list et ajouter la catgorie
non-free.
Puis excutez les commandes suivantes :

$ apt-get update
$ apt-get install snmp-mibs-downloader

42 Chapitre 4. Installation
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Suse

Installez les dpendances ncessaires :

$ yast -i gcc gcc-c++ make automake apache2 php5 php5-mysql apache2-mod_php5 php5-pear \
php5-ldap php5-snmp php5-gd php5-soap php5-posix php5-gettext php5-mbstring mysql \
libmysqlclient-devel perl-DBD-mysql mysql-community-server rrdtool perl-Config-IniFiles \
net-snmp perl-Net-SNMP perl-SNMP gd libjpeg-devel libpng-devel fontconfig-devel \
freetype2-devel sudo mailx fping iputils dos2unix cron dejavu

Sur certaines distributions OpenSuse, le paramtrage par dfaut des type mine nest pas valide pour fonctionner avec
linterface web Centreon. Editez le fichier /etc/mime.types et rechercher les lignes :

text/x-xsl xsl
text/x-xslt xslt xsl

Remplacez-les par :

text/xml xsl
text/xml xslt xsl

Sauvegardez le fichier et redmarrez apache :

$ /etc/init.d/apache2 restart

4.4.2 Moteur de supervision

Centreon est test et valid uniquement pour le moteur de supervision Centreon Engine.
Installez ce moteur avant de poursuivre linstallation. Noubliez pas dinstaller les Plugins Nagios.

Warning : Centreon Web nest pas compatible avec le moteur de supervision Nagios.

4.4.3 Multiplexeur de flux

Centreon est test et valid uniquement pour le multiplexeur de flux Centreon Broker.
Installez ce multiplexeurs de flux avant de poursuivre linstallation.

4.4.4 Centreon

Tlchargez la dernire version de Centreon https://download.centreon.com/ .

Installation shell

Extrayez Centreon de larchive :

$ tar zxf centreon-2.x.x.tar.gz

Dplacez-vous dans le rpertoire extrait :

$ cd centreon-2.x.x

Excutez le script dinstallation :

4.4. A partir des sources 43


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
$ ./install.sh -i

Note : Le script dinstallation permet une configuration personnalise, cette procdure vous montrera les meilleurs
chemins utiliser. En outre, les questions rapides Yes/No peuvent tre rpondues par [y] la plupart du temps.

Contrle de prrequis

Si ltape dinstallation des prrequis sest droule avec succs, vous ne devriez avoir aucun problme lors de cette
tape. Sinon, reprennez la procdure dinstallation des prrequis :

###############################################################################
# #
# Centreon (www.centreon.com) #
# Thanks for using Centreon #
# #
# v2.6.6 #
# #
# infos@centreon.com #
# #
# Make sure you have installed and configured #
# sudo - sed - php - apache - rrdtool - mysql #
# #
###############################################################################
------------------------------------------------------------------------
Checking all needed binaries
------------------------------------------------------------------------
rm OK
cp OK
mv OK
/bin/chmod OK
/bin/chown OK
echo OK
more OK
mkdir OK
find OK
/bin/grep OK
/bin/cat OK
/bin/sed OK

Acceptation de la licence

This General Public License does not permit incorporating your program into
proprietary programs. If your program is a subroutine library, you may
consider it more useful to permit linking proprietary applications with the
library. If this is what you want to do, use the GNU Library General
Public License instead of this License.

Do you accept GPL license ?


[y/n], default to [n]:
> y

44 Chapitre 4. Installation
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Composants principaux

Rpondez [y] toutes les questions


------------------------------------------------------------------------
Please choose what you want to install
------------------------------------------------------------------------

Do you want to install : Centreon Web Front


[y/n], default to [n]:
> y

Do you want to install : Centreon CentCore


[y/n], default to [n]:
> y

Do you want to install : Centreon Nagios Plugins


[y/n], default to [n]:
> y

Do you want to install : Centreon Snmp Traps process


[y/n], default to [n]:
> y

Dfinition des chemins dinstallation

------------------------------------------------------------------------
Start CentWeb Installation
------------------------------------------------------------------------

Where is your Centreon directory?


default to [/usr/local/centreon]
> /usr/share/centreon

Do you want me to create this directory ? [/usr/share/centreon]


[y/n], default to [n]:
> y
Path /usr/share/centreon OK

Where is your Centreon log directory


default to [/usr/local/centreon/log/]
> /var/log/centreon

Do you want me to create this directory ? [/var/log/centreon/]


[y/n], default to [n]:
> y
Path /var/log/centreon/ OK

Where is your Centreon etc directory


default to [/etc/centreon]
>

Do you want me to create this directory ? [/etc/centreon]


[y/n], default to [n]:

4.4. A partir des sources 45


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
> y
Path /etc/centreon OK

Where is your Centreon binaries directory


default to [/usr/local/centreon/bin]
> /usr/share/centreon/bin

Do you want me to create this directory ? [/usr/share/centreon/bin]


[y/n], default to [n]:
> y
Path /usr/share/centreon/bin OK

Where is your Centreon data information directory


default to [/usr/local/centreon/data]
> /usr/share/centreon/data

Do you want me to create this directory ? [/usr/share/centreon/data]


[y/n], default to [n]:
> y

Where is your Centreon generation_files directory?


default to [/usr/local/centreon/]
> /usr/share/centreon
Path /usr/share/centreon/ OK

Where is your Centreon variable library directory?


default to [/var/lib/centreon]
>

Do you want me to create this directory ? [/var/lib/centreon]


[y/n], default to [n]:
> y
Path /var/lib/centreon OK

Where is your CentPlugins Traps binary


default to [/usr/local/centreon/bin]
> /usr/share/centreon/bin
Path /usr/share/centreon/bin OK

Le fichier RRDs.pm peut tre localis nimporte o sur le serveur. Utilisez les commandes suivantes :

$ updatedb
$ locate RRDs.pm

Where is the RRD perl module installed [RRDs.pm]


default to [/usr/lib/perl5/RRDs.pm]
>

Path /usr/lib/perl5 OK
/usr/bin/rrdtool OK
/usr/bin/mail OK
/usr/bin/php OK
/usr/bin/perl OK
Finding Apache user : apache
Finding Apache group : apache

46 Chapitre 4. Installation
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Utilisateur et groupe centreon

Le groupe dapplications centreon est utilis pour les droits daccs entre les diffrents logiciels Centreon :
What is the Centreon group ? [centreon]
default to [centreon]
>

What is the Centreon user ? [centreon]


default to [centreon]
>

Utilisateur de la supervision

Cet utilisateur excute le moteur de supervision Centreon Engine :

What is the Monitoring engine user ?


> centreon-engine

Cet utilisateur excute le multiplexeur de flux Centreon Broker :

What is the Broker user ? (optional)


> centreon-broker

Rpertoire des journaux dvnements

What is the Monitoring engine log directory ?


> /var/log/centreon-engine

Rpertoire des plugins

Where is your monitoring plugins (libexec) directory ?


default to [/usr/lib/nagios/plugins]
>
Path /usr/lib/nagios/plugins OK
Add group centreon to user apache OK
Add group centreon to user centreon-engine OK
Add group centreon-engine to user apache OK
Add group centreon-engine to user centreon OK

Configuration des droits sudo

------------------------------------------------------------------------
Configure Sudo
------------------------------------------------------------------------

Where is sudo configuration file


default to [/etc/sudoers]
>
/etc/sudoers OK

4.4. A partir des sources 47


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
What is the Monitoring engine init.d script ?
> /etc/init.d/centengine

What is the Monitoring engine binary ?


> /usr/sbin/centengine

What is the Monitoring engine configuration directory ?


> /etc/centreon-engine

Si vous utilisez Centreon Broker


Where is the configuration directory for broker module ?
> /etc/centreon-broker

Where is the init script for broker module daemon ?


> /etc/init.d/cbd

Configuration des droits


Do you want me to reconfigure your sudo ? (WARNING)
[y/n], default to [n]:
> y
Configuring Sudo OK

Configuration du serveur Apache

------------------------------------------------------------------------
Configure Apache server
------------------------------------------------------------------------

Do you want to add Centreon Apache sub configuration file ?


[y/n], default to [n]:
> y
Create /etc/httpd/conf.d/centreon.conf OK
Configuring Apache OK

Do you want to reload your Apache ?


[y/n], default to [n]:
> y
Reloading Apache service OK
Preparing Centreon temporary files
Change right on /var/log/centreon OK
Change right on /etc/centreon OK
Change macros for insertBaseConf.sql OK
Change macros for sql update files OK
Change macros for php files OK
Change right on /usr/local/etc OK
Add group centreon to user apache OK
Add group centreon to user centreon-engine OK
Add group centreon to user centreon OK
Copy CentWeb in system directory
Install CentWeb (web front of centreon) OK
Change right for install directory
Change right for install directory OK
Install libraries OK
Write right to Smarty Cache OK

48 Chapitre 4. Installation
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Copying libinstall OK
Change macros for centreon.cron OK
Install Centreon cron.d file OK
Change macros for centAcl.php OK
Change macros for downtimeManager.php OK
Change macros for eventReportBuilder.pl OK
Change macros for dashboardBuilder.pl OK
Install cron directory OK
Change right for eventReportBuilder.pl OK
Change right for dashboardBuilder.pl OK
Change macros for centreon.logrotate OK
Install Centreon logrotate.d file OK
Prepare export-mysql-indexes OK
Install export-mysql-indexes OK
Prepare import-mysql-indexes OK
Install import-mysql-indexes OK
Prepare indexes schema OK
Install indexes schema OK

Installation des modules pear

------------------------------------------------------------------------
Pear Modules
------------------------------------------------------------------------
Check PEAR modules
PEAR 1.4.9 1.9.4 OK
DB 1.7.6 1.7.14 OK
DB_DataObject 1.8.4 1.10.0 OK
DB_DataObject_FormBuilder 1.0.0RC4 1.0.2 OK
MDB2 2.0.0 2.4.1 OK
Date 1.4.6 1.4.7 OK
HTML_Common 1.2.2 1.2.5 OK
HTML_QuickForm 3.2.5 3.2.13 OK
HTML_QuickForm_advmultiselect 1.1.0 1.5.1 OK
HTML_Table 1.6.1 1.8.3 OK
Archive_Tar 1.1 1.3.1 OK
Auth_SASL 1.0.1 1.0.6 OK
Console_Getopt 1.2 1.2 OK
Net_SMTP 1.2.8 1.6.1 OK
Net_Socket 1.0.1 1.0.10 OK
Net_Traceroute 0.21 0.21.3 OK
Net_Ping 2.4.1 2.4.5 OK
Validate 0.6.2 0.8.5 OK
XML_RPC 1.4.5 1.5.5 OK
SOAP 0.10.1 0.13.0 OK
Log 1.9.11 1.12.7 OK
Archive_Zip 0.1.2 0.1.2 OK
All PEAR modules OK

Installation du fichier de configuration

------------------------------------------------------------------------
Centreon Post Install
------------------------------------------------------------------------

4.4. A partir des sources 49


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Create /usr/share/centreon/www/install/install.conf.php OK
Create /etc/centreon/instCentWeb.conf OK

Installation du composant Centstorage

------------------------------------------------------------------------
Start CentStorage Installation
------------------------------------------------------------------------

Where is your Centreon Run Dir directory?


default to [/var/run/centreon]
>

Do you want me to create this directory ? [/var/run/centreon]


[y/n], default to [n]:
> y
Path /var/run/centreon OK

Where is your CentStorage binary directory


default to [/usr/share/centreon/bin]
>
Path /usr/share/centreon/bin OK

Where is your CentStorage RRD directory


default to [/var/lib/centreon]
>
Path /var/lib/centreon OK
Preparing Centreon temporary files
/tmp/centreon-setup exists, it will be moved...
install www/install/createTablesCentstorage.sql OK
Creating Centreon Directory /var/lib/centreon/status OK
Creating Centreon Directory /var/lib/centreon/metrics OK
Change macros for centstorage binary OK
Install CentStorage binary OK
Install library for centstorage OK
Change right : /var/run/centreon OK
Change macros for centstorage init script OK

Do you want me to install CentStorage init script ?


[y/n], default to [n]:
> y
CentStorage init script installed OK

Do you want me to install CentStorage run level ?


[y/n], default to [n]:
> y
Change macros for logAnalyser OK
Install logAnalyser OK
Change macros for logAnalyser-cbroker OK
Install logAnalyser-cbroker OK
Change macros for nagiosPerfTrace OK
Install nagiosPerfTrace OK
Change macros for purgeLogs OK
Install purgeLogs OK
Change macros for purgeCentstorage OK
Install purgeCentstorage OK
Change macros for centreonPurge.sh OK

50 Chapitre 4. Installation
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Install centreonPurge.sh OK
Change macros for centstorage.cron OK
Install CentStorage cron OK
Change macros for centstorage.logrotate OK
Install Centreon Storage logrotate.d file OK
Create /etc/centreon/instCentStorage.conf OK

Installation du composant Centcore

------------------------------------------------------------------------
Start CentCore Installation
------------------------------------------------------------------------

Where is your CentCore binary directory


default to [/usr/share/centreon/bin]
>
Path /usr/share/centreon/bin OK
/usr/bin/ssh OK
/usr/bin/scp OK
Preparing Centreon temporary files
/tmp/centreon-setup exists, it will be moved...
Change CentCore Macro OK
Copy CentCore in binary directory OK
Change right : /var/run/centreon OK
Change right : /var/lib/centreon OK
Change macros for centcore.logrotate OK
Install Centreon Core logrotate.d file OK
Replace CentCore init script Macro OK

Do you want me to install CentCore init script ?


[y/n], default to [n]:
> y
CentCore init script installed OK

Do you want me to install CentCore run level ?


[y/n], default to [n]:
> y
Create /etc/centreon/instCentCore.conf OK

Installation des plugins

------------------------------------------------------------------------
Start CentPlugins Installation
------------------------------------------------------------------------

Where is your CentPlugins lib directory


default to [/var/lib/centreon/centplugins]
>

Do you want me to create this directory ? [/var/lib/centreon/centplugins]


[y/n], default to [n]:
> y
Path /var/lib/centreon/centplugins OK
Preparing Centreon temporary files
/tmp/centreon-setup exists, it will be moved...

4.4. A partir des sources 51


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Change macros for CentPlugins OK
Installing the plugins OK
Change right on centreon.conf OK
CentPlugins is installed

------------------------------------------------------------------------
Start CentPlugins Traps Installation
------------------------------------------------------------------------

Where is your SNMP configuration directory


default to [/etc/snmp]
>
/etc/snmp OK

Where is your SNMPTT binaries directory


default to [/usr/local/centreon/bin/]
> /usr/share/centreon/bin
/usr/share/centreon/bin OK
Finding Apache user : apache
Preparing Centreon temporary files
/tmp/centreon-setup exists, it will be moved...
Change macros for CentPluginsTraps OK
Change macros for init scripts OK
Installing the plugins Trap binaries OK
Change macros for snmptrapd.conf OK
Change macros for snmptt.ini OK
SNMPTT init script installed OK
Install : snmptrapd.conf OK
Install : snmp.conf OK
Install : snmptt.ini OK
Install : snmptt OK
Install : snmptthandler OK
Install : snmpttconvertmib OK
Create /etc/centreon/instCentPlugins.conf OK

Fin de linstallation

###############################################################################
# #
# Go to the URL : http://localhost.localdomain/centreon/ #
# to finish the setup #
# #
# Report bugs at https://github.com/centreon/centreon/issues #
# #
# Thanks for using Centreon. #
# ----------------------- #
# Contact : infos@centreon.com #
# http://www.centreon.com #
# #
###############################################################################

Pour tous les OS

SELinux doit tre dsactiv. Pour cela, vous devez modifier le fichier /etc/sysconfig/selinux et remplacer enforcing
par disabled comme dans lexemple suivant :

52 Chapitre 4. Installation
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
SELINUX=disabled
La timezone par dfaut de PHP doit tre configure. Pour cela, allez dans le rpertoire /etc/php.d et crez un fichier
nomm php-timezone.ini contenant la ligne suivante :
date.timezone = Europe/Paris
Aprs avoir sauvegard le fichier, noubliez pas de redmarrer le service apache de votre serveur.
La base de donnes MySQL doit tre disponible pour pouvoir continuer linstallation (localement ou non). Pour
information, nous recommandons MariaDB.
Suivez la procdure dinstallation web ici.

4.4. A partir des sources 53


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
54 Chapitre 4. Installation
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
CHAPITRE 5

Mise jour

5.1 A partir des paquets

Warning : Avant de mettre jour Centreon, veuillez sauvegarder vos bases de donnes.

5.1.1 Mise jour depuis une version antrieure la version 2.4.0

La structure des RPM a chang entre la version Centreon 2.3.x et la version 2.4.x.
Avant de mettre jour Centreon vous devez choisir entre deux modles : Centreon Engine and Centreon
Broker ou Nagios and Ndo2db.
Ce choix est dpendant de votre moteur de supervision.

Modle Centreon Engine

Lancer la commande :
# yum update centreon centreon-base-config-centreon-engine

Modle Nagios

Lancer la commande :
# yum update centreon centreon-base-config-nagios

5.2 A partir des sources

Warning : Avant de mettre jour Centreon, veuillez sauvegarder vos bases de donnes.

Pour mettre jour Centreon depuis les sources, tlcharger la dernire version de Centreon.

55
5.2.1 Installation shell

Extraire le paquet :

$ tar xvfz centreon-2.x.x.tar.gz

Se dplacer de rpertoire :

$ cd centreon-2.x.x

Excuter le script :

$ ./install -u /etc/centreon

O /etc/centreon correspond au rpertoire de configuration de centreon rempalcer le cas chant.

Contrle des prrequis

Si ltape [Step 01] est russie, vous devriez avoir aucun problme ici. Sinon revenir ltape [Step 01] et installer les
prrequis :

###############################################################################
# #
# Centreon (www.centreon.com) #
# Thanks for using Centreon #
# #
# v2.6.0 #
# #
# infos@centreon.com #
# #
# Make sure you have installed and configured #
# sudo - sed - php - apache - rrdtool - mysql #
# #
###############################################################################
------------------------------------------------------------------------
Checking all needed binaries
------------------------------------------------------------------------
rm OK
cp OK
mv OK
/bin/chmod OK
/bin/chown OK
echo OK
more OK
mkdir OK
find OK
/bin/grep OK
/bin/cat OK
/bin/sed OK
------------------------------------------------------------------------
Detecting old installation
------------------------------------------------------------------------
Finding configuration file in: /etc/centreon OK
You seem to have an existing Centreon.

56 Chapitre 5. Mise jour


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Choix des composants principaux

Chargement des paramtres dinstallation prcdents :

Do you want to use the last Centreon install parameters ?


[y/n], default to [y]:
> y

Using: /etc/centreon/instCentCore.conf
/etc/centreon/instCentPlugins.conf
/etc/centreon/instCentStorage.conf
/etc/centreon/instCentWeb.conf

Slectionner les composants mettre jour :

Do you want to install : Centreon Web Front


[y/n], default to [n]:
> y

Do you want to install : Centreon CentCore


[y/n], default to [n]:
> y

Do you want to install : Centreon Nagios Plugins


[y/n], default to [n]:
> y

Do you want to install : Centreon Snmp Traps process


[y/n], default to [n]:
> y
Convert variables for upgrade:

Mise jour de linterface web

De nouvelle informaitons sont ncessaires.


Le chemin vers les binaires de centreon :
------------------------------------------------------------------------
Start CentWeb Installation
------------------------------------------------------------------------

Where is your Centreon binaries directory


default to [/usr/local/centreon/bin]
>
Path /usr/local/centreon/bin OK

Le chemin de donnes supplmentaires pour Centreon Web :

Where is your Centreon data information directory


default to [/usr/local/centreon/data]
>

Do you want me to create this directory ? [/usr/local/centreon/data]


[y/n], default to [n]:
> y
Path /usr/local/centreon/data
/usr/bin/perl OK

5.2. A partir des sources 57


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Finding Apache user : www-data
Finding Apache group : www-data

Le groupe applicatif Centreon. Ce groupe est utilis pour les droits daccs entre les applications Centreon :

What is the Centreon group ? [centreon]


default to [centreon]
>

Do you want me to create this group ? [centreon]


[y/n], default to [n]:
> y

Lutilisateur applicatif Centreon :

What is the Centreon user ? [centreon]


default to [centreon]
>

Do you want me to create this user ? [centreon]


[y/n], default to [n]:
> y

Lutilisateur du module broker. Cet utilisateur est utilis pour ajouter des droits Centreon sur les rpertoires de
configuration et journaux. Si vide, lutilisateur du moteur de supervision sera utilis.
Par exemple :
Centreon Broker : centreon-broker
What is the Broker user ? (optional)
>
Le chemin vers les journaux. Par exmeple :
Centeron Engine : /var/log/centreon-engine
Le chemin vers les sondes de supervision :

Where is your monitoring plugins (libexec) directory ?


default to [/usr/lib/nagios/plugins]
>

Path /usr/lib/nagios/plugins OK
Add group centreon to user www-data OK
Add group centreon to user nagios OK
Add group nagios to user www-data OK
Add group nagios to user centreon OK

------------------------------------------------------------------------
Configure Sudo
------------------------------------------------------------------------

Le chemin vers le script de dmarrage de lordonnanceur. Par exemple :


Centreon Engine : /etc/init.d/centengine
Le chemin vers le rpertoire de configuratino du broker. Par exemple :
Centreon Broker : /etc/centreon-broker
Le chemin vers e script de dmarrage du broker. Par exemple :
Centreon Broker : /etc/init.d/cbd
Remplacement ou non du fichier de droits utilisateurs. Pour plus de scurit, sauvegarder le fichier /etc/sudoers.

58 Chapitre 5. Mise jour


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Do you want me to reconfigure your sudo ? (WARNING)
[y/n], default to [n]:
> y
Configuring Sudo OK

------------------------------------------------------------------------
Configure Apache server
------------------------------------------------------------------------
Create /etc/apache2/conf.d/centreon.conf OK
Configuring Apache OK

Do you want to reload your Apache ?


[y/n], default to [n]:
> y
Reloading Apache service OK
Preparing Centreon temporary files
Change right on /usr/local/centreon/log OK
Change right on /etc/centreon OK
Change macros for insertBaseConf.sql OK
Change macros for sql update files OK
Change macros for php files OK
Disconnect users from WebUI
All users are disconnected OK
Copy CentWeb in system directory
Install CentWeb (web front of centreon) OK
Change right for install directory
Change right for install directory OK
Install libraries OK
Write right to Smarty Cache OK
Copying libinstall OK
Change macros for centreon.cron OK
Install Centreon cron.d file OK
Change macros for centAcl.php OK
Change macros for downtimeManager.php OK
Change macros for eventReportBuilder.pl OK
Change macros for dashboardBuilder.pl OK
Install cron directory OK
Change right for eventReportBuilder.pl OK
Change right for dashboardBuilder.pl OK
Change macros for centreon.logrotate OK
Install Centreon logrotate.d file OK
Prepare export-mysql-indexes OK
Install export-mysql-indexes OK
Prepare import-mysql-indexes OK
Install import-mysql-indexes OK
Prepare indexes schema OK
Install indexes schema OK

------------------------------------------------------------------------
Pear Modules
------------------------------------------------------------------------
Check PEAR modules
PEAR 1.4.9 1.9.4 OK
DB 1.7.6 1.7.14 OK
DB_DataObject 1.8.4 1.10.0 OK
DB_DataObject_FormBuilder 1.0.0RC4 1.0.2 OK
MDB2 2.0.0 2.4.1 OK
Date 1.4.6 1.4.7 OK

5.2. A partir des sources 59


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
HTML_Common 1.2.2 1.2.5 OK
HTML_QuickForm 3.2.5 3.2.13 OK
HTML_QuickForm_advmultiselect 1.1.0 1.5.1 OK
HTML_Table 1.6.1 1.8.3 OK
Archive_Tar 1.1 1.3.7 OK
Auth_SASL 1.0.1 1.0.6 OK
Console_Getopt 1.2 1.2.3 OK
Net_SMTP 1.2.8 1.6.1 OK
Net_Socket 1.0.1 1.0.10 OK
Net_Traceroute 0.21 0.21.3 OK
Net_Ping 2.4.1 2.4.5 OK
Validate 0.6.2 0.8.5 OK
XML_RPC 1.4.5 1.5.5 OK
SOAP 0.10.1 0.13.0 OK
Log 1.9.11 1.12.7 OK
Archive_Zip 0.1.2 0.1.2 OK
All PEAR modules OK

------------------------------------------------------------------------
Centreon Post Install
------------------------------------------------------------------------
Create /usr/local/centreon/www/install/install.conf.php OK
Create /etc/centreon/instCentWeb.conf OK
Convert variables for upgrade:

Mise jour de Centreon Storage

De nouvelle informaitons sont ncessaires.


------------------------------------------------------------------------
Start CentStorage Installation
------------------------------------------------------------------------
Preparing Centreon temporary files
/tmp/centreon-setup exists, it will be moved...
install www/install/createTablesCentstorage.sql OK
CentStorage status Directory already exists PASSED
CentStorage metrics Directory already exists PASSED
Change macros for centstorage binary OK
Install CentStorage binary OK
Install library for centstorage OK
Change right : /var/run/centreon OK
Change macros for centstorage init script OK
Replace CentCore default script Macro OK

Do you want me to install CentStorage init script ?


[y/n], default to [n]:
> y
CentStorage init script installed OK
CentStorage default script installed OK

Do you want me to install CentStorage run level ?


[y/n], default to [n]:
> y
update-rc.d: using dependency based boot sequencing
insserv: warning: current start runlevel(s) (3 5) of script centstorage overwrites defaults (2 3 4
Change macros for logAnalyser OK
Install logAnalyser OK

60 Chapitre 5. Mise jour


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Change macros for logAnalyser-cbroker OK
Install logAnalyser-cbroker OK
Change macros for nagiosPerfTrace OK
Install nagiosPerfTrace OK
Change macros for purgeLogs OK
Install purgeLogs OK
Change macros for purgeCentstorage OK
Install purgeCentstorage OK
Change macros for centreonPurge.sh OK
Install centreonPurge.sh OK
Change macros for centstorage.cron OK
Install CentStorage cron OK
Change macros for centstorage.logrotate OK
Install Centreon Storage logrotate.d file OK
Create /etc/centreon/instCentStorage.conf OK
Convert variables for upgrade:

Mise jour Centreon Core

De nouvelle informations sont ncessaires.


------------------------------------------------------------------------
Start CentCore Installation
------------------------------------------------------------------------
Preparing Centreon temporary files
/tmp/centreon-setup exists, it will be moved...
Change CentCore Macro OK
Copy CentCore in binary directory OK
Change right : /var/run/centreon OK
Change right : /var/lib/centreon OK
Change macros for centcore.logrotate OK
Install Centreon Core logrotate.d file OK
Replace CentCore init script Macro OK
Replace CentCore default script Macro OK

Do you want me to install CentCore init script ?


[y/n], default to [n]:
> y
CentCore init script installed OK
CentCore default script installed OK

Do you want me to install CentCore run level ?


[y/n], default to [n]:
> y
update-rc.d: using dependency based boot sequencing
insserv: warning: current start runlevel(s) (3 5) of script centcore overwrites defaults (2 3
Create /etc/centreon/instCentCore.conf OK
Convert variables for upgrade:

Mise jour des sondes Centreon

De nouvelle informations sont ncessaires.


------------------------------------------------------------------------
Start CentPlugins Traps Installation
------------------------------------------------------------------------

5.2. A partir des sources 61


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Finding Apache user : www-data
Preparing Centreon temporary files
/tmp/centreon-setup exists, it will be moved...
Change macros for CentPluginsTraps OK
Change macros for init scripts OK
Installing the plugins Trap binaries OK
Backup all your snmp files OK
Change macros for snmptrapd.conf OK
Change macros for snmptt.ini OK
SNMPTT init script installed OK
SNMPTT default script installed OK
update-rc.d: using dependency based boot sequencing
Install : snmptrapd.conf OK
Install : snmp.conf OK
Install : snmptt.ini OK
Install : snmptt OK
Install : snmptthandler OK
Install : snmpttconvertmib OK
Generate SNMPTT configuration OK
Create /etc/centreon/instCentPlugins.conf OK

Fin de la mise jour :


###############################################################################
# #
# Go to the URL : http://localhost/centreon/ #
# to finish the setup #
# #
# Report bugs at https://github.com/centreon/centreon/issues #
# #
# Thanks for using Centreon. #
# ----------------------- #
# Contact : infos@centreon.com #
# http://www.centreon.com #
# #
###############################################################################

5.2.2 Installation Web

Durant la mise jour web suivre les instructions suivantes :

62 Chapitre 5. Mise jour


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Prsentation

Contrle des dpendances

This step checks the dependencies on php modules.

5.2. A partir des sources 63


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Notes de version

64 Chapitre 5. Mise jour


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Mise jour des bases

Cette tape met jour le modle des bases de donnes ainsi que les donnes, version par version.

Finalisation

5.2. A partir des sources 65


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
5.3 Procdure de mise jour spcifique

5.3.1 Mettre jour un collecteur distant aprs une mise jour de Centreon 2.4

Cette procdure explique comment mettre jour la configuration dun collecteur distant aprs une migration vers
Centreon 2.4. Les exemples donns parlent de Nagios, mais cette procdure fonctionne galement avec Centreon
Engine si vous remplacez les fichiers binaires et les chemins.

Modification du collecteur

Crer un utilisateur centreon avec un mot de passe associ :

$ useradd centreon
$ passwd centreon

Ajouter lutilisateur nagios au groupe centreon :

$ usermod -a -G centreon nagios

Editer le fichier de droit sudo :

$ visudo

Ajouter les lignes suivantes :


User_Alias CENTREON=nagios,centreon

Puis mettre jour la configuration existante en remplacement nagios par CENTREON :


CENTREON ALL=NOPASSWD: /etc/init.d/nagios restart
CENTREON ALL=NOPASSWD: /etc/init.d/nagios stop
CENTREON ALL=NOPASSWD: /etc/init.d/nagios start
CENTREON ALL=NOPASSWD: /etc/init.d/nagios reload
CENTREON ALL=NOPASSWD: /usr/bin/nagiostats
CENTREON ALL=NOPASSWD: /usr/local/etc/bin/nagios *

Sauvegarder les modifications et clore le fichier.


Modifier les droits du rpertoire contenant la configuration Nagios :

$ chown centreon:centreon </nagios/path/etc/>


$ chmod 775 </nagios/path/etc/>

Modifier galement les droits du fichier service-perfdata :

$ chown centreon:centreon </nagios/path/var/>service-perfdata


$ chmod 775 </nagios/path/var/>service-perfdata

Enfin, il est ncessaire dexporter les fichiers de configuration du collecteur et de redmarrer le moteur de supervision
via linterface web.
Vous devriez voir apparatre un message indiquant que Nagios a reu une instruction de redmarrage via son journal
dvnements.

66 Chapitre 5. Mise jour


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Modifications du serveur central

Copier la cl publique de lutilisateur centreon vers le collecteur distant :

$ su - centreon
$ ssh-copy-id -i ~/.ssh/id_rsa.pub centreon@<poller_ip_address>

Remplacer <poller_ip_address> par ladresse IP du collecteur.


Pour finaliser lopration, se connecter au collecteur depuis le serveur central :

$ su - centreon
$ ssh <poller_ip_address>

Rpondre y la question pose. Vous devriez vous connecter sans saisir le mot de passe.

5.3. Procdure de mise jour spcifique 67


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
68 Chapitre 5. Mise jour
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
CHAPITRE 6

Guide utilisateur

6.1 Configuration

6.1.1 Actions gnriques

Au sein du menu Configuration il est possible deffectuer certaines actions gnriques sur les diffrents objets.

Ajouter/Supprimer

Lajout dun nouvel objet se fait via linstruction Ajouter ct du menu More actions....
Pour supprimer un objet :
1. Slectionnez le ou les objets que vous souhaitez supprimer en cochant la ou les cases prs du nom de celui-ci
2. Dans le menu More actions... cliquez sur Supprimer
Attention : La suppression dun objet est dfinitive. Si vous avez supprim un objet par accident, il vous faudra le
recrer. De mme, la suppression dun objet supprime automatiquement tous les objets qui sont lis lui et ne peuvent
vivre sans. Exemple : La suppression dun hte entraine la suppression de tous les services associs cet hte.
Pour modifier un objet, cliquez sur son nom.

Dupliquer

Principe

La duplication dun objet permet de copier/cloner celui-ci afin de pouvoir rutiliser ses attributs pour la cration dun
nouvel objet. Exemple : Jai 10 serveurs web identiques superviser :
Jajoute le premier serveur web avec tous les attributs ncessaires
Je duplique cet hte 9 fois
Je nai plus qu changer les noms dhtes et les adresses IP de chaque duplication pour les adapter aux 9
autres serveurs web superviser
Grce cette mthode, il nest plus ncessaire de crer unitairement chaque hte.

Pratique

Pour dupliquer un hte :


1. Slectionnez lhte que vous souhaitez dupliquer

69
2. Dans la colonne Options, entrez le nombre de duplication que vous souhaitez obtenir

3. Dans le menu More actions... cliquez sur Dupliquer

Changement massif

Principe

Les changements massifs permettent dappliquer un changement sur plusieurs objets.


Exemple : Lensemble des serveurs web prcdemment crs changent de communaut SNMP. Un changement massif
permet de modifier cette communaut sans avoir la peine de modifier chaque fiche de chaque hte unitairement.

Pratique

Pour effectuer un changement massif :


1. Slectionnez les objets que vous souhaitez modifier
2. Dans le menu More actions... cliquez sur Changement massif
La fentre de changement souvre, il existe deux types de changements :
Incrmentale : signifie que la modification va sajouter aux options dj existantes
Remplacement : signifie que la modification va craser les options dj existantes

Activer/Dsactiver

Principe

Lactivation et la dsactivation des objets permettent de prendre en compte ou non lobjet lors de la gnration de la
configuration. Le principal intrt est de pouvoir garder la configuration dun objet sans pour autant lappliquer.

Pratique

Pour activer/dsactiver un objet :


1. Slectionnez les objets que vous souhaitez modifier
2. Dans le menu More actions... cliquez sur Activer/Dsactiver
Il est galement possible dactiver ou de dsactiver un objet via le champ Statut de la fiche de dtails de lobjet ou
en utilisant les icnes suivantes :
pour activer
pour dsactiver

70 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
6.1.2 Les htes

Un hte est toute entit possdant une adresse IP correspondant une ressource du systme dinformations. Exemples :
Un serveur, une imprimante rseau, un serveur NAS, une base de donnes, une sonde de temprature, une camra IP...
Tous les ajouts dhtes se font dans le menu Configuration ==> Htes ==> Ajouter.

Configuration de lhte

Informations gnrales

Le champ Nom de lhte dfinit le nom dhte qui sera utilis par le moteur de supervision.
Le champ Alias indique lalias de lhte.
Le champ Adresse IP/DNS : Adresse IP ou nom DNS de lhte. Le bouton Rsoudre permet de rsoudre le
nom de domaine en interrogeant le serveur DNS configur sur le serveur central.
Les champs Communaut SNMP & Version contiennent respectivement le nom de la communaut ainsi que
la version SNMP.
Le champ Surveill depuis le collecteur indique quel est le serveur de supervision charg de superviser cet
hte.
Le champ Modles dhte permet dassocier un ou plusieurs modles dhtes cet objet. Pour ajouter un
modle dhte, cliquez sur le bouton .

En cas de conflits de paramtres prsents sur plusieurs modles, le modle dhte au-dessus crase les
proprits identiques dfinies dans modles dhtes en dessous. Le bouton permet de dplacer lordre
des modles dhte. Le bouton permet de supprimer le modle dhte.

6.1. Configuration 71
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Si le champ Crer aussi les services lis au modle est dfinit Oui, Centreon gnre automatiquement les
services en se basant sur les modles de services lis aux modles dhtes dfinis au-dessus (voir chapitre Les
modles).

Proprits du contrle de lhte

Le champ Priode de contrle dfinit la priode temporelle durant laquelle lordonnanceur vrifie le statut de
lobjet.
Le champ Commande de vrification indique la commande utilise pour vrifier la disponibilit de lhte.
Le champ Arguments dfinit les arguments donns la commande de vrification (chaque argument com-
mence avec un !).
Le champ Nombre de contrles avant validation de ltat dfinit le nombre de contrle effectuer avant de
valider le statut de lhte : lorsque le statut est valid, le processus de notification est enclench.
Le champ Intervalle normal de contrle est exprim en minutes. Il dfinit lintervalle entre chaque vrifica-
tion lorsque le statut de lhte est OK.
Le champ Intervalle non-rgulier de contrle est exprim en minutes. Il dfinit lintervalle de validation du
statut non-OK de lhte.
Les champs Contrles actifs activs et Contrles passifs activs activent/dsactivent les contrles actifs et
passifs.

Macros

La partie Macros permet dajouter des macros personnalises.


Les champs Nom de la macro et Valeur de la macro permettent respectivement de dfinir le nom et la valeur
de la macro.
La case Mot de passe permet de cacher la valeur de la macro.
Pour supprimer la macro, cliquez sur . Pour dplacer lordre des macros, cliquez sur .

Notification

Le champ Notification active permet dactiver ou de dsactiver les notifications concernant lobjet.
Si la case Contacts en complment de ceux hrits est coche, alors Centreon ncrase pas la configuration
du modle dhte parent mais ajoute les contacts en complment des contacts dfinis au niveau du modle
parent.
La liste Contacts lis indique les contacts qui recevront les notifications.
Si la case Groupes de contacts en complment de ceux hrits est coche, alors Centreon ncrase pas la
configuration du modle dhte parent mais ajoute les groupes de contacts en complment des groupes de
contacts dfinis au niveau du modle parent.
Au sein de la liste Groupe de contacts lis tous les contacts appartenant aux groupes de contacts dfinis
recevront les notifications.
Le champ Intervalle de notification est exprim en minutes. Il indique la dure entre chaque envoi de notifica-
tion lorsque le statut est non-OK. Si la valeur est dfinie 0 alors lordonnanceur envoie une seule notification
par changement de statut.
Le champ Priode de notification indique la priode temporelle durant laquelle les notifications seront acti-
ves.
Les Options de notifications dfinissent les statuts pour lesquels une notification sera envoye.
Le Dlai de premire notification est exprim en minutes. Il fait rfrence au dlai respecter avant lenvoi
dune premire notification lorsquun statut non-OK est valid.

72 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Onglet Relations

La liste Groupes dhtes parents dfinit les groupes dhtes auxquels lhte appartient.
La liste Catgorie dhtes parents dfinit les catgories auxquelles lhte appartient.
La liste Htes parents permet de dfinir les relations physiques de parent entre objet.
La liste Htes enfants permet de dfinir les relations physiques de parent entre objet.

Traitement des donnes

Si le Contrle de vrification de lhte est activ, alors la commande de remonte des contrles de lhte sera
active.
Le champ Contrler la fracheur du rsultat permet dactiver ou de dsactiver le contrle de fracheur du
rsultat.
Le champ Seuil de fracheur du rsultat est exprim en secondes. Si durant cette priode aucune demande de
changement de statut de lhte (commande passive) na t reue alors la commande de vrification active est
excute.
Le champ Dtection de bagotage des status permet dactiver ou de dsactiver la dtection du bagotage des
statuts (statut changeant trop frquemment de valeur sur une priode donne).
Les champs Seuil bas de dtection de bagotage des statuts et Seuil haut de dtection de bagotage des
statuts dfinissent les seuils hauts et bas pour la dtection du bagotage en pourcentage de changement de
statuts.
Le champ Traitement des donnes de performances permet dactiver ou de dsactiver le traitement des
donnes de performances (et donc la gnration des graphiques de performances). Cette option est inutile dans
le cas o Centreon Broker est utilis.
Les champs Rtention des informations de statut et Rtention des informations ne concernant pas le
statut indiquent si les informations concernant ou non le statut sont sauvegardes aprs chaque relance de la
commande de vrification.
Le champ Options enregistrer dfinit les options enregistrer si la rtention est active.
Le champ Gestionnaire dvnements activ permet dactiver ou de dsactiver le gestionnaire dvnements.
Le champ Gestionnaire dvnements dfinit la commande excuter si le gestionnaire dvnements est
activ.
Le champ Arguments dfinit les arguments de la commande du gestionnaire dvnements.

Informations dtailles de lhte

Moteur de supervision

Le champ URL dfinit une URL qui peut tre utilise pour donner davantage dinformations sur lhte.
Le champ Notes permet dajouter des notes optionnelles concernant lhte.
Le champ URL daction dfinit une URL habituellement utilise pour donner des informations dactions sur
lhte (maintenance...).
Le champ Icne indique licne utiliser pour lhte.
Le champ Icne alternative est le texte utilis si licne ne peut tre affiche.
Le champ Niveau de criticit indique le niveau de criticit de lhte.
Les champs prsents ci-dessous sont des champs utiliss uniquement par la CGI de lordonnanceur (habituellement
Nagios). Par consquent, ils prsentent peu dintrt lorsquon utilise Centreon Engine et Centreon Broker.
Le champ Image VRML dfinit le logo pour le moteur 3D de lhte (non compatible avec Centreon Engine).
Le champ Image de la carte des tats dfinit le logo pour la CGI de lordonnanceur.
Le champ Coordonnes 2D et 3D indiquent les coordonnes 2D et 3D utilises par la CGI.

6.1. Configuration 73
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Access groups

Le champ ACL Resource Groups (seulement visible pour les utilisateurs non administrateur), permet de lier
lhte un groupe dhtes afin de pouvoir visualiser ce dernier (voir chapitre Les listes de contrles daccs).

Informations supplmentaires

Le champ Statut permet dactiver ou de dsactiver lhte.


Le champ Commentaires permet dajouter un commentaire concernant lhte.

6.1.3 Les services

Un service est un point de contrle li/rattach un hte. Par exemple : Pourcentage dutilisation partition sur un
serveur, niveau dencre sur une imprimante.
Tous les ajouts de services se font dans le menu Configuration ==> Services ==> Ajouter.

Configuration du service

Informations gnrales

Le champ Description dfinit le nom du service.


Le champ Modle de service indique le modle de service auquel le service est li.

74 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Etat du service

Le champ Est volatile indique si le service est volatile ou non (dune manire gnrale uniquement les services
passifs sont volatiles).
Le champ Priode de contrle dfinit la priode temporelle durant laquelle lordonnanceur vrifie le statut du
service.
Le champ Commande de vrification indique la commande utilise pour vrifier la disponibilit du service.
Le tableau Arguments dfinit les arguments donns la commande de vrification (le nombre darguments
varie en fonction de la commande de vrification choisie).
Le champ Nombre de contrles avant validation de ltat dfinit le nombre de contrles effectuer avant de
valider le statut du service. Lorsque le statut est valid, le processus de notification est enclench.
Le champ Intervalle normal de contrle est exprim en minutes. Il dfinit lintervalle entre chaque vrifica-
tion lorsque le statut du service est OK.
Le champ Intervalle non-rgulier de contrle est exprim en minutes. Il dfinit lintervalle de validation du
statut non-OK du service.
Les champs Contrle actif activ et Contrle passif activ activent/dsactivent le type de contrle du service.

Macros

La partie Macros permet dajouter des macros personnalises. Les champs Nom de la macro et Valeur de la macro
permettent respectivement de dfinir le nom et la valeur de la macro. La case Mot de passe permet de cacher la valeur
de la macro.

Pour supprimer la macro, cliquez sur . Pour dplacer lordre des macros, cliquez sur .

Notification

Le champ Notification active permet dactiver ou de dsactiver les notifications pour lobjet.
Le champ Utiliser les contacts dfinis sur lhte : permet de faire hriter les contacts depuis la configuration
de lhte.
Si la case Contacts en complment de ceux hrits est coche, alors Centreon ncrase pas la configuration
du modle de service parent mais ajoute les contacts en complment des contacts dfinis au niveau du modle
parent.
La liste Contacts lis indique les contacts qui recevront les notifications.
Si la case Groupes de contacts en complment de ceux hrits est coche, alors Centreon ncrase pas la
configuration du modle de service parent mais ajoute les groupes de contacts en complment des groupes de
contacts dfinis au niveau du modle parent.
Au sein de la liste Groupe de contacts lis tous les contacts appartenant aux groupes de contacts dfinis
recevront les notifications.
Le champ Intervalle de notification est exprim en minutes. Il indique la dure entre chaque envoi de notifica-
tion lorsque le statut est non-OK. Si la valeur est dfinie 0 alors lordonnanceur envoie une seule notification
par changement de statut.
Les Options de notifications dfinissent les statuts pour lesquels une notification sera envoye.
Le Dlai de premire notification est exprim en minutes. Il fait rfrence au dlai respecter avant lenvoi
dune premire notification lorsquun statut non-OK est valid.

Onglet Relations

Relations

La liste Li aux htes permet de dfinir le ou les htes auxquels lier ce service.

6.1. Configuration 75
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
La liste Li aux groupes de services permet de lier le service un ou plusieurs groupes de services.

Traps SNMP

Le champ Traps SNMP relis au service permet de dfinir les traps SNMP qui pourront modifier le comportement
du service.

Traitement des donnes

Si le champ Excuter une commande post contrle est activ, alors la commande de remonte des contrles
de lhte sera active.
Le champ Contrler la fracheur du rsultat permet dactiver ou de dsactiver le contrle de fracheur du
rsultat.
Le champ Seuil de fracheur du rsultat est exprim en secondes. Si durant cette priode aucune demande
de changement de statut du service (commande passive) na t reue alors la commande de vrification est
excute.
Le champ Dtection de bagotage des statuts permet dactiver ou de dsactiver la dtection du bagotage des
statuts (statut changeant trop frquemment de valeur sur une priode donne).
Les champs Seuil bas de dtection de bagotage des statuts et Seuil haut de dtection de bagotage des
statuts dfinissent les seuils hauts et bas pour la dtection du bagotage en pourcentage de changement.
Le champ Traitement des donnes de performances permet dactiver ou de dsactiver le traitement des
donnes de performances (et donc la gnration des graphiques de performances).
Les champs Rtention des informations de statut et Rtention et des informations concernant pas le statut
indiquent si les informations concernant ou ne concernant pas le statut sont sauvegardes aprs chaque relance
de la commande de vrification.
Le champ Options enregistrer dfinit les options enregistrer si la rtention est active
Le champ Gestionnaire dvnements activ permet dactiver ou de dsactiver le gestionnaire dvnements.
Le champ Gestionnaire dvnements dfinit la commande excuter si le gestionnaire dvnements est
activ.
Le champ Arguments dfinit les arguments de la commande du gestionnaire dvnements.

Informations supplmentaires du service

Centreon

Modle de graphique : Dfinit le modle de graphique utiliser pour prsenter les donnes de performances
lies au service.
Catgories : Dfinit la(les) catgorie(s) laquelle (auxquelles) le service appartient.

Moteur de supervision

Le champ URL dfinit une URL qui peut tre utilise pour donner davantage dinformations sur le service.
Le champ Notes permet dajouter des notes optionnelles concernant le service.
Le champ URL daction dfinit une URL habituellement utilise pour donner des informations dactions sur
le service (maintenance...).
Le champ Icne indique licne utiliser pour le service.
Le champ Icne alternative est le texte utilis si licne ne peut tre affiche.
Le champ Niveau de criticit indique le niveau de criticit du service.

76 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Informations supplmentaires

Le champ Statut permet dactiver ou de dsactiver le service.


Le champ Commentaires permet dajouter un commentaire concernant le service.

Dtachement dun service

Si un service est li plusieurs htes, alors il sera identique pour chacun deux. Il ne sera donc pas possible de modifier
unitairement le service dun hte pour modifier une proprit. Cest pourquoi il est possible de transformer ce service
li plusieurs htes en un service unique pour chaque hte :
1. Dans la liste des services, slectionnez le service li plusieurs htes (habituellement ce service est surlign
en orange)
2. Dans le menu More actions... cliquez sur Dtacher puis validez
Il existe maintenant un service unique par hte.

6.1.4 Les commandes

Dfinition

Une commande est la dfinition dune ligne de commande qui utilise un script ou une application afin de raliser une
action. Il est possible dexcuter cette commande en prcisant des arguments.
Il existe trois types de commandes :
Les commandes de vrification sont utilises par les ordonnanceurs afin de vrifier le statut dun hte ou dun
service.
Les commandes de notification sont utilises par les ordonnanceurs pour alerter les contacts (via mail, SMS...).
Des commandes diverses sont utilises par les modules complmentaires (pour effectuer certaines actions),
par lordonnanceur pour le traitement des donnes...
Toutes les commandes peuvent tre configures au sein du menu Configuration ==> Commandes.

6.1. Configuration 77
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Ajouter une commande

Avant dajouter une commande :


1. Slectionnez dans le menu de gauche le type de commande que vous souhaitez ajouter (Contrles, Notifica-
tions, Divers).

2. Cliquez sur Ajouter

Note : Les champs de configuration dune commande sont les mmes quimporte le type de commande choisi.

Les champs de configuration

Le champ Nom de la commande dfinit le nom de la commande.


Le champ Type de commande permet de choisir le type de commande.
Le champ Ligne de commande indique lapplication ou le script utilis avec la commande.
La case Activer le shell permet dactiver des fonctions propres un shell tel que le pipe...
Les champs Exemple darguments et $HOSTADDRESS$ dfinissent respectivement des exemples dargu-
ments (chaque argument commence par un !) et une adresse IP de test. Ces champs permettent dexcuter la
ligne de commande dfinie au-dessus via linterface web en cliquant sur la flche bleue : .
Le bouton Description des arguments permet dajouter une description aux arguments de type $ARGn$.
Cette description sera visible lors de lutilisation de la commande dans un formulaire dhte ou de service.

78 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Le bouton Effacer les arguments efface la description des arguments dfinie
Le champ Connecteurs permet de lier un connecteur la commande. Pour davantage dinformations sur les
connecteurs reportez-vous aux chapitres Documentation connecteurs Perl et Documentation connecteurs SSH.
Le champ Modle de graphique permet de lier la commande un modle de graphique.
Le champ Commentaire permet de commenter la commande.

Arguments et macros

Au sein du champ Ligne de commande, il est possible de faire appel des macros ainsi qu des arguments.
Les arguments sont utiliss afin de pouvoir passer diffrents paramtres aux scripts appels par les commandes. Lors
de lexcution de la commande par lordonnanceur, chacun des arguments et macros sont remplacs par leur valeur
respective. Chaque argument se prsente sous la forme $ARGn$ o n est un entier naturel suprieur 0.
Exemple de ligne de commande utilisant les arguments : $USER1$/check-bench-process-DB -w $ARG1$ -c $ARG2$
-n $ARG3$

Note : La bonne pratique veut que nous remplacions les arguments par des macros personnalises.

6.1.5 Les priodes temporelles

Dfinition

Une priode temporelle est la dfinition dun intervalle de temps pour chacun des jours de la semaine. Ces priodes
temporelles servent activer les fonctionnalits de lordonnanceur sur une priode donne.
Les priodes temporelles sappliquent deux types dactions :
Lexcution des commandes de vrification
Lenvoi de notifications

Configuration

La configuration des priodes temporelles se droule dans le menu Configuration ==> Utilisateurs ==> Priodes
temporelles.

Options basiques

Les champs Nom de la priode temporelle et Alias dfinissent respectivement le nom et la description de la
priode temporelle.
Les champs appartenant la sous-catgorie Priode de temps dfinissent les jours de la semaine pour lesquels
il est ncessaire de dfinir des plages horaires.
Le tableau Exceptions permet dinclure des jours exclus de la priode de temps

6.1. Configuration 79
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Syntaxe dune priode de temps

Lors de la cration dune priode temporelle, les caractres suivants permettent de dfinir les priodes temporelles :
Le caractre : spare les heures des minutes. Exemple : HH :MM
Le caractre - indique une continuit entre deux horaires
Le caractre , permet de sparer deux plages horaires
Quelques exemples :
24 heures sur 24 et 7 jours sur 7 jours : 00 :00-24 :00 ( appliquer tous les jours de la semaine).
De 08h00 12h00 et de 14h00 18h45 les jours de la semaine : 08 :00-12 :00,14 :00-18 :45 ( entrer au niveau
des jours de la semaine uniquement).

Les exceptions

Les exceptions permettent dinclure la plage temporaire des jours exceptionnels (surcharge de la dfinition du fonc-
tionnement rgulier de la journe).
Exemple : Un administrateur souhaite dfinir une priode temporelle qui regroupe les heures de fermeture du bureau
cest dire :
De 18h00 07h59 les jours de semaine
24 heures sur 24 les weekends
Les jours fris, jours de fermeture exceptionnelle
Afin de pouvoir dfinir les jours fris ainsi que les jours de fermeture exceptionnelle, il est ncessaire dutiliser les
exceptions.

Pour ajouter une exception, cliquez sur le bouton . Par journe exceptionnelle, vous devez dfinir une plage horaire.
Le tableau ci-dessous prsente quelques exemples possibles :
Jour(s) Priode de temps Explications
1 january 00 :00-24 :00 Toute la journe le premier janvier de chaque anne
2014-02-10 00 :00-24 :00 Toute la journe du 10 fvrier 2014
1 july - 1 august 00 :00-24 :00 Tous les jours de chaque anne du 1 juillet au 1 aot
november 30 08 :00-19 :00 De 08h00 19h00 tous les 30 novembre de chaque anne
day 1 - 20 00 :00-24 :00 Toute la journe du premier au 20 de chaque mois
saturday -1 08 :00-12 :00,14 :00-18 :45 Tous les derniers samedi du mois les heures ouvres
monday -2 00 :00-24 :00 Tous les avant derniers lundi du mois toute la journe

80 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Options avances

Au sein des options avances, il est possible dinclure ou dexclure des priodes la dfinition de lobjet. Exemple
dapplication. Prenons deux priodes temporelles :
Une priode est dfinie 24 heures sur 24 / 7 jours sur 7 appele 24x7
Une autre qui regroupe les horaires douvertures du bureau appele working_hours
Pour obtenir les horaires de fermeture du bureau, je nai qu crer une priode temporelle dans laquelle jinclus la
plage 24x7 et pour laquelle jexclus la plage working_hours.

6.1.6 Les contacts

Dfinition

Les contacts au sein de Centreon sont utiliss afin de :


Pouvoir se connecter linterface web de Centreon : chaque contact dispose de ses propres droits afin de se
connecter linterface web.
Etre alert en cas de ncessit (notification).
Afin dajouter un contact, il suffit de se rendre dans le menu Configuration ==> Utilisateurs ==> Ajouter.

6.1. Configuration 81
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Pour afficher la matrice de notification dun contact, cliquez sur Afficher les notifications du contact ( ct du menu
Ajouter).

Informations gnrales

Le champ Alias/Login dfinit le login afin daccder linterface web.


Le champ Nom complet contient le nom et prnom de lutilisateur.
Les champs Mail et Bippeur contiennent respectivement ladresse mail et le numro de tlphone de lutilisa-
teur (dans le cas dune notification par SMS ou appel par exemple).
Le champ Modle de contact utilis permet de lier le contact un modle de contact.
La liste Li avec le groupe de contacts associe le contact un ou plusieurs groupes de contacts.
Le champ Activer les notifications permet dactiver lenvoi de notifications pour lutilisateur.
Le champ Options de notifications dhte/de service permet de dfinir les statuts pour lesquels il y a envoi
de notifications.
Le champ Priode de notification dhte/de service permet de choisir la priode temporelle pour laquelle il
y a envoi de notification.
Le champ Commande de notification dhte/de service permet de choisir la commande de notification pour
un hte ou pour un service.

Authentification Centreon

Le champ Autoriser lutilisateur se connecter linterface web permet dautoriser lutilisateur accder
linterface web de Centreon.
Les champs Mot de passe et Confirmation du mot de passe contiennent le mot de passe utilisateur.
Le champ Langue par dfaut permet de dfinir la langue de linterface Centreon pour cet utilisateur.
Le champ Administrateur dfinit si cet utilisateur est administrateur de la plateforme de supervision ou non.
Le champ Cl dauto-connexion permet de dfinir une cl de connexion pour lutilisateur. Lutilisateur naura
plus besoin dentrer son login et mot de passe mais utilisera directement cette cl pour se connecter. Syntaxe
de connexion :

http://[IP_DU_SERVEUR_CENTRAL]/index.php?autologin=1&useralias=[login_utilisateur]&token=[valeur

Note : La possibilit de connexion automatique (auto login) doit tre active dans le menu Administration ==>
Options.

Le champ Source dauthentification spcifie si les informations de connexion proviennent dun annuaire
LDAP ou dinformations stockes localement sur le serveur.
Le champ Groupes de liste daccs permet de dfinir un groupe daccs pour un utilisateur, groupe utilis
pour les contrles daccs (ACL).

Note : Un utilisateur Administrateur ne peut souffrir de contrle daccs mme li dans un groupe daccs.

Informations supplmentaires

Les champs dadresses permettent de spcifier des informations de contacts supplmentaires (autre mail, autre
numro de tlphone...).
Les champs Statut et Commentaires permettent dactiver ou de dsactiver le contact et de commenter celui-ci.

82 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
6.1.7 Les groupes

Un groupe permet de regrouper un ou plusieurs objets. Il existe trois types de groupes : htes, services et contacts.
Les groupes dhtes et de services servent principalement lors de la visualisation des graphiques ou pour regrouper les
objets. Les groupes de contacts sont utiliss principalement pour la mise en place de LCAs (ou ACL).

Les groupes dhtes

Pour ajouter un groupe dhtes :


1. Rendez-vous dans le menu Configuration ==> Htes
2. Dans le menu de gauche, cliquez sur Groupes dhtes
3. Cliquez sur Ajouter

Les champs Nom du groupe dhtes et Alias regroupent le nom et lalias du groupe dhtes.
La liste Htes lis permet dajouter des htes au sein du nouveau groupe dhtes.
Le champ Notes permet dajouter des notes optionnelles concernant le groupe dhtes.
Le champ URL dfinit une URL qui peut tre utilise pour donner davantage dinformations sur le groupe
dhtes.
Le champ URL daction dfinit une URL habituellement utilise pour donner des informations dactions sur
le groupe dhtes (maintenance...).
Le champ Icne indique licne utiliser pour le groupe dhtes.
Le champ Icne pour la carte est licne utilise pour la cartographie.
Le champ Rtention des fichiers RRD est exprim en jours, il permet de dfinir la dure de rtention des
services appartenant ce groupe dhtes au sein de la base de donnes RRD. Si cette valeur est vide, la valeur
sera celle par dfaut dfinie dans le menu Administration ==> Options ==> CentStorage pour le champ
Dure de rtention des donnes dans les bases RRD.
Les champs Statut et Commentaires permettent dactiver ou de dsactiver le groupe dhtes et de commenter
celui-ci.

6.1. Configuration 83
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Les groupes de services

Pour ajouter un groupe de services :


1. Rendez-vous dans le menu Configuration ==> Services
2. Dans le menu de gauche, cliquez sur Groupes de services
3. Cliquez sur Ajouter

Les champs Nom du groupe de services et Description regroupent le nom et la description du groupe de
services.
La liste Services dhtes lis permet de choisir les diffrents services qui feront partie de ce groupe.
La liste Services lis au groupe dhtes permet de choisir les services lis un groupe dhtes qui feront
partie de ce groupe.
Si un modle de service appartient la liste Modles de service lis alors tous les services qui hritent de ce
modle appartiennent ce groupe.
Les champs Statut et Commentaires permettent dactiver ou de dsactiver le groupe de services et de com-
menter celui-ci.

Les groupes de contacts

Pour ajouter un groupe de contacts :


1. Rendez-vous dans le menu Configuration ==> Utilisateurs
2. Dans le menu de gauche, cliquez sur Groupes de contacts
3. Cliquez sur Ajouter

84 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Les champs Nom du groupe de contacts et Alias dfinissent le nom et la description du groupe de contacts.
La liste Contacts lis permet dajouter les contacts au groupe de contacts.
Les champs Statut et Commentaires permettent dactiver ou de dsactiver le groupe de contacts et de com-
menter celui-ci.
Note : Pour plus dinformation se rfrer au chapitre associ sur les groupes.

6.1.8 Les catgories

Les catgories sont utilises afin de pouvoir dfinir des ACLs sur les htes et les services. Le but est de pouvoir classer
les htes ou les services au sein dune mme catgorie.
Centreon 2.4 avait intgr une nouvelle fonctionnalit appele Criticit. A partir de la version 2.5, les niveaux
de criticit sont lis une catgorie, ils sont devenus un type de catgorie. Un niveau de criticit est un indicateur
permettant de dfinir la criticit dun hte ou dun service. Le but est de pouvoir traiter les problmes des htes ou des
services par ordre de priorit. Grce ce systme, il est ainsi possible de filtrer les objets dans les vues Supervision
par criticit.

Les catgories dhtes

Pour ajouter une catgorie dhtes :


1. Rendez-vous dans le menu Configuration ==> Htes
2. Dans le menu de gauche, cliquez sur Catgories
3. Cliquez sur Ajouter

6.1. Configuration 85
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Les champs Nom de la catgorie dhtes et Alias contiennent respectivement le nom et lalias de la catgorie
dhte.
La liste Htes lis permet dajouter des htes la catgorie.
Si un modle dhte est ajout Li au modle dhte alors tous les htes qui hritent de ce modle appar-
tiennent cette catgorie.
La case Est de type criticit signifie que la catgorie dhtes un niveau de criticit.
Les champs Niveau et Icnes dfinissent respectivement un niveau de criticit et une icne associe.
Les champs Statut et Commentaires permettent dactiver ou de dsactiver la catgorie dhte et de commenter
celle-ci.

Les catgories de services

Pour ajouter une catgorie de services :


1. Rendez-vous dans le menu Configuration ==> Services
2. Dans le menu de gauche, cliquez sur Catgories
3. Cliquez sur Ajouter

86 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Les champs Nom et Description dfinissent le nom et la description de la catgorie de service.
Si un modle de service appartient Lie aux modles de services alors tous les services appartenant ce
modle de services font partie de cette catgorie.
La case Est de type criticit signifie que la catgorie de service un niveau de criticit.
Les champs Niveau et Icnes dfinissent respectivement un niveau de criticit et une icne associe.
Le champ Statut permet dactiver ou de dsactiver la catgorie de services.
Note : Pour plus dinformation se rfrer au chapitre associ sur les catgories.

6.1.9 Les modles

Dfinition

Un modle est une pr-configuration de paramtres dun objet qui pourra tre utilis pour configurer ce dernier. Le
principal avantage est de pouvoir dfinir des valeurs par dfaut pour certains objets afin dacclrer la cration dobjets
similaires.
Lors de la cration dun modle, seul le nom du modle est obligatoire. Les autres attributs sont optionnels.
Il existe trois types de modles :
Les modles dhtes
Les modles de services
Les modles de contacts
Les avantages sont :
Dfinition simplifie des lments
Pas de redondance dinformation
Facilit dajout de nouvelles ressources
Configurations prdfinies assimiles un catalogue dindicateurs
Les modles peuvent hriter dautres modles

Les modles dhtes

Hritage

Un hte ou un modle dhte peut hriter dun ou plusieurs modles dhtes. Cet hritage peut tre :
de type associatif (addition de plusieurs modles dhte)
de type pre-fils

6.1. Configuration 87
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Hritage de type Pre-Fils Il sagit dune prdfinition de paramtres n niveaux. Lobjet hrite de son modle
qui peut lui mme hriter de son modle. Si le fils redfini un paramtre, ce dernier crase celui dfini dans les modles
de niveaux suprieurs. Sinon il vient complter le paramtrage.

Hritage de type associatif Il sagit dadditionner plusieurs modles au sein dun mme objet afin dadditionner
lensemble des paramtres disponibles. Si un hte hrite de plusieurs modles dhtes et si un mme paramtre est
dfini sur plusieurs modles, alors le modle dhte situ au-dessus des autres modles est prioritaire par rapport ses
ascendants.

Le schma ci-dessous prsente un hte hritant de plusieurs modles dhtes.

Configuration

Pour ajouter un modle dhtes :


1. Rendez-vous dans le menu Configuration ==> Htes
2. Dans le menu de gauche, cliquez sur Modles
3. Cliquez sur Ajouter

88 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Note : Se rapporter au chapitre de configuration des htes pour configurer un modle car le formulaire est identique.

Les modles de services

Hritage

Un service ou un modle de service ne peut hriter que dun seul modle de service (hritage de type Pre-Fils).

Configuration

Pour ajouter un modle de services :


1. Rendez-vous dans le menu Configuration ==> Services
2. Dans le menu de gauche, cliquez sur Modles
3. Cliquez sur Ajouter

Note : Se rapporter au chapitre de configuration des services pour configurer un modle car le formulaire est identique.

Les bonnes pratiques

Explications

La bonne pratique veut que des modles de services soient associs des modles dhtes : lors de la cration dun
hte, les services sont gnrs automatiquement partir des modles dhtes. Il y a deux intrts lier les modles de
services aux modles dhtes :
Les services gnrs automatiquement conservent leur granularit : il est donc possible de modifier les attributs
dun service sans impacter les autres services issus de ce modle
La cration de nouveaux htes est grandement acclre : vous navez qu dfinir lhte et les modles dhtes
associs celui-ci
Exemple : Je cr lhte srvi-web-01 selon le modle ci-dessous :

6.1. Configuration 89
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Lhte srvi-web-01 possdera automatiquement les services suivants :
Load, CPU, Memoiry, disk-/ partir des modles de services issus du modle dhte Linux-Server-RedHat-5
broken-jobs, hit-ratio, tablespaces, listener partir des modles de services issus du modle dhte DB-
MySQL
processus et connection partir des modles de services issus du modle dhte Web-Server-Apache
Lorsque les services dun hte sont gnrs partir des modles dhtes, il est possible que certains services gnrs ne
soient plus ou pas vrifis par loutil de supervision. Dans ce cas, il est ncessaire de dsactiver les services inutiliss
(et non de les supprimer). En cas de suppression des services, la rgnration des services de lhte partir des modles
dhtes va recrer les services supprims.

90 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Configuration

La liaison des modles de services avec les modles dhtes a lieu dans longlet Relations des modles de services ou
des modles dhtes.

Les modles de contacts

Un contact ou un modle de contact peut hriter dun seul modle de contact.

Configuration

Pour ajouter un modle de contacts :


1. Rendez-vous dans le menu Configuration ==> Utilisateurs
2. Dans le menu de gauche, cliquez sur Modles de contacts
3. Cliquez sur Ajouter

6.1. Configuration 91
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Note : Se rapporter au chapitre de configuration des contacts. De plus, les modles de contacts sont utiliss pour
limport automatique de profils via un annuaire LDAP.

6.1.10 Configuration avance

Les macros

Une macro est une variable permettant de rcuprer certaines valeurs. Une macro commence et se termine toujours
par le signe $.

Les macros standards

Les macros standards sont des macros prdfinies dans le code source des moteurs de supervision. Ces diffrentes
macros permettent de rcuprer la valeur de diffrents objets au sein des commandes.
Exemple :
La macro $HOSTADDRESS$ permet de rcuprer ladresse IP dun hte
La macro $CONTACTEMAIL$ permet de rcuprer ladresse mail du contact
Note : La liste complte des macros est disponible ladresse suivante : Liste des macros

Les macros personnalises

Dfinition Les macros personnalises sont des macros dfinies par lutilisateur lors de la cration dun hte ou dun
service. Elles sont utilises dans les commandes de vrifications. Les macros personnalises commencent par $_HOST
pour les macros personnalises dhtes et par $_SERVICE pour les macros personnalises de services. Il y a plusieurs
avantages utiliser les macros personnalises la place des arguments :
La fonction de la macro est dfinie dans le nom de celle-ci. La macro $_HOSTMOTDEPASSEINTRANET$
est plus facilement lisible que $ARG1$
Les macros hritent des modles dhtes et de services, la modification dune seule macro est donc possible
pour un hte ou un service. En revanche, les arguments doivent tre tous redfinis en cas de modification dun
seul argument
Le nombre darguments est limit 32 contrairement aux macros personnalises qui sont infinies
Une macro dhte est utilise pour dfinir une variable qui est propre lhte et qui ne changera pas quimporte
le service interrog : des identifiants de connexion lhte, un port de connexion pour un service particulier, une
communaut SNMP.
Une macro de service est plutt utilise pour dfinir des paramtres propres un service : un seuil WAR-
NING/CRITICAL, une partition interroger...

Exemple Lors de la dfinition dun hte, les macros suivantes sont cres :

Pour faire appel ces macros dans une commande de vrification, il faudra les invoquer en utilisant les variables
suivantes : $_HOSTUSERLOGIN$, $_HOSTUSERPASSWORD$.
Lors de la dfinition dun service, les macros suivantes sont cres :

92 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Pour faire appel ces macros dans une commande de vrification, il faudra les invoquer en utilisant les variables
suivantes : $_SERVICEPARTITION$, $_SERVICEWARNING$, $_SERVICECRITICAL$.

Cas particulier Le champ Communaut SNMP & Version prsent au sein dune fiche dhte gnrent automati-
quement les macros personnalises suivantes : $_HOSTSNMPCOMMUNITY$ et $_HOSTSNMPVERSION$.

Les macros de ressources

Les macros de ressources sont des macros globales qui sont utilises par le moteur de supervision. Ces macros peuvent
tre invoques par nimporte quel type de commande. Elles se prsentent sous la forme $USERn$ o n est compris
entre 1 et 256.
Dune manire gnrale, ces macros sont utilises pour faire rfrence aux chemins contenant les sondes de supervi-
sion. Par dfaut, la macro $USER1$ est cre et sa valeur est la suivante : /usr/lib/nagios/plugins.
Pour ajouter une macro de ressources :
Rendez-vous dans le menu Configuration ==> Moteurs de supervision
Cliquez sur Ajouter

Le champ Nom de la ressource dfinit le nom de la macro de ressources. Exemple : $USER3$


Le champ Valeur de la ressource dfinit la valeur de la macro.
La liste Li au collecteur permet de dfinir quels seront les moteurs de supervision qui pourront accder
cette macro.
Les champs Statut et Commentaire permettent dactiver/dsactiver la macro ou de la commenter.

6.1. Configuration 93
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Les macros denvironnements

Les macros denvironnement (aussi appeles macros la demande ou on demand en anglais) permettent de rcu-
prer des informations partir de tous les objets issus de la supervision. Elles sont utilises afin de pouvoir rcuprer
un instant t la valeur dun objet.
Elles sont complmentaires aux macros standards. Exemple :
La macro standard $CONTACTEMAIL$ fait rfrence ladresse email du contact qui utilisera la commande
de notification
La macro denvironnement $CONTACTEMAIL :centreon$ retournera ladresse email de lutilisateur cen-
treon
La documentation complte des macros la demande est disponible cette adresse Liste des macros.

Note : Lutilisation de ces macros nest pas recommande car la recherche dune valeur dun paramtre dun objet
depuis un autre objet est consommateur en termes de ressources.

Warning : Lactivation du paramtre Activation des optimisations pour les installations de grandes tailles rend
impossible lutilisation des macros denvironnements.

Les mta-services

Dfinition

Un mta-service est un service virtuel permettant lagrgation de mtriques issues de diffrents services au travers
dune opration mathmatique. Les mta-services sont grs de la mme manire quun service cest dire quils
possdent des seuils, un processus de notification, gnrent un graphique de performance...
Exemple : Il est possible de dterminer la consommation totale de trafic WAN en additionnant au sein dun mta-
service lensemble des services supervisant le trafic WAN unitairement.

Les types de calcul Plusieurs types de calculs sont possibles sur les mtriques rcupres :
Moyenne : ralise la moyenne des donnes de performances
Somme : ralise la somme des donnes de performances
Minimum : rcupre le minimum de lensemble des donnes de performances
Maximum : rcupre le maximum de lensemble des donnes de performances

Les types de sources de donnes Le rsultat du calcul est une donne de performance (mtrique) qui gnrera un
graphique de performance. Afin de tracer au mieux le rsultat, il faut slectionner le type de source de donnes (par
dfaut GAUGE). Les types de sources de donnes disponibles sont :
Le type GAUGE enregistre une valeur instantane (temprature, humidit, CPU, ...)
Le type COUNTER enregistre une valeur incrmentale par rapport au rsultat prcdent
Le type DERIVE stockera la drive de la ligne allant de la dernire la valeur courante de la source de
donnes. Cela peut tre utile pour des jauges, par exemple, de mesurer le taux de personnes entrant ou quittant
une pice.
Le type ABSOLUTE est pour les compteurs qui se rinitialisent la lecture. Il est utilis pour les compteurs
rapides qui ont tendance dborder.
Note : Plus dinformations sur le site de RRDTools

94 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Configuration

Pour ajouter un mta-service :


1. Rendez-vous dans le menu Configuration ==> Services
2. Dans le menu de gauche, cliquez sur Mta-services
3. Cliquez sur Ajouter

Informations gnrales
Le champ Nom du Mta-Service correspond au nom du mta-service affich dans linterface.
Le champ Format de la chane de sortie (Formatage printf) correspond au message de sortie (output)
visible dans Centreon. La valeur %d correspond la valeur calcule par le mta-service
Les champs Niveau dalerte et Niveau critique correspondent respectivement aux seuils WARNING et
CRITICAL du mta-service.
Les champs Type de calcul et Type de source de donnes correspondent respectivement aux calculs et la
description de la source de donnes

6.1. Configuration 95
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Le champ Mode de slection permet de slectionner les services contenant les mtriques qui entreront dans le
calcul du mta-service.
Si loption Slectionner les services manuellement est slectionne alors les mtriques choisies seront issues de
services slectionns manuellement.
Si loption Recherche SQL est slectionne alors les services utiliss seront slectionns automatiquement par Cen-
treon via une recherche partir du champ Expression SQL rechercher de type LIKE. La mtrique utiliser sera
dans ce cas slectionner dans la liste droulante Mtrique.

Note : Plus dinformations sur le formatage PRINTF

Etat du Meta Service


Le champ Priode de contrle dfinit la priode temporelle durant laquelle lordonnanceur vrifie le statut du
mta-service.
Le champ Nombre de contrles avant validation de ltat dfinit le nombre de contrles effectuer avant de
valider le statut du mta-service : lorsque le statut est valid, une notification est envoye.
Le champ Intervalle normal de contrle est exprim en minutes. Il dfinit lintervalle entre chaque vrifica-
tion lorsque le statut du mta-service est OK.
Le champ Intervalle non-rgulier de contrle est exprim en minutes. Il dfinit lintervalle de validation du
statut non-OK du mta-service.

Notification
Le champ Notification active permet dactiver les notifications.
La liste Groupes de contacts lis permet de dfinir les groupes de contacts qui seront alerts.
Le champ Intervalle de notification est exprim en minutes et permet de dfinir lintervalle de temps entre
lenvoi de deux notifications.
Le champ Priode de notification permet de dfinir la priode de notification.
Le champ Type de notification dfinit les types de notifications envoyes.

Informations supplmentaires
La liste Modle de graphique dfinit le modle de graphique utilis par ce mta-service.
Les champs Statut et Commentaires permettent dactiver/dsactiver ou de commenter le mta-service.

Slectionner manuellement des services

Si vous avez choisi loption Slectionner les services manuellement, au sein de lcran regroupant lensemble des
mta-services :
1. Cliquez sur pour slectionner les mtriques entrant en jeu dans le calcul du mta-service. Ces mtriques
sont appeles indicateurs.
2. Cliquez sur Ajouter

Le champ Hte permet de slectionner lhte auquel le service slectionner appartient.

96 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Le champ Service permet de choisir le service (premire liste) ainsi que la mtrique au sein de ce service
(seconde liste).
Les champs Statut et Commentaires permettent dactiver/dsactiver ou de commenter lindicateur.

3. Rptez lopration jusqu avoir ajout tous les indicateurs ncessaires au calcul du mta-service.

Note : Un mta-service est considrer comme service rgulier. Il est ncessaire de gnrer la configuration de
lordonnanceur central, dexporter cette dernire puis de redmarrer lordonnanceur.

Les dpendances

Principe

Les dpendances sont utilises afin de rpondre deux principaux besoins :


Limiter lenvoi de notifications
Cibler les alertes
Les dpendances dobjets sont de deux types :
Dpendance physique entre objet : un switch de rpartition est situ en amont dun ensemble de serveurs et en
aval dun routeur
Dpendance logique entre objet : laccs un site web avec authentification LDAP dpend de ltat de lan-
nuaire LDAP lui-mme

Les dpendances physiques

Les dpendances physiques consistent prendre en compte les liens physiques entre les quipements. Ce lien ne peut
tre dfini que pour les objets de type Hte.
La configuration dune dpendance physique se droule au sein de longlet Relations dune fiche de configuration
dun hte (Configuration ==> Htes ==> Ajouter).
Il est possible de dfinir deux paramtres :
Les htes parents : signifie que les htes slectionns sont parents de cet hte (situ en amont). Si tous les htes
parents slectionns deviennent indisponibles ou injoignables alors lhte sera considr par lordonnanceur
comme injoignable lui-mme.
Les htes enfants : signifie que lhte devient parent de tous les htes enfants slectionns.
Note : Tous les parents dun hte doivent tre dans un tat non-OK pour que lhte lui-mme soit considr comme
injoignable. A partir du moment o au moins un chemin daccs (liaison de dpendance physique, alors lordonnanceur
continuera de surveiller cet hte.

Dans le cas o des relations de parents ont t dfinies entre htes superviss par des ordonnanceurs diffrents, il est
possible :
Dempcher ltablissement dune relation de parent, lors de la modification du formulaire dhte, entre deux
htes superviss par deux collecteurs diffrents.
Dautoriser ltablissement de cette relation de parent. Dans ce cas la dpendance ne sera pas gre par les
moteurs de supervision mais par Centreon Broker qui prendra en compte cette relation au sein de son moteur
de corrlation.
Pour empcher ltablissement de cette relation de parent, il est ncessaire de cocher la case Activer le mode strict
de gestion des relations de parents au sein du menu Administration ==> Options.
A linverse si cette case nest pas coche alors les liens de parent entre htes appartenant deux collecteurs diffrents
peuvent tre tablis.

6.1. Configuration 97
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Note : Ne cochez pas le filtre de notification Injoignable sur les htes ainsi que sur les contacts pour ne pas recevoir
ce type de notification.

Les dpendances logiques

Les dpendances logiques consistent mettre en place des liens logiques entre plusieurs objets de diffrents types ou
non. Par exemple : Un service est charg de superviser laccs une page web requrant une authentification base
sur un annuaire LDAP. Il est logique que si le serveur LDAP est en panne, laccs la page web sera limit voire
impossible. Dans cette situation, la notification mise ne doit ltre que pour lannuaire LDAP et non le site web.

Les htes Pour configurer une dpendance logique :


1. Rendez-vous dans le menu Configuration ==> Notifications
2. Dans le menu de gauche, sous le titre Dpendances, cliquez sur Htes
3. Cliquez sur Ajouter

Dans ce cas, nous avons deux types dhtes qui entrent en jeu : un ou des htes (appel htes matres) dont le statut
contrle lexcution et les notifications dautres htes (appels htes dpendants). Si vous utilisez Centreon Broker,
il est galement possible partir des htes matres de contrler lexcution et les notifications de services (appels
services dpendants).
Les champs Nom et Description indiquent le nom et la description de la dpendance
Le champ Relation de parent est ignorer si vous utilisez Centreon Engine. Sil est activ, alors si les liens
de dpendances de lhte matre deviennent indisponibles, la dpendance en cours de cration nest plus prise
en compte.
Le champ Critres dchec dexcution indique quels sont les statuts du ou des htes matres qui empcheront
la vrification des htes ou des services dpendants
Le champ Critres dchec de notification indique quels sont les statuts du ou des htes matres qui emp-
cheront lenvoi de notifications pour les htes ou les services dpendants
La liste Nom dhtes dfini le ou les htes matres
La liste Nom dhtes lis dfini les htes dpendants
La liste Services dpendants dfini les services dpendants
Le champ Commentaire permet de commenter la dpendance

Les services Pour ajouter une dpendance au niveau des services :


1. Rendez-vous dans le menu Configuration ==> Notifications

98 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
2. Dans le menu de gauche, sous le titre Dpendances, cliquez sur Services
3. Cliquez sur Ajouter

Dans ce cas, nous avons deux entits qui entrent en jeu : les services (dits matres) qui contrlent lexcution et les
notifications dautres services (dits dpendants). Si vous utilisez Centreon Broker, il est galement possible de contrler
lexcution et les notifications dautres htes.
Les champs Nom et Description indiquent le nom et la description de la dpendance
Le champ Relation de parent est ignorer si vous utilisez Centreon Engine. Sil est activ, alors si les liens
de dpendances du service matre deviennent indisponibles la dpendance en cours de cration nest plus prise
en compte.
Le champ Critres dchec dexcution indique quels sont les statuts du (ou des) service(s) matre(s) qui
empchera(ront) la vrification des htes ou des services dpendants
Le champ Critres dchec de notification indique quels sont les statuts du (ou des) service(s) matre(s) qui
empchera(ront) lenvoi de notifications pour les htes ou les services dpendants
La liste Services dfinie le ou les services matres
La liste Services dpendants dfinie les services dpendants
La liste Htes dpendants dfinie les htes dpendants
Le champ Commentaire permet de commenter la dpendance

Les groupes dhtes Pour ajouter une dpendance au niveau des groupes dhtes :
1. Rendez-vous dans le menu Configuration ==> Notifications
2. Dans le menu de gauche, sous le titre Dpendances, cliquez sur Groupes dhtes
3. Cliquez sur Ajouter

6.1. Configuration 99
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Deux types de groupes dhtes : Un groupe dhtes est dit matre sil contrle lexcution et la notification dautres
groupes dhtes (dit dpendants).
Les champs Nom et Description indiquent le nom et la description de la dpendance
Le champ Relation de parent est ignorer si vous utilisez Centreon Engine. Sil est activ, alors si les liens
de dpendances du groupe dhte matre deviennent indisponibles la dpendance en cours de cration nest
plus prise en compte.
Le champ Critres dchec dexcution indique quels sont les statuts du ou des groupes dhtes matres qui
empcheront la vrification des groupes dhtes dpendants
Le champ Critres dchec de notification indique quels sont les statuts du ou des htes matres qui emp-
cheront lenvoi de notifications pour des groupes dhtes dpendants
La liste Nom du groupe dhte dfinie le ou les groupes dhtes matres
La liste Nom des groupes dhtes lis dfinie le ou les groupes dhtes dpendants
Le champ Commentaire permet de commenter la dpendance

Les groupes de services Pour ajouter une dpendance au niveau des groupes de services :
1. Rendez-vous dans le menu Configuration ==> Notifications
2. Dans le menu de gauche, sous le titre Dpendances, cliquez sur Groupes de services
3. Cliquez sur Ajouter

100 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Deux types de groupes de services : Un groupe de services est dit matre sil contrle lexcution et la notification
dautres groupes de services (dit dpendants).
Les champs Nom et Description indiquent le nom et la description de la dpendance
Le champ Relation de parent est ignorer si vous utilisez Centreon Engine. Sil est activ, alors si les liens
de dpendances du groupe de service matre deviennent indisponibles la dpendance en cours de cration nest
plus prise en compte.
Le champ Critres dchec dexcution indique quels sont les statuts du ou des groupes de services matres
qui empcheront la vrification des groupes de services dpendants
Le champ Critres dchec de notification indique quels sont les statuts du ou des htes matres qui emp-
cheront lenvoi de notifications pour des groupes de services dpendants
La liste Nom des groupes de services dfinie le ou les groupes de services matres
La liste Nom des groupes de services lis dfinie le ou les groupes de services dpendants
Le champ Commentaire permet de commenter la dpendance

Les mta-services Pour ajouter une dpendance au niveau des mta-services :


1. Rendez-vous dans le menu Configuration ==> Notifications
2. Dans le menu de gauche, sous le titre Dpendances, cliquez sur Mta-services
3. Cliquez sur Ajouter
Deux types de mta-services : Un mta-service est dit matre sil contrle lexcution et la notification dautres mta-
services (dit dpendants).
Les champs Nom et Description indiquent le nom et la description de la dpendance
Le champ Relation de parent est ignorer si vous utilisez Centreon Engine. Sil est activ, alors si les liens
de dpendances du mta-service matre deviennent indisponibles la dpendance en cours de cration nest plus
prise en compte.
Le champ Critres dchec dexcution indique quels sont les statuts du ou des mta-services matres qui
empcheront la vrification des mta-services dpendants
Le champ Critres dchec de notification indique quels sont les statuts du ou des mta-services qui emp-
cheront lenvoi de notifications pour des mta-services dpendants
La liste Nom du mta-service dfinie le (ou les) mta-service(s) matre(s)
La liste Nom des mta-services lis dfinie le (ou les) mta-service(s) dpendant(s)
Le champ Commentaire permet de commenter la dpendance

Les escalades de notifications

Dfinition

Dune manire gnrale, en cas de dclenchement dune alerte, une notification permet de contacter un ou plusieurs
contacts (ou groupes de contacts). De mme, il est possible denvoyer plusieurs notifications suivant un intervalle de
temps rgulier.
Une escalade de notifications permet de contacter diffrents groupes de contacts au fil des notifications envoyes ou de
changer le moyen de notification (remplacer les mails par un SMS). La dfinition dune escalade de notification pour
un hte, un groupe dhte, un service, un groupe de services ou un mta-service crase la configuration classique des
notifications pour cet objet.
Exemple : Un service A est paramtr pour envoyer des notifications un groupe de contacts A en cas de statut
non-OK. Ces notifications sont envoyes toutes les 5 minutes. Si pendant un certain nombre de notifications envoyes
le statut du service est toujours en non-OK, il est possible de contacter les individus du groupe de contacts B etc...
Les escalades de notifications sont pratiques dans les cas o il existe dans une socit une quipe de support de niveau
1, niveau 2, niveau 3... Lorsquun problme survient lquipe de support niveau 1 est contacte. Si pendant un certain
temps lquipe niveau 1 na pas russi rsoudre le problme, lquipe niveau 2 est avertie etc...

6.1. Configuration 101


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Configuration

Pour ajouter une escalade de notification :


1. Rendez-vous dans le menu Configuration ==> Notifications
2. Cliquez sur Ajouter

Les champs Nom descalade et Alias permettent de dfinir un nom et un alias lescalade de notifications.
Le champ Premire notification permet de choisir le numro de la notification partir de laquelle le groupe
de contacts sera averti.
Le champ Dernire notification permet de choisir le dernier numro de la notification pour lequel ce groupe
de contacts sera averti. Si le groupe de contacts est le dernier niveau de lescalade. La valeur de ce champ est
0.
Le champ Intervalle de notification dfinit lintervalle de notifications entre chaque alerte.
Le champ Priode descalade dfinit la priode temporelle de notifications.
Les champs Options descalade des htes et Options descalade des services dfinissent les statuts dhtes
et de services pour lesquels lescalade est utilise.
La liste Groupes de contacts lis dfinit le groupe de contacts contacter lors du dclenchement de lescalade.
Le champ Commentaire permet de commenter lescalade.

Application de lescalade Pour slectionner les diffrents objets qui seront concerns par cette escalade, les onglets
Escalade des htes, Escalade des services, Escalade des groupes dhtes, Escalade des mta-services, Escalade
des groupes de services permettent de choisir les objets sur lesquels les escalades sont appliques.

Les temps darrts rcurrents

Dfinition

Un temps darrt est une priode de temps durant laquelle les notifications sont dsactives pour un hte ou un service.
Les temps darrts sont pratiques lors doprations de maintenance sur un hte ou un service : ils permettent dviter
de recevoir des alertes de type faux-positif.
Les temps darrts rcurrents sont des temps darrts qui reviennent de manire rptitive.
Exemple : Une sauvegarde des machines virtuelles est effectue tous les jours de 20h00 minuit. Ce type de sauvegarde
a tendance saturer lutilisation CPU de toutes les machines virtuelles. Il est ncessaire de programmer des temps
darrts rcurrents sur les services concerns afin dviter de recevoir des notifications de 20h00 minuit.

102 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Note : Les temps darrts sont pris en comptes dans le calcul du taux de disponibilit de la ressource dans le menu
Tableau de bord.

Les types de temps darrts

Il existe deux types de temps darrts :


Les temps darrts fixe : Cest dire que le temps darrt a lieu exactement pendant la priode de temps dfinie.
Les temps darrts flexible : Cest dire que si pendant la priode de temps dfinie le service ou lhte retourne
un statut non-OK alors le temps darrt dure un certain nombre de secondes ( dfinir dans le formulaire)
partir du moment o lhte ou le statut a retourn un statut non-OK.

Configuration

Pour ajouter un temps darrt rcurrent :


1. Rendez-vous dans le menu Configuration ==> Htes (ou Services suivant le type dobjet sur lequel raliser
le temps darrt)
2. Dans le menu de gauche, cliquez sur Temps darrt
3. Cliquez sur Ajouter

Configuration des temps darrts


Les champs Nom et Description permettent de donner un nom et de dcrire le temps darrt rcurrent.
Le champ Activer permet dactiver ou de dsactiver le temps darrt.
Le champ Priode permet de dfinir une ou plusieurs priodes de temps darrt rcurrent. Pour ajouter une
priode, cliquez sur le symbole .
Il est possible de choisir trois types de priodes :
Hebdomadaire : Permet de choisir les jours de semaine
Mensuel : Permet de choisir les jours dans un mois

6.1. Configuration 103


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Date spcifique : Permet de choisir des dates spcifiques
Le champ Jours dfinit le (ou les) jour(s) concern(s).
Le champ Priode de temps contient la priode de temps concerne (exprime en HH :MM - HH :MM).
Le champ Type de temps darrt dfinit le type de temps darrt souhait.
Note : Il est possible de combiner plusieurs types de priodes au sein dun seul temps darrt.

Relations
La liste Li aux htes permet de choisir le ou les htes concerns par le temps darrt rcurrent.
Si un groupe dhte est choisi avec la liste Li avec le groupe dhtes tous les htes appartenant ce groupe
sont concerns par le temps darrt rcurrent.
La liste Li avec les services permet de choisir le ou les services concerns par le temps darrt rcurrent.
Si un groupe de services est choisi avec la liste Linked with Service Groups tous les services appartenant
ce groupe sont concerns par le temps darrt rcurrent.

Les traps SNMP

Dfinition

Les traps SNMP sont des informations envoyes en utilisant le protocole SNMP depuis un quipement supervis vers
un serveur de supervision (satellite). Ces informations contiennent plusieurs attributs dont :
Adresse de lquipement qui a envoy linformation.
LOID racine (Object Identifier) correspond lidentifiant du message reu.
Le message envoy au travers du trap SNMP qui correspond un ensemble de paramtres (1 N).
Afin de pouvoir interprter lvnement reu, le serveur de supervision doit possder dans sa configuration le nces-
saire pour traduire lvnement. Pour cela, il doit disposer dune base de donnes contenant les OID ainsi que leurs
descriptions, cest ce quon appelle les fichiers MIB. Il existe deux types de MIB :
Les MIB standards qui utilisent des OID standardiss et qui sont implments par de nombreux constructeurs
sur leurs quipements.
Les MIB constructeurs qui sont propres chacun et souvent chaque modle dquipement.
Les MIB constructeurs sont rcuprer auprs des constructeurs de matriels. Centreon permet de stocker la dfinition
des traps SNMP dans sa base de donnes MySQL. Les traps peuvent ensuite tre relis des services passifs via
longlet Relations de la dfinition dun service.

Architecture

Avec Centreon 2.5.x, la gestion des traps SNMP a t revue en profondeur par rapport aux versions prcdentes :
les processus snmptt et centtraphandler ont t fusionns au sein dun unique processus centreontrapd.
le processus snmptthandler est remplac par le processus centreontrapdforward.
les satellites peuvent disposer de leur propre dfinition de Trap SNMP au sein dune base ddie SQLite
supprimant ainsi laccs au serveur MySQL Centreon.

Traitement dun trap par le serveur central Voici le processus de traitement dun trap SNMP avec Centreon 2.5.x :
1. snmptrapd est le service permettant de rcuprer les traps SNMP envoys par les quipements (par dfaut il
coute sur le port UDP 162).
2. Une fois le trap SNMP reu, il est envoy au script centreontrapdforward qui va crire les informations reues
dans un dossier tampon (par dfaut : /var/spool/centreontrapd/).
3. Le service centreontrapd lit les informations reues dans le dossier tampon et interprte les diffrents traps
reus en vrifiant dans la base de donnes Centreon les actions entreprendre pour traiter ces vnements.

104 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
4. Le service centreontrapd transmet les informations lordonnanceur ou au service centcore (pour trans-
mettre les informations un ordonnanceur distant) qui se charge de modifier le statut et les informations
associes au service auquel est li le trap SNMP.

Traitement dun trap par un serveur satellite Afin de garder une copie de la configuration des traps SNMP sur
chaque serveur satellite, une base de donnes SQLite est charge de garder en cache les informations de traps contenues
dans la base de donnes MySQL. Cette base de donnes SQLite est automatiquement gnre par le serveur Central.
Voici le processus de traitement dun trap SNMP avec Centreon 2.5.x :
1. snmptrapd est le service permettant de rcuprer les traps SNMP envoyes par les quipements (par dfaut il
coute sur le port UDP 162).
2. Une fois le trap SNMP reu, il est envoy au script centreontrapdforward qui va crire les informations reues
dans un dossier tampon (par dfaut : /var/spool/centreontrapd/).
3. Le service centreontrapd lit les informations reues dans le dossier tampon et interprte les diffrentes traps
reus en vrifiant dans la base de donnes SQLite les actions entreprendre pour traiter les traps reus.
4. Le service centreontrapd transmet les informations lordonnanceur qui se charge de modifier le statut et les
informations associes au service dont est li le trap SNMP.

6.1. Configuration 105


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Note : Le processus Centcore la charge, comme pour lexport de configuration de la supervision, de copier la base
SQLite sur le collecteur distant.

Configuration des services

Snmptrapd Afin dappeler le script centreontrapdfoward, le fichier /etc/snmp/snmptrapd.conf doit contenir les
lignes suivantes :
disableAuthorization yes
traphandle default su -l centreon -c "/usr/share/centreon/bin/centreontrapdforward"

Vous pouvez optimiser les performances de snmptrapd en utilisant les options suivantes :
-On nessaye pas de transformer les OIDs
-t ne log pas les traps au serveur syslog
-n nessaye pas de transformer les adresses IP en nom dhtes
Ces options peuvent tre modifies dans le fichier /etc/sysconfig/snmptrapd
OPTIONS="-On -d -t -n -p /var/run/snmptrapd.pid"

Il est galement possible de placer le dossier tampon snmptrapd en mmoire vive. Pour cela, ajoutez la ligne suivante
dans le fichier /etc/fstab :
tmpfs /var/run/snmpd tmpfs defaults,size=128m 0 0

Centreontrapdforward Pour modifier le dossier tampon vers lequel les informations seront crites, modifiez le
fichier de configuration /etc/centreon/centreontrapd.pm :

106 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
our %centreontrapd_config = (
spool_directory => /var/spool/centreontrapd/,
);

1;

Vous pouvez galement mapper le dossier dans le cache en mmoire vive, en ajoutant la ligne suivante dans le fichier
/etc/fstab :
tmpfs /var/spool/centreontrapd tmpfs defaults,size=512m 0 0

Centreontrapd Deux fichiers de configuration existent pour Centreontrapd :


/etc/centreon/conf.pm contient les informations de connexion la base de donnes MySQL
/etc/centreon/centreontrapd.pm contient la configuration du service centreontrapd

Configuration du service Au sein du fichier /etc/centreon/centreontrapd.pm il est conseill de modifier unique-


ment trois paramtres (si ncessaire) :
Si loption mode est dfinie 1 alors centreontrapd fonctionne sur un serveur satellite, sinon il fonctionne sur
un serveur central (Centreon).
Loption centreon_user permet de modifier lutilisateur qui excute les actions.
Loption spool_directory permet de modifier le dossier tampon lire (si vous lavez modifi dans le fichier de
configuration de centreontrapdforward).
Voici un exemple de configuration possible du fichier /etc/centreon/centreontrapd.pm (le fichier de configuration
peut tre modifie avec -config-extra = xxx) :
our %centreontrapd_config = (
# Temps en secondes avant darrter brutalement les sous processus
timeout_end => 30,
spool_directory => "/var/spool/centreontrapd/",
# Dlai entre deux contrles du rpertoire de "spool" pour dtecter de nouveaux fichiers traite
sleep => 2,
# 1 = utiliser la date et heure du traitement e lvnement par centreontrapdforward
use_trap_time => 1,
net_snmp_perl_enable => 1,
mibs_environment => ,
remove_backslash_from_quotes => 1,
dns_enable => 0,
# Sparateur appliquer lors de la substitution des arguments
separator => ,
strip_domain => 0,
strip_domain_list => [],
duplicate_trap_window => 1,
date_format => "",
time_format => "",
date_time_format => "",
# Utiliser le cache dOID interne de la base de donnes
cache_unknown_traps_enable => 1,
# Temps en secondes avant de recharger le cache
cache_unknown_traps_retention => 600,
# 0 = central, 1 = poller
mode => 0,
cmd_timeout => 10,
centreon_user => "centreon",
# 0 => continuer en cas derreur MySQL | 1 => ne pas continuer le traitement (blocage) en cas de
policy_trap => 1,

6.1. Configuration 107


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
# Enregistrement des journaux en base de donnes
log_trap_db => 0,
log_transaction_request_max => 500,
log_transaction_timeout => 10,
log_purge_time => 600
);

1;

Configuration de la connexion la base de donnes Il est possible de configurer le fichier /etc/centreon/conf.pm


de deux manires :
Conserver la connexion au serveur de base de donnes MySQL (ncessaire pour le serveur central et possible
pour les serveurs satellites). Contenu du fichier :
$centreon_config = {
VarLib => "/var/lib/centreon",
CentreonDir => "/usr/share/centreon/",
"centreon_db" => "centreon",
"centstorage_db" => "centreon_storage",
"db_host" => "localhost:3306",
"db_user" => "centreon",
"db_passwd" => "centreon"
};

1;

Connecter centreontrapd la base de donnes SQLite locale. Contenu du fichier :

$centreon_config = {
VarLib => "/var/lib/centreon",
CentreonDir => "/usr/share/centreon/",
"centreon_db" => "dbname=/etc/snmp/centreon_traps/centreontrapd.sdb",
"centstorage_db" => "dbname=/etc/snmp/centreon_traps/centreontrapd.sdb",
"db_host" => "",
"db_user" => "",
"db_passwd" => "",
"db_type" => SQLite,
};

1;

Configuration Centreon

Ajouter un constructeur Au sein de Centreon, les OIDs racines des traps SNMP sont classs par constructeur. Pour
ajouter un constructeur :
1. Rendez-vous dans le menu Configuration ==> Traps SNMP
2. Dans le menu de gauche, cliquez sur Constructeur
3. Cliquez sur Ajouter

108 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Les champs Nom du constructeur et Alias dfinissent le nom et lalias du constructeur
Le champ Description fournit une indication sur le constructeur

Importation des MIB Il est galement possible dimporter des OIDs partir des MIBs fournies par les construc-
teurs. Pour cela :
1. Rendez-vous dans le menu Configuration ==> Traps SNMP
2. Dans le menu de gauche, cliquez sur MIBs

La liste Constructeur permet de choisir le constructeur auquel appartient la MIB que vous importez
Le champ Fichier (mib) permet de charger la MIB

3. Cliquez sur Importer

Note : Les dpendances des MIBS que vous importez doivent tre prsentes dans le dossier /usr/share/snmp/mibs.
Une fois limport termin, supprimez les dpendances pralablement copies.

Note : Une fois les traps SNMP imports, il est ncessaire de vrifier le statut Supervision associ aux vnements.
Par dfaut celui-ci sera OK.

6.1. Configuration 109


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Configuration manuelle des traps

Configuration basique Il est galement possible de crer manuellement des dfinitions de trap SNMP :
1. Rendez-vous dans le menu Configuration ==> Traps SNMP
2. Cliquez sur Ajouter

Le champ Nom du Trap dfinit le nom du trap.


Le champ OID dfinit lOID racine recevoir pour que ce trap soit considr comme reu.
Le champ Nom du constructeur dfinit le nom du constructeur auquel appartient le trap slectionner dans
la liste droulante.
Le champ Message de sortie contient le message afficher en cas de rception dun trap contenant lOID
configur au-dessus.
Note : Par dfaut, la MIB contient la dfinition de cette variable (Exemple : Link up on interface $2. State : $4., ici
$2 sera remplac par le 2me argument reu dans lvnement.). Dans le cas contraire, la variable $* permet dafficher
lensemble des arguments contenu dans le trap.

Note : Il est possible de construire soit mme le message de sortie. Pour cela, utilisez la MIB afin de connaitre les
arguments qui seront prsents dans le corps de lvnement et rcuprer les arguments avec les variables $n. Chaque
argument tant identifi par un OID, il est possible dutiliser directement cet OID afin de le placer dans le message de
sortie sans connaitre sa position via la variable @{OID}.

Le champ Statut par dfaut dfinit le statut supervision par dfaut du service en cas de rception du trap.
Le Si la case Envoyer le rsultat est coche alors le rsultat est soumis au moteur de supervision.
Le champ Commentaires (dernier champ) contient par dfaut le commentaire constructeur du trap SNMP. La
plupart du temps, ce commentaire indique la liste des variables contenues dans le trap SNMP (voir chapitre
suivant sur la configuration avance).

110 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Configuration avance des traps Il est possible de dtermine le statut dun service partir de la valeur dun para-
mtre du trap SNMP plutt qu partir de lOID racine. Anciennement les constructeurs dfinissaient un trap SNMP
(OID racine) par type dvnement envoyer (linkUp / linkDown). Aujourdhui, la tendance est de dfinir un OID
racine par catgorie dvnements puis de dfinir lvnement via un ensemble de paramtres.

Pour cela, il est possible de dfinir des Rgles de correspondance avances en cliquant sur le bouton et de crer
autant de rgles que ncessaire. Pour chaque rgle, dfinir les paramtres :
Chaine dfinit llment sur lequel sera appliqu la recherche (@OUTPUT@ dfini lensemble du Message
de sortie traduit).
Expression rgulire dfinit la recherche de type REGEXP appliquer.
Statut dfinit le statut du service en cas de concordance.
Note : Lordre est important dans les rgles de correspondance car le processus sarrtera la premire rgle dont la
correspondance est assure.

Le champ Ne pas envoyer le rsultat si pas de correspondance avre dsactive lenvoi des informations au
moteur dordonnancement si aucune correspondance avec une rgle nest valide.
Si la case Reprogrammer les services associs est coche alors le prochain contrle du service, qui doit tre
actif, sera reprogramm au plus tt aprs la rception du trap.
Si la case Excuter une commande spciale est coche alors la commande dfinie dans Commande spciale
est excute.

Configuration trs avance des traps Longlet Avanc permet de configurer le comportement dexcution du pro-
cessus de traitement des traps SNMP lors de la rception de ce dernier.

Activer le routage permet dactiver le routage des informations.


Commande de routage permet de dfinir la commande utiliser pour le routage.
Avant dexcuter le traitement de lvnement (traduction du Message de sortie), il est possible dexcuter une com-
mande appele PREEXEC. Pour cela, il est possible de dfinir des Commande PREEXEC (de type SNMPTT) en
cliquant sur le bouton et de crer autant de rgles que ncessaire.
Dfinition de la commande PREEXEC dfinit la commande excuter.
Voici un exemple dutilisation avec le trap linkUP : Pour un quipement Cisco, $2 == ifDescr contient le numro
de port de linterface (GigabitEthernet0/1 par exemple). La meilleure description de linterface est contenue dans le
champ SNMP ifAlias.
La commande suivante permet de rcuprer cette valeur
snmpget -v 2c -Ovq -c <community> <cisco switch> ifAlias.$1

Pour utiliser le rsultat de la commande PREEXEC dans le Message de sortie, il faut utiliser la variable $p{n} o n
correspond lordre de dfinition de la commande. Exemple

6.1. Configuration 111


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
"Interface $2 ( $p1 ) linkUP. State: $4." "$CA"

Le rsultat sera de la forme : Interface GigabitEthernet0/1 ( SERVEUR NAS ) linkUP. State : up


Le champ Enregistrer les informations des traps SNMP en base de donnes permet de journaliser ou non
les traps en base de donnes.
Le champ Temps dexcution maximum exprim en secondes, permet de dfinir le temps maximum de
traitement de lvnement y compris les commandes de prtraitement (PREEXEC) ainsi que celles de post-
traitement (commande spciale).
Le champ Intervalle dexcution exprim en secondes, permet de dfinir le temps minimum dattente entre
deux traitements dun vnement.
Le champ Type dexcution permet dactiver lIntervalle dexcution en dfinissant les conditions Par OID
racine, Par la combinaison OID racine et hte ou de dsactiver cette restriction Aucune.
Le champ Mthode dexcution permet de dfinir si lors de la rception de plusieurs mmes vnements (OID
racine). Lexcution est soit Squentielle, soit Parallle.

Les variables

Lors de lajout dune rgle de correspondance ou de lexcution dune commande spciale il est possible de passer des
arguments aux champs Chaine ou Commande spciale. Ces arguments sont lists dans le tableau ci-dessous :
Nom de la variable Description
@{NUMERIC_OID} Rcupration de la valeur dun argument via son OID, exemple
@{.1.3.6.1.4.1.9.9.43.1.1.1}
$1, $2... Rcupration de la valeur dun argument via son ordre dapparition
$p1, $p2,... Valeur de la commande PREEXEC ($p1 = pour la premire commande, $p2 pour la
seconde, ...)
$* Tous les arguments spars par un espace
@HOSTNAME@ Nom dhte (dans Centreon) auquel le service est rattach
@HOSTADDRESS@ Adresse IP de lhte ayant envoy le trap
@HOSTADDRESS2@ Nom DNS de lhte ayant envoy le trap (si le serveur narrive pas effectuer une
rsolution DNS inverse alors on rcupre ladresse IP
@SERVICEDESC@ Nom du service
@TRAPOUTPUT@ ou Message envoy par lexpditeur du trap
@OUTPUT@
@STATUS@ Statut du service
@SEVERITYNAME@ Nom du niveau de criticit de lvnement
@SEVERITYLEVEL@ Niveau de criticit de lvnement
@TIME@ Heure de rception du trap
@POLLERID@ ID du collecteur ayant reu le trap
@POLLERAD- Adresse IP du collecteur ayant reu le trap
DRESS@
@CMDFILE@ Chemin vers le fichier de commande de CentCore (central) ou de Centreon Engine
(collecteur)
De plus, il existe des variables spciales pouvant tre utilises dans la section Paramtres de routage au niveau de la
Commande de routage si loption Activer le routage est slectionne :
Nom de la variable Description
@GETHOST- Rsolution DNS inverse permettant de connaitre le nom DNS partir de ladresse IP
BYADDR($1)@ (127.0.0.1 -> localhost)
@GETHOSTBY- Rsolution DNS permettant de connaitre ladresse IP partir du nom DNS (localhost
NAME($1)@ -> 127.0.0.1)

112 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Appliquer les changements

Pour pouvoir exporter les OID prsents en base de donnes en fichier de configuration pour centreontrapd, suivez la
procdure suivante :
1. Rendez-vous dans le menu Configuration ==> Traps SNMP
2. Dans le menu de gauche, cliquez sur Gnrer
3. Slectionnez le collecteur vers lequel vous souhaitez exporter les fichiers de configuration
4. Cochez Gnrer la base de donnes des traps et Appliquer la configuration
5. Dans la liste droulante Envoyer le signal (prfrez loption Recharger)
6. Cliquez sur le bouton Gnrer

6.1.11 Collecteur de supervision

Les serveurs satellites

Prsentation

Les serveurs satellites (aussi appels collecteurs) sont des serveurs de supervision quips dun ordonnanceur et dun
module broker. Ils sont chargs de superviser les quipements et de renvoyer les rsultats vers le serveur Centreon
central (pour la visualisation des rsultats...).

Installation

Le processus dinstallation est identique celui dun serveur Centreon central ralis partir du fichier iso de CES.

Note : Rfrez-vous la documentation premier pas avec CES 3.0

A la question Which server type would you like to install ? il faut choisir loption Poller server.

6.1. Configuration 113


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Configuration de lordonnanceur

Une fois linstallation ralise, il faut intgrer ce satellite dans la configuration Centreon.
1. Rendez-vous dans le menu Configuration ==> Centreon
2. Dupliquez le fichier de configuration du serveur Central et ditez-le
3. Modifiez les paramtres suivants, puis sauvegardez :
Changez le Nom du collecteur.
Entrez ladresse IP du collecteur dans le champ Adresse IP.
Activez le collecteur en cliquant sur Activ dans le champ Statut.

114 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Maintenant, il est ncessaire de gnrer un fichier de configuration pour lordonnanceur Centreon Engine :
1. Rendez-vous dans le menu Configuration ==> Moteurs de supervision
2. Dans le menu de gauche, cliquez sur main.cfg
3. Dupliquez le fichier de configuration du collecteur Central et modifiez-le
4. Modifiez les paramtres suivants, puis sauvegardez :
Changez le Nom de la configuration.
Activez le fichier de configuration de lordonnanceur en cliquant sur Activ dans le champ Statut.
Choisissez le nouveau collecteur dans le champ Collecteur li.

6.1. Configuration 115


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Dans longlet Donnes - Champ Multiple module broker modifiez le nom du fichier de configuration de
Centreon Broker central-module.xml. Par exemple : poller1-module.xml.

Configuration de Centreon Broker

Il est ncessaire de gnrer un fichier de configuration pour le broker Centreon Broker :


1. Rendez-vous dans le menu Configuration ==> Centreon
2. Dans le menu de gauche, cliquez sur Configuration (en dessous de Centreon Broker)
3. Dupliquez le fichier de configuration du module de votre serveur central et ditez-le
4. Modifiez les paramtres suivants, puis sauvegardez :
Changez le Nom de la configuration.
Modifiez le Nom du fichier de configuration qui doit correspondre au nom du fichier xml dfinit dans le
fichier de configuration de lordonnanceur.
Activez le fichier de configuration en cliquant sur Activ dans le champ Statut.

116 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Modifiez le champ Collecteur en slectionnant votre nouveau collecteur.

Dans longlet Output, modifiez le champ Hte distant en entrant ladresse IP du serveur contenant votre base
MySQL (dans notre cas le serveur central).

Configuration de Centreontrapd

Il est ncessaire de modifier les fichiers de configuration de Centreontrapd afin que le service puisse interroger la base
de donnes SQLite (voir chapitre Les traps SNMP).

Synchronisation des sondes

Vous pouvez synchroniser les sondes entre votre serveur Central et vos serveurs satellites en utilisant lutilitaire rsync.

Warning : Ne pas raliser cette action si vos sondes dpendent de librairies tierces devant au pralable tre
installes.

Echange de cls SSH

Afin que le serveur central puisse exporter les fichiers de configuration du moteur de supervision, il est ncessaire
deffectuer un change de cl SSH entre le serveur central et le nouveau serveur satellite.
Sur le serveur satellite :

6.1. Configuration 117


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
1. Connectez-vous en tant que root
2. Modifiez le mot de passe de lutilisateur centreon :
# passwd centreon

Sur le serveur central :


1. Connectez-vous en tant que centreon
# su - centreon

2. Si vous navez pas dj gnr une paire de cl publique/prive, tapez la commande suivante (laissez les options
par dfaut) :

$ ssh-keygen

3. Puis exportez votre cl SSH vers le serveur satellite :

$ ssh-copy-id -i /var/spool/centreon/.ssh/id_rsa.pub centreon@[ADRESSE_IP_DU_POLLER]

4. Vrifiez que vous pouvez vous connecter depuis le serveur central vers le serveur satellite en tant quutilisateur
centreon. Vous pouvez utiliser la commande :

$ ssh centreon@[ADRESSE_IP_DU_POLLER]

Exportation de la configuration

Il ne reste plus qu exporter la configuration afin de vrifier que linstallation du serveur satellite sest bien droule.

Note : Rfrez-vous la documentation Dployer la configuration

Configuration de Centreon Broker via lassistant

Vous pouvez crer des configurations de Centreon Broker via lassistant de configuration :

Trois choix sont disponibles :

118 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Configuration avec un serveur central seul

Note : Schma dun serveur central seul

6.1. Configuration 119


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
1. Entrez un nom pour la configuration

120 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Configuration du serveur central pour une architecture distribue

Note : Schma dune architecture distribue

6.1. Configuration 121


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
1. Entrez un nom pour la configuration

Configuration dun collecteur pour une architecture distribue

Warning : Pour cette configuration vous devez au pralable avoir install un collecteur.

122 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Note : Schma dune architecture distribue

1. Entrez un nom pour la configuration


2. Slectionnez un collecteur
3. Entrez ladresse IP ou le nom DNS FQDN du serveur central

6.1. Configuration 123


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
6.1.12 Dployer une configuration

Procdure

Lors de la cration/suppression/modification des objets via linterface de configuration, les changements effectus ne
sont pas appliqus de manire automatique aux serveurs de supervision. Afin de pouvoir appliquer les modifications
effectues, il est ncessaire de suivre la procdure suivante ci-dessous.

Note : Celle-ci doit toujours tre droule en 2 tapes.

Premire tape

1. Rendez-vous dans le menu Configuration ==> Moteurs de supervision ==> Gnrer


2. Slectionner le Collecteur dans la liste droulant.
3. Cochez les cases Gnrer les fichiers de configuration et Lancer le dbogage du moteur de supervision
(-v)
4. Cliquez sur Exporter

124 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Vrifier quaucune erreur napparait lors de la gnration.

Note : Si cela est le cas, corriger les erreurs et refaire la premire tape.

Deuxime tape

1. Dcochez les cases Gnrer les fichiers de configuration et Lancer le dbogage du moteur de supervision
(-v)
2. Puis cochez les cases Dplacer les fichiers gnrs ainsi que Redmarrer lordonnanceur
3. Cliquez sur Exporter

Note : Loption Commande excute post-gnration permet de demander lexcution de la commande post-
gnration paramtre au niveau de la configuration de lordonnanceur.

6.1. Configuration 125


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Explications

Au sein de la page de gnration de la configuration, plusieurs options sont disponibles :


1. Gnrer les fichiers de configuration : Gnre les fichiers de configuration de lordonnanceur dans un rper-
toire temporaire. Cette configuration est gnre partir des objets configurs via linterface web
2. Lancer le dbogage du moteur de supervision (-v) : Permet lordonnanceur de vrifier la configuration
gnre
3. Dplacer les fichiers gnrs : Dplace les fichiers de configuration du rpertoire temporaire vers le rpertoire
de lordonnanceur
4. Redmarrer lordonnanceur : Redmarre lordonnanceur afin dappliquer les nouveaux fichiers de configu-
ration
5. Commande excute post-gnration : Excute la commande post-gnration paramtre au niveau de la
configuration de lordonnanceur

6.2 Supervision

6.2.1 Les vues personnalises

Prsentation

Les vues personnalises permettent chaque utilisateur davoir sa propre vue de la supervision. Une vue peut contenir
de 1 3 colonnes. Chaque colonne peut contenir des widgets.
Un widget est un module permettant de visualiser certaines informations sur certains objets. Il est possible dinsrer
au sein dune mme vue plusieurs widgets de diffrents types. Par dfaut, Centreon propose des widgets permettant
dobtenir des informations sur : les htes, les groupes dhtes, les services, les groupes de services. Enfin, un dernier
widget permet de visualiser les graphiques de performances en temps rel.

Gestion des vues

Toutes les manipulations ci-dessous se droulent au sein de la page Accueil ==> Vues personnalises. Cette page est
galement la premire page affiche lors de la connexion dun utilisateur au sein de Centreon.

Ajouter une vue

Pour ajouter une vue, cliquez sur Ajouter une vue.

Le champ Nom de la vue indique le nom de la vue qui sera visible par lutilisateur
Le champ Mise en page permet de choisir le nombre de colonne de la vue
Pour modifier une vue existante, cliquez sur Editer une vue.

Note : La diminution du nombre de colonnes enlve les widgets associes la colonne.

126 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Partager une vue

Il est possible de partager une vue existante avec un ou plusieurs utilisateurs. Pour cela, cliquez sur Partager la vue.
Si le champ Verrouille est dfinit Oui, alors les autres utilisateurs ne pourront pas modifier la vue
Le champ Liste des utilisateurs permet de dfinir les utilisateurs avec lesquels est partage la vue
Le champ Liste des groupes utilisateur permet de dfinir les groupes dutilisateurs avec lesquels est partage
la vue

Insrer un widget

Pour ajouter un widget, cliquez sur Ajouter un widget.

Le champ Titre du widget permet de dfinir un nom pour son widget


Choisissez dans le tableau en dessous le type de widget que vous souhaitez ajouter

Personnaliser son widget

Il est possible de dplacer un widget en faisant un drag-and-drop depuis la barre de titre. Pour rduire un widget,
cliquez sur . Par dfaut, les informations contenues au sein du widget sont rafrachis de manire rgulire. Pour les
rafrachir manuellement, cliquez sur .

Pour personnaliser son widget, cliquez sur .

Supprimer un widget

Il est possible de supprimer le widget en cliquant sur .

Dtail des widgets

Les paragraphes ci-dessous dtaillent les attributs de chaque widget aprs avoir cliqu sur .

Le widget dhtes

Filters
Le champ Host Name Search permet de faire une recherche sur un ou plusieurs noms dhtes

6.2. Supervision 127


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Si la case Display Up est coche, les htes en statut UP seront affichs
Si la case Display Down est coche, les htes en statut DOWN seront affichs
Si la case Display Unreachable est coche, les htes en statut UNREACHABLE seront affichs
La liste Acknowledgement Filter permet dafficher les htes acquitts ou non acquitts (si la liste est vide, les
deux types dhtes seront affichs)
La liste Downtime Filter permet dafficher les htes qui subissent un temps darrt ou non (si la liste est vide,
les deux types dhtes seront affichs)
La liste State Type permet dafficher les htes en tat SOFT ou HARD (si la liste est vide, les deux types
dhtes seront affichs)
La liste Hostgroup permet dafficher les htes appartenant un certain groupe dhtes (si la liste est vide, tous
les htes seront affichs)
La liste Results limite le nombre de rsultats

Columns
Si la case Display Host Name est coche, alors le nom dhte sera affich
Si la case Display Output est coche, alors le message associ au statut de lhte sera affich
La liste Output Length permet de limiter la longueur du message affich
Si la case Display Status est coche, alors le statut de lhte est affich
Si la case Display IP est coche, alors ladresse IP de lhte est affiche
Si la case Display Last Check est coche, alors la date et lhoraire de la dernire vrification sont affichs
Si la case Display Duration est coche, alors la dure durant laquelle lhte a conserv son statut est affiche
Si la case Display Hard State Duration est coche, alors la dure durant laquelle lhte a conserv son tat
HARD est affiche
Si la case Display Tries est coche, alors le nombre dessais avant la validation de ltat est affich
La liste Order By permet de classer les htes par ordre alphabtique suivant plusieurs paramtres

Misc
Le champ Refresh Interval (seconds) permet de dfinir la dure avant le rafrachissement des donnes

Le widget de services

Filters
Le champ Host Name permet de faire une recherche sur un ou plusieurs noms dhtes
Le champ Service Description permet de faire une recherche sur un ou plusieurs noms de services
Si la case Display Ok est coche, les services en statut OK seront affichs
Si la case Display Warning est coche, les services en statut WARNING seront affichs
Si la case Display Critical est coche, les services en statut CRITICAL seront affichs
Si la case Display Unknown est coche, les services en statut UNKNOWN seront affichs
Si la case Display Pending est coche, les services en statut PENDING seront affichs
La liste Acknowledgement Filter permet dafficher les services acquitts ou non acquitts (si la liste est vide,
les deux types dhtes seront affichs)
La liste Downtime Filter permet dafficher les services qui subissent un temps darrt ou non (si la liste est
vide, les deux types dhtes seront affichs)
La liste State Type permet dafficher les services en tat SOFT ou HARD (si la liste est vide, les deux types
dhtes seront affichs)
La liste Hostgroup permet dafficher les services appartenant des htes faisant partie dun certain groupe
dhtes (si la liste est vide, tous les services seront affichs)
La liste Servicegroup permet dafficher les services appartenant un certain groupe de services (si la liste est
vide, tous les services seront affichs)
La liste Results limite le nombre de rsultats

128 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Columns
Si la case Display Host Name est coche, alors le nom dhte sera affich
Si la case Display Service Description est coche, alors le nom du service sera affich
Si la case Display Output est coche, alors le message associ au statut du service sera affich
La liste Output Length permet de limiter la longueur du message affich
Si la case Display Status est coche, alors le statut du service est affich
Si la case Display Last Check est coche, alors la date et lhoraire de la dernire vrification sont affichs
Si la case Display Duration est coche, alors la dure durant laquelle le service a conserv son statut est
affiche
Si la case Display Hard State Duration est coche, alors la dure durant laquelle le service a conserv son
tat HARD est affiche
Si la case Display Tries est coche, alors le nombre dessais avant la validation de ltat est affich
La liste Order By permet de classer les services par ordre alphabtique suivant plusieurs paramtres

Misc
Le champ Refresh Interval (seconds) permet de dfinir la dure avant le rafraichissement des donnes

Le widget de graphique de performance

Le champ Service permet de choisir le service pour lequel le graphe sera affich
La liste Graph period permet de choisir la priode de temps que le graphe doit afficher
Le champ Refresh Interval (seconds) permet de dfinir la dure avant le rafraichissement des donnes

Le widget de groupe dhtes

Le champ Hostgroup Name Search permet de choisir les groupes dhtes affichs
Si la case Enable Detailed Mode est coche, alors tous les noms dhtes ainsi que les services associs ces
htes seront affichs pour les groupes dhtes slectionns
La liste Results permet de limiter le nombre de rsultats
La liste Order By permet de classer les groupes dhtes par ordre alphabtique suivant plusieurs paramtres
Le champ Refresh Interval (seconds) permet de dfinir la dure avant le rafraichissement des donnes

Le widget de groupes de services

Le champ Servicegroup Name Search permet de choisir les groupes de services affichs
Si la case Enable Detailed Mode est coche, alors tous les noms dhtes ainsi que les services associs ces
htes seront affichs pour les groupes de services slectionns
La liste Results permet de limiter le nombre de rsultats
La liste Order By permet de classer les groupes de services par ordre alphabtique suivant plusieurs paramtres
Le champ Refresh Interval (seconds) permet de dfinir la dure avant le rafraichissement des donnes

6.2.2 Laccueil

Prsentation

Lcran daccueil se compose de deux lments :


La Vue densemble : est une vue qui permet de visualiser de manire intuitive, en temps rel, lvolution de
son systme dinformations en prsentant les incidents non pris en compte.
Les informations de Sant globale : est une vue qui permet de visualiser sous forme de camembert ltat global
des htes et des services en pourcentage par tat.

6.2. Supervision 129


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
La vue densemble

Afin de visualiser la vue densemble, rendez-vous dans le menu Accueil ==> Accueil.

Le tableau Htes permet de visualiser ltat gnral des htes superviss en prsentant le nombre dobjet par
tat (indisponible, injoignable, disponible ou en attente dtre supervis).
Le tableau Problmes dhte non traits (100 derniers) permet de visualiser les 100 derniers incidents
dhtes non pris en compte (acquitts).
Le tableau Services permet de visualiser ltat gnral des services superviss en prsentant le nombre dobjet
par tat (critique, en alerte, ok, inconnu ou en attente dtre supervis).
Le tableau Problmes de service non traits (100 derniers) permet de visualiser les 100 derniers incidents de
services non pris en compte (acquitts) en prsentant ces derniers par priorit : en premier, ceux dont le statut
est critique, puis ceux en statut dgrads, pour finir sur ceux dont le statut est inconnu.

La sant globale

Pour visualiser les informations de sant globale :


1. Rendez-vous dans le menu Accueil ==> Accueil
2. Dans le menu de gauche, cliquez sur Sant globale

130 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Warning : Flash player doit tre disponible sur votre navigateur pour visualiser les camemberts.

6.2.3 Statistiques de lordonnanceur

Linterface Centreon propose lutilisateur de visualiser les statistiques de lensemble des ordonnanceurs ainsi que
celles lies au broker.

Informations de performance

Pour visualiser les informations de performances de votre ordonnanceur :


1. Rendez-vous dans le menu Accueil ==> Statistiques de lordonnanceur
2. Dans le menu de gauche, cliquez sur Informations de performance
3. Choisissez votre ordonnanceur dans la liste droulante Collecteur

Plusieurs tableaux permettent de visualiser les performances de vos ordonnanceurs :


Le tableau Actuellement contrls permet de visualiser le nombre dhtes et de services contrls depuis la
dernire minute, les cinq dernires minutes, le dernier quart dheure ou la dernire heure.
Le tableau Temps de latence des contrles permet de visualiser les temps de latence minimum, maximum et
moyen des contrles effectus sur les htes et les services.
Warning : Plus le temps de latence est lev, plus les contrles sont excuts en retard vis--vis de lheure initiale
programme par lordonnanceur. Cela implique une potentielle charge leve du serveur.

6.2. Supervision 131


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Le tableau Utilisation du buffer permet de visualiser le nombre de commandes externes en attente de traite-
ments par lordonnanceur.
Warning : Dans le cas dune supervision passive injectant de nombreuses commandes externes lordonnanceur,
il est ncessaire de contrler cette valeur. En effet, si celle-ci est trop proche de la taille limite, il est possible de
perdre des commandes, il faut donc augmenter la taille du buffer.
Le tableau Statut donne un bref aperu des statuts pour les htes et les services
Le tableau Temps dexcution des contrles permet de visualiser le temps dexcution dune sonde, cest--
dire le temps entre son lancement et le moment o elle transmet linformation lordonnanceur.
Warning : Plus le temps dexcution est lev, plus cela est pnalisant pour lexcution des autres processus en
file dattente et gnre de la latence. Les plugins doivent tre performants pour ne pas engendrer de latence.

Statistiques du broker

Pour visualiser les statistiques de Centreon Broker :


1. Rendez-vous dans le menu Accueil ==> Statistiques de lordonnanceur
2. Dans le menu de gauche, cliquez sur Statistiques du broker
3. Choisissez votre collecteur dans la liste Collecteur

Les performances de Centreon Broker sont classes entits de Centreon Broker (module ordonnanceur, Broker-RRD,
Broker-Central).
Pour chaque entit, linterface web de Centreon affiche :
La liste des modules de Centreon Broker charg
Les performances dentre/sortie

132 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Les performances dentre/sortie

Chaque performance contient plusieurs informations :

Le champ Statut contient le statut de lentre, de la sortie ou ltat du module lui-mme


Le champ Mode de rcupration indique si le fichier tampon du module est en cours dutilisation
Le champ Dernier vnement indique la date et lheure du dernier vnement survenu
Le champ Vitesse de traitement des vnements indique le nombre dvnement traits la seconde
Le champ Dernier essai de connexion contient la date et lheure du dernier essai de connexion
Le champ Dernire connexion ralise contient la date et lheure de la dernire connexion russie
Le champ Pairs dcrit les entits connectes
Le champ Rtention des donnes pour connexion depuis serveur Central indique lactivation ou non du
mode de connexion sens unique entre le serveur Centreon et le collecteur
Le champ File dvnements indique le nombre dvnements traiter
Le champ Fichier en cours de lecture indique le fichier de failover en cours de lecture
Le champ Emplacement de lecture (offset) indique lemplacement de lecture associe au fichier de failover
Le champ Fichier en cours dcriture indique que le failover est activ en prcisant le nom du fichier de
failover
Le champ Emplacement dcriture (offset) indique lemplacement dcriture associe au fichier de failover
Le champ Taille maximale du fichier indique la taille maximale du fichier de failover
Le champ Failover indique le fichier temporaire de secours associ

Les graphiques

Il est galement possible de visualiser les performances des moteurs de supervision sous la forme de graphiques de
performances. Pour cela :
1. Rendez-vous dans le menu Accueil ==> Statistiques de lordonnanceur
2. Dans le menu de gauche, cliquez sur Graphiques
3. Choisissez votre collecteur dans la liste Collecteur
4. Choisissez la priode sur laquelle vous souhaitez visualiser les graphiques de performances

6.2. Supervision 133


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
6.2.4 Supervision Temps-rel

Le menu Supervision permet de visualiser en temps-rel lvolution de la supervision de son systme dinformation.

Statut des objets

Les statuts sont des indicateurs pour les htes ou les services. Chaque statut a une signification bien prcise pour
lobjet. A chaque statut correspond un code gnr par la sonde de supervision en fonction des seuils dfinis par
lutilisateur.

Statut des htes

Le tableau ci-dessous rsume lensemble des statuts possibles pour un hte.


Statut Code de retour Description
UP 0 Lhte est disponible et joignable
DOWN 1 Lhte est indisponible
UNREACHABLE 2 Lhte est injoignable

Statut des services

Le tableau ci-dessous rsume lensemble des statuts possibles pour un service.


Statut Code de retour Description
OK 0 Le service ne prsente aucun problme
WARNING 1 Le service a dpass le seuil dalerte
CRITICAL 2 Le service a dpass le seuil critique
UNKNOWN 3 Le statut du service ne peut tre vrifi (exemple : agent SNMP DOWN...)

134 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Statuts avancs

En plus des statuts standards, de nouveaux statuts permettent dajouter des informations complmentaires :
Le statut PENDING est un statut affich pour un service ou un hte frachement configur mais qui na pas
encore t contrl par lordonnanceur.
Le statut UNREACHABLE est un statut indiquant que lhte est situ (relation de parent) en aval dun hte
dans un statut DOWN.
Le statut FLAPPING (bagotant) est un statut indiquant que le pourcentage de changement de statut de lobjet
est trs lev. Ce pourcentage est obtenu partir de calculs effectus par le moteur de supervision.
Le statut ACKNOWLEDGED est un statut indiquant que lincident du service ou de lhte est pris en compte
par un utilisateur.
Le statut DOWNTIME est un statut indiquant que lincident du service ou de lhte est survenu durant une
priode de temps darrt programm.

Etats SOFT et HARD

Un hte ou un service peut avoir deux tats :


SOFT : Signifie quun incident vient dtre dtect et que ce dernier doit tre confirm.
HARD : Signifie que le statut de lincident est confirm. Lorsque le statut est confirm, le processus de notifi-
cation est enclench (envoi dun mail, SMS, ...).

Confirmation dun statut

Un incident (statut non-OK) est confirm partir du moment o le nombre dessai de validation est arriv son terme.
La configuration dun objet (hte ou service) implique un intervalle de contrle rgulier, un nombre dessai pour
valider un tat non-OK ainsi quun intervalle non-rgulier de contrle. Ds la dtection du premier incident, le statut
est dans un tat SOFT jusqu sa validation en tat HARD dclenchant le processus de notification.
Exemple :
Un service a les paramtres de vrifications suivants :
Nombre de contrles avant validation de ltat : 3
Intervalle normal de contrle : 5 minutes
Intervalle non-rgulier de contrle : 1 minute
Imaginons le scnario suivant :
Instant t + 0 : Le service est vrifi, il a le statut OK.
Instant t + 5 : La seconde vrification montre que le service a le statut CRITICAL. Le service passe en tat
SOFT (essai 1/3).
Instant t + 6 : La troisime vrification lieu, le service a toujours le statut CRITICAL en tat SOFT (essai
2/3).
Instant t + 7 : La quatrime vrification montre que le service a toujours le statut CRITICAL (essai 3/3). Le
nombre dessais a t atteint, le statut est configur (tat HARD). Le processus de notification est enclench.
Instant t + 8 : Le service retrouve le statut OK. Il passe directement en tat HARD. Le processus de notification
est enclench.
Instant t + 13 : Le service a le statut WARNING. Il passe en tat SOFT (essai 1/3).
Instant t + 14 : Le service a toujours le statut WARNING (essai 2/3).
Instant t + 15 : Le service a le statut CRITICAL. Il reste en tat SOFT car il a chang de statut.

Actions gnriques

Par dfaut, lors de la visualisation des statuts des htes ou des services, les donnes de supervision sont rafrachies
automatiquement (15 secondes par dfaut). Cependant, plusieurs icnes permettent de contrler le rafraichissement

6.2. Supervision 135


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
des donnes. Le tableau ci-dessous rsume les diffrentes fonctions de ces icnes :
Icne Description
Permet de rafrachir manuellement les rsultats
Permet de mettre en pause le rafrachissement automatique des donnes
Permet de reprendre le rafrachissement automatique des donnes

Htes

Visualisation

Pour visualiser le statut des htes, rendez-vous dans le menu Supervision ==> Htes.

La barre de recherche grise permet de filtrer les rsultats affichs. Le menu de gauche permet de modifier les htes
visibles au sein du tableau :
Pour visualiser les htes rencontrant un problme mais tant non acquitts, cliquez sur Problmes non acquit-
ts
Pour visualiser tous les htes rencontrant un problme, cliquez sur Problmes en cours
Pour visualiser tous les htes, cliquez sur Htes
Pour visualiser les htes classs par groupes dhtes, cliquez sur Groupes dhtes

136 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Tableaux dhtes

Le tableau ci-dessous donne une description de toutes les colonnes du tableau affich lors de la visualisation des htes :
Nom de la Description
colonne
S Affiche le niveau de criticit de lhte
Htes Affiche le nom de lhte. Licne indique que les notifications pour cet hte sont dsactives.
Licne permet de visualiser lensemble des graphiques de performances pour cet hte
Statut Permet de visualiser le statut de lhte
Adresse IP Indique ladresse IP de lhte
Dernier Affiche la date et lheure du dernier contrle
contrle
Dure Affiche la dure depuis laquelle lhte a conserv son statut actuel
Valid Affiche la dure depuis laquelle lhte a conserv son statut actuel (napparait pas lors de la
depuis visualisation de tous les htes)
Tentatives Affiche le nombre de tentatives effectues avant de valider ltat
Statut Affiche le message expliquant le statut de lhte
dtaill
Note : La colonne criticit ainsi que le filtre associ apparaissent si au moins un objet affich possde un niveau de
criticit.

Filtres disponibles Vous pouvez filtrer le rsultat prsent via les filtres suivants :
Hte : permet de filtrer par nom dhte via une recherche de type SQL LIKE.
Statut : permet de filtrer sur le statut des htes.
Criticit : permet de filtrer par criticit.

6.2. Supervision 137


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Collecteur : permet de filtrer les htes par collecteur. Seuls les htes du collecteur slectionn seront affichs.
Groupe dhte : permet de filtrer par groupe dhte. Seuls les htes du groupe dhtes slectionn seront
affichs.
Note : La recherche sur les champs texte ne commence qu partir de la saisie dau moins 3 caractres.

Tableau de groupes dhtes

Le tableau ci-dessous donne une description de toutes les colonnes du tableau affich lors de la visualisation des
groupes dhtes :
Nom de la Description
colonne
Groupes dhtes Liste lensemble des groupes dhtes
Etat des htes Permet de visualiser le nombre dhtes ayant le statut disponible, indisponible, injoignable
ou en attente
Etat des services Permet de visualiser le nombre de services ayant le statut OK, WARNING, CRITICAL ou
PENDING

Filtres disponibles Vous pouvez filtrer le rsultat prsent en slectionnant dans la liste droulante un collecteur.
Seuls les htes du collecteur slectionn seront affichs.

Dtails dun hte

Lorsque vous cliquez sur un hte, la page suivante saffiche :

138 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Dtails du statut Le tableau ci-dessous rsume lensemble des attributs de cette partie :
Attributs Description
Statut de lhte Affiche le statut de lhte
Statut dtaill Affiche le message associ au statut de lhte
Donnes de performance Affiche les donnes de performances renvoyes par la sonde
Tentative Affiche le nombre de tentative avant validation de ltat
Type dtat Affiche le type dtat (SOFT ou HARD)
Dernier contrle Affiche la date et lheure du dernier contrle effectu sur lhte
Prochain contrle Affiche la date et lheure du prochain contrle effectu sur lhte
Latence Affiche le temps de latence entre la programmation de lexcution et lexcution
relle de la sonde
Temps dexcution Affiche le temps dexcution de la sonde
Changement du dernier tat Affiche la date et lheure depuis laquelle lhte est dans ltat actuel
Dure de ltat actuel Affiche la dure depuis laquelle lhte est dans ltat actuel
Dernier notification Affiche la date et lheure denvoi de la dernire notification
Prochaine notification Affiche la date et lheure denvoi de la prochaine notification
Numro de notification actuel Affiche le nombre de notifications dj envoyes
Est-ce que le statut de lhte Indique si lhte bagotte (a le statut FLAPPING)
bagote ?
Pourcentage de changement Affiche le pourcentage de changement dtat
de statut
Planification darrt en cours ? Indique si lhte est concern par un temps darrt
Dernire mise jour Affiche la date et lheure de la dernire mise jour

Options et Commandes disponibles Les options ainsi que les commandes permettent deffectuer un certain nombre
dactions sur lhte. Ces diffrentes options sont traites au sein du guide dexploitation.

Raccourcis dhtes Le tableau ci-dessous rsume la signification des icnes :


Icne Description
Redirige vers la page de configuration de lhte
Affiche le statut de tous les services lis lhte
Affiche les journaux lis lhte
Affiche le rapport de disponibilit li lhte
Affiche les graphiques de performances des services lis lhte

Outils Le conteneur Outils permet :


Deffectuer un PING vers lhte
Deffectuer un traceroute vers lhte

Liens Le conteneur Liens permet de visualiser les groupes dhtes auxquels lhte appartient.

Notifications Le conteneur Notifications permet de visualiser quels sont les contacts et les groupes de contacts qui
seront alerts en cas denvoi dune notification.

6.2. Supervision 139


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Services

Visualisation

Pour visualiser le statut des services, rendez-vous dans le menu Supervision ==> Services.

La barre de recherche grise permet de filtrer les rsultats affichs. Le menu de gauche permet de modifier les services
visibles au sein du tableau :
Pour visualiser les services rencontrant un problme valid (tat HARD) mais tant non acquitts, cliquez
sur Problmes non acquitts
Pour visualiser tous les services rencontrant un problme (valid ou non, acquitts ou non), cliquez sur Pro-
blmes en cours
Pour visualiser tous les services, cliquez sur Tous les services
Pour visualiser tous les services (classs par htes), quel que soit le statut, cliquez sur Dtails (en dessous
dhtes)

140 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Pour visualiser le nombre de services (classs par htes et statuts), cliquez sur Rsum (en dessous dhtes)

6.2. Supervision 141


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Pour visualiser tous les services (classs par groupes dhtes), cliquez sur Dtails (en dessous de groupe
dhtes)

142 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Pour visualiser le nombre de services (classs par groupes dhtes et statuts), cliquez sur Rsum (en dessous
de groupe dhtes)

6.2. Supervision 143


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Pour visualiser tous les services (classs par groupes de services), cliquez sur Dtails (en dessous de groupe
de services)

144 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Pour visualiser le nombre de services (classs par groupes de services et statuts), cliquez sur Rsum (en
dessous de groupe de services)

6.2. Supervision 145


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Pour visualiser les mta-services, cliquez sur Mta-Services

Tableaux de services

Le tableau ci-dessous dcrit les colonnes affiches lors de la visualisation des services.

146 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Nom de la Description
colonne
S Affiche le niveau de criticit du service
Htes Affiche le nom de lhte. Licne permet daccder une page web dcrivant lhte
Services Affiche le nom du service. Licne indique que les notifications pour ce service sont
dsactives. Licne permet de visualiser le graphique de performance li ce service. Licne
permet daccder une page web dcrivant le service
Valid Affiche la dure depuis laquelle le service a conserv son statut actuel
depuis
Dernier Affiche la date et lheure du dernier contrle effectu
contrle
Tentatives Affiche le nombre de tentatives effectues pour valider ltat
Statut Affiche le message expliquant le statut du service
dtaill
Note : La colonne criticit ainsi que le filtre associ apparaissent si au moins un objet affich possde un niveau de
criticit.

Note : La colonne Valid depuis napparait pas lors de la slection du menu contextuel Tous les services.

Tableaux des groupes

Le tableau ci-dessous dcrit les colonnes affiches lors de la visualisation des services classs par groupes.
Nom de la colonne Description
Htes ou Groupes dhtes Liste lensemble des htes ou htes spars par des groupes dhtes ou htes
Htes ou Groupes de services spares par des groupes de services Licne permet de visualiser lensemble
Htes
des services lis lhte Licne permet de visualiser lensemble des
graphiques de performances lis aux services appartenant lhte
Statut Affiche le statut de lhte
Informations sur les services Affiche le statut des services (Mode dtaill) ou le nombre de services classs
par statut (Mode rsum)

Tableaux des mta-services

Le tableau ci-dessous dcrit les colonnes affiches lors de la visualisation des mta-services.
Nom de la Description
colonne
Mta-Services Affiche le nom du mta-service. Licne permet de visualiser le graphique de performance
li ce mta-service.
Statut Affiche le statut du mta-service
Dure Affiche la dure depuis laquelle le mta-service na pas chang de statut
Dernier contrle Affiche la date et lheure du dernier contrle
Tentative Affiche le nombre de tentatives pour valider ltat
Statut dtaill Affiche le message li au statut

Dtails dun service

Lorsque vous cliquez sur un service, la page suivante saffiche :

6.2. Supervision 147


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Dtails du statut Le tableau ci-dessous rsume lensemble des attributs de cette partie :
Attributs Description
Statut du service Affiche le statut du service
Statut dtaill Affiche le message associ au statut du service
Informations dtat tendues Affiche le message long (long output) associ au statut du service
Donnes de performance Affiche les donnes de performances renvoyes par la sonde
Tentative Affiche le nombre de tentative en cours pour valider ltat
Type dtat Affiche le type dtat (SOFT ou HARD)
Dernier contrle Affiche la date et lheure du dernier contrle effectu sur le service
Prochain contrle Affiche la date et lheure du prochain contrle effectu sur le service
Latence Affiche le temps de latence entre la programmation de lexcution et son
excution relle
Temps dexcution Affiche le temps dxcution de la sonde
Changement du dernier tat Affiche la date et lheure depuis laquelle le service est dans ltat actuel
Dure de ltat actuel Affiche la dure depuis laquelle le service est dans ltat actuel
Dernier notification Affiche la date et lheure denvoi de la dernire notification
Numro de notification actuel Affiche le nombre de notifications dj envoyes
Est-ce que le statut du service Indique si le service bagotte (statut FLAPPING)
bagote ?
Pourcentage de changement de Affiche le pourcentage de changement dtat
statut
Planification darrt en cours ? Indique si le service est concern par un temps darrt
Dernire mise jour Affiche la date et lheure de la dernire mise jour

148 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Options et commandes du service Les options ainsi que les commandes du service permettent deffectuer un certain
nombre dactions sur le service. Ces diffrentes options sont traites au sein du guide dexploitation.

Graphique dtaill et graphiques des statuts Les parties Graphique dtaill et Graphique des statuts permettent
respectivement de visualiser le graphique de performance ainsi que le graphique dhistorique de statuts pour ce service.

Raccourcis dhte Les raccourcis dhtes sont les mmes que ceux de la fiche dhte.

Raccourcis de service Le tableau ci-dessous rsume la signification des icnes :


Icne Description
Redirige vers la page de configuration du service
Affiche le statut de tous les services lis lhte
Affiche les journaux lis au service
Affiche le rapport de disponibilit li au service

Liens Le conteneur Liens permet de visualiser :


Les groupes dhtes auxquels lhte contenant le service appartient
Les groupes de services auxquels le service appartient
Les catgories de services auxquels le service appartient

Notifications Le conteneur Notifications permet de visualiser quels sont les contacts et les groupes de contacts qui
seront alerts en cas denvoi dune notification.

Moteurs de supervision

Ce menu contextuel permet de visualiser des informations complmentaires telles que la file dattente des contrles
prvus par lordonnanceur, les commentaires ou les temps darrt ajouts aux objets .

Note : Pour plus dinformations sur les commentaires ou sur les temps darrt, rendez-vous dans le guide dexploita-
tion.

File dattente

La file dattente prsente lordonnancement prvu des contrles raliser par les ordonnanceurs de supervision.
Pour visualiser la file dattente :
1. Rendez-vous dans le menu Supervision ==> Htes ou Services
2. Dans le menu de gauche, sous Moteur de supervision, cliquez sur File dattente

6.2. Supervision 149


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Le tableau ci-dessous dcrit les colonnes de cette page.
Nom de la colonne Description
Htes Indique le nom de lhte
Services Indique le nom du service
Dernier contrle Affiche la date et lheure du dernier contrle
Prochain contrle Affiche la date et lheure du prochain contrle
Contrle actif Indique si le contrle est actif et/ou passif

Filtres disponibles Vous pouvez filtrer le rsultat prsent via les filtres suivants :
Hte : permet de filtrer par nom dhte via une recherche de type SQL LIKE.
Service : permet de filtrer par le nom du service.
Collecteur : permet de filtrer par ordonnanceur. Seules les ressources supervises par cet ordonnanceur seront
affiches.
Note : La recherche sur les champs texte ne commence qu partir de la saisie du troisime caractre.

Les temps darrts

Pour visualiser les temps darrts en cours sur les ressources :


1. Rendez-vous dans le menu Supervision ==> Htes ou Services
2. Dans le menu de gauche, sous Moteur de supervision, cliquez sur Temps darrt

150 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Le tableau ci-dessous dcrit les colonnes de cette page.
Nom de la colonne Description
Nom de lhte Indique le nom de lhte
Service (si on utilise la page Services) Affiche le service concern par le temps darrt
Date et heure de dbut et Date et heure de fin Affiche la date et lheure de dbut et de fin
Dure Affiche la dure du temps darrt
Auteur Affiche la personne ayant ajout ce temps darrt
Commentaires Affiche le raison du temps darrt
Dmarr Indique si le temps darrt est en cours ou non
Fixe Indique si le temps darrt est fixe ou non

Filtres disponibles Vous pouvez filtrer le rsultat prsent via les filtres suivants :
Nom de lhte : permet de filtrer par nom dhte via une recherche de type SQL LIKE.
Service : permet de filtrer par le nom du service.
Statut dtaill : permet de filtrer par le statut dtaill des services.
Auteur : permet de filtrer par utilisateur ayant cr des commentaires.
Afficher les temps darrt termins : permet dafficher en plus les temps darrt termins.
Afficher les temps darrt rcurrents : permet dafficher les temps darrts rcurrents.
Note : La recherche sur les champs texte ne commence qu partir de la saisie du troisime caractre.

Les commentaires

Pour visualiser les commentaires dfinis sur les ressources :


1. Rendez-vous dans le menu Supervision ==> Htes ou Services
2. Dans le menu de gauche, sous Moteur de supervision cliquez sur Commentaires

6.2. Supervision 151


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Le tableau ci-dessous dcrit les colonnes de cette page.
Nom de la colonne Description
Nom de lhte Indique le nom de lhte
Service (si on utilise la page Services) Affiche le service concern par le commentaire
Date de saisie Affiche la date et lheure o le commentaire a t saisi
Auteur Affiche la personne ayant ajout ce commentaire
Commentaires Affiche le contenu du commentaire
Acquittement persistant en cas de redmarrage de Indique si le commentaire reste aprs le redmarrage de
lordonnanceur lordonnanceur

Filtres disponibles Vous pouvez filtrer le rsultat prsent via les filtres suivants :
Nom de lhte : permet de filtrer par nom dhte via une recherche de type SQL LIKE.
Service : permet de filtrer par le nom du service.
Statut dtaill : permet de filtrer par le statut dtaill des services.
Note : La recherche sur les champs texte ne commence qu partir de la saisie du troisime caractre.

6.2.5 Les journaux dvnements

Dfinition

Les journaux dvnements (aussi appels Event logs) permettent de :


Visualiser les diffrents changements de statuts et tats des objets superviss

152 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Voir les notifications envoyes ainsi que leurs destinataires
Ces journaux peuvent tre visualiss sur une priode donne.

Visualisation

Pour visualiser les journaux dvnements, rendez-vous dans le menu Supervision ==> Journaux dvnements.

Le menu de gauche permet de slectionner les htes et/ou les services pour lesquels on souhaite visualiser les journaux
dvnements.
La barre de recherche grise appele Priode de visualisation permet de slectionner la priode de temps pour laquelle
on souhaite visualiser les vnements. La liste droulante permet de slectionner des priodes de temps gnriques. Si
la liste droulante est vide alors il est possible de choisir manuellement la priode de temps en utilisant les champs Du
et Au.
La barre de recherche grise situe en dessous permet de slectionner les filtres de recherche afin dafficher les vne-
ments souhaits.
Le tableau permet de visualiser les rsultats.

Filtrer les messages

Type de message

Il est possible dafficher plusieurs types de messages sur la priode donne :


Les services ayant le statut WARNING en cochant Alerte
Les erreurs (htes non disponibles ou services ayant le statut CRITICAL) en cochant Erreur
Les incidents dhtes ou de service valids (HARD) en cliquant sur Etat Hard seulement
Les notifications envoyes en cliquant sur Notifications

6.2. Supervision 153


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Statut de lhte ou du service

Note : Les choix effectus ici influencent les cases coches dans Type de message. Il est galement possible de
visualiser les diffrents messages en slectionnant manuellement les statuts dsirs pour les htes ou les services.

Les rsultats

Le tableau ci-dessous dcrit les diffrentes colonnes du tableau de rsultats.


Nom de la Description
colonne
Jour Affiche la date de lvnement
Heure Affiche lheure de lvnement
Nom de lobjet Affiche le nom de lobjet (hte et/ou service)
Statut Affiche le statut de lobjet
Type Affiche ltat de lobjet (SOFT ou HARD)
Nombre dessais Affiche le nombre de vrification depuis le statut actuel de lobjet
Statut dtaill Affiche le message expliquant le statut de lhte ou du service
Contact Affiche le contact ayant t contact (nest renseign que sil sagit dune notification)
Commande Affiche la commande utilise pour alerter le contact (nest renseign que sil sagit dune
notification)

6.3 Gestion des graphiques de performances

6.3.1 Les graphes

Dfinition

Centreon permet de gnrer des graphiques partir des informations de supervision. Il existe deux types de gra-
phiques :
Les graphiques de performances permettent de visualiser lvolution des services de manire intuitive.
Exemples : niveau de remplissage dun disque dur, trafic rseau...
Les graphiques dhistorique (ou graphiques des statuts) permettent de visualiser lvolution des statuts dun
service.
Les graphiques de performances ont toujours comme abscisse une priode de temps et comme ordonne une unit
(Volts, Octets...). Les graphiques dhistorique ont toujours comme abscisse une priode de temps, leurs ordonnes ne
varient pas. Uniquement la couleur du graphique permet de visualiser le statut de lobjet :
Vert pour le statut OK
Orange pour le statut WARNING
Rouge pour le statut CRITICAL
Gris pour le statut UNKNOWN
Exemple de graphique de performances :

154 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Exemple de graphique dhistorique :

Visualisation

Les graphiques de performances

Il existe plusieurs manires de visualiser les graphiques de performances :


Visualiser le graphique dans la liste des services (Menu Supervision ==> Services) en survolant licne
Visualiser le graphique depuis la page de dtails dun objet en cliquant sur licne
Se rendre dans le menu Vues ==> Graphiques pour visualiser un plusieurs graphiques

Les graphiques dhistorique

Comme pour les graphiques de performances, il existe diffrentes faons daccder au graphique dhistorique :
A partir de la page de dtail dun objet (voir le chapitre supervision temps-relle)
A partir du menu Vues ==> Graphiques, en slectionnant au pralable un service spcifique puis, en cochant
la case Affichage de ltat.

Visualiser plusieurs graphiques

Pour visualiser lensemble des graphiques, rendez-vous dans le menu Vues ==> Graphiques.

6.3. Gestion des graphiques de performances 155


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Le menu de gauche permet de slectionner les htes et/ou les services pour lesquels on souhaite visualiser les gra-
phiques.
La barre de recherche grise appele Priode de visualisation permet de slectionner la priode de temps sur laquelle
on souhaite visualiser les graphiques. La liste droulante permet de slectionner des priodes de temps prdfinies.
Il est possible de choisir manuellement la priode de temps en utilisant les champs Du et Au, ce qui remplacera la
slection prdfinie.
Plusieurs actions sont possibles sur les graphiques :
Sparer les courbes : spare plusieurs courbes dun graphique en plusieurs graphiques contenant chacun une
courbe
Affichage de ltat : affiche les graphiques dhistorique lis aux graphiques de performances affichs
Pour exploiter les donnes des graphiques, il est possible de :
Visualiser le graphique de performance sur un jour, une semaine, un mois et une anne en cliquant sur le
graphique de performances de votre choix
De zoomer sur le graphique en cliquant sur licne
De sauvegarder le graphique en cliquant sur licne
De tlcharger lensemble des donnes qui composent le graphique au format .csv en cliquant sur licne

Filtres Il est possible de filtrer la slection des ressources via :


La barre de recherche rapide en recherchant par hte ou service
En parcourant larbre de slection (menu de gauche) par groupe dhtes, puis par hte, puis par service dont
afficher le graphique
En parcourant larbre de slection (menu de gauche) par groupe de services puis par service dont afficher le
graphique
Note : Les htes non lis un groupe dhte sont ajouts au conteneur Htes orphelins.

156 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
6.3.2 Personnaliser les graphiques

Les modles de graphiques

Dfinition

Les modles de graphiques sont des modles qui permettent de mettre en forme les graphiques. Les modles de
graphiques permettent de configurer plusieurs paramtres de prsentation dont la mesure de laxe des ordonnes, la
largeur et la hauteur du graphique ou encore les diffrentes couleurs...

Configuration

Pour ajouter un nouveau modle de graphique :


1. Rendez-vous dans le menu Vues ==> Graphiques
2. Dans le menu de gauche cliquez sur Modles
3. Cliquez sur Ajouter

Informations gnrales
Le champ Nom du Modle permet de dfinir un nom pour le modle de graphe
Le champ Label Vertical contient la lgende pour laxe des ordonnes (type de donnes mesures)

6.3. Gestion des graphiques de performances 157


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Les champs Largeur et Hauteur sont exprimes en pixels et expriment respectivement la largeur et la hauteur
du modle
Le champ Limite infrieure dfinit la limite minimale de laxe des ordonnes
Le champ Limite suprieure dfinit la limite maximale de laxe des ordonnes
La liste Base dfinit la base de calcul pour les donnes lors de la mise lchelle des ordonnes du graphique.
Utilisez 1024 pour des mesures comme loctet (1 Ko = 1024 octets) et 1000 pour des mesures comme le volt
(1 kV = 1000 Volts).
Note : Si la case Taille max est coche, le graphique sera automatiquement mis lchelle de la valeur maximale
des ordonnes prsentes sur la priode donne.

Lgende
Le champ Couleur darrire plan de la grille dfinit la couleur darrire plan de la grille, espace de dvolu-
tion des donnes.
Le champ Couleur de prsentation de lchelle principale dfinit la grille, pour lchelle principale.
Le champ Couleur de prsentation de lchelle secondaire dfinit la grille, pour lchelle secondaire.
Le champ Couleur du contour du graphique dfinit la couleur du contour.
Le champ Couleur darrire plan dfinit la couleur darrire plan du graphique.
Le champ Couleur du texte dfinit la couleur du texte au sein du graphique.
Le champ Couleur de la flche des axes dfinit la couleur des flches des abscisses et des ordonnes.
Le champ Couleur du haut dfinit la couleur de la bordure gauche et haute de limage.
Le champ Couleur du bas dfinit la couleur de la bordure droite et basse de limage.
Si la case Sparer les courbes est coche, alors les courbes sont automatiquement spares lors de laffichage.
Si la case Mise lchelle est coche, alors le graphique est automatiquement mis lchelle par le moteur de
gnration du graphique.
Si la case Modle graphique par dfaut de Centreon est coche, ce modle devient le modle par dfaut
pour tous les graphiques qui nont aucun modle dfinit.
Le champ Commentaires permet de commenter le modle de graphique.

Utiliser un modle de graphe

Vous pouvez ajouter ce modle de prsentation lors de ldition de lobjet :


Un service (ou un modle de service) en se rendant dans longlet Informations supplmentaires du service.
Une commande.

Les courbes

Dfinition

Une courbe est la reprsentation de lvolution des donnes de performances (mtriques issues de la collecte) visible
via les graphiques de performance. Un graphique peut contenir plusieurs courbes. Il est possible de personnaliser les
courbes en modifiant certains paramtres : lallure des courbes, la position des courbes sur le graphique, la lgende
ainsi que les informations complmentaires (moyenne, valeur totale...).

Configuration

Pour ajouter un nouveau modle de courbes :


1. Rendez-vous dans le menu Vues ==> Graphiques
2. Dans le menu de gauche cliquez sur Courbes
3. Cliquez sur Ajouter

158 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Le champ Nom du modle dfinit le nom du modle.
Le champ Source de donnes Htes/Service dfinit le service pour lequel sera utilise cette courbe. Si ces
informations ne sont pas renseignes, cette dfinition de courbe sappliquera lensemble des services dans
lesquels cette mtrique apparait.
Le champ Nom de la source de donnes permet de slectionner la mtrique qui utilisera cette dfinition. La
liste Liste des mtriques connues permet de choisir les mtriques dj existantes utilises par les services.
Si la case Empiler est coche, cette courbe sempilera (stacking) sur les autres (utile pour voir la proportion
dune mtrique par rapport une autre).
Si la case Empiler est coche, la liste Ordre permet de dfinir lordre daffichage/empilage de la courbe (plus
le nombre est petit, plus il sera proche de labscisse).
Si la case Inverser est coche, la courbe est inverse (oppose de la valeur absolue) par rapport laxe des
ordonnes (utile pour voir la proportion du trafic entrant par rapport au trafic sortant).
La liste Epaisseur exprime lpaisseur de la ligne du trait de la courbe (exprime en pixels).
Le champ Couleur de la courbe dfinit la couleur de la courbe.
Le champ Couleur de laire concerne la couleur de remplissage de la courbe si loption Remplissage est
coche, (voir ci-dessous). Elle contient 3 champs qui correspondent respectivement aux couleurs du statut OK,
WARNING et CRITICAL.
Le champ Transparence dfinit le niveau de transparence de la couleur du contour.
Si la case Remplissage est coche, alors toute la courbe est remplie avec la couleur de laire dfinie en fonction
du statut.
Les attributs ci-dessous concernent les informations situes en dessous du graphique.
Le champ Lgende dfinit la lgende de la courbe.
Si la case Afficher uniquement la lgende est coche, la courbe sera masque tandis que la lgende sera

6.3. Gestion des graphiques de performances 159


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
visible.
La liste Ligne vide aprs cette lgende permet de dfinir un certain nombre de lignes vides aprs la lgende.
Si la case Afficher la valeur maximale est coche, alors la valeur maximale atteinte par la courbe sera affiche.
Si la case Afficher la valeur minimale est coche, alors la valeur minimale atteinte par la courbe sera affiche.
Si la case Arrondir les valeurs minimales et maximales est coche, alors les valeurs minimales et maximales
seront arrondies.
Si la case Afficher la moyenne est coche, alors la moyenne des points de la courbe sera affiche.
Si la case Afficher la dernire valeur est coche, alors la dernire valeur collecte de la courbe sera affiche.
Si la case Afficher la valeur totale est coche, saffiche alors la valeur totale (somme de toutes les valeurs de
la courbe sur la priode slectionne).
Le champ Commentaires permet de commenter la courbe.

Quelques exemples de courbes

Les courbes empiles :

Les courbes inverses :

Les courbes avec remplissage :

160 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Les mtriques virtuelles

Dfinition

Les mtriques virtuelles sont laffichage de courbes rsultant du traitement / agrgation de donnes issues dun jeu de
donnes. Le jeu de donnes correspond aux diffrentes valeurs des courbes sur la priode de prsentation du graphique.
La cration de mtriques virtuelles repose sur le langage RPN (Reverse Polish Notation).
Deux types de jeu de donnes sont disponibles :
CDEF : Cette commande cre un nouvel ensemble de points partir dune ou plusieurs sries de donnes.
Lagrgation est ralise sur chaque point (donnes).
VDEF : Le rsultat de chaque agrgation est une valeur et une composante temporelle. Ce rsultant peut
galement tre utilis dans les divers lments de graphique et dimpression.

CDEF vs VDEF Le type CDEF travaille sur un ensemble de points (tableau de donnes). Le rsultat du traitement
(exemple : multiplication par 8 pour convertir des bits en octets) sera un ensemble de point. Le type VDEF permet
dextraire le maximum dun ensemble de point.

Note : Pour plus dinformations sur la notation de type RPN, rfrencez-vous la documentation officielle RRD

Configuration

Pour ajouter une mtrique virtuelle :


1. Rendez-vous dans le menu Vues ==> Graphiques
2. Dans le menu de gauche, cliquez sur Mtriques (en dessous de Virtuals)
3. Cliquez sur Ajouter

6.3. Gestion des graphiques de performances 161


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Le champ Nom de la Mtrique dfinit le nom de la mtrique.
La liste Source de donnes Hte / Service permet de dfinir le service depuis lequel exploiter les mtriques.
Le champ Type DEF dfinit le type de jeu de donnes utilis pour calculer la courbe virtuelle.
Le champ Fonction RPN (Notation Polonaise Inverse) dfinit la formule permettant de calculer la mtrique
virtuelle.
Note : Il nest pas possible dajouter ensemble les mtriques de diffrents services. Cependant, il est possible dajouter
des mtriques virtuelles pour le calcul dune nouvelle mtrique.

Le champ Unit de la Mtrique dfinit lunit de la mtrique.


Le champ Niveau dalerte dfinit le seuil dalerte afficher dans le graphique.
Le champ Niveau critique dfinit le seuil critique afficher dans le graphique.
Si la case Masquer le graphique et la lgende est coche, alors la courbe et la lgende sont caches.
Le champ Commentaires permet de commenter la mtrique.

6.4 Tableaux de bord

6.4.1 Les rapports

Dfinition

Les rapports de disponibilits des objets accessibles via linterface web Centreon permettent de visualiser de manire
intuitive le taux de disponibilit dun hte, dun groupe dhtes ou dun groupe de services sur une priode de temps
donne.

Visualisation

Pour visualiser le rapport de disponibilit dun hte :


1. Rendez-vous dans le menu Rapports ==> Tableau de bord
2. Dans le menu de gauche, slectionnez Hte

162 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
3. Slectionnez lhte dsir dans la liste droulante Hte

La liste Priode de gnration permet de choisir la priode de temps sur laquelle on souhaite visualiser le taux
de disponibilit. Il est possible de slectionner une priode prdfinie via la liste droulante ou de slectionner
manuellement sa priode en dfinissant les champs Du et Au
Le tableau Etat de lhte permet de visualiser le taux et la dure de disponibilit associ par tat de lobjet
Le tableau Statuts des lments du rapport permettent de visualiser la disponibilit des services associs
lhte suivant leurs statuts
La frise chronologique permet de visualiser de manire intuitive le statut de lobjet au court du temps

De plus, en cliquant sur une journe de la frise chronologique, vous obtenez le rapport de la journe :

6.4. Tableaux de bord 163


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Il est galement possible de visualiser des rapports web pour :
Les groupes dhtes : Cliquez sur Groupes dhtes dans le menu de gauche

Les groupes de services : Cliquez sur Groupes de services dans le menu de gauche

164 Chapitre 6. Guide utilisateur


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Licne permet dexporter les donnes du rapport au format CSV.

Note : Cliquez sur le service dun hte dans le rapport de disponibilit de lhte pour obtenir un rapport dtaill du
service.

6.4. Tableaux de bord 165


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
166 Chapitre 6. Guide utilisateur
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
CHAPITRE 7

Guide exploitation

7.1 Gestion de la supervision

7.1.1 Acquitter un problme

Principe

Lorsquun hte ou un service prsente un incident et que ce dernier est valid, le processus de notification est enclen-
ch, pouvant gnrer une notification envoye un contact. Si le problme persiste et suivant la configuration ralise
(relancer une notification intervalle de temps rgulier, escalade de notification) il est possible que dautres alertes
soient mises.
Lacquittement dun incident permet de stopper le processus de notification (envoi de notifications), jusqu ce que
lhte ou le service retrouve un statut nominal.
Exemple dutilisation :
Un service est charg de vrifier la sant des disques durs dune baie de disque. Un disque dur physique tombe en
panne sur une baie de disque, une notification est envoye. Loprateur de supervision acquitte le service en prcisant
quune quipe est en train de rgler le problme. Les notifications ne sont plus envoyes. Le service reprendra son tat
nominal aprs changement du disque.

Note : Lacquittement dun incident signifie la prise en compte du problme par un utilisateur de la supervision (et
non la rsolution de ce dernier qui ne pourra tre effective que lorsque le contrle sera revenu dans son tat nominal).

Pratique

Pour acquitter un incident, deux solutions sont possibles :

Depuis la supervision temps relle

1. Rendez-vous dans le menu Supervision ==> Htes (ou Services)


2. Slectionnez le ou les objets que vous souhaitez acquitter
3. Dans le menu Plus dactions cliquez sur Htes : Acquitter ou sur Services : Acquitter

La fentre suivante saffiche :

167
Si la case Acquittement persistant en cas de changement de statut non-OK est coche, alors lacquitte-
ment sera conserv en cas de changement de statut non-OK (Exemple DOWN UNREACHABLE ou bien
WARNING CRITICAL). Sinon, lacquittement disparait et le processus de notification est ractiv.
Si la case Notifier est coche, alors une notification est envoye aux contacts lis lobjet pour les avertir que
lincident sur la ressource a t acquitt (dans le cas o le contact possde le filtre de notification dacquittement
dactiv).
Si la case Persistant en cas de redmarrage de lordonnanceur est coche, alors lacquittement sera conserv
en cas de redmarrage de lordonnanceur. Sinon, lacquittement disparait et le processus de notification est
ractiv.
Le champ Commentaire est gnralement utilis pour fournir la raison de lacquittement et est obligatoire.
Si la case Acquitter les services lis lhte est coche, alors tous les services lis lhte seront acquitts
(option visible uniquement si vous acquittez un hte).
Si la case Forcer les contrles actifs est coche, alors une commande sera envoye lordonnanceur pour
recontrler dans les plus brefs dlais la ressource.
Pour supprimer lacquittement dun incident sur un objet :
1. Rendez-vous dans le menu Supervision ==> Htes (ou Services)
2. Slectionnez les objets auxquels vous souhaitez supprimer lacquittement
3. Dans le menu Plus dactions, cliquez sur Htes : Ds-acquitter ou sur Services : Ds-acquitter

Depuis la fiche dtaille dun objet

A partir de la page de dtail dun objet, cliquez sur licne associ au champ Acquitts dans le cadre Options
Vous accderez une page ddie permettant dacquitter lincident.

Note : Les champs sont identiques la fentre obtenue partir du menu de supervision temps rel.

7.1.2 Ajouter un commentaire

Principe

Centreon permet dajouter des commentaires un objet. Ce commentaire est visible par toute personne ayant accs
la ressource (hte ou service). Un commentaire possde les proprits suivantes :
Nom de lhte
Nom du service si le commentaire est associ un service
Date de saisie du commentaire

168 Chapitre 7. Guide exploitation


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Auteur du commentaire
Le contenu du commentaire
La validit du commentaire face un redmarrage de lordonnanceur

Pratique

Pour ajouter un commentaire, deux solutions sont possibles :

Depuis la fiche dtaille dun objet

1. Accdez la page de dtails de lobjet


2. Dans la catgorie Commandes disponibles, cliquez sur Ajouter un commentaire pour cet hte/ce service

Depuis le menu Commentaires

1. Rendez-vous dans le menu Supervision ==> Htes (ou Services)


2. Dans le menu de gauche, sous Moteur de supervision, cliquez sur Commentaires
3. Cliquez sur Ajouter un commentaire

Attributs

La fentre suivante saffiche :

Le champ Nom de lhte dfinit lhte concern par le commentaire


Si vous avez choisi dajouter un commentaire pour un service, le champ Service vous permet de slectionner
le service concern par le commentaire.
Si la case Persistant en cas de redmarrage de lordonnanceur est coche, alors le commentaire sera
conserv en cas de redmarrage de lordonnanceur.
Le champ Commentaire contient le commentaire lui-mme.

7.1.3 Programmer un temps darrt

Principe

Un temps darrt est une priode de temps durant laquelle les notifications sont dsactives pour une ressource. Les
temps darrts sont utiliss lors dopration dune maintenance programme ; ils permettent dviter de recevoir des
alertes de type faux-positif.

Note : Il est important de slectionner lensemble des ressources ncessaires afin dviter les faux-positifs comme les
faux-ngatifs. De plus, le temps pass dans cet tat est pris en compte lors de la gnration des donnes de disponibilit.

7.1. Gestion de la supervision 169


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Il existe deux types de temps darrts :
Le temps darrt fixe : il dmarre et sarrte lheure prvue.
Le temps darrt flexible : il dmarrera pendant la fentre de temps prvue ds la dtection dun incident et
prendra fin lorsque la dure prvue en secondes sera coule.

Pratique

Il y a trois possibilits diffrentes de dfinir un temps darrt :


Depuis la fiche de dtails dun hte ou du service
Depuis linterface de supervision temps relle
Depuis le menu Temps darrt

Depuis la fiche dtaille dun objet

1. Accdez la page de dtails dun objet


2. Dans la catgorie Commandes, cliquez sur Planifier un arrt pour cet hte/ce service

Depuis la supervision temps relle

1. Rendez-vous dans le menu Supervision ==> Htes (ou Services)


2. Slectionnez le(s) objet(s) sur lesquels vous souhaitez planifier un temps darrt
3. Dans le menu Plus dactions..., cliquez sur Htes : Planifier un temps darrt ou Services : Planifier un
temps darrt

Depuis le menu Temps darrt

1. Rendez-vous dans le menu Supervision ==> Htes (ou Services)


2. Dans le menu de gauche, sous Moteur de supervision, cliquez sur Temps darrt
3. Cliquez sur Ajouter un temps darrt

Attributs

Le champ Nom de lhte dfinit lhte concern par le temps darrt


Le champ Service dfinit le service concern par le temps darrt
Si la case Fixe est coche alors le temps darrt est fixe. Sinon, il est flexible
Si le temps darrt est flexible, le champ Dure dfinit la dure du temps darrt
Les champs Date et heure de dbut et Date et heure de fin dfinissent les dates de dbut et de fin du temps
darrt
Le champ Commentaires sert indiquer pourquoi le temps darrt est programm

7.1.4 Gestion des vrifications

Principe

Il est possible dactiver ou de dsactiver momentanment la vrification dun hte ou dun service.

170 Chapitre 7. Guide exploitation


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Warning : La modification des paramtres de vrifications nimpacte pas la configuration de lobjet en base de
donnes. Ces modifications sont ralises sur la supervision en temps-rel ; elles seront annules lors du redmar-
rage de lordonnacneur.

Pratique

Pour modifier la gestion de la vrification sur un objet, deux solutions sont possibles :

Depuis la fiche dtaille dun objet

1. Accdez la page de dtails de lobjet


2. Dans la catgorie Options, rendez-vous la ligne Contrles actifs pour vrifier ltat des contrles.

Pour :
Activer la vrification, cliquez sur
Dsactiver la vrification, cliquez sur

Depuis la supervision temps relle

1. Rendez-vous dans le menu Supervision ==> Htes (ou Services)


2. Slectionnez le(s) objet(s) sur lesquels vous souhaitez activer ou de dsactiver la vrification
3. Dans le menu Plus dactions... cliquez sur :
Htes : Dsactiver la vrification ou Services : Dsactiver la vrification pour arrter la vrification dun
hte ou dun service
Htes : Activer la vrification ou Services : Activer la vrification pour activer la vrification dun hte ou
dun service

7.1.5 Soumettre un rsultat

Principe

Pour les services ayant la proprit de contrle passif, il est possible denvoyer manuellement un rsultat lordon-
nanceur afin que celui-ci soit pris en compte par lordonnanceur.

Pratique

Pour soumettre un rsultat, accdez la page de dtails de lobjet. Dans la catgorie Commandes du service cliquez
sur Soumettre un rsultat pour ce service

Attributs

Les champs Nom de lhte et Service dfinissent lhte et le service pour lequel le rsultat sera soumis
Le champ Rsultat du contrle dfinit le statut du service
Le champ Sortie du contrle dfinit le message afficher pour le service
Le champ Donnes de performance permet de dfinir des donnes de performances pour la gnration des
graphiques

7.1. Gestion de la supervision 171


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
7.1.6 Gestion des notifications

Principe

Il est possible dactiver ou de dsactiver momentanment la notification dun hte ou dun service.

Warning : La modification des paramtres de notifications nimpacte pas la configuration de lobjet en base de
donnes. Ces modifications sont ralises sur la supervision en temps-rel ; elles seront annules lors du redmar-
rage de lordonnacneur.

Pratique

Il y a deux moyens de grer les notifications :

Depuis la fiche dtaille dun objet

1. Accdez la page de dtails de lobjet


2. Dans la catgorie Options, rendez-vous la ligne Notifications pour lenvoi des notifications.

Pour :
Activer la notification, cliquez sur
Dsactiver la notification, cliquez sur

Depuis la supervision temps relle

1. Rendez-vous dans le menu Supervision ==> Htes (ou Services)


2. Slectionnez le ou les htes/services pour lesquels vous souhaitez activer ou de dsactiver la notification
3. Dans le menu Plus dactions... cliquez sur :
Htes : Dsactiver la notification ou Services : Dsactiver la notification pour arrter la notification dun
hte ou dun service
Htes : Activer la notification ou Services : Activer la notification pour activer la notification dun hte ou
dun service

7.1.7 Reprogrammation des contrles

Principe

Par dfaut, les contrles (vrifications dun service) sont excuts intervalle rgulier suivant la configuration dfinie
par lutilisateur. Il est possible dinteragir sur la pile dordonnancement des contrles afin de modifier la programma-
tion de ces derniers.
Il existe deux types de programmation :
La programmation classique : la vrification du service est mise en priorit dans la file dattente de lordon-
nanceur (ds que possible).
La programmation force : la vrification du service est mise en priorit dans la file dattente de lordonnacneur
(ds que possible) et cela mme si lheure de la demande dexcution est en dehors de la priode contrle ou
si le service nest pas de type actif.

172 Chapitre 7. Guide exploitation


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Pratique

Il y a deux moyens de forcer la vrification dun service :

Depuis la fiche dtaille de lobjet

1. Accdez la page de dtail de lobjet


2. Dans la catgorie Commandes de lhte (ou Commandes du service), cliquez sur Re-planifier le prochain
contrle pour cet hte / service ou Re-planifier le prochain contrle pour cet hte / ce service (Forc)

Depuis la supervision temps relle

1. Rendez-vous dans le menu Supervision ==> Htes (ou Services)


2. Slectionnez le ou les objets pour lesquels vous souhaitez forcer la vrification
3. Dans le menu Plus dactions... cliquez sur Planifier un contrle immdiat ou Planifier un contrle imm-
diat (Forc)

7.2 Les listes de contrles daccs

Les listes de contrles daccs (LCA ou Access Control List en Anglais) permettent de limiter laccs linterface
web aux utilisateurs de Centreon travers diverses rgles. Les ACL permettent galement de crer plusieurs profils
utilisateur permettant de focaliser sur un ensemble prcis de ressources.

Note : La gestion des contrles daccs est une fonction propre Centreon, lexportation de la configuration vers les
moteurs de supervision nest pas ncessaire pour les activer.

Les groupes daccs sont des groupes contenant les utilisateurs de Centreon. Pour chaque groupe daccs, il est possible
de dfinir trois types de contrles daccs :
Les filtres daccs aux ressources permettent de limiter laccs aux objets de Centreon (htes, services...)
Les filtres daccs aux menus permettent de limiter laccs aux menus de Centreon
Les filtres daccs sur les actions permettent de limiter laccs aux actions que lutilisateur peut entreprendre
sur un moteur de supervision ou sur les ressources elles-mmes (planifier temps darrt, arrter moteur de
supervision...)
Note : Un utilisateur peut appartenir plusieurs groupes daccs permettant ainsi dadditionner lensemble des auto-
risations daccs.

Les ACLs respectent des rgles trs strictes :


Les administrateurs de Centreon ne sont pas soumis aux ACLs (proprit du contact).
Un utilisateur (non administrateur) nappartenant aucun groupe daccs na aucun droit sur la plateforme de
supervision (cran vide aprs connexion).
Les ACLs sont recalcules toutes les minutes, cest pourquoi il est parfois ncessaire de patienter quelques
instants avant de voir appliquer la modification sur le profil.
Note : Lajout de modules complmentaires Centreon permet parfois dajouter des filtres supplmentaires pour les
groupes daccs. Exemple : les modules Centreon BI, BAM et MAP peuvent tre soumis des filtres

7.2. Les listes de contrles daccs 173


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
7.2.1 Groupes daccs

Pour ajouter un groupe daccs :


1. Rendez-vous dans le menu Administration ==> ACL
2. Cliquez sur Ajouter

Informations gnrales

Les champs Nom du groupe et Alias dfinissent le nom et lalias du groupe


La liste Contacts lis permet de lier des contacts au groupe daccs
La liste Groupes de contacts lis permet de lier des groupes de contacts au groupe daccs
Le champ Statut permet dactiver ou de dsactiver le groupe daccs

Note : Les groupes de contacts peuvent tre des groupes provenant de lannuaireLDAP connect linterface Cen-
treon.

Autorisations

Les listes prsentes au sein de cet onglet permettent de lier les diffrents types de contrles daccs dj crs au
groupe daccs.

174 Chapitre 7. Guide exploitation


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
7.2.2 Filtre daccs aux ressources

Les filtres daccs aux ressources permettent de limiter la visualisation des objets (htes, groupes dhtes, services,
groupes de services) un profil utilisateur.
Pour ajouter un filtre daccs aux ressources :
1. Rendez-vous dans le menu Administration ==> ACL
2. Dans le menu de gauche, cliquez sur Gestion des accs aux ressources
3. Cliquez sur Ajouter

Note : Une fois les filtres sur les ressources paramtrez, vous pouvez visualiser le rsultat via le menu Vrifier la vue
de lutilisateur ct de loption pour ajouter un nouveau filtre.

Informations gnrales

Les champs Nom du groupe et Description dfinissent le nom et la description du filtre


La liste Groupes lis permet de lier des groupes daccs ce filtre de ressources
Le champ Statut et Commentaires permet dactiver/dsactiver le filtre ainsi que de le commenter

Gestion des htes

Longlet Gestion des htes permet dajouter :


Des htes
Des groupes dhtes

7.2. Les listes de contrles daccs 175


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Si la case Inclure tous les htes ou Inclure tous les groupes dhtes est coche, alors tout objet nouvellement cr
sera automatiquement ajout au filtre.

Note : Il est possible dexclure explicitement des htes du filtre (pratique dans le cas o 1 ou 2 htes uniquement ne
doivent pas faire partie du filtre) dans le cas o les options Inclure tous les htes ou Inclure tous les groupes dhtes
sont coches.

Gestion des services

Longlet Gestion des services permet dajouter des groupes de services au filtre.

Mta-Services

Longlet Mta-Services permet dajouter des mta-services au filtre.

Filtres

La liste Filtrer par collecteur permet de slectionner les htes en fonction des collecteurs de supervision (si
aucun nest slectionn alors tous les collecteurs sont pris en compte)
La liste Filtrer par catgorie dhte permet de filtrer les htes par catgorie
La liste Filtrer par catgorie de service permet de filtrer les services par catgorie

Warning : Les filtres par collecteur ou par catgorie dobjet sont des filtres dinclusion (UNION). Seuls les objets
appartenant ces filtres en plus des groupes dobjets (htes et services) seront visibles.

7.2.3 Filtre daccs aux menus

Les filtres daccs au menu permettent de limiter laccs aux diffrents menus de linterface Centreon. Les menus sont
hirarchiss de la manire suivante :
Les menus de niveau 1 (Accueil, Supervision, Vues, ...)
Les menus de niveau 2 (Supervision ==> Htes, Supervision ==> Services, ...)
Les menus contextuels de niveau 3 (Supervision ==> Services ==> Par htes / dtails)
Les menus contextuels de niveau 4 (Supervision ==> Services ==> Par htes / dtails ==> Problems)
Note : Pour accder un niveau de menu n-1, lutilisateur doit avoir accs au menu de niveau n sinon ce dernier
ne pourra pas visualiser le menu au travers de linterface. Dans le cas contraire, lutilisateur devra accder directement
la page concerne via un lien direct (autologin, ...).

Pour ajouter un filtre daccs aux menus :


1. Rendez-vous dans le menu Administration ==> ACL
2. Dans le menu de gauche, cliquez sur Gestion des accs aux menus
3. Cliquez sur Ajouter

176 Chapitre 7. Guide exploitation


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Les champs Nom du groupe et Alias dfinissent le nom et lalias du filtre daccs
Le champ Statut permet dactiver ou de dsactiver le filtre
La liste Groupes lis permet dassocier un groupe daccs au filtre
La catgorie Pages disponibles permet dassocier des menus au filtre (Le menu parent doit tre coch pour
pouvoir accder au menu enfant)
Le champ Commentaires donne des indications sur le filtre
Warning : Lors de la dfinition de laccs aux menus Configuration ==> Htes et Configuration ==> Service,
il est possible de donner accs en lecture seule aux diffrents objets ou en lecture/criture.

Note : A chaque ajout de nouveau module Centreon possdant une interface web accessible au travers dun nouveau
menu, ce dernier devra tre ajout dans les groupes daccs au menu afin que les utilisateurs puissent y accder le cas
chant.

7.2. Les listes de contrles daccs 177


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
7.2.4 Filtre daccs sur les actions

Les filtres sur les actions permettent de limiter laccs aux actions ralisables sur les ressources (htes et services)
ainsi que sur les ordonnanceurs de supervision (arrt des notifications, redmarrage d lordonnanceur, ...).
Pour ajouter un filtre daccs aux actions :
1. Rendez-vous dans le menu Administration ==> ACL
2. Dans le menu de gauche, cliquez sur Gestion des accs sur les actions
3. Cliquez sur Ajouter

Les champs Nom de laction et Description contiennent le nom du filtre ainsi que sa description
La liste Groupes lis permet dassocier un groupe daccs au filtre
Le tableau ci-dessous dcrit les fonctionnalits gnrales daccs :

178 Chapitre 7. Guide exploitation


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Champ Actions associes
Afficher les statistiques des htes et Affiche les statistiques de supervision sous forme de tableau prsent
services dans le bandeau dans le bandeau de Centreon
Afficher les statistiques des collecteurs Affiche les statistiques des collecteurs en haut droite (voir la case
dans le bandeau Etat des collecteurs)
Afficher la liste des collecteurs Affiche la liste des collecteurs dans Supervision ==> Htes ou
Supervision ==> Services
Le tableau ci-dessous dcrit lensemble des actions qui peuvent tre autorises sur lordonnanceur :
Champ Actions associes
Afficher les statistiques des htes et Affiche les statistiques de supervision sous forme de tableau prsent
services dans le bandeau dans le bandeau de Centreon
Afficher les statistiques des collecteurs Affiche les statistiques des collecteurs en haut droite (voir la case
dans le bandeau Etat des collecteurs)
Afficher la liste des collecteurs Affiche la liste des collecteurs dans Supervision ==> Htes ou
Supervision ==> Services
Arrter lordonnanceur Autoriser larrt de lordonnanceur
Redmarrer lordonnanceur Autoriser le redmarrage de lordonnanceur
Activer/Dsactiver les notifications Activer/Dsactiver lenvoi de notifications
Activer/Dsactiver les contrles des Activer/Dsactiver les contrles des services
services
Activer/Dsactiver les contrles passifs Activer/Dsactiver les contrles passifs pour les services
des services
Activer/Dsactiver les contrles des htes Activer/Dsactiver les contrles sur les htes
Activer/Dsactiver les contrles des Activer/Dsactiver les contrles passifs pour les htes
passifs dhtes
Activer/Dsactiver le gestionnaire Activer/Dsactiver le gestionnaire dvnement
dvnements
Activer/Dsactiver la dtection de Activer/Dsactiver la dtection du statut FLAPPING (ou bagotage)
bagotage
Activer/Dsactiver la commande post Activer/Dsactiver la commande post-contrle des services
contrle des services
Activer/Dsactiver la commande post Activer/Dsactiver la commande post-contrle des htes
contrle des htes
Activer/Dsactiver les donnes de Activer/Dsactiver les donnes de performances
performance
Le tableau ci-dessous dcrit lensemble des actions qui peuvent tre autorises sur les services :

7.2. Les listes de contrles daccs 179


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Champ Actions associes
Activer/Dsactiver les vrifications pour un Activer/Dsactiver les vrifications pour un service
service
Activer/Dsactiver les notifications pour un Activer/Dsactiver les notifications pour un service
service
Prendre en compte un incident dun service Permettre aux utilisateurs dacquitter un service
Supprimer la prise en compte dun service Permettre aux utilisateurs de supprimer un acquittement de
service
Re-planifier la prochaine vrification dun Re-planifier la prochaine vrification dun service
service
Re-planifier la prochaine vrification dun Re-planifier la prochaine vrification dun service (Forc)
service (Forc)
Planifier un temps darrt pour un service Planifier un temps darrt pour un service
Ajouter/Supprimer un commentaire pour un Autoriser lajout de commentaires pour un service
service
Activer/Dsactiver le gestionnaire dvnement Activer/Dsactiver le gestionnaire dvnement pour un
pour un service service
Activer/Dsactiver la dtection de bagotage Activer/Dsactiver la dtection du statut FLAPPING (ou
dun service bagotage) pour un service
Activer/Dsactiver le contrle passif dun Activer/Dsactiver le contrle passif pour les services
service
Soumettre un rsultat pour un service Autoriser la soumission dun rsultat pour un service
Le tableau ci-dessous dcrit lensemble des actions qui peuvent tre autorises sur les htes :
Champ Actions associes
Activer/Dsactiver les vrifications pour un Activer/Dsactiver les vrifications pour un hte
hte
Activer/Dsactiver les notifications pour un Activer/Dsactiver les notifications pour un hte
hte
Prendre en compte un incident dun hte Permettre aux utilisateurs dacquitter un hte
Supprimer la prise en compte dun hte Permettre aux utilisateurs de supprimer un acquittement dun
hte
Re-planifier la prochaine vrification dun hte Re-planifier la prochaine vrification dun hte
Re-planifier la prochaine vrification dun hte Re-planifier la prochaine vrification dun hte (Forc)
(Forc)
Planifier un temps darrt pour un hte Planifier un temps darrt pour un hte
Ajouter/Supprimer un commentaire pour un Autoriser lajout de commentaires pour un hte
hte
Activer/Dsactiver le gestionnaire dvnement Activer/Dsactiver le gestionnaire dvnement pour un hte
pour un hte
Activer/Dsactiver la dtection de bagotage Activer/Dsactiver la dtection du statut FLAPPING (ou
dun hte bagotage) pour un hte
Activer/Dsactiver les contrles des services de Activer/Dsactiver les contrles des services dun hte
lhte
Soumettre un rsultat pour un hte Autoriser la soumission dun rsultat pour un hte
Le champ Statut permet dactiver ou de dsactiver le filtre

7.2.5 Recalculer les ACLs

Il est possible de recalculer manuellement les ACLs :


1. Rendez-vous dans le menu Administration ==> ACL
2. Dans le menu de gauche, cliquez sur Recharger les ACL

180 Chapitre 7. Guide exploitation


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
3. Slectionnez le ou les utilisateurs pour lesquels vous souhaitez recharger les ACL
4. Dans le menu Plus dactions, cliquez sur Recharger les ACL

7.3 Les extensions

7.3.1 Les modules

Les modules permettent dajouter des fonctionnalits supplmentaires Centreon. Il est possible dinstaller des mo-
dules en utilisant lutilitaire YUM ou partir des fichiers sources (*.tar.gz).
Les modules sont regroups en 3 types :
Les modules communautaires, sous licence GPL v2, dvelopps par la communaut Centreon
Les modules core, sous licence GPL v2, dvelopps par lquipe Centreon
Les modules propritaires, soumis licence, dvelopps par la socit Centreon
Pour installer un module :
1. Installez le module partir de la documentation associe (le plus souvent dans le rpertoire
/usr/share/centreon/www/modules sur le serveur Central)
2. Rendez-vous dans le menu Administration ==> Extensions

3. Cliquez sur licne pour lancer linstallation du module


4. Cliquez maintenant sur Installer pour installer le module
Le tableau ci-dessous rsume les diffrentes colonnes de la page :

7.3. Les extensions 181


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Colonne Description
Nom Contient le nom du module
Nom rel Contient le nom complet du module
Informa- Contient des informations propos du module
tions
Version Indique la version du module
Auteur Indique lauteur du module
Date de fin Indique la date dexpiration de la licence
de licence
Install Indique si le module est install ou non
Statut Indique le statut du module : install, install mais sans licence, inconnu etc...
Actions Permet deffectuer certaines actions sur un module :
Pour installer un module, cliquez sur licne :
Pour configurer un module, cliquez sur licne
Pour supprimer un module, cliquez sur licne , puis confirmez la suppression

Pour mettre jour un module, cliquer sur licne puis suivre le processus

7.3.2 Les widgets

Les widgets permettent de construire de vritables vues personnalises, abordes au chapitre les vues personnalises.
Pour installer un widget :
1. Installez le widget partir de la documentation associe (le plus souvent dans le rpertoire
/usr/share/centreon/www/modules sur le serveur Central)
2. Rendez-vous dans le menu Administration ==> Extensions
3. Dans le menu de gauche, cliquez sur Configuration en dessous de Widgets

4. Cliquez sur licne pour lancer linstallation du widget


Le tableau ci-dessous rsume les diffrentes colonnes de la page :
Co- Description
lonne
Titre Contient le nom du widget
Des- Contient des informations propos du widget
crip-
tion
Ver- Indique la version du widget
sion
Auteur Indique lauteur du widget
Ac- Permet deffectuer certaines actions sur un widget :
tions
Pour installer un widget, cliquez sur licne
Pour supprimer un widget, cliquez sur licne , puis confirmez la suppression

Pour mettre jour un widget, cliquer sur licne puis suivre le processus

7.4 Les mdias

Les mdias sont des images utilises par linterface web de Centreon. Ces images sont utilises afin de pouvoir re-
prsenter de manire plus intuitive les ressources supervises, proposer des fonds de cartes pour des modules de
cartographie, ...

182 Chapitre 7. Guide exploitation


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
7.4.1 Gestion des images

Lensemble des images est stock dans le dossier /usr/share/centreon/www/img/media du serveur Centreon.
Il existe deux mthodes pour ajouter des images dans ce dossier :
Le faire manuellement
Utiliser la synchronisation automatique : cette mthode a lavantage de pouvoir importer plusieurs images la
fois.

Ajout manuel

Pour ajouter une image dans Centreon :


1. Rendez-vous dans le menu Administration ==> Options
2. Dans le menu de gauche, cliquez sur Mdias
3. Cliquez sur Ajouter
La fentre suivante saffiche :

Le champ Nouveau dossier ou dossier existant permet dajouter un nouveau dossier au sein du dossier
dimages ou de choisir un dossier dj existant dans lequel pourra tre copi limage
Le champ Image ou archive permet de slectionner limage ou lensemble dimages contenu dans une archive
qui sera importe
Le champ Commentaires permet de dcrire limage

Synchroniser les images

Pour synchroniser une ou plusieurs images dans les mdias Centreon :


1. Copiez vos images au sein du dossier dimage (les images peuvent tre situes dans des dossiers)
2. Assurez-vous que lutilisateur qui excute votre serveur web a les droits en lecture sur ces images
3. Rendez-vous dans le menu Administration ==> Options
4. Dans le menu de gauche, cliquez sur Mdias
5. Cliquez sur Synchroniser le rpertoire des images
La fentre suivante importe les nouvelles images :

7.4. Les mdias 183


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
7.5 Options dadministration de la plate-forme Centreon

Les options suivantes permettent de modifier les paramtres de larchitecture Centreon.

7.5.1 Centreon

Cette partie traite de la configuration des options gnrales de linterface web Centreon.
1. Rendez-vous dans le menu Administration ==> Options
2. Dans le menu de gauche, cliquez sur Options
3. Cliquez sur Centreon
La fentre suivante saffiche :

Le champ Rpertoire dsigne le rpertoire dans lequel Centreon est install


Le champ Rpertoire Web de Centreon indique le rpertoire web sur lequel est install Centreon
Le champ Limite par page (par dfaut) dfinit le nombre dobjet affich par page de Configuration

184 Chapitre 7. Guide exploitation


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Le champ Limite par page pour les pages de supervision dfinit le nombre dobjet affich par page au sein
du menu Supervision
Le champ Dure dexpiration de la session, exprim en minutes, indique la dure maximale dune session
Le champ Intervalle de rafrachissement, exprim en secondes, indique lintervalle de rafrachissement pour
les objets
Le champ Intervalle de rafrachissement pour la page des statistiques, exprim en secondes, indique lin-
tervalle de rafrachissement pour les objets de la page des statistiques
Le champ Intervalle de rafrachissement pour la page de supervision, exprim en secondes, indique lin-
tervalle de rafrachissement pour les objets de la page supervision
Le champ Dlai du premier rafrachissement pour la page des statistiques, exprim en secondes, indique
le dlai du premier rafrachissement pour la page des statistiques
Le champ Dlai du premier rafrachissement pour la page de supervision, exprim en secondes, indique le
dlai du premier rafrachissement pour la page de supervision
Le champ Utiliser le modle indique le thme utiliser pour linterface web de Centreon
Le champ Trier les problmes par permet de choisir comment trier les diffrents incidents dans le menu
Supervision
Le champ Affichage dordre des problmes indique lordre daffichage des incidents par ordre de gravit
croissant ou dcroissant
La case Activer la connexion automatique autorise les utilisateurs se connecter linterface web via le
mcanisme de connexion automatique
La case Afficher le raccourci de connexion automatique permet dafficher le raccourci de connexion en haut
droite
La case Activer lauthentification SSO active lauthentification SSO
Le champ Mode SSO indique si lauthentification doit avoir lieu uniquement par SSO ou bien en utilisant
lauthentification locale galement (Mixte)
Le champ Adresses des clients SSO de confiance indique quels sont les clients de confiance pour le SSO.
Chaque client de confiance est spar par une virgule
Le champ Entte HTTP SSO indique la variable de len-tte qui sera utilise comme login/pseudo.
La case Activer la gestion des dcalages horaire active la gestion du dcalage horaire
Le champ Timezone par dfaut de lhte permet de dfinit un timezone par dfaut pour application du dca-
lage horaire
Si la case Activer le mode strict de gestion des relations de parents est coche, alors loprateur ne peut
dfinir de relation de parents dhte en objets superviss par des collecteurs diffrents.
Le champ Adresse mail de contact du support (de la plate-forme de supervision) indique ladresse email
de support Centre des services du client pour la plate-forme Centreon. Cette adresse mail sera affiche en bas
de page sur le lien Centre des services

7.5.2 Supervision

Cette partie traite des options gnrales de linterface de supervision temps rel.
1. Rendez-vous dans le menu Administration ==> Options
2. Dans le menu de gauche, cliquez sur Options
3. Cliquez sur Supervision

7.5. Options dadministration de la plate-forme Centreon 185


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
La liste Moteur par dfaut dfinit le type dordonnanceur par dfaut
Le champ Unit de temps de rfrence indique lintervalle de temps en seconde utilis pour planifier les
contrles et les notifications
Le champ Rpertoire des images dfinit le rpertoire dimage dans lequel sont stocks les mdias
Le champ Rpertoire des sondes dfinit le rpertoire o se situent les sondes de supervision
La liste Broker utilis par Centreon dcrit le broker utilis par la plate-forme Centreon
Le champ Script de dmarrage du broker contient le chemin vers le script de dmarrage du broker
Le champ Chemin complet de lexcutable contient le chemin vers lexcutable permettant denvoyer des
mails
Les listes Nombre maximum dhtes afficher et Nombre maximum de services afficher contiennent le
nombre maximal dhte ou de services afficher dans la vue densemble (menu Accueil ==> Accueil)
Le champ Intervalle de rafrachissement de la page dfinit lintervalle de rafrachissement des donnes dans
la vue densemble
Les cases contenues dans les catgories Options dacquittement par dfaut et Options de temps darrt
par dfaut dfinissent les options par dfaut qui seront coches ou non lors de la dfinition dun acquittement
ou dun temps darrt
Le champ Dure permet de dfinir la dure par dfaut dun temps darrt

7.5.3 CentCore

Cette partie permet de paramtrer le fonctionnement du processus CentCore.


1. Rendez-vous dans le menu Administration ==> Options
2. Dans le menu de gauche, cliquez sur Options
3. Cliquez sur CentCore

186 Chapitre 7. Guide exploitation


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Le champ Activer la synchronisation des donnes de performance active la synchronisation des donnes de
performances entre le serveur central et les serveurs satellites (inutile avec Centreon Broker)
Le champ Activer la synchronisation des journaux dvnements active la synchronisation des journaux
entre le serveur central et les serveurs satellites
Le champ Activer la rcupration des statistiques de Centreon Broker active la rcupration des statistiques
de Centreon Broker par CentCore. Cette option peut tre bloquante car la lecture du tuyau (pipe) peut tre une
action bloquante
Le champ Temps maximum dexcution des commandes Centcore permet de dfinir un temps de dexcu-
tion maximal des commandes locales et via SSH du processus

7.5.4 Couleurs

Cette partie permet de paramtrer les couleurs utilises dans linterface web pour dfinir les diffrents statuts des htes
et des services.
1. Rendez-vous dans le menu Administration ==> Options
2. Dans le menu de gauche, cliquez sur Options
3. Cliquez sur Couleurs

Vous pouvez modifier une couleur en saisissant le code HTML de celle-ci ou en cliquant sur Modifier. Une nouvelle
fentre souvrira pour slectionner la couleur dsire.

7.5. Options dadministration de la plate-forme Centreon 187


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
7.5.5 LDAP

Cette partie permet de configurer la connexion au(x) annuaire(s) LDAP.


Pour ajouter un nouvel annuaire :
1. Rendez-vous dans le menu Administration ==> Options
2. Dans le menu de gauche, cliquez sur Options
3. Cliquez sur LDAP
4. Cliquez sur Ajouter

188 Chapitre 7. Guide exploitation


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Les champs Nom de la configuration et Description dfinissent le nom et la description du serveur LDAP
Le champ Activer lauthentification LDAP permet dactiver lauthentification travers le serveur LDAP
Le champ Sauvegarde du mot de passe LDAP permet de stocker le mot de passe des utilisateurs en base de
donnes, utile en cas de perte de connexion avec lannuaire pour authentifier les utilisateurs
Le champ Import automatiques des utilisateurs permet dimporter automatiquement les utilisateurs de lan-
nuaire LDAP dans Centreon. En cliquant sur Importer les utilisateurs manuellement, vous pouvez choisir
les utilisateurs que vous souhaitez importer
Note : Si loption Import automatiques des utilisateurs est coche, alors pour toute nouvelle personne qui se
connecte linterface Centreon, ses paramtres LDAP seront automatiquement imports dans Centreon (nom, prnom,
adresse mail, ...). Les profils ACL seront appliqus lors de laccs (Lien vers Les ACLs). Par contre, si cette option
nest pas coche, seuls les utilisateurs imports manuellement pourront sauthentifier.

Le champ Taille limite de la recherche LDAP permet de limiter la taille de la recherche des utilisateurs
Le champ Temps maximum dexcution de la recherche LDAP permet de dfinir le temps maximum de la
recherche LDAP
Le champ Modle de contact dfinit le modle de contact qui sera li pour tous les utilisateurs imports depuis
cet annuaire LDAP
Le champ Utiliser le service DNS indique sil faut utiliser le serveur DNS pour rsoudre ladresse IP de
lannuaire LDAP
Le champ LDAP servers permet dajouter un ou plusieurs annuaires LDAP vers lequel Centreon va se connec-
ter.

7.5. Options dadministration de la plate-forme Centreon 189


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Le tableau ci-dessous rsume les diffrents paramtres insrer pour ajouter un serveur LDAP :
Colonne Description
Adresse du serveur Contient ladresse IP ou nom DNS du serveur LDAP
Port Indique le port de connexion pour accder lannuaire LDAP
SSL Indique si le protocole SSL est utilis pour la connexion au serveur
TLS Indique si le protocole TLS est utilis pour la connexion au serveur
Les champs Utilisateur du domaine et Mot de passe dfinissent le nom dutilisateur et le mot de passe pour
se connecter au serveur LDAP
Le champ Version du protocole indique la version du protocole utiliser pour se connecter
La liste Modle permet de prconfigurer les filtres de recherches des utilisateurs sur lannuaire LDAP. Ces
filtres permettant de proposer par dfaut une recherche sur un annuaire de type MS AD ou de type Posix.

Note : Avant tout import, vrifiez les paramtres par dfaut proposs. Si vous navez slectionn aucun modle, vous
devez dfinir manuellement les filtres de recherches en compltant les champs.

Sous centos 6, on peut dfinir de ne pas vrifier le certificat serveur avec la procdure suivante :
Ajouter la ligne suivante dans le fichier /etc/openldap/ldap.conf :
TLS_REQCERT never

Puis redmarrez le serveur Apache :


/etcInit.d/httpd restart

7.5.6 RRDTool

Cette partie permet de configurer le moteur de gnration des graphiques RRDTool ainsi que les tailles des polices
utilises pour la prsentation de ces derniers.
1. Rendez-vous dans le menu Administration ==> Options
2. Dans le menu de gauche, cliquez sur Options
3. Cliquez sur RRDTool

190 Chapitre 7. Guide exploitation


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Le champ Chemin complet de lexcutable RRDTOOL dfinit le chemin vers lexcutable RRDTool
Les champs appartenant aux catgories Proprits du titre, Proprits de lunit, Proprits des axes, Pro-
prits de la lgende, Proprit du filigrane permettent de dfinir la police ainsi que la taille de la police pour
la proprit slectionne
Le champ Activer RRDCached permet dactiver le processus RRDcached (Ne fonctionne quavec le broker
Centreon Broker)
Le champ Port TCP dfinit le port sur lequel coute RRDcached (ne pas activer la connexion TCP)
Le champ Chemin daccs au socket Unix dfinit le chemin vers le socket Unix
Warning : Nactivez RRDCacheD que si votre plate-forme de supervision rencontre de trop nombreux accs
disques concernant lcriture des donnes dans les fichiers RRD.

7.5.7 Debogage

Cette partie permet de configurer lactivation de la journalisation de lactivit des processus Centreon.
1. Rendez-vous dans le menu Administration ==> Options
2. Dans le menu de gauche, cliquez sur Options
3. Cliquez sur Dbogage

7.5. Options dadministration de la plate-forme Centreon 191


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Le champ Rpertoire denregistrement des journaux dfinir le chemin o seront enregistrs les journaux
dvnements
La case Enregistrer les authentifications permet de journaliser les authentifications linterface Centreon
La case Dbogage du moteur de supervision active la journalisation du dbogage de lordonnanceur
La case Dbogage RRDTool active la journalisation du dbogage du moteur de graphique RRDTool
La case Dbogage de limport dutilisateurs LDAP active la journalisation du dbogage de limport des
utilisateurs LDAP
La case Enregistrer les requtes SQL active la journalisation des requtes SQL excutes par linterface
Centreon
La case Dbogage processus Centcore active la journalisation du dbogage du processus Centcore
La case Dbogage du processus Centstorage active la journalisation du dbogage du processus Centstorage
La case Dbogage du moteur de traitement des traps SNMP (centreontrapd) active la journalisation du
dbogage du processus Centreontrapd

7.5.8 CSS

Cette partie permet de configurer laspect des diffrents menus de linterface Centreon.
1. Rendez-vous dans le menu Administration ==> Options
2. Dans le menu de gauche, cliquez sur Options
3. Cliquez sur CSS

Pour chaque menu, il est possible de dfinir une feuille de style CSS. Exemples : Le fichier blue_css.php rendra le
menu bleu. Le fichier green_css.php rendra le menu vert et ainsi de suite.

7.6 Journalisation des modifications de configuration

7.6.1 Principe

Par dfaut, Centreon conserve dans un journal toutes les actions utilisateurs concernant la modification de la confi-
guration de la supervision. Pour accder ces informations, rendez-vous dans le menu Administration ==> Journal
dvnements.

192 Chapitre 7. Guide exploitation


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
La barre de recherche grise vous permet de filtrer les informations prsentes via les filtres :
Objet permettant de filtrer sur le nom de lobjet (hte, service, contact, dfinition de trap SNMP, groupe, ...)
Utilisateur permettant de filtrer par auteur de modification
Type dobjet permettant de filtrer par type dobjet modifi.

7.6.2 Pratique

Exemple : Pour voir toutes les actions faites par lutilisateur admin, renseignez admin dans le champ Utilisateur
puis cliquez sur Rechercher.
Le tableau ci-dessous dfinit les colonnes du tableau de rsultats :
Colonne Description
Heures Indique la date et lheure de lvnement
Type de modification Contient le type daction effectue. Il existe plusieurs
types dactions possibles :
Added : Indique que lobjet a t ajout
Changed : Indique que lobjet a t modifi
Deleted : Indique que lobjet a t supprim
Massive Change : Indique un changement massif
de configuration sur des objets
Enabled : Indique que lobjet a t activ
Disabled : Indique que lobjet a t dsactiv

Type Indique le type dobjet concern


Objet Indique le nom de lobjet concern
Auteur Indique lutilisateur ayant effectu cette modification
En cliquant sur le nom dun objet, vous pouvez visualiser lhistorique des modifications ralises sur ce dernier.

Le tableau ci-dessous dfinit les colonnes du tableau des modifications :

7.6. Journalisation des modifications de configuration 193


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Colonne Description
Date Date et heure de la modification
Nom de lutilisateur Nom de la personne ayant ralis la modification
Type Type de modification
La dernire colonne dcrit la modification en elle-
mme :
Nom du champ : Dcrit le champ du formulaire
modifi
Avant : Indique lancienne valeur
Aprs : Indique la nouvelle valeur

7.7 Etat du serveur

Le sous-menu Etat du serveur permet de visualiser ltat gnral des ordonnanceurs de supervision, du systme
dexploitation du serveur central ainsi que des bases de donnes.

7.7.1 Informations sur le processus

1. Rendez-vous dans le menu Administration ==> Etat du serveur


2. Dans le menu de gauche, cliquez sur Informations sur le processus

Cette page vous permet davoir un rsum concernant tous les moteurs de supervision de votre infrastructure, ordon-
nanceur par ordonnanceur. La liste Collecteur permet de choisir le collecteur pour lequel on souhaite visualiser les
informations. Le tableau Information du processus dordonnancement vous permet de visualiser toutes les infor-
mations lies au moteur de supervision.
Le tableau ci-dessous rsume lensemble des actions possibles dans le tableau Commandes du processus.

194 Chapitre 7. Guide exploitation


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Ligne Description
Arrter le moteur de supervision Permet darrter le moteur de supervision
Redmarrer le processus de Permet de redmarrer le moteur de supervision
supervision
Dsactiver les notifications Dsactive lenvoi de notification par le moteur de supervision
Arrter lexcution des contrles de Arrte la vrification des services actifs
services
Arrter le contrle passif des Arrte la vrification des services passifs
services
Arrter le contrle des htes Arrte la vrification des htes actifs
Arrter le contrle passif des htes Arrte la vrification des htes passifs
Arrter le gestionnaire dvnements Arrte le gestionnaire dvnements
Dmarrer lexcution des Dmarre les commandes de post-contrles
commandes post contrle
Dmarrer le suivi prcis des htes Dmarre le gestionnaire de journalisation du suivi post-contrle des htes
Dmarrer la dtection de bagotage Dmarre la dtection de bagotage des statuts
des statuts
Activer le traitement des donnes de Active la gnration dun fichier contenant les donnes de performances
performance (inutile avec Centreon Broker)

7.7.2 Information sur le systme

1. Rendez-vous dans le menu Administration ==> Etat du serveur


2. Dans le menu de gauche, cliquez sur Informations sur le systme

La page qui saffiche vous permet de visualiser toutes les caractristiques du serveur central.

7.7. Etat du serveur 195


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Note : Les informations affiches proviennent du module phpSysInfo

7.7.3 Base de donnes

1. Rendez-vous dans le menu Administration ==> Etat du serveur


2. Dans le menu de gauche, cliquez sur Bases de donnes

La page qui saffiche vous permet de visualiser la place utilise par les diffrentes bases de donnes prsentes sur le
serveur.

7.8 Le processus de notifications dans Centreon

7.8.1 Notifier un contact dans Centreon

Avant quun contact soit notifi au sein de Centreon, il est ncessaire de respecter plusieurs tapes. Si aucune escalade
de notification nest dfinie, le processus de gestion des notifications est standard. Celui-ci est dcrit ci-dessous :
1. Un service (ou un hte) est vrifi intervalle rgulier en fonction de la priode temporelle de vrifications
dfinie pour lui (Dans le cas dun service passif, on attend que le statut du service change dtat)
2. Lorsquune anomalie survient (statut non-OK), le service (ou lhte) passe en tat SOFT
3. Aprs que le nombre maximum de vrifications avant validation de ltat ait eu lieu et si le service (ou lhte)
persiste en conservant son statut non-OK son tat passe de SOFT HARD. Le moteur de supervision met en
cache le numro de la notification pour le service (ou lhte) : cest dire 0.
A chaque intervalle denvoi de notification pour le service (ou lhte) et jusqu la fin du statut non-OK, le moteur de
supervision ralise les oprations suivantes :
4. Le moteur de supervision vrifie que la priode temporelle de notifications dfinie pour le service (ou lhte)
permet la notification linstant o le service (ou lhte) est pass en tat HARD. Si oui, alors on passe ltape
suivante sinon, on attend que la priode temporelle dfinie pour le service (ou lhte) permette la notification.
5. Le moteur de supervision vrifie que la notification est active pour le statut actuel du service (ou de lhte)
Pour chaque contact associ au service (ou lhte) :
6. Le moteur de supervision vrifie plusieurs paramtres :
Est-ce que les notifications sont actives pour ce contact ?
Est-ce que la priode temporelle de notifications dfinie pour le contact permet la notification ?
Est-ce que le contact est configur pour tre notifi pour le statut actuel du service (ou lhte) ?

7. Si ces trois conditions sont valides, alors le moteur de supervision alerte le contact en utilisant le script de
notifications dfinit pour le service ou lhte.
8. Le moteur de supervision incrmente le numro de notification de 1

Le schma ci-dessous rsume la gestion des notifications au sein de Centreon :

196 Chapitre 7. Guide exploitation


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
7.8. Le processus de notifications dans Centreon 197
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
7.8.2 Les escalades de notifications au sein de Centreon

Les escalades de notifications permettent deux choses :


Notifier des contacts diffrents en fonction du nombre de notifications envoyes
Changer de moyens de notifications au cours du temps
En cas dutilisation des escalades de notifications, la rcupration de la liste de contact est quelque peu diffrente :
1. Un service (ou un hte) est vrifi intervalle rgulier en fonction de la priode temporelle de vrification
dfinie pour lui
2. Lorsquune anomalie survient (statut non-OK), le service (ou lhte) passe en tat SOFT
3. Aprs que le nombre maximum de vrifications avant validation de ltat ait eu lieu, si le service (ou lhte)
persiste en conservant son statut non-OK son tat passe de SOFT HARD. Le moteur de supervision met en
cache le numro de la notification pour le service (ou lhte) : cest dire 0.
A chaque intervalle denvoi de notification pour le service (ou lhte) et jusqu la fin du statut non-OK le moteur de
supervision ralise les oprations suivantes :
1. Si aucune escalade de notification nest dfinie pour le service (ou lhte) et le numro actuel de notification,
alors le traitement de la notification est fait de la mme manire que pour une notification classique : le moteur
de supervision utilise la configuration de notifications dfinie pour le service (ou lhte).
2. Si une escalade de notification est dfinie pour le service (ou lhte) et le numro actuel de notification, alors
le moteur de supervision se base sur la configuration de lescalade afin de slectionner les contacts notifier et
les moyens utiliser.
3. Le mcanisme de traitement dune notification est le mme que pour lenvoi dune notification normale
Pour rappel, la configuration des escalades de notifications est dfinie dans le chapitre Les escalades de notifications.

7.9 Grer les dpendances logiques

Vous avez vu dans le chapitre sur la configuration des dpendances comment configurer des dpendances entre objets
(htes, services, groupes dhtes, ...). Ce sous-chapitre permet dillustrer lutilisation de ces dpendances au travers de
quelques cas concrets.

Note : Les dpendances reposent sur des critres dchec savoir ne pas faire si. Ne pas notifier si le service est
dans un tat Critique. Ne pas excuter le contrle si le service est dans un tat Critique, dAlerte, Inconnu, ...

7.9.1 Dpendance dun service

Un service est vrifi en utilisant un scnario Slnium. Ce scnario se connecte une interface web avec un identifiant
et un mot de passe. Ces informations de connexions sont stockes dans une base de donnes MySQL.
Par consquent, si jamais le serveur de base de donnes ne rpond plus, alors le scnario Slnium ne peut aboutir.
Il parait vident quil est ncessaire de crer un lien de dpendance logique entre le service qui utilise le scnario
Slnium et le service qui est charg de vrifier le statut du serveur MySQL.
De plus, tant donn que le scnario Slnium ne peut pas sexcuter correctement, aucune donne de performances
ne peut tre stocke en base de donnes. Il faut donc arrter non seulement la notification pour le service utilisant le
scnario Slnium mais aussi la vrification.
Afin de crer cette dpendance :
1. Rendez-vous dans le menu Configuration ==> Notifications
2. Dans le menu de gauche en dessous de Dpendances, cliquez sur Services
3. Cliquez sur Ajouter

198 Chapitre 7. Guide exploitation


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
4. Entrez le nom et la description de la dpendance
5. Pour les champs Critres dchec dexcution et Critres dchec de notification, cochez Alerte, Critique,
Inconnu et En attente
6. Dans la liste Service, slectionnez le service qui est charg de vrifier le statut du serveur MySQL
7. Dans la liste Services dpendants, slectionnez le service qui utilise le scnario Slnium
8. Sauvegardez
A partir de ce moment, si le service charg de vrifier le statut du serveur MySQL a un statut Alerte, Critique,
Inconnu ou En attente, alors le service charg dexcuter le scnario Slnium ne sera plus excut jusqu ce que
le service matre redevienne OK.

7.9.2 Dpendance dun hte

Prenons le cas de deux htes qui fonctionnent en cluster. Trois htes sont crs afin de pouvoir superviser ce cluster :
un hte A, un hte B (tous les deux membres du cluster) et un hte C (qui centralise les informations du cluster).
Si jamais, lhte A ou lhte B a un statut non-OK, alors les services de lhte C sera automatiquement considr
comme non-OK. Il est donc ncessaire dajouter une dpendance qui empche lenvoi de notifications si jamais lhte
A ou lhte B devient dfaillant. Cependant, la remonte des donnes de performances doit toujours tre fonctionnelle,
cest pourquoi il est ncessaire de continuer la supervision de lhte C.
Afin de crer cette dpendance :
1. Rendez-vous dans le menu Configuration ==> Notifications
2. Dans le menu de gauche en dessous de Dpendances, cliquez sur Htes
3. Cliquez sur Ajouter
4. Entrez le nom et la description de la dpendance
5. Pour le champ Critres dchec de notification, cochez Alerte, Critique, Inconnu et En attente
6. Dans la liste Nom dhtes, slectionnez lhte A
7. Dans la liste Nom dhte lis, slectionnez lhte C
8. Sauvegardez
Rptez cette opration pour lhte B.

7.9.3 Dpendance dun groupe de service

Prenons lexemple dun ensemble de services Oracle sur lequel se base lapplication ERP. Il faut deux groupes de
services :
Le groupe Application Oracle
Le groupe Application ERP
Si les services Oracle deviennent critiques, alors les services de lapplication ERP sont automatiquement critiques.
Il est ncessaire de crer un lien de dpendance afin dempcher la vrification et la notification des services de
lapplication ERP si lapplication Oracle est non-OK.
Afin de crer cette dpendance :
1. Rendez-vous dans le menu Configuration ==> Notifications
2. Dans le menu de gauche en dessous de Dpendances, cliquez sur Groupes de services
3. Cliquez sur Ajouter
4. Entrez le nom et la description de la dpendance
5. Pour le champ Critres dchec dexcution et Critres dchec de notification, cochez Critique et En attente
6. Dans la liste Noms des groupes de services, slectionnez le groupe de services Application Oracle
7. Dans la liste Noms des groupes de services lis, slectionnez le groupe de services Application ERP
8. Sauvegardez

7.9. Grer les dpendances logiques 199


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
7.10 Grer les groupes et les catgories

Au sein de Centreon, il est possible de regrouper un ou plusieurs objets au sein de diffrents groupes :
Les groupes dhtes
Les groupes de services
Les groupes de contacts
Il est galement possible de crer des catgories dhtes ou de services.

7.10.1 Les groupes

Dune manire gnrale, les groupes sont des containeurs permettant de regrouper un ensemble dobjet possdant une
proprit commune :
Mme identit matrielle (serveurs Dell, HP, IBM, ...), identit logique (quipements rseau) ou identit go-
graphique (Europe, Asie, Afrique, Amrique du nord, ...)
Appartenance une mme application (application CMS, ...) ou un mme secteur dactivit (Gestion de la
paie, ...)
...

Les groupes dhtes et de services

Les groupes dhtes et de services permettent de regrouper des objets par entits logiques. Ils sont utiliss pour :
La configuration des ACLs afin de lier un ensemble de ressources un type de profil
Permettre de visualiser les rapports de disponibilit par groupe. Gnrer un rapport de disponibilit des res-
sources Agence Paris.
Permettre de visualiser le statut dun ensemble dobjets en slectionnant dans les filtres de recherche un groupe
dobjets
Rechercher rapidement un plusieurs graphiques de performances en parcourant larbre des objets par groupes
puis par ressource
Dune manire gnrale, on cherche regrouper les htes par niveau fonctionnel. Exemple : Htes DELL, HP ou
encore Htes Linux, Windows... On cherche galement regrouper les services par applications mtiers. Exemple :
Application de gestion de la paie, Application ERP, ...

Note : Pour les htes appartenant un groupe dhtes, la rtention des fichiers RRD peut tre dfinie au sein du
groupe dhtes auquel il appartient. Cette dfinition vient surcharger la dfinition globale. Dans le cas o un mme hte
appartient plusieurs groupes possdant chacun une dfinition de rtention, la valeur la plus leve sera slectionne
pour lhte.

Les groupes de contacts

Les groupes de contacts sont utiliss pour pouvoir notifier des contacts :
Lors de la dfinition dun hte ou dun service
Lors de la dfinition dune escalade de notifications
De plus, les groupes de contacts sont galement utiliss lors de la dfinition dun groupe daccs.
Par consquent, il est ncessaire de regrouper les contacts dune manire logique. La plupart du temps, ils sont regrou-
ps suivant leurs rles au sein du systme dinformations. Exemple : DSI, Administrateurs Windows, Administrateurs
Linux, Responsable de lapplication de Gestion de la paie, ...

200 Chapitre 7. Guide exploitation


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
7.10.2 Les catgories

Dune manire gnrale, les catgories servent soit dfinir un niveau de criticit pour un hte ou un service, soit
regrouper techniquement un ensemble dobjets (services lis une excution de requte sur un SGBD MariaDB, ...).
La bonne pratique demande ce quon regroupe des htes ou des services au sein de catgories pour pouvoir faciliter
le filtrage de ces objets au sein dACL. Les catgories sont galement utilises pour dfinir des types dobjets au sein
du module Centreon MAP ou pour classer les objets au sein de sous-groupes dans le module Centreon BI.

7.11 Gestion des traps SNMP avec Centreon

7.11.1 Recevoir des traps SNMP avec Centreon

Ce sous-chapitre prsente les diffrentes tapes afin de pouvoir superviser un quipement en utilisant les traps SNMP.

Importation des traps SNMP

Afin dimporter les traps SNMP, vous devez respecter les tapes suivantes :
1. Crez un constructeur li le trap SNMP que vous avez cr, voir le sous-chapitre associ
2. Importez la MIB au sein de linterface web de Centreon, voir le sous-chapitre associ
Lors de limportation dun fichier MIB, il est possible que des dpendances soient ncessaires durant limport au
niveau de votre serveur. Afin de pouvoir trouver les dpendances de vos MIB, il faut ouvrir votre fichier de MIB via
un diteur de texte standard, puis :
1. Reprez la ligne qui commence par IMPORTS
2. Toutes les dpendances ncessaires limportation de votre fichier de MIB se situent aprs le mot cl FROM
Exemple :

Dans le fichier de MIB montr ci-dessus, il existe 4 dpendances ncessaires limportation de la MIB : SNMPv2-
SMI, SNMPv2-TC, SNMPv2-CONF, SNMP-FRAMEWORK-MIB. Une fois limportation termine, il est ncessaire
de modifier la dfinition du trap afin de modifier le statut par dfaut du trap :
1. Rendez-vous dans le menu Configuration ==> Traps SNMP
2. Cliquez sur le trap que vous souhaitez modifier.
En fonction du message associ au trap, modifiez le statut par dfaut du service. Dans le cas o le statut du service
dpend du message reu, utilisez le mode de correspondance avanc.

7.11. Gestion des traps SNMP avec Centreon 201


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Crer un modle de service passif

Afin de faciliter la configuration des services utilisant les traps SNMP, il est plus pratique de crer un modle de service
passif. De cette manire, lors de la cration dun service il ne restera plus qu faire hriter le service partir de ce
modle et de lier le trap ou les traps SNMP associs ce service.
1. Rendez-vous dans le menu Configuration ==> Services
2. Dans le menu de gauche, cliquez sur Modles
3. Cliquez sur Ajouter
Le tableau ci-dessous rsume lensemble des attributs dun modle de service passif :
Attributs Description
Onglet Configuration du service
Alias TRAP
Nom du service generic-service-passif
Priode de contrle 24x7
Commande de vrification check_centreon_dummy
Arguments Status : 0 Output : Aucun trap reu depuis 24 heures
Nombre maximum de contrle 1
Contrles actifs actives Non
Contrles passifs actives Oui
Onglet Traitement des donnes
Contrler la fracheur du rsultat TRAP
Seuil de fraicheur du rsultat 86400 (24 heures)
Note : La sonde check_centreon_dummy sera appele si aucun trap nest reu sous 24 heures.

Cration du service

Puis, crez le service et associez ce dernier au modle de service passif. Il ne vous reste plus qu vous rendre dans
longlet Relations et de renseigner, au sein du champ Traps SNMP, les traps SNMP qui pourront modifier le statut
du service.
Maintenant, rgnrez les fichiers de configuration pour prendre en compte ces changements.

Simuler lenvoi dun trap

Afin de tester que la rception des traps SNMP fonctionne correctement sur votre quipement. Vous pouvez envoyer
un vnement SNMP fictif votre serveur de supervision en utilisant lutilitaire en ligne de commandes snmptrap.
Syntaxe :
snmptrap -v SNMP-VERSION -c COMMUNITY IP-DESTINATION UPTIME TRAP-OID PARAMETER-OID PARAMETER-TYPE PAR

Avec :
SNMP-VERSION : version du protocole SNMP. Pour la syntaxe ci-dessus, cest obligatoirement 2c
COMMUNITY : communaut SNMP
DESTINATION-IP : IP de destination du trap SNMP. Cela peut tre un poller ou le serveur Centreon
TRAP-OID : OID contenant ENTERPRISE-OID plus lOID du trap SNMP afin de former lOID complet
UPTIME : temps en secondes depuis le dernier redmarrage de lquipement. Lorsque lon prcise une chane
vide, cet argument est automatiquement rempli par le binaire snmptrap
Tout paramtre supplmentaire au trap SNMP doit contenir les 3 variables suivantes. Elles doivent tre rptes pour
chaque paramtre supplmentaire :

202 Chapitre 7. Guide exploitation


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
PARAMETER-OID : OID contenant ENTERPRISE-OID plus lOID du trap SNMP afin de former lOID du
paramtre
PARAMETER-TYPE : type de paramtr, i pour Integer , s pour String , etc.
PARAMETER-VALUE : valeur lie au paramtre. Mettre entre guillemets une chane de caractres contenant
des espaces
Exemple de trap pour simuler un vnement linkUp sur linterface eth0 :
snmptrap -v2c -c public 192.168.1.1 .1.3.6.1.6.3.1.1.5.4 ifIndex i 2 ifDescr s eth0 ifAdminStatus

7.11.2 Modifier le message de sortie

Utiliser lensemble des arguments

Pour un trap SNMP, lors de la configuration du message de sortie, largument $* permet dafficher lensemble des
informations (valeur des arguments) contenu au sein du trap SNMP. Cependant, il est possible dafficher uniquement
certaines informations contenues au sein du trap SNMP en appelant unitairement les arguments.
Exemple :

Le message de sortie Link down on interface $2. State : $4. permet dafficher uniquement le nom de linterface et
ltat de celle-ci (argument $2 et $4).
O trouver les arguments ?
Les arguments se trouvent au sein de la documentation de la MIB de votre constructeur ou bien au sein du champ
Commentaires de votre trap SNMP.
Par exemple :

Pour afficher :
Lindex du lien tomb, utilisez largument $1
Le nom de linterface tombe, utilisez largument $2
Ltat administratif de linterface, utilisez largument $3
Ltat de linterface, utilisez largument $4

7.11. Gestion des traps SNMP avec Centreon 203


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Par exemple, le message de sortie suivant permet dafficher lensemble des arguments :

Link down on interface: $2 (index: $1). Operational state: $4, Administration state: $3

Effectuer un contrle actif suite la reception dun trap

Il est possible par lutilisation de loption Reprogrammer les services associs de raliser un contrle actif sur le
service suite la rception du trap SNMP.
Le contrle actif dfini au niveau du service est alors effectu.

Executer une commande spciale

Centreontrapd peut xecuter une commande spciale suite la rception dun trap SNMP. Pour utiliser cela, il suffit
de cocher loption Executer une commande spcial et dcrire la commande voulue.

Utiliser lensemble des arguments (via les OID)

Il est galement possible de rcuprer directement la valeur dun argument sans connatre son ordre darrive ($1, $2,
$3, ...). Pour cela, utilisez lOID complet de largument.
Voici un exemple :
Link down on interface: @{.1.3.6.1.2.1.2.2.1.2} (index: @{.1.3.6.1.2.1.2.2.1.1}). Operational state:

Utiliser une variable externe

Il est galement possible de modifier le message de sortie en rcuprant des informations via des scripts ou commandes
externes et de rcuprer le rsultat pour linsrer au sein du message. Pour cela, au sein de la dfinition de votre trap
SNMP, rendez-vous dans longlet Avanc et ajoutez une (ou plusieurs) commande(s) PREEXEC.
Exemple :

La premire commande est snmpget -v 2c -Ovq -c public @HOSTADDRESS@ ifAlias.$1 et permet de rcuprer
lalias de linterface. La variable $1 correspond ici la valeur associe largument 1 des traps linkUp/linkDown,
soit lindex.
La seconde commande contient snmpget -v 2c -Ovq -c public @HOSTADDRESS@ ifSpeed.$1 et permet de r-
cuprer la vitesse de linterface. La variable $1 correspond ici la valeur associe largument 1 des traps lin-
kUp/linkDown, soit lindex.
Pour utiliser le rsultat de la premire commande dans le message de sortie, utilisez largument $p1 et pour utiliser le
rsultat de la seconde commande dans le message de sortie, utilisez largument $p2.
Par consquent, nous pouvons dduire le message de sortie suivant :

Link down on interface: $2 (index: $1). Operational state: $4, Administration state: $3, Alias : $p1,

204 Chapitre 7. Guide exploitation


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Utiliser une expression rgulire

Il est galement possible de modifier le message de sortie en utilisant une expression rgulire par lintermdiaire de
loption Output Transform. Il suffit de renseigner une expression rgulire et elle sera xcute la rception dun
trap SNMP.
Par exemple :

s/\|/-/g

Remplacera les occurences | dans le message de sortie du trap SNMP par -.

7.11.3 Router/transfrer les traps SNMP

Parfois, il existe un concentrateur de traps SNMP au sein dune socit. Exemple : Oracle GRID. Oracle GRID est
charg de fdrer les informations de tous les serveurs Oracle en cas de ncessit, cest le serveur Oracle GRID qui
envoie un trap SNMP au serveur de supervision.
Or, partir dun trap SNMP reu par Oracle GRID, on souhaite pouvoir extraire ladresse IP de lhte concern et
afficher le message du trap dans un service appartenant non pas Oracle Grid mais lhte concern par le trap (le
vritable metteur).
Pour cela, excutez la procdure suivante :
1. Crez un trap gnrique, ayant les paramtres suivants :
Attributs Description
Onglet Configuration du trap
Nom Nom du trap
OID OID du trap
Statut Statut par dfaut du trap
Message de sortie Message de sortie personnalis
Onglet Avanc
Activ le routage Cochez la case
Commande de $2 (ici on part du principe que largument numro 2 du trap contient ladresse IP de lhte
routage concern par le trap)

2. Crer une deuxime dfinition du trap avec :

Attributs Description
Onglet Configuration du trap
Nom Nom du trap (autre que celui de la premire dfinition)
OID OID du trap (mme que celui de la premire dfinition)
Statut Statut par dfaut du trap
Message de sortie Message de sortie personnalis

3. Associer la premire dfinition un service (par exemple PING) du serveur Oracle GRID
4. Associer la deuxime dfinition un service passif de lhte concern
5. Gnrer les dfinitions de traps SNMP et redmarrer centreontrapd

Au sein du champ Commande de routage vous pouvez utiliser les arguments suivants :
Nom de la variable Description
@GETHOST- Rsolution DNS inverse permettant de connaitre le nom DNS partir de ladresse IP
BYADDR($2)@ (127.0.0.1 -> localhost)
@GETHOSTBY- Rsolution DNS permettant de connaitre ladresse IP partir du nom DNS (localhost
NAME($2)@ -> 127.0.0.1)

7.11. Gestion des traps SNMP avec Centreon 205


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Ne pas soumettre le trap SNMP durant un downtime

Loption Check Downtime permet centreontrapd de contrler si le service nest pas dans un statut de downtime lors
de la rception du trap SNMP. Il est possible alors dannuler la soumission du trap.

Note : Ce mode de focntionnement nest compatible quavec Centreon Broker et des services superviss depuis le
central.

Il est possible dadapter le comportement selon ces trois mthodes :


Aucun : Rien de spcial, le trap SNMP est envoy normalement
Real-Time : Si un downtime est actif sur le service, il nest pas mis jour.
History : Ooption utilise pour ne pas prendre en compte un trap SNMP qui concerne un vnement pass lors
dun temps darrt.

7.11.4 FAQ

Comme vu dans le chapitre sur les traps SNMP, plusieurs lments entrent en jeu dans la gestion des traps SNMP.
En cas de problmes, il est ncessaire de vrifier le bon fonctionnement de son architecture, plusieurs points sont
vrifier.
Source : Gestion des traps SNMP sous Centreon par Laurent Pinsivy, GNU/Linux Magazine N160 - Mai 2013, licence
CC BY-NC-ND

Configuration de lmetteur

Le premier point contrler est la configuration de lquipement ou application qui a mis linterruption que vous
auriez d recevoir. Vrifiez ladresse IP ou nom DNS de destination, la communaut SNMP ainsi que la version du
protocole.

Pare-feux rseau et logiciels, routage

Le second point contrler sont les autorisations des pare-feux rseau et logiciels ou la mise en place dun routage
spcifique. Si un ou plusieurs pare-feux rseau sont prsent ou si une translation de port et/ou dadresse IP est en
place, vrifiez que le flux est possible entre lmetteur et le collecteur. Lutilisation de sondes rseau, de dbogage des
quipements rseau (pare-feux et routeurs) ou des logiciels tcpdump/wireshark sur le collecteur peut vous permettre
de valider la rception du flux de donnes sur le port UDP 162.

Snmptrapd

Une fois la rception du flux valid, vrifiez ltat de fonctionnement du processus snmptrapd, qui doit tre en cours
dexcution, ainsi que ses options de configuration. Il est possible dactiver la journalisation du processus. Pour cela
modifiez le fichier /etc/sysconfig/snmptrapd.options et remplacez la ligne OPTIONS pour avoir :
# snmptrapd command line options
# OPTIONS="-On -d -t -n -p /var/run/snmptrapd.pid"
OPTIONS="-On -Lf /var/log/snmptrapd.log -p /var/run/snmptrapd.pid"

Redmarrez le processus pour prendre en compte les modifications. Ainsi, pour toute rception de traps SNMP, ces
vnements seront inscrit dans le journal /var/log/snmptrapd.log . Si les vnements sont inscrit dans le journal,
supprimez la journalisation et passez ltape suivante.

206 Chapitre 7. Guide exploitation


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Dans le cas o vous filtrez par communaut SNMP, vrifiez les communauts autorises dans le fichier de configuration
/etc/snmp/snmptrapd.conf . Si aprs toutes ces vrifications les traps SNMP ne sont pas inscrites dans le journal,
vrifiez que le processus coute sur le port UDP 162 pour les quipements distants en utilisant la commande :

# netstat -ano | grep 162


udp 0 0 0.0.0.0:162 0.0.0.0:* off (0.00/0/0)

Si tel nest pas le cas, modifiez le port dcoute du processus.

Note : On ne le rpte jamais assez mais dsactivez le dbogage du processus aprs validation du fonctionnement.
Dans le cas contraire, la volumtrie des journaux peut tre trs importante.

Centreontrapdforward

Une fois la validation du processus snmptrapd ralise, contrlez le processus centreontrapdforward. La premire
tape consiste vrifier lappel de ce processus par snmptrapd dans le fichier /etc/snmp/snmptrapd.conf :
Vrifier que le service snmptrapd appelle bien centreontrapdforward. Pour cela, ditez le fichier
/etc/snmp/snmptrapd.conf et vrifiez que le fichier contient :
traphandle default su -l centreon -c "/usr/share/centreon/bin/centreontrapdforward"

Si laccs au fichier est incorrect, modifiez le et redmarrez le processus snmptrapd. Vous pouvez contrler le bon
fonctionnement du binaire centreontrapdforward en vous rendant au chapitre de configuration de centreontrapdfor-
ward.

Centreontrapd

Le prochain binaire est celui de Centreon qui permet de slectionner lhte possdant ladresse IP ou le nom DNS de
lmetteur ainsi que le service li cet hte et auquel est relie la dfinition de linterruption SNMP. Pour vrifier son
fonctionnement, il convient de vrifier les paramtres de configuration de centreontrapd.
Vous pouvez vrifier la bonne configuration de centreontrapd au sein du chapitre de configuration de centreontrapd.

CentCore

Dans le cas dun serveur central, le processus Centcore doit tre dmarr pour transfrer la commande externe
lordonnanceur supervisant lmetteur, vrifiez son tat de fonctionnement. Activez le dbogage du processus via le
menu Administration ==> Options ==> Dbogage et redmarrez le processus.

Note : Vous pouvez modifier le niveau de dbogage du processus via le fichier /etc/sysconfig/centcore en modifiant
la svrit.

En cas de non rception de la commande externe, vrifiez le chemin daccs au fichier de commande du processus
dfini dans la variable $cmdFile du fichier de configuration /etc/centreon/conf.pm .. Le chemin doit tre
/var/lib/centreon/centcore.cmd dans le cas dun serveur central ou le chemin vers le fichier de commande de lor-
donnanceur.

Ordonnanceur

Que vous ayez configur un serveur central ou un collecteur distant pour la rception de trap SNMP, lordonnanceur
doit recevoir la commande externe de changement de statut et/ou de message de sortie (output). Vrifiez le journal

7.11. Gestion des traps SNMP avec Centreon 207


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
de lordonnanceur. Dans le cas de Centreon Engine le fichier est /var/log/centreon-engine/centengine.log. Les lignes
suivantes doivent apparatre :
[1352838428] EXTERNAL COMMAND: PROCESS_SERVICE_CHECK_RESULT;Centreon-Server;Traps-SNMP;2;Probleme cri
[1352838433] PASSIVE SERVICE CHECK: Centreon-Server;Traps-SNMP;2;Probleme critique

Si seule la commande externe apparat mais pas la prise en compte de celle-ci par lordonnanceur ( PASSIVE SER-
VICE CHECK ), il se peut quun problme de synchronisation de lhorloge systme soit en cause. Le serveur est soit
en retard et la commande sera traite ultrieurement, soit en avance et la commande ne sera pas prise en compte.

Centreon

Afin dtre visible dans Centreon, lordonnanceur doit transmettre les informations, via son module NEB, la partie
serveur du broker pour que ce dernier linsre en base de donnes. Centreon affichera ensuite le rsultat partir de la
base de donnes centreon_storage . Sil vous est possible de visualiser les informations des derniers contrles de
votre collecteur dans linterface web, alors vous devriez voir le statut et le message de sortie ( output ) de modifis.
Si tel nest pas le cas, alors votre ordonnanceur nest pas connect la partie serveur de votre broker. Les problmes
peuvent tre les suivants :
Lordonnanceur na pas charg le module NEB son dmarrage car celui-ci est introuvable ou non dfini dans
les options de lordonnanceur
Le module NEB na pu se connecter la partie serveur cause dun problme de paramtrage.
Un pare-feu bloque la connexion entre le collecteur et le serveur Centreon qui hberge la base de donnes -La
partie serveur du broker nest pas fonctionnelle ou nest pas en cours dexcution

Schma dtaill

Vous trouverez ci-dessous un schma dtaill de tous les processus utiliss et/ou prsents lors de la rception dune
interruption SNMP :

208 Chapitre 7. Guide exploitation


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
7.11. Gestion des traps SNMP avec Centreon 209
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
210 Chapitre 7. Guide exploitation
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
CHAPITRE 8

Foire Aux Questions

8.1 Foire Aux Questions

8.1.1 Administration

Comment la fonction Supprimer des graphiques fonctionne ?

Afin de prserver les performances globales, cette action ne supprime pas toutes les donnes de la base de donnes
juste aprs son lancement. Les entres seront retires des tables index_data et metrics mais pas de la table data_bin.
La principale raison est que la table data_bin stocke rapidement une norme quantit de donnes et utilise le moteur
MyISAM qui ne prend pas en charge le verrouillage par ligne Si vous essayez de supprimer trop dentres simultan-
ment, vous pourriez bloquer toute votre base de donnes pendant plusieurs heures.
Quoi quil en soit, cela ne signifie pas que les donnes resteront dans votre base de donnes indfiniment. Elles seront
supprimes plus tard, en fonction de votre politique de rtention des donnes programme.

Aucun graphique ne semble tre gnr, que dois-je contrler ?

Il ya plusieurs choses vrifier lorsque les RRDs ne semblent pas tre gnrs.

Espace disque

Par dfaut, les fichiers contenant les graphiques (.rrd) sont stocks dans le rpertoire /var/lib/centreon/metrics. Il est
videmment ncessaire de disposer dassez despace sur votre systme de fichiers.

Permissions

Est-ce que les fichiers contenant les graphiques (.rrd) peuvent tre crit dans le rpertoire /var/lib/centreon/metrics ?
Le processus qui crit dans ce rpertoire est soit cdb soit centstorage.

Plugins

Est-ce que vos plugins gnrent correctement les donnes de performance ? Se rfrer la documentation officielle
pour plus dinformations.

211
Centreon Broker

Centreon Broker doit tre correctement configur correctement. Se rfrer la documentation de configuration pour
plus dinformations.
Le dmon cbd rrd doit tre en cours dexcution :

$ /etc/init.d/cbd status
* cbd_central-rrd is running

Assurez-vous davoir correctement rempli le paramtre Script de dmarrage du broker dans le menu Administra-
tion ==> Options ==> Monitoring.

8.2 Performance

Ce chapitre est un guide pour optimiser Centreon

8.2.1 Bases de donnes

Le serveur de base de donnes est lun des lments centraux de Centreon. Sa performance a un impact direct sur
lutilisateur de linterface web. Centreon utilise deux ou trois bases de donnes en fonction de votre broker :
centreon Stockage de la configuration
centreon_storage Donnes temps relle et historique
centreon_status Donnes temps relle si ndo2db est utilis
La base de donnes centreon_status est installe mme si vous nutilisez pas ndo2db.

Index

Les bases de donnes utilisent des index pour acclrer les requtes. Dans le cas o des index sont manquants les
requtes sont plus longues tre excutes.

Synchronisation des index

Des fichiers dindex sont gnres pour chaque version de Centreon depuis la version 2.4.0. Ils sont situs dans le
rpertoire data normalement situ dans les rpertoires bin ou www. Il y a un fichier JSON pour chaque base de
donnes :
centreonIndexes.json Index pour la base centreon
centreonStorageIndexes.json Index pour la base centreon_storage
centreonStatusIndexes.json Index pour la base centreon_status

Vrifiez si votre base de donnes est dsynchronise :

$ cd CENTREONBINDIR
$ ./import-mysql-indexes -d centreon -i ../data/centreonIndexes.json

Si des diffrences sont dtectes, vous pouvez synchroniser votre base de donnes. Le processus prend quelques
minutes mais si votre base de donnes contient un fort volume de donnes sans index, cela peut prendre plus de
2 heures. Soyez sre davoir assez de place disponible sur la partition pour reconstruire les index :

$./import-mysql-indexes -d centreon -i ../data/centreonIndexes.json -s

212 Chapitre 8. Foire Aux Questions


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Note : Les index utiliss par les cls trangres (foreign keys ) ne peuvent tre synchroniss.

Loption -s ou --sync doit tre utilise pour mettre jour la base de donnes. Si vous avez besoin de dfinir
lutilisateur et le mot de passe, utiliser respectivement les options -u et -p.

Optimisations InnoDB

Cette section nest pas encore documente.

Schema des Bases de donnes

Le schema de la base de donnes Centreon peut tre consult ici :

8.2. Performance 213


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
214 Chapitre 8. Foire Aux Questions
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Le schma de la base de donnes Centreon_storage ici :

8.2.2 RRDCacheD

RRDCacheD est un processus qui permet de limiter les E/S disque lors de la mise jour des graphiques de performance
et/ou des graphiques de statut (fichiers RRDs). Pour cela, le processus RRDCacheD est appel par le module Centreon
Broker et mutualise les criture sur disque plutt que denregistrer une une les donnes issues de la collecte.

8.2. Performance 215


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Installation

Le processus RRDCacheD est disponible dnas le paquet rrdtool dj install sur votre serveur Centreon.

Configuration

Options gnrales

diter le fichier /etc/sysconfig/rrdcached et modifier les informations suivantes


# Settings for rrdcached
OPTIONS="-m 664 -l unix:/var/rrdtool/rrdcached/rrdcached.sock -s rrdcached -b /var/rrdtool/rrdc
RRDC_USER=rrdcached

Note : Lordre des options est trs important, si loption ** -m 664** est plac eaprs loption -l
unix :/var/rrdtool/rrdcached/rrdcached.sock alors la socket sera cre avec les mauvais droits.

Concernant les autres options importantes :


Op- Description
tion
-w Les donnes sont crites sur le disques toutes les x secondes (ici 3600s donc 1h)
-z Doit tre infrieur ou gale loption -w. RRDCacheD utilise une valeur alatoire dans lintervalle [0 :-z]
pour dcaler lcriture dun fichier afin dviter que trop dcritures soient mises en attente simultanment.
-f Correspond un temps maximum de mise jour (tilmeout). Si dans le cache des valeurs sont suprieures
ou gales au nombre de secondes dfinies, alors celle-ci sont automatiquement crite sur le disque.
Note : Ces valeurs doivent tre adaptes en fonction du besoin/des contraintes de la plate-forme concerne !

Configuration des groupes

Crer les groupes en excutant les commandes suivantes


# usermod -a -G rrdcached centreon-broker
# usermod -a -G rrdcached apache
# usermod -a -G centreon rrdcached
# usermod -a -G centreon-broker rrdcached

Redmarrer le processus Apache pour prendre en compte les modifications


# /etc/init.d/httpd restart

Dmarrer le processus RRDCacheD


# /etc/init.d/rrdcached start

Configurer le processus dans linterface web Centreon

Se rendre dans le menu Administration -> Options -> RRDTool, activer lutilisation du processus et renseigner
laccs au socket /var/rrdtool/rrdcached/rrdcached.sock :

216 Chapitre 8. Foire Aux Questions


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Warning : Attention, mme si la modification a t ralis dans le menu Administration, il est ncessaire dex-
porter la configuration et de redmarrer le processus centreon-broker via un export de la configuration du serveur
central et un redmarrage du processus cbd.

Interface web Centreon

La mise en place de rrdcached fait que les graphiques ne sont plus mis jours en temps rel. Il est donc possible de
voir un petit blanc sur la droite de certains graphiques. Cela veut dire que les donnes sont encore dans le cache du
processus, cela est normal !

Warning : Attention, si le processus crash pour une raison quelconque (aucune en thorie cest plutt stable), les
donnes sont perdues, donc aucun moyen de les rejouer sauf en reconstruisant les graphiques via centreon-broker.

8.2. Performance 217


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
218 Chapitre 8. Foire Aux Questions
M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
CHAPITRE 9

Comment dvelopper des extensions pour Centreon

Ce chapitre est une reprise sans traduction de la documentation anglaise.

9.1 How to write a module

You want to create a new module for Centreon 2 or to adapt an existing one ? Youre at the right place !
You should know Centreon contains a page dedicated to the installation and the uninstallation of modules (Administra-
tion > Modules). To make the module appears on this page, its directory must be placed inside Cetreons modules/
directory. Example :
/usr/local/centreon/www/modules/module-Dummy

An empty module template can be found inside Centreons repository


<http://svn.centreon.com/trunk/module-Dummy>_.

*****
Basis
*****

The essential elements your modules directory must contain are presented below (\* = required):

**[conf.php]\***::

// Short modules name. Must be equal to your modules directory name


$module_conf[dummy][name] = "dummy";
// Full modules name
$module_conf[dummy][rname] = "Dummy Module";
// Modules version
$module_conf[dummy][mod_release] = "2.0";
// Additional information
$module_conf[dummy][infos] = "First of all";
// Allow your module to be uninstalled
$module_conf[dummy][is_removeable] = "1";
// Module authors name
$module_conf[dummy][author] = "Centreon Team";
// 1: the module executes an SQL file for installation and/or uninstallation
// 0: the module doesnt execute any SQL file
$module_conf[dummy][sql_files] = "1";
// 1: the module executes a PHP file for installation and/or uninstallation
// 0: the module doesnt execute any SQL file
$module_conf[dummy][php_files] = "1";

219
[infos > infos.txt]
This file can contain various information about your module.
[php > install.php]
This PHP file is executed at module installation if it is configured inside the conf.php file.
[php > uninstall.php]
This PHP file is executed at module uninstallation if it is configured inside the conf.php file.
[sql > install.sql]
This SQL file is executed during the module installation if it is configured inside the conf.php file. If you want your
module to be available from Centreon menus, you must insert new entries into the topology table of the centreon
database. An example is available inside the Dummy module.
[sql > uninstall.sql]
This SQL file is executed during the module uninstallation if it is configured inside the conf.php file. It can also remove
your module from Centreon menus.
[generate_files > *.php]
The PHP files contained inside the generate_files directory will be executed during the configuration files
generation (inside Configuration > Monitoring Engines). Those files must generate configuration files.
[UPGRADE > dummy-x.x > sql > upgrade.sql]
Centreon provides an upgrade system for modules. To use it, just add a directory under UPGRADE named using the
following pattern : <module name>-<version>. When clicking on the upgrade button, Centreon will search for
scripts to execute, following the logical order of versions.
For example, if the version 1.0 of the dummy module is installed and the following directories exist :

$ ls UPGRADE
dummy-1.1 dummy-1.2

Centreon will execute the scripts in the following order : 1.1, 1.2. A configuration file in each upgrade directory is
present in order to allow (or not) the execution.
Youre free to organize the remaining files (your modules content) as you like.

9.1.1 Advanced

Thats great, you know how to install a module ! As an empty module is not really usefull, put your imagination at
work. Knowing that you can do almost everything, it should not be too complicated :-).

Connecting to the database

You can use the centreon, centstorage and ndo databases by calling the following file :
centreon/www/class/centreonDB.class.php.
For example, execute requests like this :
<?
$pearDB = new CentreonDB();
$pearDB->query("SELECT * FROM host");
?>

220 Chapitre 9. Comment dvelopper des extensions pour Centreon


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Existing functions

You can access most of the functions already developed within Centreon using include() statements. Theyre
generally stored in centreon/www/class/.
Before developing your own function, check the existing code, it could spare your time !

9.2 How to write a widget

Centreon (since version 2.4) offers a custom view system which allows user to view one or different widgets in the
same page : Home > Custom views.
You may have specific needs that are not yet covered by our widget catalog and this tutorial will explain to you how
to write your first widget for Centreon.

9.2.1 Should I make a widget or a module ?

If you are wondering if you should be making a module or a widget, then ask yourself if your project is meant to
contain many menus or is it rather a plain page which is going to display little information ?
Of course, you could make a widget that would only work with a certain module.

9.2.2 Directory structure

Widgets work pretty much like Modules. They have to be placed in the following directory :
# centreon/www/widgets/nameOfYourWidget/

Your widget must contain one mandatory file named configs.xml at its root.

9.2.3 Configuration file

This is the XML configuration file of our Dummy widget :

<configs>
<title>Dummy</title>
<author>Centreon</author>
<email>contact@centreon.com</email>
<website>http://www.centreon.com</website>
<description>Dummy widget</description>
<version>1.0.3</version>
<keywords>dummy, widget, centreon</keywords>
<screenshot></screenshot>
<thumbnail>./widgets/dummy/resources/logoCentreon.png</thumbnail>
<url>./widgets/dummy/index.php</url>
<autoRefresh></autoRefresh>
<preferences>
<preference label="text preference" name="text preference" defaultValue="default value"
<preference label="boolean preference" name="boolean preference" defaultValue="1" type=
<preference label="date" name="date" defaultValue="" type="date"/>
<preference label="host preference" name="host preference" defaultValue="" type="host"/
<preference label="list preference" name="list preference" defaultValue="none" type="li
<option value="all" label="all"/>

9.2. How to write a widget 221


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
<option value="none" label="none"/>
</preference>
<preference label="range preference" name="range preference" defaultValue="5" type="ran
<preference label="host search" name="host search" defaultValue="notlike _Module_%" typ
</preferences>
</configs>

Now, lets see what these tags refer to.

Basic tags

* = Mandatory tag
Tag nameDescription
title* Title of your widget
author* Your name
email Your email address
website URL of your project
descrip- Short description of your widget
tion*
version* Version of your widget. Increment this number whenever you publish a new version.
keywords A few key words that describe your widget
screenshot Screenshot that shows the best side of your widget. Screenshot should be placed within your widget
directory.
thumbnail Logo of your project. Best size is 100px x 25px. Thumbnail shoud be placed within your widget
directory.
url* Path of the main page of your widget
autorefresh This parameter is not implemented yet

Parameter attributes

* = Mandatory parameter
Tag Description
attributes
label* Label of the parameter
name* Name of the parameter that will be used for retrieving its value
defaultVa- Default Value of the parameter
lue*
requirePer- Value can be 1 or 0. When set to 1, this parameter will not be shown to unauthorized users.
mission
type* Parameter type, must be one of the following :
text,boolean,date,list,range,compare,host,hostgroup, hostTemplate,servicegroup,serviceTemplate
min* For range type only. It refers to the minimum value of the range parameter
max* For range type only. It refers to the maximum value of the range parameter
step* For range type only. It refers to the step value of the range parameter

222 Chapitre 9. Comment dvelopper des extensions pour Centreon


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
Parameter type

Type name Description


text Renders a text input element
boolean Renders a checkbox
date Renders two text input elements. One for the date of
start, the other one for the date of end.
list Renders a selectbox. The selectbox will be populated
with the option tags which have to be defined within the
preference tag.
range Renders a selectbox which will be populated with values
depending on the min, max and step definitions.
compare Renders a selectbox and a text input. Selectbox will
contain SQL operands such as :
> : greater than
< : less than
>= : greater or equal
<= : less or equal
= : equal
!= : not equal
LIKE : can be used with the wildcard %%
NOT LIKE : can be used with the wildcard %%

host Renders a selectbox populated with a list of hosts.


hostgroup Renders a selectbox populated with a list of hostgroups.
hostTemplate Renders a selectbox populated with a list of host tem-
plates.
servicegroup Renders a selectbox populated with a list of service-
groups.
serviceTemplate Renders a selectbox populated with a list of service tem-
plates.
The preference window would look like this as a result :

_static/images/extending/pref_dummy_widget.png

9.2.4 Code

Now, lets see how you could retrieve the parameter values in your PHP code.
widgets/dummy/index.php :
<?php
// required classes
require_once "/etc/centreon/centreon.conf.php";
require_once $centreon_path . "www/class/centreon.class.php";
require_once $centreon_path . "www/class/centreonSession.class.php";
require_once $centreon_path . "www/class/centreonDB.class.php";
require_once $centreon_path . "www/class/centreonWidget.class.php";

9.2. How to write a widget 223


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY
// check if session is alive
session_start();
if (!isset($_SESSION[centreon])) {
echo "Session expired";
exit;
}
$centreon = $_SESSION[centreon];

// variable initialization
$db = new CentreonDB();
$widget = new CentreonWidget($centreon, $db);

// retrieve widget preferences


$preferences = $widget->getWidgetPreferences($_GET[widgetId]);
// print the retrieved preferences
print_r($preferences);
?>

The result :
Array ( [text preference] => default value
[boolean preference] => 1
[date] =>
[host preference] =>
[list preference] => none
[range preference] => 5
[host search] => notlike _Module_% )

Ressources en ligne supplmentaires :


Demo
Captures dcran

224 Chapitre 9. Comment dvelopper des extensions pour Centreon


M ERETHIS 12 AVENUE R ASPAIL FR94290 G ENTILLY