DHCP Platform Service

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

Monitor a Remote DHCP Service

You can configure a platform service of type "DHCP" to report the availability of a remote Dynamic Host Configuration Protocol (DHCP) server.

Resource Plugin, Functions, and Classes

The DHCP service type is managed by HQ's netservices plugin. The plugin performs the following functions:

  • Metric collection using the org.hyperic.hq.plugin.netservices.DHCPCollector class.

  • event tracking using the reportEvent method in the Collector class.

Configure the DHCP Service in HQ

You manually configure an DHCP service, on supported Unix-like platforms.

  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 "DHCP" from the Service Type pull-down.

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

Configuration Properties Page

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


DHCP Configuration Options

The tables below document the options in the configuration schema for the DHCP service type.

Properties in the plugin descriptor set default values for:

  • port to 67

  • hostname to - This is the IP limited broadcast address. Packets will be broadcast to all NICs on the some network segment as the source NIC, and not forwarded by a router. You can also use the IP address of a specific DHCP server.

<option> name






Parent Schema


Hardware (MAC) Address



If MAC address is supplied, the plugin will issue a request for the IP address mapped to the MAC address on the DHCP Server. If the DHCP client request packet will be forwarded by a router to a DHCP server in a different subnet, the router must support static allocation.






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




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


Port where service listens.



Socket Timeout (in seconds)




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


DHCP Metrics

  • Availability - The DHCP service is considered available if the DHCP server issues an IP address lease offer in response to a DHCP DISCOVER from the DHCPClient class.

  • Response Time - The time (in ms) it took to determine service availability.

DHCP 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 DHCP service type is shown below:


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 HQ log tracking functionality and configuration options, and how to view log events, see Set Up Log Tracking for a Resource.