3.15 HealthCheck

Use the HealthCheck Knowledge Script to monitor the operational status of active services on Cisco Unified Communications servers. Although the script monitors the following services by default, you can choose to exclude any default service, or include any other service not mentioned in the list.

  • Cisco DB

  • Cisco AMC Service

  • Cisco Communications

  • Cisco CDR Agent

  • Cisco CTL Provider

  • Cisco Database Layer Monitor

  • Cisco DRF Local

  • Cisco Extension Mobility

  • Cisco Presence Datastore

  • Cisco Presence Engine

  • Cisco RIS Data Collector

  • Cisco Extension Mobility

  • Cisco Tftp

  • Cisco Presence Engine

  • Cisco Presence Datastore

  • Cisco XCP Router

The script checks the target server to determine whether the default services are configured on that server, and it only monitors the services that are actually configured.

This script raises an event if a stopped service is restarted or fails to restart, or if a service is stopped but the Start service if it is stopped? parameter has not been set to Yes. In addition, this script generates data streams for service availability.

You can exclude default services by specifying those services in the Default services to exclude parameter, and you can include additional services (not listed above by) specifying those services in the Other services to include parameter.

This script is a member of the CiscoUCM recommended Knowledge Script Group (KSG). For more information, see Recommended Knowledge Script Groups.

3.15.1 Resource Object

CiscoUCM_CMServer

3.15.2 Default Schedule

By default, this script runs every two minutes.

If you are running this script as part of the Recommended KSG, do not change the schedule. The schedules for the recommended scripts are staggered to lessen the impact on CPU utilization when you run the KSG.

3.15.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 CiscoUCM_HealthCheck job. The default is 5.

Monitor Services

Default services to exclude

Type the name of any default service you do not want to automatically start. You can specify the names of multiple services, separated by commas.

Other services to include

Type the name of any service you want to automatically start, but is not included in the list of default services. You can specify the names of multiple services, separated by commas.

Start service if it is stopped?

Select Yes to automatically start all stopped default services on Unified Communications servers. Any service you specify in Default services to exclude will not be started. The default is Yes.

NOTE:Only “activated” services can be automatically started. If an administrator has “deactivated” a service, then AppManager cannot start it.

Event Notification

Raise event if service is stopped and should not be started?

Select Yes to raise an event if a monitored service is stopped but Start service if it is stopped? is unchecked. The default is Yes.

Event severity when service is stopped and should not be started

Set the event severity level, from 1 to 40, to indicate the importance of an event in which a monitored service is stopped but Start service if it is stopped? is unchecked. The default is 15.

Raise event if service fails to start?

Select Yes to raise an event if AppManager cannot start a monitored service. The default is Yes.

Event severity when service fails to start

Set the event severity level, from 1 to 40, to indicate the importance of an event in which AppManager cannot start a monitored service. The default is 5.

Raise event if stopped service has been started?

Select Yes to raise an event if AppManager successfully starts a monitored service. The default is Yes.

Event severity when stopped service has been started

Set the event severity level, from 1 to 40, to indicate the importance of an event in which AppManager successfully starts a monitored service. The default is 25.

Raise event if service is deactivated?

Select Yes to raise an event if a monitored service has been deactivated by an administrator. The default is unselected.

Event severity when service is not active

Set the event severity level, from 1 to 40, to indicate the importance of an event in which a monitored service has been deactivated by an administrator. The default is 15.

Skip event notification for uninstalled service

Select No to raise events for uninstalled services. The default is Yes.

Data Collection

 

Collect data for service availability?

Select Yes to collect data for charts and reports. If enabled, data collection returns 0 for a stopped service or 1 for a started service. The default is Yes.

NOTE:This script generates data streams for services running when the job starts or automatically restarted while the job runs. If a service is deactivated when the job starts, no data stream is generated.