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

This section describes the settings that are specified in the Services tree of PFM - Web Console for collecting information about the operating status of processes, as well as how to check, modify, and delete the settings.

Organization of this subsection
(1) Setting user-defined records (monitoring targets)
(2) Checking or changing the settings in a user-defined record (monitoring target)
(3) Deleting a user-defined record (monitoring target)

(1) Setting user-defined records (monitoring targets)

To set a monitoring target:

  1. Create an application.
  2. Set the application's properties (such as the application name and threshold values to be monitored).
  3. Bind an alarm table to the monitoring agent#
#
Alarm binding is performed in the Agents tree of PFM - Web Console.

To collect information about operating status on a per-process basis, you set only one process for the application when you create the application. To collect information about operating status on a per-application basis, you can set more than one process for the application when you create the application.

The following subsections provide a more detailed description of how to set monitoring targets.

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 Job Management Partner 1/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 Job Management Partner 1/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 settings tree in the Service Properties window.
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 settings 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 6-6 Settings for application properties

    ItemProperty nameDescriptionName of field in corresponding record
    Virtualized environment identifierVirtual Environment ID#1If necessary when operating in a virtualized system, 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.21(1) Identifying processes that have the same name in a virtualized system.
    A value between 0 and 2147483647​ can be specified. The value is evaluated against the value of the PD_APS record's Virtual Env ID field.
    Virtual Env ID field of the PD_APP2 record
    Monitoring labelMonitoringXX LabelSpecify 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 fieldMonitoringXX FieldSelect one of Program Name, Command Line, or No selection.
    • 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#3MonitoringXX ConditionEnter 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 processesMonitoringXX RangeEnter 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 10 or later or AIX 6.1 or later.
    #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
    [Figure]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.
    [Figure]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.
    [Figure]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 6.2.7 Distinguishing the letter case of monitoring targets.
    [Figure]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 [Figure] is converted as follows:
    Source informationPost-conversion information
    Character encodingBinaryBinaryCharacter string
    Shift-JIS82602360#`
    EUCA3C12323##
    UTF-8EFBCA1232323###
  3. Click the OK button.
    The settings are enabled.
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 7. 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.

Table 6-7 Condition expressions for monitoring the status of a particular process only

ItemCondition expressions
RecordApplication Process Count (PD_APPD)
FieldApplication Name
Monitoring Label
Monitoring Status
Abnormal condition and warning condition#1Application Name = Name#2
AND Monitoring Label = Label#2
AND Monitoring Status = ABNORMAL
#1
The same conditions are specified for abnormal conditions and warning conditions.
#2
Specify the application name and monitoring label for the application you want to monitor.

(2) Checking or changing the settings in a user-defined record (monitoring target)

To check or change the settings for a monitoring target for collecting information about the operating status of processes:

  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 Job Management Partner 1/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 Job Management Partner 1/Performance Management Planning and Configuration Guide.
  4. Expand the contents of the monitoring agent host directory, and then 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. Expand the Advanced application monitoring > Application monitoring settings tree, and then select the tree of the application name you want to check.
  7. Check the settings.
  8. To change a setting, perform step 2 under Setting the application properties in (1) Setting user-defined records (monitoring targets).
  9. Click the OK button.
    If you updated a setting in step 8, that change becomes effective.

(3) Deleting a user-defined record (monitoring target)

To delete a monitoring target:

  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 Job Management Partner 1/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 Job Management Partner 1/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, select the application name of the monitoring target to be deleted from DELETE AN APPLICATION MONITORING SETTING, and then click the OK button.
    The setting is deleted.