HTTP check type

Grafana Cloud

HTTP and HTTPS

HTTP and HTTPS checks are used to test websites. Uptime and response latency are measured like other check types. These checks can also be configured for more advanced tests like if a site is using a specific version of SSL, for SSL certificate expiration, or if HTTP automatically redirects to HTTPS.

Additionally there’s a specialized type called “MultiHTTP” that supports testing multiple URLs in a single check.

Options

HTTP checks have the following additional settings:

HTTP settings

Option name	Description
Request method	The HTTP method the probe will use
Request body	The body of the HTTP request
Request headers	The set of headers to send with the request
Compression algorithm	The compression algorithm to expect in the response
Proxy URL	The URL of the proxy used to connect to the target
Proxy connect headers	Name/value pairs of headers to send to the proxy

These configuration options do not produce any additional labels in the resulting metrics.

Compression

If you specify a compression algorithm, the body response is required to contain a header matching that value and the body itself must be compressed using that algorithm. The check will fail if that’s not the case.

TLS config

Option name	Description
Disable target certificate validation	Whether to validate the certificate that is presented
Server name	The server name used during certificate validation
CA certificate	The certificate for the certificate authority
Client certificate	The client certificate to present during authentication
Client key	The corresponding key for the client certificate

Authentication

Option name	Description
Include bearer authorization header in request	Use bearer authentication
Include basic authorization header in request	Use basic authentication

Validation

Option name	Description
Valid status codes	Status codes considered as valid responses (defaults to 2xx)
Valid HTTP versions	HTTP versions considered as valid responses
SSL options	Whether to require or reject SSL (defaults to ignore)
Regex validations	Set of regular expression validations

For each regular expression validation, you have to specify whether to match a header or the body of the response. In either case, you have to specify a regular expression (using Go’s Syntax). The logic of the match can be inverted; normally the check will fail if the header or body matches the provided regular expression, but with invert match selected, the check will fail if the header or body does not match the provided regular expression. For header matches, you can also specify that a missing header does not cause the check to fail.

Avanced options

Option name	Description
IP version	The Internet Procotol version to use (V4, V6 or any)
Follow redirects	Whether to follow redirects or to stop at the first response
Cache busting query parameter name	The name of the parameter appended to the URL to prevent caching

Metrics

Metric name	Description
probe_all_duration_seconds	Returns how long the probe took to complete in seconds (histogram)
probe_all_success	Displays whether or not the probe was a success (summary)
probe_dns_lookup_all_time_seconds	Returns the time taken for probe dns lookup in seconds (histogram)
probe_dns_lookup_time_seconds	Returns the time taken for probe dns lookup in seconds
probe_duration_seconds	Returns how long the probe took to complete in seconds
probe_failed_due_to_regex	Indicates if probe failed due to regex
probe_http_all_duration_seconds	Duration of http request by phase, summed over all redirects (histogram)
probe_http_content_length	Length of http content response
probe_http_duration_seconds	Duration of http request by phase, summed over all redirects
probe_http_redirects	The number of redirects
probe_http_ssl	Indicates if SSL was used for the final redirect
probe_http_status_code	Response HTTP status code
probe_http_uncompressed_body_length	Length of uncompressed response body
probe_http_version	Returns the version of HTTP of the probe response
probe_ip_addr_hash	Specifies the hash of IP address. It’s useful to detect if the IP address changes.
probe_ip_protocol	Specifies whether probe ip protocol is IP4 or IP6
probe_ssl_earliest_cert_expiry	Returns last SSL chain expiry in unixtime
probe_ssl_last_chain_expiry_timestamp_seconds	Returns last SSL chain expiry in timestamp
probe_ssl_last_chain_info	Contains SSL leaf certificate information
probe_success	Displays whether or not the probe was a success
probe_tls_version_info	Returns the TLS version used or NaN when unknown
sm_check_info	Provides information about a single check configuration