...
External Check
The External Check monitor captures asynchronous events. Uptime Infrastructure Monitor does not actively monitor these events by polling or initiating service checks; instead, External Check monitors rely on an external event to generate the information that the monitors capture. External Check monitors enable you to determine when to collect service data for the event that you specify.
After you define an External Check monitor, it has a status of UNKNOWN until the it is updated with a URI similar to the following template:
Code Block |
---|
http://$UPTIME_HOST:9996/command?command=externalcheck&name=$ELEMENT$MONITOR_NAME&status=$STATUS&message=$MESSAGE&hostname=$MONITOR$ELEMENT_NAME |
$UPTIME_HOST
: the hostname of the Uptime Infrastructure Monitor Monitoring Station
$ELEMENT_NAME
: the hostname (not display name) of the system the External Check is assigned to
$STATUS
: an integer indicating the status of the monitor: 0 = OK, 1 = WARN, 2 = CRIT
$MESSAGE
: the message explaining the status
$MONITOR_NAME
: the name of the External Check monitor
A sample script, extevent.pl
, is included with Uptime Infrastructure Monitor in the /scripts
subdirectory, and serves as an example of how to automate the receiving of asynchronous events, and update the External Check monitor accordingly. When the script is called with the appropriate arguments, it connects to Uptime Infrastructure Monitor command port (9996), and updates the status, triggering the appropriate Alert Profiles and Action Profiles.
Info |
---|
Before using an External Check monitor, contact IDERA Customer Support for assistance. You need specific detailed instructions for configuring this monitor depending on the nature of the applications that generate asynchronous events for Uptime Infrastructure Monitor. |
Configuring External Check Monitors
To configure External Check monitors, do the following:
- In the External Check monitor template, complete the monitor information fields.
To learn how to configure monitor information fields, see Monitor Identification. - Complete the following settings:
- Timing Settings (see Adding Monitor Timing Settings Information for more information)
- Alert Settings (see Monitor Alert Settings for more information)
- Monitoring Period settings (see Monitor Timing Settings for more information)
- Alert Profile settings (see Alert Profiles for more information)
- Action Profile settings (see Action Profiles for more information)
- Click Finish.
...