6.7.1 User-defined record settings for collecting application operating status information settings

The following explains how to specify the user-defined record settings for collecting information about the application operating status.

To perform setup, first create an instance, and then set the instance properties (such as the monitored application name and threshold).

Organization of this subsection

(1) To create an instance
(2) To set instance properties

(1) To create an instance

From the monitoring console browser, log in to PFM - Web Console.

The Main window appears.
In the navigation frame of the Main window, click the Services tab.

The Services page appears.
From the navigation frame, expand the contents of the Machines folder.

A folder that has the name of the host on which the Performance Management service is installed appears. Expand this folder to display the services installed on the host.

The name of each service is displayed by service ID. For details about service IDs, see B. List of Identifiers, and the section that explains the service naming conventions in the appendix of the JP1/Performance Management Planning and Configuration Guide.

The format of the service ID differs depending on whether the product name display functionality is enabled. For details about the product name display functionality, see the chapter explaining Performance Management functionality in the JP1/Performance Management Planning and Configuration Guide.
Expand the contents of the PFM - Agent host folder, and then select the Agent Collector service.

Select host-name<Windows> (Agent Collector service). A check mark is displayed next to the Agent Collector service.
Select the Properties method in the method frame.

The Service Properties page appears.
Select the ADDITION OR DELETION A SETTING tree.
Enter an instance name for ADD AN APPLICATION MONITORING SETTING in the information frame, and click the OK button.

An instance name tree is generated in the Application monitoring setting tree of the Service Properties window.
Important
- The instance name entered for ADD AN APPLICATION MONITORING SETTING can be specified by the user. The instance name specified here is stored in the Application Name field of the PD_APP record, and is used as an ID to identify the application.
- In ADD AN APPLICATION MONITORING SETTING, you can specify a character string of 1-63 bytes. The character string can consist of alphanumeric characters and symbols except the following characters:
  
  Tab (\t) \ : ; , * ? " ' < > |
- You can set a maximum of 64 instances.

To Page Top

(2) To set instance properties

After finishing the above step for setting the instance properties, display the Service Properties window again and select the instance name tree generated in the Application monitoring setting tree.

The property information entry window appears at the bottom of the information frame.

Set properties.

Set the process type, process name, and minimum and maximum values for the process count. You can set information for multiple processes. The following table lists the properties you can set.

Table 6‒10: Monitoring field properties
Item	Parameter name	Explanation	Corresponding field in the PD_APP record
Process type	`ProcessXX` `Kind`	Select either Command Line or Service Name. Note that evaluation is not performed when None is selected. When Command Line is selected, the value of the Program field in the PD record is used for evaluation. When Service Name is selected, the Service Name field of the PD_SVC record is used for evaluation.	`ProcessXX` `Kind`
Process name	`ProcessXX` `Name`	Specify a process name of no more than 127 bytes.	`ProcessXX` `Name`
Minimum and maximum thresholds for the number of processes	`ProcessXX` `Range`	Specify the minimum and maximum thresholds for the number of processes in the format `m-n` (for example, `1-2`). Only one value can be specified without a hyphen to set the minimum value and maximum value to the same value. For example, when `10` is specified, `10-10` is set. You can specify values in the range from 0 to 65535.	`ProcessXX` `Range`

Legend:: XX: A two-digit numeric value in the range from 01 to 15

Important

The value specified for the ProcessXX Name property is used to evaluate the application operating status. Note that when the ProcessXX Name field in the PD_APP record is displayed in a report in PFM - Web Console, only the first 31 bytes are displayed.
If there are multiple processes for which the first 31 bytes of each name are the same, set up an instance for each process so that the process can be monitored, and set the evaluation results (the value of the ProcessXX Name field for the PD_APP record) to be reported by alarm. Note that because the value of the ProcessXX Name field in the PD_APP records is the same for all instances, alarms will not be reported properly. Accordingly, instead of using the ProcessXX Name field in the PD_APP records, use the value of the ProcessXX Status field for setting alarm notification. For example settings, see 6.7.4(4) Monitoring whether a given process is running when there are multiple processes for which the first 31 bytes of the names are the same.
All alphanumeric and special characters can be used to specify the ProcessXX Name property, except for the following:

Tab (\t) \ : ; , " ' < > |
Wildcard characters * and ? can also be specified in the ProcessXX Name property. An asterisk (*) represents zero or more instances of any character, and a question mark (?) represents any single character.
Do not specify a Windows program extension (such as .exe) for the ProcessXX Name property.

Click the OK button.

The specified settings are applied.

To Page Top