http

Reference for the `http` collector.

http · collector · run nanook doc http for the same content in your terminal.

Performs an HTTP request and reports status, response code, and latency.

Options

Option	Type	Default	Description
`url`	string	required 🔒	target URL
`timeout`	string	`5s`	request timeout (e.g. `5s`, `30s`)
`success`	expr	`http.code between [200, 299]`	nanook-expr predicate over `http.code` and `http.latency` [nanook-expr]

Metric	Kind	Unit	Description
`http.status`	bool	—	true if the request succeeded. Labels: `url`.
`http.code`	numeric	—	HTTP response code. Labels: `url`.
`http.latency`	numeric	`seconds`	request latency in seconds. Labels: `url`.

[[collectors]]
name = "api"
kind = "http"
interval = 30
[collectors.opts]
url = "https://api.example.com/health"
timeout = 3000

[[collectors]]
name = "homepage"
kind = "http"
interval = 60
[collectors.opts]
url = "https://example.com"
success = "http.code between [200, 399]"

[[alerts]]
expr = "api::http.latency > 1s"
count = 3
channel = "ops"

[[alerts]]
expr = 'api::http.status is "false"'
count = 2
channel = "ops"
escalate = { after = 300, channel = "oncall" }