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

(1) To create an instance:

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

   The Main window appears.

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

   The Services page appears.

3. From the navigation frame, expand the contents of the Machines directory.

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

   The name of each service is displayed by service ID. For details about service IDs, see C. List of Identifiers, and the section explaining the service naming conventions in the appendix in 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.

4. Expand the contents of the PFM - Agent host directory, and then select Agent Collector service.

   Select host-name<UNIX> (Agent Collector service). A check mark is displayed next to the Agent Collector service.

5. Select the Properties method in the method frame.

   The Service Properties window appears.

6. Select the ADDITION OR DELETION A SETTING tree.

7. Enter an instance name for ADD AN APPLICATION MONITORING SETTING at the bottom of 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 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:

1. After finishing the above procedure, 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.

2. 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 7‒9: Monitoring field properties

   Item	Parameter name	Explanation	Corresponding field in the PD_APP record
   Process type	ProcessXX Kind	Select Execute or Command Line. Note that evaluation is not performed when None is selected. When Execute is selected, the value of the Program field in the PD record is used for evaluation. When Command Line is selected, the value of the Argument List field in the PD 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 whether the application is running. 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 in the PD_APP record) to be reported by alarm. Note that because the value of the ProcessXX Name field in the PD_APP record is the same for all instances, alarms will not be reported properly. Accordingly, instead of using the ProcessXX Name field in the PD_APP record, use the value of the ProcessXX Status field for setting alarm notification. For example settings, see 7.3.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.

   • Alphanumeric characters and symbols can be specified for the ProcessXX Name property.

   • Wildcard characters * and ? can also be specified for the ProcessXX Name property. An asterisk (*) represents zero or more instances of any character, and a question mark (?) represents any single character.

   • When you select Execute for the ProcessXX Kind property, a value equivalent to the Program field of the PD record must be specified for the ProcessXX Name property. The value of the Program field of the PD record is almost equal to the value displayed when the ps -e command is executed. (This value might be different from the command execution result depending on the type and version of the OS.)

   • When you select Command Line for the ProcessXX Kind property, a value equivalent to the Argument List field of the PD record must be specified for the ProcessXX Name property. The value of the Argument List field of the PD record is almost equal to the value displayed when the ps -ef command is executed. (This value might be different from the command execution result depending on the type and version of the OS.)

3. Click the OK button.

   The specified settings are applied.

To Page Top

(3) Setting the range of data for collecting information about the application operating status

When PFM - Agent for Platform is running on a virtualized system, you can set the ADD AN APPLICATION MONITORING SETTING FOR VIRTUAL ENVIRONMENT property to restrict the environment from which process information is to be collected.

1. After creating the instance, display the Service Properties window again and select the ADD AN APPLICATION MONITORING SETTING FOR VIRTUAL ENVIRONMENT tree in the ADDITION OR DELETION A SETTING tree.

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

   Note

   When creating an instance, you can concurrently set ADD AN APPLICATION MONITORING SETTING and ADD AN APPLICATION MONITORING SETTING FOR VIRTUAL ENVIRONMENT.

2. Set properties.

   For details about the properties, see 2.3.22(1) Identifying processes that have the same name in a virtualized system.

   Important

   • The virtual environment ID entered for ADD AN APPLICATION MONITORING SETTING FOR VIRTUAL ENVIRONMENT can be specified by the user. The ID specified here is stored in the Virtual Env ID field of the PD_APP record.

   • In ADD AN APPLICATION MONITORING SETTING FOR VIRTUAL ENVIRONMENT, you can specify a value from 0 to 2147483647. You cannot specify characters.

   • As in the case of ADD AN APPLICATION MONITORING SETTING, a maximum of 64 instances can be created with ADD AN APPLICATION MONITORING SETTING FOR VIRTUAL ENVIRONMENT.

To Page Top