# dns - resolve record

Attempts to resolve the DNS record, and optionally checks the result. Requires `dig` to be installed and on the PATH.

record
  Type:

    string

  Required:

    true

  the DNS name to resolve

record_type
  Type:

    string

  Required:

    false

  Default:

    `A`

  the type of record to request

desired_val
  Type:

    string

  Required:

    false

  if not given, this monitor simply checks the record resolves.

  Give the special value `NXDOMAIN` to check the record does not resolve.

  If you need to check a multivalue response (e.g. MX records), format them like this (note the leading spaces on the continuation lines):

      desired_val=10 a.mx.domain.com
        20 b.mx.domain.com
        30 c.mx.domain.com

server
  Type:

    string

  Required:

    false

  the server to send the request to. If not given, uses the system default.

port
  Type:

    integer

  Required:

    false

  Default:

    `53`

  the port on the DNS server to use