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”:

../_images/config_resfresh_1.png

Click on “Modify” button to edit information:

../_images/config_resfresh_2.png

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”:

../_images/config_poller_1.png

Database configuration

Define information of your Centreon Syslog Server:

../_images/config_poller_3.png

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:

../_images/config_poller_4.png

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:

../_images/config_poller_5.png

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:

../_images/config_poller_6.png

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:

../_images/config_poller_7.png

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

../_images/config_export_1.png

If the export is successful, this popup appears:

../_images/config_export_2.png

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
../_images/config_export_error_1.png

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

../_images/config_export_error_2.png

See also

User manual to run at best this module.