check_dns

Runs check_dns to perform nameserver checks. It basically wraps the plugin from https://github.com/mackerelio/go-check-plugins/tree/master/check-dns

Implementation

Windows	Linux	FreeBSD	MacOSX
✅	✅	✅	✅

Examples

Default Check

Alert if dns server does not respond:

check_dns -H labs.consol.de
OK - labs.consol.de returns 94.185.89.33 (A)

Check for specific type from specific server:

check_dns -H consol.de -q MX -s 1.1.1.1
OK - consol.de returns mail.consol.de. (MX)

Example using NRPE and Naemon

Naemon Config

define command{
    command_name         check_nrpe
    command_line         $USER1$/check_nrpe -H $HOSTADDRESS$ -n -c $ARG1$ -a $ARG2$
}

define service {
    host_name            testhost
    service_description  check_dns
    use                  generic-service
    check_command        check_nrpe!check_dns!'-H' 'omd.consol.de'
}

Usage

  check_dns [OPTIONS]

Application Options:
  -H, --host=             The name or address you want to query
  -s, --server=           DNS server you want to use for the lookup
  -p, --port=             Port number you want to use (default: 53)
  -q, --querytype=        DNS record query type (default: A)
      --norec             Set not recursive mode
  -e, --expected-string=  IP-ADDRESS string you expect the DNS server to return. If multiple IP-ADDRESS are returned at
                          once, you have to specify whole string
      --search-path=      Search paths is added to the domains before sending a DNS query. This can be specified
                          multiple times.
      --resolv-conf-file= Path to the resolv.conf file to use. Is not used in Windows. Default is /etc/resolv.conf .
                          (default: /etc/resolv.conf)
  -v, --verbose           Show verbose output.
  -w, --warning=          Warning timeout in seconds, if getting a successfull DNS query takes longer than specified,
                          set return status to warning.
  -c, --critical=         Critical timeout in seconds, if getting a successfull DNS query takes longer than specified,
                          set return status to critical.
  -t, --timeout=          If the program cannot get a successfull DNS response until the specified timeout in seconds,
                          it exits with critical status. (default: 10)

Help Options:
  -h, --help              Show this help message