7 DMS カスタム WLST コマンド

特定のコンポーネントまたはサーバに対するパフォーマンスメトリック、一連のパフォーマンスメトリック、またはすべてのパフォーマンスメトリックを表示するには Dynamic Monitoring Service (DMS) を使用します。

メトリックの詳細について、『Oracle Fusion Middleware 管理者ガイド』の「Oracle Fusion Middleware のモニタ」を参照してください。

注意 :

これらのコマンドを使用するには、コンポーネントがインストールされている Oracle ホームから WLST を呼び出す必要があります。『Oracle Fusion Middleware 管理者ガイド』の「カスタム WLST コマンドの使用」を参照してください。

DMS コマンド

パフォーマンスメトリックに関する情報を表示するには、表 7-1 に指定されているコマンドを使用します。

表 7-1 DMS コマンド

コマンド	説明	WLST の使用状況
displayMetricTableNames	使用可能な DMS メトリックテーブルの名前が表示される。	オンライン
displayMetricTables	DMS メトリックテーブルの内容が表示される。	オンライン
dumpMetrics	使用可能なメトリックが表示される。	オンライン
reloadMetricRules	メトリックルールをリロードする。	オンライン

displayMetricTableNames

WLST の使用状況 : オンライン

説明

使用可能な DMS メトリックテーブルの名前が表示されます。戻り値は、メトリックテーブル名を含む文字列の配列です。

構文

displayMetricTableNames([servers])

引数	定義
servers	省略可能。メトリックを取得するサーバを指定する。有効な値は、WebLogic サーバ名および OPMN で管理されるコンポーネント名のリストである。 1 つのサーバを指定するには、次の構文を使用する。 servers='servername' 複数のサーバを指定するには、以下のいずれかの構文オプションを使用する。 servers=['servername1', 'servername2', ...] servers=('servername1', 'servername2', ...) この引数を指定しない場合、コマンドは、WebLogic サーバおよび OPMN で管理されるコンポーネントのすべてのメトリックテーブル名のリストを返します。

引数

定義

servers

省略可能。メトリックを取得するサーバを指定する。有効な値は、WebLogic サーバ名および OPMN で管理されるコンポーネント名のリストである。

1 つのサーバを指定するには、次の構文を使用する。

servers='servername'

複数のサーバを指定するには、以下のいずれかの構文オプションを使用する。

servers=['servername1', 'servername2', ...]
servers=('servername1', 'servername2', ...)

この引数を指定しない場合、コマンドは、WebLogic サーバおよび OPMN で管理されるコンポーネントのすべてのメトリックテーブル名のリストを返します。

例

次の例では、WebLogic サーバおよび OPMN で管理されるコンポーネントのすべてのメトリックテーブル名を示します。

displayMetricTableNames()
ADF
ADFc
ADFc_Metadata_Service
ADFc_Region
ADFc_Taskflow
ADFc_Viewport
BAM_common_connectionpool
BAM_common_connectionpool_main
BAM_common_messaging
BAM_common_messaging_consumers
.
.
.

次の例では、soa_server1 という WebLogic 管理対象サーバのメトリックテーブル名を示します。

displayMetricTableNames(servers='soa_server1')
ADF
JVM
JVM_ClassLoader
JVM_Compiler
JVM_GC
JVM_Memory
JVM_MemoryPool
JVM_MemorySet
JVM_OS
JVM_Runtime
.
.
.

次の例では、2 つの WebLogic 管理対象サーバのメトリックテーブル名を示します。

displayMetricTableNames(servers=['soa_server1', 'bam-server1'])
ADF
ADFc
ADFc_Metadata_Service
ADFc_Region
ADFc_Taskflow
ADFc_Viewport
BAM_common_connectionpool
BAM_common_connectionpool_main
BAM_common_messaging
BAM_common_messaging_consumers
.
.
.

displayMetricTables

WLST の使用状況 : オンライン

説明

DMS メトリックテーブルの内容が表示される。

戻り値は、JMX javax.management.openmbean.CompositeData オブジェクトの配列。配列の各要素は次のフィールドがあります。

[テーブル] フィールドはメトリックテーブル名。
[スキーマ] フィールドは、メトリックテーブルスキーマの情報を含む javax.management.openmbean.TabularData オブジェクト。
[行] フィールドは、メトリックテーブルの行を含む javax.management.openmbean.TabularData オブジェクト。

メトリックテーブルスキーマの javax.management.openmbean.TabularData オブジェクトは、以下の 4 つのフィールドがあります。

[カラム] フィールドは、カラムの名前を含む。
[タイプ] フィールドは、カラム値のタイプを含む。
[単位] フィールドは、カラムの単位を含む。
[説明] フィールドは、カラムの説明を含む。

メトリック行の javax.management.openmbean.TabularData は、すべてのメトリックのフィールドを含みます。フィールド名としてメトリックの名前を使用します。

構文

displayMetricTables([metricTable_1], [metricTable_2], [...,] [servers] [variables])

引数	定義
metricTable_n	省略可能。メトリックテーブルのリストを指定する。デフォルトでは、この引数はすべての使用可能なメトリックを表示する。メトリックテーブル名は、単純なパターンに対する特殊文字を使用します。マッチング文字「?」は単一の文字に一致する。文字「*」は、0 文字以上の文字列に一致する。引数名前がないメトリックの名を指定する。カンマ区切りのリストで、0 以上のメトリックテーブル名を指定できる。
servers	省略可能。メトリックを取得するサーバを指定する。有効な値は、WebLogic サーバ名および OPMN で管理されるコンポーネント名のリストである。 1 つのサーバを指定するには、次の構文を使用する。 servers='servername' 複数のサーバを指定するには、以下のいずれかの構文オプションを使用する。 servers=['servername1', 'servername2', ...] servers=('servername1', 'servername2', ...) この引数を指定しない場合、コマンドは、WebLogic サーバおよび OPMN で管理されるコンポーネントのすべてのメトリックテーブルのリストを返します。
variables	省略可能。メトリックの集約パラメータを定義する。有効な値は、Jython マップでの名前と値のペアのセットである。次の構文を使用します。 variables={name1:value1, name2:value2, ...} 特定の名前と値のペアは、集約されたメトリックテーブルによって異なります。集約されたメトリックテーブルのすべては、変数名の特定のセットがあります。

引数

定義

metricTable_n

省略可能。メトリックテーブルのリストを指定する。デフォルトでは、この引数はすべての使用可能なメトリックを表示する。メトリックテーブル名は、単純なパターンに対する特殊文字を使用します。マッチング文字「?」は単一の文字に一致する。文字「*」は、0 文字以上の文字列に一致する。

引数名前がないメトリックの名を指定する。

カンマ区切りのリストで、0 以上のメトリックテーブル名を指定できる。

servers

省略可能。メトリックを取得するサーバを指定する。有効な値は、WebLogic サーバ名および OPMN で管理されるコンポーネント名のリストである。

1 つのサーバを指定するには、次の構文を使用する。

servers='servername'

複数のサーバを指定するには、以下のいずれかの構文オプションを使用する。

servers=['servername1', 'servername2', ...]
servers=('servername1', 'servername2', ...)

この引数を指定しない場合、コマンドは、WebLogic サーバおよび OPMN で管理されるコンポーネントのすべてのメトリックテーブルのリストを返します。

variables

省略可能。メトリックの集約パラメータを定義する。有効な値は、Jython マップでの名前と値のペアのセットである。次の構文を使用します。

variables={name1:value1, name2:value2, ...}

特定の名前と値のペアは、集約されたメトリックテーブルによって異なります。集約されたメトリックテーブルのすべては、変数名の特定のセットがあります。

例

以下の例では、JVM および weblogic.management.runtime.WebAppComponentRuntimeMBean メトリックテーブルのデータを示し、Server-0 および Server-2 から取得されたデータに制限されます。

displayMetricTables('JVM','weblogic.management.runtime.WebAppComponentRuntimeMBean',
    servers=['soa_server1','bam_server1'])
.
.
.
ApplicationRuntime:     soa-infra
ComponentName:  /integration/services/IdentityService
ContextRoot:    /integration/services/IdentityService
DeploymentState:        2
FilterDispatchedRequestsEnabled:        false
IndexDirectoryEnabled:  false
JSPDebug:       false
JSPKeepGenerated:       false
JSPPageCheckSecs:       1
JSPVerbose:     true
ModuleId:       /integration/services/IdentityService
ModuleURI:      IdentityService.war
Name:   soa_server1_/integration/services/IdentityService
ObjectName:     com.bea:ApplicationRuntime=soa-infra,Name=soa_server1_/integration/services/IdentityService, 
 ServerRuntime=soa_server1,Type=WebAppComponentRuntime
OpenSessionsCurrentCount:       0
OpenSessionsHighCount:  0
.
.
.

以下の例では、指定したメトリックの集約パラメータを持つ集約されたメトリックテーブルを示します。

displayMetricTables('j2ee_application:webservices_port_rollup',
      servers=['soa_server1','bam_server1'],
      variables={'host':'hostname', 'servletName':'dms'})
----------------------------------------
j2ee_application:webservices_port_rollup
----------------------------------------
 
Faults: 0
Requests:       0
Requests.averageTime:   0.0
Requests.totalTime:     0.0
ServerName:     soa_server1
moduleName:     RuntimeConfigService
moduleType:     WEBs
portName:       RuntimeConfigServicePortSAML
processRequest.active:  0
service.throughput:     0.0
service.time:   0.0
startTime:      1238182359291
webserviceName: RuntimeConfigService
 
Faults: 0
Requests:       0
Requests.averageTime:   0.0
Requests.totalTime:     0.0
ServerName:     soa_server1
moduleName:     TaskMetadataService
moduleType:     WEBs
portName:       TaskMetadataServicePort
processRequest.active:  0
service.throughput:     0.0
service.time:   0.0
startTime:      1238182358096
webserviceName: TaskMetadataService
.
.
.

次の例では、指定したパターンに一致する名前のメトリックテーブルを示します。

displayMetricTables('J??', 'JVM_*')
.
.
.
---------------
JVM_ThreadStats
---------------
 
Host:   hostname.us.oracle.com
JVM:    JVM
Name:   threads
Parent: /JVM/MxBeans
Process:        AdminServer:9001
ServerName:     AdminServer
contention.value:       enabled in JVM
daemon.value:   60      threads
deadlock.value: 0       threads
live.value:     61      threads
peak.value:     66      threads
started.value:  241     threads
 
Host:   hostname.us.oracle.com
JVM:    JVM
Name:   threads
Parent: /JVM/MxBeans
Process:        soa_server1:9001
ServerName:     soa_server1
contention.value:       enabled in JVM
daemon.value:   68      threads
deadlock.value: 0       threads
live.value:     74      threads
peak.value:     74      threads
started.value:  105     threads
.
.
.

dumpMetrics

WLST の使用状況 : オンライン

説明

内部フォーマットまたは XML で利用可能なメトリックを示す。戻り値は、テキストドキュメントである。

構文

dumpMetrics([servers,] [format])

引数	定義
servers	省略可能。メトリックを取得するサーバを指定する。有効な値は、WebLogic サーバ名および OPMN で管理されるコンポーネント名のリストである。 1 つのサーバを指定するには、次の構文を使用する。 servers='servername' 複数のサーバを指定するには、以下のいずれかの構文オプションを使用する。 servers=['servername1', 'servername2', ...] servers=('servername1', 'servername2', ...) この引数を指定しない場合、コマンドは、WebLogic サーバおよび OPMN で管理されるコンポーネントのすべてのメトリックテーブルのリストを返します。
format	省略可能。コマンド出力フォーマットを指定する。有効な値は、「raw」および「xml」である。たとえば、 format='raw' format='xml' DMS の生のフォーマットは、単純なメトリック表示フォーマットで、1 つの行に 1 つのメトリックを表示する。

引数

定義

servers

省略可能。メトリックを取得するサーバを指定する。有効な値は、WebLogic サーバ名および OPMN で管理されるコンポーネント名のリストである。

1 つのサーバを指定するには、次の構文を使用する。

servers='servername'

複数のサーバを指定するには、以下のいずれかの構文オプションを使用する。

servers=['servername1', 'servername2', ...]
servers=('servername1', 'servername2', ...)

format

省略可能。コマンド出力フォーマットを指定する。有効な値は、「raw」および「xml」である。たとえば、

format='raw'
format='xml'

DMS の生のフォーマットは、単純なメトリック表示フォーマットで、1 つの行に 1 つのメトリックを表示する。

例

以下の例は、XML フォーマットにあるネイティブ WebLogic Server メトリックおよび内部的な DMS メトリックを含むすべての使用可能なメトリックを出力します。

dumpMetrics(format='xml')
<table name='weblogic_j2eeserver:jvm' keys='ServerName serverName'
 componentId='bam_server1' cacheable='false'>
<row cacheable='false'>
<column name='serverName'><![CDATA[bam_server1]]></column>
<column name='nurserySize.value' type='DOUBLE'>0.0</column>
<column name='jdkVersion.value'><![CDATA[1.6.0_05]]></column>
<column name='jdkVendor.value'><![CDATA[BEA Systems, Inc.]]></column>
<column name='daemonThreads.active' type='LONG'>68</column>
<column name='cpuUsage.percentage' type='DOUBLE'>100.0</column>
<column name='threads.active' type='LONG'>71</column>
<column name='ServerName'><![CDATA[bam_server1]]></column>
<column name='heapUsed.value' type='DOUBLE'>0.0</column>
</row>

以下の例では、Server-0 からのメトリックをデフォルトの生のフォーマットで出力します。

dumpMetrics(servers='Server-0')
.
.
.
    /JVM/MxBeans/threads/Thread-44 [type=JVM_Thread]
     ECID.value:        null
     RID.value: null
     blocked.value:     0       msec
     blockedCount.value:        1       times
     cpu.value: 40      msecs
     lockName.value:    null
     lockOwnerID.value: null
     lockOwnerName.value:       null
     name.value:        LDAPConnThread-0 ldap://10.229.149.27:7001
     state.value:       RUNNABLE
     waited.value:      0       msec
     waitedCount.value: 0       times
    /JVM/MxBeans/threads/Thread-45 [type=JVM_Thread]
     ECID.value:        null
     RID.value: null
     blocked.value:     0       msec
.
.
.

Server-0 および Server-1 からのメトリックを XML フォーマットで出力します。

dumpMetrics(servers=['soa_server1', 'bam_server1'], format='xml')
<table name='oracle_soainfra:high_latency_sync_composites' keys='ServerName
 soainfra_composite soainfra_composite_revision soainfra_domain'
 componentId='bam_server1' cacheable='false'>
</table>
<table name='weblogic_j2eeserver:ejb_transaction' keys='ServerName appName
 ejbModuleName name serverName' componentId='bam_server1' cacheable='false'>
<row cacheable='false'>
<column name='serverName'><![CDATA[bam_server1]]></column>
<column name='name'><![CDATA[MessagingClientParlayX]]></column>
<column name='ejbTransactionCommit.percentage' type='DOUBLE'>0.0</column>
<column name='ejbTransactionRollback.completed' type='LONG'>0</column>
<column name='ejbTransactionTimeout.throughput' type='DOUBLE'>0.0</column>
<column name='ejbTransactionCommit.completed' type='LONG'>0</column>
<column name='ejbTransactionTimeout.completed' type='LONG'>0</column>
<column name='appName'><![CDATA[usermessagingserver]]></column>
<column name='ejbTransactionRollback.throughput' type='DOUBLE'>0.0</column>
<column name='ServerName'><![CDATA[bam_server1]]></column>
<column name='ejbTransactionCommit.throughput' type='DOUBLE'>0.0</column>
<column name='ejbModuleName'><![CDATA[sdpmessagingclient-ejb-parlayx.jar]]></column>
</row>
.
.
.

reloadMetricRules

WLST の使用状況 : オンライン

説明

メトリックルールをリロードします。OPMN で管理されるコンポーネントをデプロイした後、またはメトリックルールを変更した後に、このコマンドを実行する必要があります。一般的に、メトリックルールは変更しないことをお勧めします。

構文

reloadMetricRules([servers])

引数	定義
servers	省略可能。メトリックルールを再ロードするサーバを指定する。有効な値は、WebLogic サーバ名および OPMN で管理されるコンポーネント名のリストである。 1 つのサーバを指定するには、次の構文を使用する。 servers='servername' 複数のサーバを指定するには、次の構文を使用する。 servers=['servername1', 'servername2', ...] servers=('servername1', 'servername2', ...) この引数を指定しない場合、コマンドは、WebLogic サーバおよび OPMN で管理されるコンポーネントのすべてのメトリックルールをリロードする。

引数

定義

servers

省略可能。メトリックルールを再ロードするサーバを指定する。有効な値は、WebLogic サーバ名および OPMN で管理されるコンポーネント名のリストである。

1 つのサーバを指定するには、次の構文を使用する。

servers='servername'

複数のサーバを指定するには、次の構文を使用する。

servers=['servername1', 'servername2', ...]
servers=('servername1', 'servername2', ...)

この引数を指定しない場合、コマンドは、WebLogic サーバおよび OPMN で管理されるコンポーネントのすべてのメトリックルールをリロードする。

例

以下の例は、指定された管理対象サーバで、メトリックルールをリロードする。

reloadMetricRules(servers='soa_server1')
Location changed to domainRuntime tree. This is a read-only tree with Domainmbean
 as the root.
For more help, use help(domainRuntime)
 
loaded 'server-oracle_eps_server-11.0.xml'
loaded 'server-weblogic_j2eeserver-11.0.xml'
loaded 'server-oracle_bamweb-11.0.xml'
loaded 'server-oracle_federation-11.0.xml'
loaded 'server-portal-11.0.xml'
loaded 'server-weblogic_j2ee_application_webcenter-11.0.xml
.
.
.