Liveness Test

You can use liveness tests to determine whether your servers are live or down. Liveness testing is optional and not available with all property types.

Liveness Test
Field Function
Enabled Click the Enabled checkbox to allow (enable) the liveness test for the selected property. Uncheck the box to disable the liveness test for the selected property.
Test Name Specifies a name for the liveness test. This field is required.
Test Interval Specifies, in seconds, how often liveness tests are run. The default is 60 seconds.
Test Timeout Specifies, in seconds, how long the servermonitor waits without getting a response before declaring a timeout error. The default is 25 seconds. See Timeout back off for more information.
Port Specify the port number for requesting the test object or accept a protocol's default port. The default port varies depending on which protocol you select.
Note: You can override the default port but you will get a Nonstandard Port warning in yellow next to the port number.
Protocol Specifies the protocol used to monitor servers. You can select from the following protocols. The port defaults are in parentheses.
  • DNS (port 53)
  • FTP (port 21)
  • HTTP (the default; port 80)
  • HTTPS (port 443)
  • POP (port 110)
  • POPS (port 995)
  • SMTP (port 25)
  • SMTPS (port 465)
  • TCP (port default not specified)
  • TCPS (port default not specified)
Test Object Path Specify a valid local path to the test object. Enter only the local part of the test object, for example, /storage/data/examples.html.
HTTP Headers Select one or more HTTP headers from a standard list of HTTP header options. In the Name field pull-down menu, choose an HTTP header and specify its value. Click the green plus sign (+) next to a header row to see a new row from which you can choose additional HTTP headers.
Note: The HTTP headers option is available only when you select HTTP and HTTPs protocols.

Optionally, you can choose Other … , which allows you to specify one or more customized HTTP headers. The customized header name must contain only letters, digits, hyphens, underscores, and dots. Blank spaces causes an error when you try to submit and validate the changes. To return to the Name field pull-down menu, click the arrow located to the left of the header text field.

To verify the validity of the selected HTTP headers, click the Validate HTTP Headers button before you save the liveness test.

For detailed descriptions of standard HTTP headers, see https://www.w3.org/Protocols/HTTP/HTRQ_Headers.html.

HTTP/FTP Errors Specify the ranges of response codes to consider when using HTTP, HTTPS, or FTP test protocols.
Authentication Defines authentication of a liveness test. This is optional but if used both the username and password fields must be entered.
Save Liveness Test Click the Save Liveness Test button. The new liveness test name appears in the Liveness Test table. Click the Add to Change List button.
These protocols have fields not shown on the Liveness Test page.
DNS and TCP/TCPS protocol fields
Protocol Fields
DNS
  • Record Type: Click and select an option from: A, AAAA, AFSDB, CNAME, DNSKEY, DS, HINFO, LOC, MX, NAPTR, NS, NSEC3, NSEC3PARAM, PTR, RP, RRSIG, SOA, SPF, SRV, SSHFP, TXT, or Other Type
  • Numeric Type: This field appears only when you select the DNS protocol and select Other Type from the Record Type menu. The default is 0, which is not valid. You must change the 0 value to an integer value between 1 and 65535.
  • DNS Name: Enter a single, valid DNS name. This is required.
  • Answers Required: If you check this, the liveness test will fail if the server returns no answers. If you leave it unchecked, the liveness test will succeed if the server returns a response with a success (status) code, even if the response contains no answers. The default is false.
  • Recursion Requested: Click the checkbox if you want recursion. The default is false.
TCP/TCPS TCP and TCPS Test Strings: You can specify a request and response string to use in the liveness tests. When the servermonitor performs the test, it connects to the server at the port you specified. If no request or response string is supplied, the test succeeds at this point. If a request string is specified, servermonitor then sends the request string and waits for the server to send a response. If the response contains the response string in the first 8K characters of the response, then the liveness test succeeds, otherwise it fails.
Note: If you select one of the secure protocols for a liveness test (HTTPS, POPS, SMTPS, and TCPS), you can upload an SSL certificate for that test. See Upload an SSL certificate for a liveness test for more information.
Note: If you select the HTTPS protocol, the Certificate Verification checkbox appears below the Protocol field. Click the checkbox to verify the validity of an SSL certificate. This prevents sending traffic to an origin that is up but has an invalid or bad certificate, which can cause failure on the clients if they are sent to the origin.