User Guide for CiscoWorks QoS Policy Manager 3.2
Reports Tab Reference

Table Of Contents

Reports Tab Reference

IP Telephony

Voice Ready Report Page

Upload

Upload Reports Page

Upload Report

Analysis

Historical Monitoring Tasks Page

Historical Monitoring Task Wizard

Monitoring Task Wizard - Task Definition Page

Monitoring Task Wizard - Select Devices Page

Monitoring Task Wizard - Select Interfaces Page

Monitoring Task Wizard - Select Policies Page

Monitoring Task Wizard - Summary Page

Historical Reports Pages

Policies Graphs: Matching and Dropped Traffic for Policies Page

Filters Graphs: Matching Traffic for Filter Conditions Page

Actions Graphs: Policy Actions on Matching Traffic Page

Real-Time Monitoring Tasks Page

Real-Time Monitoring Wizard

Real-Time Monitoring Wizard - Device Selection Page

Real-Time Monitoring Wizard - Interface Selection Page

QoS Policy Manager - Real Time Report Window

Import Policy Groups

Import Policy Groups Reports Page

Import Report

Conflicts

FRTS Conflicts - Subinterfaces Page

FRTS Conflicts - DLCIs Page

Assignment Conflicts Reports Page

Assignment Conflicts Report

Verify Device Configuration Page

Job Verification Details Page

Device Configuration Verification Wizard

Device Configuration Verification Wizard - Deployment Group Selection Page

Device Configuration Verification Wizard - Device Selection and Preview Page

Device Configuration Verification Wizard - Summary Page

Restore

Restore Reports Page


Reports Tab Reference


The following topics describe the pages in the Reports tab. Topics are organized according to the following Reports tab options:

IP Telephony

Upload

Analysis

Import Policy Groups

Conflicts

Restore

IP Telephony

The Voice Ready Report Page topic describes the fields in the page that is accessed from the IP Telephony option:

Voice Ready Report Page

Use this page to view a report showing the readiness of the network for voice configuration. The report displays all the configurable and nonconfigurable devices in the current device group and deployment group.

To open this page, select Reports > IP Telephony.

Table D-1 Voice Ready Report Page 

Field
Description

Sys Name

Displays the system name of the device.

Click the Sys Name link for a device in the table to view details about the device. The Device Properties page appears for the selected device.

Primary Name

Displays the main IP address of the device.

Model

Displays the device model.

OS

Displays the version of the operating system on the device.

Mapped OS

Displays the mapped OS version that QPM assigned to the device.

Voice Status

Displays a check mark if the device is configured for voice. If the device is not configurable for voice, the field will remain blank.

Reason

Displays an explanation of why the device is not configurable for voice.


Related Topics

Viewing and Editing Device Properties, page 4-15

Viewing the Voice Ready Report, page 5-25

Using QPM Tables, page 3-8

Upload

The following topics describe the fields in the pages that are accessed from the Upload option:

Upload Reports Page

Upload Report

Upload Reports Page

Use this page to select a report displaying the status of the process of uploading QoS configurations to QPM.

To open this page, do any of the following:

Select Reports > Upload.

Click View in the dialog box that opens after the Upload process starts.

Table D-2 Upload Reports Page 

Field
Description

Start Date

Displays the date and time the upload process started.

Complete Date

Displays the date and time the upload process completed.

User Name

Displays the name of the user who ran the upload task.

Status

Displays the status of the upload process:

In progress—Upload process is in progress. You cannot view the Upload report if the status is In progress.

Completed—The Upload process has completed. You can view the Upload report.

Failed—QPM could not complete the upload process. The upload report displays the error.

View button

Click to view the Upload report with details of the selected upload task. See Upload Report for details.

Delete button

Click to delete the selected upload report.

Refresh Rate

Select the rate at which the page refreshes with updated information.


Related Topics

Uploading Device QoS Configurations to Policy Groups, page 6-17

Upload Report

The Upload report displays general information for the report, and for each uploaded device, the following two tables:

Errors and warnings—Displays details about the information, warning, and error messages generated by the upload process.

Uploaded policies—Displays information about the policy groups created by the upload process.

To open the Upload report, in the Upload Reports page, select an upload task and click View, or click on the Start Date link of the required report.

Table D-3 Upload Report - General Information 

Field
Description

User Name

Displays the name of the user who ran the upload task.

Start Date

Displays the date and time the upload process started. Click to open the report for the corresponding upload task.

Complete Date

Displays the date and time the upload process completed.

Report Type

Displays the type of report—Upload.

Report Description

Displays the description of the report.


Table D-4 Upload Report - Errors and Warnings 

Field
Description

#

Displays the error number.

Network Element

Displays the type of network element to which the error applies, if relevant.

Severity

Displays the severity of the error or warning.

Information—General information or information about a successfully uploaded configuration.

Warning—Generated for the following:

Settings which might have affected the upload operation.

Configuration uploaded without unsupported parameters, or with changes.

Failure—Policy not uploaded because of empty, missing, or unsupported CLI.

Internal Error—Generated when there is an internal exception.

QoS Feature

Displays the QoS feature to which the error applies.

Message

Displays the error message.

CLI Configuration

Displays the CLI command to which the message applies, if relevant.


Table D-5 Upload Report - Uploaded Policies 

Field
Description

#

Displays the line number in the report table.

Policy Group Name

Displays the name of the policy groups.

Network Elements

Displays the network elements assigned to each policy group.

QoS Properties

Displays the number of QoS properties defined for each policy group.

In Policies

Displays the number of inbound policies for each policy group.

Out Policies

Displays the number of outbound policies for each policy group.


Related Topics

Upload Reports Page

Analysis

The following topics describe the fields in the pages that are accessed from the Analysis option:

Historical Monitoring Tasks Page

Historical Monitoring Task Wizard

Historical Reports Pages

Real-Time Monitoring Tasks Page

Real-Time Monitoring Wizard

QoS Policy Manager - Real Time Report Window

Historical Monitoring Tasks Page

Historical monitoring tasks collect data for historical monitoring reports.

Use this page to:

View historical monitoring reports.

View, create, edit, delete, and stop historical monitoring tasks.

Export collected data from tasks.

To open this page, select Reports > Analysis.

When the historical QoS analysis data collected by QPM reaches the configured disk space limit, the following happens:

All running monitoring tasks are stopped automatically, and are set to the status Stopped due to out of disk space.

The next time you open the Historical Monitoring Tasks page, a message notifies you that the disk space limit was reached and provides recover instructions.

This message only appears on the Historical Monitoring Tasks page. You will not receive notification that the disk space limit was reached until you open this page.

All data collected before the tasks were stopped is available for display in reports. To free the necessary disk space and continue monitoring, you must delete the stopped tasks and run the database rebuild utility. Then you can recreate the deleted tasks to resume running them.

For instructions for recovering from running out of analysis disk space, see Freeing Disk Space for QoS Analysis, page 9-18.

Table D-6 Historical Monitoring Tasks Page 

Field
Description

Check box column

Select check box to select its row.

Name

Displays the task name.

Description

Displays the task description.

Status

Displays the task status. The following are the possible statuses:

Processing—The initial status for tasks, indicating the task is being created.

Running—Task is running correctly and collecting data.

Stopped—Task was stopped by user request.

Stopped due to disk space limit—The amount of collected data reached the configured disk space limit.

Collector Error—Task could not be created because of a data collection error.

In Edit—The task is disabled, and has not started yet.

Finished—The task successfully finished. It will not collect any more data.

View report button

Click to view a report of the selected task. The Matching and Dropped Traffic for Policies page appears.

Create button

Click to create a new task. The Task Definition page appears.

Edit button

Click to edit a task that is in an error status. The Task Definition page appears.

You can edit tasks in the following statuses:

Processing—QPM is processing the task. Refresh the page until the status changes.

Collector Error

In Edit

Delete button

Click to delete the selected task. A confirmation dialog box opens.

Stop button

Click to stop a running task.

Export Data button

Click to export a task's collected monitoring data to a zip file that contains a set of XML data files. The browser file download process starts.

Ensure that you have the unzip application recreate the folder structure of the zipped files when unzipping them. Each interface has a separate folder. Within each folder is a separate file for each policy defined on the interface.

Refresh Rate

Select a page refresh rate from the list. The refresh rate determines how often the page refreshes with updated information.


Historical Monitoring Task Wizard

Use the Historical Monitoring Task wizard to create and edit historical monitoring tasks.

The Historical Monitoring Task wizard contains the following pages:

Monitoring Task Wizard - Task Definition Page

Monitoring Task Wizard - Select Devices Page

Monitoring Task Wizard - Select Interfaces Page

Monitoring Task Wizard - Select Policies Page

Monitoring Task Wizard - Summary Page

Monitoring Task Wizard - Task Definition Page

Use this page to define basic properties of the historical monitoring task.

To open this page, select Reports > Analysis. The Historical Monitoring Tasks page appears. Then do one of the following:

To create a new task, click Create.

To edit a task that is in an error status, select the check box next to the task name, then click Edit.

Table D-7 Monitoring Task Wizard - Task Definition Page 

Field
Description

Name

Enter a task name. Valid characters are alphanumeric, space, hyphen, and underscore.

Polling Interval

Select a polling interval, which is the frequency at which the task will poll data, in minutes.

Start Time and End Time

Enter task start and end times using the date and time fields. Optionally, select the calendar tool to select a date. Enter dates in mm/dd/yyyy format. Enter times in 24-hour format (for example, 06:00 is 6:00 a.m.).

Each task has a maximum running duration that is based on the polling interval you select. These duration limits are listed in Performing Historical QoS Analysis, page 9-7.

You cannot configure an end time that exceeds the maximum running duration of the polling interval you have selected.

Enabled

Select to enable the job immediately after finishing the task definition. Deselect to disable the task.

The task will not begin collecting data until the configured start time, regardless of the status of the Enabled check box. If the Enabled check box is not selected, the task will not begin collecting data, even if the configured start time passes.

Enter a comment or description

Enter a description of the task or a comment about it.

Back button

Click to return to the previous step.

Next button

Click to proceed to the next step.

Cancel button

Click to cancel task creation and exit the wizard.


Monitoring Task Wizard - Select Devices Page

Use this page to select the devices that contain the interfaces that you want to monitor.

Only devices that can be monitored are listed. Although QPM might support the creation and deployment of policies to a device, that device might not collect sufficient data for QPM to monitor QoS on the device, or you might not have create supported policy types on any of the device's interfaces.

To open this page, do one of the following:

Click Next in the Monitoring Task Wizard - Task Definition Page.

Select Select Interfaces from the wizard Navigation list.

Table D-8 Monitoring Task Wizard - Select Devices Page 

Field
Description

Check box column

Select the check box to select its row.

Sys Name

Displays the device's sys name.

IP Address

Displays the device's IP address.

Model

Displays the device's model.

OS Version

Displays the device's OS version.

Mapped OS Version

Displays the mapped OS version that QPM assigned to the device.

Back button

Click to return to the previous step.

Next button

Click to proceed to the next step.

Cancel button

Click to cancel task creation and exit the wizard.


Monitoring Task Wizard - Select Interfaces Page

Use this page to select the interfaces that you want to monitor.

To open this page, do one of the following:

Click Next in the Monitoring Task Wizard - Select Devices Page.

Select Select Interfaces from the wizard Navigation list.

Table D-9 Monitoring Task Wizard - Select Interfaces Page 

Field
Description

Check box column

Select the check box to select its row.

Device Name

Displays the name of the device.

Interface Name

Displays the interface name.

Interface Type

Displays the interface type.

Interface Description

Displays the interface description.

Back button

Click to return to the previous step.

Next button

Click to proceed to the next step.

Cancel button

Click to cancel task creation and exit the wizard.


Monitoring Task Wizard - Select Policies Page

Use this page to select the policies that you want to monitor. Do not select more than 12 policies, and do not select policies that have more than 12 match statements per policy filter.

To open this page, do either of the following:

Click Next in the Monitoring Task Wizard - Select Interfaces Page.

Select Select Policies from the wizard Navigation list.

Table D-10 Monitoring Task Wizard - Select Policies Page 

Field
Description

Check box column

Select the check box to select its row.

Device Name

Displays the device's name.

Interface Name

Displays the interface name.

Policy Group Name

Displays the policy group name.

Policy Name

Displays the policy name.

Direction

Displays the direction of the policy (in or out).

Policy Description

Displays the policy description.

Back button

Click to return to the previous step.

Next button

Click to proceed to the next step.

Cancel button

Click to cancel task creation and exit the wizard.


Monitoring Task Wizard - Summary Page

Use this page to view a summary of the monitoring task and determine whether to edit, finish, or cancel it.

To open this page, do either of the following:

Click Next in the Monitoring Task Wizard - Select Policies Page.

Select Summary from the wizard Navigation list.

Table D-11 Monitoring Task Wizard - Summary Page 

Field
Description

Name

Displays task name.

Collector

Displays the agent that is collecting data.

Polling Interval(min)

Displays the task polling interval in minutes.

Start Time

Displays the task start time.

End Time

Displays the task end time.

Enabled

Indicates whether the job is enabled.

Description

Displays the task description.

Selected Interfaces and Policies

Displays a list of the interfaces and policies you have selected to monitor.

Back button

Click to return to the previous step.

Next button

Click to proceed to the next step.

Finish button

Click to finish the wizard and create the task.

Cancel button

Click to cancel task creation and exit the wizard.


Historical Reports Pages

The following pages are accessible by launching a historical monitoring report:

Policies Graphs: Matching and Dropped Traffic for Policies Page

Filters Graphs: Matching Traffic for Filter Conditions Page

Actions Graphs: Policy Actions on Matching Traffic Page

The historical policy analysis graphs do not show the effect of traffic dropping for reasons other than QoS policy actions, such as dropping because of full queues.

Therefore, it is possible that the traffic volume shown for an interface will be greater than the capacity of the interface. In this case, if you set the vertical axis to percentage, the traffic volume for the interface will exceed 100% of the interface's capacity.

Policies Graphs: Matching and Dropped Traffic for Policies Page

Use this page to view data that shows how much traffic matched the policies and whether it was transmitted or dropped. You can customize the page with the customization controls.

To open this page, do either of the following:

Click View Report in the Historical Monitoring Tasks Page.

Click Policies Graphs in any historical monitoring report page.

You will not see data on the historical graphs immediately after the task starts. Depending on when you start the task, the length of the polling interval, and how many other tasks are being run concurrently, it can take up to several hours to see graphed data. This is because of the way in which QPM collects the data and writes it to the QPM database.

To see any data in the graphs, your task must include at least three polling periods.

For example, if you use a polling period of 30 minutes, and run the task for only one hour, you will not see any graphed data for the task. If you need to see data immediately, as it is collected, use real-time monitoring.

If a device is not successfully polled (for example, when a device is unreachable), a red triangle appears along the X axis at the point where the device data could not be collected.

The graph uses the last collected data values in the graph, which will appear as straight lines until the device is successfully polled. For bar graphs, a red triangle indicates there was at least one unsuccessful polling period in the bar.

Table D-12 Policies Graphs - Matching and Dropped Traffic for Policies Page 

Field
Description

Graph Type

Select the graph type to display:

Line—Presents data in a line chart format.

Bar—Presents data in a bar chart format.

Units

Select the units to display in the graphs:

Packets/second—Displays data flow rates in packets per second.

Bits/second—Displays data flow rates in bits per second.

Vertical Axis

Select the vertical scale for graphs:

Linear—Displays the vertical scale of charts in linear format (the distance between units remains constant).

Logarithmic—Displays the vertical scale of charts in logarithmic format (the distance between units gets smaller as the total gets higher).

Percentage—Displays the vertical scale of charts as a percentage of the total bandwidth available on the interface.

Group

Select how to group the objects that are displayed in the graphs:

Policy—Organizes the report according to policy groups.

Interface—Organizes the report according to interfaces.

From Time and To Time

Select the period of time you want to view in the report:

Enter dates in the first From Time and To Time fields in the format mm/dd/yyyy, or click the calendar icons to select dates from the Calendar dialog box.

Enter times in the second From Time and To Time fields in 24-hour format.

Apply button

Click to view only data collected during the period defined by the From Time and To Time controls.

Reset button

Click to reset the time period displayed in the From Time and To time controls to the collection period defined for the analysis task.

Policy/Interface selection table

Select which policies or interfaces (depending on the selection in the Group list box) to display in the report by selecting the check box next to the policies or interfaces you want to view in the right pane of the report, then click Show Graphs.

Show Graphs button

Click to update the graphs to display the policies and interfaces selected using the policy-interface selection table

Matching Traffic Per Class Prior to QoS Actions graphs

Displays the traffic that matched each policy group's filters, before any policy actions were performed.

This data is obtained from the cbQosCMPrePolicyPkt and cbQosCMPrePolicyByte MIB variables.

Matching Traffic Per Class After QoS Actions

Displays the traffic that matched each policy group's filters and was transmitted (not dropped) by the configured QoS policies.

This data is obtained as follows:

The bits data is obtained from the cbQosCMPostPolicyByte MIB variable.

The packets data is obtained by subtracting the cbQosCMDropPkt MIB variable from the cbQosCMPrePolicyPkt MIB variable.

Matching Traffic Per Class Discarded by QoS Drop Actions

Displays the traffic that matched each policy group's filters and was dropped (not transmitted) by QoS policy drop actions.

This data is obtained from the cbQosCMDropPkt and cbQosCMDropByte MIB variables.

Policies Graphs button

Click to open the Policies Graphs: Matching and Dropped Traffic for Policies Page.

Filters Graphs button

Click to open the Filters Graphs: Matching Traffic for Filter Conditions Page

Actions Graphs button

Click to open the Actions Graphs: Policy Actions on Matching Traffic Page

Back to Task List button

Click to open the Historical Monitoring Tasks Page.


Filters Graphs: Matching Traffic for Filter Conditions Page

Use this page to view data that shows how matching traffic was distributed among the policy filter conditions. You can customize the page with the customization controls.

To open this page, click Filters Graphs in any historical monitoring report page.

You will not see data on the historical graphs immediately after the task starts. Depending on when you start the task, the length of the polling interval, and how many other tasks are being run concurrently, it can take up to several hours to see graphed data. This is because of the way in which QPM collects the data and writes it to the QPM database.

To see any data in the graphs, your task must include at least three polling periods.

For example, if you use a polling period of 30 minutes, and run the task for only one hour, you will not see any graphed data for the task. If you need to see data immediately, as it is collected, use real-time monitoring.

If a device is not successfully polled (for example, when a device is unreachable), a red triangle appears along the X axis at the point where the device data could not be collected.

The graph uses the last collected data values in the graph, which will appear as straight lines until the device is successfully polled. For bar graphs, a red triangle indicates there was at least one unsuccessful polling period in the bar.

Table D-13 Filters Graphs - Matching Traffic for Filter Conditions Page 

Field
Description

Graph Type

Select the graph type to display:

Line—Presents data in a line chart format.

Bar—Presents data in a bar chart format.

Units

Select the units to display in the graphs:

Packets/second—Displays data flow rates in packets per second.

Bits/second—Displays data flow rates in bits per second.

Vertical Axis

Select the vertical scale for graphs:

Linear—Displays the vertical scale of charts in linear format (the distance between units remains constant).

Logarithmic—Displays the vertical scale of charts in logarithmic format (the distance between units gets smaller as the total gets higher).

Percentage—Displays the vertical scale of charts as a percentage of the total bandwidth available on the interface.

Group

Select how to group the objects that are displayed in the graphs:

Policy—Organizes the report according to policy groups.

Interface—Organizes the report according to interfaces.

From Time and To Time

Select the period of time you want to view in the report:

Enter dates in the first From Time and To Time fields in the format mm/dd/yyyy, or click the calendar icons to select dates from the Calendar dialog box.

Enter times in the second From Time and To Time fields in 24-hour format.

Apply button

Click to view only data collected during the period defined by the From Time and To Time controls.

Reset button

Click to reset the time period displayed in the From Time and To time controls to the collection period defined for the analysis task.

Filters graphs

Displays how much traffic in each class matched each of the class' filters.

Each graph includes a legend that shows the time period represented by each point on the poll time (horizontal) axis.

The correlation between the filters shown in this graph and the filter rules configured in the policy is not exact.

Whenever possible, QPM translates the filter rules configured in QPM to modular CLI match statements. However, there are cases in which only ACL translation can reflect the filter definition

This results in multiple filter rules being combined into one match statement (rules combined by OR become separate match statements. Rules combined by AND are combined into one match statement).

This data is obtained from the cbQosMatchPrePolicyPkt and cbQosMatchPrePolicyByte MIB variables.

Policies Graphs button

Click to open the Policies Graphs: Matching and Dropped Traffic for Policies Page.

Filters Graphs button

Click to open the Filters Graphs: Matching Traffic for Filter Conditions Page

Actions Graphs button

Click to open the Actions Graphs: Policy Actions on Matching Traffic Page

Back to Task List button

Click to open the Historical Monitoring Tasks Page.


Actions Graphs: Policy Actions on Matching Traffic Page

Use this page to view data that shows the policy actions that were taken on matching traffic. You can customize the page with the customization controls.

To open this page, click Actions Graphs in any historical monitoring report page.

You will not see data on the historical graphs immediately after the task starts. Depending on when you start the task, the length of the polling interval, and how many other tasks are being run concurrently, it can take up to several hours to see graphed data. This is because of the way in which QPM collects the data and writes it to the QPM database.

To see any data in the graphs, your task must include at least three polling periods. For example, if you use a polling period of 30 minutes, and run the task for only one hour, you will not see any graphed data for the task. If you need to see data immediately, as it is collected, use real-time monitoring.

If a device is not successfully polled (for example, when a device is unreachable), a red triangle appears along the X axis at the point where the device data could not be collected.

The graph uses the last collected data values in the graph, which will appear as straight lines until the device is successfully polled. For bar graphs, a red triangle indicates there was at least one unsuccessful polling period in the bar.

Table D-14 Actions Graphs - Policy Actions on Matching Traffic Page 

Field
Description

Graph Type

Select the graph type to display:

Line—Presents data in a line chart format.

Bar—Presents data in a bar chart format.

Units

Select the units to display in the graphs:

Packets/second—Displays data flow rates in packets per second.

Bits/second—Displays data flow rates in bits per second.

Vertical Axis

Select the vertical scale for graphs:

Linear—Displays the vertical scale of charts in linear format (the distance between units remains constant).

Logarithmic—Displays the vertical scale of charts in logarithmic format (the distance between units gets smaller as the total gets higher).

Percentage—Displays the vertical scale of charts as a percentage of the total bandwidth available on the interface.

Group

Select how to group the objects that are displayed in the graphs:

Policy—Organizes the report according to policy groups.

Interface—Organizes the report according to interfaces.

From Time and To Time

Select the period of time you want to view in the report:

Enter dates in the first From Time and To Time fields in the format mm/dd/yyyy, or click the calendar icons to select dates from the Calendar dialog box.

Enter times in the second From Time and To Time fields in 24-hour format.

Apply button

Click to view only data collected during the period defined by the From Time and To Time controls.

Reset button

Click to reset the time period displayed in the From Time and To time controls to the collection period defined for the analysis task.

Policy Actions graphs

See Policy Actions Graphs.

Policies Graphs button

Click to open the Policies Graphs: Matching and Dropped Traffic for Policies Page.

Filters Graphs button

Click to open the Filters Graphs: Matching Traffic for Filter Conditions Page

Actions Graphs button

Click to open the Actions Graphs: Policy Actions on Matching Traffic Page

Back to Task List button

Click to open the Historical Monitoring Tasks Page.


Policy Actions Graphs

Policy actions graphs display information about traffic that was dropped because of policy actions. Only actions that are configured in a policy will appear in this page.

For example, if a policy has queuing and policing actions assigned, only actions graphs for queuing and policing will appear.

The following actions can appear in the graphs:

Policing—Displays the following traffic amounts:

Conformed—Traffic conformed to rate limit.

This data is obtained from the cbQosPoliceConformedPkt and cbQosPoliceConformedByte MIB variables.

Exceeded—Traffic exceeded rate limit.

This data is obtained from the cbQosPoliceExceededPkt and cbQosPoliceExceededByte MIB variables.

Violated—Traffic violated rate limit.

This data is obtained from the cbQosPoliceViolatedPkt and cbQosPoliceViolatedByte MIB variables.

Queuing—Displays the amount of traffic dropped due to queuing.

This data is obtained from the cbQosQueueingDiscardByte and cbQosQueueingDiscardPkt MIB variables.

WRED—Displays counts of the following per precedence level:

Random drop—Traffic exceeded minimum but was less than maximum count.

This data is obtained from the cbQosREDRandomDropPkt and cbQosREDRandomDropByte MIB variables.

Tail drop—Traffic exceeded maximum count.

This data is obtained from the cbQosREDTailDropPkt and cbQosREDTailDropByte MIB variables.

Transmit counter—Traffic was transmitted.

This data is obtained from the cbQosREDTransmitPkt and cbQosREDTransmitByte MIB variables.

Traffic Shaping—Displays counts of the following:

Delayed traffic.

This data is obtained from the cbQosTSStatsDelayedByte and cbQosTSStatsDelayedPkt MIB variables.

Traffic drop due to traffic shaping.

This data is obtained from the cbQosTSStatsDropByte and cbQosTSStatsDropPkt MIB variables.

CAR action (non-modular QoS)—Displays counts of the following:

Bytes/packets that conformed to rate limit.

Packets/bytes that exceeded rate limit.

Real-Time Monitoring Tasks Page

Real-time tasks define the data to display in a real-time monitoring report.

Use this page to:

View real-time monitoring reports.

View, create, edit, and delete real-time monitoring tasks.

To open this page, select Reports > Analysis, then select Real-Time from the TOC.

Table D-15 Real-Time Monitoring Tasks Page 

Field
Description

Check box column

Select check box to select its row.

Name

Displays task name.

Description

Displays task description.

Status

Displays task status. The only status that will appear is Ready to run, which indicates that the task is ready to run.

Run button

Click to run the selected task's report. A QoS Policy Manager - Real-Time Report window appears.

You can run multiple real-time monitoring reports at the same time. Each report appears in a separate report window.

Create button

Click to create a new task. The Real Time Monitoring Wizard - Device Selection page appears.

Edit button

Click to edit the selected task. The Real Time Monitoring Wizard - Device Selection page appears.

Delete button

Click to delete the selected task. A confirmation dialog box opens.

Refresh Rate

Select a page refresh rate from the list. The refresh rate determines how often the page refreshes with updated information.


Real-Time Monitoring Wizard

Use the Real-Time Monitoring wizard to create and edit historical monitoring tasks.

The Real-Time Monitoring wizard contains the following pages:

Real-Time Monitoring Wizard - Device Selection Page

Real-Time Monitoring Wizard - Interface Selection Page

Real-Time Monitoring Wizard - Device Selection Page

Use this page to define basic properties of the real-time monitoring task and select the device that contains the interface to monitor.

To open this page, select Reports > Analysis, then select Real-Time from the TOC. The Real-Time Monitoring Tasks page appears. Then do one of the following:

To create a new task, click Create.

To edit a task, select the check box next to the task name, then click Edit.

Table D-16 Real-Time Monitoring Wizard - Device Selection Page 

Field
Description

Name

Enter a task name.

Polling Interval

Select a polling interval, which is the frequency at which the task will poll data, in minutes.

Radio button column

Select a radio button to select its row.

Sys Name

Displays the device's sys name.

IP Address

Displays the device's IP address.

Model

Displays the device model.

OS Version

Displays the device's OS version.

Mapped OS Version

Displays the mapped OS version that QPM assigned to the device.

Device Folder

The QPM device folder that contains the device.

Enter a comment or description

Enter a description of the task or a comment about it.

Next button

Click to proceed to the next step.

Cancel button

Click to cancel task creation and exit the wizard.


Real-Time Monitoring Wizard - Interface Selection Page

Use this page to select the interface that the task will monitor.

To open this page, click Next in the Real-Time Monitoring Wizard - Device Selection Page.

Table D-17 Real-Time Monitoring Wizard - Interface Selection Page 

Field
Description

Radio button column

Select a radio button to select its row.

Interface Name

Displays the interface name.

Interface Type

Displays the interface type.

Interface Description

Displays the interface description.

Back button

Click to return to the previous step.

Finish button

Click to finish the wizard and create the task. The task's report appears in the QoS Policy Manager - Real Time Report window.

Cancel button

Click to cancel task creation and exit the wizard.


QoS Policy Manager - Real Time Report Window

Use this window to view a real-time monitoring report.

To open this window, click Run in the Real-Time Monitoring Tasks Page.

The real-time policy analysis graphs do not show the effect of traffic dropping for reasons other than QoS policy actions, such as dropping because of full queues.

Therefore, it is possible that the traffic volume shown for an interface will be greater than the capacity of the interface. In this case, if you set the vertical axis to percentage, the traffic volume for the interface will exceed 100% of the interface's capacity.

If a device is not successfully polled (for example, when a device is unreachable), a red triangle appears along the X axis at the point where the device data could not be collected.

The graph uses the last collected data values in the graph, which will appear as straight lines until the device is successfully polled. For bar graphs, a red triangle indicates there was at least one unsuccessful polling period in the bar.

Table D-18 QoS Policy Manager - Real Time Report Window 

Field
Description

Graph Type

Select the graph type to display:

Line—Presents data in a line chart format.

Bar—Presents data in a bar chart format.

Units

Select the units to display in the graphs:

Packets/second—Displays data flow rates in packets per second.

Bits/second—Displays data flow rates in bits per second.

Vertical Axis

Select the vertical scale for graphs:

Linear—Displays the vertical scale of charts in linear format (the distance between units remains constant).

Logarithmic—Displays the vertical scale of charts in logarithmic format (the distance between units gets smaller as the total gets higher).

Percentage—Displays the vertical scale of charts as a percentage of the total bandwidth available on the interface.

Task Name

Displays the name of the task.

Task Start Time

Displays the start time of the task (when the report was run).

Device

Displays the IP address of the device that is monitored in the report.

Interface

Displays the interface name of the interface that is monitored in the report.

Actual Polling Interval

Displays the polling interval at which the task polls for data.

This interval might be different than the polling interval configured for the task. If QPM is not able to poll at the interval configured for the task (for example, because of network congestion), it will determine the shortest interval at which it can poll, which is displayed in this field.

Policy selection controls

To select which policies to display in the report, select the check box next to the policies you want to view in the right pane of the report, then click Show Graphs.

Show Graphs button

Click to display only the policies selected in the policy selection controls.

Close Window button

Click to close report window.

Matching Traffic for Policies graph

Displays the traffic that matched each policy group's filters, before any policy actions were performed.

This data is obtained from the cbQosCMPrePolicyPkt and cbQosCMPrePolicyByte MIB variables.

Matching Traffic Per Class After QoS Actions graph

Displays the traffic that matched each policy group's filters and was transmitted (not dropped) by the configured QoS policies.

This data is obtained as follows:

The bits data is obtained from the cbQosCMPostPolicyByte MIB variable.

The packets data is obtained by subtracting the cbQosCMDropPkt MIB variable from the cbQosCMPrePolicyPkt MIB variable.

Per Class Traffic Discarded By All QoS Drop Actions graph

Displays the traffic that matched each policy group's filters and was dropped (not transmitted) by QoS policy drop actions.

This data is obtained from the cbQosCMDropPkt and cbQosCMDropByte MIB variables.

Filters graphs

Displays how much traffic in each class matched each of the class' filters.

Each graph includes a legend that shows the time period represented by each point on the poll time (horizontal) axis.

The correlation between the filters shown in this graph and the filter rules configured in the policy is not exact. Whenever possible, QPM translates the filter rules configured in QPM to modular CLI match statements.

However, there are cases in which only ACL translation can reflect the filter definition

This results in multiple filter rules being combined into one match statement (rules combined by OR become separate match statements. Rules combined by AND are combined into one match statement).

This data is obtained from the cbQosMatchPrePolicyPkt and cbQosMatchPrePolicyByte MIB variables.

Actions graphs

See Policy Actions Graphs.


Policy Actions Graphs

Policy actions graphs display information about the effect of policy actions. Only actions that are configured in a policy will appear in this page.

For example, if a policy has queuing and policing actions assigned, only actions graphs for queuing and policing will appear.

The following actions can appear in the graphs:

Policing—Displays the following traffic amounts:

Conformed—Traffic conformed to rate limit.

This data is obtained from the cbQosPoliceConformedPkt and cbQosPoliceConformedByte MIB variables.

Exceeded—Traffic exceeded rate limit.

This data is obtained from the cbQosPoliceExceededPkt and cbQosPoliceExceededByte MIB variables.

Violated—Traffic violated rate limit.

This data is obtained from the cbQosPoliceViolatedPkt and cbQosPoliceViolatedByte MIB variables.

Queuing—Displays the amount of traffic dropped due to queuing.

This data is obtained from the cbQosQueueingDiscardByte and cbQosQueueingDiscardPkt MIB variables.

WRED—Displays counts of the following per precedence level:

Random drop—Traffic exceeded minimum but was less than maximum count.

This data is obtained from the cbQosREDRandomDropPkt and cbQosREDRandomDropByte MIB variables.

Tail drop—Traffic exceeded maximum count.

This data is obtained from the cbQosREDTailDropPkt and cbQosREDTailDropByte MIB variables.

Transmit counter—Traffic was transmitted.

This data is obtained from the cbQosREDTransmitPkt and cbQosREDTransmitByte MIB variables.

Traffic Shaping—Displays counts of the following:

Delayed traffic.

This data is obtained from the cbQosTSStatsDelayedByte and cbQosTSStatsDelayedPkt MIB variables.

Traffic drop due to traffic shaping.

This data is obtained from the cbQosTSStatsDropByte and cbQosTSStatsDropPkt MIB variables.

CAR action (non modular QoS)—Displays counts of the following:

Bytes/packets that conformed to rate limit.

Packets/bytes that exceeded rate limit.

Import Policy Groups

The following topics describe the fields in the pages that are accessed from the Import Policy Groups option:

Import Policy Groups Reports Page

Import Report

Import Policy Groups Reports Page

Use this page to select a report displaying the status of the process of importing policies from a QPM 2.1.x export file. The QPM 2.1.x export file contains policy database information in XML format. QoS configurations to QPM.

To open this page, do any of the following:

Select Reports > Import Policy Groups.

Click View in the dialog box that opens after the Import process starts.

Table D-19 Import Policy Groups Report Page 

Field
Description

Start Date

Displays the date and time the import process started.

Complete Date

Displays the date and time the import process completed.

User Name

Displays the name of the user who ran the import task.

Status

Displays the status of the import process:

In progress—Import process is in progress. You cannot view the Import report if the status is In progress.

Completed—The import process has completed. You can view the Import report.

Failed—QPM could not complete the import process. The import report displays the error.

View button

Click to view the Import report with details of the selected import task. See Import Report for details.

Delete button

Click to delete the selected import report.

Refresh Rate

Select the rate at which the page refreshes with updated information.


Related Topics

Importing Policies from QPM 2.1.x, page 10-13

Import Report

The Import report displays general information for the report, and the following two tables:

Errors and warnings—Displays details about the information, warning, and error messages generated by the import process.

Imported policies—Displays information about the policy groups created by the import process.

To open the Import report, in the Import Policy Groups Reports page, select an import task and click View, or click on the Start Date link of the required report.

Table D-20 Import Report - General Information 

Field
Description

User Name

Displays the name of the user who ran the import task.

Start Date

Displays the date and time the import process started. Click to open the report for the corresponding import task.

Complete Date

Displays the date and time the import process completed.

Report Type

Displays the type of report—Import.

Report Description

Displays the description of the report.


Table D-21 Import Report - Errors and Warnings 

Field
Description

#

Displays the error number.

Configured on (in QPM 2.1.x)

Displays the device, or network element, or QPM 2.1 device group, for the configuration to which the error applies.

Policy Name (in QPM 2.1.x)

Displays the name of the policy in QPM 2.1.x to which the error applies. If the error applies to the properties defined for the device, or interface, or QPM 2.1 device group, this field is empty.

Severity

Displays the severity of the error or warning.

QoS Feature

Displays the QoS feature to which the error applies, if relevant.

Message

Displays the error message.


Table D-22 Import Report - Imported Policies 

Field
Description

#

Displays the line number in the report table.

Policy Group Name

Displays the name of the policy groups.

Network Elements

Displays the network elements assigned to each policy group.

QoS Properties

Displays the number of QoS properties defined for each policy group.

In Policies

Displays the number of inbound policies for each policy group.

Out Policies

Displays the number of outbound policies for each policy group.


Related Topics

Import Policy Groups Reports Page

Conflicts

The following topics describe the fields in the pages that are accessed from the Conflicts option:

FRTS Conflicts - Subinterfaces Page

FRTS Conflicts - DLCIs Page

Assignment Conflicts Reports Page

Assignment Conflicts Report

Verify Device Configuration Page

Job Verification Details Page

Device Configuration Verification Wizard

FRTS Conflicts - Subinterfaces Page

FRTS conflicts occur when subinterfaces are assigned to policy groups configured with Frame Relay Traffic Shaping (FRTS), but their parent interfaces have not been defined with FRTS.

Use the FRTS Conflicts - Subinterfaces page to generate a report that displays the assigned FRTS subinterfaces with FRTS conflicts in policy groups in the current deployment group.


Note To ensure that these subinterfaces will be configured on deployment, configure the parent interfaces with FRTS, or remove the subinterface from the FRTS policy group assignment.


To open the FRTS Conflicts - Interfaces page, and generate a report, select Reports > Conflicts, then select FRTS Subinterfaces in the TOC.

Table D-23 FRTS Conflicts - Subinterfaces Page 

Field
Description

Sys Name

Displays the system name of the device to which the frame relay subinterface belongs.

Name

Displays the name of the subinterfaces for which there is an FRTS conflict.

Type

Displays the types of interface to which the subinterface belongs.

Description

Displays the interface description.

Card Type

Displays the type of card on which the interface resides.

Rate

Displays the interface rates.

Device Folder

Displays the name of the device folder to which the device belongs.


Related Topics

FRTS Conflicts - DLCIs Page

Configuring FRTS Policies, page 6-61

FRTS Conflicts - DLCIs Page

FRTS conflicts occur when DLCIs are assigned to policy groups configured with Frame Relay Traffic Shaping (FRTS), but their parent interfaces have not been defined with FRTS.

Use the FRTS Conflicts - DLCIs page to generate a report that displays the assigned FRTS DLCIs with FRTS conflicts in policy groups in the current deployment group.


Note To ensure that these DLCIs will be configured on deployment, configure the parent interfaces with FRTS, or remove the DLCI from the FRTS policy group assignment.


To open the FRTS Conflicts - DLCIs page, and generate a report, select Reports > Conflicts, then select FRTS DLCIs in the TOC.

Table D-24 FRTS Conflicts - DLCIs Page 

Field
Description

Sys Name

Displays the system name of the device to which the DLCI belongs.

Name

Displays the name of the DLCI for which there is an FRTS conflict.

Interface Name

Displays the name of the parent interface of the DLCI.

Device Folder

Displays the name of the device folder to which the device belongs.


Related Topics

FRTS Conflicts - Subinterfaces Page

Configuring FRTS Policies, page 6-61

Assignment Conflicts Reports Page

Assignment conflict reports are generated in the following cases:

Devices with policy group assignments are moved from one device group to another, as a result of synchronization of privileges. QPM removes the network element assignments of these devices.

The IOS version on a device with policy group assignments is changed, either manually in the Device Properties page or by a rediscovery.

If the policy groups to which the device is assigned contain QoS configurations that are no longer supported by the device IOS, QPM removes the network element assignments of the device.

Use the Assignment Conflicts Reports page to select a report showing the network element assignment conflicts.

To open the Assignment Conflicts Reports page, select Reports > Conflicts, then select Assignments in the TOC.

Table D-25 Assignment Conflicts Reports Page 

Field
Description

Start Date

Displays the date and time the report was generated.

Complete Date

Displays the date and time the report was completed.

User Name

Displays the name of the user who generated the report.

Status

Displays the status of the assignment report:

In progress—The report is being generated. You cannot view a report in progress.

Completed—The report is complete. You can view the report.

Report Type

Displays the type of report.

View button

Click to view details of the selected report. See Assignment Conflicts Report for details.

Delete button

Click to delete a report from the list.

Refresh Rate list box

Select the rate at which the page refreshes to obtain updated information.


Assignment Conflicts Report

The Assignment Conflicts report displays the network element assignments that were removed when the mapped OS version of devices changed, or when devices were moved from their device group following a sync operation.

To open the Assignment Conflicts report, select a report in the Assignment Conflicts Reports page, and click View.

Table D-26 Conflict Assignments Report 

Field
Description

User Name

Displays the name of the user who made the changes that caused the report to be generated.

Start Date

Displays the date and time the report was generated.

Complete Date

Displays the date and time the report was completed.

Report Type

Displays the type of report—Conflict Assignments.

Report SubTitle

Displays the cause of assignment conflicts in the report.

Report Description

Displays the description of the report.

#

Displays the serial number of the assignment conflict.

Deployment Group Name

Displays the name of the deployment group with the assignment conflict.

Policy Group Name

Displays the name of the policy group with the assignment conflict.

Device Name

Displays the name of the device containing the network element whose assignment was removed.

Network Element Name

Displays the name of the network element whose assignment was removed.


Related Topics

Assignment Conflicts Reports Page

Verify Device Configuration Page

Use this page to view all the device configuration verification requests that were created and those that are currently being executed.

To open this page, do any of the following:

Select Reports > Conflicts > Verify Device Configuration.

Click Verify in the Summary page of the Device Configuration Verification wizard.

Table D-27 Verify Device Configuration Page 

Field
Description

Owner

The person who last saved the deployment job.

Deployment Group

The current deployment group.

Deployment Time

The date and time the last device verification was initiated for the job.

Status

The status of the device verification job—Pending, In Progress, Completed, or Failed.

Details

Click the Details icon for a device verification job to open its Job Details report, in which you can view the status of devices related to the job.

Refresh

Click to force a manual update of the displayed data.

New Verification

Click to open the Device Configuration Verification wizard for creating a new device configuration verification job.

View Verification Details

Click to view the details of the selected device configuration verification job. The Job Verification Details page appears.

Delete

Click to delete a selected device configuration verification job from the list.


Related Topics

Device Configuration Verification Wizard - Summary Page

Device Configuration Verification Wizard

Job Verification Details Page

Creating a Device Configuration Verification Job, page 7-31

Step 3: Confirming the Wizard Information for a Verification Job, page 7-33

Viewing the Device Configuration Verification Jobs, page 7-33

Job Verification Details Page

Use this page to view a detailed report for a selected device configuration verification job, including device status information.

To open this page, do any of the following:

In the Verify Device Configuration page, select a device configuration verification job, and click View Verification Details.

In the Verify Device Configuration page, select a device configuration verification job and click its Details icon.

Table D-28 Job Verification Details Page 

Field
Description

Job Name

Displays the name of the device configuration verification job.

Deployment Group

Displays the name of the deployment group.

Device Group

Displays the name of the device group.

Job Status

Displays the status of the device verification job—Pending, In Progress, Completed, or Failed.

Owner

Displays the name of the person who last saved the device configuration verification job.

Creation Time

Displays the date and time the device configuration verification job was created.

Job Description

Displays a description of the device configuration verification job, if available.

Device Name/IP

Displays the device name or IP address.

Status

Displays the deployment status of the device.

Status Time

Displays the time the device received its status.

Errors/Warnings

Displays an error string, if available. In the case of a FAILED status, the CLI command that caused the error will also be displayed.

Match/Mismatch

Displays "Match" if the configuration assigned to the device in the current deployment group is the same as the configuration on the device.

Displays "Mismatch" if CLI changes were made on a device after deployment, indicating a mismatch between the deployment group and the device configuration.

View CLI Commands

Click to view the CLI commands that were used to configure the device. A Device Configuration Preview window opens.


Related Topics

Device Configuration Preview Window, page C-9

Verify Device Configuration Page

Creating a Device Configuration Verification Job, page 7-31

Device Configuration Verification Wizard

The following topics describe the pages of the Device Configuration Verification wizard that guides you through the steps required to create a new device configuration verification job, for the devices in a deployment group.

The Device Configuration Verification wizard contains the following steps:

Device Configuration Verification Wizard - Deployment Group Selection Page

Device Configuration Verification Wizard - Device Selection and Preview Page

Device Configuration Verification Wizard - Summary Page

Related Topics

Using QPM Wizards, page 3-9

Device Configuration Verification Wizard - Deployment Group Selection Page

Use this page to select the deployment group that contains the devices whose configurations you want to verify.

To open this page, do any of the following:

In the Verify Device Configuration page, click New Verification.

In the Device Configuration Verification wizard navigation menu, select Deployment Group Selection.

Table D-29 Device Configuration Verification Wizard - Deployment Group Selection Page 

Field
Description

Deployment Group

Select the deployment group whose devices you want to verify.

Click the View list link to view a detailed list of all the current deployment groups.

Next button

Click to move to the next step of the wizard.

Finish button

Click to move to the last step of the wizard.


Related Topics

Deployment Groups List Page, page C-3

Verify Device Configuration Page

Step 1: Selecting the Deployment Group for a Verification Job, page 7-31

Device Configuration Verification Wizard - Device Selection and Preview Page

Use this page to select the devices whose configurations you want to verify, and preview their configurations. This page displays a list of all the devices that are part of the selected deployment group.

To open this page, do any of the following:

In the Deployment Group Selection page of the Device Configuration Verification wizard, click Next.

In the Device Configuration Verification wizard navigation menu, select Device Selection and Preview.

Table D-30 Device Configuration Verification Wizard - Device Selection and Preview Page 

Field
Description

Device

Displays the device name or IP address.

Device Folder

Displays the name of the device folder.

Policy Configuration

Displays the current configuration for the device (Modified, Unchanged Policies). Click to open a Device Configuration Preview window that displays the configuration details of the selected device.

Back button

Click to move to the previous step of the wizard.

Next button

Click to move to the next step of the wizard.

Finish button

Click to move to the last step of the wizard.


Related Topics

Device Configuration Preview Window, page C-9

Device Configuration Verification Wizard - Deployment Group Selection Page

Step 2: Previewing and Selecting the Devices for a Verification Job, page 7-32

Device Configuration Verification Wizard - Summary Page

Use this page to verify the deployment group name and the number of devices selected for verification.

To open this page, do any of the following:

In the Device Selection and Preview page of the Device Configuration Verification wizard, click Next or Finish.

In the Device Configuration Verification wizard navigation menu, select Summary.

Table D-31 Device Configuration Verification Wizard - Summary Page 

Field
Description

Deployment group name

The name of the deployment group.

Number of devices to be verified

The number of devices that were selected for verification.

Back button

Click to go back through the wizard to make any changes that are required.

Verify button

Click this button to activate the verification job. You are returned to the Verify Device Configuration Page, where you can see the status of the job. When it is completed, you can view the report by selecting it and clicking View Verification Details.


Related Topics

Verify Device Configuration Page

Device Configuration Verification Wizard - Device Selection and Preview Page

Step 3: Confirming the Wizard Information for a Verification Job, page 7-33

Restore

Restore Reports Pagefdescribes the fields in the page that is accessed from the Restore option:

Restore Reports Page

Use this page to view a report of all the deployment group restore operations for the current device group.

To open this page, do one of the following:

Select Reports > Restore.

Click View in the dialog box that opens after the restore process ends.

Table D-32 Restore Reports Page 

Field
Description

Start Date

Displays the date the restore process started.

Complete Date

Displays the date the restore process completed.

User Name

Displays the name of the user who ran the restore process.

Status

Displays the status of the restore process for the device:

In progress—Restore process is in progress. You cannot view the restore report if the status is In progress.

Completed—The restore process has completed. You can view the restore report.

Failed—QPM could not complete the restore process. The restore report displays the error.

View button

Click to view details of a selected restore report. See Restore Validation Report Window, page C-5 for details.

Delete button

Click to delete a selected restore report from the list.

Refresh Rate list box

Select the rate at which the page refreshes to obtain updated information.


Related topics

Restore Validation Report Window, page C-5

Restoring and Deploying a Historical Deployment Group, page 7-16