Cisco Evolved Programmable Network Manager 7.0 User and Administrator Guide

Reports Overview

Cisco EPN Manager reports provide information about system, network health, and fault information. You can customize and schedule reports to run regularly. Reports can present data in a tabular, or graphical format (or a mixture of these formats). You can also save reports in XML, HTML, CSV, or PDF formats. The files can be saved on the Cisco EPN Manager server for later download, or sent to an e-mail address. To generate reports, see Create, Schedule, and Run a New Report.

Cisco EPN Manager reports provide the following type of data:

Current—provides a snapshot of data that is not time-dependent.
Historical—periodically retrieves data from the device and stores it in the Cisco EPN Manager database.
Trend—generates a report using aggregated data, which is collected and summarized as minimums, maximums, and averages.

With Cisco EPN Manager, you can filter these reports based on a specific criteria. For example, IPSLA Y.1731 reports can be filtered based on probes and PWE3 reports can be filtered based on Virtual Connection Identifier (VCID). You can also export reports, sort reports into logical groups, and archive reports for long-term storage.

Compress Report Files

You can choose to compress reports that exceed a particular file size limit. By default, any report that is larger than 5 MB is compressed in a zip format. To change the file size limit, update the variable minSizeToCompressFile in the ReportResources.properties file.

Procedure

Step 1

Open the ReportResources.properties file.

File path - /opt/CSCOlumos/conf/rfm/classes/com/cisco/server/resources/ReportResources.properties

Step 2

Update the minSizeToCompressFile with the required value (in bytes).

For example, if you wish to compress files larger than 7 MB, update the variable as:

minSizeToCompressFile=7340032

Step 3

Save the file.

You must restart the Cisco EPN Manager for this change to take effect.

Available Reports

The Reports Launch Pad provides access to several Cisco EPN Manager reports. You can access them by navigating to Reports > Reports > Reports Launch Pad, and click the Templates tab. The reports available are:

Carrier Ethernet Performance Reports
Device Reports
Network Summary Reports
Optical Performance Reports

You can choose to switch to All Template view which conatins all the reports, Recently Used view which contains a maximum of 20 recent reports which has been run, saved or scheduled or Starred view which contains all the reports which has been marked with a star to set a favorite. You can also refine and filter your reports by category or type from the left hand panel or search for a report using the search text box.

All the available reports are displayed in the center pane. You can add a favourite report by clicking on the star icon.

If you click on a report wideget, you will be redirected to the Generated Reports page where you can view the saved and scheduled reports for that paticular selection.

Note

Exporting performance Performance Monitoring (PM) graph reports in PDF format is not recommended for large datasets due to significant memory and time consumption. Hence, when using the PDF export option, it is advised to limit the report to a maximum of 500 devices or less. This limitation does not exist for CSV exports.

Carrier Ethernet Performance Reports

This section lists the Carrier Ethernet (CE) Performance reports supported by Cisco EPN Manager. It also includes the monitoring policies that must be enabled so that the proper report data is collected. For more information about monitoring policies, see How Device Health and Performance Is Monitored: Monitoring Policies.

Report Type

Provides:

Monitoring Policies That Must Be Enabled

Parameters That Must Be Activated

IPSLA Graphs

Graphical representation of average delay backward, average delay forward, average delay two-way, jitter forward, jitter backward, average backward packet loss ratio, average forward packet loss ratio, and availability.

IPSLA

For details about the IPSLA monitoring policy, see IP SLA Monitoring Policy.

Response Time Avg, Response Time Max,Response Time Min, Jitter Neg DS Avg, Jitter Neg SD Avg, Jitter Pos DS Avg, Jitter Pos SD Avg, Packet Loss Overall Util Avg, Packet Loss DS Util Avg, Packet Loss SD Util Avg, Latency One Way SD Avg, Latency One Way SD Max, Latency One Way SD Min, Latency One Way DS Avg, Latency One Way DS Max, Latency One Way DS Min

IPSLA Statistics

Tabular representation of probe index, IPSLA probe type, TOS, target IP, VRF name, average delay two-way, average delay forward, average delay backward, packet loss ratio forward, packet loss ratio backward, average jitter forward, average jitter backward, average backward packet loss ratio, average forward packet loss ratio, and availability.

IPSLA

For details about the IPSLA monitoring policy, see IP SLA Monitoring Policy.

Jitter Neg DS Avg, Jitter Neg SD Avg, Jitter Pos DS Avg, Jitter Pos SD Avg, Packet Loss Overall Util Avg, Packet Loss DS Util Avg, Packet Loss SD Util Avg, Latency One Way SD Avg, Latency One Way SD Max, Latency One Way SD Min, Latency One Way DS Avg, Latency One Way DS Max, Latency One Way DS Min

IPSLA Top N

Tabular representation of probe index, IPSLA probe type, TOS, target IP, VRF name, average delay two-way, maximum delay two-way, minimum delay two-way, average delay forward, maximum delay forward, minimum delay forward, average delay backward, maximum delay backward, minimum delay backward, average forward packet loss ratio, average backward packet loss ratio, jitter forward, jitter backward, and availability.

IPSLA

For details about the IPSLA monitoring policy, see IP SLA Monitoring Policy.

Response Time Avg, Response Time Max,Response Time Min, Jitter Neg DS Avg, Jitter Neg SD Avg, Jitter Pos DS Avg, Jitter Pos SD Avg, Packet Loss Overall Util Avg, Packet Loss DS Util Avg, Packet Loss SD Util Avg, Latency One Way SD Avg, Latency One Way SD Max, Latency One Way SD Min, Latency One Way DS Avg, Latency One Way DS Max, Latency One Way DS Min

IPSLA Y.1731 Graphs

Graphical representation of average delay backward, average delay forward, jitter two-way, jitter forward, jitter backward, average backward frame-loss ratio, average forward frame-loss ratio, and availability of the Y.1731 probe.

Note

A value of –1 in Probe Indexcolumn indicates that the device does not have a Probe Index configured.

IPSLA Y.1731

For details about the IPSLA Y.1731 monitoring policy, see IP SLA Y.1731 Monitoring Policy.

Average Delay Two Way, Average Delay Forward, Average Delay Backward, Average Positive Jitter Forward, Average Negative Jitter Forward, Average Positive Jitter Backward, Average Negative Jitter Backward, Average Forward Frame Loss Ratio, Average Backward Frame Loss Ratio

IPSLA Y.1731 Statistics

Tabular representation of operation type, CFM domain, source, destination, frame type, average delay two-way, average delay forward, average delay backward, average jitter, forward frame loss ratio, backward frame loss ratio, average forward jitter, average backward jitter, and availability of the Y.1731 probe.

IPSLA Y.1731

For details about the IPSLA Y.1731 monitoring policy, see IP SLA Y.1731 Monitoring Policy.

Average Delay Two Way, Average Delay Forward, Average Delay Backward, Average Forward Frame Loss Ratio, Average Backward Frame Loss Ratio, Average Jitter

IPSLA Y.1731 Top N

Tabular representation of operation type, CFM domain, source, destination, frame type, average delay two-way, maximum delay two-way, minimum delay two-way, average delay forward, maximum delay forward, minimum delay forward, average delay backward, maximum delay backward, minimum delay backward, average forward frame loss ratio, maximum forward frame loss ratio, minimum forward frame loss ratio, average backward frame loss ratio, maximum backward frame loss ratio, minimum backward frame loss ratio, jitter forward, jitter backward, and availability of the devices that are configured using the Y.1731 technology.

IPSLA Y.1731

For details about the IPSLA Y.1731 monitoring policy, see IP SLA Y.1731 Monitoring Policy.

Average Delay Two Way, Average Delay Forward, Average Delay Backward, Average Positive Jitter Forward, Average Negative Jitter Forward, Average Positive Jitter Backward, Average Negative Jitter Backward, Average Forward Frame Loss Ratio, Average Backward Frame Loss Ratio

Interface Availability

Displays the interface details for the devices in the network.

Interface Health

For details about the Interface Health monitoring policy, see Interface Health Monitoring Policy.

Statistics

Interface Graphs

Graphical representation of the interface traffic statistics over time: in traffic, out traffic, in utilization and out utilization.

Interface Health

For details about the Interface Health monitoring policy, see Interface Health Monitoring Policy.

Statistics

Interface Top N

Tabular representation of Top N reports of interface traffic statistics: maximum in traffic, average in traffic, maximum out traffic, average out traffic, maximum in utilization, maximum out utilization and current in utilization, current out utilization, in errors, out errors, in discards, out discards and interface availability.

Interface Health

For details about the Interface Health monitoring policy, see Interface Health Monitoring Policy.

Statistics

Interface Traffic

Tabular representation of interface traffic statistics: in traffic rate, out traffic rate, in utilization, out utilization, in errors, out errors, in discards, out discards, in packets rate, out packets rate (including L3 packets), CRC errors and percentage.

Interface Health

For details about the Interface Health monitoring policy, see Interface Health Monitoring Policy.

Statistics and CRC

Link Utilization

Tabular representation of A device name, A interface name, A member of, A end in utilization, A end out utilization, A end capacity, Z device name, Z interface name, Z member of, Z end in utilization, Z end out utilization, Z end capacity, event time, and the interface utilization of the interfaces participating in the link, including the link aggregate group they belong to.

Note

The prerequisite for this report is to have CDP/LLDP enabled links in the network.

Interface Health

For details about the Interface Health monitoring policy, see Interface Health Monitoring Policy.

Statistics

MPLS Link Statistics

Representation of link delay and jitter in MPLS segment routing.

MPLS Link Performance

For more details about the MPLS monitoring policy, see MPLS Link Performance Monitoring Policy.

Average Delay, Min Delay, Max Delay, RX Packets, TX Packets

PWE3 Statistics

Tabular representation of PWE3 traffic and availability statistics including device name, IP address, VC ID, peer address, VC type, current in bit rate, current out bit rate, current in byte rate, current out byte rate, current in packet rate, current out packet rate, global availability, in availability and out availability.

Pseudowire Emulation Edge to Edge

For details about the Pseudowire Emulation Edge to Edge monitoring policy, see Pseudowire Emulation Edge to Edge Monitoring Policy.

PW VC Perf Total In HC Packets Rate,PW VC Perf Total In HC Bytes Rate, PW VC Perf Total Out HC Packets Rate, PW VC Perf Total Out HC Bytes Rate, PW VC Oper Status Up, PW VC Inbound Oper Status Up, PW VC Outbound Oper Status Up, PW VC Oper Status Down, PW VC Perf Total In HC Packets, PW VC Perf Total In HC Bytes, PW VC Perf Total Out HC Packets, PW VC Perf Total Out HC Bytes, PW VC Inbound Oper Status Down, PW VC Outbound Oper Status Down

PWE3 Top N

Tabular representation of Top N reports of PWE3 statistics including device name, IP address, VC ID, peer address, VC type, average in byte rate, average out byte rate, maximum in byte rate, maximum out byte rate, average in bit rate, average out bit rate, maximum in bit rate, maximum out bit rate, average in packet rate, average out packet rate, maximum in packet rate, maximum out packet rate, global inbound availability and global outbound availability.

Pseudowire Emulation Edge to Edge

For details about the Pseudowire Emulation Edge to Edge monitoring policy, see Pseudowire Emulation Edge to Edge Monitoring Policy.

PW VC Perf Total In HC Packets Rate,PW VC Perf Total In HC Bytes Rate, PW VC Perf Total Out HC Packets Rate, PW VC Perf Total Out HC Bytes Rate, PW VC Oper Status Up, PW VC Inbound Oper Status Up, PW VC Outbound Oper Status Up, PW VC Oper Status Down, PW VC Perf Total In HC Packets, PW VC Perf Total In HC Bytes, PW VC Perf Total Out HC Packets, PW VC Perf Total Out HC Bytes, PW VC Inbound Oper Status Down, PW VC Outbound Oper Status Down

PWE3 Traffic Graphs

Graphical representation of PWE3 traffic including average in bit rate, average out bit rate, average in byte rate, average out byte rate, average in packet rate, average out packet rate, global availability, in availability and out availability.

Pseudowire Emulation Edge to Edge

For details about the Pseudowire Emulation Edge to Edge monitoring policy, see Pseudowire Emulation Edge to Edge Monitoring Policy.

PW VC Perf Total In HC Packets Rate,PW VC Perf Total In HC Bytes Rate, PW VC Perf Total Out HC Packets Rate, PW VC Perf Total Out HC Bytes Rate, PW VC Oper Status Up, PW VC Inbound Oper Status Up, PW VC Outbound Oper Status Up, PW VC Oper Status Down, PW VC Perf Total In HC Packets, PW VC Perf Total In HC Bytes, PW VC Perf Total Out HC Packets, PW VC Perf Total Out HC Bytes, PW VC Inbound Oper Status Down, PW VC Outbound Oper Status Down

QoS Policing

Tabular representation of the details about the policy map: ClassMap. The details include, direction of the policy map, average exceed byte rate, maximum exceed byte rate, maximum exceed date, average violate byte rate, maximum violate byte rate, maximum violate date, average conformed byte rate, maximum conformed byte rate, maximum conformed date, CIR current rate and PIR current rate. Also, graphical representation of exceed, violate and conformed byte rates.

Quality of Service

For details about the Quality of Service monitoring policy, see Quality of Service Monitoring Policy.

Conformed Bytes Rate, Exceeded Bytes Rate, Violated Bytes Rate, Exceeded Packets, Violated Bytes, CIR, Conformed Bytes, Exceeded Bytes, PIR

QoS Policy

Graphical and tabular representation of the details about the policy map: ClassMap. The details include, direction of the policy map, average pre-policy byte rates, maximum pre-policy byte rates, average post-policy byte rates, maximum post-policy byte rates, maximum pre-policy dates, maximum post-policy dates, average drop in percentage, maximum drop in percentage, maximum drop date, average pre-policy of CIR, average interface speed in percentage, maximum pre-policy of CIR, maximum interface speed in percentage, average pre-policy of CIR, maximum pre-policy of CIR and interface speed date. Also, graphical representation of pre-policy, post-policy, drop bit rate, and drop percentage.

Quality of Service

For details about the Quality of Service monitoring policy, see Quality of Service Monitoring Policy.

Drop Bytes Rate, Drop Percent, Post-Policy Bytes Rate, Pre-Policy Bytes Rate, Pre-Policy Percent of CIR, Post-Policy Percent of CIR, CIR, Post-Policy Rate (Bytes/Sec),Pre-Policy Bytes

Device Reports

This section lists the device reports supported by Cisco EPN Manager. It also lists the monitoring policies and parameters that must be enabled for each of the report type. These reports are applicable for both Optical and Carrier Ethernet technologies.

Note

Report types marked with an asterisk (*) are applicable for SVO devices.

For more information about monitoring policies, see Monitor Device and Network Health and Performance.

Report type

Report details

Monitoring policies that must be enabled

Parameters that must be activated

Alarm

Lists alarms for devices in the network. This includes severity, message, status, failure source, time stamp, creation time, device timestamp, owner, category, condition, location, service affecting, and satellite ID

NA

CPU Utilization

Table that lists all devices with their average CPU usage for a specified time period.

Device Health

For details about the Device Health monitoring policy, see Device Health Monitoring Policy.

CPU Utilization

Detailed Hardware *

Lists hardware information for the entire inventory or device types (for example, switches and hubs, routers, and optical transport).

NA

Detailed Software *

Provides software information for the entire inventory or device types (for example, switches and hubs, routers, and optical transport).

NA

Device Availability

Table listing all the available devices in the network and their reachability percentage.

NA

Device Credential Verification

Provides the credential status of the devices in your network. Includes the login, reachability, and protocol statuses of each device. Also, includes the last modified date and time for the device.

Device credential Verification report includes two report types: Immediate Report: Report will be generated immediately by getting the data from DB. It is legacy behavior from device credential verification report.

Check Device and Show : Device credential will be verified on runtime in backend and report will be generated.

NA

Device Health

CPU utilization, memory utilization, and availability information of the network devices for a specified time period. Includes minimum, maximum, and average for all CPU modules and memory pools on a device.

Device Health

For details about the Device Health monitoring policy, see Device Health Monitoring Policy.

CPU Utilization

Device Serial Number

Lists the serial number of devices present on your network.

NA

Event

List of events for devices in your network. Includes description, failure source, time stamp, device timestamp, severity, category, condition.

NA

GNSS Module Inventory

GNSS inventory data such as satellite visibility ID, signal-to-noise ratio, module status, satellite status, antenna alarm status, and so on.

GNSS Monitoring Policy

For details about the GNSS monitoring policy, see GNSS Monitoring Policy.

NA

Identity Capability

Identity capability summary information for the switches in the network.

NA

Interface Detail (Two report options are available: Physical Interface and IP Interface)

Physical Interface Report: Physical interface details of the devices in your network. Includes device name, port name, port description, MAC address, admin status, and operational status.

NA

IP Interface Report: Logical port data of the devices in your network. Includes device name, port name, port IP address, port description, admin status, and operational status.

Inventory*

Basic Inventory data for the devices in your network for each of the following categories: combined inventory, controllers, MSEs, switches, routers, dead radios, Cisco interfaces and modules, storage networking, security and VPN, optical networking.

NA

Link

Performance information related to OTU, OTS, ODU, and OMS enabled links in a network.

Device Health

For details about the Device Health monitoring policy, see Device Health Monitoring Policy.

NA

Memory Utilization

Memory utilization information for a specified time period. Includes information for all memory pools/modules.

Device Health

For details about the Device Health monitoring policy, see Device Health Monitoring Policy.

Memory Pool Utilization

Network Inventory Detail

Network inventory information in the network includes device name, device IP, equipment type, operation status, actual equipment type, physical location, CLEI code, hardware part number, manufactured date, serial number, product ID, version ID, and also UDFs (if selected from the column list under Settings tab).

Device Health

For details about the Device Health monitoring policy, see Device Health Monitoring Policy.

NA

Optical SFP Threshold

SFP threshold data related to Transceiver temperature and voltage levels, transmit and receive power levels, and laser bias levels.

NA

Port Capacity

Percentage of interface utilization for devices in a network. Also, includes the option to define a report type: All, Connected, Free, or Free Down.

NA

PTP State

Provides details such as PTP clock class, PTP servo, port index, and PTP boundary clock data.

PTP/SyncE Monitoring Policy

For details about the PTP/SyncE Monitoring Policy, see PTP/SyncE Monitoring Policy.

NA

PWE3 Config Report

Lists the details of pseudo wire configuration in the server. The details include PW ID, PW class, description, its source, remote peer information, access interface name, preferred path, LDP fallback, bandwidth, MTU, and so on.

Device Health

For details about the Device Health monitoring policy, see Device Health Monitoring Policy.

NA

RSVP TE Tunnel Detail

Lists the configuration information of the RSVP TE tunnel circuits. The details include tunnel ID, its source and destination, affinity bits and mask, priority, bandwidth, metrics, tunnel type, load share ratio, route information, Fault Oam Enabled, Wrap Enabled, backup tunnel ID, protection, overflow threshold, BW informatiom, and so on.

NA

PWID Inventory

Lists the Pseudowire Identifier (PWID) between all the local device and peer devices. Lists all PWID for all services per domain and per router.

Device Health

For details about the Device Health monitoring policy, see Device Health Monitoring Policy.

NA

SFP Port and Module Details

Lists the small form-factor pluggable and module details on your network.

NA

Third Party Devices Detail

Lists the details of the third-party devices on your network.

NA

Vlan

Vlan information for switches in a network.

NA

VLAN Detailed

Detailed VLAN information for the switches in the network. Includes VLAN ID, VLAN name, VTP domain name, admin status, device IP address, device name, interface IP address, operational VLAN mode, and operational status.

NA

Wired Detailed Device Inventory *

Detailed inventory data for the wired devices in your network. Includes system information, chassis information, module information, module port interfaces, VLAN interfaces, software image information, memory pool information, flash devices, flash partition, flash file.

Note

Up to 5 devices can be selected if you want to run the report immediately without saving it. To include more than 5 devices, save or schedule the report.

NA

Wired Device Availability

List of wired devices with the highest and lowest availability in your network. Includes device name, average availability (%), and Bottom N device availability.

Note

This report is not applicable for SVO devices.

NA

Wired Module Detail *

Table listing detailed module information for wired devices in the network including device name, device IP, equipment name, number of ports, operational status, vendor equipment type, manufacturer, serial number, and UDI.

NA

Wired Port Attribute

Port attribute information such as admin status, operational status, MAC address, and so on. Includes VLAN ID, access mode VLAN, device IP address, Interface IP address, description, MAC address, Admin status, operational status, type, MTU, speed, duplex, IsTrunk, and trunk encapsulation

Wired Port Pluggable Attribute is a sub-report type available under the Wired Port Attribute. It includes port pluggable attribute information, such as pluggable model information, pluggable description, pluggable type, port name, device IP address, interface IP address, MAC address, operational status, MTU, and speed.

Device Health

For details about the Device Health monitoring policy, see Device Health Monitoring Policy.

NA

Network Summary Reports

This section lists the Network Summary reports supported by Cisco Evolved Programmable Network Manager. These reports provide information about the health of the network.


Report Type	Provides:	Monitoring Policies That Must Be Enabled	Parameters That Must Be Polled
Link Flap Report	Tabular representation of the A end device, A end interface, Z end device, Z end interface, link name and the number of flaps.	NA	NA

Optical Performance Reports

Table lists the Optical Performance reports supported by Cisco EPN Manager. For all graphical reports, ensure that you select a maximum of four interfaces while you schedule or run these reports. For all tabular reports, use the Show field to specify the number of records to be displayed in a page while you schedule or run these reports.

The performance data displayed in the generated reports depends on the monitoring policy parameter that you activate when you enable the monitoring policy. For a detailed list of monitoring type and the associated performance counters, see Monitoring Policies Reference. For more information about monitoring policies, see Monitor Device and Network Health and Performance. For information about how to interpret the report results, see Report Output Examples: Web GUI Output and CSV File Output.

Note

Enable the Optical 1 day, Optical 15 mins, or Optical 30 secs monitoring policies to populate data for these reports.

Table 1. Optical Performance Reports

Report

Report Type

Provides:

Monitoring Policy Parameters That Must Be Activated

Parameters That Must Be Polled

Ethernet

Ethernet Reports–IOS-XR and SVO devices

Graphical and tabular reports that list the total number of packets that are requested by the higher-level protocols to be transmitted, and which were not addressed to a multicast or broadcast address at this sublayer, including those that were discarded or not sent. The details also include the total number of multicast frames transmitted error free, the total number of packets requested by higher-level protocols, the total number of transmitted octets, the total number of octets received on the interface, and the number of received packets that were discarded because of errors.

To customize the report output for a new report, choose Reports > Report Launch Pad > Optical Performance > Ethernet. Click Generate New and click the Customize Data tab.

To customize the report output for an existing report, choose Reports > Report Launch Pad > Optical Performance > Ethernet, click the required report link, and click the Customize Data tab.

Optical 1 day,

Optical 15 mins,

or Optical 30 secs

For details about the information collected by optical monitoring policies, see Monitoring Policies Reference.

For information about how to interpret the report results, see Report Output Examples: Web GUI Output and CSV File Output.

Ethernet

OTN

Section Monitoring NEnd & FEnd Reports- Cisco NCS 1000 series, Cisco NCS 2000 series, and Cisco NCS 4000 series devices

Graphical and tabular reports that list the OTN section monitoring details of devices and interfaces in the OTN circuit type. The details include number of background block errors and its ratio, number of errored seconds and its ratio, number of severely errored seconds and its ratio, number of unavailable seconds, and number of failure counts.

Optical 1 day,

Optical 15 mins,

or Optical 30 secs

For details about the information collected by optical monitoring policies, see Monitoring Policies Reference.

For information about how to interpret the report results, see Report Output Examples: Web GUI Output and CSV File Output.

OTN

DWDM Infrastructure¹

Path Monitoring NEnd & FEnd Reports

Graphical and tabular reports that list the OTN path monitoring details of devices and interfaces in OTN circuit type. They provide details such as number of background block errors and its ratio, number of errored seconds and its ratio, number of severely errored seconds and its ratio, number of unavailable seconds, and number of failure counts.

Forward Error Correction Reports- Cisco NCS 1000 series, Cisco NCS 2000 series, and Cisco NCS 4000 series devices

Graphical and tabular reports that list the OTN forward error correction details of devices and interfaces in the OTN circuit type. The details include ECW, UCW, the number of bit errors that are corrected, number of uncorrectable words, and preforward error correction-based bit error counts detected during the performance monitoring time interval.

Tandem Connection Monitoring NEnd & FEnd Reports

Graphical and tabular reports that provide the tandem connection monitoring details for the devices and interfaces in the OTN circuit type. The details include number of background block errors and its ratio, number of errored seconds and its ratio, number of severely errored seconds and its ratio, number of unavailable seconds, and number of failure counts.

OTN

GFP Statistics Reports–Cisco NCS 2000 series and Cisco NCS 4000 series devices

Graphical and tabular reports that provide the Generic Framing Procedure (GFP) statistics for the devices in the OTN circuit type. The GFP statistics include number of GFP frames and bytes received and transmitted, number of single and multiple bit errors received, number of packets received with CRC errors, invalid GFP type, invalid CID, number of CMF frames received and transmitted, and number of cHEC and tHEC multiple bit errors.

OTN

DWDM Infrastructure¹

Physical

Optical Power Reports-Cisco NCS 1000 series, Cisco NCS 2000 series, SVO, Cisco NCS 4000 series, Cisco NCS 1010 devices

Graphical and tabular reports that provide the average, minimum, and maximum percentage of optical input and output power of the received and transmitted signal for devices in a physical circuit type.

Note

Graphical reports are not supported for SVO devices.

Optical 1 day,

Optical 15 mins,

or Optical 30 secs

For details about the information collected by optical monitoring policies, see Monitoring Policies Reference.

For information about how to interpret the report results, see Report Output Examples: Web GUI Output and CSV File Output.

Note

Optical 30 secs

is not applicable for SVO devices

Physical

DWDM Infrastructure¹

Laser Bias Current Reports- Cisco NCS 1000 series, Cisco NCS 2000 series, SVO, and Cisco NCS 4000 series devices

Graphical and tabular reports that provide the average, minimum, and maximum percentage of laser bias current. The laser bias current is the normalized value expressed as the integer percentage.

Note

Graphical reports are not supported for SVO devices.

Optical Physical Report -Cisco NCS 1000 series, Cisco NCS 2000 series, SVO, Cisco NCS 4000 series, Cisco NCS 1010 devices

Graphical and tabular reports that provide the average, minimum, and maximum value of optical power on the unidirectional port. The details include the average, minimum, and maximum Optical Service Channel power level. The details of average, minimum and maximum optical signal-to-noise ratio, optical power warning, chromatic dispersion, second order polarization mode dispersion, polarization dependent loss, differential group delay, polarization change rate, and phase noise.

Note

Graphical reports are not supported for SVO devices.

SDH Or SONET

SDH Regenerator Section Report

Graphical and tabular reports that provide the performance monitoring details of the SDH regenerator section layer for the devices in your network. The details include the number of background block errors and its ratio, number of errored seconds and its ratio, number of severely errored seconds and its ratio, number of unavailable seconds, number of errored blocks, and number of out-of-frame seconds.

Optical 1 day or

Optical 15 mins

For details about the information collected by optical monitoring policies, see Monitoring Policies Reference.

For information about how to interpret the report results, see Report Output Examples: Web GUI Output and CSV File Output.

SDH/SONET

DWDM Infrastructure¹

SDH Multiplex Section NEnd & FEnd Reports - Cisco NCS 2000 series devices

Graphical and tabular reports that provide the performance monitoring details of SDH multiplex section layer for the devices in your network. The details include number of background block errors and its ratio, number of errored seconds and its ratio, number of severely errored seconds and its ratio, number of unavailable seconds, number of errored blocks, number of failure counts, protection switching—Switching count, ring count, span count, working count, duration, ring duration, span duration, and working duration.

SDH Multiplex Section NEnd & FEnd Reports - Cisco NCS 4000 series devices

Graphical and tabular reports that provide the performance monitoring details of SDH multiplex section layer for the devices in your network. The details include number of background block errors and its ratio, number of errored seconds and its ratio, number of severely errored seconds and its ratio, number of unavailable seconds, and number of errored blocks.

SONET Section Report

Graphical and tabular reports that provide performance monitoring details of SONET section layer for the devices in your network. The details include number of coding violations, number of errored seconds, number of severely errored seconds, and number severely errored frame seconds.

SONET Line NEnd & FEnd Reports - Cisco NCS 2000 series devices

Graphical and tabular reports that provide performance monitoring details of SONET line layer for the devices in your network. The details include number of coding violations, number of errored seconds, number of severely errored seconds, number of unavailable seconds, number of failure counts, protection switching—Switching count, ring count, span count, working count, duration, ring duration, span duration, and working duration.

SONET Line NEnd & FEnd Reports - Cisco NCS 4000 series devices

Graphical and tabular reports that provide performance monitoring details of SONET line layer for the devices in your network. The details include number of coding violations, number of errored seconds, number of severely errored seconds, number of unavailable seconds, and number of failure counts.

_{1. You must activate this
parameter for all Cisco Optical Networking Services (ONS) and Cisco Network
Convergence System (NCS) 2000 series devices.}

Performance Reports

This section lists the basic performance reports supported by Cisco EPN Manager. It also lists the monitoring policies and parameters that must be enabled for each of the report type. These reports are applicable for Optical and Carrier Ethernet technologies.

Note

Report types marked with an asterisk (*) are applicable for SVO and Cisco NCS 2000 series devices.

For more information about monitoring policies, see Monitor Device and Network Health and Performance.


Report Type	Provides:	Monitoring Policies That Must Be Enabled	Parameters That Must Be Activated
Environmental Temperature	Tabular representation of Device IP Address, name, Sensor Name, Sensor Type, Maximum Inlet Temp, Maximum Other Temp, and Event time for network devices.	Device Health For details about the Device Health monitoring policy, see Device Health Monitoring Policy.	Environment Temperature
Threshold Violations	Lists the threshold violation alarms data (source, event type, category, and description) for your network in a table.	Device Health For details about the Device Health monitoring policy, see Device Health Monitoring Policy.	Admin Status Up/Down Operational Status Up/Down Admin Status Up and Operational Status Down Percentage

System Monitoring Reports

This section lists the System Monitoring reports supported by Cisco Evolved Programmable Network Manager. These reports provide information about CPU, Disk and Memory utilization of the network when they exceed threhold limits.


Report Type	Provides:	Monitoring Policies That Must Be Enabled	Parameters That Must Be Polled
CPU Threshold Breach	CPU Utilization for devices in a network. .	NA	NA
Disk Threshold Breach	Disk utilization results when it exceeds the threshold limit.	NA	NA
Memory Threshold Breach	Includes memory utilization results when memory utilization exceeds the threshold limit.	NA	NA

Configure a SFTP Repository

You can configure an external SFTP repository (local or remote) to which you can export reports.

Procedure

Step 1	Navigate to Administration > Settings > System Settings > General > Report.
Step 2	Enter details of the SFTP sever in the fields listed under the External Server Settings area.
Step 3	Click Save.

Create, Schedule, and Run a New Report

The Report Launch Pad provides access to all Cisco EPN Manager reports from a single page. From this page, you can perform all report operations: Create, save, view, schedule, and customize.

To see more report details, hover the cursor over the template widget.

To create, schedule, and run a new report:

Before you begin

Ensure that you have configured an external server if you are planning on exporting the report to an external SFTP repository. See Configure a SFTP Repository for more information.

When you run multiple reports, maintain an adequate time interval between the reports which contain huge tables. This avoids overlapping while fetching data.

Procedure

Step 1	From the left sidebar, choose Reports > Reports > Report Launch Pad, and choose Templates.
Step 2	Locate the report that you want to launch (you can filter the reports by checking/unchecking the checkboxes based on the report type under the Refine & Filer pane), and click Generate New.
Step 3	Under the Report Details window, enter the report title. You can edit the Report Title field.
Step 4	Choose the appropriate Report By category from the drop-down list.
Step 5	The Report Criteria field allows you to sort your results depending on the previous Report By selection made.
Step 6	Select the values from Severities and Categories drop-downs. Choose the Reporting Period.
Step 7	If you plan to run this report later or as a recurring report, click the Export and Schedule tab, click the Export slider, and choose the report type. Select the report export file format (CSV, XML, HTML, or PDF). Exported CSV file is a single .csv file, which has capability to hold one million records. If the number of records exceeds one million, then another CSV file will be generated accommodating the remaining records. Finally, the CSV files are generated in a zip format. Select one of the Destination options (File, Email, or SFTP).
Step 8	Check the Schedule slider, and choose the date and time to run the report.
Step 9	To run the report, choose one of the following options: Run—Runs the report without saving the report setup. Save—If you have not saved any parameters, the report is saved without running. If you have enabled the Export option and entered related details, the report is saved and is run immediately. If you have enabled both the Export and Schedule options and entered related details, then the report is saved and is run at the scheduled date and time that you have entered. Cancel—Returns to the previous page without running or saving this report.

Customize Report Results

Many reports allow you to customize their results, letting you include or exclude different types of information. Reports that support this feature display a Customize button. Click this button to access the Create Custom Report page and customize the report results.

To customize a report result:

Procedure

Step 1	Click Reports > Reports > Generated Reports and, then select the report that you want to customize. Click the Edit icon.
Step 2	In the Edit Report page, click the Customize Data tab and complete the required information. You can choose report columns as well as sort the reports based on different criteria.
Step 3	Click Save to save the changes.

Filter and Customize Report Data Using User Defined Fields

You can create custom attributes and assign values to them. See Create User Defined Fields for Custom Values for information about how to create user-defined fields (UDF). You can then use the UDFs to filter and customize the report results.

Cisco EPN Manager scans the values of UDFs created every two minutes and generates a UDF.json file, in which the metadata are saved. You can access this file from the /opt/CSCOlumos/conf/rfm/classes/com/cisco/server/reports/conf/UDF.json location.

Here is an example of how the metadata for the UDFs are displayed in the UDF.json file:

[
  {
    "label": "internal",
    "hidden": true,
    "displayName": "Internal",
    "fixedColumn": false
  },
  {
    "label": "location",
    "hidden": true,
    "displayName": "Location",
    "fixedColumn": false
  },
  {
    "label": "quality",
    "hidden": true,
    "displayName": "Quality",
    "fixedColumn": false
  },

In this example:

The attribute label is the user-defined field that is created in the Administration > Settings > System Settings > General > User Defined Fields page.
The attribute hidden is set to False, by default. If this attribute is set to True, the UDF is hidden on the Reports page. You need to set this attribute to False so that the UDF is available for selection when you customize the report results.
The attribute displayName is used to change the UDF name that will be displayed in the report results.
The attribute fixedColumn is applicable only when the hidden attribute is set to False.

After you have made the required changes in the UDF.json file, you can customize the report results. See Customize Report Results.

You can filter and customize reports based on UDFs for the following reports:


Report Category	Report Name	Report Type
CE Performance	Interface Graphs	Interface In Utilization Graph
		Interface In Traffic Graph
		Interface Out Utilization Graph
		Interface Out Traffic Graph
	Interface Top N	Interface Top N In Utilization
		Interface Top N In Traffic
		Interface Top N Out Utilization
		Interface Top N Out Traffic
		Interface Bottom N Availability
	Interface Traffic	Interface Errors and Discards
		Interface Traffic Report
		Interface CRC Errors Report
Performance	Environmental Temperature	Summarized Environmental Temperature
Performance	Environmental Temperature	Current Environmental Temperature
Device	CPU Utilization	CPU Utilization
		Top CPU Utilization
		Bottom CPU Utilization
	Memory Utilization	Memory Utilization
		Top Memory Utilization
		Bottom Memory Utilization
	Wired Module Detail	Wired Module Detail Report Details
	Wired Detailed Device Inventory	Wired Detailed Device Inventory Report Details

You can also change the filter type of the UDF in the UDF.json file. The default filter type is String.

Here are a few examples of filter types and their definitions:

[
  {
    "label": "internal",
    "displayName": "Internal",
    "hidden": false,
    "fixedColumn": false,
    "filterMetadata": {
      "sqlDataType": "Boolean",
      "attr": "internal",
      "label": "UDF: Internal Used",
      "filterType": "boolean"
    }
  },
  {
    "label": "location",
    "displayName": "Location",
    "hidden": false,
    "fixedColumn": false
  },
  {
    "label": "quality",
    "displayName": "Quality",
    "hidden": false,
    "fixedColumn": false,
    "filterMetadata": {
      "sqlDataType": "Number",
      "selectItems": {
        "1": "High Quality",
        "2": "Mid Quality",
        "3": "Low Quality"
      },
      "attr": "quality",
      "label": "UDF: Quality",
      "filterType": "enumeration"
    }
  },
  {
    "label": "sapid",
    "displayName": "SAP ID",
    "hidden": false,
    "fixedColumn": true,
    "filterMetadata": {
      "sqlDataType": "Number",
      "attr": "sapid",
      "label": "UDF: SAP ID",
      "filterType": "numeric"
    }
  },
  {
    "label": "startTime",
    "displayName": "Start Time",
    "hidden": false,
    "fixedColumn": false,
    "filterMetadata": {
      "sqlDataType": "Timestamp",
      "attr": "startTime",
      "label": "UDF: Start Time",
      "filterType": "datetime"
    }
  },
  {
    "label": "vendor",
    "displayName": "Vendor",
    "hidden": false,
    "fixedColumn": true,
    "filterMetadata": {
      "sqlDataType": "String",
      "selectItems": {
        "huawei": "Hua Wei",
        "alu": "Alcatel Lucent",
        "cisco": "Cisco"
      },
      "attr": "vendor",
      "label": "UDF: Vendor",
      "filterType": "enumeration"
    }
  }
]

After making the required changes in the UDF.json file, use the Advanced Filter option in the Report Details page to filter the report data.

Report Output Examples: Web GUI Output and CSV File Output

In this example, a section monitoring report is generated for Cisco NCS 2000 series devices that are available in the near end of the network. You can choose to view the result, either at the bottom of the Report Details page, or export the results in CSV, XML, HTML, or PDF format files. For more information on how to create and run a report, see Create, Schedule, and Run a New Report.

If scheduling is enabled and you choose to export the result to a CSV file, the report is saved in the repository that is named as /localdisk/ftp/reports. You can adjust the location of the report repository. For more information, see Report Purging.

Note

If scheduling is disabled and you choose to export the result to a CSV file, the report is saved in the repository that is named as /localdisk/ftp/reportsOnDemand.

The file naming convention for the CSV file is ReportTitle_yyyymmdd_hhmmss.csv, where yyyymmdd is the year, month, and date, and hhmmss is the hours, minutes, and seconds when the report result is exported.

The following figure shows how the results are displayed in a CSV file.

The following table explains how you can interpret the section monitoring report result.


Column Name	Description
Device Name	Name of the device that is in the near end of the network.
Device IP Address	IP address of the device.
Interface	Interface name of the device.
Date/Time	Date and time when the section monitoring data was collected for the device. The value in this column depends on the report interval that you chose when you created the report. The report interval can be 15 minutes or 24 hours.
BBE-SM	Number of background block errors for the device.
BBER-SM	Background block error ratio for the device.
ES-SM	Number of errored seconds for the device.
ESR-SM	Errored seconds ratio for the device.
SES-SM	Number of severely errored seconds for the device.
SESR-SM	Severely errored seconds ratio for the device.
UAS-SM	Number of unavailable seconds for the device.
FC-SM	Number of failure counts (AIS/RFI detected) for the device.

Troubleshooting Tips for an Empty Report

If the report was run successfully but you do not have an output file that can be exported, you can try one of the following troubleshooting tips:

Check if you have

For example:

Enabled the correct monitoring policy. For details on what monitoring policies must be enabled, see Monitoring Policies Reference.

For QoS reports, QoS monitoring policy must be enabled.

Enabled the periodic collection.

For any System Monitoring Periodic reports (CPU/Disk/Memory), the periodic collection must be enabled. Once enabled, the report must be generated after 12 hours to see the output.

Note

To enable Periodic collection,

Visit link: https://<Server IP>/webacs/ncsDiag.jsp
Select System Monitoring Diagnostic > Monitoring Settings, and click the Periodic Collection Enable button.

Chosen the correct device type for a particular report.

Do not choose NCS devices for generating CE Performance reports as they are optical devices.

Selected the correct time period while generating a report.

You cannot choose a 2-week time period if you enabled the policy only two days ago.

Configured the device properly. For more details, see Configure Devices So They Can Be Modeled and Monitored.

For QoS reports, QoS must be configured/enabled on the device.

Successful device inventory collection. For more details, see Find Devices With Inventory Collection or Discovery Problems

For the reports to have data, the inventory collection status must be Completed.

Bias-Free Language

Book Title

Cisco Evolved Programmable Network Manager 7.0 User and Administrator Guide

Chapter Title

Manage Reports

Results

Chapter: Manage Reports

Manage Reports

Reports Overview

Compress Report Files

Procedure

Available Reports

Carrier Ethernet Performance Reports

Device Reports

Network Summary Reports

Optical Performance Reports

Performance Reports

System Monitoring Reports

Configure a SFTP Repository

Procedure

Create, Schedule, and Run a New Report

Before you begin

Procedure

Customize Report Results

Procedure

Filter and Customize Report Data Using User Defined Fields

Report Output Examples: Web GUI Output and CSV File Output

Troubleshooting Tips for an Empty Report

Was this Document Helpful?

Contact Cisco