使用 wsadmin 工具来启用 PMI

通过本页面来了解如何使用命令行(而不是管理控制台)来启用性能监控基础结构。

关于此任务

您可以使用命令行来启用性能监控基础结构 (PMI)。

过程

运行 wsadmin 命令。 使用 wsadmin,您可以调用 Perf Mbean 上的操作,以获取 PMI 数据,设置或获取 PMI 监视级别,以及启用数据计数器。
注: 如果还未启用 PMI 数据,您需要首先通过对 PerfMBean 调用 setInstrumentationLevel 操作启用 PMI 数据。

Perf MBean 中下列操作可用于 wsadmin

/** Get performance data information for stats */
public void getConfig (ObjectName mbean);

/** Returns the current statistic set */
public void getStatisticSet ();

/** Enable PMI data using the pre-defined statistic sets.
    Valid values for the statistic set are "basic", "extended", "all", and "none" */
public void setStatisticSet (String statisticSet);

/** Returns the current custom set specification as a string */
public void getCustomSetString ();

/** Customizing PMI data that is enabled using fine-grained control. 
    This method allows to enable or disable statistics selectively.
    The format of the custom set specification string is STATS_NAME=ID1,ID2,ID3 seperated by ':',
	  where STATS_NAME and IDs are defined in WS*Stat interfaces in com.ibm.websphere.pmi.stat package. 
    Use * to enable all the statistics in the given PMI module. For example, to enable all the statistics
	  for JVM and active count, pool size for thread pool use: jvmRuntimeModule=*:threadPoolModule=3,4. 
    The string jvmRuntimeModule is the value of the constant WSJVMStats.NAME and threadPoolModule is the 
	  value of WSThreadPoolStats.NAME.
 */
public void setCustomSetString (String customSpec, Boolean recursive);

/** Get stats for an MBean*/
public void getStatsObject (ObjectName mbean, Boolean recursive);

/** Set instrumentation level using String format.
    This should be used by scripting for an easy String processing. 
    The level STR is a list of moduleName=Level connected by ":".
    NOTE: This method is deprecated in Version 6.0
 */
public void setInstrumentationLevel(String levelStr, Boolean recursive);  


/** Get instrumentation level in String for all the top level modules. 
    This should be used by scripting for an easy String processing.
    NOTE: This method is deprecated in Version 6.0
 */
public String getInstrumentationLevelString();     

/** Return the PMI data in String 
    NOTE: This method is deprecated in Version 6.0
 */     
public String getStatsString(ObjectName on, Boolean recursive);      

/** Return the PMI data in String      
    Used for PMI modules/submodules without direct MBean mappings.      
    NOTE: This method is deprecated in Version 6.0
 */     
public String getStatsString(ObjectName on, String submoduleName, Boolean recursive);

/** Return the submodule names if any for the MBean      
    NOTE: This method is deprecated in Version 6.0   
 */
public String listStatMemberNames(ObjectName on);
/** Get performance data information for stats */
public void getConfig (ObjectName mbean);

/** Returns the current statistic set */
public void getStatisticSet ();

/** Enable PMI data using the pre-defined statistic sets.
    Valid values for the statistic set are "basic", "extended", "all", and "none" */
public void setStatisticSet (String statisticSet);

/** Returns the current custom set specification as a string */
public void getCustomSetString ();

/** Customizing PMI data that is enabled using fine-grained control. 
    This method allows to enable or disable statistics selectively.
    The format of the custom set specification string is STATS_NAME=ID1,ID2,ID3 seperated by ':', 
		where STATS_NAME and IDs are defined in WS*Stat interfaces in com.ibm.websphere.pmi.stat package. 
    Use * to enable all the statistics in the given PMI module. For example, to enable all the statistics 
		for JVM and active count, pool size for thread pool use: jvmRuntimeModule=*:threadPoolModule=3,4. 
    The string jvmRuntimeModule is the value of the constant WSJVMStats.NAME and threadPoolModule is the 
value of WSThreadPoolStats.NAME.
 */
public void setCustomSetString (String customSpec, Boolean recursive);

/** Get stats for an MBean*/
public void getStatsObject (ObjectName mbean, Boolean recursive);

/** Set instrumentation level using String format.
    This should be used by scripting for an easy String processing. 
    The level STR is a list of moduleName=Level connected by ":".
    NOTE: This method is deprecated in an earlier version. */
public void setInstrumentationLevel(String levelStr, Boolean recursive);  


/** Get instrumentation level in String for all the top level modules. 
    This should be used by scripting for an easy String processing.
    NOTE: This method is deprecated in in an earlier version. */
public String getInstrumentationLevelString();     

/** Return the PMI data in String 
    NOTE: This method is deprecated in in an earlier version.
 */     
public String getStatsString(ObjectName on, Boolean recursive);      

/** Return the PMI data in String      
    Used for PMI modules/submodules without direct MBean mappings.      
    NOTE: This method is deprecated in in an earlier version.
 */     
public String getStatsString(ObjectName on, String submoduleName, Boolean recursive);

/** Return the submodule names if any for the MBean      
    NOTE: This method is deprecated in in an earlier version.
 */
public String listStatMemberNames(ObjectName on);
如果 MBean 是 StatisticProvider,并且如果您将它的 ObjectName 传递给 getStatsObject,那么您将获取该 MBean 的统计数据。具有下列 MBean 类型的 MBean 是统计提供程序:
  • DynaCache
  • EJBModule
  • EntityBean
  • JDBCProvider
  • J2CResourceAdapter
  • JVM
  • MessageDrivenBean
  • ORB
  • Server
  • SessionManager
  • StatefulSessionBean
  • StatelessSessionBean
  • SystemMetrics
  • ThreadPool
  • TransactionService
  • WebModule
  • Servlet
  • WLMAppServer
  • WebServicesService
  • WSGW

示例

将以下样本 Jacl 命令与 wsadmin 工具配合使用以获取 PMI 数据:

获取 Perf MBean ObjectName
wsadmin>set perfName [$AdminControl completeObjectName type=Perf,*]
wsadmin>set perfOName [$AdminControl makeObjectName $perfName]

调用 getStatisticSet 操作

使用此方法来查找当前有效的统计信息集:

wsadmin> $AdminControl invoke $perfName getStatisticSet

此方法返回下列某个值:basic、extended、all、none。

调用 setStatisticSet 操作

使用此方法来启用使用统计信息集的监视。

有效的统计信息集值是:basic、extended、all、none。

wsadmin> set params [java::new {java.lang.Object[]} 1]
wsadmin> $params set 0 [java::new java.lang.String extended]
wsadmin> set sigs  [java::new {java.lang.String[]} 1]
wsadmin> $sigs set 0 java.lang.String
wsadmin> $AdminControl invoke_jmx $perfOName setStatisticSet $params $sigs

调用 getConfig 操作

使用此方法来查找关于给定组件统计信息的信息。

wsadmin> set jvmName [$AdminControl completeObjectName type=JVM,*]

wsadmin> set params [java::new {java.lang.Object[]} 1] 
wsadmin> $params set 0 [java::new javax.management.ObjectName $jvmName]
wsadmin> set sigs  [java::new {java.lang.String[]} 1]
wsadmin> $sigs set 0 javax.management.ObjectName

wsadmin> $AdminControl invoke_jmx $perfOName getConfig $params $sigs

此方法返回以下内容:

    Stats type=jvmRuntimeModule, Description=The performance data from 
the Java virtual machine run time.

    {name=UpTime, ID=4, type=CountStatistic, description=The amount of 
time (in seconds) that the Java virtual machine has been running., 
unit=SECOND, level=low, statisticSet=basic, resettable=false, 
aggregatable=true}

    {name=UsedMemory, ID=3, type=CountStatistic, description=The amount 
of used memory (in KBytes) in the Java virtual machine run time., 
unit=KILOBYTE, level=low,
    statisticSet=basic, resettable=false, aggregatable=true}

    {name=FreeMemory, ID=2, type=CountStatistic, description=The free 
memory (in KBytes) in the Java virtual machine run time., 
unit=KILOBYTE, level=low, statisticSet=all, resettable=false, 
aggregatable=true}

    {name=HeapSize, ID=1, type=BoundedRangeStatistic, description=The 
total memory (in KBytes) in the Java virtual machine run time., 
unit=KILOBYTE, level=high, statisticSet=basic, resettable=false, 
aggregatable=true}

调用 getCustomSetString 操作

此操作提供了字符串格式的当前监视规范:

wsadmin> $AdminControl invoke $perfName getCustomSetString

输出类似于以下内容:

    jvmRuntimeModule=4,3,1:systemModule=2,1:threadPoolModule=4,3:thread
PoolModule>HAManager.thread.pool=4,3:threadPoolModule>MessageListenerTh
readPool=4,3:threadPoolModule>ORB.thread.pool=4,3:threadPoolModule>Serv
let.Engine.Transports=4,3:threadPoolModule>TCS_DEFAULT=4,3:transactionM
odule=4,19,16,18,3,7,6,1,14

此输出表明在 JVM 组件中启用了统计标识 1、3、4。使用先前的 getConfig 操作或使用 API 文档可以找到统计标识的描述。此输出包含整个服务器的当前监视规范。各个模块通过 : 分隔,> 用作模块内的分隔符。

调用 setCustomSetString 操作

可以使用此操作选择性地启用或禁用统计信息。在以下命令中启用 JVM 模块的统计标识 1、2、3、4。要启用所有的统计标识,请使用星号(*)。

wsadmin> set params [java::new {java.lang.Object[]} 2] 
wsadmin> $params set 0 [java::new java.lang.String jvmRuntimeModule=1,2,3,4]
wsadmin> $params set 1 [java::new java.lang.Boolean false]

wsadmin> set sigs  [java::new {java.lang.String[]} 2]
wsadmin> $sigs set 0 java.lang.String
wsadmin> $sigs set 1 java.lang.Boolean

wsadmin> $AdminControl invoke_jmx $perfOName setCustomSetString $params $sigs

调用 getStatsObject 操作

将此操作用于获取给定 MBean 的统计信息。以下示例会获取 JVM 的统计信息:

wsadmin> set jvmName [$AdminControl completeObjectName type=JVM,*]
wsadmin> set params [java::new {java.lang.Object[]} 2] 
wsadmin> $params set 0 [java::new javax.management.ObjectName $jvmName]
wsadmin> $params set 1 [java::new java.lang.Boolean false]
wsadmin> set sigs  [java::new {java.lang.String[]} 2]
wsadmin> $sigs set 0 javax.management.ObjectName
wsadmin> $sigs set 1 java.lang.Boolean
wsadmin> $AdminControl invoke_jmx $perfOName getStatsObject $params 
$sigs
Stats name=jvmRuntimeModule, type=jvmRuntimeModule#
    {
    name=HeapSize, ID=1, description=The total memory (in KBytes) in 
the Java virtual machine run time., unit=KILOBYTE, type=BoundedRangeStatistic, lowWaterMark=51200, 
highWaterMark=263038, current=263038, integral=2.494158617766E12, lowerBound
=51200, upperBound=262144

    name=FreeMemory, ID=2, description=The free memory (in KBytes) in 
the Java virtual machine run time., unit=KILOBYTE, type=CountStatistic, 
count=53509

    name=UsedMemory, ID=3, description=The amount of used memory (in KBytes) in 
the Java virtual machine run time., unit=KILOBYTE, 
type=CountStatistic, count=209528

    name=UpTime, ID=4, description=The amount of time (in seconds) that 
the Java virtual machine has been running., unit=SECOND, 
type=CountStatistic, count=83050
}

调用 getInstrumentationLevelString 操作

使用 invoke,因为它没有参数。

wsadmin>$AdminControl invoke $perfName getInstrumentationLevelString
此命令返回以下内容:
beanModule=H:cacheModule=H:connectionPoolModule=H:j2cModule=H:jvmRu
ntimeModule=H:orbPerfModule=H:servletSessionsModule=H:systemModule=
H:threadPoolModule=H:transactionModule=H:webAppModule=H
注: 您可以更改先前字符串中的级别(n、l、m、h、x),然后将它传递给 setInstrumentationLevel 方法。
调用 setInstrumentationLevel 操作 - 启用/禁用 PMI 计数器
  • 设置参数(“pmi=l”是将所有模块设置为低级别的简单方法)。
    wsadmin>set params [java::new {java.lang.Object[]} 2] 
    wsadmin>$params set 0 [java::new java.lang.String pmi=l] 
    wsadmin>$params set 1 [java::new java.lang.Boolean true]
  • 设置特征符。
    wsadmin>set sigs  [java::new {java.lang.String[]} 2] 
    wsadmin>$sigs set 0 java.lang.String
    wsadmin>$sigs set 1 java.lang.Boolean
  • 调用此方法。使用 invoke_jmx,因为它具有参数。
    wsadmin>$AdminControl invoke_jmx $perfOName setInstrumentationLevel $params $sigs
此命令不返回任何内容。
注: PMI 级别字符串可以与 pmi=level(其中 level 是 n、l、m、h 或 x)或类似于 module1=level1:module2=level2:module3=level3(与从 getInstrumentationLevelString 返回的字符串中显示的格式相同)的内容一样简单。

调用 getStatsString(ObjectName, Boolean) 操作

如果您知道 MBean ObjectName,那么可以通过传递正确的参数来调用此方法。作为示例,此处使用 JVM MBean。

  • 获取 MBean 查询字符串。例如,JVM MBean。
    wsadmin>set jvmName [$AdminControl completeObjectName type=JVM,*]
  • 设置参数。
    wsadmin>set params [java::new {java.lang.Object[]} 2]
    wsadmin>$params set 0 [$AdminControl makeObjectName $jvmName]
    wsadmin>$params set 1 [java::new java.lang.Boolean true]
  • 设置特征符。
    wsadmin>set sigs  [java::new {java.lang.String[]} 2]
    wsadmin>$sigs set 0 javax.management.ObjectName 
    wsadmin>$sigs set 1 java.lang.Boolean
  • 调用方法。
    wsadmin>$AdminControl invoke_jmx $perfOName getStatsString $params $sigs
此命令返回以下内容:
{Description jvmRuntimeModule.desc}
 {Descriptor {{Node wenjianpc} {Server server1} {Module jvmRuntimeModule}
 {Name jvmRuntimeModule} {Type MODULE}}} 
{Level 7} 
{Data {{{Id 4} {Descriptor {{Node wenjianpc} {Server server1} {Module jvmRuntimeModule}
 {Name jvmRuntimeModule} {Type DATA}}} 
{PmiDataInfo {{Name jvmRuntimeModule.upTime} {Id 4}
 {Description jvmRuntimeModule.upTime.desc} {Level 1}
 {Comment {The amount of time in seconds the JVM has been running}} 
 {SubmoduleName null} {Type 2} {Unit unit.second} {Resettable false}}} 
{Time 1033670422282} {Value {Count 638} }} 
{{Id 3} {Descriptor {{Node wenjianpc} {Server server1} {Module jvmRuntimeModule}
 {Name jvmRuntimeModule} {Type DATA}}} 
{PmiDataInfo {{Name jvmRuntimeModule.usedMemory} {Id 3}
 {Description jvmRuntimeModule.usedMemory.desc} {Level 1}
 {Comment {Used memory in JVM runtime}} {SubmoduleName null} {Type 2}
 {Unit unit.kbyte} {Resettable false}}} {Time 1033670422282}
 {Value {Count 66239} }} 
{{Id2} {Descriptor {{Node wenjianpc} {Server server1} {Module jvmRuntimeModule}
 {Name jvmRuntimeModule} {Type DATA}}} 
{PmiDataInfo {{Name jvmRuntimeModule.freeMemory} {Id 2}
 {Description jvmRuntimeModule.freeMemory.desc} {Level 1} 
 {Comment {Free memory in JVM runtime}} 
{SubmoduleName null} {Type 2} {Unit unit.kbyte} {Resettable false}}} 
{Time 1033670422282} {Value {Count 34356} }} 
{{Id 1} {Descriptor{{Node wenjianpc} {Server server1} {Module jvmRuntimeModule}
 {Name jvmRuntimeModule} {Type DATA}}} 
{PmiDataInfo {{Name jvmRuntimeModule.totalMemory} {Id 1}
 {Description jvmRuntimeModule.totalMemory.desc} {Level 7}
 {Comment {Total memory in JVM runtime}} 
 {SubmoduleName null} {Type 5} {Unit unit.kbyte} {Resettable false}}} 
{Time 1033670422282} {Value {Current 100596} {LowWaterMark 38140}
 {HighWaterMark 100596} {MBean 38140.0} }}}}

调用 getStatsString (ObjectName, String, Boolean) 操作

此操作使用另一个字符串参数,并且用于没有匹配 MBean 的 PMI 模块。在这种情况下,父代 MBean 与 代表 PMI 模块的字符串名协同使用。通过调用 listStatMemberNames 可以找到 MBean 中可用的字符串名。例如,beanModule 是通过所有 Enterprise JavaBeans 聚集 PMI 数据的逻辑模块,但是 beanModule 没有 MBean。因此,您可传递服务器 MBean ObjectName 和字符串 (beanModule),以便在 beanModule 中获取 PMI 数据。

  • 获取 MBean 查询字符串。例如,server MBean:
    wsadmin>set mySrvName [$AdminControl completeObjectName 
        type=Server,name=server1,node=wenjianpc,*]
  • 设置参数。
    wsadmin>set params [java::new {java.lang.Object[]} 3]
    wsadmin>$params set 0 [$AdminControl makeObjectName $mySrvName]
    wsadmin>$params set 1 [java::new java.lang.String beanModule]
    wsadmin>$params set 2 [java::new java.lang.Boolean true]
  • 设置特征符。
    wsadmin>set sigs  [java::new {java.lang.String[]} 3]
    wsadmin>$sigs set 0 javax.management.ObjectName
    wsadmin>$sigs set 1 java.lang.String
    wsadmin>$sigs set 2 java.lang.Boolean
  • 调用方法。
    wsadmin>$AdminControl invoke_jmx $perfOName getStatsString $params $sigs
因为递归的标志设置为 true,所以此命令在 BeanModule 层次结构中的所有 Enterprise JavaBeans 中返回 PMI 数据。
注: 此方法用于获取没有直接 MBean 映射的 PMI 模块的 stats 数据。

调用 listStatMemberNames 操作

  • 获取 MBean 查询字符串。例如,Server:
    wsadmin>set mySrvName [$AdminControl completeObjectName 
        type=Server,name=server1,node=wenjianpc,*]
  • 设置参数。
    wsadmin>set params [java::new {java.lang.Object[]} 1]
    wsadmin>$params set 0 [$AdminControl makeObjectName $mySrvName]
  • 设置特征符。
    wsadmin>set sigs  [java::new {java.lang.String[]} 1]
    wsadmin>$sigs set 0 javax.management.ObjectName
    wsadmin>$AdminControlinvoke_jmx $perfOName listStatMemberNames $params $sigs
此命令返回 PMI 模块和子模块名,其不具有直接 MBean 映射。这些名称通过空格“ ”分隔。然后您可以使用此名称作为 getStatsString 方法中的 String 参数。例如:
beanModule connectionPoolModule j2cModule servletSessionsModule 
threadPoolModule 
webAppModule
使用 wsadmin 工具定制并运行以下示例 Jython 脚本以获取 PMI 数据:
print "\n---------------------------------------------------------------------- "
print "Obtain the Perf MBean ObjectName"
print "------------------------------------------------------------------------ "
perfName = AdminControl.completeObjectName ('type=Perf,*')
perfOName = AdminControl.makeObjectName (perfName)
print perfOName
print "------------------------------------------------------------------------ \n"


print "\n---------------------------------------------------------------------- "
print "Invoke getStatisticSet operation "
print "------------------------------------------------------------------------ "
print AdminControl.invoke (perfName, 'getStatisticSet')
print "------------------------------------------------------------------------ \n"


print "\n---------------------------------------------------------------------- "
print "Invoke setStatisticSet operation"
print "------------------------------------------------------------------------ "
params = ['extended']

sigs  = ['java.lang.String']

print AdminControl.invoke_jmx (perfOName, 'setStatisticSet', params, sigs)
print "------------------------------------------------------------------------ \n"


print "\n---------------------------------------------------------------------- "
print "Invoke getConfig operation"
print "------------------------------------------------------------------------ "
jvmName = AdminControl.completeObjectName ('type=JVM,*')

params = [AdminControl.makeObjectName (jvmName)] 

sigs = ['javax.management.ObjectName']

print AdminControl.invoke_jmx (perfOName, 'getConfig', params, sigs)
print "------------------------------------------------------------------------ \n"


print "\n---------------------------------------------------------------------- "
print "Invoke getCustomSetString operation"
print "------------------------------------------------------------------------ "
print AdminControl.invoke (perfName, 'getCustomSetString')
print "------------------------------------------------------------------------ \n"


print "\n---------------------------------------------------------------------- "
print "Invoke setCustomSetString operation"
print "------------------------------------------------------------------------ "
params = ['jvmRuntimeModule=1,2,3,4', java.lang.Boolean ('false')] 

sigs  = ['java.lang.String', 'java.lang.Boolean']

print AdminControl.invoke_jmx (perfOName, 'setCustomSetString', params, sigs)
print "------------------------------------------------------------------------ \n"


print "\n---------------------------------------------------------------------- "
print "Invoke getStatsObject operation"
print "------------------------------------------------------------------------ "
jvmName = AdminControl.completeObjectName ('type=JVM,*')

params = [AdminControl.makeObjectName (jvmName), java.lang.Boolean ('false')] 

sigs = ['javax.management.ObjectName', 'java.lang.Boolean']

print AdminControl.invoke_jmx (perfOName, 'getStatsObject', params, sigs)
print "------------------------------------------------------------------------ \n"


print "\n---------------------------------------------------------------------- "
print "Invoke getInstrumentationLevelString operation"
print "------------------------------------------------------------------------ "
print AdminControl.invoke (perfName, 'getInstrumentationLevelString')
print "------------------------------------------------------------------------ \n"


print "\n---------------------------------------------------------------------- "
print "Invoke setInstrumentationLevel operation - enable/disable PMI counters "
print "------------------------------------------------------------------------ "
params = ['pmi=l', java.lang.Boolean ('true')] 

sigs = ['java.lang.String', 'java.lang.Boolean'] 

print AdminControl.invoke_jmx (perfOName, 'setInstrumentationLevel', params, sigs)
print "------------------------------------------------------------------------ \n"


print "\n---------------------------------------------------------------------- "
print "Invoke getStatsString(ObjectName, Boolean) operation"
print "------------------------------------------------------------------------ "
jvmName = AdminControl.completeObjectName ('type=JVM,*')

params = [AdminControl.makeObjectName (jvmName), java.lang.Boolean ('true')]

sigs = ['javax.management.ObjectName', 'java.lang.Boolean']

print AdminControl.invoke_jmx (perfOName, 'getStatsString', params, sigs)
print "------------------------------------------------------------------------ \n"


print "\n---------------------------------------------------------------------- "
print "Invoke getStatsString (ObjectName, String, Boolean) operation"
print "------------------------------------------------------------------------ "
mySrvName = AdminControl.completeObjectName ('type=Server,name=server1,node=wcsNode,*')

params = [AdminControl.makeObjectName (mySrvName),
          'beanModule',
          java.lang.Boolean ('true')]

sigs = ['javax.management.ObjectName',
        'java.lang.String',
        'java.lang.Boolean')

print AdminControl.invoke_jmx (perfOName, 'getStatsString', params, sigs)
print "------------------------------------------------------------------------ \n"


print "\n---------------------------------------------------------------------- "
print "Invoke listStatMemberNames operation"
print "------------------------------------------------------------------------ "
mySrvName = AdminControl.completeObjectName ('type=Server,name=server1,node=wcsNode,*')

params = [AdminControl.makeObjectName (mySrvName)]

sigs = ['javax.management.ObjectName']

print AdminControl.invoke_jmx (perfOName, 'listStatMemberNames', params, sigs)
print "------------------------------------------------------------------------ \n"
注: 启用 Intelligent Management 后,应用程序服务器不允许您禁用 Intelligent Management 需要的 PMI 计数器。有关启用 Intelligent Management 后不能禁用的 PMI 计数器列表的信息,请参阅启用 PMI 数据收集

指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tprf_command
文件名:tprf_command.html