Monitor a Remote RPC Service

You can configure a platform service of type "RPC" to report the availability of a Remote Procedure Call (RPC) service over the network. The RPC service must be registered with its host's portmapper daemon. You configure the host where the RPC service runs, the name of the service, and the protocol it uses.

Resource Plugin, Functions, and Classes

RPC services are monitored by HQ's netservices plugin:

Monitoring is performed by the org.hyperic.hq.plugin.netservices.RPCCollector class.

Event tracking is performed by the reportEvent method in the Collector class.

Configure the RPC Service in HQ

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

Navigate to the platform whose Agent will monitor the service.

Select New Platform Service from the Tools menu.

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

Configuration Properties Page

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

RPC Configuration Options

The table below documents the options in the configuration schema for the RPC service type in the netservices plugin descriptor.

<option> name in plugin

description in HQ UI

default

optional

type

Notes

Parent Schema

hostname

Hostname

localhost

no

string

IP address or domain name of the RPC host.

rpc

program

RPC program

nfs

no

string

The name by which the program is registered with its host portmapper.

rpc

version

RPC version

2

no

int

rpc

protocol

RPC protocol

any

no

enum

Specifies transport protocol to use to ping the PRC service. Values are "any", "tcp", "udp". If set to "any", Agent will try try TCP first and then UDP, if necessary.

rpc

RPC Metrics

Availability - An RPC service is reported as available if it responds to an RPC ping from the agent.

Response Time - The length of time required to determine service availability.

RPC 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:

Click the Administration tab.

Click Monitoring Defaults.

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

The Monitoring Defaults page for the RPC service type is shown below:

RPC 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.