Skip to main content

​
Description

The dns_check probe performs DNS lookups and validates results. Supports record types A, AAAA, CNAME, MX, TXT. Allows custom DNS resolver and expected value assertions.

​
Config fields

FieldTypeRequiredDefaultDescription
typestringYes—Must be "dns_check"
hoststringYes—Domain name to resolve
recordTypestringNo"A"Record type: A, AAAA, CNAME, MX, TXT
resolverstringNosystem resolverCustom DNS resolver (host or host:port). Defaults to :53 if no port
expectedValuesstring[]No—DNS values that must be present in the result. Any missing value → down

​
Metrics

MetricTypeUnitDescription
vms.dns_check.statusstatus—up or down
vms.dns_check.latency_msgaugemsLookup time

​
Example config

{
  "type": "dns_check",
  "host": "app.verolabs.co",
  "recordType": "A",
  "expectedValues": ["10.0.0.10"]
}

​
Notes

  • CNAME trailing dots are automatically stripped before comparison.
  • MX records compare hostname only (no priority).