SSH DNS Profile

This profile monitors a UNIX Domain Name Server. DNS services are monitored remotely. Monitoring scripts are installed on the remote server and called from the GroundWork server using the SSH protocol. Please reference SSH document under GroundWork Profiles>SSH Profiles when using this profile.

Services Configuration
  • SERVICE - Definitions in Monarch are stored under this name.
  • COMMAND LINE - Service command name with arguments to be passed to the plugin.
  • PLUGIN COMMAND LINE - Plugin script called by Nagios for this Service.
  • EXTENDED INFO - The Extended Service Info definition, typically used for generating graphs.
    Command lines displayed below are intended to be single line commands.
    Service Command Line Plugin Command Line Extended Info
    udp_dns_expect check_dns_expect!!
    $USER1$/check_dns -t 30 -s $HOSTADDRESS$ -H "$ARG1$" -a "$ARG2$" number_graph
    udp_dns check_dns! $USER1$/check_dns -t 30 -s $HOSTADDRESS$ -H "$ARG1$" number_graph
    ssh_process_named check_by_ssh_process_named $USER1$/check_by_ssh -H $HOSTADDRESS$ -t 60 -l "$USER17$" -C "$USER22$/check_procs -c 1:1 -C named -a /etc/named.conf" percent_graph
Profile Package

This package includes the following files:

Profile Definitions

  • service-profile-ssh-dns.xml
  • perfconfig-ssh-dns.xml

Plugins Scripts on the GroundWork Server

  • check_dns
  • check_by_ssh

Plugins Scripts on the Remote Monitored Server

  • check_procs

Performance Graphing Programs

  • percent_graph.cgi
  • number_graph.cgi

GroundWork Monitor includes many monitoring profiles for a variety of devices, systems and applications. Profiles already imported on a new GroundWork installation include Service Ping, SNMP Network, and SSH UNIX. The GroundWork Monitor Configuration tool is used to import updated Profiles and Profiles that require additional setup; the Profile XML file and its companion Performance Configuration definition file. Services can also be imported in addition to Service Profiles in the Profile Importer. The import process is documented under GROUNDWORK PROFILES > How to import profiles.


This section contains detail settings used by this Profile. These parameters can be altered with the Configuration tool.

Command Parameters

Command parameters are in the Configuration Services section with the following names and default values.


  • Check for the number of named processes running.


  • Queries the assigned Host to get the IP address of a Host. The nslookup program is used to perform the query.
  • $ARG1$ - Host name or IP address to query. (default


  • Queries the assigned host to get the IP address of a host and checks the reply with the expected IP address. The nslookup program is used to perform the query.
  • $ARG1$ - Host name to query. (default
  • $ARG2$ - IP address of the host name (default
Performance Graphing Parameters

The following parameters are used to generate performance charts. These parameters are set using the Configuration>Performance tool in GroundWork Monitor.


  • Graphs the number of running named processes.
  • The Nagios® service description must contain the string "ssh_process".


  • Graphs the response time from the DNS server to query a name.
  • Nagios® service description must contain the string "udp_dns".


  • Graphs the response time from the DNS server to query a known address.
  • Nagios® service description must contain the string "udp_dns_expect".
Implementation Notes

If you are communicating to a remote host that is behind a firewall, make sure the SSH port 22 is allowed to access the remote host.

Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.