6 DMSのカスタムWLSTコマンド

この章では、パフォーマンス・メトリックの表示およびイベント・トレースの構成に使用できるダイナミック・モニタリング・サービス(DMS)のWLSTコマンドについて詳細に説明します。この章では、コマンド構文、引数およびコマンド例について説明します。

注意: これらのDMSのカスタムWLSTコマンドを使用するには、Oracle共通ホームからWLSTスクリプトを起動する必要があります。『Oracle Fusion Middlewareの管理』のカスタムWLSTコマンドの使用に関する項を参照してください。

表6-1の各カテゴリのDMSコマンドを使用して、パフォーマンス・メトリックの表示およびイベント・トレースを構成します。

表6-1 DMSコマンド・カテゴリ

コマンド・カテゴリ	説明
DMSの構成コマンド	DMSシステム構成パラメータを設定および表示します。
DMSメトリック・コマンド	パフォーマンス・メトリックに関する情報を表示します。
DMSパラメータ・スコープ・メトリック・ルール・コマンド	一連のナウン・タイプを一連のパラメータ名のセットに関連付ける制約およびルールを指定して、メトリックを作成します
DMSイベント・トレース・コマンド	イベント・トレースを構成します

DMSの構成コマンド

表6-2のコマンドを使用して、システム・プロパティを構成し、システム・プロパティを表示します。

表6-2 DMSの構成コマンド

使用するコマンド	目的	WLST使用
listDMSConfigurationParameters	1つ以上のDMS構成パラメータに関する情報を表示します。	オンライン
setDMSConfigurationParameter	DMS構成パラメータの値を設定します。	オンライン

listDMSConfigurationParameters

オンラインで使用します。

説明

1つ以上の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

オンラインで使用します。

説明

指定したDMSシステム構成パラメータの値を設定します。このコマンドは、既存のDMSシステム・プロパティ(現在は非推奨)を置き換えます。

構文

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

例

次の例では、DMSClockTypeのHIGHRESへの設定を示します。

setDMSConfigParameter(name= 'DMSClockType', value='HIGHRES', server='mymanaged') 

DMSメトリック・コマンド

表6-3のコマンドを使用して、特定のパフォーマンス・メトリック、一連のパフォーマンス・メトリックまたは特定のサーバーまたはコンポーネントに対するすべてのパフォーマンス・メトリックに関する情報を表示します。

メトリックの詳細は、『Oracle Fusion Middlewareの管理』の章「Oracle Fusion Middlewareの監視」および『パフォーマンスのチューニング・ガイド』の章「Oracle Dynamic Monitoring Serviceの使用方法」を参照してください。

表6-3 DMSメトリック・コマンド

使用するコマンド	目的	WLST使用
displayMetricTableNames	使用可能なメトリック表の名前を表示します。	オンライン
displayMetricTables	DMSメトリック表の内容を表示します。	オンライン
dumpMetrics	使用可能なメトリックを表示します。	オンライン
reloadMetricRules	メトリック・ルールをリロードします。	オンライン

displayMetricTableNames

コマンド・カテゴリ: 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') 

displayMetricTables

コマンド・カテゴリ: 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
.
.
.

dumpMetrics

コマンド・カテゴリ: DMSメトリック

WLST使用: オンライン

説明

使用可能なメトリックを内部形式またはXMLで表示します。返される値はテキスト・ドキュメントです。

構文

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>
.
.
.

reloadMetricRules

コマンド・カテゴリ: DMSメトリック

WLST使用: オンライン

説明

メトリック・ルールをリロードします。このコマンドは、システム・コンポーネントのデプロイ後、またはメトリック・ルールの変更後に実行する必要があります。通常は、メトリック・ルールは変更しないことをお薦めします。

構文

reloadMetricRules()

例

次の例では、ドメイン内で実行中のすべてのサーバーでメトリック・ルールをリロードします。

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'

.
.
.

DMSパラメータ・スコープ・メトリック・ルール・コマンド

パラメータ・スコープ・メトリック・コマンドでは、一連のナウン・タイプを一連のパラメータ名のセットに関連付ける制約およびルールを指定して、メトリックを作成できます。

表6-4のコマンドを使用して、パラメータ・スコープ・メトリックを管理します。

表6-4 DMSパラメータ・スコープ・メトリック・ルール・コマンド

使用するコマンド	目的	WLST使用
createDMSScopedMetricsParameterConstraint	setParameterScopedMetricsRuleコマンドで使用できるパラメータ制約を作成します。	オンライン
deleteDMSParameterScopedMetricsRules	指定したパラメータ・スコープ・メトリック・ルールを削除します。	オンライン
dumpParameterScopedMetrics	指定したルールIDのパラメータ・スコープ・メトリック・データを表示します。	オンライン
listDMSContextParameters	DMSで認識されている実行コンテキスト・パラメータのセットをリストします。	オンライン
listDMSParameterScopedMetricsRules	現在のパラメータ・スコープ・メトリックの構成を表示します。	オンライン
resetDMSParameterScopedMetrics	特定のルール識別子に関連付けられているパラメータ・スコープ・メトリック・データをリセットします。	オンライン
sampleDMSContextParameterValues	指定された名前のコンテキスト・パラメータの値セットのサンプルを収集します。	オンライン
setDMSParameterScopedMetricsRule	パラメータ・スコープ・メトリック・ルールを作成または更新します。	オンライン

createDMSScopedMetricsParameterConstraint

コマンド・カテゴリ: DMSパラメータ・スコープ・メトリック

WLST使用: オンライン

説明

setParameterScopedMetricsRuleコマンドで使用できる制約を作成します。

構文

createDMSScopedMetricsParameterConstraint(name [, values] [,maxnumofvalues])

引数	定義
name	制約の参照先パラメータの名前。
values	オプション。制約によって適用される特定の値のリスト。
maxmumofvalues	オプション。制約で使用される値の最大数。関係するにもかかわらず指定しなかった場合、値が10と仮定されます。valuesオプションが指定されている場合、この値は無視されます。

例

次の例では、URIという名前のパラメータ制約を作成します。値MyApp/advSearch.jspxおよびMyApp/basicSearch.jspxが適用されます。

createDMSScopedMetricsParameterConstraint(  name="URI", values=["MyApp/advSearch.jspx", "MyApp/basicSearch.jspx"])

deleteDMSParameterScopedMetricsRules

コマンド・カテゴリ: 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"

例

次の例では、管理対象サーバーwls_server1のIDがrule1のパラメータ・スコープ・メトリック・ルールを削除します。

deleteDMSParameterScopedMetricsRules(server='wls_server1', rule1)

dumpParameterScopedMetrics

コマンド・カテゴリ: DMSパラメータ・スコープ・メトリック

WLST使用: オンライン

説明

指定したルールIDのパラメータ・スコープ・メトリック・データを表示します。

構文

dumpParameterScopedMetrics([server, ]ruleid)

引数	定義
server	オプション。パラメータ・スコープ・メトリック・データのダンプ先となるサーバーを指定します。有効な値は、WebLogic Serverインスタンス名およびシステム・コンポーネント名のリストです。 サーバーを指定するには、次の構文を使用します。 server='servername' この引数が指定されない場合、すべてのWebLogicサーバーおよびシステム・コンポーネントのメトリック表のリストがコマンドによって返されます。 この引数を使用するには、管理サーバーに接続している必要があります。 Oracle HTTP Serverなどのシステム・コンポーネントの場合は、次の書式を使用します。 servers=['component_name], servertype='component_type')
ruleid	データを表示するパラメータ・スコープ・メトリック・ルールのID。

例

次の例では、管理対象サーバーwls_server1のパラメータ・スコープ・メトリック・ルールregionRuleのデータを表示します。

dumpParameterScopedMetrics(server="wls_server1", ruleid="regionRule")

listDMSContextParameters

コマンド・カテゴリ: DMSパラメータ・スコープ・メトリック

WLST使用: オンライン

説明

DMSで認識されている実行コンテキスト・パラメータのセットをリストします。

構文

listDMSContextParameters([server][, parameternames] [,verbose])

引数	定義
server	オプション。実行コンテキスト・パラメータを表示するサーバーを指定します。有効な値は、WebLogic Serverインスタンス名およびシステム・コンポーネント名のリストです。 サーバーを指定するには、次の構文を使用します。 server='servername' この引数が指定されない場合、すべてのWebLogicサーバーおよびシステム・コンポーネントのメトリック表のリストがコマンドによって返されます。 この引数を使用するには、管理サーバーに接続している必要があります。 Oracle HTTP Serverなどのシステム・コンポーネントの場合は、次の書式を使用します。 servers=['component_name], servertype='component_type')
parameternames	オプション。該当する実行コンテキスト・パラメータの名前のリスト。サーバー上に見つからないパラメータ名は無視されます(エラーはレポートされません)。この引数が使用されない場合、すべての実行コンテキスト・パラメータがリストされます。
verbose	オプション。trueの場合、各実行コンテキスト・パラメータについて、(使用可能な場合)実行コンテキスト・パラメータの説明が、可能な値およびその説明のセットとともに出力に含まれます。

例

次の例では、管理対象サーバーwls_server1のパラメータ・スコープ・メトリック・ルールを示します。

listDMSContextParameters(server='wls_server1')
Server: ManagedServer1
 
    Module
    FlowId
    Action
    RCID

listDMSParameterScopedMetricsRules

コマンド・カテゴリ: DMSパラメータ・スコープ・メトリック

WLST使用: オンライン

説明

現在のパラメータ・スコープ・メトリックの構成を表示します。

構文

listDMSParameterScopedMetricsRules([server])

引数	定義
server	オプション。パラメータ・スコープ・メトリック構成を表示するサーバーを指定します。有効な値は、WebLogic Serverインスタンス名およびシステム・コンポーネント名のリストです。 サーバーを指定するには、次の構文を使用します。 server='servername' この引数が指定されない場合、すべてのWebLogicサーバーおよびシステム・コンポーネントのメトリック表のリストがコマンドによって返されます。 この引数を使用するには、管理サーバーに接続している必要があります。 Oracle HTTP Serverなどのシステム・コンポーネントの場合は、次の書式を使用します。 servers=['component_name], servertype='component_type')

例

次の例では、管理対象サーバーwls_server1のパラメータ・スコープ・メトリック・ルールを示します。

listDMSParameterScopedMetricsRules(server='wls_server1')

  Rule: ruleA 
   Noun types: 
      JDBC_Connection 
   Context Parameter Constraints: 
      Parameter: URI 
        Constraining values: 
          MyApp/advSearch.jspx 
          MyApp/basicSearch.jspx 

resetDMSParameterScopedMetrics

コマンド・カテゴリ: 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"

例

次の例では、管理対象サーバーwls_server1のIDがruleAのルールをリセットします。

resetDMSParameterScopedMetrics(server="wls_server1", ids="ruleA")

sampleDMSContextParameterValues

コマンド・カテゴリ: DMSパラメータ・スコープ・メトリック

WLST使用: オンライン

説明

指定された名前のコンテキスト・パラメータの値セットのサンプルを収集します。

構文

sampleDMSContextParameterValues(parametername [, naxmuofvaleus] [,action])

引数	定義
parametername	オプション。サンプリング対象のコンテキスト・パラメータの名前。この引数は、引数actionとの組合せで使用する必要があります。
manmumofvalues	オプション。サンプルに含める個別値の最大数。省略した場合、値10が適用されます。値0では、すべての個別値がサンプリングされます。コンテキスト・パラメータによっては、これは無制限のサイズのセットをサンプリングすることを意味します。action="start"を指定した場合にのみ関連します。
action	オプション。サンプリング対象のアクション。この引数は、引数parameternameとの組合せで使用する必要があります。 有効な値は、次のとおりです。 start: 値のサンプリングを開始します。 stop: 値のサンプリングを停止して値を表示します。 show: サンプリング値のヒストグラムを表示します。

例

次の例では、パラメータ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.

setDMSParameterScopedMetricsRule

コマンド・カテゴリ: 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つを指定する必要があります。 「createDMSScopedMetricsParameterConstraint」を参照してください。
actparamconstraints	オプション。このルールで使用されるアクティブ化パラメータ制約のリスト。この引数またはctxparamconstraintsのうち少なくとも1つを指定する必要があります。 「createDMSScopedMetricsParameterConstraint」を参照してください。
replace	オプション。trueの場合、同じIDを持つ既存のルールが新規ルールによって置き換えられます。falseまたは設定しない場合で、そのIDを持つルールがすでに存在する場合は、エラーが発生します。

例

次の例では、idがruleA、nountypeがJDBC_Connection、コンテキスト・パラメータ制約がctxP1のルールを作成します。

setDMSParameterScopedMetricsRule(id="ruleA", nountypes=["JDBC_Connection"],  ctxparamconstraints=[ctxP1])

DMSイベント・トレース・コマンド

表6-5のコマンドを使用して、イベント・トレースを構成します。イベント・トレースでは、再起動せずにライブ・トレースを構成します。Oracle Fusion Middleware製品を使用して更新されたDMSメトリックは、DMSイベント・トレース機能でトレースされる場合があります。

DMSイベント・トレースの使用の詳細は、パフォーマンスのチューニングのDMSトレースおよびイベントに関する項を参照してください。

表6-5 DMSトレース・コマンド

使用するコマンド	目的	WLST使用
addDMSEventDestination	新規宛先をイベント・トレース構成に追加します。	オンライン
addDMSEventFilter	フィルタをイベント・トレース構成に追加します。	オンライン
addDMSEventRoute	指定されたイベント・ルートをイベント・トレース構成に追加します。	オンライン
enableDMSEventTrace	イベント・トレースを有効にして、指定した条件と宛先、および有効化されたイベント・ルートを使用してフィルタを作成します。	オンライン
listDMSEventConfiguration	イベント・トレース構成の概要を表示します。	オンライン
listDMSEventDestination	宛先の完全な構成またはすべての宛先のリストを表示します。	オンライン
listDMSEventFilter	フィルタの構成またはすべてのフィルタのリストを表示します。	オンライン
listDMSEventRoutes	イベント・ルートおよびそのステータス(有効または無効)を表示します。	オンライン
removeDMSEventDestination	指定した宛先を削除します。	オンライン
removeDMSEventFilter	指定したフィルタを削除します。	オンライン
removeDMSEventRoute	指定したイベント・ルートを削除します。	オンライン
updateDMSEventDestination	イベントの宛先の構成を更新します。	オンライン
updateDMSEventFilter	イベント・フィルタの構成を更新します。	オンライン
updateDMSEventRoute	イベント・ルートの構成を更新します。	オンライン

addDMSEventDestination

コマンド・カテゴリ: 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.

addDMSEventFilter

コマンド・カテゴリ: DMSイベント・トレース

WLST使用: オンライン

説明

フィルタをイベント・トレース構成に追加します。同じIDのフィルタがすでに存在している場合、コマンドによってエラーが返され、フィルタは追加されません。

イベント・フィルタを追加するには、管理サーバーに接続している必要があります。接続していない場合は、エラー・メッセージがレポートされます。

構文

addDMSEventFilter(id=id [, name=name] [, etypes] 
                   , props= {'prop-name': 'value'...} 
                   [, server=server_name])

引数	定義
id	指定したフィルタの一意の識別子。
name	オプション。フィルタ名。
etypes	オプション。イベントとアクションのペアのカンマ区切りのリストを含む文字列。この引数を条件とともに使用することで、よりきめ細かいフィルタを作成することが可能になります。また、より広範囲なメトリックを持つフィルタを作成することもできます。たとえば、すべてのナウン、またはアクションが作成されているすべてのナウンです。
props	prop-name: フィルタ・プロパティの名前。唯一有効なプロパティは<condition>で、1つの条件のみを指定できます。 value: フィルタのプロパティの値。
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>	有効な演算子は次のとおりです。 equals: ナウン・タイプ名が値と等しい場合のみ絞り込みます。 starts_with: ナウン・タイプ名が値で始まる場合のみ絞り込みます。 contains: ナウン・タイプ名が値と等しい場合のみ絞り込みます。 not_equals: ナウン・タイプ名が値と等しくない場合のみ絞り込みます。
value	操作対象のナウン・タイプの名前。パフォーマンスを測定するどのオブジェクトの名前でも指定できます。

次の表では、<context>について説明します。

値	説明
CONTEXT	キーワード。
name	絞り込むコンテキストの名前。
value	操作対象のコンテキストの名前。
<context-operator>	有効な演算子は次のとおりです。 equals: コンテキスト名が値と等しい場合のみ絞り込みます。 starts_with: コンテキスト名が値で始まる場合のみ絞り込みます。 contains: コンテキスト名が値と等しい場合のみ絞り込みます。 not_equals: コンテキスト名が値と等しくない場合のみ絞り込みます。 is_null: コンテキスト名がnullの場合のみ絞り込みます。 lt: コンテキスト名が値より小さい場合のみ絞り込みます。 gt: コンテキスト名が値より大きい場合のみ絞り込みます。 le: コンテキスト名が値以下の場合のみ絞り込みます。 ge: コンテキスト名が値以上の場合のみ絞り込みます。
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.

addDMSEventRoute

コマンド・カテゴリ: DMSイベント・トレース

WLST使用: オンライン

説明

指定されたイベント・ルートをイベント・トレース構成に追加します。同じIDのイベント・ルートがすでに存在している場合、コマンドによってエラーが返され、イベント・ルートは追加されません。

イベント・ルートを追加するには、管理サーバーに接続している必要があります。接続していない場合は、エラーが返されます。

構文

addDMSEventRoute([filterid=filter_id], destinationid=destination_id, [enable=true|false] [,server=server_name])

引数	定義
filterid	オプション。フィルタの一意の識別子。
destinationid	特定の宛先の一意の識別子。この宛先が存在している必要があります。
enable	オプション。フィルタを有効にします。有効な値はtrueおよびfalseです。デフォルトは、trueです。
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".

enableDMSEventTrace

コマンド・カテゴリ: DMSイベント・トレース

WLST使用: オンライン

説明

イベント・トレースを有効にして、指定した条件と宛先、および有効化されたイベント・ルートを使用してフィルタを作成します。これは、フィルタ、宛先およびイベント・ルートを明示的に作成せずにフィルタ処理を開始する簡単な方法ですが、構成オプションは少なくなります。指定した宛先が存在している必要があります。

DMSイベント・トレースを有効化するには、管理サーバーに接続している必要があります。接続していない場合は、エラーが返されます。

より複雑な構成が必要な場合は、addDMSEventDestination、addDMSEventFilterおよびaddDMSEventRouteを使用します。

構文

enableDMSEventTrace(destinationid=destinationid [, etypes=etype] 
                     [, condition=condition]  [, server=server_name])

引数	定義
destinationid	特定の宛先の一意の識別子。既存の宛先はすべて有効です。
etypes	オプション。イベントとアクションのペアのカンマ区切りのリストを含む文字列。使用可能なetypeのリストについては、「addDMSEventFilter」を参照してください。
condition	オプション。フィルタの条件。条件の構文については、「addDMSEventFilter」を参照してください。 条件が指定されない場合、すべてのDMSイベントが渡されます
server	オプション。この操作を実行するサーバー。デフォルトは、接続しているサーバーです。

例

次の例では、指定された条件を持つイベント・トレースを有効化します。

enableDMSEventTrace(destinationid='destination1', condition='CONTEXT username EQUALS Joe AND CONTEXT ip EQUALS 192.168.1.5')
 
Filter "auto215443800" using Destination "destination1" added, and event-route enabled for server "AdminServer".

listDMSEventConfiguration

コマンド・カテゴリ: DMSイベント・トレース

WLST使用: オンライン

説明

イベント・トレース構成の概要を表示します。

構文

listDMSEventConfiguration([server=server_name]] 

引数	定義
server	オプション。この操作を実行するサーバー。デフォルトは、接続しているサーバーです。

例

次の例では、接続している管理対象サーバーの構成をリストします。

listDMSEventConfiguration()
 
Server: AdminServer
 
Event routes:
   Filter        :  auto215443800
   Destination   :  destination1
   Enabled       :  true

listDMSEventDestination

コマンド・カテゴリ: DMSイベント・トレース

WLST使用: オンライン

説明

特定の宛先について、完全な構成を表示します。宛先IDが指定されない場合、イベント・トレース構成内のすべての宛先の宛先IDおよび名前がリストされます。

構文

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              

listDMSEventFilter

コマンド・カテゴリ: DMSイベント・トレース

WLST使用: オンライン

説明

特定のフィルタについて、完全な構成を表示します。フィルタIDを指定しない場合、イベント・トレース構成内のすべてのフィルタのフィルタIDおよび名前がコマンドによって表示されます。

構文

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

listDMSEventRoutes

コマンド・カテゴリ: 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

removeDMSEventDestination

コマンド・カテゴリ: 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".

removeDMSEventFilter

コマンド・カテゴリ: 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().

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".

updateDMSEventDestination

コマンド・カテゴリ: 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".

updateDMSEventFilter

コマンド・カテゴリ: DMSイベント・トレース

WLST使用: オンライン

説明

イベント・トレース構成内の既存のフィルタを更新します。

イベント・フィルタを更新するには、管理サーバーに接続している必要があります。接続していない場合は、エラーが返されます。

構文

updateDMSEventFilter(id=id [, name=name] [,etypes=etypes], 
                     props= {'prop-name': 'value'...} 
                     [,server=server_name])

引数	定義
id	更新するフィルタの一意の識別子。
name	オプション。更新するフィルタの名前。
etypes	オプション。イベントとアクションのペアのカンマ区切りのリストを含む文字列。有効な値のリストについては、「addDMSEventFilter」を参照してください。
props	prop-name: フィルタ・プロパティの名前。唯一有効なプロパティは<condition>で、1つの条件のみを指定できます。prop-nameの構文の詳細は、「addDMSEventFilter」を参照してください。 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".

updateDMSEventRoute

コマンド・カテゴリ: DMSイベント・トレース

WLST使用: オンライン

説明

指定されたイベント・ルートを有効化または無効化します。イベント・ルートを更新するには、管理サーバーに接続している必要があります。接続していない場合は、エラーが返されます。

構文

updateDMSEventRoute([filterid=filter_id], destinationid=destination_id 
         [, enable=true|false] [, server=server_name])

引数	定義
filterid	オプション。フィルタの一意の識別子。
destinationid	オプション。特定の宛先の一意の識別子。この宛先が存在している必要があります。
enable	オプション。フィルタを有効にします。有効な値はtrueおよびfalseです。
server	オプション。この操作を実行するサーバー。デフォルトは、接続しているサーバーです。

例

次の例では、filteridがmds1、destinationがjfrであるイベント・ルートを無効化します。

updateDMSEventRoute(filterid='mds1', destinationid='jfr', enable='false')
Event-route for filter "mds1", destination "destination1" updated for server "AdminServer".