Cisco Prime Performance Manager User Guide, 1.0
Managing Reports

Table Of Contents

Managing Reports

Viewing Report Status Table

Viewing Network Level Reports

Viewing Node Level Reports

Enabling Reports Using the CLI

Viewing Reports

Viewing Details Tab

Enabling and Disabling Reports

Viewing Graph Series Editor Details


Managing Reports


At scheduled intervals, you can configure the Cisco Prime Performance Manager to gather critical information from network objects that it detects.

Prime Performance Manager uses this information to calculate statistics, such as ethernet statistics, peer flap statistics, performance statistics, device availability and so on. It generates reports based on those statistics.

To view all reports:


Step 1 Select Reports in the Web Navigation tree

Step 2 Click the type of report that you want to view in the web navigation tree. For example, if you want to view current TCP reports, select Reports > Application Traffic > TCP.

All TCP reports appear. See Viewing Reports, page 5-30 for more information.


To view the report for a single node of a specified report type, go to:


Step 1 Click a node in the left pane of the Web Navigation tree

Step 2 Click the type of report you want to view.

Reports for the active nodes appear in the right content pane.

Step 3 Select a node.

The reports for that specific node are displayed. See Viewing Node Level Reports for more information


This chapter contains:

Viewing Report Status Table

Enabling Reports Using the CLI

Viewing Reports

Viewing Report Status Table

The Reports Status Table in the Prime Performance Manager web interface content pane allows you to globally enable and disable reports that are displayed in the left navigation tree.


Note Only reports that run on a regularly scheduled interval are displayed in the Hourly and Daily data. Reports that run continuously are not displayed.


To access the main Reports page:


Step 1 In a web browser, launch the Prime Performance Manager web interface (see Accessing Prime Performance Manager Web Interface, page 5-2).

Step 2 In the navigation tree, click Reports.

The Reports Status Table in the content area displays the Report Type and the status (enabled or disabled).

Step 3 Select the report that you wish to disable and click Save.

The reports in the left navigation tree refreshes to display the status of the report disabled.

To enable a report in Prime Performance Manager Web interface, click the check box in the Status column.


Related Topic

Viewing Network Level Reports

Viewing Node Level Reports

Viewing Network Level Reports

The Network Level Reports display a summary of the top level graph view summary that is available for a particular report, in the left navigation pane. At Network Level, Table/CSV/Graph views are available to all devices in the network. To view a Network Level Report, select Reports > Availability > Interfaces.

The right content pane displays the network level graph view summary of nodes available.

To view the different types of reports in the right content pane, click the Reports drop-down arrow and select the reports you want to view.

Related Topics

Viewing Graph Series Editor Details

Toolbar Buttons, page 5-15

Viewing Node Level Reports

The Node Level Reports display details on reports that are available for a particular node. If you select a node from the top level graph view summary in the right content pane (see Viewing Network Level Reports for details) it displays the reports detail for that node with the node name in the left navigation pane.

See Managing Reports for more information.

After you select a node, the Report Status tab appears. This tab displays the nodes that are specific to that node. See Viewing Report Status Table for more information

Related Topics

Viewing Details Tab

Displaying Active Alarms and Event History, page 5-11

Toolbar Buttons, page 5-15

Enabling Reports Using the CLI

Using CLI commands, you can generate reports that can be run at specified intervals. You can enable and disable automatic generation of these reports, using the ppm statreps commands (see ppm statreps, page A-53).

After you enable generation of a report, it will run at the specified intervals until you disable it with the appropriate CLI command.

Enabling reports using the CLI, is the same as enabling and disabling reports from the Reports page. To enable or disable report aging settings, select Report in the left navigation pane and enter the aging value in the Aging Settings.

The database report aging occurs once every day before the backup starts. It is triggered by the cron job ppmCron.sh backup

To enable reports using the CLI:


Step 1 Log in as the root user.

Step 2 Enter:

cd /opt/CSCOppm-gw/bin

Step 3 Enter the following CLI command to enable all report types:

./ppm statreps all

To see a list of all report-related CLI commands, enter the following command:

./ppm rephelp


Viewing Reports

After you generate reports, you can view them using the Prime Performance Manager web interface. You can view historical reports for all objects of a specific type. For example, all link reports for all links.

You can also view reports for a specific object. For example, all link reports for a specific link.

For the reports whose output type is Graph, the Graph Series Editor window is displayed when you click the Custom series icon. See Viewing Graph Series Editor Details for details.

For these reports, you can use the Sort Parameter option to select the criteria to include a top set of series. You can also use this option to sort the graphs that are displayed.

You can access reports in the Prime Performance Manager web interface through these categories. See Table 7-1 for more details.

Table 7-1 Reports 

Category
Report Type
Related Content

Reports > Application Traffic

AAA

AAA Reports

SNMP

SNMP Reports

TCP

TCP Reports

UDP

UDP Reports

Reports > Availability

Interfaces

Interface Reports

MPLS Networks

MPLS Networks Reports

PseudoWires

PseudoWires Reports

SNMP Ping

SNMP Ping Reports

Reports >IP Protocols

BGP

CAR Reports

ICMP

Class Map Reports

OSPF

EVC Reports

Reports >IP QoS

CAR

BGP Reports

Class Map

ICMP Reports

EVC

OSPF Reports

Reports > IP SLA

Ethernet OAM

Ethernet OAM Reports

ICMP Jitter

ICMP Jitter Reports

RoundTrip Time

RoundTrip Time Reports

UDP Jitter

UDP Jitter Reports

Reports > Resources

Buffers

Buffers Reports

CPU

CPU Reports

Memory

Memory Reports

Reports > Transport Statistics

ATM Interface

ATM Interface Reports

ATM PVC

ATM PVC Reports

EVC Interface

EVC Interface Reports

Ethernet Errors

Ethernet Errors Reports

Interface

Interface Reports

Reports > Transport Statistics > MPLS

In Segment

In Segment Reports

LDP

LDP Reports

MPLS Interface

MPLS Interface Reports

TE Tunnel

TE Tunnel Reports

Out Segment

Out Segment Reports

Reports > Transport Statistics

Pseudowire

Pseudowire Reports

Reports > Transport Statistics

ATM Interface

ATM Interface Reports



Note Prime Performance Manager reports are based on the MIBs supported on the devices. Refer MIBs, page D-1 for MIBs supported in Prime Performance Manager.


Yo can view a Web report either for all objects of a specified type or for a single object of a specified type.

To view a Web report for all objects of a specified type:


Step 1 Select Reports in the Prime Performance Manager web navigation tree and click the type of report you want to view

For example, if you want to view hourly TCP Segments report, select Reports > Application Traffic > TCP> TCP Segments > 15 Minutes/Hourly/Daily.

All link reports appear.

Step 2 Click the Reports drop-down arrow and navigate to the type of report you need. (You need to select the various drop-down menus)

Step 3 Select Duration from the drop-down lists. For example, if you wanted to view hourly link reports for the last 12 hours, choose Last 12 Hours from the Duration drop-down.

For most Statistics and Accounting reports, to customize the date, time range, or both, click the Customize the date and time range icon. Note that these dates are the dates with server time zone.

Step 4 Click the Output Mode drop-down to view the corresponding report in Graph / Table / CSV mode.

CSV reports for all nodes are generated in /opt/CSCOppm-gw/reports and prefixed with the report type for additional context.

For example, B20110308.0945-0500-20110308.1000-0500_ppm-xxx-vm38.csv report is prefixed with CPU.B20110308.0945-0500-20110308.1000-0500_ppm-xxx-vm38.csv.

Step 5 Click the green arrow to run the report


To view a Web report for a single object of a specified type:


Step 1 Click a node in the Web navigation tree to select an object in a node.

Step 2 In the content area in the right pane, click the Reports tab.

Reports appear for the active object only.

Step 3 Click the Reports drop-down arrow and navigate to the type of report you need. (You need to select the various drop-down menus)

Step 4 Select Duration from the drop-down lists. For example, if you wanted to view hourly link reports for the last 12 hours, choose Last 12 Hours from the Duration drop-down.

For most Statistics and Accounting reports, to customize the date, time range, or both click the Customize the date and time range icon. Note that these dates are the dates with server time zone.

Step 5 Click the Output Mode drop-down to view the corresponding report in Graph / Table / CSV mode.

CSV reports for all nodes are generated in /opt/CSCOppm-gw/reports and prefixed with the report type for additional context.

For example, B20110308.0945-0500-20110308.1000-0500_ppm-xxx-yy38.csv report is prefixed with CPU.B20110308.0945-0500-20110308.1000-0500_ppm-xxx-yy38.csv. All the CSV reports are available only after they are compressed in .zip format.

Step 6 Click the green arrow to run the report



Tip For details on web toolbars and icons, see Using the Toolbar, page 5-5.


Related Topics

Viewing Node Level Reports

Viewing Graph Series Editor Details

Enabling and Disabling Reports

Enabling Reports Using the CLI

Viewing Details Tab

The Details tab displays information such as naming and status details for the chosen Node and Gateway/Units.

To view the Details tab details of a selected node from the report menu:


Step 1 Select a report in the left navigation tree.

Step 2 Select an object from the reports and then click on a node from the top level graph view summary in the right content pane.

Step 3 The Reports, Details, Events, Alarms and Report Status tab display. See Table 7-2 for more details.


Table 7-2 Details Tab 

Section
Field
Description

Naming Information

Display Name

Name of the Node.

Custom Name

Custom name of the node. The custom name appears if you have defined it. If this name is not defined, this field displays, Unknown.

IP Address or Host Name

IP address or DNS name of the node, as discovered by Prime Performance Manager.

SysName

Name set on the router and returned, using the SNMP variable sysName.

Node Type

Type of the node.

Serial Number

Serial number of the node

Location

Physical location of this node. If the location details are not available for the node, this field displays Unknown.

Unit

Name of the Unit to which the node belongs.

Status Information

Is Ignored

Indicates whether the node is Ignored (that is, whether to include the node when aggregating and displaying Prime Performance Manager status information).

Alarm Severity

Indicates the alarm severity of the object.

Status

Current status of the node. Possible values are:

Active

Discovering

Polling

Unknown

Unmanaged

Waiting

Warning

Last Status Change

Date and time when the status of the node was last changed.

Status Reason

Status reasons are listed in order of decreasing magnitude. If two or more reasons apply, the reason of greatest magnitude appears.

Polling Information

Report Polling

Indicates whether report polling is enabled for this node.

First Discovered

Date and time that the Prime Performance Manager first discovered the node.

Last Poll IP Address

Last IP address that was polled for this node.

Last Full Poll Time

Date and time of the last full poll of the node for node-related MIBs

Last Poll Response (secs)

Time, in seconds, taken by this node to respond to the last poll request.

Avg. Poll Response (secs)

Average time, in seconds, taken by this node to respond to Prime Performance Manager poll requests.

Descriptive Information

Contact

Textual identification of the contact person for the managed node, along with the information on how to contact this person.

If the contact details are not available for the node, this field displays Unknown.

Software Version

Version of software (for example, the ONS package or IOS version) that is installed on the node.

Software Description

Comprehensive information about the software that is installed on the node.

Uptime Information

Uptime

Time the node is up, in days, hours, minutes, and seconds.

Reboot Reason

Reason for the last reboot of the node.

IP Address

IP Address

IP addresses associated with this node, including the primary SNMP address and all backup IP addresses, that are intended for SNMP.

Last Regular Poll Time

Date and time of the last full poll of the node. If the IP address has never been polled, Prime Performance Manager displays, Never Polled.

SNMP Pollable

Whether the IP address is used for SNMP polling.


To view the Details tab of a gateway:


Step 1 Select the Gateway/Units from the Summary List in the navigation tree.

Step 2 Select a Gateway from the Gateway/Units table in the right content pane.

The Details, Events and Alarms tab appear. The information in the Details tab is the same as in Table 7-2, but is limited.


To view the Details tab of a unit:


Step 1 Select the Gateway/Units from the Summary List in the navigation tree.

Step 2 Select a Unit from the Gateway/Units table in the right content pane.

The Details, Events, Alarms and Nodes for Unit tab appear. The information in the Details tab is the same as in Table 7-2, but is limited.


Enabling and Disabling Reports

To enable/disable specific reports, select the Setting tab (see Viewing Historical Statistics Report Settings, page 5-31) in the Reports page. All reports (5 Minute, 15 Minute, Hourly Report, Daily Report) can be enabled or disabled. By default, all the reports are run every15 minutes, hourly and daily.

You can see the node appearing at the bottom on the left navigation tree, after a specific node is selected from the right pane.

To enable a 5-minute report, you should edit the corresponding XML definition of the report.


Note Only a System Administrator has the permission to enable a 5-minute report. The SNMP polling interval for the devices that requires a 5-minute report, are set by System Administrator.


The XML report definition are located on the Gateway in the /opt/CSCOppm-gw/etc/pollers/system or /opt/CSCOppm-gw/etc/pollers/user directories. An System Administrator access is required to edit the report definitions.

Enabling a 5-minute report increases disk space utilization required for the Units and decreases the performance of the Units because of the increase in disk activity.

Viewing Graph Series Editor Details

The Graph Series Editor window allows you to show or hide a selected data series.This window appears if you select the report output as Graph. Most network-level reports contain the top 10 series of data.

See Table 7-3 for more details.

Table 7-3 Graph Series Editor 

Column or Buttons
Descriptions

Selected Series

Displays the domain name IDs for the data that is used to create the report.

Available Series

Displays the list of available objects for this report.

If there are many objects in the report, the objects in the Available Series column span multiple pages and all objects are not shown on one page.

See Using the Toolbar, page 5-5 for more information on using the paging features. To view all selected objects, sort the table by the Display column.

Display

Depending on the report type you select, other columns displayed will differ.

Column of check boxes that allow you to display (by checking) or hide (by unchecking) the data series associated with the chosen backhaul.

The Prime Performance Manager displays only 10 series, by default.

Clear Selection

Deselects the selected list of series and the OK button is grayed out. This is a simple way to deselect all the display check boxes.

OK

Applies the selections you made. If you deselect all items in the dialog box, the OK and Clear Selection buttons are grayed out.

Cancel

Cancels your selections and closes the Graph Series Editor window.

Help

Opens the Help for the Graph Series Editor window