3.3 CUPS_ActiveIMSessions

Use the CUPS_ActiveIMSessions Knowledge Script to monitor the number of active instant message sessions between SIP and XMPP on a Cisco Unified Presence server.

This script raises an event if a counter or instance is not accessible, or if the current number of active instant message sessions exceeds a threshold you set. The script also raises an event if the delta value for active instant message sessions (the amount of present subscriptions minus previous subscriptions) exceeds a threshold. In addition, this script collects data for current and delta values.

3.3.1 Resource Object

CiscoUCM_PresenceApp

3.3.2 Default Schedule

By default, this script runs every five minutes.

3.3.3 Setting Parameter Values

Set the following parameters on the Values tab as needed:

Parameter

How to Set It

General Settings

Job Failure Notification

Event severity when job fails

Set the event severity level, from 1 to 40, to indicate the importance of the failure of the CUPS_ActiveIMSessions job. The default is 5.

Counter Specifications

Name of the object to monitor

Specify the name of the object you want to monitor. The default is Cisco Presence Engine.

Name of the counter to monitor

Specify the name of the performance counter you want to monitor for active instant message sessions. The default is ActiveIMSessions.

Name of the instance(s) to monitor

Specify the name or names of the Unified Presence server instances you want to monitor for active instant message sessions. Separate multiple instance names with commas.

Raise event if counter/instance not found?

Select Yes to raise an event if the script cannot find the specified counter or instance. The default is Yes.

Event severity when counter/instance not found

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the script cannot find the specified counter or instance. The default is 25.

Monitor Current Value

Event Notification

Raise event if current value exceeds threshold?

Select Yes to raise an event if the number of current active instant message sessions exceeds the threshold you set. The default is unselected.

Threshold - Maximum current value

Specify the maximum number of current active instant message sessions that must exist before an event is raised. The default is 500 sessions.

Event severity when current value exceeds threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of current active instant message sessions exceeds the threshold. The default is 10.

Data Collection

Collect data for current value?

Select Yes to collect data about the number of current active instant message sessions for charts and reports. The default is Yes.

Monitor Delta Value

Event Notification

Raise event if delta value exceeds threshold?

Select Yes to raise an event if the delta value for active instant message sessions (the amount of present sessions minus previous sessions) exceeds the threshold you set. The default is unselected.

Threshold - Maximum delta value

Specify the maximum delta value for active instant message sessions that must exist before an event is raised. The default is 100 sessions.

Event severity when delta value exceeds threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the delta value for active instant message sessions exceeds the threshold. The default is 10.

Data Collection

Collect data for delta value?

Select Yes to collect data about the delta value for current active instant message sessions for charts and reports. The default is unselected.