6.6.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)
To set a monitoring target:
-
Create an application.
-
Set the application's properties (such as the application name and threshold values to be monitored).
-
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 or per-service basis, you set only one process or service 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 or service for the application when you create the application.
The following subsections provide a more detailed description of how to set monitoring targets.
(a) Creating the application
-
From the monitoring console browser, log in to PFM - Web Console.
The Main window appears.
-
In the navigation frame of the Main window, select the Services tab.
The Services tree 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 that host.
The name of each service is displayed by its service ID. For details about the 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 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.
-
Expand the contents of the monitoring agent host folder, and 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 window appears.
-
Select the Advanced Application Monitoring > ADDITION OR DELETION A SETTING tree.
-
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.
-
-
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
-
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.
-
Set the application properties.
Set the 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‒7: Settings for application properties Item
Property name
Description
Field name of the corresponding record
Virtualized environment
identifier
Virtual Environment ID#1
If necessary when you are operating PFM - Web Console by using a virtualized system (Docker container), 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.17(4) Property settings and obtained information.
As an identifier of the virtualized environment, specify the Docker container ID by using 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 Docker host environment, specify 0.
Virtual Env ID field in 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 in the PD_APPD record
Monitoring field
MonitoringXX Field
Select one of Program Name, Command Line, Service Name, 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.
-
Service Name
Evaluate using the value in the Service Name field of the PD_ASVC record.
-
None
Do not evaluate.
The default is None.
Monitoring Field field in the PD_APPD record
Monitoring condition#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 a 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
Source information
Post-conversion information
Character encoding
Binary
Binary
Character string
Shift-JIS
8260
2360
#`
EUC
A3C1
2323
##
UTF-8
EFBCA1
232323
###
-
-
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 7. Monitoring Templates.
To bind an alarm table:
-
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 Agents tab.
The Agents tree appears.
-
In the navigation frame of the Agents tree, select host-name<Windows> (Agent Collector service).
A check mark is displayed next to the Agent Collector service.
-
Select the Bind Alarm Table method in the method frame.
The Bind Alarm Table [Select Alarm Table] window appears.
-
Select an alarm table displayed at the bottom of the Windows folder, 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.
Item |
Condition expressions |
---|---|
Record |
Application Process Count (PD_APPD) |
Field |
Application Name Monitoring Label Monitoring Status |
Abnormal condition and warning condition#1 |
Application Name = Name#2 AND Monitoring Label = Label#2 AND Monitoring Status = ABNORMAL |
(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:
-
From the monitoring console browser, log in to PFM - Web Console.
The Main window appears.
-
In the navigation frame of the Main window, select the Services tab.
The Services tree 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 that host.
The name of each service is displayed by its service ID. For details about the 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 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.
-
Expand the contents of the monitoring agent host folder, and then 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 window appears.
-
Expand the Advanced application monitoring > Application monitoring setting tree, and then select the tree of the application name you want to check.
-
Check the settings.
-
To change a setting, perform step 2 under Setting the application properties in (1) Setting user-defined records (monitoring targets).
-
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:
-
From the monitoring console browser, log in to PFM - Web Console.
The Main window appears.
-
In the navigation frame of the Main window, select the Services tab.
The Services tree 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 that host.
The name of each service is displayed by its service ID. For details about the 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 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.
-
Expand the contents of the monitoring agent host folder, and 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 window appears.
-
Select the Advanced Application Monitoring > ADDITION OR DELETION A SETTING tree.
-
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.