MODULE CENTREON SYSLOG

FRONTEND & SERVER

MANUEL D'ADMINISTRATION

O C I T

E R E T H I S

12 Avenue Raspail 94250 Gentilly

Tl: 01.49.69.97.12 - Fax: 01.78.12.00.28

Ta b l e d e s m a t i r e s
1 . P R S E N T A T I O N .....................................................................................................................................3
2 . L A N G U E D E L ' I N T E R F A C E ...............................................................................................................4
2 .1 .CONFIGURA TION ..................................................................................................................................4
2 .2 .CONFIGURA TION DE L 'UTIL ISA TE UR............................................................................................4
3 . D R O I T S D ' A C C S A U M E N U D U M O D U L E S Y S L O G ...........................................................5
4 . C O N N E X I O N L A B A S E D E D O N N E S D U M O D U L E ........................................................6
5 . G E S T I O N D E L A D U R E D E R T E N T I O N D E S V N E M E N T S S Y S L O G ..................8
6 . E X P O R T D E L A C O N F I G U R A T I O N D U S E R V E U R .................................................................9

1.

P R S E N TAT I O N

Ce manuel prsente l'administration des modules centreon-syslog-frontend et centreon-syslog-server .

La gestion de l'administration des deux modules est regroupe au sein de l'interface de Centreon dans la section administration
et concerne plusieurs points :

Langue de l'interface ;

Droits d'accs au menu du module Syslog ;

Connexion la base de donnes du module centreon-syslog-server ;

Gestion de la dure de rtention des vnements syslog en base de donnes ;

Export de la configuration du serveur depuis l'interface d'administration .

L'utilisation et la reproduction de ce document sont interdites en dehors d'un cadre contractuel

3/9

2.

L ANGUE DE L'I NTER FA CE

L'interface d'exploitation et d'administration du modules centreon-syslog-frontend peut tre disponible dans plusieurs
langues. Ceci est fonction des deux points suivants :

La langue dfinie pour l'utilisateur connect ;

La prsence du fichier de traduction .

En effet, la langue affiche est celle dfinie pour l'utilisateur actuellement connect l'interface. Le mcanisme de traduction est
identique celui utilis pour le reste de l'interface de Centreon. Cependant, le fichier de traduction doit tre disponible dans le
rpertoire du module pour qu'Apache puisse traduire l'interface du module.
2.1.

Configuration

Le fichier de traduction se nomme messages.mo (qui est la version compile du fichier messages.po qui peut tre
modifi avec un diteur tel que poedit ). Avant d'installer le fichier de langue, vous devez connatre le type d'encodage :
UTF-8, ISO8859-1, ISO8859-15, ....

Pour cela, tapez la commande :

$> locale

Et rcuprez la valeur de LC_MESSAGES, ici fr_FR.UTF-8 .

Vous pouvez maintenant compiler le fichier "messages.po" comportant les diffrentes traductions et le placer dans le rpertoire
prvu cet effet. Par exemple, pour traduire Centreon en franais, crez un nouveau rpertoire fr_FR.UTF-8 dans le
rpertoire /www/locale/ de Centreon.

Crez en suite un second rpertoire LC_MESSAGES dans ce mme rpertoire :

$> mkdir /usr/local/centreon/www/modules/Syslog/locale/fr_FR.UTF-8/
$> mkdir /usr/local/centreon/www/modules/Syslog/locale/fr_FR.UTF-8/LC_MESSAGES/

Remarque : le nom du rpertoire est essentiel, il doit comporter le code de la langue et du pays. Par exemple, pour la langue
franaise parl en France, se sera fr_FR.UTF-8, pour l'espagnol parl en Espagne se sera es_ES.UTF-8, le portugais europen
pt_PT.UTF-8, le portugais brsilien pt_BR.UTF-8, l'anglais amricain en_US etc.

Compiler le fichier *.po vers le rpertoire prvu cet effet :

$> msgfmt messages.po -o /usr/local/centreon/www/modules/Syslog/locale/fr_FR.UTF8/LC_MESSAGES/messages.mo

Appliquez les droits aux nouveaux fichiers, ils doivent appartenir l'utilisateur et au groupe d'Apache :
$> chown -R www-data.www-data /usr/local/centreon/www/modules/Syslog/locale/fr_FR.UTF-8/

Redmarrer le serveur web pour prendre en compte les modifications :

$> /etc/init.d/apache2 reload

2.2.

Configuration de l'utilisateur

Se rendre dans le menu Configuration Users mon utilisateur puis choisir dans la liste droulante la langue dsire.
L'interface sera traduite lors du prochain accs aux pages du modules.

L'utilisation et la reproduction de ce document sont interdites en dehors d'un cadre contractuel

4/9

3.

Droits d'accs au menu du module Syslog

La gestion des droits d'accs est identique celle du reste de l'interface Centreon. Pour cela il faut manipuler les objets :

Groupe d'accs ;

Accs au menus .

Un groupe d'accs est un conteneur auquel seront lis des utilisateurs de l'interface de Centreon. Une fois ce groupe cr, il est
possible de lier une restriction d'accs aux menus ce groupe. Ainsi, tous les utilisateurs inclus dans ce groupe ne peuvent voir
que ce qui leur a t permi.

La gestion des ACL (Access Control List) est modifiable dans le menu Administration ACL de Centreon.

Remarque : il n'est pas possible de restreindre l'accs aux vnements syslog. Ainsi, si un utilisateurs a accs la page de
recherche du module, il pourra effectuer une recherche sur l'ensemble des lments disponibles.

La configuration ci-dessous donne accs aux pages Monitoring et Research du module centreon-syslog-frontend pour
le groupe d'accs Guest :

Illustration 1: Gestion des accs aux menus

L'utilisation et la reproduction de ce document sont interdites en dehors d'un cadre contractuel

5/9

4.

Connexion la base de donnes du module

Afin de pouvoir parcourir les vnements syslog depuis l'interface de visualisation, l'accs la base de donnes du serveur
syslog doit tre au pralable correctement configur, auquel cas un message d'erreur sera visible :

Illustration 2: Erreur d'accs

L'accs la base de donnes est configurable dans le menu Administration Modules Syslog Configuration :

Illustration 3: Administration du module Syslog

L'utilisation et la reproduction de ce document sont interdites en dehors d'un cadre contractuel

6/9

Les champs modifier sont les suivants :

Syslog DB server : Adresse IP du serveur syslog ;

Syslog DB Name : Nom de la base de donnes, par dfaut syslog ;

Syslog Table Name : Nom de la table utilise pour la recherche. Si la table indique est logs , alors la page de
recherche slectionne uniquement les entres de la table des vnements du jour. Si la table indique est all_logs ,
la recherche est faite sur la totalit des vnements en base.

Syslog Filters Table Name : Nom de la table contenant les filtres disponibles pour la recherche. Si la table indique
est cache , alors les filtres disponibles seront ceux de la table des vnements du jour. Si la table indique est
all_cache , les filtres disponibles seront ceux de la totalit des vnements en base.

Syslog User : Utilisateur MySQL ayant accs la base de donnes ;

Syslog Password : Mot de passe de l'utilisateur MySQL .

Illustration 4: Champs de connexion au serveur

Remarque : Toutes ces informations sont celles dfinies lors de l'installation du module centreon-syslog-server .

L'utilisation et la reproduction de ce document sont interdites en dehors d'un cadre contractuel

7/9

5.

GESTION DE LA DURE DE RTENTION DES VNEMENTS SYSLOG

La dure de rtention des vnements syslog permet de supprimer automatiquement les anciennes donnes. Chaque jours
23h59, un service planifi supprime les tables logsYYYYMMdd et cacheYYYYMMdd obsoltes, ou YYYYMMdd
correspond au format de date anglais.

Cette dure de rtention est modifiable via le menu Administration Modules Syslog Configuration :

Illustration 5: Dure de rtention

La dure est comptabilise en jours. Lors d'une mise jour de la version Syslog 1.1 ou d'une nouvelle installation, la dure
par dfaut est de 30 jours. Auparavant, pour les utilisateurs de la version Syslog 1.1 , cette dure de rtention tait
modifiable dans le fichier de configuration de php-syslog-ng qui permettait d'excuter une rotation des tables.

Une fois la modification effectue, il faut exporter la configuration. Pour plus d'information quand l'export de la configuration
du serveur, voir le chapitre Export de la configuration du serveur.

L'utilisation et la reproduction de ce document sont interdites en dehors d'un cadre contractuel

8/9

6.

Export de la configuration du serveur

L'export de la configuration du serveur depuis Centreon se fait au moyen d'une connexion SSH. C'est pourquoi il est demand
lors de l'installation du module centreon-syslog-frontend d'installer les librairie libss2 et ssh2 pour PHP.

L'export ne demande pas d'change de cls SSH au pralable. Seuls doivent tre renseigns l'adresse IP du serveur (dj dfinie
pour avoir accs la base de donnes), ainsi que le port SSH, l'utilisateur syslog cr lors de l'installation du module
centreon-syslog-server , du mot de passe de cet utilisateur et du rpertoire etc dans lequel est copi le fichier de
configuration.

Ces informations sont renseigner dans le menu Administration Modules Syslog Configuration :

Illustration 6: Paramtres de connexion au serveur pour l'export de la configuration

Les champs modifier sont les suivants :

Syslog DB Server : adresse IP du serveur syslog ;

Syslog configuration directory : rpertoire etc contenant la configuration du serveur, dfini lors de l'installation
du module centreon-syslog-server ;

SSH port for connection to Syslog server : port d'coute du service sshd du serveur syslog ;

Name of syslog user on Syslog server : nom de l'utilisateur distant, par dfaut syslog ;

Password for distant user on Syslog server : mot de passe de l'utilisateur .

Une fois ces champs remplis, cliquer sur le bouton Export configuration . Une boite de dialogue affiche le statut de l'export
qui peut tre:

Configuration file was exported with succes : La configuration a t copie avec succs ;

Unable to connect on distant server. : L'adresse IP de la machine est incorrecte ;

Authentification failed. : Le nom de l'utilisateur et/ou le mot de passe est (sont) incorrect(s) ;

Unable to export configuration file. Rights may be not correct on distant directory. : Le rpertoire de
destination est incorrect ou les droits sur le fichier syslog.conf.php ne permettent pas l'utilisateur de le copier
dans ce rpertoire.

L'utilisation et la reproduction de ce document sont interdites en dehors d'un cadre contractuel

9/9