Script Sensor (Enterprise Edition only)

<< Click to Display Table of Contents >>

Navigation:  Sensors > Misc Sensors >

Script Sensor (Enterprise Edition only)

With the Script Sensor you can launch a process and gather its output. It is not only possible to execute applications (EXE) and batch files (BAT), it is also possible to directly execute Powershell scripts (PS1) and Visual Basic scripts (VBS).

 

Hints:

When a program is executed on a remote host, the standard output and standard error stream are not available. The only possibility to transfer a value is to use the Exit Code.

If you encounter problems while trying to execute a file on a remote host, please read this article.

 

Sensor Tasks

Test Sensor

Tests the current sensor settings.

Get Help

Opens the ServerSentinel online help for the current sensor.

Basic Settings

Name

The name of the sensor (max. 100 characters). Choose a meaningful name to clearly identify the sensor.

Sensor is Active

Toggles the sensor ON/OFF.

Check Interval

The interval or times at which which the sensor should perform its checks.

Simple

The sensor performs its checks every x time units, e.g. every 10 minutes.

Daily

The sensor performs its checks daily at one or more (max. 4) fixed times, e.g. daily at 0 and 12 o'clock.

Weekly

The sensor performs its checks at certain days of the weeks at one or more (max. 4) fixed times, e.g. monday to friday at 12 o'clock.

Monthly

The sensor performs its checks at certain days of the month at one or more (max. 4) fixed times, e.g. every 1st of the month at 12 o'clock.

Only check if this Sensor didn't fail

This sensor will only be checked, if the sensor in the drop down list didn't fail.

Further Information

Comment

Short additional information to the sensor (max. 255 characters).

Account

Host

The IP address or DNS name of host which should be monitored.

Credentials

Here you can either select an existing credential set or create a new one by inserting a display name, an username and a password.

Process to Start

Executable Path

File to be executed (max. 255 characters).

Working Directory

The directory in which the process should be executed (max. 255 characters).

Program Arguments

Arguments for the process (max. 255 characters).

 

Meta Data Values

Data Value

Data Type

Description

Checktime

Date

The time the dataset has been created.

Exception Message

String

The message of the error if any occurred.

Response Time

Integer

The response time needed to perform the check.

Status

String

A status string that may contain arbitrary information that was collected by the sensor (max. 255 characters). Per default this value is empty.

Status Flag

Enum

The status of the sensor after the check has been performed.

Data Values

Data Value

Data Type

Description

Content of Error Stream

String

The content of the error stream when the application was called.

Content of Output Stream

String

The content of the output stream when the application was called.

Exit Code

Integer

The code the application returned upon quit.

Result

 

The parsed content of the output stream.

The data type depends on the output. For example the data type will be Double if the output is a decimal value.

 

Special Status Flag Behavior

If the data value "Exit Code" is not used in an active condition, it will be interpreted. The "Status Flag" will change to "Error" if the "Exit Code" is non-zero.