RTView® EM
User Guide


Using the Monitor - Introduction

RTView EM uses visual cues (such as color coding, graphic charts and sizing of shapes) to communicate the current state of all elements in your system. This section describes how to interpret EM displays, as well as display behavior and GUI functionality.

EM comes with Solution Packages that you can optionally install (such as the GlassFish or Business Works Monitors). The optional Solution Packages are not described in this document. This section includes:

NOTE: It typically takes about 30 seconds after a server is started to appear in an RTView EM display. By default, data is collected every 15 seconds, and the display is refreshed 15 seconds after that.

 


Reading Displays

To interpret EM displays it is essential to understand that which drives the structure of all EM displays--the Service Data Model. The Service Data Model also enables data aggregation and filtering in displays. For these reasons, we begin this section with the Fundamental Structure of Displays, followed by discussion of how to read specific display objects. This section includes:

Fundamental Structure of Displays

To interpret EM displays it is helpful to understand the Service Data Model. The Service Data Model, also referred to as the CMDB, is a database that forms the fundamental structure of all EM displays. The Service Data Model has a four level hierarchy which are, from the highest level (Owner) to the lowest level (Service):

  • Owner
  • Area
  • Group
  • Service

The Service Data Model maps all the Configuration Items (CIs) in your EM system to one or more Services (CIs are items being monitored by EM--servers, processes and so forth--anything that can be configured). Each Service is mapped to a Group, each Group to an Area and each Area to an Owner. Displays are organized and populated with data according to this hierarchy. This mapping enables EM to aggregate data for several hundreds of CIs, and allows objects (heatmaps, tables and so forth) to filter data shown according to user selections.

For details about the Service Data Model, see Configure Service Data Model.


Heatmaps

RTView EM heatmaps organize CIs (according to the Service Data Model) into rectangles and use color to highlight the most critical value in each. Heatmaps enable you to view various alert metrics in the same heatmap using drop-down menus. Each Metric has a color gradient bar that maps relative values to colors. In most heatmaps, the rectangle size represents the number of CIs in the rectangle; a larger size is a larger value. Heatmaps include drop-down menus to filter data by Owner, Area, Group, Service, Region and Environment. The filtering options vary among heatmaps.  

For example, the Area Heatmap (in the following figure) illustrates a typical EM heatmap. The heatmap contains a Metric drop-down menu with options to show Alert Impact, Alert Severity, Alert Count and Criticality (menu options vary according to the data populating the heatmap). Alert Impact is selected and its corresponding color gradient bar is shown. Each rectangle represents all CIs in an Area. The red rectangle in the heatmap indicates that one or more CIs in that Area currently has an alert in an alarm state. The yellow rectangles in the heatmap indicate that one or more CIs in those Areas currently have an alert in a warning state. A green rectangle would indicate that no alert is in a warning or alarm state in an Area.

Continuing with our example, there are two filtering options. You can choose to show all Owners or a single Owner, and all Environments or a single Environment. Each rectangle represents an Area. The rectangle size represents the number of CIs in the rectangle; a larger size is a larger value. You can also mouse-over a rectangle to see more values. The following figure illustrates the mouse-over feature in which we see all the Metric drop-down values.

In most heatmaps, you can also drill-down to more detail by clicking a rectangle in the heatmap. Or, open a new window by using the button and then drill-down. The drill-down opens a display that contains relevant and more detailed data.

As previously mentioned, each Metric has a color gradient bar that maps relative values to colors. The following summarizes the heatmap color code translation for typical EM heatmaps:

Alert Impact The product of the maximum Alert Severity multiplied by the maximum Criticality of alerts in a given heatmap rectangle. Values range from 0 - 10, as indicated in the color gradient bar, where 10 is the highest Alert Impact.
Alert Severity The maximum level of alerts in a given heatmap rectangle. Values range from 0 - 2, as indicated in the color gradient bar, where 2 is the highest Alert Severity.
  Metrics that have exceeded their specified ALARM LEVEL threshold have an Alert Severity value of 2. For a given heatmap rectangle, this indicates that one or more metrics have reached their alert thresholds.
 
  Metrics that have exceeded their specified WARNING LEVEL threshold have an Alert Severity value of 1. For a given heatmap rectangle, this indicates that one or more metrics have reached their warning thresholds.
 
  Metrics that have not exceeded either specified threshold have an Alert Severity value of 0. For a given heatmap rectangle, this indicates that no metrics have reached their warning or alert thresholds.
 
Alert Count The total number of critical and warning alerts in a given heatmap rectangle. The color gradient bar, populated by the current heatmap, shows the value/color mapping. The numerical values in the gradient bar range from 0 to the maximum count of alerts in the heatmap. The middle value in the gradient bar indicates the average alert count.
Criticality The maximum level of Criticality (rank of importance) in a given heatmap rectangle. Values range from 1 to 5, as indicated in the color gradient bar, where 5 is the highest Criticality.

Criticality is specified in the Service Data Model (CMDB) by your administrator. Criticality values are listed in the Component Views / CI Service Table display, which range from A to E, where A is the highest Criticality (level 5 maps to a Criticality of A and level 1 maps to a Criticality of E with equally spaced intermediate values).

Mouse-over

The mouse-over functionality provides additional detailed data in an over imposed pop-up window when you mouse-over a heatmap. The following figure illustrates mouse-over functionality in a heatmap object. In this example, when you mouse-over a host, details are shown such as CI Count, Alert Impact, Alert Severity, and Criticality.


Tables

RTView EM tables organize CIs (according to the Service Data Model) into columns and rows of data. EM tables contain the same data that is shown in the heatmap in the same view. Tables provide you a text and numeric view of the data shown in that heatmap, and additional data not included the heatmap.

Table rows also sometimes use color to indicate the current most critical alert state for all CIs associated with a given row. For example, the figure above illustrates a table in which each row is a different Service. The color coding is as follows:

  One or more alerts exceeded their critical threshold for one or more CIs associated with the Service.
  One or more alerts exceeded their warning threshold for one or more CIs associated with the Service.

The CI Count column indicates that one or more CIs are associated with each Service. The first row in the table is the OC-CLUSTER Service. The CI Count column indicates the Service has four CIs. The yellow row color indicates that one or more alerts exceeded their warning threshold for one or more CIs associated with the Service.

Continuing with the above example, the second row in the table is the TRANSACTION Service. The CI Count column indicates the Service has one CI. The red row color indicates that one or more alerts exceeded their critical threshold for one or more CIs associated with the Service (in this case there is a single CI).

Sorting

RTView EM allows you to sort the rows of a table for any defined columns. To do so, you click on the column title. A symbol appears when sorting in ascending order, and the inverted symbol when sorting in descending order.

The following figure illustrates the usage of the button to sort table columns. In this example, the Severity Level column is sorted in descending order (from high to low values).


Trend Graphs

RTView EM trend graphs enable you to view and compare various important metrics over time, such as server memory utilization, server throughput, the number of clients being served by the server, or the total amount of data sent to clients. You can use trend graphs to assess utilization and performance trends.

For example, the following figure illustrates a typical EM trend graph. In this example, metrics for Pending Messages, Incoming Messages and Outgoing Messages are traced.

You can set the time range for the trend graph. Click the  button to open the calendar dialog. By default, the time range end point is the current time. Change the time range end point by clicking the  button and selecting the date and time, then click OK. Or enter the date and time in the text field using the following format: MMM dd, YYYY HH:MM:ss. For example, Apr 26, 2012 5:01 PM. Click Apply. The navigation arrows  appear. Use the navigation arrows  to move forward or backward one time period (the time period selected from the Time Range drop-down menu). Click Restore to Now to reset the time range end point to the current time.

Mouse-over

The mouse-over functionality provides additional detailed data in an over imposed pop-up window when you mouse-over trend graphs. The above figure illustrates mouse-over functionality. In this example, when you mouse-over a single dot, or data point, in the Out Msgs / sec trend graph, a pop-up window shows data for that data point. In this case, the X-axis value is 13:15:29 hours on September 6th, and the Y-axis value is 22 Outbound messages per second.

Log Scale

Typically, trend graphs provide the Log Scale option. Log Scale enables you to see usage correlations for data with a wide range of values. For example, if a minority of your data is on a scale of tens, and a majority of your data is on a scale of thousands, the minority of your data is typically not visible in non-log scale graphs. Log Scale makes data on both scales visible by applying logarithmic values rather than actual values to the data.

 


Monitor GUI

This section describes EM GUI organization and functionality that is shared by all RTView EM displays. This section includes:

  • Navigation Tree: Describes navigation tree organization which is shared by all EM displays.

  • Title Bar Functionality: Describes the functionality of the title bar top layer that is shared by all EM displays.

Navigation Tree

The navigation tree (in the left display panel) is organized by views and shared by all EM displays. Each View contains a different scope of data and different drop-down menus for organizing or filtering data. You can install additional Solution Packages which are subsequently situated in the navigation tree between Component Views and RTView Servers displays. This section describes the views that come with EM.

All Management Areas: Organized by Owner, these displays show the health of your entire system using aggregated data from all Areas. Use these displays to be quickly identify critical conditions across all Areas in your system, then drill-down to investigate in lower-level displays. These displays drill-down to the next level: Multi Area Service Views displays.

Multi Area Service Views: Organized by Area, these displays show the health of Services for one or more Groups. Use these displays to be identify critical conditions across all Areas or a single Area. Drill-down to investigate in lower-level displays. These displays drill-down to the Service Summary Views displays.

Single Area Service Views: Organized by Group, these displays show the health of the Services for a single Area and a single Owner. Use these displays to identify critical conditions on a single Service. These displays drill-down to the Service Summary Views displays.

Service Summary Views: Organized by Service, these displays show the health of CI Types. Use these displays for a closer view of a critical condition, including alert details.

Component Views: The displays in this section present all CI details and drill-down to displays that are relevant to the CI Type.

RTView Servers: The displays in this section enable you to view performance metrics gathered by RTView, and monitor all RTView Servers.

Alert Views: The display in this section lists all alerts in the system and allows you to track, manage and assign alerts.

Administration: The displays in this section enable you to set alert thresholds, observe how alerts are managed, and modify your Service Data Model.

Architecture: The displays in this section provide a topological view of your RTView EM system as well as performance metrics for your EM Cache Tables and Data Servers.


Title Bar Functionality

RTView EM displays share the same top layer in the title bar, described below.

Previous Display: Opens the previous display.
     
Up One Level: Opens the first display in the upper level.
     
Convenience Navigation: These buttons are for convenient navigation to displays that are most commonly accessed from the current display. These buttons differ from display to display.
     
View Drop-down Menu: Drop-down menus are also for convenient navigation to displays that are most commonly accessed from the current display.
     
  Connection Indicators: Date, Time and Data OK are the Connection Indicators.  When the Date, Time field is correct and the Data OK indicator is green, this is a strong indication that the Platform is receiving current and valid data.
Open Alerts Table Opens the Alerts Table display in a new window.
       
  Date, Time: The current date and time. If the time is incorrect, this might indicate that RTView stopped running.
  Data OK: The data connection state. Red indicates the data source is disconnected (for example, if the Data Server is not receiving data, or if the Display Server does not receive data from the Data Server, this will be red). Green indicates the data source is connected.
     
Open New Window Open one or more instance of the same display. Each window operates independently, allowing you to switch views, navigate to other displays in RTView EM, and compare server performance data. For illustration, see Multiple Windows.
     
Help Links to online help page for the current display.

Multiple Windows

The following illustrates the usage of the button to open multiple windows.

 

 

 
 
 
SL, SL-GMS, GMS, RTView, SL Corporation, and the SL logo are trademarks or registered trademarks of Sherrill-Lubinski Corporation in the United States and other countries. Copyright © 1998-2013 Sherrill-Lubinski Corporation. All Rights Reserved.
 
 
 

JMS, JMX and Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. They are mentioned in this document for identification purposes only.

 
 
 

Third Party Notice Requirements