9.16. Configuration for the dns check

This check tests a name server by resolving a domain name into a IP address and compares it with a given IP

DNS

Explanation

DNS is the enclosing tag for domain names to check

Parent

OSAGENT

allowed values

Count

0 or 1. If you don't define DNS, no dns check will run.

Example
<DNS>
  <HOSTNAME2RESOLVE>
    <NAME>www.google.com</NAME>
    <ERRORLEVEL>ERROR</ERRORLEVEL>
    <NS>194.25.2.129</NS>
  </HOSTNAME2RESOLVE>
  <HOSTNAME2RESOLVE>
    <NAME>www.heise.de</NAME>
    <ERRORLEVEL>ERROR</ERRORLEVEL>
  </HOSTNAME2RESOLVE>
</DNS>
        

COMMAND

Explanation

Sometimes you have to configure your own nslookup command.

Parent

DNS

allowed values

Every command you want. You should write something like "/x/y/z/nslookup $host $nameserver", because the dns check substitutes "$host" and "$nameserver" with the right values.

Count

0 or 1.

Example
<DNS>
  <COMMAND>/specific/nslookup $host $ns</COMMAND>
  <HOSTNAME2RESOLVE>
    <NAME>www.google.com</NAME>
    <ERRORLEVEL>ERROR</ERRORLEVEL>
    <NS>194.25.2.129</NS>
  </HOSTNAME2RESOLVE>
</DNS>
        

HOSTNAME2RESOLVE

Explanation

for every host you want to "lookup" you you define the HOSTNAME2RESOLVE-pair

Parent

DNS

allowed values

Count

As many as you like.

Example

Look at DNS

NS

Explanation

use this entity when you want to specify (check) a other nameserver then the system-wide ns (in /etc/resolv.conf).

Parent

HOSTNAME2RESOLVE

allowed values

an IP-address

Count

0 or 1. If you don't configure ns, the default nameserver of your system will be used (through nslookup)

Example
<DNS>
  <HOSTNAME2RESOLVE>
    <NAME>www.google.com</NAME>
    <ERRORLEVEL>ERROR</ERRORLEVEL>
    <NS>194.25.2.129</NS>
  </HOSTNAME2RESOLVE>
</DNS>
        

NAME

Explanation

specify here your domain name to check (resolve)

Parent

HOSTNAME2RESOLVE

allowed values

an full qualified domain name (as you do it with nslookup)

Count

1

Example
<DNS>
  <HOSTNAME2RESOLVE>
    <NAME>www.google.com</NAME>
    <ERRORLEVEL>ERROR</ERRORLEVEL>
  </HOSTNAME2RESOLVE>
</DNS>