Availability Periods Reports
WOCU manages and provides detailed information about the availability of the Hosts and Services of the monitored technological infrastructure.
Availability is a concept subject to very varied configurations, for this reason, with the (In)Availability Periods Report, it is possible to configure and obtain the periods of operability of the Hosts and Services that comply with the established configuration.
In other words, this report answers questions such as: Hosts in the Realm that have been down for more than one day in the month of October.
Next, the process of creating and running reports is detailed, establishing a series of filters and parameters configured by the user.
Configuration and generation of Availability Periods Reports
In general, when creating reports, the user must access the blue button New Report, located in the Reports.
![../../_images/3_003_aggregator_realm_reports_reports_new-report-button_0-58.png](../../_images/3_003_aggregator_realm_reports_reports_new-report-button_0-58.png)
Before generating the report, it will be necessary to set a number of filters and parameters as described below.
Export of reports from Visualize.
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. For more information, see: 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 periods.
![../../_images/3_093_aggregator_realm_reports_reports_availability_periods_type_0-58.png](../../_images/3_093_aggregator_realm_reports_reports_availability_periods_type_0-58.png)
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 shall determine whether the report will be visible to other users, i.e. a public report, or on the contrary will be private and will only be visible to the creator of the report.
Scope
This parameter determines the scope of the Periods of Availability Report, as the report will refer to one or the other type of Assets monitored in WOCU.
![../../_images/3_006_aggregator_realm_reports_reports_availability-scope_0-58.png](../../_images/3_006_aggregator_realm_reports_reports_availability-scope_0-58.png)
The four options available are as follows:
Only Hosts: By selecting this option the report will refer only to the Hosts and Services monitored in WOCU.
Only BP Hosts: By selecting this option the report will refer only to Business Processes (BP Hosts) monitored in WOCU.
Only Hosts & Services: selecting this option the report will refer only to the monitored Hosts and Services.
Only BPs - Hosts & Services: By selecting this option the report will refer only to Business Processes monitored in WOCU.
All: By selecting this option the 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 of Services monitored by WOCU, which will be reflected in the future report.
![../../_images/3_007_aggregator_realm_reports_reports_availability-group-services-by_0-58.png](../../_images/3_007_aggregator_realm_reports_reports_availability-group-services-by_0-58.png)
The grouping options for the Services 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 monitored. That is to say, this action groups together different Services from different Hosts.
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 example above, under the Service description
health_powersupply
will group the status of the power supply status of all monitored Cisco hosts. That is, this action groups together Services from different hosts.
Attention
The Service Command and Service Description grouping options cannot be applied when the Scope selected is Host. In this case no grouping shall ever be applied.
None
By selecting this option the Services by service Availability Panel information will 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.
![]()
Host Groups
This configuration parameter allows filtering the data collected and reflected in the report, showing only those related to the Host Groups existing in WOCU.
![../../_images/3_008_aggregator_realm_reports_reports_availability-hostgroup_0-36.jpg](../../_images/3_008_aggregator_realm_reports_reports_availability-hostgroup_0-36.jpg)
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, 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]“).
![../../_images/3_008a_aggregator_realm_reports_reports_availability-hostgroup-multirealms_0-36.jpg](../../_images/3_008a_aggregator_realm_reports_reports_availability-hostgroup-multirealms_0-36.jpg)
Group Services
If and only if the user accesses the Availability Periods Reporting option in a Multi-Realm environment, the Group Services option will appear.
![../../_images/3_009_aggregator_realm_reports_reports_availability-agrupate-services_0-36.jpg](../../_images/3_009_aggregator_realm_reports_reports_availability-agrupate-services_0-36.jpg)
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.
![../../_images/3_009a_aggregator_realm_reports_reports_availability-agrupate-services-on_0-36.jpg](../../_images/3_009a_aggregator_realm_reports_reports_availability-agrupate-services-on_0-36.jpg)
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 a grey colour.
![../../_images/3_009b_aggregator_realm_reports_reports_availability-agrupate-services-off_0-36.jpg](../../_images/3_009b_aggregator_realm_reports_reports_availability-agrupate-services-off_0-36.jpg)
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.
![../../_images/3_011_aggregator_realm_reports_reports_availability-assumed-state_0-36.jpg](../../_images/3_011_aggregator_realm_reports_reports_availability-assumed-state_0-36.jpg)
Possible states for Hosts:
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 or Only BP Hosts.
Filter by service
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
Business Processes Only .
All
![../../_images/3_013_aggregator_realm_reports_reports_availability-filter-service-by_0-58.png](../../_images/3_013_aggregator_realm_reports_reports_availability-filter-service-by_0-58.png)
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 pattern entered 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.
Hosts/Services periods configuration
For the configuration of availability and non-availability periods of Hosts and Services, there are three parameters:
![../../_images/3_095_aggregator_realm_reports_reports_availability_periods_hosts-periods-configuration_0-58.png](../../_images/3_095_aggregator_realm_reports_reports_availability_periods_hosts-periods-configuration_0-58.png)
✓ Availability: configuration parameter for the display of assets according to their availability. The possible options are:
Show available: By ticking this box, the report will collect and show in detail, the period(s) of availability of Hosts and Services.
Show unavailable: By ticking this box, the report will compile and show in detail, the period(s) during which the Hosts and Services have not been operational.
✓ Duration Threshold: parámetro de configit guración del umbral del periodo de tiempo de disponibilidad y/o no disponibilidad. Incluye varios selectores con múltiples opciones:
Temporary conditions:
Equals to >
Lower than >
Lower or equals to >
Greater than >
Greater or equals to >
Duration: value of the selected time unit.
Unit of time:
Seconds
Minutes
Hours
Days
Weeks
![]()
✓ Grouping: configuration parameter for the grouping of availability periods.
Show only max periods per host/services: Checking this box will group the different periods of a Host or Service, showing only the longest period registered in WOCU.
Note
You will not be able to configure Service periods when the selected Scope is Host or Only BP Hosts. In this case the configuration options will be disabled.
Date intervals
This parameter is used to establish the time period for which the Availability calculation will be made.
![../../_images/3_014_aggregator_realm_reports_reports_availability-date-interval_0-36.jpg](../../_images/3_014_aggregator_realm_reports_reports_availability-date-interval_0-36.jpg)
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: generated in the previous full week (Monday to Sunday).
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.
![../../_images/3_015_aggregator_realm_reports_reports_availability-date-interval-custom_0-36.jpg](../../_images/3_015_aggregator_realm_reports_reports_availability-date-interval-custom_0-36.jpg)
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.
![../../_images/3_032_aggregator_realm_reports_reports_top-hosts-date-interval-multiple_0-36.jpg](../../_images/3_032_aggregator_realm_reports_reports_top-hosts-date-interval-multiple_0-36.jpg)
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 Periods reports
To save the configuration and generate the report, click on the blue Create.
![../../_images/3_016_aggregator_realm_reports_options-creation_0-58.png](../../_images/3_016_aggregator_realm_reports_options-creation_0-58.png)
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.
![../../_images/3_078b_aggregator_realm_reports_reports_inventory-view_0-58.png](../../_images/3_078b_aggregator_realm_reports_reports_inventory-view_0-58.png)
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 reports from Visualize.
WOCU-Monitoring also allows the automation of the reports, thanks to the possibility of programming their generation and Scheduling option
Export of Availability Periods Reports
WOCU-Monitoring also allows the export of the report in PDF, CSV and JSON formats. These condense all information on the availability of the monitored assets in a document that can be easily dissemination and simple analysis.
![../../_images/3_078d_aggregator_realm_reports_inventory-export-actions_0-58.png](../../_images/3_078d_aggregator_realm_reports_inventory-export-actions_0-58.png)
Through the Export selector located in the global report panel, the corresponding files shall be downloaded”
Availability Periods Analysis and Reporting Options
The information generated by WOCU for this type of report is presented to the user through panels that will vary in number depending on the configuration set.
![../../_images/3_096_aggregator_realm_reports_visualize_availability_periods_0-58.png](../../_images/3_096_aggregator_realm_reports_visualize_availability_periods_0-58.png)
Configuration panel
First of all, the configuration panel is presented, which will be fixed in all reports. In it, the filters and parameters established in the configuration of the generated report are presented.
![../../_images/3_096a_aggregator_realm_reports_visualize_availability_periods-configuration_0-58.png](../../_images/3_096a_aggregator_realm_reports_visualize_availability_periods-configuration_0-58.png)
These 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 that is the subject of the report.
Scope: indicates the scope or scope of the report (Host, Host & Services, Business Processes and All).
Threshold: indicates the minimum minimum availability set.
Assumed hosts initial states: indicates the status assigned and assumed by the user for Hosts.
Unavailable states for hosts:Indicates the type of status or statuses categorised as unavailable, chosen by the user, for non-operational Host(s).
Assumed services initial states: indicates the status assigned and assumed by the user for Services
Unavailable states for services: Indicates the type of status or statuses categorised as unavailable, chosen by the user, for non-operational Services.
Services grouped by: Indicates the type of grouping of services for the availability calculation. This field shall not appear in the report when no grouping type is applied, i.e. Host is selected in the Scope parameter.
Date interval: indicates start and end time and date of the availability data collection period. In multiple frames, the periods shall be presented in tabular format. Remember that the total range limit is 31 days.
![]()
Host Availability Periods Panel
Below is the panel listing the periods of availability and/or unavailability, obtained for Hosts during the configured time period.
![../../_images/3_096b_aggregator_realm_reports_visualize_availability_periods_hosts-panel_0-58.png](../../_images/3_096b_aggregator_realm_reports_visualize_availability_periods_hosts-panel_0-58.png)
This panel is divided into two blocks:
1) Host operating period configuration filters
The configuration set in the report on the availability periods of the Hosts of the Realm in question is displayed.
![../../_images/3_096c_aggregator_realm_reports_visualize_availability_periods_hosts-panel-filters_0-58.png](../../_images/3_096c_aggregator_realm_reports_visualize_availability_periods_hosts-panel-filters_0-58.png)
Note
More information on each of these filters can be found at: Hosts/Services periods configuration.
2) Table of Asset operating periods
List of periods of availability and/or non-availability for each Host of the Realm concerned.
![../../_images/3_096d_aggregator_realm_reports_visualize_availability_periods_hosts-panel-table_0-58.png](../../_images/3_096d_aggregator_realm_reports_visualize_availability_periods_hosts-panel-table_0-58.png)
Attention
The table is ordered from longest to shortest period.
The information displayed is distributed in the following columns:
✓ Availability icon: indicates the status of the Host in the registered period, i.e. whether during this period it has been available (✔️ in green colour) or unavailable (❌ in red colour).
✓ Host: name of the Host registering the period. Clicking on the name will redirect the user to the Detailed view of Assets: Hosts and Business Processes.
✓ Duration: indicates the total time frame of the period. This interval is expressed in weeks (w), days (d), hours (h), minutes (m) and seconds (s).
✓ Started at: indicates the exact start time of the recorded period.
✓ Ended at: indicates the exact time at which the recorded period ends.
Important
As very large lists are generated, it is recommended to use the search bar to search for a specific Host and the paging options to navigate through the different pages of the list.
Services Availability Periods Panel
Provided that the scope of the report includes Services, an additional panel will be displayed with the list of periods of availability and/or unavailability, obtained for the Services associated to Hosts, during the configured time period.
![../../_images/3_096e_aggregator_realm_reports_visualize_availability_periods_services-panel_0-58.png](../../_images/3_096e_aggregator_realm_reports_visualize_availability_periods_services-panel_0-58.png)
This panel is divided into two blocks:
1) Service operating period configuration filters
The configuration set in the report on the availability periods of the Hosts of the Realm in question is displayed.
![../../_images/3_096c_aggregator_realm_reports_visualize_availability_periods_hosts-panel-filters_0-58.png](../../_images/3_096c_aggregator_realm_reports_visualize_availability_periods_hosts-panel-filters_0-58.png)
Note
More information on each of these filters can be found at: Hosts/Services periods configuration.
2) Table of Service operating periods
List of periods of availability and/or unavailability for each Service associated with a Host.
![../../_images/3_096f_aggregator_realm_reports_visualize_availability_periods_services-table_0-47.jpg](../../_images/3_096f_aggregator_realm_reports_visualize_availability_periods_services-table_0-47.jpg)
Attention
The table is ordered from longest to shortest period.
The information displayed is distributed in the following columns:
✓ Availability icon: indicates the status of the Service in the registered period, i.e. whether during this period it has been available (✔️ in green colour) or unavailable (❌ in red colour).
✓ Service: name of the Service registering the period. Clicking on the name will redirect the user to the Detailed view of Services associated to a Host, except when services are grouped by command or description.
✓ Host: name of the Host to which the Service of the period in question is associated. Clicking on the name will redirect the user to the Detailed view of Assets: Hosts and Business Processes.
✓ Duration: indicates the total time frame of the period. This interval is expressed in weeks (w), days (d), hours (h), minutes (m) and seconds (s).
✓ Started at: indicates the exact start time of the recorded period.
✓ Ended at: indicates the exact time at which the recorded period ends.
Important
As very large lists are generated, it is recommended to use the search bar to search for a specific Service and the pagination options to navigate through the different pages of the list.
Editing reports from Visualize
This type of report allows the editing of operational period configuration parameters from this same view, i.e. it is possible to edit and generate a new report without having to go back to the Report management page.
To do this, one of the parameters available at the top of the panels must be modified:
The new results will be instantly displayed in the relevant listings.
Attention
The edited and exported report with a new configuration will NOT be saved in the report history. Only the initial report launched will be recorded.