monitor

The monitor entry point typically contains the code to determine status of the resource. For example, the monitor entry point of the IP agent checks whether or not an IP address is configured, and returns the state online, offline, or unknown.

The framework calls the monitor entry point after completing the online and offline entry points to determine if bringing the resource online or taking it offline was effective. The agent framework also calls this entry point periodically to detect if the resource was brought online or taken offline unexpectedly. Under normal circumstances, the monitor runs every sixty seconds when a resource is online, and every 300 seconds when a resource of expected to be offline.

The monitor entry point receives a resource name and ArgList attribute values as input (see ArgList).

It returns the resource status (online, offline, or unknown), and the confidence level 0–100. The confidence level is informative only and is not used by VCS. It is returned only when the resource status is online.

A C++ entry point can return a confidence level of 0–100. A script entry point combines the status and the confidence level in a single number. For example:

• 100 indicates offline.
• 101 indicates online and confidence level 10.
• 102 indicates online and confidence level 20.
• 103–109 indicates online and confidence levels 30–90.
• 110 indicates online and confidence level 100.

If the exit value of the monitor script entry point falls outside the range 100–110, the status is considered unknown.