Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Add instruction to make a more readable Excel example

Table of Contents

opEvents Views

This is an introduction to all the Views in opEvents. 

Dashboard View

The Dashboard View The opEvents home page gives you a snapshot of all the nodes , events, and issues with the most events in your environment in a simple, easy-to-grasp graphical and tabular formats. It displays the Events by Node charts, filtered according to the specified time and event filters. From this page, you can also access the current/escalated events, actions taken, summary reports, unprocessed/raw logs, archived logs, etc. 

Dashboard View

By default, opEvents opens in the Dashboard view that displays the Events by Node. It lists the devices that are generating the most number of events. Time Filter and the most recent events in a table. The Dashboard View is the default Home page for opEvents.

  • Use the time Filter function located at the top right corner of the chart to specify the particular time period you want to look for the events in.
  • Hover over a segment of the pie chart to see the device name.
  • Click on a segment for a comprehensive look at the events on the specific device, occurred during the indicated time period.
  • If you don't want to display a specific device on the chart/graph, you can filter it out by clicking on its name in the legend below the chart/graph. 

In the table below the charts, you can see the list of the most recent events, with the time of the event, the node, the event name, description of the event, the number of times the event occurred, the priority, and the most recent state of the node.

  • Click on a column name/heading to sort the events list by ascending or descending order and find the required events more easily.
  • Use the Search field above the table to find a specific event quickly. You can also narrow the search by selecting a column name from the drop-down list beside the Search field.  

Image Modified

Node Context

To view more comprehensive information about a device, click on a node link under the Node column (from any of the Views pages). This will open the Node Context page of the device. 

Image Modified

On the Node Context page, you can view a snapshot of the device properties, elements up and down, status, and the most recent events on the device.  

  • Click the Details menu item to view the complete raw details for the node.
  • Click View Node in NMIS to open the Node Details page in NMIS.
  • Click the Edit Node menu item to update the Node settings, including the node Name, Host, Location, etc. 
    • You can enable or disable the node activation and licensing here as well as add Comments for the node.
    • You can also Delete the node on the Edit Node page.
  • Click Node Tools to access tools like Ping, Trace, nslookup, etc. You can also open the Edit Node Configuration page from here. 
  • Click the Event Up or Event Down icon to open the Event Context page for that event.
  • You can toggle the State Up and Down, or delete the state using the Edit State icons.
  • In the Recent Events table, click the required link in the Event column to open its Event Context page. 
  • Click the Overview icon to open the Node Events Overview page that displays all of the node events on a single page.
    Image Modified
    • Similar to the Dashboard page, on this page too you can filter the events by time period, select/deselect the events displayed on the charts, search for Events, and probe further into each Event by clicking the Event link in the table.

...

To learn more about an event or view more granular details about it, click on an event link under the Event column (from any of the Views pages). This will open the Event Context page for the event. 

Image Modified

On the Event Context page, you can view a summary of the Event, the node it was generated on, Element, Priority, and the applicable Escalation policy (if configured).  

...

From the top menu, choose Views > Events for a more detailed view of the table on the Dashboard page.

Image Modified

  • Above the table in the top left, you can see the total number of events being reported and the time period of the report. 
  • Apart from other information about the event, its name and the device it occurred on, you can also view the Element Description, event Priority and its Most Recent State. 
  • Click a link under the Date, Node, or Event columns fora for a more detailed view of them.
  • You can add a Note Title to an event by clicking the edit icon in its row and adding it in the text filedfield. After adding the Note Title, click the update icon. 
  • Click on a column heading to sort the events list by ascending or descending order and find the required events more easily.
  • Use the Query field above the table to find a specific event quickly. You can also narrow the search by selecting a column name from the drop-down list beside the Query field.  
  • To generate a copy of this page in CSV format and download it, use the Export to CSV icon below the table. 
  • Specify the number of events you want to display in the table using the Show drop-down menu.

Time Filter

The top right-hand corner of the Event views page has a Filter widget with three buttons:

Image Added

  1. Filter for Advanced Filters - Time Filters, Event Filter, and Summarisation
  2. Period for quick Time Period filtering, with a drop-down of time periods
  3. Toggle to Toggle Auto Refresh

Current Events View

On the Views > Current Events, you can Acknowledge events that have recently occurred and may not have been noticed or acted upon yet.

Image Modified

  • Select the events you want to acknowledge (by clicking the check boxes in the first column) and click the Acknowledge button above the table. 
  • You can also acknowledge all the events on the page in one go, by clicking the Select All check box and then clicking the Acknowledge button.
  • You can add a Note Title to an event by clicking the edit icon in its row and adding it in the text filed. After adding the Note Title, click the update icon. 
  • You can specify the number of events to display in the table using the Show drop-down menu.
  • Click a link under the Date, Node, or Event columns for further information about the device/event. 

...

The Views > Actions page displays the actions taken on the events. Event actions are the conditions an event must conform to and what actions to take in case of a match.

Image Modified

  • In the Actions table, you can view the Event name, its Date, the Node on which the event has occurred, the Action taken, and the Comments added about the specific action. 
  • You can sort the entries in the table by clicking the required column headers.
  • Click an Event link or a Node link (in their respective columns) for further details about them. 
  • Generate a copy of this page in CSV format and download it using the Export to CSV icon below the table. 
  • Specify the number of events to display in the table using the Show drop-down menu.
  • You can customize the information displayed on this page, including the columns of the table, by editing the opEvents_action-log.json file at /usr/local/omk/conf/table_schemas (on the server filesystem). For more information on how to edit these values, see opEvents 2.4.x - Customizing Table Columns.

...

On the Views > Raw Logs page, you can view the current raw event logs. This view is useful for viewing what the full event message says within the Entry column.

Image Modified

  • Click on an Event ID link to open the Event Context page and view the complete details about the event.
  • Click on a log Date link to open the Raw Log Details page and view more details about the selected log. 
    Image Modified
  • To generate a copy of this page in CSV format and download it, use the Export to CSV icon below the table. 
  • Specify the number of raw logs to display in the table using the Show drop-down menu.
  • For a new Type of log to be displayed in the Raw Logs table, add an entry in the opevents_logs section in opCommon.json, as well as in EventParserRules.json. You can find more information on this at opEvents input sources
  • Use the time Filter function at the top right corner of the page to locate the required events more quickly. 
  • You can customize the information displayed on the Raw Logs page, including the columns of the table, by editing the opEvents_raw-log.json file at /usr/local/omk/conf/table_schemas. Learn more about editing these values at opEvents 2.4.x - Customising Table Columns.

...

From the top menu bar, click Views > Archive Logs to view all types of archived logs along with their Entry description.

Image Modified

  • Use the Filter function on the top right corner of the page to choose the number of days you want to look back for the logs depending on your log rotation setup.
  • Generate a copy of this page in CSV format and download it using the Export to CSV icon below the table. 
  • Specify the number of logs to display in the table using the Show drop-down menu.
  • Clicking the archive name under the Archive column will open the Archive Log Details page. It displays the event ID along with other details from the Archive Logs view pertaining to the event.
  • To customize the columns in the Archive Logs table and other information displayed on this page, edit the opEvents_archive-log.json file at /usr/local/omk/conf/table_schemas. For more detail on how to edit these values, see opEvents 2.4.x - Customising Table Columns.

...

To view a list of all the Nodes in your environment and a summary of their properties (including their Group, Location, Customer, Business Services, and their Host), from the top menu bar, click Views > Nodes.

Image Modified

  • The Nodes View allows you to quickly search for a specific node and view its events using the search box above the Nodes table.
  • You can generate a copy of this page in CSV format by clicking the Export to CSV icon below the table. 
  • Specify the number of devices to display in the table using the Show drop-down menu.
  • Click on a node Name to open the device's Node Context page, where you can view more detailed information about the device.
  • You can customize the information displayed on this page, including the columns of the table, by editing the opEvents_node-log.json file at /usr/local/omk/conf/table_schemas (on the server filesystem). For more information on how to edit these settings, see opEvents 2.4.x - Customising Table Columns.

Summary Reports View

For a summary report list about all of the reports generated, from the top menu bar, choose Views > Summary Reports.

Image Modified

  • Click on a Report Title to open and view the full report in a new tab/window. 
  • You can download a report by clicking the Download link in the XLSX column.
  • Specify the number of reports to display in the table using the Show drop-down menu.
  • The items on this table and the information displayed on this page can be customized by going to /usr/local/omk/conf/table_schemas (on the server filesystem) and editing the opEvents_summary-reports.json file. For more information on this process, see opEvents 2.4.x - Customising Table Columns.

...

You can see the generated full report page for the specified time period.         

Summary

...

Reports

You can view a report by clicking on a link in the Title column or by Downloading and opening it with a spreadsheet application.

...

  • An Overview of the report
  • Top 10 nodes by event count
  • Top 10 events by count
  • Event Priorities by count
  • Top 10 nodes and events by event count
  • Top 10 nodes by event weight
  • Top 10 nodes by incident duration
  • Top 10 nodes and incidents by duration
  • Incident Duration Summary
  • Events Summary for 1h Periods
  • Incidents Summary for 1h Periods. 

For a sample full report. click HERE.

Image Removed

Time Filter

The top right-hand corner of the Event views page has a Filter widget with three buttons:

, click  Example Summary Reports.pdf

Image Added


To make a report pdf like the example

  1. Download the report xlsx file and open in Excel
  2. Select all the worksheets by right-clicking on the Overview tab and clicking Select All Sheets.
  3. On the Page Layout tab, in the Page Setup group, click Orientation, and then click Landscape.
  4. On the File tab, select Print
  5. Change Print Active Sheet to Print Entire Workbook
  6. Change No Scaling to Fit Sheet on One Page
  7. On Printer select Microsoft Print to PDF
  8. Click the Print button.
  9. Filter for Advanced Filters - Time Filters, Event Filter, and Summarisation
  10. Period for quick Time Period filtering
  11. Toggle for Toggle Auto Refresh