Availability Reports
WOCU facilitates the monitoring of the level of availability of the monitored technological infrastructure. Through the Availability Report it is possible to evaluate compliance with Service Level Agreements (SLAs) quickly and easily.
The process of creating and executing reports is detailed below, establishing a series of filters and parameters configured by the user.
Configuration and generation of Availability Reports
In general, when creating reports, the user must access the blue New Report button, located in the Reports section.
Before generating the report, it will be necessary to set a number of filters and parameters as described below.
Export of Availability Reports
WOCU-Monitoring also allows the automation of the reports, thanks to the possibility of scheduling their generation and launch at the user’s discretion by means of the New Scheduling More information at: Scheduling.
Report
In this drop-down field, the user must select the type of report he/she wishes to create, in this case it will be Availability.
Note
Depending on the type of report selected, new fields to be defined will be automatically included.
Template
In this optional field the user selects the template to be applied to the Report. Templates are created prior to reports. This element is further developed in section Templates.
Name
Mandatory field in which the user assigns an identification term that differentiates the report from the rest.
Description
Optional field where the user may include descriptive text relating to the report.
Visibility
In this field the user determines whether the report will be visible to the rest of the users, i.e. a public report, or whether it will be private and only visible to the creator of the report.
Alcance (Scope)
This parameter determines the scope of the Availability Report, as the report will refer to one or the other type of Assets monitored in WOCU.
The four options available are as follows:
Only Hosts: By selecting this option the Availability Report will refer only to the Hosts monitored in WOCU.
Only BP Hosts: By selecting this option the Availability Report will refer only to Business Processes (Hosts) monitored in WOCU.
Only Hosts & Services: By selecting this option the Availability Report will refer only to the Hosts and Services monitored in WOCU.
Only BPs - Hosts & Services: By selecting this option the Availability Report will refer only to Business Processes (Hosts and Services) monitored in WOCU.
All: By selecting this option the Availability Report will refer to all types of Assets monitored in WOCU: both Hosts and Services as well as Business Processes.
Group services by
This configuration parameter allows for certain groupings to be made in the detail information about the services monitored by WOCU-monitoring which is reflected in the final report in its Services by service Availability Panel.
The Grouping of Services (Group by) options are as follows:
Command
Selecting this option will display the information from the Services by service Availability Panel will display the report results for the Services grouped in function to the checking command executed by the system in the check for each Service.
For example, under the command “check-cisco-health” the result of the Status check of the monitored Cisco Hosts will be grouped together. That is, by this action, different Services from different Hosts are grouped together.
Description
Selecting this option will display the information from the Services by service Availability Panel will display the report results for the Services grouped in function to the name or description of each Service.
Continuing with the previous example, under the Service description “health_powersupply”, the status of the power supplies of all the monitored Cisco hosts will be grouped. That is, by means of this action, Services from different Hosts are grouped together.
Attention
The Service Command and Service description grouping options cannot be applied when the selected Scope is Host. In this case no grouping shall ever be applied.
None
By selecting this option the Services by service Availability Panel informationwill display the report results for the Services without any grouping. The information in the Panel, in this configuration, details one by one the different Services associated with each of the Hosts.
Important
When this option is selected, an additional field is introduced to the Panel (Hosts) to indicate the Host to which the Service whose percentage of Availability is detailed corresponds.
Host Group
This configuration parameter allows filtering the data collected and reflected in the report, showing only those related to the Host Groups existing in WOCU.
To select and filter the results of the report by a specific Host Group, simply choose the name of the group from the Host Group drop-down menu. All the groups registered within the realm will be displayed.
To deactivate the filter, the user must choose the No HG filter option, which appears first in the list.
In the case of a Multirealm (Multirealm), the list will show the Host Groups defined in the different realms that make up the set. To indicate to the user that a given Host Group belongs to one of the realms that make up the Multirealm, the name of the realm to which the Host Group belongs is enclosed in square brackets (“[Realm]”).
Threshold
This configuration parameter sets the value (in percentage) of the minimum service level threshold that is considered adequate or acceptable. This percentage is closely linked to the fulfilment of Service Level Agreements (SLAs) and is a simple way to evaluate and measure the Availability of a technological infrastructure over a period of time.
By default, the value set in the User preferences is defined. To change it, click on the up and down arrows in the box itself. Each click will add or subtract one unit to this percentage.
Important
El valor debe estar comprendido entre 0 y 100%, con máximo dos decimales.
The value must be between 0 and 100%, with a maximum of two decimal places. When defining a value that does not conform to the above requirements, the system will return the following error messages, preventing the correct configuration of the report:
Group Services
Yes, and only if the user accesses the Availability Reporting option in a Multi-Realm environment, the Group Services option will appear.
When this option is enabled, Services that share the same name will be grouped together even if they are in different Realms. Otherwise, the Services will appear separately and independently in the report.
To activate the filter click on the Group Services button. Once activated, the text On will appear and the background of the button will be highlighted in blue.
To deactivate the filter click on the active button. When deactivated, the text Off will appear and the background of the button will change to grey.
Assumed initial state
These options allow the user to assume and assign the initial state of hosts and services, in case WOCU has not collected enough data to define them.
Possible states for Host:
Down
UP
Unreachable
Current state
Possible states for Services:
OK
Warning
Critical
Unknow
Current state
More information in Statements of Assets in WOCU.
Note
It shall not be possible to select an initial status for a service, when the selected Scope is Host.
Select unavailable states
Every asset monitored in WOCU always has a status associated with it, which is categorised according to whether it is available or unavailable. These configuration options allow the user to choose the status of hosts and services so that they are considered unavailable.
The possible states associated with unavailable elements are:
For Host:
Down
Unreachable
Pending
For Services:
Warning
Critical
Unknow
Pending
More information in Statements of Assets in WOCU.
By clicking on a specific box you can activate or deactivate this option. Note that once selected, the box marked with a tick (✓) will appear inside it.
It is worth mentioning that the Down and Critical states, for hosts and services respectively, are always considered to be unavailable. Therefore they cannot be deselected
Note
It shall not be possible to select a status for unavailable services, when the selected Scope is Host. In this case the options will not be visible in the report configuration.
Include Down Times
The system allows to inhibit for a certain period of time the warnings and alarms of an Asset, which is going to suffer a fall or other known and/or planned event that will affect the status of the Asset.
Checking this box will include all scheduled downtimes on the Assets that make up the report.
Filter service by
This field allows filtering by certain services, in order to monitor their level of availability in the report. This filter acts in the context of:
Host & Services
Only BPs - Hosts & Services
All
The filtering of services will be carried out by defining a regular expression, giving greater flexibility and customisation of the filtering to the operator himself.
For this purpose, the services whose name/description meet those defined in the regular expression will be picked up and displayed in the generated report. On the other hand, services that are outside the entered pattern will be excluded by the system.
Important
Regular expressions will be case insensitive to facilitate filtering.
A simple string or complex regular expressions can be used (see the python documentation for reference).
The regular expression must be valid, otherwise the form itself will do the corresponding validation.
Date intervals
This parameter is used to establish the time period for which the Availability calculation will be made.
There are a number of time criteria already in place:
Today: filters and displays only the events generated during the time period elapsed in today’s day.
Yesterday: generated yesterday.
Last 24 hours: generated in the last 24 hours.
Last 48 hours: generated in the last 48 hours.
Last 7 Days: generated in the last seven days.
Last 30 Days: generated in the last 30 days.
This Week: generated during the period of time elapsed in the current week (from the start day of the week to the current day).
This Month: generated during the period of time elapsed in the current month (from day 1 to the current day of the month).
Previous Week: generados en la anterior semana completa (de lunes a domingo).
Previous Month: generated in the previous full month (from day 1 to days 28/30/31).
In case you want to set a specific period of time there is the option Custom Range. To configure the time frame it is necessary to set a start date and an end date. By clicking on one of the days, this date will be set as a selection, being marked with a blue background. In addition to the day, a specific time can be set for that day, using the drop-down menus in the hour, minute and second boxes, until the desired time is set. The selected date and time can be seen both in the upper boxes and in the lower part of the view.
By clicking on the button with the plus sign (+), it is possible to add multiple date ranges for data collection in the configured report. Date ranges can be deleted by clicking on the red button with the cross (X), the range disappears and only the remaining date ranges are applied when the report is run.
Attention
It is of course not possible to choose start and end dates after the current date, nor to set an end date before the start date.
Once the programming has been carried out, click on the Apply button to apply the programming.
Execution and scheduling of Availability Reports
To save the configuration and generate the report, click on the blue button Create.
Once the report has been created and programmed, you will go back to the initial screen of this section, where the reports will be stacked sequentially in the reports in the Reports.Within the panel is the user can access the generated report by clicking on the name of the report.
Next, the user is directed to a new, exclusive report window where the information generated and collected by the system is presented. These panels are described in detail in the following section.
Export of Availability Reports
WOCU-Monitoring also allows the automation of the reports, thanks to the possibility of programming their generation and Scheduling option.
Export of Availability Reports
WOCU also allows the export of the Availability Report in PDF, CSV and JSON format. These condense all the information on the Availability of the monitored Assets into a document that is easy to disseminate and simple to analyse. These options facilitate the immediate sending of information.
Using the Export to PDF, CSV and JSON buttons located in the global report panel next to the other available actions, the corresponding files will be downloaded.
Important
WOCU will return the following error message when the scope of the report exceeds a certain number of hosts. The default number is 1,000 hosts, but this number may vary depending on the environment and infrastructure being monitored.
Note on the PDF Availability Report
This section briefly describes the main elements of this document. For more information, please refer to Analysis and Options for Availability Reports.
Cover
The cover page shows as the main title the type of report generated, in this case Availability.
Configuration
The following page presents the filters and parameters set in the configuration of the generated report. These are:
There are
Identifier: Identifier code of the report.
Name: identification name assigned to the report.
Description: descriptive text relating to the report.
Create at): indicates the date and time the report was created.
Create by: indicates the user who created/owns the report.
Scope: details the name of the Realm that is the subject of the report and what type of Realm it is.
Date interval: indicates start and end time and date of the period.
Exported on: indicates time and date of export of the PDF report.
Custom configuration parameters:
Scope: indicates the scope of the Availability Report (Host, Host & Services, Business Processes, All).
Services grouped by: indicates the type of grouping of services for the calculation of availability. This field shall not appear in the report when no grouping type is applied, i.e. Host is selected in the Scope parameter.
Hostgroup: reports the host group selected for the availability calculation. This field shall not appear in the report when it is not configured in the Hostgroup parameter.
Threshold: indicates the minimum percentage of availability set.
Assumed initial states: indicates the status assigned and assumed by the user for both Host and Services. Assets with assumed states shall be notified with an attention signal icon (⚠).
Unavailable states: indicates the type of state(s) categorised as unavailable, chosen by the user, for non-operational Host and Services.
Services filtered by: indicates the regular expression defined and applied in the report for the filtering of services.
Comments
The next page is intended for comments added by the report creator or WOCU administrator.
There is the possibility to remove the comments page from the exported report. In the export confirmation window, there is a checkbox to select whether or not to export the report with the attached comments. If the box is not checked, this page will not be displayed in the exported report.
Global summmary
The following page includes an export of the Availability Panels corresponding to the selection of assets made by the user in the filters. A graphical summary of the percentage of Availability obtained for the set of selected elements is provided.
Availability Dossier
The same page includes the Availability Dossier Panels by status corresponding to the selection of assets made by the user in the filters. A numerical summary is provided indicating the elements that meet or do not meet the minimum percentage of Availability established.
Hosts Availability.
If the selection of assets made by the user in the filters refers to or includes hosts, the report shall include this section detailing, one by one, the statistics and availability data of the selected hosts within the given time frame.
For each Hosts a graphical summary is included showing:
Host Name.
Date range: indicates start and end time and date of the period configured for the collection of availability data.
Initial state info: indicates the initial state of the host, together with the exact date and time at which WOCU recorded this state. Remember that in the event that the system has not collected enough data to to define the initial status, the user may assume and assign a starting state during the report configuration in the Assumed initial state. This status shall be identified in the report by the icon of an attention signal (⚠) followed by the word Assumed.
Total Downs: indicates the total number of downs (loss of availability) suffered by a host during the set time frame.
Time Down: recorded in days, hours and minutes the time during which the host has been unavailable.
Availability: reached by the host during the set time frame. The bar changes size and colour depending on the percentage of availability reached. At the same time, it is complemented with numerical information on this percentage.
Events timeline: graphical representation of the host status in WOCU during the set time frame.
Additionally, this summary is accompanied by the host status change history, where all events recorded in WOCU are detailed. This history allows a detailed study of the activity of a host.
Service availability
If the selection of assets made by the user in the filters refers to or includes services, the report will include this section detailing, one by one, the statistics and service data of the selected assets within the given time frame.
The information in this section includes three fields:
Services with an assumed initial state (current state): services with the initial state assumed by the user will be identified in the list with an attention sign in front of the percentage bar.
Hosts Name: to which each service belongs.
Name of each Service.
Percentage of Availability: reached by the service. Services with assumed statuses shall be notified with an attention signal icon (⚠).
Analysis and Options for Availability Reports
The information generated by WOCU for the Availability Report is presented to the user through a total of seven panels grouped in four main groups or rows.
All Availability Report Panels include next to the descriptive text their Time Frame: Time From: [date and time] | Time to: [date and time].
Report configuration panel
As in the Availability Report exported in PDF, there is a configuration panel where the filters and parameters set in the configuration of the generated report are presented. These are:
There are
ID: Report identifier code.
Name: identification name assigned to the report.
Description: descriptive text relating to the report.
Comments: displays comments added by the user.
Create at): indicates the date and time the report was created.
Create by: indicates the user who created/owns the report.
Realm:Indicates the name of the Realm which is the subject of the report.
Scope: indicates the scope of the Availability Report (Host, Host & Services, Business Processes, All).
Threshold: indicates the minimum percentage of availability set.
Assumed hosts initial states
Unavailable states: indicates the type of state(s) categorised as unavailable, chosen by the user, for non-operational Host and Services.
Services grouped by: indicates the type of grouping of services for the calculation of availability. This field shall not appear in the report when no grouping type is applied, i.e. Host is selected in the Scope parameter.
Assumed services initial states
Unavailable states: indicates the type of state(s) categorised as unavailable, chosen by the user, for non-operational Host and Services.
Date interval: indicates start and end time and date of the availability data collection period. In multiple time frames, the periods shall be presented in tabular format. Remember that the total range limit is 31 days.
Indicates the inclusion in the report of scheduled downtimes on constituent Assets.
Global Availability Report Panels
In the second row of the Availability Report there are two panels that graphically show the percentage of availability obtained, calculated by WOCU for Hosts and Services, during the configured time period.
The area covered in green represents the percentage of availability reached. Inside each graph, the percentage availability value is included, together with the Threshold predefined by the user, which is also marked on the graph with a dashed line. Depending on the compliance or non-compliance with the established minimum availability Threshold, a green ✓ will appear in front of the availability percentage, when the availability exceeds the set value, or a red X if it does not.
In the above example, the obtained percentage of availability of hosts (97.04%), is above the established threshold (98%).In the percentage value of Services (5.34%) is below the set.
Note
If in the Scope parameter the option to display Business Processes or the option All has been chosen, the panels shall display, respectively, Business Process Hosts and Business Process Services.
Availability Dossier Panels by State
In the third row of the Availability Report there are two panels that count the compliance status of the different Hosts (Hosts) and Services (Services) monitored. WOCU thus allows you to know how many have met the availability Threshold, set for the established period.
The compliance status of these panels is as follows:
Always Available
The green figure indicates how many of the assets have 100% availability.
Above Threshold
The yellow figure indicates how many of the assets have an availability below 100% but above the Availability percentage set in the Threshold.
Below Threshold
The orange figure indicates how many of the assets have an availability below the availability percentage set in the Threshold.
Never Available
The figure in red indicates how many of the assets have an availability of 0%.
Total Hosts/Services
The figure in black indicates how many assets of this type are monitored in WOCU.
This panel, in addition to serving the user as a numerical overview, also performs filtering functions, which have effects on the fourth group of Availability Report panels: Availability Report Asset Detail Panels. By clicking on the different states of availability compliance statuses, the following detail panel will show only the hosts and services selected in this panel. By default, all Hosts and Services are displayed. By selecting another availability status, the selected option will be highlighted with a grey background and the filter will be applied in the Detail Panel.
Important
If in the Scope parameter the option to display Business Processes or the option All has been chosen, the panels shall display, respectively, Business Process Hosts and Business Process Services.
Availability Report Asset Detail Panels
In the fourth row of the Availability Report are two panels that give detailed visibility on the availability of monitored hosts and services on an individualised and/or aggregated basis.
WOCU thus facilitates a detailed availability analysis for each element, and even allows the study and analysis of the degree of availability achieved for a certain type of service, thanks to the Services grouped by option mentioned above.
Attention
If in the Scope parameter the option to display Business Processes or the option All has been chosen, the panels shall display, respectively, Business Process Hosts and Business Process Services.
Hosts by host Availability
This panel provides the availability percentage for each Host. Through this mode WOCU allows to observe the availability detail of critical infrastructure elements or simply an individualised analysis of the elements.
The detail panels have the following fields:
Hosts
Indicates the name of the host or service for which availability data is provided.
Total Downs
Indicates the total number of downs (loss of availability) suffered by a host during the set time frame.
Time Down
Indicates the total number of downs (loss of availability) suffered by a host during the set time frame.
Percentage
Indicates the percentage availability value reached by the asset, in the time period set for the report. The field contains a bar that changes size and colour depending on the percentage of availability reached. In turn, the bar is complemented by the icon of an attention signal, when the initial status of the asset is assumed by the user.
Downtime
Clicking on any record in the Hosts table will pop up a new window with specific availability information about the host:
This window provides the following information:
✓ Host
✓ Realm origin: Realm in which the host is embedded.
✓ Date range: indicates the start and end date and time of the period configured for the collection of availability data. In the case of having configured several time frames, this field will display each of them.
✓ Time bar: which provides a history of the availability of the host over the established time range. A simple legend accompanies this graphical representation, informing the total time (given in days and hours) that the host has been available (in green) or unavailable (in red).
Along with the exact date and time at which this status was reached and recorded, the Initial State of the host is added.Remember that in the event that the system has not collected sufficient data to define the initial state, the user may assume and assign a starting state during the configuration of the report in the parameter Assumed initial state.
In this case, WOCU shall indicate that the initial state has been assumed by the user with the text: ⚠ Initial state has been assumed. This situation shall also be recorded and displayed in the time bar.
✓ Event history table: where the alternating states occurred during the defined time range. More information on states and associated colours in Statements of Assets in WOCU.
Each entry in the table shall contain the following information:
Time column: details the exact date and time when a status change was registered and therefore an event was generated.
State column: indicates whether for the date and time at which a new state was registered, the host is available (✔️ in green colour) or unavailable (❌ in red colour). Remember that the unavailable states are configured by the user during the generation of the report in the parameter
Select unavailable states for hosts.Event column: indicates the status that WOCU calculated for the host at the time of receipt of the event.
When there are Assets with scheduled downtimes and the Include Down Times has been checked during the report configuration, this view may change. We will illustrate this case with the following example:
The period(s) of scheduled downtime between one date and another are also recorded and represented in the time bar. In order to identify this situation, the legend includes a new entry indicating the colour code associated with this state, together with the following explanatory text: During this period no events will be recorded and host state is assumed to be UP >> During this period no events will be recorded and host state is assumed to be UP..
Important
Downtimes are included in the availability band (UP).
Finally, in the Event History Table where the alternation of states is recorded, the set of scheduled downtime periods occurring during the defined time range shall be listed.
Each entry in the table shall contain the following information:
Time Column: date and time at which the start or end of the downtime period, and therefore of the event, was recorded. Thanks to the labels shown in the Event Column, we can identify whether the period starts (
Downtime Start) or ends (Downtime End).State column: indicates the optimum availability status of the host (✔️ in green). Remember that the down times are included in the total availability range (UP) of the host.
Services by service Availability Panel
This panel provides the percentage of Availability for Services. Through this mode WOCU allows to observe the availability detail of critical infrastructure elements or simply an individualised analysis of the elements.
The detail panels have the following fields:
Services
Indicates the name of the host or service for which availability data is provided.
Percentage
Indicates the percentage availability value reached by the asset, in the time period set for the report. The field contains a bar that changes size and colour depending on the percentage of availability reached. In turn, the bar is complemented by the icon of an attention signal, when the initial status of the asset is assumed by the user.
All
Additionally, it is worth remembering that if the user uses the Group by filter with the None option, an additional field will appear in the Services detail panel: the Hosts field that will identify the host to which each listed Service belongs.
Important
Clicking on any record in the Services table will redirect the user to the Detailed view of Services associated to a Host.
Calculation of availability
Framed in a specific time interval, the availability calculation of the configured sample is obtained by the following formula:
Note
Equivalently, the availability of Services is obtained with the formula presented.
→ Where i is a Host, if it is a Host Report (Hosts) or a Service, in Service-based Reporting.
→ where n is the total number of Hosts or Services.