This documentation has an index for AI agents at /llms.txt. A Markdown version of this page is available at https://explorer.opentelemetry.io/collector/components/contrib/httpcheckreceiver.md.

HTTP Check Receiver

OpenTelemetry Collector receiver · contrib distribution

The HTTP Check Receiver can be used for synthetic checks against HTTP endpoints.

Component ID: contrib-httpcheckreceiver
Name: httpcheckreceiver
Type: receiver
Distribution: contrib
Repository: opentelemetry-collector-contrib

Stability

Level	Signals
alpha	metrics

Metrics

Metric	Type	Value type	Unit	Stability	Enabled	Attributes	Description
`httpcheck.client.connection.duration`	gauge	int	ns	development	no	`http.url` (string), `network.transport` (string)	Time spent establishing TCP connection to the endpoint.
`httpcheck.client.request.duration`	gauge	int	ns	development	no	`http.url` (string)	Time spent sending the HTTP request to the endpoint.
`httpcheck.dns.lookup.duration`	gauge	int	ns	development	no	`http.url` (string)	Time spent performing DNS lookup for the endpoint.
`httpcheck.duration`	gauge	int	ms	development	yes	`http.url` (string)	Measures the duration of the HTTP check.
`httpcheck.error`	sum	int	{error}	development	yes	`error.message` (string), `http.url` (string)	Records errors occurring during HTTP check.
`httpcheck.response.duration`	gauge	int	ns	development	no	`http.url` (string)	Time spent receiving the HTTP response from the endpoint.
`httpcheck.response.size`	gauge	int	By	development	no	`http.url` (string)	Size of response body in bytes.
`httpcheck.status`	sum	int	1	development	yes	`http.method` (string), `http.status_class` (string), `http.status_code` (int), `http.url` (string)	1 if the check resulted in status_code matching the status_class, otherwise 0.
`httpcheck.tls.cert_remaining`	gauge	int	s	development	no	`http.tls.cn` (string), `http.tls.issuer` (string), `http.tls.san` (slice), `http.url` (string)	Time in seconds until certificate expiry, as specified by `NotAfter` field in the x.509 certificate. Negative values represent time in seconds since expiration.
`httpcheck.tls.handshake.duration`	gauge	int	ns	development	no	`http.url` (string)	Time spent performing TLS handshake with the endpoint.
`httpcheck.validation.failed`	sum	int	{validation}	development	no	`http.url` (string), `validation.type` (string)	Number of response validations that failed.
`httpcheck.validation.passed`	sum	int	{validation}	development	no	`http.url` (string), `validation.type` (string)	Number of response validations that passed.

Attributes

Attribute	Type	Description
`error.message`	string	Error message recorded during check
`http.method`	string	HTTP request method
`http.status_class`	string	HTTP response status class
`http.status_code`	int	HTTP response status code
`http.tls.cn`	string	The commonName in the subject of the certificate.
`http.tls.issuer`	string	The entity that issued the certificate.
`http.tls.san`	slice	The Subject Alternative Name of the certificate.
`http.url`	string	Full HTTP request URL.
`network.transport`	string	OSI transport layer or inter-process communication method.
`validation.type`	string	Type of validation performed (contains, json_path, size, regex)

Data

JSON (latest): /data/collector/components/contrib-httpcheckreceiver/latest.json
JSON (pinned): /data/collector/components/contrib-httpcheckreceiver/contrib-httpcheckreceiver-ad775c288c8d.json
Explore: /collector/components/contrib/httpcheckreceiver