GroundWork Open Source Solutions, Inc.
2200 Powell Street Ste. 350 Emeryville CA 94608 · Email: [email protected] | Tel: (866) 899-4342

GroundWork Status Viewer

Copyright 2005 GroundWork Open Source Solutions, Inc. ("GroundWork").
All rights reserved. Use is subject to the GNU General Public License.

Contents

Status Viewer Minimum Requirements

  • MySQL 4.1.8 or higher
  • JDK 1.4.2 (preferably Sun's)
  • Linux kernel 2.6
  • Ant 1.6.x
  • Maven 1.0.x
  • Groundwork Foundation 1.0.0 Installed
    • Verify Foundation PHP API path is in your PHP's include_path
  • Webserver with PHP 5.x Module
  • MySQL & Session Extensions enabled in php.ini file
  • Webserver must have permission to these nagios files:
    • Read access to comment and downtime files
    • Write access to Nagios's command file (if you enabled it in your config)
  • Nagios 1.2 or higher

Installation Instructions

Please see file "INSTALL" in both packages from the SourceForge.net download page. GroundWork Foundation must be installed first.

Overview of Status Viewer

Functionality and Design Principles of Status Viewer

  • User Interface for Nagios
  • Built on top of the Collage database and GroundWork APIs
  • Standard PHP application
  • Designed for operators to display real time status information
  • Displays Nagios object states
  • Displays historical events

Preferences

You may want to start out setting a few preferences for Status. Preferences can be set by selecting the Preferences link from the NetView, TroubleView, and EventView screens. The screen data refresh rate can be set at predefined intervals, you can set the number of events listed in the EventView, and there is a snap feature to help with viewing data. See the table below for complete descriptions.

Refresh Rate

Default is set to 10 seconds. This is the interval used in which the browser will wait until reloading the current page.

Events Per Page

Default is set to 30 events. This is the number of events displayed in the EventView.

Objects Per Page

Default is set to 10 objects. This is the number of child objects displayed when a host or service is expanded.

Snap To Feature

Default is set to Enable. This feature snaps the browser focus to the last object selected when enabled.

NetView

NetView is a monitoring view of your overall network infrastructure. It allows you to view the current status of all Hosts and Services that are being monitored. The NetView produces two main types of output - a listing of the last 5 critical events and a hierarchical drill down status view of all HostGroups, Hosts, and Services. The table below describes the main areas and commands displayed in the Status NetView screen.

NetView Screen

Statistics

Statistics location on the right side of the screen, simply lists a count of your network HostGroups, Hosts, and Services being monitored.

Last 5 Critical Events

Displays the last 5 critical events monitored. This list is updated based on the refresh rate setting in preferences. An event listed but no longer in critical status may remain in the listing unless replaced by a more recent critical event. You can select the Host or Service link to determine its current status.

HostGroups

HostGroups is the main section of NetView. HostGroups contain Host status information which contains Service status information. Host and Service commands are managed here.

[Manual Reload]

Select Manual Reload to refresh the monitoring data manually. You can set the refresh rate to automatically refresh 5 seconds to 5 minute intervals in Preferences.

[Preferences]

In Preferences you have the option of setting a refresh rate, number of lines to be displayed in the EventView, and enable or disable the snap to feature.

[Reload Application]

When selected Reload Application rereads the Nagios configuration and rebuilds the network structure in Status. This will force a more immediate view if a new Host or Service has been added for monitoring.

Drilling Down

The Last 5 Critical Events list displays the event report date, Host name, Service name, severity, application name, and an event message. By selecting a Host or Service name you can drill down to display specific Host or Service status information in an ObjectView. In this ObjectView, you can initiate Host or Service commands such as Disabling Checks or Scheduling Downtime. The table below describes the main areas and commands displayed in the ObjectView screen.

Host or Service Status

The ObjectView screen displays your selected Host or Service status information which includes the current Status, Last Status Check, Status Information, and Status Data Age.

Host/Service Commands

The dropdown Host or Service Commands box lists the options available applicable to the current event.

Execute

Execute submits the selected Host or Service command.

Show Comments for this Host/Service

Click this link to add a comment for a Host or Service.

HostGroups

HostGroups is the main section within the NetView option. HostGroups is the overall view of your network monitoring. The screenshots below take you through the navigation of NetView. First displaying all HostGroups, then Hosts, and then Services. Once you are at your destination you can execute appropriate Host or Service commands, show or add Host or Service comments, or link to additional information or graphs about a Host or Service.

Select the expand    button to display an expandable view of monitored HostGroups. The example below displays the HostGroup Applications Systems and its Host Application 2: E-Valid web transaction.

Select the expand    button again to expand the Host view. The example below displays the Host Application 2: E-Valid web transaction and its Services including nrpe evalid transaction script on Application 2, and script check host Server Win2K Exchange 1 on Application 2.

Select the expand    button once again to expand the Service view. The example below displays the Service nrpe evalid transaction script on Application 2 and the status information.

The clone    button enables the display of HostGroup, Host, and Service information in individual ObjectView windows. This allows you to keep a watch on selected monitors of your choosing while you continue to view data in NetView or other views.

Trouble View

TroubleView is a monitoring view of all the Hosts and Services in trouble (i.e. Critical or Down) and not those in good health. It allows you to quickly view only the Hosts or Services that are in a red state and need attention. The table below describes the main areas and commands displayed in the TroubleView screen. As in the NetView, once you are at your destination you can execute an appropriate Host or Service commands, show or add comments, or link to additional information or graphs about a Host or Service.

TroubleView Screen

Troubled Hosts/Services

A list of all current troubled Hosts/Services.

[Clear Recovered Items]

Select Clear Recovered Items to refresh the Troubled Hosts/Services list to only red state status items. When Troubled Hosts/Services changes state (i.e. recovers) the problem will remain in the list which enables you to track its current status.

From this view you can expand    the Host/Service to view the status information for a selected Host/Service.

Or use the clone    button to isolate a Host/Service to its own window.

EventView

EventView is a monitoring view of all Nagios event messages. It allows you to view a list of all the Hosts and Services that are being monitored. As within NetView's Last 5 Critical Events list you can select a Host or Service links to drill down and display specific Host or Service status information where you can also initiate Host or Service commands. The table below describes the main areas and commands displayed in the Status EventView screen.

EventView Screen

Event Log

All Nagios generated events displaying report data, Host, Service, Application Name, and Message. This is a view similar to the Last 5 Critical Events displayed in NetView but with all severity levels displayed.

Next

Displays the next page of events. The number of events per page can be set in Preferences.

FilterView

FilterView is a tool that allows you to limit what is displayed according to search criteria, or "filters", that the user creates. Below is the form that appears when creating a filter. Note that criteria may be based on Hostgroup, Host, and/or Service, with multiple criteria for each.

Filter Creation Screen

Below is an example of sample output from an executed filter that returns all Hosts without acknowledgement of status.

Filter View Screen