This document uses the following abbreviations to identify
administration differences for these Cisco products:
Unified CM refers to Cisco Unified Communications Manager
Unified CCX refers to Cisco Unified Contact Center Express
The Cisco Unified Real-Time Monitoring Tool (RTMT), which runs
as a client-side application, uses HTTPS and TCP to monitor system performance.
RTMT can connect directly to devices via HTTPS to troubleshoot system problems.
Note
Even when RTMT is not running as an application on your desktop,
tasks such as alarm and performance monitoring updates continue to take place
on the server in the background.
RTMT allows you to perform the following tasks:
Monitor a set of predefined management objects that monitor the
health of the system.
Generate various alerts, in the form of emails, for objects when
values go over or below user-configured thresholds.
Collect and view traces in various default viewers that exist in
RTMT.
View syslog messages in SysLog Viewer.
Work with performance-monitoring counters.
This chapter contains information on the following topics:
Services, servlets, and service parameters on server
To support the RTMT client, several services need to be
active and running on the server. RTMT uses the following services and servlets:
Cisco AMC service—This service starts up automatically after the
installation and allows RTMT to retrieve real-time information from the server
or from a server in a cluster (if applicable).
Caution
You must configure a second server as the failover collector in
Cisco Unified Contact Center Express Administration, so RTMT can continue to
retrieve information if the primary collector fails. Otherwise, RTMT cannot
retrieve information if the primary collector has failed.
The following list comprises some Cisco AMC service parameters
that are associated with RTMT:
Primary Collector
Failover Collector
Data Collection Enabled
Data Collection Polling Rate
Server Synchronization Period
RMI Registry Port Number
RMI Object Port Number
AlertMgr Enabled
Logger Enabled
Note
For the latest list of parameters, go to the Service Parameters
window of the Cisco Unified CCX Serviceability interface; then, choose Cisco
AMC service.
Note
For information on these service parameters, see the service
parameter Help.
Cisco RIS Data Collector (in the Control Center—Network Services
window in Cisco Unified Serviceability)—The Real-time Information Server (RIS)
maintains real-time information such as performance counter statistics,
critical alarms generated, and so on. The Cisco RIS Data Collector service
provides an interface for applications, such as Cisco Unified Real-Time
Monitoring Tool (RTMT), SOAP applications, and AlertMgrCollector (AMC) to
retrieve the information that is stored on the server.
Cisco Tomcat Stats Servlet (in the Control Center—Network Services
window in Cisco Unified Serviceability)—The Cisco Tomcat Stats Servlet allows
you to monitor the Tomcat perfmon counters by using RTMT or the Command Line
Interface. Do not stop this service unless you suspect that this service is
using too many resources, such as CPU time.
Cisco Trace Collection Servlet (in the Control Center—Network
Services window in Cisco Unified Serviceability)—The Cisco Trace Collection
Servlet, along with the Cisco Trace Collection Service, supports trace
collection and allows users to view traces by using the RTMT client. If you
stop this service on a server, you cannot collect or view traces on that
server.
Cisco Trace Collection Service (in the Control Center—Network
Services window in Cisco Unified Serviceability)—The Cisco Trace Collection
Service, along with the Cisco Trace Collection Servlet, supports trace
collection and allows users to view traces by using the RTMT client. If you
stop this service on a server, you cannot collect or view traces on that
server.
Cisco Log Partition Monitoring Tool (in the Control Center—Network
Services window in Cisco Unified Serviceability)—This service, which starts up
automatically after the installation, monitors the disk usage of the log
partition on a server.
Cisco SOAP-Real-Time Service APIs (in the Control Center—Network
Services window in Cisco Unified Serviceability)—The Cisco SOAP-Real-Time
Service APIs, which start up automatically after the installation, allow you to
collect real-time information for the system.
Cisco SOAP-Performance Monitoring APIs (in the Control
Center—Network Services window in Cisco Unified Serviceability)—This service,
which starts up automatically after the installation, allows you to use
performance monitoring counters for various applications through SOAP APIs.
Cisco RTMT Reporter servlet (in the Control Center—Network
Services window in Cisco Unified Serviceability)—This service, which starts up
automatically after the installation, allows you to publish reports for RTMT.
Cisco Serviceability Reporter (in the Control Center—Feature
Services window in Cisco Unified Serviceability)—The Cisco Serviceability
Reporter service allows you to publish reports for RTMT.
RTMT Collector, a component that automatically gets installed
with the application, logs preconfigured monitoring objects information while
Alert Manager, also automatically installed, logs alert histories into log
files. Each preconfigured object belongs to one of several categories: servers
and alerts. Each category uses a separate log file, and alert details also get
logged in a separate file.
The system also records important perfmon object values in
performance log files.
Tip
Although they require no configuration tasks to run, RTMT Collector
and Alert Manager support redundancy. If the primary collector or manager fails
for any reason, the secondary collector and manager perform the tasks until
primary support becomes available. RTMT Collector, Alert Manager, and RTMT
Reporter run on the first server to minimize call-processing interruptions.
You can display log files, except an alert log file, by using
the Performance log viewer in RTMT or by using the native Microsoft Performance
viewer. For more information on using the Performance log viewer in RTMT, refer
to
Additional information. You can view
an alert log file by using any text editor.
To download log files to a local machine, you can use the
collect files option in Trace and Log Central in RTMT. For more information on
downloading log files by using the collect files option, refer to
Collect trace files.
Alternatively, from the command line interface (CLI), you can
use the file list command to display a list of files and the file get command
to download files by SFTP. For more information on using CLI commands, see the
Command Line Interface Reference Guide for Cisco Unified Contact Center
Express, available here:
Log files exist in csv format. New log files get created
every day at 00:00 hours on the local system. The first column of all these
logs comprises the time zone information and the number of minutes from the
Greenwich Meridian Time (GMT). RTMT Reporter uses these log files as a data
source to generate daily summary reports. The report, which is based on the
default monitoring objects, generates every 24 hours for the following
information:
Server Status—% CPU load,% memory used,% disk space used per
server.
Alert Status—Number of alerts per server. For Unified CCX
clusters, number of alerts per severity level for the cluster, including the
top 10 alerts in the cluster.
Tip
The RTMT reports display in English only.
The following service parameters apply to RTMT report
generation: RTMT Reporter Designated server, RTMT Report Generation Time, and
RTMT Report Deletion Age. For information on these parameters, go to the
service parameter Help for your configuration by choosing a service in the
Service drop-down list box of the Service Parameters window and then clicking
Help > This Page
For more information on the Serviceability reports, see the
"Serviceability Reports" chapter in Cisco Unified Serviceability
Administration Guide available here: