History of Alarms Report
The History of Alarms report, as its name suggests, provides details of all the alarms that were generated by the eG manager during a configured period of time in the past.
Note:
If the user who logs into the eG Reporter console has been assigned only VMs for monitoring (and not any other component), then the Operational Reports menu will provide only the History of Alarms report option. In this case, the History of Alarms will list all the historical alarms related to the VMs that have been assigned to the current user.
Historical analysis of alarms reveals recurring issues and problem-prone components, and helps deduce problem patterns. Using the filter option provided by the report, you can zoom into specific types of problems and scrutinize them closely. The report also provides analytical tools like detailed diagnosis and graphs, which can be used to perform a post-mortem of the problems and diagnose the root-cause of issues.
To generate this report, do the following:
Select the History of Alarms option from the Operational Reports node of the REPORTS BY FUNCTION tree.
The History of Alarms page will then appear.
You can build filter conditions using this page so that, you can selectively view the alarm history. The first step towards building these filter conditions is selecting a basis for the filter. This can be achieved by picking an option from the Analyze by list. The options available here are as follows:
Component: This is the default selection in the Analyze by list. This implies that by default, the History of Alarms report is generated for all managed components in the environment. If you proceed with the default selection, then, you will find that All is the default selection in the Component Type list, and all the managed components in the environment populate the Component list. If you want to view the alarm history of a particular component of a particular component-type, pick the type of your choice from the Component Type list.; this will make sure that the Component list consists of only those managed components that are of the chosen type. You can then easily pick the component of your choice from the Component list.
Zone: Selecting this option from the Analyze by list will invoke a Zone list. Select a particular zone from this list, if you want to view the history of alarms related to that zone. An Include Subzone flag also appears. By setting this flag to Yes, you can make sure that the alarm history also includes those alarms that are associated with the sub-zones of the chosen zone.
Once a Zone is selected, the Component Type and Component lists will be populated with those component types and components (respectively) that are part of the selected zone. To view the alarm history of a component that is part of a zone, pick that component from the Component list. If the Component list has too many components to choose from, then, you can condense the list by first picking a Component Type; this will make sure that the Component list consists of those components in the selected zone that are of the chosen type. You can then easily pick the component of your choice from the Component list.
Note that the ‘Zone’ option will not be available in the ‘Analyze by’ list if no zones are configured in the environment.
Segment: If this option is chosen from the Analyze by list, a Segment list will additionally appear. In order to view the alarm history pertaining to a specific segment, pick a segment from the Segment list.
Once a Segment is selected, the Component Type and Component lists will be populated with those types and components (respectively) that are part of the selected segment. To view the alarm history of a component that is part of a segment, pick that component from the Component list. If the Component list has too many components to choose from, then, you can condense the list by first picking a Component Type; this will make sure that the Component list consists of those components in the selected segment that are of the chosen type. You can then easily pick the component of your choice from the Component list.
Note that the ‘Segment’ option will not be available in the ‘Analyze by’ list if no segments are configured in the environment.
Service: If this option is chosen from the Analyze by list, a Service list will additionally appear. In order to view the alarm history pertaining to a specific service, pick a service from the Service list.
Once you choose a Service, the Component Type and Component lists will be populated with those types and components (respectively) that are engaged in the delivery of the said service. If you want to view the alarm history of a component that supports the selected service offering, pick that component from the Component list. If the Component list has too many components to choose from, then, you can condense the list by first picking a Component Type; this will make sure that the Component list consists of those components in the selected service that are of the chosen type. You can then easily pick the component of your choice from the Component list.
Note that the ‘Service’ option will not be available in the ‘Analyze by’ list if no services are configured in the environment.
If the Component list consists of too many components, then viewing all the components and selecting the ones you need for report generation could require endless scrolling. To avoid this, you can click the
icon next to the Components list. The Components pop up window will then appear using which you can view almost all the components in a single interface and Select the ones for which the report is to be generated.For viewing the details of alarms that were generated during a specific time window, select a fixed Timeline, or choose Any to provide a date/time range.
In addition to the settings discussed above, this report comes with a set of default specifications. These settings are hidden by default. If you do not want to disturb these default settings, then you can proceed to generate the report by clicking the Run Report button soon after you pick a Component. However, if you want to view and then alter these settings (if required), click on the
button. The default settings will then appear in the More Options drop down window. The steps below discuss each of these settings and how they can be customized.You can even choose to view the details of past alarms that are of a particular priority, by selecting that priority from the Priority list. All is the default selection here.
Next, to view the alarms that have remained unresolved for a time period that is in excess of a specified duration, select the greater than option from the Duration list, enter a value in the adjacent text box, and then select a unit of time from the list box alongside. For example, to view the history of the alarms that have remained unresolved for over 1 hour, select the greater than option, enter 1 in the text box alongside, and select hours from the list box adjacent to it.
Similarly, you can view the history of alarms that have remained unresolved for a time period lesser than a specified duration. To achieve this, select the lesser than option from the Duration is list, specify a value in the adjacent text box, and select a unit of time from the list box.
In addition, you can configure the number of event records to be displayed per page of the event history. By default, 15 records are displayed per page. To display more records, select an appropriate value from the Events per page list.
If you have set alarms for different days of the week or hour or month, you can group those alarms by selecting the respective option from Group Alarms By list box. Based upon your selection, report will be generated.
In large environments, reports generated using months of data can take a long time to complete. Administrators now have the option of generating reports on-line or in the background. When a report is scheduled for background generation, administrators can proceed with their other monitoring, diagnosis, and reporting tasks, while the eG manager is processing the report. This saves the administrator valuable time. To schedule background processing of a report, select the Background Save - PDF option or the Background Save - CSV option from the Report Generation list. In this case, a Report Name text box will appear, where you would have to provide the name with which the report is to be saved in the background. To process reports in the foreground, select the Foreground Generation - HTML option from this list.
Note:
The Report Generation list will appear only if the EnableBackgroundReport flag in the [BACKGROUND_PROCESS] section of the eg_report.ini file (in the {EG_INSTALL_DIR}\manager\config directory) is set to Yes.
The default selection in the Report Generation list will change according to the Timeline specified for the report. If the Timeline set is greater than or equal to the number of days specified against the MinDurationForReport parameter in the [BACKGROUND_PROCESS] section of the eg_report.ini file, then the default selection in the Report Generation list will be Background. On the other hand, if the Timeline set for the report is lesser than the value of the MinDurationForReport parameter, then the default selection in the Report Generation list will be Foreground. This is because, the MinDurationForReport setting governs when reports are to be processed in the background. By default, this parameter is set to 2 weeks - this indicates that by default, reports with a timeline of 2 weeks and above will be processed in the background.
Finally, click the Run Report button to generate the report.
In this report, the details pertaining to every alarm like the start time, duration, name of the component, component-type, test, alarm description, and the service (if any) that is impacted by the issue, are available. Every row of alarm information will be accompanied by a colored indicator, that indicates the corresponding alarm priority. Critical alarms will be of the color red, major alarms will be in orange, and the minor ones come in pink. An alarm with the end time set to current denotes a problem that has still not been fixed.
You can search the generated report for a particular alarm based on various criteria. For instance, to search for alarm information related to all managed components of a particular type, provide the whole/part of the component type to search for in the Search text box and click the
icon alongside. Likewise, you can search based on Component Name, Service, Test, and Alarm Description.
Typically whenever an alarm is raised for the problems at the host-level of a component, the History of Alarms page automatically sets the Component type to Host system, even if the component affected is say, an Oracle Database server or a Web server. From this alarm information, users cannot determine the exact Component type of the affected component. Moreover, help desk personnel may prefer to view the operating system of the problem host as part of the alarm information displayed in the History of Alarms page, as such an information will greatly simplify the troubleshooting process. To make sure that the History of Alarms page enables help desk to easily understand, interpret, and solve problems affecting a host's performance, you can optionally configure the eG Enterprise system to display the actual Component type, Host system, or the affected Operating system for host-level alarms in the History of Alarms page. To enable this capability, do the following:
Edit the eg_ui.ini flag in the <EG_INSTALL_DIR>\manager\config directory
In the [HOST_SYSTEM] section of this file, set the Show_HostSystem flag to any one of the following values mentioned below:
Set the Show_HostSystem flag to HostSystem if you want the component type to be displayed as Host system for the host-level alarms;
Set the Show_HostSystem flag to CompType if you want to display the affected component; This is the default setting that is provided;
Set the Show_HostSystem flag to OS if you want to display the operating system of the host;
Finally, save the file.
Note:
This configuration affects the CURRENT ALARMS window, email/SMS alerts, and SNMP traps as well.
The History of Alarms report also comprises of a
icon, which when clicked, allows you to view the graph of the corresponding measure for the last one hour. If the detailed diagnosis capability has been enabled for the eG installation, then problem measures for which detailed diagnosis is available will be accompanied by the icon. When this icon is clicked, the detailed diagnosis of the measure will appear, throwing greater light on the problem condition.The NEXT, PREVIOUS, LAST and FIRST buttons, and the Page text box are provided to enable you to easily browse the alarm information that runs across pages.
On the other hand, If the Background Save - PDF option is chosen from the Report Generation list, then clicking on the Run Report button will not generate the report and display it in this page for your benefit. Instead, a message indicating that the report is being processed in the background will appear. This will be accompanied by a link, that will lead you to the page that lists all the reports that are being processed in the background, and their current status. If background report generation fails for a report, you can regenerate that report using this page, or can even delete that report if need be. On the other hand, if background processing successfully completes for your report, then, you can view a PDF of the report by clicking on the
icon in that page. Using the icons available at the right, top corner of the report, you can do the following:
PRINT the report
SAVE the report as a PDF file
MAIL the report to configured individuals
Save a Data report to a CSV file
Add the report as a FAVORITE
SCHEDULE the automatic mailing of the report at configured intervals to specific recipients