Monitor Device and Network Health and Performance
How Device Health and Performance Is Monitored: Monitoring Policies
Monitoring policies control how Cisco Evolved Programmable Network Manager monitors your network by controlling the following:
-
What is monitored—The network and device attributes Cisco Evolved Programmable Network Manager monitors.
-
How often it is monitored—The rate at which parameters are polled.
-
When to indicate a problem—Acceptable values for the polled attributes.
-
How to indicate a problem—Whether Cisco Evolved Programmable Network Manager should generate an alarm if a threshold is surpassed, and what the alarm severity should be.
Monitoring policies are important because apart from controlling what is monitored, they determine what data can be displayed in reports, dashboards, and other areas of Cisco Evolved Programmable Network Manager. Monitoring policies do not make any changes on devices.
Only device health monitoring (that is, the Device Health monitoring policy) is enabled by default. Interface Health monitoring is not enabled by default to protect system performance in large deployments. Note that the Device Health monitoring policy does not apply to the Cisco NCS 2000 and Cisco ONS families of devices. To monitor those device types, use the optical monitoring policies listed in Monitoring Policies Reference.
These steps summarize how you can configure a monitoring policy.
-
Use a monitoring policy type as a template for your monitoring policy, and give the policy a name that is meaningful to you. Policy types are packaged with Cisco Evolved Programmable Network Manager and make it easy for you to start monitoring different technologies and services, such as Quality of Service, Optical SFP, and TDM/SONET. A complete list is provided in Monitoring Policies Reference.
-
Adjust your policy's polling frequencies or disable polling altogether for specific parameters.
-
Specify the threshold crossing alarms (TCAs) you want Cisco Evolved Programmable Network Manager to generate if a parameter's threshold is surpassed. Some TCAs are configured by default; you can adjust or disable them, and configure new TCAs.
-
Specify the devices you want your policy to monitor. Devices are filtered depending on the policy type.
-
Activate your policy. The polled data is displayed in dashboards, reports, the Alarms and Events table, and other areas of the web GUI.
Monitoring policies collect data by polling network and device attributes at fixed polling intervals. The policy may run outisde of the polling interval due to:
-
Server load on account of processes like daily backup and daily inventory collection
-
Issues in connecting to the device or network latency
-
Collecting data from the device takes longer than the polling interval configured.
If there are devices being polled or in queue from a previous policy run, the policy skips polling these devices in the current polling interval. This behavior could result in a loss of up to 10 percent of monitored data for certain devices.
To view and administer monitoring policies, choose
.
Navigation |
Description |
Automonitoring |
Lists the policies that are enabled by default in Cisco Evolved Programmable Network Manager. Only the Device Health monitoring policy is enabled by default. You can adjust the settings for this policy. |
My Policies |
The policy you create is listed here. When you choose a policy from My Policies, you can view the policy's details. |
Set Up Basic Device Health Monitoring
The Device Health monitoring policy is enabled by default. It monitors both Cisco devices and third-party devices. For Cisco devices, the device health monitoring checks managed devices for CPU utilization, memory pool utilization, environment temperature, and device availability. For third party devices, the device health monitoring checks managed devices for device availability only. This policy also specifies thresholds for utilization and temperature which, if surpassed, trigger alarms that are displayed in the GUI client.
To view the current settings for this policy, choose Automonitoring from the list on the left. You can also adjust the polling frequency and threshold for the different parameters. To adjust a polling frequency or threshold, use the drop-down lists that are provided in the GUI client.
, then selectYou might also want to create a device health monitoring policy that monitors specific devices—for example, devices of a certain type or in a certain geographical location. For instructions on how to do this, see Adjust What Is Being Monitored.
Set Up Basic Interface Monitoring
Interfaces are not monitored by default. This protects the system performance for networks with a large numbers of interfaces.
Use this procedure to set up basic interface monitoring.
To set up and enable interface monitoring:
Procedure
Step 1 |
Choose My Policies in the list on the left. , then select |
Step 2 |
Click Add to create a new policy. |
Step 3 |
Choose Interface Health for generic interface monitoring. If you are monitoring optical devices, choose Optical 15 Mins or another optical policy (see Monitoring Policies Reference). When you select a policy, Cisco Evolved Programmable Network Manager populates the window with the policy settings. |
Step 4 |
Enter the name and description. |
Step 5 |
From the Device Selection drop-down list, click the appropriate radio button and select the device or device groups that you want to monitor. For the Interface Health monitoring policy, you can also select port groups. Cisco Evolved Programmable Network Manager only lists the devices or ports applicable to the policy that you selected in Step 3. Note the following:
|
Step 6 |
To adjust how often the interface is polled, select a value from the Polling Frequency drop-down list. Some policies allow you to set polling frequencies for different parameters, while other policies have only one polling frequency that is applied to all the parameters. For example, the following shows a policy that monitors Cisco ASR 9000 interfaces. It uses the Interface Health policy type, where all parameters are polled using the same interval. Alternatively, the following shows a policy that monitors Cisco NCS 1004 interfaces. It uses the Optical 15 mins policy type, where each interface type has its own polling interval. You can edit the interval by double-clicking it. |
Step 7 |
If the policy supports TCA customization, you can adjust the thresholds. See Change Thresholds and Alarm Behavior for a Monitoring Policy. |
Step 8 |
Click:
|
Use the Dashboards To Check Network and Device Health
Cisco Evolved Programmable Network Manager provides a variety of dashboards for monitoring your devices and network. The following are some examples of what dashboards can provide:
-
Network-wide real-time status information, such as unreachable devices, interfaces that are down, and the most recent alarms.
-
Summarized historical information, such as the most frequently-occurring alarms, and the devices and interfaces with the highest memory and CPU utilization.
-
Device-specific information, such as a device's availability history, utilization, interface statistics, and alarms.
-
Technology-specific information, such as Carrier Ethernet services.
For information on dashboards, see Set Up and Use the Dashboards.
Check What Cisco Evolved Programmable Network Manager Is Monitoring
This topic explains how to get the following information:
-
Which policies are activated, their status, and their history.
-
The specific parameters that Cisco Evolved Programmable Network Manager is polling, the frequency at which they are polled, and their threshold crossing alarm (TCA) settings.
-
Who created the policy and which policy type they used as its basis.
To find out what a policy polls, when the policy last ran, and whether the policy is currently active, choose My Policies. Cisco Evolved Programmable Network Manager lists the monitoring policies you created or have access to, with the following information.
, then choose
Policy Field |
Description |
---|---|
Name |
Policy name (specified by the policy creator). To find out who created a policy, see the instructions that follow this table. |
Description |
Policy description (specified by the policy creator). |
Type |
Template (policy type) used to create this policy. For information on the policy types, see How Device Health and Performance Is Monitored: Monitoring Policies. |
Status |
Active or Inactive. |
Threshold |
Whether the policy monitors parameter thresholds and generates TCAs. If Yes is displayed, you can check the TCA settings using the instructions that follow this table. |
Activation History |
Active monitoring policy—Displays the number of times the policy was activated, and provides a hyperlink to an Activation History popup window that tells you:
Inactive monitoring policy—Displays Not Available. |
Collection Status |
Active monitoring policy—Provides a hyperlink to a Collection Status popup window that tells you:
Inactive monitoring policy—Displays Not Available. |
To view polling frequencies and TCA details, from My Policies, select a policy from the list on the left. Depending on the policy type, the following information is displayed.
Note |
To view the Optical 1 day, Optical 15 mins, and Optical 30 secs parameters, refer to the Monitoring Policies Reference. |
Policy Field |
Description |
---|---|
General Information |
Name, description, creator, status, policy type (Feature Category). For information on the policy types, see How Device Health and Performance Is Monitored: Monitoring Policies. |
Device Selection |
Devices which the policy is monitoring. |
Polling Frequency |
How often Cisco Evolved Programmable Network Manager polls the device parameters. |
Parameters and Thresholds |
Which parameters are polled and their TCA settings, if any. To view the TCA settings, click the arrow next to the parameter name. For more information about viewing the parameters polled by the various policy types, see Check Which Parameters and Counters Are Polled By a Monitoring Policy. |
Check Which Parameters and Counters Are Polled By a Monitoring Policy
Check What Cisco Evolved Programmable Network Manager Is Monitoring explains how to find out which monitoring policies are currently activated. To find out which parameters are being polled by a policy, follow this procedure.
Note |
To view the Optical 1 day, Optical 15 mins, and Optical 30 secs parameters, refer to the Monitoring Policies Reference. |
You can use this procedure to check:
-
Parameters polled by existing policies (regardless of whether a policy is active or inactive).
-
Parameters used by a policy type. This is useful if you want to check what a new policy will poll before creating the policy.
Procedure
Step 1 |
Choose My Policies. The web GUI lists the existing active and inactive monitoring policies. , then choose |
Step 2 |
To check the parameters used by an existing policy:
|
Step 3 |
To check the parameters used by a specific policy type:
|
Policies Pane Pop-Up Window
From the Policies pane in the Monitoring Policies page, you can open a pop-up window that provides summary information and action links for the corresponding policy or policy folder. To open a pop-up window, place your cursor over the appropriate i (information) icon.
-
If you open the pop-up window for a policy, it displays information such as the policy’s type, status, and timestamp for the last time it was updated. From the Actions area, you can click links to edit, delete, or duplicate the policy.
-
If you open the pop-up window for a policy folder, it indicates the folder’s name and the number of policies that belong to it. From the Actions area, you can click links to delete the folder or add a new sub-folder. Note that you can only add and delete folders within My Policies. Also, when user-created folders are in place, you need to specify the destination folder whenever you create a new policy.
Check a Monitoring Policy’s Device, Polling, Threshold, and Alarm Settings
To check a monitoring policy’s threshold and alarm settings:
Procedure
Step 1 |
Choose My Policies. , then choose |
Step 2 |
Select the monitoring policy and click Edit to open the policy details. |
Step 3 |
To find out which devices the policy is monitoring, click the Device Selection drop-down list. Devices that are monitored are indicated with a check mark. To add or remove devices, see Change the Device Set a Policy is Monitoring. |
Step 4 |
To find out the polling interval the policy is using, check the Polling Interval setting. For per-parameter polling, you must expand the individual parameters to see the setting. To adjust the polling settings, see Change the Polling for a Monitoring Policy. Optical policy polling frequencies cannot be changed; they can only be disabled. |
Step 5 |
To find out the thresholds and alarm settings the policy is using, expand the parameter in the Polling and Thresholds area. To change the threshold and alarm settings, see Change Thresholds and Alarm Behavior for a Monitoring Policy. Optical policy thresholds cannot be customized. |
Adjust What Is Being Monitored
To make adjustments to what Cisco Evolved Programmable Network Manager is monitoring, use the guidance in the following table to find the best method for your needs.
If: |
See: |
|
---|---|---|
Cisco Evolved Programmable Network Manager is collecting the data you need, and... |
... you want to change the polling frequency | |
... you want to adjust the alarm behavior |
Change Thresholds and Alarm Behavior for a Monitoring Policy |
|
... you want to adjust which devices are monitored | ||
Cisco Evolved Programmable Network Manager is not collecting the data you need, and... |
... a similar monitoring policy already exists | |
... no similar monitoring policies exist, but one of the policy types contains the parameters you want to monitor |
Create a New Monitoring Policy Using Out-of-the-Box Policy Types |
|
... no similar monitoring policies exist, and none of the policy types contain the parameters you want to monitor |
Create a Monitoring Policy for Unsupported Parameters and Third-Party Devices |
|
... you want it to monitor unsupported or third-party devices |
Create a New Monitoring Policy Based On An Existing Policy
Procedure
Step 1 |
Check what is currently being monitored to verify that you need to create a new policy. See Check What Cisco Evolved Programmable Network Manager Is Monitoring. |
Step 2 |
Create the duplicate.
|
Step 3 |
Make your changes to the duplicate. |
Step 4 |
Click:
|
Create a New Monitoring Policy Using Out-of-the-Box Policy Types
Procedure
Step 1 |
Check what is currently being monitored. See Check What Cisco Evolved Programmable Network Manager Is Monitoring. |
Step 2 |
Choose Add. , then click |
Step 3 |
Select the policy type template you want to use from the Policy Types menu. |
Step 4 |
Configure the new policy:
|
Step 5 |
Click:
|
Create a Monitoring Policy for Unsupported Parameters and Third-Party Devices
You can design custom MIB polling policies to monitor third-party or Cisco devices and device groups. You can also create custom MIB policies to monitor device features, for which Cisco EPN Manager doesn’t provide default policies. Using this feature, you can:
-
Upload the SNMP MIB for the device type, then choose devices and attributes to poll and the polling frequency.
-
Upload a single MIB definition file or a group of MIBs with their dependencies as a ZIP file.
-
Display the results as a line chart or a table.
This feature allows you to easily repeat polling for the same devices and attributes and customize the way Cisco devices are polled using SNMP.
You can create a maximum of 25 custom MIB polling policies.
To create a custom MIB polling policies, follow these steps:
Procedure
Step 1 |
Choose My Policies and click Add. , then choose |
Step 2 |
From the Policy Types menu, select Custom MIB Polling. |
Step 3 |
Enter a name for the policy. |
Step 4 |
Under the MIB Selection tab, specify the polling frequency and enter the MIB information.
|
Step 5 |
To test the policy that you created on a device before activating it, click the Test tab and select a device on which to test the new policy. |
Step 6 |
Click Save and Activate to immediately activate the policy on the devices specified. |
Schedule Custom MIB reports
You can schedule reports to monitor the custom MIB polling policies. This feature enables you to generate reports at intervals for custom MIBs:
To schedule a custom MIB report, follow the steps given below:
Before you begin
Procedure
Step 1 |
Choose Custom MIB Report Jobs. , and choose |
Step 2 |
Click + icon to open Add Custom MIB Report Job window. |
Step 3 |
Enter the Report Name and select the Policy Name. |
Step 4 |
In the Schedule Settings section, select the Start Time and Recurrence intervals for the custom MIB report. |
Step 5 |
Click Save to schedule a custom MIB report. |
Step 6 |
To view the scheduled report and export the data, click the report name (hyperlink), which opens a window with all the reports generated at given intervals. You can click the Generated report can be downloaded here option to export the report data in CSV format. For more information on reports, see Reports Overview. |
Check the Status of Past Monitoring Policy Data Collections
To check a monitoring policy's past data collection:
Procedure
Step 1 |
Choose My Policies. , then click |
Step 2 |
Locate the policy, and under the Collection Status, click Details to open the Collection Data dialog. To see which parameters were polled for a device, hover your mouse over the text in the Parameter column. |
Change the Device Set a Policy is Monitoring
You can customize how often monitoring information is gathered (polling interval). Not all policies have all of these settings; for example, a policy may only collect statistics, so it would not have any thresholds or alarms associated with it.
Procedure
Step 1 |
Choose Monitor > Monitoring Policies > My Policies and select the policy you want to edit. |
Step 2 |
Check the policy you want to edit and click Edit . |
Step 3 |
Click the Device Selection drop-down list. |
Step 4 |
Select and deselect devices as needed. |
Step 5 |
Click Save and Activate to save and activate the policy immediately on the selected devices. |
Change the Polling for a Monitoring Policy
You can customize how often monitoring information is gathered (polling interval). Not all policies have all of these settings; for example, a policy may only collect statistics, so it would not have any thresholds or alarms associated with it.
Procedure
Step 1 |
Choose My Policies. , then click |
Step 2 |
Select the policy you want to edit and click Edit. |
Step 3 |
Adjust the polling frequency. How to adjust polling depends on the monitoring policy type.
To disable polling for all attributes in the policy, deactivate the policy by clicking Save and Deactivate at the bottom of the page. Do not proceed to the next step. |
Step 4 |
Click Save and Activate to save and activate the policy immediately on the selected devices. |
Change Thresholds and Alarm Behavior for a Monitoring Policy
You can customize the threshold value that indicates a problem and whether Cisco Evolved Programmable Network Manager should generate an informational event or an alarm (of any severity) when a problem is detected. Not all policies have all of these settings; for example, a policy may only collect statistics, so it would not have any thresholds or alarms associated with it.
Procedure
Step 1 |
Choose My Policies. , then choose |
||
Step 2 |
Select the policy you want to edit and click Edit. |
||
Step 3 |
Locate the parameter you want to change. You can search for the parameter by entering a string in the Parameter text box. |
||
Step 4 |
Expand the parameter. You can change an existing condition or add new conditions, as in the following figure, which specifies thresholds and alarms for CPU utilization on Cisco ASR 9000 devices.
|
||
Step 5 |
When you are done, click Save and Activate to save and activate the policy immediately on the selected devices. |
Run Performance Tests
When you run a performance test, Cisco EPN Manager connects to the network devices in real time to retrieve the information. Reports, on the other hand, use historical data that is saved in the database. See these topics for more information, depending upon the type of test you want to run:
Cisco EPN Manager also supports running OTDR performance tests on OTS optical links. For more information, see Run an OTDR Performance Test on an OTS Link.
Run an OTDR Performance Test on an OTS Link
An Optical Time Domain Reflectometer (OTDR) test is a graphical signature of a fiber's attenuation along its length which provides insight into the performance of the link components (cable, connectors and splices). It allows remote diagnosis of OTS link related issues (such as degraded devices, splices and bends in the cables).
The OTDR test can be initiated only on OTS links that are connected to the OTDR port in the TNC card.
Note |
For NCS1001 devices, an .xml file with the device specific configuration needs to be added under /opt/CSCOlumos/conf/ncs1k-otdr-ports.xml in case the default xml configuration is varying with the device configuration. Doing so, provides an association/connection between the OTS link associated EDFA line port and the OTDR port. |
Some of the OTDR functions are limited to specific user groups, as described in the table below:
User Group |
Can view OTDR scan results? |
Can run and analyze OTDR scan? |
Can configure OTDR scan? |
Can set baseline? |
|
---|---|---|---|---|---|
Web GUI |
Root |
Yes |
Yes |
Yes |
Yes |
Super Users |
Yes |
Yes |
Yes |
Yes |
|
Admin |
Yes |
Yes |
Yes |
Yes |
|
Config Managers |
Yes |
Yes |
Yes |
Yes |
|
System Monitoring |
Yes |
Yes |
No |
Yes |
The OTDR scan can be accessed from the Actions menu in the Links tables or from the Interface 360 view. The OTDR Scan menu option is only available for links or interfaces on which OTDR is supported.
To run an OTDR scan:
Procedure
Step 1 |
Access the OTDR scan window in one of the following ways:
The OTDR Scan window opens and displays the results of the last scan for this link. |
||
Step 2 |
In the Configure tab, check the OTDR configuration settings on both sides of the link and modify them if necessary. See Configure OTDR Port Values. |
||
Step 3 |
In the Scans tab, click the arrow next to Change Scan Direction to view the direction settings. In the Scan Direction area, the A-side and Z-side of the selected OTS link are represented and you can select the direction in which you want to run the test. |
||
Step 4 |
Under Scan Direction, select the direction of the test by clicking on the relevant arrow. Note that above each direction arrow is information indicating when the last scan for that direction was run or if there are new scans to download. The table displays all system, Baseline & imported scans for the selected direction. You can:
|
||
Step 5 |
Start a new scan in one of the following ways:
You can view the progress of the scan in the Change Scan Direction window. To stop a scan that is in progress, click the Cancel link above the direction arrow in which the scan runs. |
||
Step 6 |
Once the scan is complete,
|
||
Step 7 |
(Optional) Click Set Baseline to set an OTDR test baseline. Setting a baseline helps you to compare with the last scan results. Set Baseline is not supported for NCS1001 devices. |
||
Step 8 |
To export the scan results, see Export the OTDR Scan Results. |
||
Step 9 |
To import the scans, see Import OTDR Scan. |
||
Step 10 |
To schedule the OTDR scan to be run at predefined regular intervals, see Provision OTDR Scan Recurrence. |
Configure OTDR Port Values
For the OTDR scan, you can either use the default settings for the TNCS cards for each sector or you can modify the settings as required.
Procedure
Step 1 |
Access the OTDR scan page as described in the Run an OTDR Performance Test on an OTS Link topic. |
||
Step 2 |
Access the OTDR scan page. |
||
Step 3 |
In the Configure tab, select a device from the Device drop-down list. A table is displayed listing all the sectors with the default values for the following columns:
The OTDR measurement ranges are categorized based on the fiber spans defined for each sector. Following are the OTDR measurement sectors:
|
||
Step 4 |
To modify the OTDR settings on the device, click the Device OTDR Settings hyperlink. For more details on the OTDR settings, see the 'Configuring OTDR Auto Scan' section in Provision Optical Interfaces. |
||
Step 5 |
To edit the sector parameters, select the required Distance Profile in the table, and click Edit. A dialog box is displayed. |
||
Step 6 |
In the dialog box :
To enable absolute threshold, you must select Absolute Fiber Pass Fail Criteria check-box in the OTDR Settings page. |
||
Step 7 |
Click Save. |
Provision OTDR Scan Recurrence
Follow the below procedure to set up OTDR scan recurrence on the selected ports:
Procedure
Step 1 |
In the Configure tab of the OTDR Scan page, from the Device drop-down list, select the port on which you want to provision a recurring scan. |
Step 2 |
Select the appropriate distance profile, and click Edit. A popup window is displayed. |
Step 3 |
In the Recurrence area, set the scan frequency by choosing one of the following: |
Step 4 |
Select the desired day from the on drop-down list and enter the hours and minutes. |
Step 5 |
Select the desired day range between 0 to 365 and enter the hours and minutes. |
Step 6 |
Click Save. |
Export the OTDR Scan Results
You can export the scan results to your local.
Procedure
Step 1 |
Select the scan for which you want to create an export file. |
Step 2 |
Click Export Scans icon. The exported file (.sor format) will be downloaded to your local machine. |
Import OTDR Scan
You can import the scan results from your local.
Procedure
Step 1 |
Click the Import Scans icon. The Import Scan (.sor) window appears. |
Step 2 |
Click on Browse and select the .sor file which you require to import. |
Step 3 |
Select a Distance Profile from the drop down list. |
Step 4 |
Select the Scan Direction by clicking on the desired line which shows the direction. |
Step 5 |
Click Import. |
View OTDR Scan Results in the Geo Map
You can view the OTDR scan results in the context of the geo map in order to pinpoint the location of the fiber issues. For example, if the OTDR test reports a concentrated loss 20 km from the link endpoint, you can visualize on the map where this is geographically located.
Prerequisites:
-
KML file containing fiber data and coordinates must be imported so that the fibers are visible on the geo map. See Import Location Data from a KML File.
-
The OTS link on which the OTDR scan is run must be associated with a fiber. See Associate Links to Fibers.
-
The A- and Z-side devices must be mapped on the geo map. See Place Unmapped Devices on the Geo Map.
Procedure
Command or Action | Purpose | |||
---|---|---|---|---|
Step 1 |
Launch the OTDR scan. |
|||
Step 2 |
Define the scan parameters and run the scan. |
|||
Step 3 |
Click View on Geo Map. |
|
||
Step 4 |
Click on a point in the OTDR scan results graph. |
|
||
Step 5 |
If necessary, click on the OTDR link below the OTDR scan results graph to return to the OTDR scan page. |
Monitor Network Performance Using Reports
Cisco Evolved Programmable Network Manager provides various reports to help you monitor your network's performance. The following are some examples:
-
Environmental temperature, CPU, and memory utilization
-
Interface errors and discards
-
For Carrier Ethernet devices—IPSLA Ethernet OAM, PWE3, QoS, and other CE reports
-
For Optical devices—Ethernet, OTN, SDH/SONET, and other optical reports
When you run a performance report, retrieves historical data that has been saved in the database. Reports can only display data that Cisco Evolved Programmable Network Manager has been configured to collect—in other words, data that are collected and monitored using monitoring policies. (No monitoring policies have to be enabled for event and alarm-related reports; that data is collected automatically.) For information on which monitoring policies must be enabled for the different reports, see Available Reports.
Note |
Sometimes, while generating the report, the last sample may get omitted. This happens when the sample is inserted into DB after the report generation time. To avoid this, define an offset for any report by editing the file: /opt/CSCOlumos/conf/ReportExportSettings.properties |