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:

See also
User manual to run at best this module.