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

Before generating the report, it will be necessary to set a number of filters and parameters as described below.

Report Scheduling

WOCU-Monitoring also allows the automation of the reporting operation, thanks to the possibility of scheduling its generation and launch at the user’s discretion through the New Scheduling option. More information at: Scheduling.

Report

In this drop-down field the user must select the type of report they wish to create, in this case it will be Availability periods.

../../_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

The four options available are as follows:

Hosts Only: selecting this option will cause the report to refer only to the Hosts monitored in WOCU-Monitoring.

Only BP Hosts: by selecting this option the report will refer only to monitored Business Processes (BP Hosts).

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 monitored Business Processes (Hosts and Services).

All: selecting this option will result in the report referring to all types of Assets monitored in WOCU-Monitoring: 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

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.

../../_images/3_007a_aggregator_realm_reports_reports_availability-group-services-command_0-36.png

For example, under the command check-CISCO-health the results of the health check of the monitored Cisco Devices will be grouped. That is, through this action different Services of different Devices are grouped.

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.

../../_images/3_007b_aggregator_realm_reports_reports_availability-group-services-description_0-36.png

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.

../../_images/3_007c_aggregator_realm_reports_reports_availability-group-none_0-36.png

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.png

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.

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.png

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.

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.

../../_images/3_012_aggregator_realm_reports_reports_availability-states-unavailable_0-56.png

The possible states associated with unavailable elements are:

Hosts:

  • Down

  • Unreachable

  • Pending

For Services:

  • Warning

  • Critical

  • Unknow

  • Pending

More information in: Statements of Assets in WOCU.

By clicking on a particular 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 or Only BP Hosts. In this case the options will not be visible in the report configuration.

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

../../_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

✓ 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: Configuration parameter for the threshold of the time period of availability and/or unavailability. Includes several selectors with multiple options:

  • 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

../../_images/3_095a_aggregator_realm_reports_reports_availability_periods_hosts-periods-threshold_0-38.png

✓ 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.png

There are a number of time criteria already in place:

Today: filters and displays only data recorded during the period of elapsed time in today’s day.

Yesterday: filters and displays only data recorded yesterday.

Last 24 hours: Filters and displays only data recorded in the last 24 hours.

Last 48 hours: Filters and displays only data recorded in the last 48 hours.

Last 7 Days: Filters and displays only data recorded in the last seven days.

Last 30 Days: Filters and displays only data recorded in the last thirty days.

This Week: Filters and displays only data recorded during the time period elapsed in the current week (from the start day of the week to the current day).

Previous Week: Filters and displays only data recorded in the previous full week (Monday to Sunday).

Last 30 days: Filters and displays only data recorded in the last 30 full days from the current date.

This Month: Filters and displays only data recorded during the time period elapsed in the current month (from day 1 to the current day of the month).

Previous Month: Filters and displays only data recorded in the previous full month (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.png

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.png

Attention

Logically, it is not possible to choose start and end dates later than the current date, or to set an end date earlier than the start date.

Once the programming is done, you must press the Apply button for it to be applied.

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

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 Centralized Report Management. 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.

Report Scheduling

WOCU-Monitoring also allows the automation of the reporting operation, thanks to the possibility of scheduling its generation and launching at the user’s discretion through the 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

Through the Export selector located in the global reports panel, the corresponding files will 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.

Note

By clicking on the name tag, the report is accessed. In this space, the report is presented entirely through panels and graphs, for reading and interaction by the user.

../../_images/3_089_aggregator_realm_visualize-report_0-61.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

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.

../../_images/3_020a_aggregator_realm_reports_availability-pannel-configuration-date-interval_0-36.png

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

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

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

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 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

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

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.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 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 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 your own report in real time

This type of report allows editing of the parameters for configuration of operating periods, from this same view, that is, it is possible to edit and generate a new report without having to go back to the Reports 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.