Configuration¶

This chapter describes the configuration of the module as well as how to add a Centreon Syslog Server.

General configuration¶

General options¶

Connect to Centreon GUI on main server and go to the menu “Configuration -> Syslog -> Refresh”:

Click on “Modify” button to edit information:

Modify configuration and click on the “Save” button to save your modification.

Fields description are the following :

Name	Description
Refresh interval for monitoring	Interval in seconds to refresh monitoring syslog events
Refresh interval for filters	Interval in seconds to refresh filters for monitoring pages

Language of the interface¶

The interface of monitroing, search and administration of this module can be available in several languages. This depends of following both points:

Language defined of Centreon user
The availability of the translation file of the module

Translate the file “messages.pot” from module sources located “www/modules/centreon-syslog-frontend” directory.

Note

you can use poedit to make translation.

Create your locale language directory using the following command:

$ mkdir -p /usr/share/centreon/www/modules/centreon-syslog-frontend/locale/`locale | grep LC_MESSAGES | cut -d \" -f 2`/LC_MESSAGES

Warning

change Centreon installation directory ‘/usr/share/centreon’ by your.

Compile your translated language file using command:

$ msgfmt messages.pot -o /usr/share/centreon/www/modules/centreon-syslog-frontend/locale/`locale | grep LC_MESSAGES | cut -d \" -f 2`/LC_MESSAGES

Warning

change Centreon installation directory ‘/usr/share/centreon’ by your.

Set Apache user rights on the file:

$ chown -R www-data.www-data /usr/share/centreon/www/modules/centreon-syslog-frontend/locale

Restart Apache server:

$ /etc/init.d/apache2 reload

Todo

change user language

ACL configuration¶

The management of access rights is identical to that besides of the interface Centreon. For it it is necessary to use:

Access groups
Menus Access

An access group is a container to group users who can have access to Centreon GUI. Once this group was created, it is possible to link an access restriction to the menus at this group. So all the users included in this group can see only what was allowed them.

To modify ACL for users of Centreon connect to Centreon and go to the menu “Administration -> ACL”.

Warning

It is not possible to create ACL on syslog object. If a user can have access to Centreon Syslog Frontend module pages, this user can see all syslog events.

Add a collector¶

Connect to Centreon GUI on main server and go to the menu “Configuration -> Syslog -> Collectors” and click on “Add”:

Database configuration¶

Define information of your Centreon Syslog Server:

Fields description are the following:

Name	Description
Collector Name	Name of your Syslog collector
IP or DNS name	IP address or DNS of your Syslog server
Database port	Port number of MySQL database on your collector
Database type	Use ‘mysql’
Database name	Name of your database (‘centreon_syslog’ by default)
Database user	Name of user can connect to MySQL server
Password of Database user	Password of MySQL user
Logs table name	Name of daily table to store syslog events (‘logs’ by default)
Logs Merge table name	Name of MySQL merge table of daily syslog events tables (‘all_logs’ by default)
Cache table name	Name of cache for filters for real time syslog pages (‘cache’ by default)
Cache Mere table name	Name of MySQL merge table of daily cache tables (‘all_cache’ by default)

SSH configuration¶

Go to “SSH” tab:

Fields description are the following:

Name	Description
IP or DNS name	IP address or DNS of your Syslog server
Username for SSH connection	‘Syslog’ by default. Created during Centreon Syslog Server installation process
Password for SSH connection	Password created during installation of Centreon Syslog Server
SSH port	Port number of SSH on your collector (‘22’ by default)

General configuration¶

Go to “Configuration” tab:

Fields description are the following:

Name	Description
Configuration directory	Centreon Syslog Server “etc” directory (‘/etc/centreon-syslog’ by default)
Duration of retention of data	Number of days to store syslog events in database before deletion
Status	Enable/Disable display of syslog events from this collector in monitoring pages
Comment	Add description of this collector

Click on “Save” button to save your configuration:

The configuration of your syslog collector is now complete!

Export of configuration¶

If you modifiy the duration of retention of data you must export configuration to the Centreon Syslog Server. Log on Centreon and go to the menu “Configuration -> Syslog -> Collectors” and click on your collector definition:

Click on the “Export configuration” button to transfer ‘syslog.conf.php’ to the collector:

If the export is successful, this popup appears:

Else you may have an error of configuration.

Type of errors¶

The following messages can be returned:

the “etc” directory of Centreon Syslog Server in configuration of the collector is not correct
the ‘syslog ‘user’ have incorrect rights on the “etc” directory of Centreon Syslog Server on distant server

The following messages mean that the authentication failed, the specified password for ‘syslog’ user in configuration of the collector is probably incorrect: