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/dnscheckreceiver.md.

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

LevelSignals
developmentmetrics

Attributes

AttributeTypeDescription
dns.domainstringDomain name queried.
dns.rcodeintDNS 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.record.typestringRecord type queried.
dns.resolved.all.ipsstringAll resolved IP addresses.
dns.resolved.ipstringFirst/primary resolved IP address.
dns.serverstringAddress of the DNS server queried.
error.messagestringError message recorded when the DNS check fails.

Data

  • JSON: /data/collector/components/contrib-dnscheckreceiver/contrib-dnscheckreceiver-b3fd55495f77.json
  • Explore: /collector/components/contrib/dnscheckreceiver