Cisco Prime Nerk 43 User Guide

							CH A P T E R
  
5-1
Cisco Prime Network 4.3.2 User Guide
5
Setting Up Native Reports 
Prime Network provides two reporting functions. The native reports feature is launched from the Reports 
menu in the Vision client, Events client, or Administration client; this reporting tool is described in the 
following topics. The Operations Reports feature is an optional application and is described in Cisco 
Prime Network 4.3.2 Operations Reports User Guide. 
These topics describe how to set up the native reports feature:
Workflow for Setting Up Regular Reports, page 5-1
Checking Global Settings for Report Operations, page 5-2
Setting Up Your Report Folders, page 5-2
Inventory Hardware and Software Reports, page 5-7
Network Service Reports, page 5-9
Creating Your Customized Report, page 5-10
Entering Report Criteria and Testing Your Report, page 5-10
Scheduling a Recurring Report, page 5-12
Sending a Report Through E-mail Notification, page 5-12
Whether you can perform these setup tasks depends on your account privileges. See Permissions 
Required to Perform Tasks Using the Prime Network Clients for more information.
Workflow for Setting Up Regular Reports
This workflow shows the steps required to set up regular, scheduled reports. If you simply want to run 
an existing predefined report, see:
Inventory Hardware and Software Reports, page 5-7
Network Service Reports, page 5-9
The following table provides the basic workflow for setting up scheduled reports.
Description See:
Step 1If necessary, adjust the global settings that affect reports (for 
example, whether users can create shared reports which 
others can view).Checking Global Settings for Report 
Operations, page 5-2
Step 2Set up your report folder structure in Report Manager.Setting Up Your Report Folders, 
page 5-2 
						

							  
5-2
Cisco Prime Network 4.3.2 User Guide
Chapter 5      Setting Up Native Reports
  Checking Global Settings for Report Operations
Checking Global Settings for Report Operations
The following default report behavior is controlled from the Administration client and will affect report 
users:
The report actions users can perform, and the devices users can view and manage. When a user 
account is created the administrator assigns a user access level to the user account (Viewer, Operator, 
Operator Plus, Configurator, or Administrator).
–The user access level controls which reports a user can generate.
–The device scope determines which devices a user has permission to access, and which devices 
they can run reports against.
For a matrix of actions users can perform depending on their user access level and device scope 
assignments, see Permissions Required to Perform Tasks Using the Prime Network Clients.
Whether users can create public (shared) reports. By default, users cannot create shared reports.
Users with Administrator privileges can change these settings. They can also configure Prime Network 
to generate a warning message whenever a user executes a command script. For more information, see 
the Cisco Prime Network 4.3.2 Administrator Guide. 
Setting Up Your Report Folders
Create nested folders to organize your reports under the existing Report Manager categories: Events 
Reports, Inventory Reports, and Network Service Reports. You can then place your customized reports 
under these folders (by specifying the Location field when you create the report).
Step 1Choose Reports > Report Manager from the Prime Network client main menu.
Step 2In Report Manager, choose Events Reports > New Folder.
Step 3Choose the report you want to customize:
Event reports—Tickets, Service events, Syslogs, and 
Traps; Audit, Provisioning, System and Security events; 
database-related informationEvent Reports, page 5-3
Hardware and software reportsInventory Hardware and Software 
Reports, page 5-7
Ethernet service, network pseudowire, VPLS/H-VPLS 
reportsNetwork Service Reports, page 5-9
Step 4Create a customized report based on any of the predefined 
reports that are packaged with Prime Network.Creating Your Customized Report, 
page 5-10
Step 5Test your customized report.Entering Report Criteria and Testing 
Your Report, page 5-10
Step 6Schedule your recurring report.Entering Report Criteria and Testing 
Your Report, page 5-10 Description See: 
						

							  
5-3
Cisco Prime Network 4.3.2 User Guide
Chapter 5      Setting Up Native Reports
  Event Reports
Step 3In the New Folder dialog, enter a folder name. The new folder appears under the Events Reports.
You can also move folders and reports to new locations from the Report Manager.
Event Reports
These event reports can be run from the Vision client, Events client, or Administration client:
Generalized Network Event Reports (Tickets, Service Events, Traps, Syslogs), page 5-3
Ticket Event Reports, page 5-4
Service Event Reports, page 5-4
Syslog-Specific Event Reports, page 5-5
Trap-Specific Event Reports, page 5-5
Database-Related Event Reports, page 5-6
Audit, Provisioning, System, Security Event Reports (Non-Network Reports), page 5-7
Generalized Network Event Reports (Tickets, Service Events, Traps, Syslogs)
To get this network event information: Use this report:Can you choose 
devices?Can you specify a 
time period?
Devices with most severe events
(Pie chart shows device percentages)Events Reports > 
Devices with the Most 
Events (By Severity)Ye s Ye s
Devices with most frequent events
Pie chart shows device percentagesEvents Reports > 
Devices with the Most 
Events (By Type)Ye s Ye s
Devices with most syslogs
Devices with most traps
Devices with most Service events
(up to 1,000 devices):Detailed Event Count 
(By Device)Ye s Ye s 
						

							  
5-4
Cisco Prime Network 4.3.2 User Guide
Chapter 5      Setting Up Native Reports
  Event Reports
Ticket Event Reports
Service Event Reports
To get this ticket information: Use this report:Can you choose 
devices?Can you specify 
a time period?
Most common tickets for all managed devices
Pie chart shows type percentagesEvents Reports > Most 
Common Daily EventsNo; all devices 
chosen by defaultYe s
Details about tickets by their severity:
Alarm cause and the root event time
Affected devices
Whether ticket was acknowledged
Other event details: Duplication count, reduction 
count, alarm count, last modification, etc.Detailed Tickets Yes Yes
Ticket details for specific devices (up to 1,000 devices): 
Number of tickets per severity
Number of tickets per ticket typeDetailed Event Count 
(By Device)Ye s T B D
Tickets with highest number of associated events with 
details such as:
Root cause
Ticket creation timeEvents Reports > Event 
Reduction StatisticsYe s Ye s
Ticket MTTR
1 (mean time to repair information):
Number of tickets cleared manually
Number of tickets cleared automatically (by system)
MTTR
Ticket root cause and creation time
1. MTTR is based on time of ticket creations, and time the ticket was last modified. (Acknowledging a cleared ticket can therefore affect the MTTR for the 
ticket.)
Events Reports > Mean 
Time to RepairNo; all devices 
chosen by defaultYe s
To get this network event information: Use this report:Can you choose 
devices?Can you specify a 
time period?
Most common Service events, tickets, syslogs, traps
Pie chart shows type percentagesEvents Reports > Most 
Common Daily EventsAll chosen by 
defaultYe s
Most severe Service events with details Detailed Service Events Yes Yes 
						

							  
5-5
Cisco Prime Network 4.3.2 User Guide
Chapter 5      Setting Up Native Reports
  Event Reports
Syslog-Specific Event Reports
Trap-Specific Event Reports
To get this Syslog information: Use this report:Can you choose 
devices?Can you specify 
time period?
Most common syslogs, and how many of each type?
Pie chart shows type percentagesEvents Reports > Most 
Common SyslogsNo; all devices 
chosen by 
defaultYe s
Devices with most syslogs
NoteThis report can also be generated from generic 
(non-actionable) events.
Pie chart shows device percentagesEvents Reports > Devices 
with the Most SyslogsNo; all devices 
chosen by 
defaultYe s
Time frame when most syslogs occurred Events Reports > Daily 
Average and PeakNo; all devices 
chosen by 
defaultYe s
Syslog details (up to 250,000):
IP address time, description
Syslog raw data (generic events) or description 
(actionable events)
NoteThis report can also be generated from generic 
(non-actionable) events.Detailed Syslogs Yes No
For specific syslogs, their count and first and last time they 
occurred
Pie chart show s syslog percentagesEvents Reports > Syslog 
CountNo; all devices 
chosen by 
defaultYe s
For specific syslogs, the devices they occurred on
Pie chart show s syslog percentagesEvents Reports > Syslog 
Count (By Device)Ye s Ye s
For specific syslogs and specific devices, a graph of syslogs 
with their priorityEvents Reports > Syslog 
Trend (By Severity)Ye s Ye s
To get this trap information: Use this report:Can you choose 
devices?Can you specify 
a time period?
Most common traps for all managed devices
Pie chart shows type percentagesEvents Reports > 
Most Common 
Daily EventsYes No; all devices 
chosen by 
default
Time frame when most traps occurred Events Reports > 
Daily Average and 
PeakYes No; all devices 
chosen by 
default 
						

							  
5-6
Cisco Prime Network 4.3.2 User Guide
Chapter 5      Setting Up Native Reports
  Event Reports
Database-Related Event Reports
Traps generated by specific devices:
Number of traps per severity
Number of traps per ticket type
NoteThis report can also be generated from generic 
(non-actionable) events.
Pie chart shows device percentagesEvents Reports > 
Devices with the 
Most TrapsYe s Ye s
Trap details for specific devices:
IP address, time, description (long description if report is 
generated from actionable events)
SNMP and trap version
Generic or device-specific trap OID, if the event is generic
The maximum number of traps retrieved for this report depends on 
whether the Long Description check box is selected. When checked, 
a maximum of 30,000 traps are retrieved. When this check box is not 
checked, a maximum of 100,000 traps are retrieved for this report.
NoteThis report can also be generated from generic 
(non-actionable) events.Detailed Traps No Yes
For this database-related information: Use this report:Can you choose 
devices? Can you specify 
time period?
For specific period, the number of active tickets, alarms, 
and events stored in DB
Tickets with most number of events
Events-per-second rateEvents Reports > Database 
MonitoringN/A Yes
For specific period, the number of generated tickets with 
these details:
Ticket type and count
Root cause and ticket creation time
Number of correlated events per ticket (largest, 
smallest, average)Events Reports > Event 
Reduction StatisticsYe s Ye s
For a specific period, total number of actionable and 
generic events added to the Oracle database by type 
(Syslogs, Traps, Tickets, correlated/uncorrelated events, 
network/non-network events)Events Reports > Fault DB 
vs. Event Archive StatisticsN/A Yes To get this trap information: Use this report:Can you choose 
devices?Can you specify 
a time period? 
						

							  
5-7
Cisco Prime Network 4.3.2 User Guide
Chapter 5      Setting Up Native Reports
  Inventory Hardware and Software Reports
Audit, Provisioning, System, Security Event Reports (Non-Network Reports)
Inventory Hardware and Software Reports
For all inventory reports, Prime Network retrieves the inventory information from the network element. 
These inventory reports can be run from the Vision client, Events client, or Administration client:
Hardware Reports, page 5-8
Software Reports, page 5-8 For this non-network event information: Use this report:Can you 
choose 
devices? Can you 
specify a 
time period?
Audit event details:
Severity, timestamp, description
Username, originating IP address
Command details: name, parameters, signatureDetailed Audit Events No Yes
Provisioning event details
Severity, timestamp, description, username
StatusDetailed Provisioning 
EventsNo Yes
Security event details:
Severity, timestamp, description, location
Username, originating IP addressDetailed Security Events No Yes
System event details:
Severity, timestamp, description, locationDetailed System Events No Yes 
						

							  
5-8
Cisco Prime Network 4.3.2 User Guide
Chapter 5      Setting Up Native Reports
  Inventory Hardware and Software Reports
Hardware Reports
Software Reports
Hardware inventory information: Type of report:Can you choose 
devices?
Hardware details (you can filter this report using a string from the device, chassis, 
module, or port name):
Chassis—Description and serial number; shelf description, serial number, and 
status
NoteWhen the last Virtualized Services Module (VSM) blade is removed from 
the chassis, a notification stating that the data center has been removed is 
sent by the Prime Network. When this notification is received and 
transformed by Prime Network Integration Layer to the Operations 
Support Systems (OSS) client, the client is expected to delete all objects 
(Hosts, VM) under this specific virtual device context (VDC).
Module—Module and sub module name; module status, hardware type, and 
version
Port—Port location, type, and status; port alias, if port is sending alarms, if 
port is managed, PID, pluggable type serial numberHardware Detailed Yes
Hardware details you can optionally group (the report also provides the device 
IP address and serial number):
Device name or system name
Vendor, product, device series, element type, or chassisHardware Summary Yes
Module details (you can filter this report using a string from the module name):
Hardware version and serial number
Software version
IP addressModules Summary 
(By Type)Ye s
Software information: Type of report:Can you choose 
devices?
Software sorted by devices:
Software version and image file name
Device name, type, IP address, and serial numberSoftware Summary 
(By Device)Ye s 
						

							  
5-9
Cisco Prime Network 4.3.2 User Guide
Chapter 5      Setting Up Native Reports
  Network Service Reports
Network Service Reports
The following network service reports can be run from the Vision client, Events client, or Administration 
client. Software sorted by version:
Number of software versions being run
Image file name and number of devices running that imageSoftware Summary 
(By Version)Ye s
Cisco IOS-XR software sorted by devices:
Cisco IOS XR software version 
For each package installed on device:
–Package name and state (active or inactive)
–Storage location
–Module name 
Device name, type, IP address, and serial numberIOS-XR Software 
Package SummaryYe s Software information: Type of report:Can you choose 
devices?
Table 5-1 Standard Network Service Report Types
For this service information:Use this report:
Ethernet service information which you can filter using a service, EVC, or map name:
Ethernet service or Layer 2 VPN name, including the customer label (business tag)
EVC name and customer label
Maps containing the Ethernet service or Layer 2 VPN instanceEthernet Service 
Summary
Ethernet service summary with the following additional details:
Edge EFPs associated with the EVC or Layer 2 VPN
EFT fragment name and typeEthernet Service 
Detailed
Network pseudowire information which you can filter using a pseudowire name, type, or map name:
Pseudowire name and type, including any customer labels (business tags)
Maps containing the pseudowire instanceNetwork 
Pseudowire 
Summary
Network pseudowire summary with the following additional details:
Pseudowire details and type, such as pseudowire edge, Ethernet flow point, or switching entityNetwork 
Pseudowire 
Detailed
VPLS/H-VPLS information which you can filter using a VPLS/H-VPLS name or map name:
VPLS or H-VPLS name, including any customer labels (business tags)
Maps containing the VPLS/H-VPLS instance VPLS Summary
VPLS/H-VPLS summary with the following additional details:
Type of VPLS service, such as VPLS forward, access EFP, or core pseudowireVPLS Detailed 
						

							  
5-10
Cisco Prime Network 4.3.2 User Guide
Chapter 5      Setting Up Native Reports
  Creating Your Customized Report
Creating Your Customized Report
Customized reports can be added to Report Manager so that other users can run them using their own 
criteria (depending on their user access level and device scopes). If you created new report folders as 
described in Setting Up Your Report Folders, page 5-2, customized reports can be organized under that 
folder (using the Location field).
This example shows how to create a report called 24-Hour Critical Tickets. The customized report will 
be stored under a user-created folder called Critical Tickets - Daily Report - August 2014.
Step 1Right-click Events Reports > Detailed Network Events > Detailed Tickets > Define Report of This 
Ty p e.
Step 2In the Create Report dialog, enter the required information, such as:
Report Settings
–Name—24-Hour Critical Tickets 
–Location—Click Browse and navigate to Events Reports > Critical Tickets - Daily Report - 
August 2014 in the Move To dialog box.
Date Selection—Last 1 days
Device Selection—All Devices
Filter Events/Tickets By Severity—Critical
Step 3Click OK. 
In Report Manager, the new report appears under Events Reports > Critical Tickets - Daily Report - 
August 2014 > 24-Hour Critical Tickets. Next you should test the report to make sure it works 
correctly.
Entering Report Criteria and Testing Your Report
To enter criteria and test a customized report:
Step 1Select Reports > Report Manager > Run Report and navigate to your customized report.
Step 2Right-click the report and choose Run Now.
Step 3Supply your report criteria. What you must supply depends on the report type. Most criteria is 
self-explanatory, but the following provides some additional details on the choices.
NoteThe settings that are displayed depend on the report type.