Cisco Active Network Abstraction Administrator Guide, 3.6.2
System Health Diagnostics
Download this chapter
System Health DiagnosticsSystem Health Diagnostics
Download the complete book
PDF of Cisco Active Network Abstraction Administrator Guide, 3.6.2PDF of Cisco Active Network Abstraction Administrator Guide, 3.6.2 (PDF - 3 MB)
give_us_feedback

Table Of Contents

System Health and Diagnostics

Introduction

Getting Started

Toolbar

Graphs

Graph Types

Web Page Options

MC Loads Page

MC [server ip] Load Page

Invoking Additional Parameters

Use Cases

Use Case 1

Use Case 2


System Health and Diagnostics

This chapter describes how to work with the system health and diagnostics tool, and the various aspects of the Cisco ANA system that can be monitored.

•Introduction

•Getting Started

•Invoking Additional Parameters

•Use Cases

Introduction

The system health and diagnostics tool provides the user with system resource utilization information for the gateway and units (physical, allocated and used). It monitors various aspects of the Cisco ANA system, for example, the size of the Java heap and AVM CPU usage and enables the user to ensure that the gateway, units and AVMs are functioning correctly.

Getting Started

This section provides instructions for accessing the tool. The tool is password protected to ensure security. Before you start working with the tool make sure you have your user name, password and the Cisco ANA Gateway IP address or host name that you require.

Note The connection to the tool is via the https protocol and authentication method.

To access the tool:

Step 1 Enter the following URL in your browser:

https://[Gateway IP]:1311/graphs

Step 2 Replace [Gateway IP] in the URL with the required Gateway IP. A security alert is displayed regarding the site certificate.

Step 3 Click Yes to proceed.

Step 4 You are prompted to enter your user name and password.

Note These were defined during the system installation as User name and Password for the web monitoring tool. The User name is not the same as the one used in Cisco ANA's applications.

Note To change the user name and password, login to the gateway as user "sheer" and run the following command:
$SHEERHOME/utils/apache/bin/htpasswd -cb $SHEERHOME/Main/webroot/.passwd <new username> <new password>

The MC Loads page (Units monitoring page) is displayed. The MC Loads page displays a combined graph of the loads for the gateway and units in a graphical representation.

The MC Loads page (Units monitoring page) is displayed below.

Figure 12-1 MC Loads Page

1

Details

2

Toolbar

3

Web page options

4

IP Hyperlink

5

Unit(s) row

6

Gateway row

7

Graph types in columns


The web pages that are displayed in the tool may have the following components:

•Details of the IP address of the gateway or unit and the current date and time are displayed.

•Toolbar.

•Web page options.

•IP hyperlink. Clicking on the IP hyperlink of a gateway or unit displays the AVMs for the selected gateway or unit.

•Table of graphs where each row across horizontally represents a gateway or a unit, and each column represents a different graph type.

Toolbar

The toolbar enables you to adjust the graph period and columns that are displayed.

Figure 12-2 Toolbar

The following dropdown lists are available in the toolbar:

•Period—Enables you to set the period of time for the graphs in the page.

•Add/Remove column—Enables you to add and/or remove graph types from the page.

Step 1 Select an option from the Period dropdown list.

Step 2 Select an option from the Remove column dropdown list.

Step 3 Click Submit. The changes are implemented.

Graphs

A table of graphs is displayed on the web pages where each row horizontally across represents a gateway or a unit. Each column matches one of the graph types described in Graph Types. Clicking on a graph for a gateway, unit or AVM opens the individual graph of the selected item in a separate page.

Each graph displays the IP and the name of the graph. For more information about graph types see Graph Types. In addition, a key is displayed at the bottom of the graph.

There are two colored vertical lines (indicators) that may be displayed in the graphs:

•An out of memory indicator (a red vertical line) is displayed on the Java heap graph when an AVM runs out of memory. This is displayed in the combined and individual AVM graphs.

•A restart indicator (a green vertical line) is displayed in the AVM graph of the specific individual AVM that was restarted, as well as in the combined graph, when a Cisco ANA unit is restarted.

Figure 12-3 Out of Memory and Restart Indicators

The horizontal lines displayed in the graphs show the maximum and minimum values for a period of time.

The graph history is maintained for a period of 28 days. The data history is maintained as follows:

•Data of every 15 seconds is saved for a period of 3 hours

•All data from 3 hours to 24 hours is diluted to a sampling rate of 300 seconds.

•All data from 24 hours to 7 days is diluted to a sampling rate of 15 minutes.

•All data from 7 days to 28 days is diluted to a sampling rate of 2 hours.

Graph Types

The following types of graphs are available in the tool:

•Java Heap—The sizes of the Java heaps in the AVMs processes.

•Process Size—The AVMs memory process sizes.

•CPU %—The AVMs CPU usage.

•GC Time—The AVMs Java Garbage Collector (GC) activity.

•Dropped Messages—The number of message drops in the Cisco ANA Transport messaging Mechanism. This may happen when the system is under a heavy load.

•Logged Lines—The number of lines written to the AVM logs.

•CPU Total—The Cisco ANA Units operation system CPU metrics.

Web Page Options

You can view the following web pages:

•MC Loads Page—Displays a combined graph of the loads for the gateways and units in a graphical representation.

•MC [server ip] Load Page—Displays the combined and individual AVM graphs.

The following options should not be used:

•Transport Counters Page

•Status

The web page options that are displayed on a page depend on the web page on which you are located.

MC Loads Page

Each row in the table corresponds to a Cisco ANA Unit or gateway, and each column matches one of the graph types described in Graph Types. The MC Loads page displays the combined unit and gateway graphs, where each graph stacks the readings from all the AVMs in the unit graphs.

Clicking on the hyperlink of the unit or gateway opens the MC [server ip] Load page. For more information see MC [server ip] Load Page.

MC [server ip] Load Page

The first row in the table of the MC [server ip] Load page displays the combined AVMs graph, and every row thereafter represents an individual AVM's graphs for the unit. Each graph stacks the readings for the AVM.

Figure 12-4 MC [server ip] Load Page

Invoking Additional Parameters

When a single graph page is opened, additional parameters can be invoked on the graph through the browser URL field, in an HTTP GET format:

•period—The period of the graph, in hours/minutes/days/weeks. Using the letters h/m/d/w to stand for hours/minutes/days/weeks respectively.

•end—The starting time of the graph, using the same time format as in "period".

For example, to generate a graph from two days ago for a period of four hours:

https://10.56.56.26:1311/graphs/graph.cgi?type=heap&mcip=127.0.0.1&period=4h&end=-2d

•refresh—Refreshes the graph page periodically. The period is defined in seconds. The minimum period should be 20 as the Cisco ANA graph data is collected every 20 seconds.

In the following example the page is refreshed every 20 seconds:

https://10.56.56.94:1311/graphs/graph.cgi?type=heap&mcip=127.0.0.1&refresh=20

•width—The width of the graph in pixels.

•height—The height of the graph in pixels.

In the following example the graph is drawn with a width of 800 pixels and height of 600 pixels:

https://10.56.56.94:1311/graphs/graph.cgi?type=heap&mcip=127.0.0.1&width=800&height=600

Use Cases

This section provides a few use case examples for the system health and diagnostics tool.

Use Case 1

In a case where the unit's CPU graph shows high CPU consumption and the GC Time graph is high as well, it may be that one of the AVMs doesn't have enough memory (CPU loaded with Java Garbage Collector tasks). When the Java Garbage Collector is reduced, the CPU consumption returns to normal.

Use Case 2

For memory consumption, it is recommended that 30% of the AVM memory is free (in a steady state). The graphs provide you with a visual way to check this rate.

Check the unit's Java Heap graph. The upper horizontal line displays the configured memory size for the AVM. The graph shows the real memory usage of the selected AVM.

For example, in the Java Heap graph below there is only 20% free memory:

•Configured memory - 250 Mb

•Used memory - 200 Mb

•Free Memory - 50 Mb (250-200)

Figure 12-5 Use Case 2