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
IMs Sent Per Session
IMs Received Per Session
Total Text Conferencing Rooms
Total AdHoc Group Chat Rooms
Total Persistent Chat Rooms
Per-Chat Room Counters
IMs Received Per Room
Number of Occupants Per Room
SIP Proxy Counters
Number of Idle SIP Proxy Worker Processes
General Performance Monitoring
April 5, 2013
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
•
SIP Proxy Counters
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.
Note
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.
Note
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.
Example:
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"
IMs Sent Per Session
Cisco XCP JSM Session Counters—JsmSessionMessagesIn
This counts the total number of IMs received by the user on his IM client or session.
IMs Received Per Session
Cisco XCP JSM Session Counters—JsmSessionMessagesOut
This counts the total number of IMs sent by the user from his IM client or session.
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"
IMs Received Per Room
Cisco XCP TC Room Counters—TCRoomMsgPacketsRecv
This counter represents the number of IMs received by the room.
Number of Occupants Per Room
Cisco XCP TC Room Counters—TCRoomNumOccupants
This counter gives the current number of occupants of the chat room. Monitor this counter for Persistent Chat rooms to get an indication of the usage trend for the chat room.
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.