Monitoring the System
Available Languages
Table Of Contents
Displaying Active Calls by Application
Displaying Active Calls by Route
Displaying All Future Messages
Displaying the Number of Future Messages for Each Subscriber
Displaying the Number of Scheduled Messages for a Subscriber
Monitoring Active IMAP and VoiceView Express Sessions
Displaying VoiceView Express Sessions
Terminating an Active VoiceView Express Session
Monitoring Notification Queues
Displaying SNMP and Management Data Activity
Viewing System Activity Messages
Checking AIM Compact Flash Memory Wear Activity
Monitoring the System
Last Updated: September 18, 2007
This chapter contains procedures for monitoring the Cisco Unity Express system's health and performance and includes the following sections:
•
Monitoring Active IMAP and VoiceView Express Sessions
•
•
•
Monitoring Active Calls
This section describes the commands that permit monitoring of active calls on the Cisco Unity Express system and contains the following sections:
•
•
•
Displaying Active Calls by Application
To display active calls by application, use the following command in Cisco Unity Express EXEC mode:
show ccn call application [all [subsystem {jtapi | sip}] |
application-name [subsystem {jtapi | sip}]]where all displays active calls for all applications, application-name displays active calls for the specified application, and jtapi and sip display active calls for those subsystems.
The command displays information about the port, the call, and the media.
The following is sample output for the show ccn call application command:
se-10-0-0-0# show ccn call application voicemailActive Call Details for Subsystem :SIP-----------------------------------------**** Details for route ID :1200 ****-------------------------------------** Active Port #1:Call and Media info **------------------------------------------Port ID :4Port Impl ID :16904Port State :IN_USECall Id :241Call Impl Id :FFCE47C8-669711D6-8C4BF237-80EC4A17@10.4.39.35Call State :CALL_ANSWEREDCall active time(in seconds) :1Application Associated :voicemailApplication Task Id :17000000122Called Number :1200Dialed Number :Calling Number :1005ANI :DNIS :CLID :sip:1005@10.4.39.35Arrival Type :DIRECTLast Redirected Number :Original Called Number :Original Dialed Number :Media Id :6Media State :IN_USEMedia Destination Address :10.4.39.35Media Destination Port :16970Destination Size :20Destination Payload :G711ULAW64KMedia Source Address :10.4.39.135Media Source Port :16904Source Size :30Source Payload :G711ULAW64Kse-10-0-0-0# show ccn call application promptmgmtActive Call Details for Subsystem :SIP-----------------------------------------**** Details for route ID :1202 ****-------------------------------------** Active Port #1:Call and Media info **------------------------------------------Port ID :3Port Impl ID :16902Port State :IN_USECall Id :242Call Impl Id :92023CF-669811D6-8C50F237-80EC4A17@10.4.39.35Call State :CALL_ANSWEREDCall active time(in seconds) :1Application Associated :promptmgmtApplication Task Id :17000000123Called Number :1202Dialed Number :Calling Number :1005ANI :DNIS :CLID :sip:1005@10.4.39.35Arrival Type :DIRECTLast Redirected Number :Original Called Number :Original Dialed Number :Media Id :5Media State :IN_USEMedia Destination Address :10.4.39.35Media Destination Port :18534Destination Size :20Destination Payload :G711ULAW64KMedia Source Address :10.4.39.135Media Source Port :16902Source Size :30Source Payload :G711ULAW64KDisplaying Active Calls by Route
Cisco Unity Express supports displaying active calls by route. (A route is a trigger number configured for an application. Use the show ccn trigger command to display a list of configured triggers.)
To display active calls by route, use the following command in Cisco Unity Express EXEC mode:
show ccn call route [all [subsystem {jtapi | sip}] | route-address [subsystem {jtapi | sip}]]
where all displays active calls for all applications, route-address displays active calls for the specified route, and jtapi and sip display active calls for those subsystems.
The command displays information about the port, the call, and the media for both JTAPI and SIP subsystems.
The following example is sample output for the show ccn call route all command:
se-10-0-0-0# show ccn call route allActive Call Details for Subsystem :JTAPI-----------------------------------------**** Details for route ID :2200 ****-------------------------------------** Active Port #1:Call and Media info **------------------------------------------Port ID :2Port Impl ID :2225550100Port State :IN_USECall Id :9Call Impl Id :1566/1Call State :CALL_ANSWEREDCall active time(in seconds) :6Application Associated :voicemailApplication Task Id :17000000010Called Number :2200Dialed Number :Calling Number :2001ANI :DNIS :CLID :Arrival Type :DIRECTLast Redirected Number :Original Called Number :2200Original Dialed Number :Media Id :2Media State :IN_USEMedia Destination Address :172.16.59.11Media Destination Port :22814Destination Size :20Destination Payload :G711ULAW64KMedia Source Address :10.4.14.133Media Source Port :16388Source Size :20Source Payload :G711ULAW64K** Active Port #2:Call and Media info **------------------------------------------Port ID :1Port Impl ID :2225550150Port State :IN_USECall Id :10Call Impl Id :1567/1Call State :CALL_ANSWEREDCall active time(in seconds) :6Application Associated :voicemailApplication Task Id :17000000011Called Number :2200Dialed Number :Calling Number :2003ANI :DNIS :CLID :Arrival Type :DIRECTLast Redirected Number :Original Called Number :2200Original Dialed Number :Media Id :1Media State :IN_USEMedia Destination Address :172.16.59.12Media Destination Port :27928Destination Size :20Destination Payload :G711ULAW64KMedia Source Address :10.4.14.133Media Source Port :16386Source Size :20Source Payload :G711ULAW64KThe following example displays active calls for the route 1200, which is a trigger number for the voice-mail application.
se-10-0-0-0# show ccn call route 1200Active Call Details for Subsystem :SIP-----------------------------------------**** Details for route ID :1200 ****-------------------------------------** Active Port #1:Call and Media info **------------------------------------------Port ID :8Port Impl ID :16912Port State :IN_USECall Id :246Call Impl Id :E682B0A9-673311D6-8C64F237-80EC4A17@10.4.39.35Call State :CALL_ANSWEREDCall active time(in seconds) :0Application Associated :voicemailApplication Task Id :17000000127Called Number :1200Dialed Number :Calling Number :1005ANI :DNIS :CLID :sip:1005@10.4.39.35Arrival Type :DIRECTLast Redirected Number :Original Called Number :Original Dialed Number :Media Id :1Media State :IN_USEMedia Destination Address :10.4.39.35Media Destination Port :18812Destination Size :20Destination Payload :G711ULAW64KMedia Source Address :10.4.39.135Media Source Port :16912Source Size :30Source Payload :G711ULAW64KDisplaying Incoming Fax Calls
To display a list of incoming fax calls when incoming calls are recorded, use the fshow ccn call fax incoming command in Cisco Unity Express EXEC mode. This command displays the connection time, sender's phone number, and the receiver's phone number for all the incoming fax sessions.
The following example is sample output for the show ccn call fax incoming command:
se-10-0-0-0> show ccn call fax incomingConnect Time Sender Receiver=======================================================================Mon Jan 15 12:56:26 PST 2007 1111 50001 incoming fax call(s)Terminating an Active Call
An active call can be terminated by using the call's implementation ID or using the implementation ID of the port through which the call came in to the system. Use the show ccn call route command to obtain the call or port implementation ID. See "Displaying Active Calls by Route".
To terminate an active call, use the following command in Cisco Unity Express EXEC mode:
ccn call terminate {callimplid | portimplid} impli-id
where impli-id is the implementation ID of the call or port.
The following example terminates a call with implementation ID 1567/1:
se-10-0-0-0# ccn call terminate call 1567/1The following example terminates a call coming through a port with implementation 2225550150:
se-10-0-0-0# ccn call terminate port 2225550150Monitoring Future Messages
Monitoring future messages involves the following procedures:
For a description of future messages, see "Configuring the Delivery of Future Messages" on page 266.
Displaying Future Messages
You cana use several CLI commands to display information about future messages.
Displaying All Future Messages
To display details of all messages scheduled for future delivery, use the show voicemail messages future command in Cisco Unity Express EXEC mode.
The following is sample output for the command:
se-10-0-0-0# show voicemail messages futureMessage ID: JMX0637L023-NM-FOC08221WRB-731357131983Sender: User1Recipient(s): UserALength(sec): 30Delivery time: Mon, 11 April 2006 08:0000-0800 (PST)Message ID: JMX0637L023-NM-FOC08221WRB-731183375855Sender: User2Recipient(s): UserB,UserGLength(sec): 20Delivery time: Wed, 13 April 2006 10:15:00-0800 (PST)Displaying the Number of Future Messages for Each Subscriber
To display the number of messages scheduled for future delivery for each subscriber, use the show voicemail mailboxes command in Cisco Unity Express EXEC mode.
The following is sample output for the command:
se-10-0-0-0# show voicemail mailboxesOWNER MSGS NEW SAVE DEL BCST FUTR MSGTIME MBXSIZE USED''user1'' 25 25 0 0 0 1 2952 3000 98 %''user2'' 5 1 4 0 0 0 1933 3000 64 %''user3'' 5 5 0 0 0 2 893 3000 30 %''user4'' 5 5 0 0 0 1 893 3000 30 %''user8'' 5 5 0 0 0 1 893 3000 30 %''user9'' 5 5 0 0 0 0 893 3000 30 %Displaying the Number of Scheduled Messages for a Subscriber
To display the number of scheduled messages for a specific subscribe, use the show voicemail detail mailbox command in Cisco Unity Express EXEC mode.
The following is sample output for the command:
se-10-0-0-0# show voicemail detail mailbox user2Owner: /sw/local/users/user2Type: PersonalDescription:Busy state: idleEnabled: trueMailbox Size (seconds): 3927Message Size (seconds): 60Play Tutorial: trueSpace Used (seconds): 60Total Message Count: 14New Message Count: 1Saved Message Count: 2Future Message Count: 2Deleted Message Count: 9Expiration (days): 30Greeting: standardZero Out Number:Created/Last Accessed: Jan 23 2006 13:41:31 PSTDeleting a Future Message
To delete a message scheduled for future delivery, use the following command in Cisco Unity Express EXEC mode:
voicemail message future message-id delete
where message-id is the message ID of the scheduled message. Use the show voicemail messages future command to display the message IDs of the scheduled messages.
An error message appears if message-id does not exist or if message-id does not belong to a message scheduled for future delivery.
The following example deletes a future message:
se-10-0-0-0# voicemail message future JMX0637L023-NM-FOC08221WRB-731357131983 deleteMonitoring Active IMAP and VoiceView Express Sessions
Several CLI commands are available for monitoring active IMAP and VoiceView Express sessions:
•
•
Displaying IMAP Sessions
To display status information about active Internet Mail Access Protocol (IMAP) sessions, use the show imap sessions comand in Cisco Unity Express EXEC mode.
The following is sample output for the command:
se-10-0-0-0# show imap sessionsSessions IP Address Connect Time User ID====================================================================1 10.21.82.244 Wed Nov 16 01:35:02 CST 2005 user12 172.18.10.10 Wed Nov 16 03:23:15 CST 2005 user5
Note
Displaying VoiceView Express Sessions
To display status information about active VoiceView Express sessions, use the show voiceview sessions command in Cisco Unity Express EXEC mode.
The following is sample output for the command:
se-10-0-0-0# show voiceview sessionsMailbox RTP User ID Phone MAC Address1013 Yes user1 0015.C68E.6C1E1016 No user5 0015.629F.87061015 No user3 0015.63EE.37901014 Yes user6 0015.629F.888B4 session(s)2 active RTP stream(s)
Note
Terminating an Active VoiceView Express Session
To terminate an active VoiceView Express session, use the following command in Cisco Unity Express EXEC mode:
service voiceview session terminate mailbox-id
where mailbox-id is the ID of the mailbox that has the active VoiceView Express session.
The following example terminates a VoiceView Express session for mailbox ID user 3:
se-10-0-0-0# service voiceview session terminate mailbox user3Additionally, a new TUI or VoiceView Express session preempts and terminates an existing VoiceView Express session.
Monitoring Queues
Several CLI commands are available for monitoring Cisco Unity Express queues:
•
Monitoring Network Queues
To display status information about network queues, use the show network queues command in Cisco Unity Express EXEC mode.
The following example shows output from the command:
se-10-0-0-0# show network queuesRunning Job Queue=================ID TYPE TIME RETRY SENDER RECIPIENT107 VPIM 06:13:26 20 jennifer 1001@sjc.mycompany.com106 VPIM 06:28:25 20 jennifer 1001@sjc.mycompany.comUrgent Job Queue=================ID TYPE TIME RETRY SENDER RECIPIENT123 VPIM 16:33:39 1 andy 9003@lax.mycompany.comNormal Job Queue=================ID TYPE TIME RETRY SENDER RECIPIENT122 VPIM 16:33:23 1 andy 9001@lax.mycompany.com124 VPIM 16:34:28 1 andy 9003@lax.mycompany.com125 VPIM 16:34:57 1 andy 9002@lax.mycompany.com
Monitoring Notification Queues
To display status information about message notification queues, use the following command in Cisco Unity Express EXEC mode:
show voicemail notification queue {email | phone}
where email displays details about the e-mail queue, and phone displays details about the phone notification queue.
The following example shows output from two version of the show voicemail notification queue command:
se-10-0-0-0# show voicemail notification queue emailOWNER DEVICE TYPE TIMEuser1 Text Pager 723232user1 Email inbox 2323343se-10-0-0-0# show voicemail notification queue phoneOWNER DEVICE TYPE TIMEuser1 Numeric Pager 342343After a job enters one of the queues, you cannot delete the job. The system deletes the job after the notification is sent.
Monitoring Fax Queues
Faxes are always sent in queued mode.To display the fax queue for Cisco Unity Express IVR, use the show ccn subsystem fax outbound fax command in Cisco Unity Express IVR user EXEC mode.
The following example shows sample output from the command:
se-10-0-0-0> show ccn subsystem fax outbound queue
============================================================================
Fax ID Recipient Subject Retry Scheduled
Count Send Time
============================================================================
15 9784551212 subject of Fax - max 30 char 1 2007/05/30 10:52:00
Displaying SNMP and Management Data Activity
If you have not configured Simple Network Management Protocol (SNMP) monitoring on the Cisco Unity Express system, see the procedure in the "Configuring SNMP Monitoring" section on page 325.
Use the following trace commands in Cisco Unity Express EXEC mode to display the SNMP and management data activity:
•
•
The following examples show sample output for these commands:
se-10-0-0-0# trace snmp agent allse-10-0-0-0# show trace buffer tail4280 06/03 10:10:31.035 snmp agnt 1 com.cisco.aesop.mgmt.snmp.SnmpNative.SnmpTableGetLong(CISCO-UNITY-EXPRESS-MIB,cueMboxTable ,cueMboxPercentTimeUsed,0) = cueMboxPercentTimeUsed 4280 06/03 10:10:31.100 snmp agnt 1 com.cisco.aesop.mgmt.snmp.SnmpNative.SnmpTableGetLong(CISCO-UNITY-EXPRESS-MIB,cueMboxTable ,cueMboxNumberOfMessages,1) 4280 06/03 10:10:31.100 snmp agnt 1 com.cisco.aesop.mgmt.snmp.MBeanUtil.invoke(Voicemail:name=Stats,MboxStatsTableValue, <parms>,<signature>) 4280 06/03 10:10:31.109 snmp agnt 1 com.cisco.aesop.mgmt.snmp.SnmpNative.SnmpTableGetLong(CISCO-UNITY-EXPRESS-MIB,cueMboxTable ,cueMboxNumberOfMessages,1) = cueMboxNumberOfMessages 4280 06/03 10:10:31.171 snmp agnt 1 com.cisco.aesop.mgmt.snmp.SnmpNative.SnmpTableGetLong(CISCO-UNITY-EXPRESS-MIB,cueMboxTable ,cueMboxNumberOfMessages,0) 4280 06/03 10:10:31.171 snmp agnt 1 com.cisco.aesop.mgmt.snmp.MBeanUtil.invoke(Voicemail:name=Stats,MboxStatsTableValue, <parms>,<signature>) 4280 06/03 10:10:31.180 snmp agnt 1 com.cisco.aesop.mgmt.snmp.SnmpNative.SnmpTableGetLong(CISCO-UNITY-EXPRESS-MIB,cueMboxTable ,cueMboxNumberOfMessages,0) = cueMboxNumberOfMessages 4280 06/03 10:10:31.241 snmp agnt 1 com.cisco.aesop.mgmt.snmp.SnmpNative.SnmpTableGetLong(CISCO-UNITY-EXPRESS-MIB,cueMboxTable ,cueMboxNumberOfNewMessages,1) 4280 06/03 10:10:31.241 snmp agnt 1 com.cisco.aesop.mgmt.snmp.MBeanUtil.invoke(Voicemail:name=Stats,MboxStatsTableValue, <parms>,<signature>) 4280 06/03 10:10:31.250 snmp agnt 1 com.cisco.aesop.mgmt.snmp.SnmpNative.SnmpTableGetLong(CISCO-UNITY-EXPRESS-MIB,cueMboxTable ,cueMboxNumberOfNewMessages,1) = cueMboxNumberOfNewMessages 4280 06/03 10:10:31.313 snmp agnt 1 com.cisco.aesop.mgmt.snmp.SnmpNative.SnmpTableGetLong(CISCO-UNITY-EXPRESS-MIB,cueMboxTable ,cueMboxNumberOfNewMessages,0) 4280 06/03 10:10:31.313 snmp agnt 1 com.cisco.aesop.mgmt.snmp.MBeanUtil.invoke(Voicemail:name=Stats,MboxStatsTableValue, <parms>,<signature>) 4280 06/03 10:10:31.322 snmp agnt 1 com.cisco.aesop.mgmt.snmp.SnmpNative.SnmpTableGetLong(CISCO-UNITY-EXPRESS-MIB,cueMboxTable ,cueMboxNumberOfNewMessages,0) = cueMboxNumberOfNewMessages 4280 06/03 10:10:31.384 snmp agnt 1 com.cisco.aesop.mgmt.snmp.SnmpNative.SnmpTableGetLong(CISCO-UNITY-EXPRESS-MIB,cueMboxTable ,cueMboxNumberOfSavedMessages,1) 4280 06/03 10:10:31.385 snmp agnt 1 com.cisco.aesop.mgmt.snmp.MBeanUtil.invoke(Voicemail:name=Stats,MboxStatsTableValue, <parms>,<signature>) 4280 06/03 10:10:31.393 snmp agnt 1 com.cisco.aesop.mgmt.snmp.SnmpNative.SnmpTableGetLong(CISCO-UNITY-EXPRESS-MIB,cueMboxTable ,cueMboxNumberOfSavedMessages,1) =cueMboxNumberOfSavedMessages 4280 06/03 10:10:31.454 snmp agnt 1 com.cisco.aesop.mgmt.snmp.SnmpNative.SnmpTableGetLong(CISCO-UNITY-EXPRESS-MIB,cueMboxTable ,cueMboxNumberOfSavedMessages,0) 4280 06/03 10:10:31.455 snmp agnt 1 com.cisco.aesop.mgmt.snmp.MBeanUtil.invoke(Voicemail:name=Stats,MboxStatsTableValue, <parms>,<signature>) 4280 06/03 10:10:31.463 snmp agnt 1 com.cisco.aesop.mgmt.snmp.SnmpNative.SnmpTableGetLong(CISCO-UNITY-EXPRESS-MIB,cueMboxTable ,cueMboxNumberOfSavedMessages,0) =cueMboxNumberOfSavedMessagesse-10-0-0-0# trace management agent allse-10-0-0-0# show trace buffer tail087 06/03 10:18:42.523 mgmt agnt 1 com.cisco.aesop.mgmt.voicemail.JTAPI.getJTAPConnectionStatus out
087 06/03 10:18:42.523 mgmt agnt 1 com.cisco.aesop.mgmt.voicemail.VoiceConnectivity.getUpdateStatus in
087 06/03 10:18:42.523 mgmt agnt 1 com.cisco.aesop.mgmt.voicemail.VoiceConnectviity.update in
087 06/03 10:18:42.524 mgmt agnt 1 com.cisco.aesop.mgmt.voicemail.VoiceConnectivity.udpateTables in
087 06/03 10:18:42.525 mgmt agnt 1 com.cisco.aesop.mgmt.SysdbUtil.get(/sw/protorbcp,device)
087 06/03 10:18:42.526 mgmt agnt 1 com.cisco.aesop.mgmt.SysdbUtil.get(/hw/eth/eh0,ip,addrdefault)
087 06/03 10:18:42.529 mgmt agnt 1 com.cisco.aesop.mgmt.voicemail.JTAPIUtil.gettapiPortStatus in
087 06/03 10:18:42.574 mgmt agnt 1 com.cisco.aesop.mgmt.voicemail.JTAPIUtil.gettapiPortStatus {3504={id=3, implid=3504, state=IDLE}, 3503={id=0, implid=3503,tate=IDLE}, 3502={id=1, implid=3502, state=IDLE}, 3500={id=2, implid=3500, stat=IDLE}}
087 06/03 10:18:42.574 mgmt agnt 1 com.cisco.aesop.mgmt.voicemail.JTAPIUtil.gettapiPortStatus out
087 06/03 10:18:42.576 mgmt agnt 1 com.cisco.aesop.mgmt.SysdbUtil.get(/sw/apps/f/ccnapps/configurations/craAesop/ccnwfapp,wfjtapi,ciscoccnatcallmanager)
087 06/03 10:18:42.581 mgmt agnt 1 com.cisco.aesop.mgmt.voicemail.JTAPIUtil.getctiveCCM in
087 06/03 10:18:42.581 mgmt agnt 1 com.cisco.aesop.mgmt.SysdbUtil.get(/sw/limit,global,applicationMode)
087 06/03 10:18:42.602 mgmt agnt 1 com.cisco.aesop.mgmt.voicemail.JTAPIUtil.getctiveCCM out
087 06/03 10:18:42.604 mgmt agnt 1 com.cisco.aesop.mgmt.SysdbUtil.get(/sw/apps/f/ccnapps/configurations/craAesop/ccnwfapp,wfsip,providerHostname)
087 06/03 10:18:42.607 mgmt agnt 1com.cisco.aesop.mgmt.SysdbUtil.get(/sw/apps/f/ccnapps/configurations/craAesop/ccnwfapp,wfsip,providerHostname)
087 06/03 10:18:42.610 mgmt agnt 1 com.cisco.aesop.mgmt.SysdbUtil.get(/sw/apps/f/ccnapps/configurations/craAesop/ccnwfapp,wfsip,providerPortnumber)
087 06/03 10:18:42.614 mgmt agnt 1 com.cisco.aesop.mgmt.SysdbUtil.get(/sw/limit,global,applicationMode)
087 06/03 10:18:42.615 mgmt agnt 1 com.cisco.aesop.mgmt.voicemail.VoiceConnectivity.udpateTables out
087 06/03 10:18:42.615 mgmt agnt 1 com.cisco.aesop.mgmt.voicemail.VoiceConnectivity.update out
087 06/03 10:18:42.616 mgmt agnt 1 com.cisco.aesop.mgmt.voicemail.VoiceConnectivity.getUpdateStatus outViewing System Activity Messages
Cisco Unity Express captures messages that describe activities in the system.
If you have not configured a syslog server, see the "Configuring a Syslog Server" section on page 294 for the procedure.
The system activities are categorized into four levels of severity depending on their impact on the system's functioning:
•
•
•
•
These messages are collected and directed to three possible destinations:
•
•
•
The external server must be configured to listen for User Datagram Protocol (UDP) on port 514 from the IP address of the Cisco Unity Express module.
Checking AIM Compact Flash Memory Wear Activity
Cisco Unity Express tracks the use and wear of the AIM compact flash memory as log and trace data are saved to the module. To display this data, use the show interface ide 0 command in Cisco Unity Express EXEC mode.
show interface ide 0
The following is sample output:
se-10-0-0-0# show interface ide 0IDE hd0 is up, line protocol is up3496 reads, 46828544 bytes0 read errors9409 write, 137857024 bytes0 write errors0.0993% wornViewing Historical Reports
The Historical Reporting feature enables you to save information and statistics related to call and application events in a historical reporting database on the module. You can use this historical data later to generate various types of usage reports, using the Cisco Unified Communications Express Historical Reporting Client.
For information on how to configure Historical Reporting, see the "Configuring Historical Reporting" section on page 87.
To view historical reports, use the Administration > Historical Reporting option of the GUI. For instructions about using the Cisco Unified Communications Express Historical Reporting Client, see the G online help for the GUI.
Note
Viewing Real Time Reports
The Real Time Reports feature enables you to view real-time statistics for various call-related and application-related events.
To view real-time reports, use the Reports > Real Time Reports option of the GUI. For more information about real-time reports, see the online help for the GUI.
Note
Feedback