From OpenNMS

Contents 1 Distributed Summary Page 2 Distributed History Page 3 Distributed Details Page 4 Choose resource page showing distributed status data 5 Graph of distributed status data 6 Computation of status data 6.1 Calculation of status for a group of PollStatus objects 6.2 Calculation of status for an application 6.3 Calculation of status for a location monitor and application 7 Troubleshooting 7.1 Graph and features not displaying

Distributed Summary Page

Shows all applications configured in the database as columns and each monitoring locations configured in the XML file as a row. Two pieces of status information are shown for each cell. The color of the cell is computed based on the current status of all services for the specific application and monitoring location. The percentage within the cell is the percentage of the time since midnight that the status of that cell was green, with the exception that the unavailability of distributed monitors isn't counted (we don't currently store historical data for distributed monitors). See the section on computation of status data for details on how this status data is computed.

Clicking on any of the links in the cells with a percentage will take you to the history page for that application and location.

Distributed History Page

Shows graphs over a time period for a specific application and location monitor. A different application, location, location monitor, or time period can be selected and the page will be updated when the "Update" button is clicked. Note: if the location is changed, the first location monitor for that location will be chosen when the page reloads.

Clicking on the "View Status Details" link will take you to the distributed details page for that application and location.

Distributed Details Page

Shows current status of a specific application at a specific location. Note: services within the application that have no OnmsLocationSpecificStatus history are not show. This is a bug that still needs to be addressed. For this reason, the cell for this application and location combination on the summary page might show a different current status than what one would think should be shown based on data on this page.

Choose resource page showing distributed status data

Graph of distributed status data

Computation of status data

Calculation of status for a group of PollStatus objects

• "Critical" if any PollStatus objects return false to isAvailable()
• "Normal" otherwise

Calculation of status for an application

Get a list of all applicable OnmsLocationSpecificStatus objects for services within the application. If a OnmsLocationSpecificStatus object doesn't exist for a specific service, a PollStatus of unknown is used.

Calculation of status for a location monitor and application

• "Indeterminate" if there are no location monitors with current data
• "Normal" if there is at least one location monitor with current data and all location monitors with current data have reported "Normal" for the application
• "Warning" if there is at least one location monitor with current data, at least one of which has reported "Normal" for the application, and at least one of which has reported "Critical" for the application
• "Critical" if there is at least one location monitor with current data, and all location monitors with current data have reported "Critical" for the application

Troubleshooting

Graph and features not displaying

• No data error when looking at the list of locations. Stop the tomcat service, rm -rf $CATALINA_HOME/work/* then restart tomcat.
• A graph error is present when the work directory of tomcat removing when clicking on the % of the poller. Stop the tomcat service, rm -rf $CATALINA_HOME/work/* then restart tomcat.