Cisco Unified Real-Time Monitoring Tool

Cisco Unified Real-Time Monitoring Tool


Note


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.
Related Information

Nonconfigurable components on server

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:

http://www.cisco.com/en/US/products/sw/custcosw/ps1846/products_installation_and_configuration_guides_list.html

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:

http://www.cisco.com/en/US/products/sw/custcosw/ps1846/products_installation_and_configuration_guides_list.html

Related Information