External Command Check

General information

This check can run and monitor the exit code of an external command or a batch script. You can either easily develop your own basic plug-ins to use them with this check or use any console utility which can report its status using the application exit code.

Status Conditions

• Successful - The external command check is considered successful if the external command exit code meets the specified criteria. To learn more about how these criteria can be set, see below in this article.
• Failed - The external command check is considered failed if the external command exit code does NOT meet the specified criteria. To learn more about how these criteria can be set, see below in this article.

Check Settings

Besides the standard properties, you should specify the following ones for this check:

• Program File - The path to the file that is to be executed. You can use message formatting patterns to pass additional information about from a particular check into your program or batch script. This property supports System Environment Variables.
• Startup Directory - If the Use startup directory check box is selected, you can specify where to start your program in case the alert is activated. Otherwise, your command will be executed in the current directory. In most cases it is the directory where NetEagle.exe is located. This property supports System Environment Variables.
• Failure Condition - You should enter the appropriate value of exit code into the right edit box (see the picture below) and select a criteria from the drop-down list: less, more, equal or not equal. For example, if you enter 5 and select less, this check will be failed for all exit codes less then 5.
• Priority - Process priority for the specified command.
• Window Show State - This property is for windowed applications only. Select the state for the window after the application is launched.
• Do not create console window - Select this check box if you want the console application to be run hidden (without showing its console).
• Terminate the external program when the check is stopped - Select this check box if you want to close the external program if the check is going to be terminated. Otherwise, the external program will be allowed to continue its work.