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:
Step 3
Enter the following CLI command to enable all report types:
To see a list of all report-related CLI commands, enter the following command:
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
|