Sensors > Misc Sensors

The SSH Sensor allows you to execute Bash scripts on an unix based target host with using SSH.

Examples on how to use the sensor including some scripts can be found in the Examples-Section.

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).

Connection Settings

Host	IP address or DNS name of host which should be monitored (max. 255 characters).
Port	The port for SSH which should be used to connect to the target host.
Credential	Here you can either select an existing credential set or create a new one by inserting a display name, an username, a password and/or a private key.

SSH Settings

Script	The Bash script which should be executed on the target host.
Parameters	The values for the parameters expected by the script that will be passed to it during execution.
Timeout	The maximum duration the script should be executed in seconds. If the script is still running when the timeout is reached, it will be terminated.

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
Exit Code	Integer	The exit code returned by the shell.
Error Stream Content	String	The content of the error stream returned by the shell.
Output Stream Content	String	The content of the output stream returned by the shell.

Besides the values above also the results of the evaluation of the defined regular expressions will be listed.

SSH Sensor (Enterprise Edition only)