2.1.5 Measurement of user-defined services
To measure a service other than the standard Internet services supported by PFM - Agent for Service Response, you must provide a program for measuring the target service's response times, and then register your program as a user command. In PFM - Agent for Service Response, such a program is called a user-defined command. A service that is measured by a user-defined command is called a user-defined service. PFM - Agent for Service Response can measure a user-defined service's response times down to thousandths of a second (3 decimal places).
There are two ways of performing measurement with a user-defined command:
-
By using a numeric value output by the user-defined command as the measurement result
-
By using the user-defined service's execution time as the measurement result
The following figure provides an overview of measurement of a user-defined service.
At startup, PFM - Agent for Service Response's Probe Daemon reads the three files listed below. Measurement results are output to a report file for each measurement condition and then collected by Agent Collector at a specified interval.
-
Probe action condition definition file (esp.conf)
This file defines start options, such as the maximum number of measurement conditions for a PFM - Agent for Service Response probe and the maximum size of a report file. For details, see 8.2 Probe action condition definition file (esp.conf).
-
Measurement condition registration file (esptask.xml)
This file defines the measurement conditions, such as the target's service type, host name, and measurement interval. You define the measurement conditions in PFM - Web Console (or you can define conditions by editing the measurement condition registration file directly). For details about defining conditions in PFM - Web Console, see 4.7 Defining measurement conditions in PFM - Web Console. For details about measurement condition registration file, see 8.3 Measurement condition registration file (esptask.xml).
-
Command registration file (espcommand.xml)
This file registers user-defined commands. For details, see 8.6 Command registration file (espcommand.xml).
PFM - Agent for Service Response calls the user-defined command according to the defined measurement conditions at the defined measurement interval, and takes measurements consecutively in the same manner as when it measures the supported standard Internet services. However, only one item of a user-defined service can be measured. To measure additional item of a single user-defined service, you must create a user-defined command for each item.