DNS

Performs queries to a DNS server, typical use cases include:

• Checking the latency of the DNS server in a Kubernetes cluster
• Verifying that there are serving records for a DNS based load balancer.

dns-check.yaml

apiVersion: canaries.flanksource.com/v1
kind: Canary
metadata:
  name: dns-check
spec:
  interval: 30
  dns:
    - name: A record query
      server: 8.8.8.8
      port: 53
      query: "1.2.3.4.nip.io"
      querytype: "A"
      minrecords: 1
      exactreply: ["1.2.3.4"]
      timeout: 10
      thresholdMillis: 1000

Field	Description	Scheme	Required
server	Address of DNS server to query e.g. 8.8.8.8	string	Yes
port	Port to query DNS server on, e.g. 53	int	Yes
query	Domain name to lookup	string	Yes
querytype	Record type to query e.g. A, CNAME, TXT, SRV	string	Yes
exactreply	Expected exact match result(s)	[]string
minrecords	Minimum records	int
thresholdMillis	Threshold response time from DNS server	int
timeout	Timeout in seconds	int
name	Name of the check, must be unique within the canary	string	Yes
description	Description for the check	string
icon	Icon for overwriting default icon on the dashboard	string
labels	Labels for check	map[string]string
test	Evaluate whether a check is healthy	Expression
display	Expression to change the formatting of the display	Expression
transform	Transform data from a check into multiple individual checks	Expression
metrics	Metrics to export from	[]Metrics