This section details the options in the configuration schema for the DNS service type in the netservices plugin descriptor.

A property in the plugin descriptor sets the default value of port for a DNS service to 53.

Table 1. DNS Configuration Options

Name

Description

Default

Optional

Type

Notes

Parent Schema

lookupname

Lookup Name

www.hyperic.com

N/A

N/A

Hostname to use in queries to the DNS service.

dns

pattern

Answer Match

N/A

true

N/A

This setting affects how the agent will determine availability of the DNS service.

If you do not enter a value, if the agent can connect to the DNS service, the agent will report it to be available, even if no Answers are returned.

If you enter an asterisk, the agent will report the DNS service to be available if the service returns an Answer to a query.

If you enter a regular expression or substring, the agent will report the DNS service to be available if it returns an Answer that matches the pattern.

dns

type

Record type

N/A

N/A

enum

The DNS resource record type to use in queries to the DNS service. Selector list values are: A, ANY, CNAME, MX, NS, TXT.

dns

hostname

Hostname

localhost

false

N/A

Hostname of system that hosts the service to monitor. For example: mysite.com

sockaddr

port

Port

A default value for port is usually set for each type of network service by properties in the netservices plugin descriptor.

false

N/A

Port where service listens.

sockaddr

sotimeout

Socket Timeout (in seconds)

10

true

int

The maximum amount of time the agent will wait for a response to a request to the remote service.

sockaddr