Skip to main content

Generating reports using jobs

MBI is a Centreon extension that has some terms you may not have heard elsewhere in our documentation. We strongly suggest you read the Concepts page before following MBI-related procedures.

Reports are created using jobs. A job is a report definition, that can include several output formats, and several publication modes.

Step 1: Create a new job​

  1. Make sure you have prepared your data as per the MBI requirements.
  2. Go to Reporting > Monitoring Business Intelligence > Jobs.
  3. Click the Add button to create a new job.
  4. On the Job parameters tab, in the Report template field, select the report template you want. Each report template contains specific data: use our catalog of available reports to choose the template best suited to your needs (once you have selected a report template, the contents of the Report contents tab display the options concerning this specific report template).

Step 2: Configure the job​

Go to the Job parameters tab of the job creation page.

Configure the main parameters​

  • Enter a Job name for the job. This will also be the name of the generated report in the Reporting > Monitoring Business Intelligence > Report view page.

  • Select the job groups you want so as to share your report with other non-admin users:

    • They will be able to edit the job (if they have the correct ACL to access the Reporting > Monitoring Business Intelligence > Jobs page).
    • They will be able to see the generated report in the Reporting > Monitoring Business Intelligence > Report view page (if they have the correct ACL to access this page).
    • This is not the same as publishing your report for other users, which is done using the Publication section and allows you to directly send the report to someone.

  • Select the Language of the report: you can generate reports in French or English (ignore the refresh icon next to the list).

  • Select the Output formats you want for this report: bear in mind that not all report designs support all formats. Refer to the catalog of available reports to find out which outputs are supported for the report design you selected.

  • Set the Job priority to increase this job's priority if MBI cannot generate all scheduled reports at once.
  • Enable administrator notification for administrators to be alerted whenever this report is generated. This option must be enabled in the Reporting > Monitoring Business Intelligence > General Options page, under Notification options.

Schedule job execution​

tu In the Scheduling section of the Job parameters tab:

  • Select an execution mode:
    • Immediate: specify the reporting period (i.e. the time range) covered by the report. The report will be generated when you click the Save button once you have finished configuring the job.
    • Scheduled: Executes once at the scheduled time. You need to specify the reporting period (i.e. the time range) covered by the report.
    • Recurring: Executes at defined intervals (daily, weekly or monthly) and uses its own interval as the reporting period i.e. weekly reports contain information about the past week.

Define report-specific parameters​

Go to the Report content tab of the job configuration page. The contents of this tab varies according to the report template you selected on the Job parameters tab (it will be empty if no report design is selected yet). Typically, fields will allow you to define which host groups, host categories and service categories to include in the report.

Select publication rules to share your generated report (optional)​

If you want to share the generated reports for example via email or on a server, go to the Publication section of the Job parameters tab.

Select the Publication rules you want.

  • Global rules are not listed on this tab, but they are applied automatically every time the job is executed.
  • Reports with custom rules will be sent every time they are generated, based on the job's schedule.

Step 3: Save the job​

Once you are satisfied with its configuration, save the job.

  • The job appears in the list of jobs in the Reporting > Monitoring Business Intelligence > Jobs page. An icon on the left shows you the current status of the job (scheduled, running, failed, stopped, finished).
  • Once generated, reports will be available on the Reporting > Monitoring Business Intelligence > Report view page. Click the output icons on the right to download them.

Ran into any issues? Try troubleshooting your configuration.