DNS Platform Service

Topics marked with * relate to features available only in vFabric Hyperic.

Monitor a Remote DNS Service

You can configure a platform service of type "DNS" to report the availability of a remote DNS service.

Resource Plugin, Functions, and Classes

The "DNS" service type is managed by Hyperic's netservices plugin and performs the following functions:

  • Metric collection using org.hyperic.hq.plugin.netservices.DNSCollector.

  • Event tracking using the reportEvent method in the Collector class to report DNS error codes and messages.

Configure a DNS Service in Hyperic

The "DNS" service type can be manually configured on an operating system platform.

  1. Navigate to the platform whose Agent will monitor the service.

  2. Select New Platform Service from the Tools menu.

  3. On New Service page, enter a name for the service and select "DNS" from the Service Type pull-down.

  4. Supply all required values on the Configuration Properties page. Configuration options are defined below in DNS Configuration Options.

Configuration Properties Page

The Configuration Properties page for the DNS service type is shown below.

images/download/attachments/79038211/DnsConfigOptions.png

DNS Configuration Options

The tables below document the options in the configuration schema for the DNS service type in the netservices plugin descriptor.
Note: A property in the plugin descriptor sets the default value of port for a DNS service to 53.

name

description

default

optional

type

Notes

Parent Schema

lookupname

Lookup Name

www.hyperic.com

 

Hostname to use in queries to the DNS service.

dns

pattern

Answer Match

true

 

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.

For information on DNS answers, see Information about DNS Answers

dns

type

Record type

 

enum

The DNS resource record type to use in queries to the DNS service. Selector list values are: A, ANY, CNAME, MX, NS, TXT. For record type definitions, see Wikipedia definition of DNS query types

dns

hostname

Hostname

localhost

false

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

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

DNS Metrics

Metric

Defininition

Availability

If no value is specified for the pattern configuration option, the DNS service is considered to be available if the Hyperic agent can contact it, whether or not any Answers are returned. If an asterisk is specified for the pattern option, the service is considered available if at least one Answer is returned. If pattern is set to a substring or regular expression, the service is considered available if at least one Answer returned matches the expression. If Answers are returned that do not match the patter, Availability is reported at the "Warning" level.

Response Time

Time in ms it took to determine availability.

Answers

Number of resource Record(s) which answer the question.

Authority Records

Number of Resource Record(s) which point to the domain authority.

Additional Records

Number of Resource Record(s) which may hold additional information

DNS Monitoring Defaults Page

You can enable and disable metrics, select indicator metrics, and change the collection interval for a resource type on its Monitoring Defaults page. To navigate to a resource type's Monitoring Defaults page:

  1. Click the Administration tab.

  2. Click Monitoring Defaults.

  3. Scroll down to the resource type and click Edit Metric Template.

The Monitoring Defaults page for the DNS service type is shown below:
images/download/attachments/79038211/DnsMetrics.png

Event Tracking

You can enable log tracking for a network service. If you do, the agent will log an event for responses that match the criteria you specify.

To enable log tracking, click the Enable Log Tracking box in the Monitoring section of the Configuration Properties page.

For information about Hyperic log tracking functionality and configuration options, and how to view log events, see Set Up Log Tracking for a Resource.