4.10.13 Add process monitoring settings
Function
Adds new application definitions (definition information used to monitor processes in JP1/PFM) for an agent managed by JP1/PFM.
This plugin assumes the following server:
• PFM management server (Execution target server)
This is the server on which this plugin is executed. JP1/PFM - Web Console must have already been set up.
Use situation
You use this plugin to initialize an added remote agent in a system using JP1/PFM - RM for performance monitoring.
Prerequisites
For the latest support information about [Required products on the execution target server]/[Prerequisite product OS running in the execution target server], see the release notes.
In addition, the following OS and products use abbreviations. For the abbreviations of OS and products, see the "Preface".
[Required products on the execution target server]
(1) JP1/PFM - Web Console
[Prerequisite product OS running in the execution target server]
(1) Windows Server 2016 Standard/Datacenter
(2) Windows Server 2019 Standard/Datacenter
(3) Windows Server 2022 Standard/Datacenter
(4) Red Hat Enterprise Linux Server 7
(5) Red Hat Enterprise Linux Server 8
[Usage conditions for required products on the execution target server]
(1) The following file is stored on the execution target server:
• Application definition file (file specified in the jpcprocdef create command)
(2) A key file for authentication has been created on the execution target server, by using a user account with the JP1/PFM administrator user permissions.
Version
04.00.00
Plug-in tags
Configure JP1,PFM,Windows,Linux
Plug-in name displayed in the task log
jp1pfmAddProcessDef
Return code
0: Normal
11: Error (user error) Definition file's contents are invalid
12: Error (user error) Invalid property
13: Error (user error) Authentication disabled
14: Error (user error) File access disabled
20: Error (user error) Other user error
21: Error (invalid environment) Command cannot be found (error detected in the plugin script)
22: Error (invalid environment) Insufficient memory or disk capacity
23: Error (invalid environment) Required environment is invalid
25: Error (invalid environment) Communication error
26: Error (linked product error) Internal error
41: Error (error detected in plugin) Missing property (error detected in plugin script)
42: Error (error detected in plugin) Internal error (error detected in the plugin script)
Property list
The following table lists the properties:
|
Property key |
Property name |
Description |
Default value |
I/O type |
Required |
|---|---|---|---|---|---|
|
JP1PFM.serviceID |
JP1/PFM - RM agent's service ID |
Specify the service ID of the JP1/PFM - RM remote agent to be defined. |
-- |
Input |
R |
|
JP1PFM.applicationDefinitionFileName |
Application definition file name |
Specify the full path of the application definition file required for JP1/PFM processes monitoring. |
-- |
Input |
R |
|
plugin.destinationHost |
Host name of the execution target server |
Specify the host name or IP address of the server on which this plugin will be executed. IPv6 addresses are not supported. |
-- |
Input |
R |
|
common.returnValue |
Return value for the plugin |
The return value of this plugin stored. |
-- |
Output |
O |