General options

Centreon MBI general options are used to configure:

  • Scheduling options for jobs that generate reports

  • Communication between Centreon MBI interface and the CBIS reporting engine

  • Notification parameters for Centreon MBI administrators.

Notification options

The reporting engine can notify Centreon MBI administrators by e-mail after each report generation. The e-mail includes:

  • The direct download links to the reports

  • Log file pertaining to the job that generated the reports.

Centreon MBI administrators can thus be informed if any job fails. This notification, however, is different from publication by e-mail of the actual reports sent to specific users. The notification option sends an e-mail to Centreon MBI administrators containing only the logs of the job that generated the report.

The notification option parameters can be modified in the menu: Reporting > Business Intelligence > General Options | Notification Options

Description:

Row

Description

Enable job notification for administrators

Enables the default notification system. This option can be disabled for scheduled jobs.

E-mail from

E-mail sender

SMTP server

SMTP server address (IP/DNS)

SMTP port

SMTP port

Use credential

Uses an authentication (yes/no)

Use SSL

Uses an SSL authentification (yes/no)

SMTP user

SMTP user account

SMTP password (Set this parameter only if you need to update the password)

Password for SMTP user

E-mail default title

Default subject line for notification e-mail, if no other is specified

Default E-mail body

Default body of notification e-mail, if no other is specified

Default E-mail footer

Default footer of notification e-mail, if no other is specified

Centreon main server web protocol

The protocol used by Centreon web interface (http / https)

Centreon web URL extension

The Centreon server URL extension (e.g.: /centreon)

Centreon main server web address (Example : demo.centreon.com)

Centreon server address (e.g.: demo.centreon.com)

Contact groups

Centreon MBI administrators contact groups. Leave empty if you do not want to receive a notification after each report is generated.

Testing notification

Enter an e-mail address into this field, then click on “test” to send an e-mail validating your configuration.

Scheduler options

The following menu allows you to modify the scheduling options of the reporting engine:

Reporting > Business Intelligence > General Options | Scheduler options

CBIS properties

The Centreon MBI interface can instantly communicate with the CBIS reporting engine. It opens a connection on the CBIS listening port to:

  • Alert about the modification or creation of a job.

  • Update the available languages for translation of the reports.

  • Test publication rule configurations.

  • Test the configuration of notifications.

Parameters description:

Option

Description

CBIS host

IP address of server hosting the reporting engine

CBIS port

TCP listening port for CBIS engine

CBIS connection timeout

Time limit (in seconds) for connection to the reporting engine

Any modification of these parameters requires restarting the CBIS daemon (#service cbis restart).

Report generation scheduling properties

Description of parameters:

Option

Description

All cyclic reports generation hour

Hour for generating daily/weekly/monthly reports

Day of month for the generation of monthly reports

Day of month for generating monthly reports

Day of week for the generation of weekly reports

Day of week for generating weekly reports

Maximum load allowed to the scheduler for the jobs execution

Maximum load authorized for running simultaneous jobs

Custom report properties

Two reports require access to the Centreon main server to generate RRD graphs. These reports are:

  • Host-graph-v2

  • Hostgroup-graph-v2.

Fill in the following field specifying the server address:

../_images/10000000000005A100000028486B421A.png

Any modification of these parameters requires restarting the CBIS daemon.

The default theme can also be defined in this menu, using the option “Default report color theme”.

Extract/load/transform (ETL) options

Centreon MBI integrates its own ETL capabilities to:

  • Synchronize monitoring raw data with the reporting server

  • Calculate availability and performance statistics on the reporting server

  • Manage data retention on the reporting server.

Before proceding, you should have read the best practice parts to ensure that the objects (e.g., groups, categories) are configured according to Centreon MBI requirements.

In the Centreon menu “Reporting > Business Intelligence > General Options > ETL options”, specify the following options:

Options

Values

General options

Reporting engine uses a dedicated MySQL server

Yes. You must have a dedicated reporting server.

Temporary files storage directory on reporting server

Folder on the dedicated reporting server where the dumps will be stored (depending on your architecture).

Type of statistics to build

  • Select “Availability only” if you only use the availability reports.

  • Select “Performance and capacity only” if you only use reports capacity and performance.

  • Select “All” to calculate the statistics for both types of reports.

Use large memory tweaks (store MySQL temporary tables in memory)

No

Reporting perimeter selection

Host groups

Select only the host groups for aggregating data.

Host categories

Select only the host categories for aggregating data.

Service categories

Select only the service categories aggregating data.

Availability statistic calculation

Live services for availability statistics calculation

Select required time periods for calculating host availability and services.

Performance and capacity statistic calculation

Granularity required for performance data statistics

Select the degree of granularity for calculating performance data. (1)

Live services for performance data statistics calculation

Select time periods for days of the week used in calculation of capacity and performance data.

Capacity statistic aggregated by month

Live services for capacity statistics calculation

Select the “24x7” time period.

Service categories related to capacity data monitoring

Select service categories associated with capacity-type services.

Exclude metrics from service categories that does not return a capacity USAGE information

Concerns only metrics linked to services which return capacity data. Only select metrics that return a maximum total capacity value and not a usage value (e.g., the “size” metric returned by the check_centreon_snmp_remote_storage plugin).

Centile parameters

Calculating centile aggregation by

Select the degree of granularity required. The standard percentile report provided with MBI 2.1 uses Month data.

Select service categories to aggregate centile on

Select only relevant service categories for centile statistics (e.g., Traffic).

First day of the week

Select the first day of the week for Week aggregation.

Centile / Timeperiod combination

Create new centile/time period combinations for calculating the statistics.

(1) Reports requiring precise hourly performance data are listed below. If these reports are not needed, disable statistics calculation by hour:

  • Host-detail-v2

  • Hostgroup-traffic-Average-Usage-By-Interface

  • Hostgroup-traffic-by-Interface-And-Bandwith-Ranges.

Data retention options

Data retention can be managed on the reporting database. The retention can apply to raw or aggregated data. The following parameters manage this retention (in days).

Don’t forget to activate the data retention using the check box “Enable data retention option”.

Field

Performance data retention

Raw performance data imported from Centreon

Performance data aggregated by hour

Performance data aggregated by day

Performance data aggregated by month

Availability data retention

Raw log data imported from Centreon

Availability data aggregated by day

Availability data aggregated by month

Report Parameter

This tab enables you to display the dimensions available for a given user based on ACL restrictions and what was calculated in the data warehouse.

When updating the groups and categories configuration, make sure to update the ACL by clicking on “Update ACL resources”. This will update available objects when configuring jobs.

Reporting Widgets

This menu is used to verify the connection to the reporting database and edit the connection parameters, which are used to populate the widgets with data.