7.2.5 Settings in the Services tree for collecting information about the operating status of processes

(a) Creating an application

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, select the Services tab.

   The Services tree 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 that host.

   The name of each service is displayed by its service ID. For details about the service IDs, see C. 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 depends on whether the product name display functionality is enabled. For details about the product name display functionality, see the chapter that explains the Performance Management functionality in the JP1/Performance Management Planning and Configuration Guide.

4. Expand the contents of the monitoring agent host directory, and 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 Advanced Application Monitoring > ADDITION OR DELETION A SETTING tree.

7. At the bottom of the information frame, specify an application name for ADD AN APPLICATION MONITORING SETTING.

   The application name, and the character string you specify for it, must conform to the following rules:

   • You can choose any name for the application name. The specified application name is stored in the Application Name field of the PD_APP2 and PD_APPD records and will be used as an identifier for identifying the application. The application name you specify must be unique.

   • The name must consist of 1 to 63 bytes of single-byte alphanumeric and special characters, except for the following characters:

     Tab (\t) \ : ; , * ? " ' < > |

   • A maximum of 64 applications can be set.

8. Click the OK button.

   The application name is generated at the bottom of the Advanced application monitoring > Application monitoring setting tree in the Service Properties window.

(b) Setting the application properties

1. After completing the steps in Creating the application, display the Service Properties window again and select the application name tree generated in the Advanced application monitoring > Application monitoring setting tree.

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

2. Set the application properties.

   Set the virtualized environment identifier, monitoring label, monitoring field, monitoring condition, and minimum and maximum thresholds for the number of processes. You can set information for multiple processes. The following table shows the settings you can specify for the application properties.

   Table 7‒6: Settings for application properties

   Item	Property name	Description	Name of field in corresponding record
   Virtualized environment identifier	Virtual Environment ID#1	If necessary when a virtualized system (such as a container) is used for operation, enter an identifier to identify the virtualized environment. When an environment is specified, monitoring can be limited to processes of the specified environment. For details, see 2.3.22(1) Identifying processes that have the same name in a virtualized system. You can specify one of the following values as an identifier of the virtualized environment: For a zone environment: Specify a value in the range from 0 to 2147483647. For a WPAR environment: Specify a value in the range from 0 to 2147483647. For a Linux container: Specify a 64-character hexadecimal value (a single-byte character string consisting of numbers in the range from 0 to 9 and alphabet letters in the range from a to f). If you want to monitor only the processes running in the host environment, specify 0.	Virtual Env ID field of the PD_APP2 record
   Monitoring label	MonitoringXX Label	Specify a label for identifying the monitoring conditions. All single-byte alphanumeric and special characters can be used except for the tab character (\t). You can specify a maximum of 31 bytes. The default is MonitoringXX,#2 which will be set if nothing is entered. Each monitoring label must be unique.	Monitoring Label field of the PD_APPD record
   Monitoring field	MonitoringXX Field	Select one of Program Name, Command Line, or None. Program Name Evaluate using the value in the Program Name field of the PD_APS record. Command Line Evaluate using the value in the Command Line field of the PD_APS record. None Do not evaluate. The default is None.	Monitoring Field field of the PD_APPD record
   Monitoring conditions#3	MonitoringXX Condition	Enter the conditions for identifying the monitoring target. All single-byte alphanumeric and special characters can be used except for the tab character (\t). You can specify a maximum of 4,096 bytes. The default is one space.	Monitoring Condition field of the PD_APPD record
   Minimum and maximum thresholds for the number of processes	MonitoringXX Range	Enter minimum and maximum threshold values for the number of processes, separated by a hyphen (for example, 1-2). You can specify values from 0 to 65535. The default is 0-0.	Minimum Monitoring Min field of the PD_APPD record Maximum Monitoring Max field of the PD_APPD record

   #1

   This property is displayed only when the OS on which PFM - Agent for Platform is running is Solaris, AIX, or Linux.

   #2

   XX represents a two-digit numeric value in the range 01 through 15 that is set to the numeric value corresponding to the Monitoring Number field in the PD_APPD record.

   #3

   • The wildcards * and ? can be used in process monitoring. An asterisk (*) represents zero or more instances of any character, and a question mark (?) represents any single character.

   • If you enter more than 127 bytes for the monitoring conditions (MonitoringXX Condition) in the settings for collecting information about the operating status of processes, only the first 127 bytes set in the Monitoring Condition field of the PD_APPD record will be displayed. However, monitoring will be performed using the entire monitoring conditions that were set.

   • When the monitoring targets are identified from the monitoring conditions specified in Name, letter case is distinguished by default. For details about changing the setting to distinguish the letter case when the monitoring targets are identified from the monitoring conditions, see 7.2.7 Distinguishing the letter case of monitoring targets.

   • Make sure that the character string you enter in the MonitoringXX Condition property matches what is set in Program Name field of the PD_APS or PD_APSI record, and the Command Line field of the PD_APS record.

   Any character in the source information that is not in the ASCII character set range of 0x20 to 0x7E will be converted to a hash mark (#: 0x23) before it is stored in the Program Name field of the PD_APS or PD_APSI record, and the Command Line field of the PD_APS record. Note that multi-byte characters are processed in single-byte units during conversion. For example, the multi-byte (full-width) letter is converted as follows:

   Source information		Post-conversion information
   Character encoding	Binary	Binary	Character string
   Shift-JIS	8260	2360	#`
   EUC	A3C1	2323	##
   UTF-8	EFBCA1	232323	###

3. Click the OK button.

   The settings are enabled.

(c) Binding an alarm table to the monitoring agent

Finally, bind an alarm table to the monitoring agent in order to monitor information about operating status. The alarm for monitoring information about operating status is the Application Status alarm. Edit it as necessary. For details about the Application Status alarm, see Application Status in 8. Monitoring Templates.

To bind an alarm table:

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 Agents tab.

   The Agents tree appears.

3. In the navigation frame of the Agents tree, select host-name<UNIX> (Agent Collector service).

   A check mark is displayed next to the Agent Collector service.

4. Select the Bind Alarm Table method in the method frame.

   The Bind Alarm Table [Select Alarm Table] window appears.

5. Select an alarm table displayed at the bottom of the UNIX directory, and then click the OK button.

   The alarm table is bound to the monitoring agent.

To monitor the status of a particular process only, you can create an alarm for the following condition expressions.