Oracle® Fusion Middlewareインフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス 12c (12.1.2) E48021-01 |
|
前 |
次 |
この章では、パフォーマンス・メトリックの表示およびイベント・トレースの構成に使用できるダイナミック・モニタリング・サービス(DMS)のWLSTコマンドについて詳細に説明します。この章では、コマンド構文、引数およびコマンド例について説明します。
注意: これらのDMSのカスタムWLSTコマンドを使用するには、Oracle共通ホームからWLSTスクリプトを起動する必要があります。『Oracle Fusion Middlewareの管理』のカスタムWLSTコマンドの使用に関する項を参照してください。 |
表6-1の各カテゴリのDMSコマンドを使用して、パフォーマンス・メトリックの表示およびイベント・トレースを構成します。
表6-1 DMSコマンド・カテゴリ
コマンド・カテゴリ | 説明 |
---|---|
|
DMSシステム構成パラメータを設定および表示します。 |
|
パフォーマンス・メトリックに関する情報を表示します。 |
|
一連のナウン・タイプを一連のパラメータ名のセットに関連付ける制約およびルールを指定して、メトリックを作成します |
|
イベント・トレースを構成します |
表6-2のコマンドを使用して、システム・プロパティを構成し、システム・プロパティを表示します。
表6-2 DMSの構成コマンド
使用するコマンド | 目的 | WLST使用 |
---|---|---|
listDMSConfigurationParameters |
1つ以上のDMS構成パラメータに関する情報を表示します。 |
オンライン |
|
DMS構成パラメータの値を設定します。 |
オンライン |
オンラインで使用します。
listDMSConfigurationParameters([name='parameter_name'][, server='server_name'])
引数 | 定義 |
---|---|
name |
パラメータ名。 |
server |
サーバーの名前。 |
次の例では、すべてのDMSシステム構成パラメータに関する情報を表示します。
listDMSConfigurationParameters()
Server: AdminServer
Parameter Config Value Runtime Value
DMSClockType DEFAULT DEFAULT
SensorActivationLevel NORMAL NORMAL
DMSClockUnits MICROSECONDS MICROSECONDS
次の例では、DMSシステム構成パラメータDMSClockUnitsに関する情報を表示します。
listDMSConfigurationParameters(name="DMSClockUnits")
Server: AdminServer
Parameter Config Value Runtime Value
DMSClockUnits MICROSECONDS MICROSECONDS
オンラインで使用します。
setDMSConfigurationParameter(name='parameter_name', value='value', server='server_name')
引数 | 定義 |
---|---|
name |
パラメータ名。 |
value |
パラメータの値。 |
server |
サーバーの名前。 |
次の表に、サポートされている構成パラメータを、対応するシステム・プロパティとともにリストします。これらのシステム・プロパティは、現在は非推奨です。
構成パラメータ | 値 | デフォルト | 非推奨のシステム・プロパティ |
---|---|---|---|
DMSClockType |
default | highres |
default |
oracle.dms.clock |
DMSClockUnits |
milliseconds | microseconds | nanoseconds |
microseconds |
oracle.dms.clock.units |
SensorActivationLevel |
none | normal | heavy | all |
normal |
oracle.dms.sensors |
DMSPublisherClass |
任意の文字列 |
null (構成デフォルト) |
oracle.dms.publisher.classes |
DMSHTTPPort |
任意の数値のポート番号 |
0 (構成デフォルト) |
oracle.dms.httpd.port.start |
表6-3のコマンドを使用して、特定のパフォーマンス・メトリック、一連のパフォーマンス・メトリックまたは特定のサーバーまたはコンポーネントに対するすべてのパフォーマンス・メトリックに関する情報を表示します。
メトリックの詳細は、『Oracle Fusion Middlewareの管理』の章「Oracle Fusion Middlewareの監視」および『パフォーマンスのチューニング・ガイド』の章「Oracle Dynamic Monitoring Serviceの使用方法」を参照してください。
表6-3 DMSメトリック・コマンド
使用するコマンド | 目的 | WLST使用 |
---|---|---|
|
使用可能なメトリック表の名前を表示します。 |
オンライン |
|
DMSメトリック表の内容を表示します。 |
オンライン |
|
使用可能なメトリックを表示します。 |
オンライン |
|
メトリック・ルールをリロードします。 |
オンライン |
コマンド・カテゴリ: DMSメトリック
WLST使用: オンライン
displayMetricTableNames([servers])
引数 | 定義 |
---|---|
servers
|
オプション。メトリックの取得元となるサーバーを指定します。有効な値は、WebLogic Serverインスタンス名およびシステム・コンポーネント名のリストです。 1つのサーバーを指定するには、次の構文を使用します。
servers='servername'
複数のサーバーを指定するには、次のいずれかの構文オプションを使用します。 servers=['servername1', 'servername2', ...] servers=('servername1', 'servername2', ...) この引数が指定されない場合、すべてのWebLogicサーバーおよびシステム・コンポーネントのメトリック表の名前のリストがコマンドによって返されます。 Oracle HTTP Serverなどのシステム・コンポーネントの場合は、次の書式を使用します。 servers=['component_name], servertype='component_type') |
次の例では、すべてのWebLogicサーバーおよびシステム・コンポーネントのメトリック表の名前を表示します。
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
.
.
.
次の例では、WebLogic管理対象サーバーwls_server1のメトリック表の名前を表示します。
displayMetricTableNames(servers='wls_server1')
ADF
JVM
JVM_ClassLoader
JVM_Compiler
JVM_GC
JVM_Memory
JVM_MemoryPool
JVM_MemorySet
JVM_OS
JVM_Runtime
.
.
.
次の例では、2つのWebLogic管理対象サーバーのメトリック表の名前を表示します。
displayMetricTableNames(servers=['wls_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
.
.
.
次の例では、Oracle HTTP Serverインスタンスohs_1のメトリック表の名前を表示します。
displayMetricTableNames(servers='ohs_1', servertype='OHS')
コマンド・カテゴリ: DMSメトリック
WLST使用: オンライン
DMSメトリック表の内容を表示します。
返される値は、メトリック表のリストで、各表について次の情報が含まれています。
メトリック表の名前。
メトリック表のスキーマ情報
メトリック表の行。
メトリック表のスキーマ情報には、次が含まれています。
列の名前です。
列値のタイプ。
列の単位。
列の説明。
displayMetricTables([metricTable_1] [, metricTable_2], [...] [, servers] [, variables])
引数 | 定義 |
---|---|
metricTable_n |
オプション。メトリック表のリストを指定します。デフォルトでは、この引数は使用可能なすべてのメトリックを表示します。メトリック表名には、単純なパターン照合のための特殊文字を含むことができます。文字「?」は任意の1文字と一致します。文字「*」はゼロ個以上の文字と一致します。 メトリック表の名前を指定します。カンマ区切りのリストで複数のメトリック表名を指定できます。 これらは、WLSTのコマンドdisplayMetricTableNamesによって出力されるものと同じ名前です。 |
servers
|
オプション。メトリックの取得元となるサーバーを指定します。有効な値は、WebLogic Serverインスタンス名およびシステム・コンポーネント名のリストです。 1つのサーバーを指定するには、次の構文を使用します。 servers='servername' 複数のサーバーを指定するには、次のいずれかの構文オプションを使用します。 servers=['servername1', 'servername2', ...] servers=('servername1', 'servername2', ...) この引数が指定されない場合、すべてのWebLogicサーバーおよびシステム・コンポーネントのメトリック表のリストがコマンドによって返されます。 Oracle HTTP Serverなどのシステム・コンポーネントの場合は、次の書式を使用します。 servers=['component_name], servertype='component_type') |
variables
|
オプション。メトリック集計パラメータを定義します。有効な値は、名前と値のペアのセットです。次の構文を使用します。 variables={name1:value1, name2:value2, ...} 特定の名前と値のペアは、集計されたメトリック表に依存します。集計された各メトリック表には、特定の変数名セットが含まれます。 |
次の例では、JVMおよびweblogic.management.runtime.WebAppComponentRuntimeMBeanメトリック表のデータを表示し、wls_server1およびwls_server2から取得されたデータに制限します。
displayMetricTables('JVM','weblogic.management.runtime.WebAppComponentRuntimeMBean', servers=['wls_server1','wlsserver2']) . . . --- JVM --- Host: host.example.com Name: JVM Parent: / Process: wls_server_2:7004 ServerName: wls_server_2 activeThreadGroups.maxValue: 8.0 groups activeThreadGroups.minValue: 7.0 groups activeThreadGroups.value: 8 groups activeThreads.maxValue: 58.0 threads activeThreads.minValue: 39.0 threads activeThreads.value: 57 threads freeMemory.maxValue: 174577.0 kbytes freeMemory.minValue: 12983.0 kbytes freeMemory.value: 98562 kbytes startTime.value: 1368467917680 msecs . . .
次の例では、集計されたメトリック表と指定されたメトリック集計パラメータを表示します。
displayMetricTables('j2ee_application:webservices_port_rollup', servers=['wls_server1','ls_server1'], variables={'host':'hostname', 'servletName':'dms'}) ---------------------------------------- j2ee_application:webservices_port_rollup ---------------------------------------- Faults: 0 Requests: 0 Requests.averageTime: 0.0 Requests.totalTime: 0.0 ServerName: wls_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: wls_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.com
JVM: JVM
Name: threads
Parent: /JVM/MxBeans
Process: AdminServer:7001
ServerName: AdminServer
contention.value: enabled in JVM
daemon.value: 85 threads
deadlock.value: 0 threads
live.value: 89 threads
peak.value: 95 threads
started.value: 836 threads
.
.
.
コマンド・カテゴリ: DMSメトリック
WLST使用: オンライン
dumpMetrics([servers] [, format])
引数 | 定義 |
---|---|
servers
|
オプション。メトリックの取得元となるサーバーを指定します。有効な値は、WebLogic Serverインスタンス名およびシステム・コンポーネント名のリストです。 1つのサーバーを指定するには、次の構文を使用します。
servers='servername'
複数のサーバーを指定するには、次のいずれかの構文オプションを使用します。 servers=['servername1', 'servername2', ...] servers=('servername1', 'servername2', ...) この引数が指定されない場合、すべてのWebLogicサーバーおよびシステム・コンポーネントのメトリック表のリストがコマンドによって返されます。 Oracle HTTP Serverなどのシステム・コンポーネントの場合は、次の書式を使用します。 servers=['component_name], servertype='component_type') |
format
|
オプション。コマンドの出力形式を指定します。有効な値はraw (デフォルト)、xmlおよびpdmlです。次に例を示します。 format='raw' format='xml' format='pdml' DMS RAW形式は単純なメトリック表示形式で、1行につき1つのメトリックを表示します。 |
次の例では、ネイティブWebLogicサーバー・メトリックおよび内部DMSメトリックを含む使用可能なすべてのメトリックをXML形式で出力します。
dumpMetrics(format='xml')
<table name='weblogic_j2eeserver:jvm' keys='ServerName serverName'
componentId='wls_server1' cacheable='false'>
<row cacheable='false'>
<column name='serverName'><![CDATA[wls_server2]]></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[wls_server2]]></column>
<column name='heapUsed.value' type='DOUBLE'>0.0</column>
</row>
次の例では、Server-0のメトリックをデフォルトのRAW形式で出力します。
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://host: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 . . .
次の例では、wls_server1とwls_server2のメトリックをXML形式で出力します。
dumpMetrics(servers=['wls_server1', 'wls_server2'], format='xml')
<table name='oracle_soainfra:high_latency_sync_composites' keys='ServerName
soainfra_composite soainfra_composite_revision soainfra_domain'
componentId='wls_server2' cacheable='false'>
</table>
<table name='weblogic_j2eeserver:ejb_transaction' keys='ServerName appName
ejbModuleName name serverName' componentId='wls_server2' cacheable='false'>
<row cacheable='false'>
<column name='serverName'><![CDATA[wls_server2]]></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[wls_server2]]></column>
<column name='ejbTransactionCommit.throughput' type='DOUBLE'>0.0</column>
<column name='ejbModuleName'><![CDATA[sdpmessagingclient-ejb-parlayx.jar]]></column>
</row>
.
.
.
コマンド・カテゴリ: DMSメトリック
WLST使用: オンライン
メトリック・ルールをリロードします。このコマンドは、システム・コンポーネントのデプロイ後、またはメトリック・ルールの変更後に実行する必要があります。通常は、メトリック・ルールは変更しないことをお薦めします。
次の例では、ドメイン内で実行中のすべてのサーバーでメトリック・ルールをリロードします。
reloadMetricRules()
Location changed to domainRuntime tree. This is a read-only tree with DomainMBean
as the root.
For more help, use help(domainRuntime)
loaded 'server-mds-11.0.xml'
loaded 'server-weblogic_j2ee_application_webservices-11.0.xml'
loaded 'server-weblogic_j2eeserver_adf-11.0.xml'
loaded 'server-weblogic_soa_composite-11.0.xml'
loaded 'server-weblogic_j2eeserver_webservices-11.0.xml'
loaded 'server-oracle_sdpmessaging-11.0.xml'
loaded 'server-weblogic_j2ee_application_webcenter-11.0.xml'
loaded 'server-weblogic_j2eeserver-11.0.xml'
reloaded metric rules for server 'wls_server_1'
.
.
.
パラメータ・スコープ・メトリック・コマンドでは、一連のナウン・タイプを一連のパラメータ名のセットに関連付ける制約およびルールを指定して、メトリックを作成できます。
表6-4のコマンドを使用して、パラメータ・スコープ・メトリックを管理します。
表6-4 DMSパラメータ・スコープ・メトリック・ルール・コマンド
使用するコマンド | 目的 | WLST使用 |
---|---|---|
createDMSScopedMetricsParameterConstraint |
setParameterScopedMetricsRuleコマンドで使用できるパラメータ制約を作成します。 |
オンライン |
deleteDMSParameterScopedMetricsRules |
指定したパラメータ・スコープ・メトリック・ルールを削除します。 |
オンライン |
|
指定したルールIDのパラメータ・スコープ・メトリック・データを表示します。 |
オンライン |
|
DMSで認識されている実行コンテキスト・パラメータのセットをリストします。 |
オンライン |
listDMSParameterScopedMetricsRules |
現在のパラメータ・スコープ・メトリックの構成を表示します。 |
オンライン |
resetDMSParameterScopedMetrics |
特定のルール識別子に関連付けられているパラメータ・スコープ・メトリック・データをリセットします。 |
オンライン |
sampleDMSContextParameterValues |
指定された名前のコンテキスト・パラメータの値セットのサンプルを収集します。 |
オンライン |
setDMSParameterScopedMetricsRule |
パラメータ・スコープ・メトリック・ルールを作成または更新します。 |
オンライン |
コマンド・カテゴリ: DMSパラメータ・スコープ・メトリック
WLST使用: オンライン
createDMSScopedMetricsParameterConstraint(name [, values] [,maxnumofvalues])
引数 | 定義 |
---|---|
name
|
制約の参照先パラメータの名前。 |
values
|
オプション。制約によって適用される特定の値のリスト。 |
maxmumofvalues
|
オプション。制約で使用される値の最大数。関係するにもかかわらず指定しなかった場合、値が10と仮定されます。valuesオプションが指定されている場合、この値は無視されます。 |
コマンド・カテゴリ: DMSパラメータ・スコープ・メトリック
WLST使用: オンライン
deleteDMSParameterScopedMetricsRules([server,] ids)
引数 | 定義 |
---|---|
server
|
オプション。パラメータ・スコープ・メトリックの削除元となるサーバーを指定します。有効な値は、WebLogic Serverインスタンス名およびシステム・コンポーネント名のリストです。 サーバーを指定するには、次の構文を使用します。
server='servername'
この引数が指定されない場合、すべてのWebLogicサーバーおよびシステム・コンポーネントのメトリック表のリストがコマンドによって返されます。 この引数を使用するには、管理サーバーに接続している必要があります。 Oracle HTTP Serverなどのシステム・コンポーネントの場合は、次の書式を使用します。
servers=['component_name], servertype='component_type')
|
ids |
削除するルールの識別子のリスト。複数の識別子を指定するには、IDをカンマで区切り、全体を大カッコで囲みます。次に例を示します。 ids=["id1", "id2" |
コマンド・カテゴリ: DMSパラメータ・スコープ・メトリック
WLST使用: オンライン
dumpParameterScopedMetrics([server, ]ruleid)
引数 | 定義 |
---|---|
server
|
オプション。パラメータ・スコープ・メトリック・データのダンプ先となるサーバーを指定します。有効な値は、WebLogic Serverインスタンス名およびシステム・コンポーネント名のリストです。 サーバーを指定するには、次の構文を使用します。
server='servername'
この引数が指定されない場合、すべてのWebLogicサーバーおよびシステム・コンポーネントのメトリック表のリストがコマンドによって返されます。 この引数を使用するには、管理サーバーに接続している必要があります。 Oracle HTTP Serverなどのシステム・コンポーネントの場合は、次の書式を使用します。
servers=['component_name], servertype='component_type')
|
ruleid
|
データを表示するパラメータ・スコープ・メトリック・ルールのID。 |
コマンド・カテゴリ: DMSパラメータ・スコープ・メトリック
WLST使用: オンライン
listDMSContextParameters([server][, parameternames] [,verbose])
引数 | 定義 |
---|---|
server
|
オプション。実行コンテキスト・パラメータを表示するサーバーを指定します。有効な値は、WebLogic Serverインスタンス名およびシステム・コンポーネント名のリストです。 サーバーを指定するには、次の構文を使用します。
server='servername'
この引数が指定されない場合、すべてのWebLogicサーバーおよびシステム・コンポーネントのメトリック表のリストがコマンドによって返されます。 この引数を使用するには、管理サーバーに接続している必要があります。 Oracle HTTP Serverなどのシステム・コンポーネントの場合は、次の書式を使用します。
servers=['component_name], servertype='component_type')
|
parameternames
|
オプション。該当する実行コンテキスト・パラメータの名前のリスト。サーバー上に見つからないパラメータ名は無視されます(エラーはレポートされません)。この引数が使用されない場合、すべての実行コンテキスト・パラメータがリストされます。 |
verbose
|
オプション。 |
コマンド・カテゴリ: DMSパラメータ・スコープ・メトリック
WLST使用: オンライン
listDMSParameterScopedMetricsRules([server])
引数 | 定義 |
---|---|
server
|
オプション。パラメータ・スコープ・メトリック構成を表示するサーバーを指定します。有効な値は、WebLogic Serverインスタンス名およびシステム・コンポーネント名のリストです。 サーバーを指定するには、次の構文を使用します。
server='servername'
この引数が指定されない場合、すべてのWebLogicサーバーおよびシステム・コンポーネントのメトリック表のリストがコマンドによって返されます。 この引数を使用するには、管理サーバーに接続している必要があります。 Oracle HTTP Serverなどのシステム・コンポーネントの場合は、次の書式を使用します。
servers=['component_name], servertype='component_type')
|
コマンド・カテゴリ: DMSパラメータ・スコープ・メトリック
WLST使用: オンライン
特定のルール識別子に関連付けられているパラメータ・スコープ・メトリック・データをリセットします。この操作は原子性でない場合があるため、リセット操作が進行中でも、メトリック・データは引き続き収集されます。
resetDMSParameterScopedMetrics([server,] ids)
引数 | 定義 |
---|---|
server
|
オプション。パラメータ・スコープ・メトリックをリセットするサーバーを指定します。有効な値は、WebLogic Serverインスタンス名およびシステム・コンポーネント名のリストです。 サーバーを指定するには、次の構文を使用します。
server='servername'
この引数が指定されない場合、すべてのWebLogicサーバーおよびシステム・コンポーネントのメトリック表のリストがコマンドによって返されます。 この引数を使用するには、管理サーバーに接続している必要があります。 Oracle HTTP Serverなどのシステム・コンポーネントの場合は、次の書式を使用します。
servers=['component_name], servertype='component_type')
|
ids
|
リセットするルールの識別子のリスト。複数の識別子を指定するには、IDをカンマで区切り、全体を大カッコで囲みます。次に例を示します。 ids=["id1", "id2" |
コマンド・カテゴリ: DMSパラメータ・スコープ・メトリック
WLST使用: オンライン
sampleDMSContextParameterValues(parametername [, naxmuofvaleus] [,action])
引数 | 定義 |
---|---|
parametername
|
オプション。サンプリング対象のコンテキスト・パラメータの名前。この引数は、引数 |
manmumofvalues
|
オプション。サンプルに含める個別値の最大数。省略した場合、値10が適用されます。値0では、すべての個別値がサンプリングされます。コンテキスト・パラメータによっては、これは無制限のサイズのセットをサンプリングすることを意味します。action="start"を指定した場合にのみ関連します。 |
action
|
オプション。サンプリング対象のアクション。この引数は、引数 有効な値は、次のとおりです。
|
次の例では、パラメータbespoke.ServiceLevelの値のサンプリングを開始します。
sampleDMSContextParameterValues(parametername="bespoke.ServiceLevel", maxnumofvalues=5, action="start")
Values of the parameter bespoke.ServiceLevel are now being sampled.
List of parameters currently being sampled:
bespoke.ServiceLevel has been sampled for 0 seconds.
次の例では、サンプリングを停止して、値のヒストグラムを表示します。
sampleDMSContextParameterValues()
List of parameters currently being sampled: bespoke.ServiceLevel has been sampled for 87 seconds.
sampleDMSContextParameterValues(parametername="bespoke.ServiceLevel", action="stop")
Histogram of values for parameter bespoke.ServiceLevel.
Gold 21
Silver 5
Bronze 37
Values of the parameter bespoke.ServiceLevel will no longer be sampled.
コマンド・カテゴリ: DMSパラメータ・スコープ・メトリック
WLST使用: オンライン
パラメータ・スコープ・メトリック・ルールを作成または更新します。特定のナウン・タイプとパラメータの組合せについて、メトリックのコレクションを管理できるのは一度に1つのルールです。たとえば、コンテキスト・パラメータURIおよびナウン・タイプJDBC_Connectionに基づいて、2つの個別のルールでパラメータ・スコープ・メトリックの収集を試行することはできません。
setDMSParameterScopedMetricsRule([server,] id, nountypes [, ctxparamconstraints][, actparamconstraints] [,replace={true|false}])
引数 | 定義 |
---|---|
server
|
オプション。パラメータ・スコープ・メトリック・ルールを設定するサーバーを指定します。有効な値は、WebLogic Serverインスタンス名およびシステム・コンポーネント名のリストです。 サーバーを指定するには、次の構文を使用します。
server='servername'
この引数が指定されない場合、すべてのWebLogicサーバーおよびシステム・コンポーネントのメトリック表のリストがコマンドによって返されます。 この引数を使用するには、管理サーバーに接続している必要があります。 Oracle HTTP Serverなどのシステム・コンポーネントの場合は、次の書式を使用します。
servers=['component_name], servertype='component_type')
|
id
|
ルールの識別子。 |
nountypes
|
ルールが適用されるナウン・タイプのリスト。 |
ctxparamconstraints
|
オプション。このルールで使用されるコンテキスト・パラメータ制約のリスト。この引数またはactparamconstraintsのうち少なくとも1つを指定する必要があります。 |
actparamconstraints
|
オプション。このルールで使用されるアクティブ化パラメータ制約のリスト。この引数またはctxparamconstraintsのうち少なくとも1つを指定する必要があります。 |
replace |
オプション。 |
表6-5のコマンドを使用して、イベント・トレースを構成します。イベント・トレースでは、再起動せずにライブ・トレースを構成します。Oracle Fusion Middleware製品を使用して更新されたDMSメトリックは、DMSイベント・トレース機能でトレースされる場合があります。
DMSイベント・トレースの使用の詳細は、パフォーマンスのチューニングのDMSトレースおよびイベントに関する項を参照してください。
表6-5 DMSトレース・コマンド
使用するコマンド | 目的 | WLST使用 |
---|---|---|
|
新規宛先をイベント・トレース構成に追加します。 |
オンライン |
|
フィルタをイベント・トレース構成に追加します。 |
オンライン |
|
指定されたイベント・ルートをイベント・トレース構成に追加します。 |
オンライン |
|
イベント・トレースを有効にして、指定した条件と宛先、および有効化されたイベント・ルートを使用してフィルタを作成します。 |
オンライン |
|
イベント・トレース構成の概要を表示します。 |
オンライン |
|
宛先の完全な構成またはすべての宛先のリストを表示します。 |
オンライン |
|
フィルタの構成またはすべてのフィルタのリストを表示します。 |
オンライン |
|
イベント・ルートおよびそのステータス(有効または無効)を表示します。 |
オンライン |
|
指定した宛先を削除します。 |
オンライン |
|
指定したフィルタを削除します。 |
オンライン |
|
指定したイベント・ルートを削除します。 |
オンライン |
|
イベントの宛先の構成を更新します。 |
オンライン |
|
イベント・フィルタの構成を更新します。 |
オンライン |
|
イベント・ルートの構成を更新します。 |
オンライン |
コマンド・カテゴリ: DMSイベント・トレース
WLST使用: オンライン
新規宛先をイベント・トレース構成に追加します。同じIDの宛先がすでに存在している場合、コマンドによってその旨が報告され、宛先は追加されません。宛先を追加するには、管理サーバーに接続している必要があります。接続していない場合は、エラーが返されます。
addDMSEventDestination(id=id [, name=dest_name] ,class=class_name [, props= {'name': 'value'...}] [,server=server_name])
引数 | 定義 |
---|---|
id |
指定した宛先の一意の識別子。 |
name |
オプション。宛先の名前。 |
class |
宛先の完全クラス名。 使用可能なクラスのリストについては、表6-6を参照してください。 |
props |
オプション。宛先に使用される名前/値プロパティ。プロパティが必要な宛先もあります。たとえば、LoggerDestinationクラスでは、プロパティloggerNameが必要です。 構文および許可される値については、「addDMSEventFilter」を参照してください。 |
server
|
オプション。この操作を実行するサーバー。デフォルトは、接続しているサーバーです。 |
表6-6に、完全ランタイム・クラス名を表示した組込みの宛先を示します。
表6-6 組込みの宛先
ランタイム宛先クラス名 | 説明 |
---|---|
oracle.dms.trace2.runtime.LoggerDestination |
ODLを使用して、ログ・メッセージをファイルに送信します。 |
oracle.dms.event.HTTPRequestTrackerDestination |
アクティブなHTTPリクエストのセットをダンプして、管理者がアクティビティのスナップショットを取得できるようにします。 |
oracle.dms.jrockit.jfr.JFRDestination |
イベントをJRockitフライト・レコーダに渡して、JRockit Mission Controlを使用してJRockit JVMおよびWLDFからの他のデータのコンテキストでそのイベントを表示できるようにします。 |
oracle.dms.jmx.MetricMBeanFactory |
ナウンをMBeanとして公開します。 |
oracle.dms.util.StackTraceCollatorDestination |
該当するイベントの発生中に、実行中のスタック・トレースを照合します。これは、基本的にはデバッグ・ツールです。 照合済データは、シャットダウン時および、処理されているイベントが一定の時間内(デフォルトは1分)にレポートされなかった場合に書き出されます。 |
次の例では、IDがdestination1、名前がFile-system、クラスがoracle.dms.trace2.runtime.LoggerDestinationの宛先を追加します。LoggerDestinationではプロパティloggerNameが必要なため、値はtrace2-loggerに設定されます。
addDMSEventDestination(id='destination1', name='File-system', class='oracle.dms.trace2.runtime.LoggerDestination', props={'loggerName': 'trace2-logger'}) Destination "destination1" added.
次の例では、すでに存在しているIDを持つ宛先の追加を試みます。
addDMSEventDestination(id='destination1', name='File-system', class='oracle.dms.trace2.runtime.LoggerDestination', props={'loggerName': 'trace2-logger'}) Destination "destination1" already exists. Unable to add this.
コマンド・カテゴリ: DMSイベント・トレース
WLST使用: オンライン
フィルタをイベント・トレース構成に追加します。同じIDのフィルタがすでに存在している場合、コマンドによってエラーが返され、フィルタは追加されません。
イベント・フィルタを追加するには、管理サーバーに接続している必要があります。接続していない場合は、エラー・メッセージがレポートされます。
addDMSEventFilter(id=id [, name=name] [, etypes] , props= {'prop-name': 'value'...} [, server=server_name])
引数 | 定義 |
---|---|
id |
指定したフィルタの一意の識別子。 |
name |
オプション。フィルタ名。 |
etypes |
オプション。イベントとアクションのペアのカンマ区切りのリストを含む文字列。この引数を条件とともに使用することで、よりきめ細かいフィルタを作成することが可能になります。また、より広範囲なメトリックを持つフィルタを作成することもできます。たとえば、すべてのナウン、またはアクションが作成されているすべてのナウンです。 |
props |
prop-name: フィルタ・プロパティの名前。唯一有効なプロパティは
|
server
|
オプション。この操作を実行するサーバー。デフォルトは、接続しているサーバーです。 |
etypes
の構文は次のとおりです。
<etypes>:==
<type>:[<action>]
有効なetypesを次にリストします。
NOUN:CREATE|DELETE|TYPE_CHANGE SENSOR EVENT_SENSOR:CREATE|DELETE|METRIC_SELECTION_CHANGED, PHASE_SENSOR:CREATE|DELETE|METRIC_SELECTION_CHANGED|START|STOP|ABORT STATE_SENSOR:CREATE|DELETE|METRIC_SELECTION_CHANGED|UPDATE ROLLUP_SENSOR:CREATE|DELETE|METRIC_SELECTION_CHANGED EXECUTION_CONTEXT:START|STOP|SUSPEND HTTP_REQUEST:START|STOP|CONTEXT_CHANGED
次のことに注意してください。
SENSORには関連付けられたアクションはなく、関連するすべてのSENSORSおよび関連するアクションを含むために拡張されます。
関連付けられたアクションを指定しないタイプは、そのタイプのすべてのアクションにデフォルト設定されます。たとえば、HTTP_REQUESTは次にデフォルト設定されます。
HTTP_REQUEST:START,HTTP_REQUEST:STOP、HTTP_REQUEST:CONTEXT_CHANGED
2つのイベントとアクションのペアがカンマで区切られたetypeを次に示します。
etypes='NOUN:DELETE, STATE_SENSOR:DELETE'
引数props
の<condition>
プロパティの構文を次に示します。引数については、構文の次にある表で説明しています。
<condition>::=
<type> [<operator> <condition>]
<type>::=
<nountype> | <context>
<nountype>::= NOUNTYPE <nountype-operator> value
<nountype-operator>::=
"equals" | "starts_with" | "contains" | "not_equals"
<context>::=
CONTEXT <name> <context-operator> [<value>] [IGNORECASE=true|false] [DATATYPE="string|long|double"
]
<context-operator>::=
"equals" | "starts_with" | "contains" | "not_equals" | "is_null" | "gt" | "le" | "ge"
<operator>::=
AND |OR
次の表に、<type>の引数について説明します。
値 | 説明 |
---|---|
<nountype> |
関連するメトリックのある各センサーは、ナウンに応じた階層に構成されています。ナウン・タイプは、収集された一連のメトリックを反映した名前です。たとえば、JDBCはナウン・タイプです。センサーおよびナウンの詳細は、パフォーマンスのチューニングの共通のDMSの用語と概念の理解に関する項を参照してください。 |
<context> |
実行コンテキストは、実行コンテキストID (ECID)、関係ID (RID)および値のマップの関連付けです。この引数を使用することで、値のマップ内に格納されているデータをフィルタが調べて使用できるようになります。たとえば、マップにuserというキーが含まれている場合、userがbruceであるリクエストを返すフィルタを作成できます。 |
次の表に、<nountype>の引数について説明します。
値 | 説明 |
---|---|
NOUNTYPE |
キーワード。 |
<nountype-operator> |
有効な演算子は次のとおりです。
|
value |
操作対象のナウン・タイプの名前。パフォーマンスを測定するどのオブジェクトの名前でも指定できます。 |
次の表では、<context>について説明します。
値 | 説明 |
---|---|
CONTEXT |
キーワード。 |
name |
絞り込むコンテキストの名前。 |
value |
操作対象のコンテキストの名前。 |
<context-operator> |
有効な演算子は次のとおりです。
|
IGNORECASE |
オプション。指定された場合、文字列データ型の大文字/小文字の区別は無視されます。デフォルトは、コンテキストで使用されている大文字/小文字です。 IGNORECASE AND DATATYPEは、コマンド内の位置には依存しません。 |
DATATYPE |
オプション。有効な値は、string、longまたはdoubleです。デフォルトはstringです。 IGNORECASE AND DATATYPEは、コマンド内の位置には依存しません。 |
次の例では、名前がMyFilterのフィルタを、ナウン・タイプおよびコンテキストを指定して追加します。
addDMSEventFilter(id='mds1', name='MyFilter', props={'condition': 'NOUNTYPE equals MDS_Connections AND CONTEXT user equals bruce IGNORECASE'}) Filter "mds1" added.
次の例では、同じIDを持つフィルタの追加を試みます。コマンドによってエラーが返されます。
addDMSEventFilter(id='mds1', name='MyFilter', props={'condition': 'NOUNTYPE equals MDS_Connections AND CONTEXT user equals bruce'}) Unable to add filter "mds1" as a filter with that ID already exists for server "AdminServer".
次の例では、2つのイベントとアクションのペアを持つフィルタを追加します。
addDMSEventFilter(id='mds2', name='MyFilter', etypes='NOUN:CREATE,HTTP_REQUEST:START', props={'condition': 'NOUNTYPE equals MDS_Connections AND CONTEXT user equals bruce IGNORECASE=true'}) Filter "mds2" added.
コマンド・カテゴリ: DMSイベント・トレース
WLST使用: オンライン
指定されたイベント・ルートをイベント・トレース構成に追加します。同じIDのイベント・ルートがすでに存在している場合、コマンドによってエラーが返され、イベント・ルートは追加されません。
イベント・ルートを追加するには、管理サーバーに接続している必要があります。接続していない場合は、エラーが返されます。
addDMSEventRoute([filterid=filter_id], destinationid=destination_id, [enable=true|false] [,server=server_name])
引数 | 定義 |
---|---|
filterid |
オプション。フィルタの一意の識別子。 |
destinationid |
特定の宛先の一意の識別子。この宛先が存在している必要があります。 |
enable |
オプション。フィルタを有効にします。有効な値は |
server
|
オプション。この操作を実行するサーバー。デフォルトは、接続しているサーバーです。 |
次の例では、フィルタIDがmds1で宛先IDがdestination1であるイベント・ルートを追加します。
addDMSEventRoute(filterid='mds1', destinationid='destination1', enable='false')
Event-route for filter "mds1", destination "destination1" added for server "AdminServer".
次の例では、すでに存在しているイベント・ルートの追加を試みます。
addDMSEventRoute(filterid='mds1', destinationid='destination1', enable='false')
Unable to add event route as a mapping with filter "mds1" and destination "destination1" already exists for server "AdminServer".
コマンド・カテゴリ: DMSイベント・トレース
WLST使用: オンライン
イベント・トレースを有効にして、指定した条件と宛先、および有効化されたイベント・ルートを使用してフィルタを作成します。これは、フィルタ、宛先およびイベント・ルートを明示的に作成せずにフィルタ処理を開始する簡単な方法ですが、構成オプションは少なくなります。指定した宛先が存在している必要があります。
DMSイベント・トレースを有効化するには、管理サーバーに接続している必要があります。接続していない場合は、エラーが返されます。
より複雑な構成が必要な場合は、addDMSEventDestination、addDMSEventFilterおよびaddDMSEventRouteを使用します。
enableDMSEventTrace(destinationid=destinationid [, etypes=etype] [, condition=condition] [, server=server_name])
引数 | 定義 |
---|---|
destinationid
|
特定の宛先の一意の識別子。既存の宛先はすべて有効です。 |
etypes |
オプション。イベントとアクションのペアのカンマ区切りのリストを含む文字列。使用可能なetypeのリストについては、「addDMSEventFilter」を参照してください。 |
condition |
オプション。フィルタの条件。条件の構文については、「addDMSEventFilter」を参照してください。 条件が指定されない場合、すべてのDMSイベントが渡されます |
server
|
オプション。この操作を実行するサーバー。デフォルトは、接続しているサーバーです。 |
コマンド・カテゴリ: DMSイベント・トレース
WLST使用: オンライン
listDMSEventConfiguration([server=server_name]]
引数 | 定義 |
---|---|
server
|
オプション。この操作を実行するサーバー。デフォルトは、接続しているサーバーです。 |
コマンド・カテゴリ: DMSイベント・トレース
WLST使用: オンライン
listDMSEventDestination([id=id] [, server=server_name)
引数 | 定義 |
---|---|
id |
オプション。特定の宛先の一意の識別子。 |
server
|
オプション。この操作を実行するサーバー。デフォルトは、接続しているサーバーです。 |
次の例では、接続している管理対象サーバーの宛先に関する情報を表示します。
listDMSEventDestination()
Server: AdminServer
Id : HTTPRequestTrackerDestination
Name : HTTP Request Tracker Destination
Id : mbeanCreationDestination
Name : MBean Creation Destination
次の例では、管理対象サーバーwls_server_1の宛先に関する情報を表示します。
listDMSEventDestination(server='wls_server_1')
Server: wls_server_1
Id : HTTPRequestTrackerDestination
Name : HTTP Request Tracker Destination
Id : mbeanCreationDestination
Name : MBean Creation Destination
.
.
.
次の例では、宛先destination1に関する情報を表示します。
listDMSEventDestination(id='destination1')
Server: AdminServer
Id : destination1
Name : File-system
Class : oracle.dms.trace2.runtime.LoggerDestination
Class Info : Logs incoming events to the logger configured for the Destination.
Properties :
Name Value
loggerName trace2-logger
コマンド・カテゴリ: DMSイベント・トレース
WLST使用: オンライン
listDMSEventFilter([id=id] [, server=server_name])
引数 | 定義 |
---|---|
id |
オプション。指定したフィルタの一意の識別子。 |
server
|
オプション。この操作を実行するサーバー。デフォルトは、接続しているサーバーです。 |
次の例では、イベント・トレース構成内のすべてのフィルタのリストを表示します。
listDMSEventFilter()
Id Name
auto215443800 auto generated using enableEventTrace
JFRFilter JFRFilter
traceFilter
mds2 MyFilter
mds1 MyFilter
次の例では、フィルタmds1の構成を表示します。
listDMSEventFilter(id='mds1')
Server: AdminServer
Id : mds1
Name : MyFilter
Properties :
Condition :
NOUNTYPE equals MDS_Connections AND CONTEXT user equals bruce IGNORECASE
コマンド・カテゴリ: DMSイベント・トレース
WLST使用: オンライン
指定されたフィルタまたは宛先に関連付けられているイベント・ルートおよびそのステータス(有効または無効)をリストします。filteridまたはdestinationidを指定しない場合、イベント・トレース構成内のすべてのイベント・ルートがこのコマンドによってリストされます。
listDMSEventRoutes([filterid=filter_id] [, destinationid=destination_id] [, server=server_name])
引数 | 定義 |
---|---|
filterid |
オプション。フィルタの一意の識別子。 |
destinationid |
オプション。特定の宛先の一意の識別子。この宛先が存在している必要があります。 |
server
|
オプション。この操作を実行するサーバー。デフォルトは、接続しているサーバーです。 |
次の例では、すべてのイベント・ルートをリストします。
listDMSEventRoutes()
Server: AdminServer
Filter : auto215443800
Destination : destination1
Enabled : true
Filter : None
Destination : HTTPRequestTrackerDestination
Enabled : true
次の例では、フィルタIDがfilter1であるイベント・ルートをリストします。
listDMSEventRoutes(filterid='mds1')
Server: AdminServer
Filter : mds1
Destination : destination1
Enabled : false
次の例では、宛先IDがdestination1であるイベント・ルートをリストします。
listDMSEventRoutes(destinationid='destination1')
Server: AdminServer
Filter : auto215443800
Destination : destination1
Enabled : true
Filter : mds2
Destination : destination1
Enabled : false
Filter : mds1
Destination : destination1
Enabled : false
コマンド・カテゴリ: DMSイベント・トレース
WLST使用: オンライン
イベント・トレース構成から既存の宛先を削除します。イベント・ルートとの依存関係がない宛先のみを削除できます。その宛先に依存するイベント・ルートが存在する場合、警告が返されます。
宛先を削除するには、管理サーバーに接続している必要があります。接続していない場合は、エラーが返されます。
removeDMSEventDestination(id=id [, server=server_name])
引数 | 定義 |
---|---|
id |
削除する宛先の一意の識別子。 |
server
|
オプション。この操作を実行するサーバー。デフォルトは、接続しているサーバーです。 |
次の例では、宛先jfrを削除します。
removeDMSEventDestination(id='jfr')
Destination "jfr" removed.
次の例では、宛先styx.inpass.db1の削除を試みます。しかし、この宛先にはイベント・ルートが存在するため、コマンドによってエラーが返されます。
removeDMSEventDestination(id='styx.inpass.db1')
An event-route for destination 'styx.inpass.db1' exists. Unable to remove this destination for server "AdminServer".
コマンド・カテゴリ: DMSイベント・トレース
WLST使用: オンライン
イベント・トレース構成から既存のフィルタを削除します。イベント・ルートとの依存関係がないフィルタのみを削除できます。そのフィルタに依存するイベント・ルートが存在する場合、警告が返されます。
イベント・フィルタを削除するには、管理サーバーに接続している必要があります。接続していない場合は、エラーが返されます。
removeDMSEventFilter(id=id [, server=server_name])
引数 | 定義 |
---|---|
id |
削除するフィルタの一意の識別子。 |
server
|
オプション。この操作を実行するサーバー。デフォルトは、接続しているサーバーです。 |
次の例では、フィルタmds1を削除します。
removeDMSEventFilter(id='mds1')
Filter "mds1" removed for server "AdminServer".
次の例では、イベント・ルートが現在存在しているフィルタの削除を試みます。
removeDMSEventFilter(id='allaccounts')
Filter "allaccounts" cannot be removed. An event-route currently exists for that
filter. Remove the event-route first using the command removeDMSEventRoute().
コマンド・カテゴリ: DMSイベント・トレース
WLST使用: オンライン
removeDMSEventRoute([filterid=filter_id] [, destinationid=destination_id] [, server=server_name])
引数 | 定義 |
---|---|
filterid |
オプション。フィルタの一意の識別子。 |
destinationid |
オプション。特定の宛先の一意の識別子。この宛先が存在している必要があります。 |
server
|
オプション。この操作を実行するサーバー。デフォルトは、接続しているサーバーです。 |
次の例では、filteridがmds1、destinationがjfrであるイベント・ルートを削除します。
removeDMSEventRoute(filterid='mds1', destinationid='jfr')
Event-route for filter "mds1", destination "jfr" removed for server "AdminServer".
次の例では、宛先がdestination1であるイベント・ルートを削除します。
removeDMSEventRoute(destinationid='destination1')
Event-route for filter "None", destination "destination1" removed for server "AdminServer".
コマンド・カテゴリ: DMSイベント・トレース
WLST使用: オンライン
updateDMSEventDestination(id=id [, name=dest_name], class=class_name [,props= {'name': 'value'...}] [, server=server_name)
引数 | 定義 |
---|---|
id |
更新する宛先の一意の識別子。 |
name |
オプション。宛先の名前。 |
class |
宛先の完全クラス名。 使用可能な宛先のリストについては、表6-6を参照してください。 |
props |
オプション。宛先に使用される名前/値プロパティ。新しいプロパティを追加したり、既存のプロパティを更新または削除できます。プロパティを更新する場合は、すべてのプロパティを指定する必要があります。プロパティを省略すると、そのプロパティは削除されます。たとえば、ある宛先にプロパティLoggerNameおよびseverityが含まれている場合にseverityを省略すると、severityがその宛先から削除されます。 構文および許可される値については、「addDMSEventFilter」を参照してください。 |
server
|
オプション。この操作を実行するサーバー。デフォルトは、接続しているサーバーです。 |
次の例では、宛先jfrの名前を更新します。
updateDMSEventDestination(id='jfr', name='Alternative Flight-Recorder')
Destination "jfr" updated for server "AdminServer".
次の例では、存在しない宛先の更新を試みます。コマンドによってエラーが返されます。
updateDMSEventDestination(id='destination1', props={'loggerName': 'MyNewTrace2-logger'}) Destination "destination1" does not exist for server "AdminServer".
コマンド・カテゴリ: DMSイベント・トレース
WLST使用: オンライン
updateDMSEventFilter(id=id [, name=name] [,etypes=etypes], props= {'prop-name': 'value'...} [,server=server_name])
引数 | 定義 |
---|---|
id |
更新するフィルタの一意の識別子。 |
name |
オプション。更新するフィルタの名前。 |
etypes |
オプション。イベントとアクションのペアのカンマ区切りのリストを含む文字列。有効な値のリストについては、「addDMSEventFilter」を参照してください。 |
props |
prop-name: フィルタ・プロパティの名前。唯一有効なプロパティは value: フィルタのプロパティの値。 |
server
|
オプション。この操作を実行するサーバー。デフォルトは、接続しているサーバーです。 |
次の例では、IDがmds1であるフィルタのフィルタ・プロパティを更新します。
updateDMSEventFilter(id='mds1', props={'condition': 'NOUNTYPE equals XYZ_Total_Connections AND CONTEXT user equals bruce'}) Filter "mds1" updated for server "AdminServer"..
次の例では、存在しないフィルタの更新を試みます。
updateDMSEventFilter(id='Filter2')
Filter "Filter2" does not exist for server "AdminServer".
コマンド・カテゴリ: DMSイベント・トレース
WLST使用: オンライン
updateDMSEventRoute([filterid=filter_id], destinationid=destination_id [, enable=true|false] [, server=server_name])
引数 | 定義 |
---|---|
filterid |
オプション。フィルタの一意の識別子。 |
destinationid |
オプション。特定の宛先の一意の識別子。この宛先が存在している必要があります。 |
enable |
オプション。フィルタを有効にします。有効な値は |
server
|
オプション。この操作を実行するサーバー。デフォルトは、接続しているサーバーです。 |