The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
Counters
You can use queries to select and display perfmon counters. You can organize the perfmon counters to display a set of feature-based counters and save it in a category. After you save your Unified RTMT profile, you can quickly access the counters in which you are interested.
Unified RTMT displays perfmon counters in chart or table format. The chart format displays the perfmon counter information by using line charts. For each category tab that you create, you can display up to six charts in the Perfmon Monitoring pane with up to three counters in one chart. After you create a category, you cannot change the display from a chart format to a table format, or vice versa.
Tip | You can display up to three counters in one chart in the Perfmon Monitoring pane. To add another counter in a chart, click the counter and drag it to the Perfmon Monitoring pane. Repeat again to add up to three counters. |
By default, Unified RTMT displays perfmon counters in a chart format. You can also choose to display the perfmon counters in a table format. To display the perfmon counters in table format, you need to check the Present Data in Table View check box when you create a new category.
You can remove a counter chart (table entry) with the Remove Chart/Table Entry menu item in the Perfmon menu in the menu bar.
You can remove counters from the RTMT Perfmon Monitoring pane when you no longer need them. Follow this procedure to remove a counter from the pane.
Follow this procedure to configure alert notification for a counter.
Tip | To remove the alert for the counter, right-click the counter and choose Remove Alert. The option appears gray after you remove the alert. |
Step 1 | Find and display the performance counter. | ||
Step 2 | From the counter chart or table, right-click the counter for which you want to configure the alert notification, and choose Set Alert/Properties. | ||
Step 3 | Check the Enable Alert check box. | ||
Step 4 | In the Severity drop-down list box, choose the severity level at which you want to be notified. | ||
Step 5 | In the Description pane, enter a description of the alert and click Next. | ||
Step 6 | Configure the settings in the Threshold, Value Calculated As, Duration, Frequency, and Schedule panes. After you enter the settings in the window, click Next to proceed to the next panes. | ||
Step 7 | To configure the system to send an e-mail message for the alert, check the Enable Email check box. | ||
Step 8 | To trigger an alert action that is already configured, choose the alert action that you want from the Trigger Alert Action drop-down list box. | ||
Step 9 | To configure a
new alert action for the alert, click
Configure.
The Alert Action dialog box appears. | ||
Step 10 | To add a new
alert action, click
Add.
The Action Configuration dialog box appears. | ||
Step 11 | In the Name field, enter a name for the alert action. | ||
Step 12 | In the Description field, enter a description for the alert action. | ||
Step 13 | Click
Add to add a new e-mail recipient for the alert
action.
The Input dialog box appears. | ||
Step 14 | Enter either the e-mail or e-page address of the recipient that you want to receive the alert action notification and click OK | ||
Step 15 | In the User-defined email text box, enter the text that you want to display in the e-mail message and click Activate. |
The following shows how to obtain a description of the counter:
RTMT allows you to choose different perfmon counters to log locally. You can then view the data from the perfmon CSV log by using the performance log viewer.
To start logging perfmon counter data into a CSV log file, perform the following procedure:
Step 1 | Find and display the performance monitoring counters. | ||
Step 2 | If you are
displaying perfmon counters in the chart format, right-click the graph for
which you want data sample information and choose
Start
Counter(s) Logging.
The Counter Logging Configuration dialog box appears. | ||
Step 3 | If you want to
log all counters in a screen (both chart and table view format), you can
right-click the category name tab at the bottom of the window and choose
Start
Counter(s) Logging.
The Counter Logging Configuration dialog box appears. | ||
Step 4 | Configure the maximum file size and maximum number of files parameter. | ||
Step 5 | In the Logger
File Name field, enter a filename and click
OK.
RTMT saves the CSV log files in the log folder in the .jrtmt directory under the user home directory. For example, in Windows, the path specifies D:\Documents and Settings\userA\.jrtmt\log, or in Linux, the path specifies /users/home/.jrtmt/log. To limit the number and size of the files, configure the maximum file size and maximum number of files parameter in the trace output setting for the specific service in the Trace Configuration window of Cisco Unified Serviceability. See Cisco Unified Serviceability Administration Guide.
|
To stop logging perfmon counter data, perform the following procedure:
Step 1 | Find and display the performance monitoring counters. |
Step 2 | If you are displaying perfmon counters in the chart format, right-click the graph for which counter logging is started and choose Stop Counter(s) Logging. If you want to stop logging of all counters in a screen (both chart and table view format), you can right-click the category name tab at the bottom of the window and choose Stop Counter(s) Logging. |
The Counter Property window contains the option to configure data samples for a counter. The perfmon counters that display in the RTMT Perfmon Monitoring pane contain green dots that represent samples of data over time. You can configure the number of data samples to collect and the number of data points to show in the chart. After the data sample is configured, view the information by using the View All Data/View Current Data menu option.
Follow this procedure to configure the number of data samples to collect for a counter.
Step 1 | Find and display the counter. |
Step 2 | Click the
counter for which you want data sample information and choose
.
The Counter Property window displays the description of the counter, as well as the tab for configuring data samples. The description includes the host address, the object to which the counter belongs, the counter name, and a brief overview of what the counter does. |
Step 3 | To configure the number of data samples for the counter, click the Data Sample tab. |
Step 4 | From the
No. of
data samples drop-down list box, choose the number of samples
(between 100 and 1000).
The default specifies 100. |
Step 5 | From the
No. of
data points shown on chart drop-down list box, choose the number of
data points to display on the chart (between 10 and 50).
The default specifies 20. |
Step 6 | Click one of the
following parameters:
|
Step 7 | To close the Counter Property window and return to the RTMT Perfmon Monitoring pane, click OK. |
Follow this procedure to view the data that is collected for a performance counter.
Step 1 | In the RTMT Perfmon Monitoring pane, right-click the counter chart for the counter for which you want to view data samples. |
Step 2 | Choose
View All
Data.
The counter chart displays all data that has been sampled. The green dots display close together. |
Step 3 | Right-click the counter that currently appears. |
Step 4 | Choose
View
Current.
The counter chart displays the last configured data samples that were collected. |
The performance log viewer displays a chart with the data from the selected counters. The bottom pane displays the selected counters, a color legend for those counters, display option, mean value, minimum value, and the maximum value.
The following table describes the functions of different buttons that are available on the Performance Log Viewer.
Allows you to add counters that you want to display in the performance log viewer. If you do not want to display a counter, uncheck the Display column next to the counter. |
|
Resets the performance log viewer to the initial default view. |
|
The Performance Log Viewer displays data for counters from perfmon CSV log files in a graphical format. You can use the performance log viewer to display data from the local perfmon logs that you collected, or you can display the data from the Real-time Information Server Data Collection (RISDC) perfmon logs.
The local perfmon logs consist of data from counters that you select and store locally on your computer.
Step 1 | Select . |
Step 2 | Select the type of perfmon logs that you want to view: |
Step 3 | Select the counters that you want to display. |
Step 4 | Select
OK.
|
The Performance Log viewer includes a zoom feature that allows you to zoom in on and out on an area in the chart.
Step 1 | Perform one of the following actions:
| ||||||
Step 2 | Select the name of the server where the counter is located.
The tree hierarchy expands and displays all the perfmon objects for the node. | ||||||
Step 3 | Double-select the performance counter you want to monitor. | ||||||
Step 4 | Perform one of the following actions:
|
Note | The method for accessing Performance may vary depending on the version of windows you install on your computer. |
Step 1 | Select . |
Step 2 | Perform the following actions in the application window: |
Step 3 | Select the Source tab in the System Monitor Properties dialog box. |
Step 4 | Browse to the directory where you downloaded the perfmon log file and select the perfmon csv file. The log file includes the following naming convention: PerfMon_<node>_<month>_<day>_<year>_<hour>_<minute>.csv; for example, PerfMon_172.19.240.80_06_15_2005_11_25.csv. |
Step 5 | Select Apply. |
Step 6 | Select Time Range. To specify the time range in the perfmon log file that you want to view, drag the bar to the appropriate starting and ending times. |
Step 7 | To open the Add Counters dialog box, select the Data tab and select Add. |
Step 8 | Select the perfmon object from the Performance Object drop-down list box. If an object has multiple instances, you may select All instances or select only the instances that you are interested in viewing. |
Step 9 | You can select All Counters or select only the counters that you are interested in viewing. |
Step 10 | Select Add to add the selected counters. |
Step 11 | Select Close when you finish selecting counters. |
Troubleshooting
The troubleshooting perfmon data logging feature assists Cisco TAC in identifying system problems. When you enable troubleshooting perfmon data logging, you initiate the collection of a set of system and operating system performance statistics on the selected node. The statistics that are collected include comprehensive information that you can use for system diagnosis.
The system automatically enables troubleshooting perfmon data logging to collect statistics from a set of perfmon counters that provides comprehensive information about the system state. When you eable Troubleshooting Perfmon Data Logging, Cisco estimates that the system experiences a less than five percent increase in CPU utilization and an insignificant increase in the amount of memory that is being used, and it writes approximately 50 MB of information to the log files daily.
You can perform the following administrative tasks with the troubleshooting perfmon data logging feature:
The troubleshooting perfmon data-logging feature collects information from the following counters within the following perfmon objects.
Note | Cisco Unity Connection counters are not logged to the troubleshooting perfmon data log. |
Database Change Notification Server Object:
Database Local DSN Object:
Enterprise Replication DBSpace Monitors Object:
IP Object:
Memory Object:
% Page Usage
% VM Used
% Mem Used
Buffers Kbytes
Cached Kbytes
Free Kbytes
Free Swap Kbytes
HighFree
HighTotal
Low Total
Low Free
Page Faults Per Sec
Page Major Faults Per Sec
Pages
Pages Input
Pages Input Per Sec
Pages Output
Pages Output Per Sec
SlabCache
SwapCached
Shared Kbytes
Total Kbytes
Total Swap Kbytes
Total VM Kbytes
Used Kbytes
Used Swap Kbytes
Used VM Kbytes
Network Interface Object:
Number of Replicates Created and State of Replication Object:
Partition Object:
Process Object:
Processor Object:
System Object:
TCP Object:
Thread Object (Troubleshooting Perfmon Data Logger only logs Cisco Unified Communications Manager threads):
Cisco CallManager Object:
Cisco SIP Stack Object:
Cisco CallManager System Performance Object:
AverageExpectedDelay
CallsRejectedDueToThrottling
CodeRedEntryExit
CodeYellowEntryExit
QueueSignalsPresent 1-High
QueueSignalsPresent 2-Normal
QueueSignalsPresent 3-Low
QueueSignalsPresent 4-Lowest
QueueSignalsProcessed 1-High
QueueSignalsProcessed 2-Normal
QueueSignalsProcessed 3-Low
QueueSignalsProcessed 4-Lowest
QueueSignalsProcessed Total
SkinnyDevicesThrottled
ThrottlingSampleActivity
TotalCodeYellowEntry
Cisco TFTP Server Object:
BuildAbortCount
BuildCount
BuildDeviceCount
BuildDialruleCount
BuildDuration
BuildSignCount
BuildSoftkeyCount
BuildUnitCount
ChangeNotifications
DeviceChangeNotifications
DialruleChangeNotifications
EncryptCount
GKFoundCount
GKNotFoundCount
HeartBeat
HttpConnectRequests
HttpRequests
HttpRequestsAborted
HttpRequestsNotFound
HttpRequestsOverflow
HttpRequestsProcessed
HttpServedFromDisk
LDFoundCount
LDNotFoundCount
MaxServingCount
Requests
RequestsAborted
RequestsInProgress
RequestsNotFound
RequestsOverflow
RequestsProcessed
SegmentsAcknowledged
SegmentsFromDisk
SegmentsSent
SEPFoundCount
SEPNotFoundCount
SIPFoundCount
SIPNotFoundCount
SoftkeyChangeNotifications
UnitChangeNotifications
Follow this procedure to collect information from counters within the perfmon objects with the perfmon data-logging feature.
Step 1 | Select the administration interface. | ||||||||||||
Step 2 | Select the server from the Server list box. | ||||||||||||
Step 3 | Select the Cisco RIS Data Collector from the Service drop-down list box. | ||||||||||||
Step 4 | Enter the
appropriate settings as described in the following table.
| ||||||||||||
Step 5 | Select
Save.
|