Showing results for 
Search instead for 
Did you mean: 





This document describes how to monitor the Cisco Unity Connection and Cisco Unified Communications Manager servers using Cisco Unified Real- Time Monitoring Tool (RTMT). It covers the Installation and configuration of the RTMT along with the procedures to configure the System Alerts.


Cisco Unified Real-Time Monitoring Tool (RTMT)

The Cisco Unified Real-Time Monitoring Tool (RTMT), which runs as a client-side application, uses HTTPS and TCP to monitor system performance, device status, device discovery, CTI applications, and voice messaging ports. RTMT can connect directly to devices via HTTPS to troubleshoot system problems.


RTMT allows you to perform the following tasks:


  1. Monitor a set of predefined management objects that monitor the health of the system.
  2. Generate various alerts, in the form of e-mails, for objects when values go over/below user- configured thresholds.
  3. Collect and view traces in various default viewers that exist in RTMT.
  4. View syslog messages in SysLog Viewer.
  5. Work with performance-monitoring counters
  6. When CUCMs are using MGCP gateways instead of H.323 gateways blocking calls based on ANI or Calling Number becomes difficult or not possible in older Cisco Unified Communications Manager (CUCM) versions which is below 8.x


Installing and Configuring Cisco Unified Real-Time Monitoring Tool

You can install Cisco Unified Real-Time Monitoring Tool (RTMT), which works for resolutions 800*600 and above, on a computer that is running Windows 98, Windows XP, Windows 2000, Windows Vista, or Linux with KDE and/or Gnome client.


Note: RTMT requires at least 128 MB in memory to run on a Windows OS platform.


Installing RTMT

To install the tool, perform the following procedure:

Note : While installing RTMT on a Windows Vista platform, you will see a User Account Control pop-up message that says, "An unidentified program wants to access your computer." Click Allow to continue working with RTMT.



Step 1: Go to the Plug-ins window of the administration interface for your configuration:


Table 1 RTMT Plug-in





From Cisco Unity Connection Administration, choose System Settings > Plugins.

Cisco Unified Communications Manager

From Cisco Unified Communications Manager Administration, choose Applications > Plugins.


Step 2: Click the Find button.


Step 3: To install the RTMT tool on a client that is running the Microsoft Windows operating system, click the Download link for the Cisco Unified CM Real-Time Monitoring Tool-Windows.

To install the RTMT tool on a client that is running the Linux operating system, click the Download link for the Cisco Unified CM Real-Time Monitoring Tool-Linux.


Step 4: Download the executable to the preferred location on your client.


Step 5: To install the Windows version, double-click the RTMT icon that displays on the desktop or locate the directory where you downloaded the file and run the RTMT installation file.The extraction process begins.


Step 6: To install the Linux version, ensure that the file has execute privileges; for example, enter the following command, which is case sensitive: chmod +x CcmServRtmtPlugin.bin


Step 7: After the RTMT welcome window displays, click Next.


Step 8: To accept the license agreement, click I accept the terms of the license agreement; then, click Next.


Step 9: Choose the location where you want to install RTMT. If you do not want to use the default location, click Browse and navigate to a different location. Click Next.


Step 10: To begin the installation, click Next.

The Setup Status window displays. Do not click Cancel.


Step 11: To complete the installation, click Finish.



Performance Objects and Counters for Cisco Unity Connection


Following are the Cisco Unity Connection-related objects and counters that can be monitored through RTMT


CUC Data Store

CUC Data Store: Databases


CUC Message Store

CUC Message Store: Databases


CUC Personal Call Transfer Rules

CUC Phone System

CUC Phone System: Ports

CUC Replication

CUC Sessions: Calendar Access

CUC Sessions: E-mail Access

CUC Sessions: IMAP Server

CUC Sessions: RSS

CUC Sessions: SMTP Server

CUC Sessions: TRaP

CUC Sessions: TTS

CUC Sessions: Voice

CUC Sessions: VUI

CUC Sessions: Web

CUC Sessions: Web Calendar Access

CUC Sessions: Web E-mail Access



Using RTMT for Alerts

The system generate alert messages to notify administrator when a predefined condition is met, such as when an activated service goes from up to down. The system can send alerts as e-mail/epage.

RTMT, which supports alert defining, setting, and viewing, contains preconfigured and user-defined alerts. Although you can perform configuration tasks for both types, you cannot delete preconfigured alerts (whereas you can add and delete user-defined alerts).

The Alert menu comprises the following menu options:

• Alert Central-This option comprises the history and current status of every alert in the system.

Note You can also access Alert Central by clicking the Alert Central icon in the hierarchy tree in the system drawer.


• Set Alert/Properties-This menu option allows you to set alerts and alert properties.


• Remove Alert-This menu category allows you to remove an alert.


• Enable Alert-With this menu category, you can enable alerts.


• Disable Alert-You can disable an alert with this category.


• Suspend cluster/node Alerts-This menu category allows you to temporarily suspend alerts on a particular server or on an entire cluster (if applicable).


• Clear Alerts-This menu category allows you to reset an alert (change the color of an alert item to black) to signal that an alert has been handled.


After an alert has been raised, its color will automatically change in RTMT and will stay that way until you manually clear the alert.


• Clear All Alerts-This menu category allows you to clear all alerts.


• Alert Detail-This menu category provides detailed information on alert events.


• Config Email Server-In this category, you can configure your e-mail server to enable alerts.

Note To configure RTMT to send alerts via e-mail, you must configure DNS.

• Config Alert Action-This category allows you to set actions to take for specific alerts; you can configure the actions to send the alerts to desired e-mail recipients.


In RTMT, you configure alert notification for perform counter value thresholds and set alert properties for the alert, such as the threshold, duration, frequency, and so on.


You can locate Alert Central under the Tools hierarchy tree in the quick launch. Alert Central provides both the current status and the history of all the alerts in the system.

System Alerts - Cisco Unity Connection


System alerts - Cisco Unity Connection


The following list comprises the preconfigured system alerts.

  • AuthenticationFailed
  • CiscoDRFFailure
  • CoreDumpFileFound
  • CpuPegging
  • CriticalServiceDown
  • HardwareFailure
  • LogFileSearchStringFound
  • LogPartitionHighWaterMarkExceeded
  • LogPartitionLowWaterMarkExceeded
  • LowActivePartitionAvailableDiskSpace
  • LowAvailableVirtualMemory
  • LowInactivePartitionAvailableDiskSpace
  • LowSwapPartitionAvailableDiskSpace
  • ServerDown (Unified CM clusters only)
  • SparePartitionHighWaterMarkExceeded
  • SparePartitionLowWaterMarkExceeded
  • SyslogSeverityMatchFound
  • SyslogStringMatchFound
  • SystemVersionMismatched
  • TotalProcessesAndThreadsExceededThreshold


Cisco Unity Connection Alerts


The following list comprises the preconfigured Cisco Unity Connection alerts. These alerts apply only to Cisco Unity Connection and Cisco Unified Communications Manager Business Edition.

  • NoConnectionToPeer (CiscoUnity Connection cluster configuration only)
  • AutoFailoverSucceeded (Cisco Unity Connection cluster configuration only)
  • AutoFailoverFailed (Cisco Unity Connection cluster configuration only
  • AutoFailbackSucceeded (Cisco Unity Connection cluster configuration only)
  • AutoFailbackFailed (Cisco Unity Connection cluster configuration only)
  • SbrFailed (Split Brain Resolution Failed) (Cisco Unity Connection cluster configuration only)
  • LicenseExpirationWarning
  • LicenseExpired


For alert descriptions and default configurations, refer


Cisco unity connection alert description and default configuration

Configuring E-mails for Alert Notification

Perform the following procedure to configure e-mail information for alert notification.

To configure RTMT to send alerts via e-mail, you must configure DNS. For information on configuring the primary and secondary DNS IP addresses and the domain name in Cisco Unified Communications Manager Server Configuration, see the DHCP Server Configuration chapter in the Cisco Unified Communications Manager Administration Guide.



Step 1: Choose System > Tools > Alert > Config Email Server.
The Mail Server Configuration window displays.

Step 2: Enter the address of the mail server in the Mail Server field.

Step 3: Enter the port number of the mail server in the Port field.

Step 4: To add recipients, click Add in the Recipients section.
The Input box displays.

Step 5: Enter the address of the intended recipient in the Enter e-mail/epage address field.
Repeat Step 5 as necessary to enter all intended e-mail recipients.

Step 6: (Optional) Enter a message that will be sent with the alert in the Default Message field.

Step 7: Click OK.


Port Monitor Overview

The RTMT Port Monitor lets you monitor the activity of each Cisco Unity Connection voice messaging port in real time. This information can help you determine whether they system has too many or too few ports.


This tool can display the following information for each port:

Table 2 Port Monitor Parameters


Port Monitor Parameter

Parameter: Description

Port Name: The display name of the port in Cisco Unity Connection Administration.

Caller: For incoming calls, the phone number of the caller.

Called: For incoming calls, the phone number that was dialed.

Reason: If applicable, the reason why the call was redirected.

Redir: The extension that redirected the call. If the call was redirected by more than one extension, this field shows the extension prior to the last extension.

Last Redir: The last extension that redirected the call.

Application Status: The name of the conversation that Cisco Unity Connection is playing for the caller. When the port is not handling a call, the status specifies "Idle."

Display Status: The action that the conversation is currently performing. When the port is not handling a call, the status specifies "Idle."

Conversation Status: Specific details about the action that the conversation is performing. When the port is not handling a call, the status specifies "Idle."


Cisco Unified Communications Manager Alerts

The following list comprises the preconfigured CUCM alerts.


For alert descriptions and default configurations, refer


CUCM Alert description and default configuration


Cisco Unified Communication Manager Alerts




Related information



Great Document.  Easy to understand.

Thank you Mark Stafford.




Can share some details on alerts triggered from  RTMT messages


• BeginThrottlingCallListBLFSubscriptions
• CallAttemptBlockedByPolicy
• CallProcessingNodeCpuPegging
• CodeYellow
• DDRBlockPrevention
• DDRDown
• EMCCFailedInLocalCluster
• EMCCFailedInRemoteCluster
• ExcessiveVoiceQualityReport

Getting Started

Find answers to your questions by entering keywords or phrases in the Search bar above. New here? Use these resources to familiarize yourself with the community:

Recognize Your Peers
Quick Links