Real-Time Monitoring Tool Administration Guide for Cisco Unified Presence Release 8.0, 8.5, and 8.6
General Performance Monitoring
Downloads: This chapterpdf (PDF - 185.0KB) The complete bookPDF (PDF - 1.53MB) | Feedback

Table of Contents

General Performance Monitoring

Cisco XCP Counters

Number of Connected XMPP Clients

Number of Connected CAXL Clients

Number of Active Outbound SIP Subscriptions

Number of Active Inbound SIP Subscriptions

Number of IM Sessions

Total IMs

IMs in Last 60 Seconds

Per User/Per Session Counters

Total Text Conferencing Rooms

Total AdHoc Group Chat Rooms

Total Persistent Chat Rooms

Per-Chat Room Counters

SIP Proxy Counters

Number of Idle SIP Proxy Worker Processes

General Performance Monitoring

July 14, 2014

 

This section provides information on some of the more important counters that you can monitor on Cisco Unified Presence. These counters give very useful information about Presence and Instant Messaging traffic rates that Cisco Unified Presence is handling.

Cisco XCP Counters

Number of Connected XMPP Clients

Cisco XCP CM—ConnectedSockets

View the current number of XMPP clients connected to the Cisco UP XCP Connection Manager on an individual Cisco Unified Presence server. This number should rise and fall based on the usage patterns of your deployment. Further investigation may be required if this number is higher than expected for your user base.

Number of Connected CAXL Clients

Cisco XCP Web CM—ConnectedSockets

View the current number of CAXL web clients connected to the Cisco UP XCP Web Connection Manager on an individual Cisco Unified Presence server. This number should rise and fall based on the usage patterns of your deployment. Further investigation may be required if this number is higher than expected for your user base.

Number of Active Outbound SIP Subscriptions

Cisco XCP SIP S2S—S2SSubscriptionsOut

View the current number of active outgoing SIP Subscriptions being maintained by the Cisco UP XCP SIP Federation Connection Manager service on the Cisco Unified Presence server. Monitor this counter if Cisco Unified Presence server is configured for SIP Interdomain Federation or SIP Intradomain Federation.


NoteThe total combined count of SubscriptionsOut and SubscriptionsIn must not rise above 260,000 on any single Cisco Unified Presence server. The total combined count of SubscriptionsOut and SubscriptionsIn must not rise above 260,000 on any single Cisco Unified Presence server.


Number of Active Inbound SIP Subscriptions

Cisco XCP SIP S2S—S2SSubscriptionsIn

View the current number of active inbound SIP Subscriptions being maintained by the Cisco UP XCP SIP Federation Connection Manager service on the Cisco Unified Presence server. Monitor this counter if Cisco Unified Presence server is configured for SIP Interdomain Federation or SIP Intradomain Federation.


NoteThe total combined count of SubscriptionsOut and SubscriptionsIn must not rise above 260,000 on any single Cisco Unified Presence server. The total combined count of SubscriptionsOut and SubscriptionsIn must not rise above 260,000 on any single Cisco Unified Presence server.


Number of IM Sessions

Cisco XCP JSM—JsmIMSessions

This counter gives the total number of IM sessions on the Cisco Unified Presence node across all users. The Presence Engine (PE), which provides presence composition services and rich, always-on, network availability, creates an IM session on behalf of all users at PE start-up time. This is necessary so that network presence events such as Cisco Unified Communications Manager Telephony Presence and Exchange Calendar notifications are reflected in a user's availability even if that user is not logged in to any IM clients.

Every licensed user on a Cisco Unified Presence node has one IM Session for Presence Engine rich presence composition in addition to one IM Session for any logged in clients.

 

There are 100 licensed users on the Cisco Unified Presence node as follows:

  • 50 users are not logged in
  • 40 users are logged in on one IM client
  • 10 users are logged in on two IM clients

This gives a total of 160 IM Sessions comprised of:

  • 100 x 1 for rich Presence Engine sessions
  • 40 x 1 for users logged in on a single client
  • 10 x 2 for users logged in on two clients

Total IMs

Cisco XCP JSM—JsmTotalMessagePackets

This counter gives the total number of IMs handled by the Cisco Unified Presence node across all users.

Note that if user Alice sends an IM to user Bob, and both users are assigned to the same Cisco Unified Presence node, then this IM is counted twice. This is because the XCP Router and Jabber Session Manager treat the two users separately. For example, Alice's privacy rules are applied to the IM before it is delivered to Bob, and Bob's privacy rules are applied to the IM before it is delivered to Bob's client. When Cisco Unified Presence handles an IM it is counted once for the originator and once for the terminator.

If Alice and Bob are assigned to different Cisco Unified Presence nodes and Alice sends an IM to Bob, the IM is counted once on Alice's node and once on Bob's node.

IMs in Last 60 Seconds

Cisco XCP JSM—JsmMsgsInLastSlice

This counter gives the total number of IMs handled by the Cisco Unified Presence node across all users in the past 60 seconds. This counter is reset to 0 every 60 seconds. The same rules for counting IMs for the TotalMessagePackets counter also apply to this counter. Monitor this counter to help identify the busy IM hours in your organization.

Per User/Per Session Counters

Cisco XCP JSM Session Counters

These per session counters only exist for the duration of an IM session or user login. One set of these counters exists for each Presence Engine network availability session, and one set of these counters exists for each client login session. In the example given above for the IMSessions counters, there are 160 different sets of Cisco XCP JSM Session Counters. When a user logs out, or when the Presence Engine is stopped, the associated Cisco XCP JSM Session Counters instance is deleted.

You can use the Cisco XCP JSM Session counters to get a snapshot of all users currently logged in. These counters can be accessed from the CLI using the following command:

admin: show perf list instances "Cisco XCP JSM Session Counters"

Total Text Conferencing Rooms

Cisco XCP TC—TcTotalRooms

This counter represents the total number of Text Conferencing rooms hosted on the node. This includes both AdHoc rooms and Persistent Chat rooms.

Total AdHoc Group Chat Rooms

Cisco XCP TC—TcAdHocRooms

This counter represents the total number of AdHoc chat rooms currently hosted on the node. Note that AdHoc chat rooms are automatically terminated when all users leave the room, so this counter should rise and fall in value regularly.

Total Persistent Chat Rooms

Cisco XCP TC—TcPersistentRooms

This counter represents the total number of Persistent Chat rooms hosted on the node. Persistent Chat rooms must be explicitly terminated by the room owner. You can monitor this counter to identify if the total number of persistent chat rooms is very large and also to help identify if some persistent chat rooms are not being used regularly anymore.

Per-Chat Room Counters

Cisco XCP TC Room Counters

These pre-chat room counters exist only for the lifetime of a chat room. For AdHoc chat rooms, these counter instances are deleted when the AdHoc chat room is terminated. For Persistent Chat rooms, the counter instances are also deleted when the Persistent Chat room is terminated, however persistent chat rooms are long-lived, so they should rarely be terminated.

You can use these per-chat room counters to monitor the usage and participants in Persistent (and AdHoc) chat rooms over their lifetime and can help identify Persistent Chat rooms that are no longer being used frequently.

You can use the Cisco XCP TC Room counters to get a snapshot of all rooms that are currently hosted on the node. These counters can be accessed from the CLI using the following command:

admin: show perf list instances "Cisco XCP TC Room Counters"

SIP Proxy Counters

Number of Idle SIP Proxy Worker Processes

SIP Proxy—NumIdleSipdWorkers

View the current number of idle, or free, SIP worker processes on the Cisco Unified Presence SIP Proxy. This counter gives a good indication of the load being applied to the SIP Proxy on each Cisco Unified Presence server. Monitor this counter if Cisco Unified Presence server is configured for SIP Interdomain Federation or SIP Intradomain Federation.

The number of idle processes can drop to zero on occasion and is not a cause for concern. However, if the number of idle processes are consistently below 5 processes, then it is an indication that the Cisco Unified Presence Server is being heavily loaded and requires further investigation.