Watchdog: HTTP Reachability
Checks whether a URL returns an expected HTTP status code and measures the response time. Type http, runner Dashboard. Fields, defaults, statuses and messages.
Watchdog: HTTP Reachability
The check requests one of the client's URLs with GET and compares the response status code with a list of expected codes.
| Property | Value |
|---|---|
| Type identifier | http |
| Runner | Dashboard |
| Target in the email | URL (label of the selected URL) |
Fields
| Field | Key | Default | Meaning |
|---|---|---|---|
| URL | client_url_id |
Required. One of the URLs stored on the client | |
| Timeout (seconds) | timeout |
10 |
Request time limit in seconds |
| Expected status codes | expected_status_codes |
200,201,301,302 |
Comma-separated list. Leave empty for the defaults |
If the URL has BasicAuth credentials, the check sends them. The selection marks such URLs with [BasicAuth].
Behaviour
The check verifies the peer's TLS certificate (verify_peer) and follows up to 5 redirects. The status code of the final response is compared.
| Situation | Status | Message |
|---|---|---|
| Status code is in the list | OK |
none |
| Status code is not in the list | FAIL |
Unexpected HTTP status: <code> |
| Connection, TLS or timeout error | FAIL |
Error text |
| No URL selected | UNKNOWN |
No URL selected for this check |
| URL was deleted | UNKNOWN |
URL #<id> not found — was it deleted? |
The result carries the status code and the response time in milliseconds.
Because the check follows up to 5 redirects, the status code compared is normally that of the target page, not of the redirect.