Suggestion definition file settings (imdd_suggestion_arbitrary-character-string.conf)
The following items can be configured in the suggestion definition file (suggestion template):
-
JP1/PFM plug-in function
For details on JP1/PFM plug-in functions available in the suggestion definition file, see the description for each function in 5. JP1/PFM Plug-in Functions Available on JP1/IM2.
-
Tree SID
In the suggestion definition file, you specify the tree SID of an IM management node as a processing target of the JP1/PFM plug-in function for node in suggestion display criteria or sid in suggestion activation criteria when a JP1/PFM plug-in function is executed.
The Integrated Operation Viewer of JP1/IM2 shows components of Performance Management (IM management nodes) in the tree shown below. You can specify the tree SID of a numbered IM management node in Performance Management as a processing target of the JP1/PFM plug-in function.
All Systems | +- PFM-Manager-host-name <-(1) | +- Management Applications | +- JP1/PFM - Manager <-(2) | +- PFM-Agent-host-name <-(1) | +- Management Applications | | +- JP1/PFM - Base <-(3) | | +- JP1/PFM - PFM-View-name-of-PFM-Agent | | +- service-ID-of-Agent-Collector <-(4) | | | +- PFM-Agent-product-specific-category | +- JP1/PFM - PFM-View-name-of-PFM-Agent | | +- service-ID-of-Agent-Collector <-(5) | +- PFM-RM-host-name <-(1) | +- Management Applications | +- JP1/PFM - Base <-(3) | +- JP1/PFM - PFM-View-name-of-PFM-RM | +- service-ID-of-Remote-Monitor-Collector <-(6) | +- service-ID-of-group-agent <-(7) | +- monitored-host-name-of-remote-agent <-(1) +- Management Applications | +- JP1/PFM - PFM-View-name-of-PFM-RM | +- service-ID-of-remote-agent <-(8) | +- PFM-RM-product-specific-category +- JP1/PFM - PFM-View-name-of-PFM-RM +- service-ID-of-remote-agent <-(9)
The following shows examples of tree SIDs of numbered IM management nodes:
(1) Tree SID of an IM management node that corresponds to a host
-
Tree SID example
_ROOT_AllSystems/_HOST_PFMHOST
-
Regular expression example
_HOST_[^/]*$
-
Note
If a host has an IM management node of a product other than Performance Management, a plug-in of that product can also process this tree SID.
(2) Tree SID of an IM management node that corresponds to PFM - Manager
-
Tree SID example
_ROOT_AllSystems/_HOST_HOSTMGR/_CATEGORY_managementApplications/_OBJECT_JP1PFMMGR
-
Regular expression example
_OBJECT_JP1PFMMGR
-
Note
Only the JP1/PFM plug-in can process this tree SID.
(3) Tree SID of an IM management node that corresponds to PFM - Base
-
Tree SID example
_ROOT_AllSystems/_HOST_HOSTAGT/_CATEGORY_managementApplications/_OBJECT_JP1PFMBASE
-
Regular expression example
_OBJECT_JP1PFMBASE
-
Note
Only the JP1/PFM plug-in can process this tree SID.
(4) Tree SID of an IM management node that corresponds to a service of a PFM - Agent instance
-
Tree SID example
_ROOT_AllSystems/_HOST_HOSTAGT/_CATEGORY_managementApplications/_SUBCATEGORY_JP1%2FPFM%20-%20Windows/_OBJECT_JP1PFM-ATA1hostAGTJP1AGENTSERVICE
-
Regular expression example
_CATEGORY_m.*_OBJECT_JP1PFM-A[^1478]
-
Note
Only the JP1/PFM plug-in can process this tree SID.
(5) Tree SID of an IM management node that corresponds to performance data of a PFM - Agent instance
-
Tree SID example
_ROOT_AllSystems/_HOST_HOSTAGT/_CATEGORY_platform/_SUBCATEGORY_JP1%2FPFM%20-%20Windows/_OBJECT_JP1PFM-ATA1hostAGT
-
Regular expression example
_CATEGORY_[^m].*_OBJECT_JP1PFM-A[^1478]
-
Note
Only the JP1/PFM plug-in can process this tree SID.
(6) Tree SID of an IM management node that corresponds to a PFM - RM instance
-
Tree SID example
_ROOT_AllSystems/_HOST_HOSTRM/_CATEGORY_managementApplications/_SUBCATEGORY_JP1%2FPFM%20-%20RM%20Platform/_OBJECT_JP1PFM-A7A1i1%5BhostRM%5DJP1AGENTSERVICE
-
Regular expression example
_OBJECT_JP1PFM-A[1478].*%5B[^%]*%5D
-
Note
Only the JP1/PFM plug-in can process this tree SID.
(7) Tree SID of an IM management node that corresponds to a group agent
-
Tree SID example
_ROOT_AllSystems/_HOST_HOSTRM/_CATEGORY_managementApplications/_SUBCATEGORY_JP1%2FPFM%20-%20RM%20Platform/_OBJECT_JP1PFM-A7A1i1%5BAll%40hostRM%5DJP1AGENTSERVICE
-
Regular expression example
_OBJECT_JP1PFM-A.*%5BAll%40
-
Note
Only the JP1/PFM plug-in can process this tree SID.
(8) Tree SID of an IM management node that corresponds to a service of a remote agent
-
Tree SID example
_ROOT_AllSystems/_HOST_HOSTRA/_CATEGORY_managementApplications/_SUBCATEGORY_JP1%2FPFM%20-%20RM%20Platform/_OBJECT_JP1PFM-A7A1i1%5Bt1%40hostRM%5DJP1AGENTSERVICE
-
Regular expression example
_CATEGORY_m.*_OBJECT_JP1PFM-A[1478].*%5B(.|..|[^A]..|.[^l].|..[^l]|.{4,})%40
-
Note
Only the JP1/PFM plug-in can process this tree SID.
(9) Tree SID of an IM management node that corresponds to performance data of a remote agent
-
Tree SID example
_ROOT_AllSystems/_HOST_HOSTRA/_CATEGORY_platform/_SUBCATEGORY_JP1%2FPFM%20-%20RM%20Platform/_OBJECT_JP1PFM-A7A1i1%5Bt1%40hostRM%5D
-
Regular expression example
_CATEGORY_[^m].*_OBJECT_JP1PFM-A[1478].*%5B.*%40
-
Note
Only the JP1/PFM plug-in can process this tree SID.
-
-
Variable
In the suggestion definition file, variables are available for defining suggestion activation criteria and response actions. A variable string is enclosed between ${ and }.
If you specify a variable in the following format, you can get a property value of an IM management node of Performance Management that is shown in the Integrated Operation Viewer of JP1/IM2, from the IM management node with the target SID associated with the IM management node (monitoring agent) of Performance Management specified by the tree SID:
${.:target[PFM]:value.property.property-name:}
Example:
The following shows an example of getting the value of property name ServiceId from the IM management node selected in the Integrated Operation Viewer of JP1/IM2:
${.:target[PFM]:value.property.ServiceId:}