Server - Custom Checks

Define the amount of time used to calculate the I/O throughput average values. The higher the time you specify, the better occasional peaks will be “flattened”, i.e. may less frequently cause Warning or Critical check status.

Define the file systems you want this Custom Check to monitor. You may use * as a file system to make a single entry for all file filesystems. If you make multiple specifications and a file system matches the same, the threshold values are merged together for each file system and the lowest of each will be the effective one.

Specify the file systems to be included. Wildcards * and ? are supported.

Specify the thresholds, see as well FSUsageWarn and FSUsageWarn. For Unix, you can as well define thresholds for the inodes, see FSNodeWarn and FSNodeCrit.

Specify the thresholds for monitoring the inodes on Unix, see as well FSNodeWarn and FSNodeCrit.

Define the absolute path name of the file monitored in this field. File name substitution is provided in case wildcard characters (like * or ?) are used.

Define a Critical threshold.

Define the absolute path name of the file monitored in this field. File name substitution is provided in case wildcard characters (like * or ?) are used.

Define the check status to be returned if the file exists.

Define the check status to be returned if the file does not exist.

Define the absolute path name of the file monitored in this field. File name substitution is provided in case wildcard characters (like * or ?) are used.

Define the Warning threshold.

Define a Critical threshold.

Performs an HTTP HEAD request, i.e. only the header of the response will be retrieved.

Performs an HTTP GET request. Basic Authentication is supported as well

Performs an HTTP POST request. HTML Form data can be provided URL-encoded

The URL of the site you want to verify.

Set this flag if you want to interpret JavaScript eventually returned with the response.

If you need to define a proxy server in order to access the site defined in the URL field you may fill in this value.

By default, the Avantra Agent uses the string agent/[version] in order to identify as a user agent. Some web servers may restrict access to certain browsers, like the Microsoft Internet Explorer or Mozilla Firefox, or they behave differently using one of these browsers.

Choose HEAD or GET or POST.

In case you have chosen GET in the Method field you may fill in a user name and a password in this field if Basic Authentication is required by the requested URL.

In case you have chosen POST in the Method field, you have to fill in the form data in URL-encoded format.

You may define a value for the connection timeout. The default is 10 seconds. Please note: This is a timeout for the sub-process spawned to perform the connection attempt. The timeout for the HTTP request itself will always be 80% of the defined value.

If filled with a value > 1, all consecutive failed connection attempts will return a Warning check status until the threshold is exceeded. The Check turns to Critical afterwards.

You can filter the response for one or multiple strings by filling in data in this field.

If there is a value defined in the Content must contain string and the string is not found in the response, this check status is returned.

If there is a value defined in the Content must contain string and the string is found in the response, this check status is returned.

Fill in a Warning threshold for the response time.

Fill in a Critical threshold for the response time.

Fill in a Warning threshold if the check shall verify SSL certificate expiry time.

Fill in a Critical threshold if the check shall verify SSL certificate expiry time.

Select the check status to return in case an SSL certificate is invalid.

Hostname or IP address of the JMX application server. If the agent runs on the same host you might use localhost as hostname. Please make sure, that your application server is bound to the hostname or IP address you specify here.

The TCP/IP port of the application server’s JMX remote access.

Name of the user in case required by the remote JMX access.

Password corresponding to User in case required by the remote JMX access.

Object Name of the MBean to be monitored. We recommend that you copy this value from jconsole and paste it here.

The attribute to be monitored of the MBean with Object Name above. Again we recommend that you paste it here.

The expression defines how to calculate a value to be monitored - based on the attributes or Composite Data attribute values. Supported are basic calculations (+ - / *), but no paratheses.

Specify a Warning condition and a threshold for the MBean Attribute Evaluation

Specify a Critical condition and a threshold for the MBean Attribute Evaluation

Specify the custom check result message. If you leave this field blank, a standard message giving the result of the MBean Attribute Evaluation will be displayed.

The JavaScript program providing the check data retrieval and evaluation logic. See section API Documentation.

If this option is enabled, the time to run the script is appended to the check result text. This might be useful to check if the performance of a script is good.

Starting with Avantra Version 21.11, you can run tests for newly created RUN_JS checks on the selected Agent directly from the Avantra WebUI. This feature does not require saving or activating the check, i.e. it can be tested before affecting the execution of the check on other systems.

The type of a Log Adapter.

Select your desired Log Adapter. As soon as you have selected a Log Adapter, the available Macros are loaded and the Expression Editors in various fields are initialized.

If you have selected File Adapter in Log Adapter Type you have to fill in this value, which indicates the path and file name of the target log files.

See Log File Path Pattern.

This setting defines which entries of the log files are to be processed. Log entries written since last check cycle processes all log entries that have been added after the last read of the file. Log entries written in last x minutes reads all entries that have been added during the past Log Entry Timespan minutes.

Fill in the period of time the {avantra-agent} should look back while processing the log file if Log entries written in last x minutes is selected in _Log Adapter Processing>.

Define a conditional expression that indicates log entries considered as Warning.

Define a conditional expression that indicates log entries considered as Critical.

In the Warning Trigger section, this value defines how many entries must be matched to the condition before the check status will be set as Warning. I.e. if there are only 2 entries matching and this value is set to 3, then the check status will be OK. If there are 3 or more entries matching, then the check status will be set as Warning.

Define a conditional expression that indicates log entries that resolve issues found using Warning Condition or Critical Condition.

You can specify the format of the check message shown in RealTime Monitoring or used in Notifications.

Define the display of a matched log entry in the check message. You may enter arbitrary text tokens in the field, and you may use all Macros available for the selected Log Adapter (using the icon) to build a meaningful description text.

Define the amount of time used to calculate the I/O throughput average values. The higher the time you specify, the better occasional peaks will be "flattened", i.e. may less frequently cause Warning or Critical check status.

Define the network interfaces you want to monitor. You may use * as network interface name to make a single entry for all network interfaces. * is a good value for an initial setup, because all network interfaces are then displayed in the check results table including description (if available) and IP address.

Fill in the host name or the IP address of the remote host.

Define a Warning threshold for packet loss.

Define a Critical threshold for packet loss.

Define a Warning threshold for the average round-trip time.

Define a Critical threshold for the average round-trip time.

Define a time out for the Check. The check status will be Critical if the time out is exceeded.

Define the number of ICMP packets to send per Check

Define the size of ICMP echo request packets

Enter the name of the process you want to monitor.

If the number of running processes falls below this threshold, a Critical check status is returned.

If the number of running processes falls below this value, but does not exceed the value defined in Critical alert if number of processes is lower than, a Warning check status is returned.

If the number of running processes exceeds this threshold, but is still below the value defined in Critical alert if number of processes is higher than, a Warning check status is returned.

If the number of running processes exceeds this threshold, a Critical check status is returned. If the field is left blank, no Critical Check Results will be returned.

Define the full command line call to be executed by the Avantra Agent. It is recommended to use absolute path names whenever possible.

/bin/sh "%%PROG_DIR%%/proggy.sh" -param 1 -param 2

"C:\Program Files\system32\cmd.exe" "%%PROG_DIR%%\proggy.cmd" /param 1 /param 2

Define a working directory of the executed script or program.

Define environment variables for the executed script or program. Please note that multiple entries must be separated by commas or semicolons. The format is name ‘=' value { (';' | ',’) name '=’ value}

Define a timeout for the executed script or program.

Use this field to define the exit code of your program that shall indicate an Unknown check status.

If you want the {custom-check} to collect performance data (which must be written to console output by the program), check _Select Performance Resource Type and choose a previously defined custom performance resource type from the list. See Configuring Custom Performance Data Resource Types on how to define custom performance resource types.

Determine whether to return the check status as Ok, Warning, Critical, Unknown if the timeout specified in the Time out setting is exceeded.

Check the box to not display the command line in the check result.

Use the Upload Program button in order to select a script or program to deploy.

Read-only field containing the name of the script or program once it is deployed. The name is displayed as a link that allows you to download the script or program.

Read-only field containing the MD5http://en.wikipedia.org/wiki/Checksum[checksum] of the script or program once it is deployed. This value is used to detect whether the file copied to the target System's filesystem has not been modified.

Read-only field containing the date the script or program was uploaded.

You may define where the script/program is supposed to reside in the target System's filesystem by filling in the appropriate directory.

If you set this flag, the Avantra Agent will take care to remove the script/program once the Custom Check is deleted. The Program Directory is also removed if it is empty.

If you enter a value, the Custom Check will record the Service Availability for use in e.g. Service Level Reports.

If Service Availability is recorded, a Warning check status is usually considered Down. Set this flag if you want the Warning check status to be considered Up instead.

Define the display name or the technical service name in this field. You can find the technical Service Name in the field Service Name of the General tab in the Properties of the respective service.

Select the check status in case the service is running.

Select the check status in case the service exists but is not running.

Select the check status in case the service does not exist.