DNS Check Receiver
OpenTelemetry Collector receiver · contrib distribution
The DNS Check Receiver can be used for synthetic checks against DNS servers.
- Component ID:
contrib-dnscheckreceiver - Name:
dnscheckreceiver - Type: receiver
- Distribution: contrib
- Repository:
opentelemetry-collector-contrib
Stability
| Level | Signals |
|---|---|
| development | metrics |
Metrics
| Metric | Type | Value type | Unit | Stability | Enabled | Attributes | Description |
|---|---|---|---|---|---|---|---|
dnscheck.duration | gauge | int | ms | development | yes | Round-trip duration of the DNS query. | |
dnscheck.error | sum | int | {error} | development | no | error.message (string) | Number of errors recorded during the DNS check. |
dnscheck.status | sum | int | 1 | development | yes | dns.rcode (int), dns.resolved.all.ips (string), dns.resolved.ip (string) | 1 if the DNS query returned successfully, 0 otherwise. The dns.resolved.ip and dns.resolved.all.ips attributes are only present when the value is 1 and the record type is A or AAAA. The dns.rcode attribute is present whenever a response was received from the server, including non-success responses such as NXDOMAIN, SERVFAIL, or REFUSED; it is absent only when no response was received at all (e.g. timeout or network unreachable). |
Attributes
| Attribute | Type | Description |
|---|---|---|
dns.rcode | int | DNS response code (RCODE) returned for the query. Only present when a response was received from the server, including non-success responses such as NXDOMAIN, SERVFAIL, or REFUSED. Absent when no response was received at all (e.g. timeout or network unreachable). See the RCODE Reference table in the README for the meaning of each value, based on the IANA DNS Parameters registry (https://www.iana.org/assignments/dns-parameters/dns-parameters.xhtml#dns-parameters-6). |
dns.resolved.all.ips | string | All resolved IP addresses. |
dns.resolved.ip | string | First/primary resolved IP address. |
error.message | string | Error message recorded when the DNS check fails. |