InetAddress Ping Platform Service

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

Monitoring an Internet Address

You can set up a platform service to report the availability of a remote host by pinging its internet address. You configure a platform service of type "InetAddress Ping" on the operating system platform of your choice. The Hyperic Agent on that platform pings the address and reports availability under the newly created platform service.

Note these requirements:

  • The Hyperic Agent must run with Java 1.5 or higher.

  • On Unix-like systems, the Hyperic Agent must run as root to ICMP ping some hosts.

Resource Plugin, Functions, and Classes

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

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

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

Configure the InetAddress Ping Service in Hyperic

The InetAddress Ping service type must be manually configured.

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

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

Configuration Properties Page

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

images/download/attachments/79038211/InetAddresPingConfigOptions.png

InetAddress Ping Configuration Options

The tables below define the options in the configuration schema for the "InetAddress Ping" service type. These are the resource attributes that are displayed, and may be edited, on the Configuration Properties page for an InetAddress Ping service, shown above.

name

description

default

optional

type

Notes

Parent Schema

hostname

Hostname

localhost

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

netservices plugin descriptor

sotimeout

Socket Timeout (in seconds)

10

 

int

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

netservices plugin descriptor

InetAddress Ping Metrics

  • Response Time - How long (in ms) it took to determine availability.

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

images/download/attachments/79038211/InetAddressPingMetrics.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.