dns

Reference for the `dns` collector.

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

Resolves a hostname and reports status and latency.

Options

OptionTypeDefaultDescription
hoststringrequiredhostname to resolve

Metrics

MetricKindUnitDescription
dns.statusbool—true if resolution succeeded. Labels: host.
dns.latencynumericsecondsresolution time in seconds. Labels: host.

Examples

Probe upstream DNS

[[collectors]]
name = "dns-google"
kind = "dns"
interval = 30
[collectors.opts]
host = "google.com"

Resolution failures

[[alerts]]
expr = 'dns-google::dns.status is "false"'
count = 2
channel = "ops"

Slow resolution

[[alerts]]
expr = "dns-google::dns.latency > 500ms"
count = 3
channel = "ops"