You can use the wsadmin tool to configure the Performance
Monitoring Infrastructure (PMI) in your environment. PMI enables the
server to collect performance data from various product components.
PMI provides information about average system resource usage statistics,
with no correlation between the data across different components.
About this task
There are two ways to perform this task. Complete the
steps in this topic to use the AdminConfig object to modify your server
configuration. Alternatively, you can use the configurePerformanceMonitoringService
Jython script in the AdminServerManagement script library to configure
PMI. The wsadmin tool automatically loads the script when the tool
starts. Use the following syntax to configure PMI settings using the
configurePerformanceMonitoringService script:
AdminServerManagement.configurePerformanceMonitoringService(nodeName, serverName, enable, initialSpecLevel,
otherAttributeList)
For additional information and argument
definitions, see the documentation for the AdminServerMananagment
script library.
Procedure
- Start the wsadmin scripting tool.
- Identify the application server of interest.
Use the AdminConfig object and the getid command to retrieve the configuration ID of the
application server of interest, and assign it to the
s1 variable, as the following example demonstrates:
Table 1. Description of elements . The previous commands consist of the following elements:
Element |
Description |
set |
Jacl command |
s1 |
Variable name |
$ |
Jacl operator for substituting a variable name with its value |
AdminConfig |
Object representing the product configuration |
getid |
AdminConfig command |
Cell |
Attribute |
mycell |
Value of the Cell attribute |
Node |
Attribute |
mynode |
Value of the Node attribute |
Server |
Attribute |
server1 |
Value of the Server attribute |
Example
output:
server1(cells/mycell/nodes/mynode/servers/server1|server.xml#Server_1)
- Identify the PMI service that belongs to the server.
Use the AdminConfig object and the
list command to identify the PMI
service, and assign it to the
pmi variable, as the following example demonstrates:
Table 2. Description of elements . The previous commands consist of the following elements:
Element |
Description |
set |
Jacl command |
pmi |
Variable name |
$ |
Jacl operator for substituting a variable name with its value |
AdminConfig |
Object that represents the application server
configuration |
list |
AdminConfig command |
PMIService |
AdminConfig object |
s1 |
Evaluates to the ID of the application server of interest |
Example
output:
(cells/mycell/nodes/mynode/servers/server1|server.xml#PMIService_1)
- Modify the PMI configuration attributes.
Use
the AdminConfig object and the
modify command
to modify the PMI configuration attributes, as the following example
demonstrates:
- Using
Jacl:
$AdminConfig modify $pmi {{enable true} {statisticSet all}}
- Using
Jython:
AdminConfig.modify(pmi, [['enable', 'true'], ['statisticSet','all']]
- Save the configuration changes.
Use the following command example to save your configuration
changes:
AdminConfig.save()
- In a network deployment environment only,
synchronize the node.
Use the syncActiveNode or syncNode scripts in the
AdminNodeManagement script library to propagate the configuration
changes to node or nodes.