skip to main content
Reporting
  
Reporting
Reports
The Monitoring headline basically covers everything in op5 Monitor that is happening in real time. It shows you the status on your hosts and services right now. The Reporting headline is about letting the user create historical reports from the information that op5 Monitor has collected.
A monitoring system receives a huge amount of data from your IT environment. op5 Monitor has a powerful but yet very easy built-in report generator.
Reports are made from events that have occurred in time, by elements, services or specific groups.
SLA
The reports in op5 Monitor can be mapped against unique Service Level Agreements. This means that you can directly see and follow-up both your internal and external SLAs.
Creating a SLA report
You can either do it a fast an easy way and only follow step 1-3 and 11 in the following guide. By doing that you will use default values in almost all settings.
The complete instruction describes all settings.
To create a SLA report
1 In the main menu to the left click SLA Reporting
And the report setup page is displayed
2 Choose Report type (what type of objects to base your reports on).
We use hostgroups in this guide.
Note that if a host is added to the hostgroup it will not be included automatically in the report.
3 Select the objects you like to base the report on and move them from Available hostgroups to Selected hostgroups.
4 Select Reporting period and Report timeperiod. If you leave Report timeperiod empty it will be the same as 24/7.
5 Choose what SLA calculation method to use.
You may choose between 1
Group availability (SLA)
Average
6 Set the desired values in the following options or go directly to step 7 and leave the settings with their default value.
a Choose if you like to count scheduled downtime as uptime, actual state or uptime with difference.
Uptime, with difference will calculate downtime without scheduled downtime but will show the difference between actual state and the actual state when scheduled downtime is calculated as uptime.
b Choose whether you like to see the alias instead of the host name in the generated report.
c Choose whether to assume state during op5 Monitor downtime.2
d Choose whether you like to hide some specific states of the hosts or services in the report.
e Enter a description of the report. This will be included in the header of the report.
f Choose whether to include soft states or only use hard states in the report.
g Select skin.
This skin will be used in both HTML and PDF reports.
7 Check Cluster mode to create the report where the group logic is reversed so that the OK/UP time is calculated using the most positive service/host state of the selected objects.
8 Type in the SLA values with values from 0.00 to 100.00.
Click on the icon in front of the name of the months to copy the value to the other months that are available 3.
9 Click Create report.
SLA report result
When you have created your report you will get a result page looking like this.
The table below describes the parts of the result page
Nr
Description
1
The icons gives you the possibility to
save the report
direct link to report
save the report as a pdf
print the report.
2
The report graphs.
Click on the numbers on top of every bar and you will get a detailed report for that month.
3
The report result in numbers.
4
A list of every object included in the report. Click on the object name to get a SLA report for each and every object.
Availability
The availability report shows availability of host groups, service groups, hosts or services during a selected report period.
op5 Monitor comes with two different kinds of availability reports. The standard one that comes with Nagios and a new one with extended functionality and nicer presentation. As default the op5 availability report is used but you can reach the old CGI reports by clicking on the Old Availability link.
Creating an Availability report
You can either do it a fast an easy way and only follow step 1-3 and 10 in the following guide. By doing that you will use default values in almost all settings.
The complete instruction describes all settings.
To create an Availability report
1 In the main menu to the left click Availability
And the report setup page is displayed
2 Choose Report type (what type of objects to base your reports on).
We use hostgroups in this guide.
3 Select the objects you like to base the report on and move them from Available hostgroups to Selected hostgroups.
Note that if a host is added to the hostgroup it will not be included automatically in the report.
4 Select Reporting period and Report timeperiod. If you leave Report timeperiod empty it will be the same as 24/7.
5 Choose what SLA calculation method to use.
You may choose between 4
Group availability (SLA)
Average
6 Set the desired values in the following options or go directly to step 7 and leave the settings with their default value.
a Choose if you like to count scheduled downtime as uptime.
b Choose whether you like to see the alias instead of the host name in the generated report.
c Choose whether to assume state during op5 Monitor downtime.5
d Choose whether you like to hide some specific states of the hosts or services in the report.
e Choose whether to assume if the system is logging initial states or not. op5 Monitor does by default so if you have not changed anything in the nagios.cfg file leave the default value as it is.
f Enter a description of the report. This will be included in the header of the report.
g Choose whether to include soft states or only use hard states in the report.
h Select skin.
This skin will be used in both HTML and PDF reports.
7 Check Cluster mode to create the report where the group logic is reversed so that the OK/UP time is calculated using the most positive service/host state of the selected objects.
8 Click Create report.
Availability report result
When you have created your report you will get a result page looking like this.
The table below describes the different parts of the result page.
 
Nr
Description
1
The action icons gives you the possibility to change and save the report. From left to right, those are the icons:
Save it to be able to create a scheduled report
Edit some report settings in a popup frame
Direct link to report
Download the report as a CSV file.
Show the report as an PDF.
Print the report.
 
2
This is the actual result. You can here see how much time each object has been in the different states.
Click on the object names in the list to get a more detailed report.
There are two summary rows in the bottom of the table:
Average
This is the average value for a group of hosts/services. It is calculated by adding the % Time for each host/service and then divide the total value with the amount of hosts/services in the group.
Group Availability (SLA)
This value is only calculated for UP and PROBLEM states (for services OK and PROBLEM states). It displays the amount of time where all hosts/services in the group has been UP/OK or in a PROBLEM state at the same time.
3
A pie chart displaying the result in a graphical way.
Editing the availability report settings
You do not have to create a totally new report if you only like to change a minor settings of the one you just created.
To edit the settings
1 Click edit settings.
2 Edit the settings you like to change in the dialog shown below. All options are described in Creating an Availability report on page 99.
3 Click Update report to save the new values.
 
Save reports
There are two reasons for saving a report:
It is easy to reach the same report the next time you like to see it.
You can automate the report by scheduling it to be sent to you or anybody else in an email or save it as file.
To save a report you need first to create the report. When viewing the report the save option will be available.
The procedure is the same for both SLA reports and Availability reports. In the guide below we will use a SLA report.
Saving a report
To save a report
1 Create a new report as in Creating an Availability report on page 99.
2 In the result page click Save report.
3 Give the report a name.
4 Click Save report.
Schedule reports
When you want to have the reports on regularly basis and do not want to get it through the op5 Monitor GUI each time it is a good idea to schedule the report.
Before you schedule a report you need to create it ( Creating a SLA report on page 94 or Availability report result on page 102) and then save it (Save reports on page 104 ).
Scheduling reports can be done when viewing the report.
 
Note that the report first must be saved before a scheduled report can be created.
In the guides below we will schedule a SLA report but it is done exactly the same way for the availability reports.
To schedule a report from the result page
1 Create the report as shown in Creating a SLA report on page 94.
2 Save the report as shown in Saving a report on page 105.
3 Click create schedule icon.
4 Fill in the options in the new window.
a Select report type, choose the same type of report that you saved before.
b Choose Report Interval. This will be how often the report is supposed to be sent.
c Select the saved report.
d Add Recipients email addresses, separated by a comma.
e Give the report a file name. This is the name that the pdf file will have when it arrives in your mailbox.
f Add a description for the scheduled report.
g Add a path where to save the report. The path must be absolute and include the filename, with either .pdf or .csv prefix depending in what format you want the file. This is optional.
5 Click Save.
Modifying scheduled reports
To modify a scheduled report
1 Click Schedule reports in the main menu.
2 Double click on any field you like to modify.
3 Click OK to save.
4 If you want to save the report as file, enter a absolute path including the filename and prefix (.pdf or .csv) in local persistent filepath.
Deleting scheduled reports
To modify a scheduled report
1 Click Schedule reports in the main menu.
2 Click delete icon on the schedule you like to delete.
3 Click OK.
 
Events and logs
Alert summary - Top alert producers
One of the most useful things when working with op5 Monitor is the Top alert producers report. This report is created from the Alert summary.
The Top alert producers reports makes it easy to identify the biggest problem producers in your environment monitored by op5 Monitor.
There are a few predefined alert summary reports included in op5 monitor but to get the top alert producers we need to create a custom report.
Creating a Top alert producers report
To create a Top alert producers report
1 Click Alert summary in the main menu.
2 Select custom report mode.
3 Select all hostgroups.
4 Select Report period 6.
5 Select Report type and set it to Top alert producers.
6 Leave the Alert Types with the default value.
7 Choose Hard states for State Types, we are only interested in the real problems.
8 Choose only problems sate for both hosts and services.
9 Set the number of items to show in the resulting report. 7
10 Click on Show Report.
Top alert producers result
Now we have a report ready to be examined.
The reason for doing this is to minimize the number of false alerts and false notifications. Now start working with the problems. The sooner the better. You do not want to end up with a monitoring system you do not think you can trust.
Saving an Alert summary report
Alert summary reports are useful from time to time. So when you have created a new one you will probably like to use that one an other time. Then it is a good idea to save it.
To save an Alert summary report.
1 Create an Alert summary report like you did in Creating a Top alert producers report on page 108, show the report then:
2 Click Save report.
3 Enter a name for the report and click Create Summary Report.
Scheduling an Alert summary report
For the exact same reason as it is to schedule an availability report or a SLA report you might want to schedule an alert summary report.
To schedule an alert summary report
1 Create an Alert summary report like you did in Creating a Top alert producers report on page 108 and save the report.
2 Click the plus icon at the right top of the page
3 Follow the instructions in Schedule reports on page 105, just select “Alert summary report” as report type.
4 Click Save.
Trends
Trends display a graphic view of status on a host or a service during a selected time period. This graphical view is reached from Availability reports.
Creating a trend report
To create a trend report
1 Click Include trends graph.
2 The trends will be showed in the report.
Event log
Events is actually a long list of all evens that has occurred on a host. It shows you everything from alerts and notifications to op5 Monitor service restarting. In other words this is a log viewer for the main op5 Monitor log.
Viewing and filtering logs
In the op5 Monitor event log you can
view every event that took place in op5 Monitor
filter out any kind of events you do not want to see
set the start and end time of the logs you like to view.
To view the event log
Click Event log icon in the main menu and there you go.
As you can see in the picture below everything except for Initial and logrotation states are shown by default.
The event log view is divided into two parts
filtering
logs
In the filtering you can change what type of events you like to show and also between what dates you like to view logs for.
The logs are grouped by hours to make it a bit easier to find what you are looking for.
Alert History
The alert history view is a view for all alerts that has been detected by the system.
Viewing and filtering logs
In the op5 Monitor alert history you can
view every alert that took place in op5 Monitor
filter out any kind of alerts you do not want to see
set the start and end time of the alerts you like to view.
To view the alert history
Click Alert history icon in the main menu and there you go.
Filter alert history
The list can be long. Try filter it by using the filter options, this can be accessed through the Edit settings icon.
 

1 Traditional Availability reports are based on group availability (worst case). An alternative way is to use average values for the group or object in question. Note that using average values are by some, considered not to be actual SLA.

2 If the application is not running for some time during a report period we can by this option decide to assume states for hosts and services during the downtime.

3 Only the months that is included in the report and where data is found will be available.

4 Traditional Availability reports are based on group availability (worst case). An alternative way is to use average values for the group or object in question. Note that using average values are by some, considered not to be actual SLA.

5 If the application is not running for some time during a report period we can by this option decide to assume states for hosts and services during the downtime.

6 Since this is the first time we generate this report we use the last 31 days. When you use this on, for example, weekly basis you could use the last 7 days.

7 If you have a large environment with a lots of host you might want to increase the number of shown items.