HTTP check


HTTP checks run in the agent and can verify whether or not a website is up or down, responds in a certain time, and/or contains specific text on the page.

Also see the related TCP Checks



No installation is required


Edit the http_check.yaml file in your agent’s conf.d directory. The following yaml file will check the StackState home page for the text “Cloud-Scale Monitoring” within 5 seconds. The response time will be available in the metric network.http.response_time.


  - name: My first service
    timeout: 5

    content_match: 'Cloud-Scale Monitoring'
    collect_response_time: true
    skip_event: true

      - env:production
Other settings available include:

urlThe URL to test.
timeoutThe time in seconds to allow for a response.
methodThe HTTP method. This setting defaults to GET, though many other HTTP methods are supported, including POST and PUT.
dataThe data option is only available when using the POST method. Data should be included as key-value pairs and will be sent in the body of the request.
content_matchA string or Python regular expression. The HTTP check will search for this value in the response and will report as DOWN if the string or expression is not found.
reverse_content_matchWhen true, reverses the behavior of the content_match option, i.e. the HTTP check will report as DOWN if the string or expression in content_match IS found. (default is false)
username & passwordIf your service uses basic authentication, you can provide the username and password here.
http_response_status_codeA string or Python regular expression for an HTTP status code. This check will report DOWN for any status code that does not match. This defaults to 1xx, 2xx and 3xx HTTP status codes. For example: 401 or 4\d\d.
include_contentWhen set to true, the check will include the first 200 characters of the HTTP response body in notifications. The default value is false.
collect_response_timeBy default, the check will collect the response time (in seconds) as the metric network.http.response_time. To disable, set this value to false.
disable_ssl_validationThis setting will skip SSL certificate validation and is enabled by default. If you require SSL certificate validation, set this to false.
ignore_ssl_warningWhen SSL certificate validation is enabled (see setting above), this setting will allow you to disable security warnings.
ca_certsThis setting will allow you to override the default certificate path as specified in init_config
check_certificate_expirationWhen check_certificate_expiration is enabled, the service check will check the expiration date of the SSL certificate. Note that this will cause the SSL certificate to be validated, regardless of the value of the disable_ssl_validation setting.
days_warning & days_criticalWhen check_certificate_expiration is enabled, these settings will raise a warning or critical alert when the SSL certificate is within the specified number of days from expiration.
headersThis parameter allows you to send additional headers with the request. Please see the example YAML file for additional information and caveats.
skip_eventWhen enabled, the check will not create an event. This is useful to avoid duplicates with a server side service check. This defaults to false.
no_proxyIf set, the check will bypass proxy settings and attempt to reach the check url directly. This defaults to false.
allow_redirectsThis setting allows the service check to follow HTTP redirects and defaults to true.
tagsA list of arbitrary tags that will be associated with the check. For more information about tags.


Execute the agent info command and verify that the integration check was successful. The output should contain a section similar to the following:

  - instance #0 [OK]
  - Collected 0 metrics, 0 events & 1 service check

Data Collected


The response time of an HTTP request to a given url, tagged by url, e.g. 'url:'.
shown as second