Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド 11g リリース1(11.1.1.7) B55916-08 |
|
前 |
次 |
この章では、Oracle SOA Suiteの問題を早期に診断し、WebLogic診断フレームワーク(WLDF)およびOracle Fusion Middleware診断フレームワークを活用して適切な修正処理を適用する方法について説明します。WLDFでは、監視および通知を使用して診断シナリオをモニターし、Oracle Fusion Middleware診断フレームワークでは、SOA固有の診断シナリオを、表示および分析用に書式設定されたデータ・ダンプに収集します。
この章では、次の項目について説明します。
トラブルシューティングの詳細は、付録B「Oracle SOA SuiteとOracle BPM Suiteのトラブルシューティング」を参照してください。
注意: この章で説明する情報は、Oracleデータベースにのみ適用されます。Oracle以外のデータベースを使用する場合は、動作や結果が異なります。 |
Oracle SOA Suiteで問題を監視および診断する場合、次の困難に直面します。
システムがハングする瞬間に複数のスレッド・ダンプを取得したり、メモリー不足になる前にヒープ・ダンプを取得するなど、特に断続的な問題の発生の瞬間での診断データの取得(ジャストインタイム診断とも呼ばれる)
データ形状(SOAスキーマとMDSスキーマの状態および増加パターンによる件数)などの詳細情報の取得
バージョン、ログ、構成ファイル、適用パッチなどの基本情報を提供するためのOracleサポート・サービスとの相互の通信
問題が拡大する前の早期の検出と修正処理の適用
これらの困難に取り組むために、Oracle SOA Suiteは、問題の早期特定および適切な修正処理の適用を支援する次の診断フレームワークと統合されます。
WLDF: 監視および通知を使用して診断シナリオを監視します。
診断フレームワーク: SOA固有の診断シナリオを、表示および分析用に書式設定されたデータ・ダンプに収集します。これらのデータ・ダンプは、サポート・ワークベンチを介してアクセス可能になり、サービス・リクエスト(SR)の一環としてアップロード可能になります。
WLDFは、Oracle WebLogic Serverに組み込まれている監視と診断を行うフレームワークであり、サーバー・プロセス内で稼働してサーバーの標準的なライフサイクルの一部となる一連のサービスを定義および実装します。
WLDFを使用して、Oracle SOA Suiteから診断データを取得できます。診断データを収集して問題を特定するために、Oracle WebLogic Server管理コンソールからWLDFの監視および通知を構成します。障害が発生した場合は、このデータを使用して障害を隔離し、診断できます。
WLDFの詳細は、『Oracle Fusion Middleware Oracle WebLogic Server診断フレームワークの構成と使い方』を参照してください。
監視は、サーバーおよびアプリケーションの状態を監視して、設定した基準に基づいて通知を送信します。監視および通知は、ドメイン内の1つ以上のサーバー・インスタンスに割り当てられている診断モジュールの一部として構成されます。監視を作成する場合は、Oracle WebLogic Server管理コンソールでOracle SOA SuiteおよびOracle WebLogic Server MBeanの属性を使用して、監視するためのルール式を作成します。
たとえば、空きヒープ・メモリーの割合が100%未満になった場合に通知を送信するとします。Oracle WebLogic Server MBean weblogic.management.runtime.JRockitRuntimeMBean
およびその属性HeapFreePercent
を使用する監視を作成します。次に、HeapFreePercent
が100%未満の場合に通知を受け取る必要があることを示すロジックを定義します。JRockit仮想マシン(VM)以外で稼働している場合は、MBean JVMRuntimeMBean
を使用することもできます。
Oracle WebLogic Server管理コンソールでの監視および通知の作成方法は、『Oracle Fusion Middleware管理者ガイド』の監視および通知の作成および診断フレームワークの構成に関する項を参照してください。
作成する監視ルール式は、Oracle SOA SuiteおよびOracle WebLogic Server MBeanの属性を使用して、データを収集し、監視を実行します。使用可能なMBeanを使用してシナリオを診断し、そのシナリオに関する統計を提供したり、メッセージをログに記録します。マネージドBean(MBean)は分散環境でJMX管理可能なリソースを表すJavaオブジェクトです。次のMBeanの属性は、シナリオを監視するための監視の定義に使用できます。
Oracle WebLogic Server MBean
診断用Oracle SOA Suite MBean
MBeansとして公開されるダイナミック・モニタリング・サービス(DMS)メトリック
Oracle SOA Suiteには、監視や通知を使用して監視できる様々な診断シナリオが用意されています。表12-1に、サポートされている診断シナリオおよび監視に使用できるMBeanの詳細を示します。
表12-1 サポートされる診断シナリオおよびMBean
シナリオ | 説明 | 診断データ・ソース |
---|---|---|
メモリーの問題(起動、デプロイメントおよび実行時) |
使用可能な空きヒープを監視します。空きヒープの割合がしきい値未満の場合、スレッド・スタック・ダンプおよびヒープ・ダンプを生成するために通知がトリガーされます。 |
Oracle WebLogic Server MBean |
デプロイメントのハング |
デプロイメントの経過時間を監視します。しきい値を超えると、通知がトリガーされます。 |
Oracle SOA SuiteデプロイメントMBean |
データ・ソースの問題 |
一時停止および接続プール/トランザクションのタイム・アウトを監視します。 |
JDBC MBean |
サーバーの過負荷 |
自動でサーバーの状態を監視します。 |
Oracle WebLogic Server MBean |
スタック・スレッド |
スタック・スレッドを監視します。検出すると、通知がトリガーされます。 |
スタック・スレッド監視/診断フレームワーク通知は自動的に組み込まれます。診断フレームワーク・インシデント・パッケージは、ADRコマンド・インタプリタ(ADRCI)などのツールを使用して作成できます。インシデントは自動的に作成されます。 |
表12-2に、診断データを監視および収集するための監視を作成するときに選択する、使用可能なMBeanおよびDMSメトリックの一部を示します。
表12-2 MBeanおよびDMSメトリック
診断データ・ソース(MBean)および使用方法 | 説明 | Oracle WebLogic Server MBean | SOA MBeanまたはDMSメトリック |
---|---|---|---|
|
メモリー統計用 |
はい |
- - |
|
デプロイメント経過時間用 |
- - |
SOA MBean |
|
ヘルス状態情報用 |
はい |
- - |
|
JDBCデータ・ソース用およびトランザクション・ランタイム特性のアクセス用 |
はい |
- - |
Oracle WebLogic Server MBeanの詳細は、Oracle Fusion Middleware Oracle WebLogic Server MBeanリファレンスを参照してください。
診断フレームワークは、問題の検出、診断および解決に役立つOracle Fusion Middlewareの機能です。対象としている問題は、コードのバグ、メタデータの破損、顧客データの破損、スレッドのデッドロック、一貫性のない状態に起因する障害などのクリティカル・エラーです。診断フレームワークは重大なエラーを検出し、関連する診断情報(ログ、メトリック、サーバー・イメージなど)のダンプを取得します。WLDFの監視および通知は、診断フレームワークが適切なデータ・ダンプをリスニングおよび生成するイベントをトリガーします。ダンプは、表示および分析用にインシデント・パッケージに書式設定されます。
インシデントとして取得される問題には、表12-1で説明されているようなクリティカル・エラーが含まれます。各インシデント・パッケージは一意のIDで識別されます。クリティカル・エラーが発生すると、この一意のID(インシデント番号として知られている)が割り当てられます。エラーの診断データ(ログ・ファイルなど)は、この番号で即時に取得され、タグが設定されます。
その後、データは自動診断リポジトリ(ADR)に格納されます。ADRは、エラーの発生および関連する診断データの記憶域をカタログ化するためのファイルシステム・リポジトリです。データは、インシデント・パッケージ番号で取得して書式設定した後、ADRCIなどのOracleデータベース・ツールで表示し、分析されます。
ADRCIを使用して、ダンプ・ファイルの名前、およびXMLタグが取り除かれた状態のアラート・ログを表示できます。このビューでは、問題を調査し、新たな障害の診断データをパッケージ化してOracleサポート・サービスにアップロードできます。
診断フレームワークのWLSTコマンドを使用して、次のタスクを実行することもできます。
問題の問合せ
インシデント・ダンプ・ファイルの表示
手動インシデントの作成
ダンプの手動実行
診断フレームワークはすべてのJRF対応プラットフォームでサポートされています。
診断フレームワークは様々なダンプに自動的に組み込まれます。これらのダンプの詳細は、『Oracle Fusion Middleware管理者ガイド』のレポートの調査および問題の解決に関する項を参照してください。
これらのダンプに加え、Oracle SOA Suiteの様々なダンプもサポートされています。Oracle SOA Suiteのダンプの詳細は、第12.2項「Oracle SOA Suite診断ダンプの実行」を参照してください。
問題の解決、インシデントおよびWLDFと診断フレームワークとの統合の詳細は、『Oracle Fusion Middleware管理者ガイド』の「問題の診断」の章を参照してください。
ADRの詳細は、第12.7項「ADRツールでのインシデント・パッケージの表示」を参照してください。
Oracle SOA Suiteに繰り返し発生する問題があると、複数のインシデント・パッケージが作成される可能性があります。多数のエラーが発生している場合にサーバーの過負荷を防止する目的で、診断フレームワークでは一部のインシデントが自動的にフラッド制御されます。この問題を回避するために、インシデント・パッケージ数を制御するように診断フレームワークを構成できます。詳細は、『Oracle Fusion Middleware管理者ガイド』の診断フレームワークの構成に関する項を参照してください。
Oracle WebLogic Server管理コンソールで監視を作成する場合は、通知も定義します。FMWDFW通知という通知は自動的に選択可能になります。独自の通知を作成することも可能ですが、FMWDFW通知では、第12.2項「Oracle SOA Suite診断ダンプの実行」で説明されているOracle SOA Suiteのダンプが作成されるため、この通知を選択することをお薦めします。
エラーが検出されると、FMWDFW通知ハンドラがインシデントを作成し、診断フレームワークがインシデント処理セマンティクスを担当します。これらのセマンティクスは、インシデント処理ルールによって制御されます。インシデント処理ルールはXMLファイルに定義され、SOAインフラストラクチャの起動時にロードされて、診断フレームワークに登録されます。
表12-1に示したシナリオとは異なるシナリオに直面した場合は、Oracleサポート・サービスと連携して、カスタマイズされたインシデント処理ルール・ファイルのコピーを取得する必要があります。カスタマイズされたルール・ファイルは(推奨されるネーミング規則のsoa-infra#custom-rules.xml
を使用して)、次のいずれかの場所に配置できます
サーバー・レベルの構成: FMW_HOME
/user_projects/
domains/
domain_name
/config/fmwconfig/servers/
server_name
/dfw
ドメイン・レベルの構成: FMW_HOME
/user_projects/
domains/
domain_name
/config/fmwconfig
/dfw
診断フレームワークはサーバー起動時にファイルを自動的にロードします。ファイル名の接頭辞としてアプリケーション名が指定されている場合を除き、すべてのダンプはシステム・スコープ指定として登録されます。
myrules.xml
: システム・スコープ指定。これは、ルール・ファイルがSOAインフラストラクチャのすべてのSOAコンポジット・アプリケーションに適用されることを意味します。
application_name
#
name
.xml
: アプリケーション・スコープ指定。これは、ルール・ファイルがこの特定のSOAコンポジット・アプリケーションのみに適用されることを意味します。#
の前の文字列はすべてアプリケーション名としてみなされます。
さらに、サーバーを再起動しないでSOAインフラストラクチャにルール・ファイルを動的にロードすることもできます。サーバーの再起動によって収集された診断データの正確さが損なわれる可能性があるため、動的リロードは重要です。
サーバーを再起動しないで動的にファイルをリロードするには、次のWLSTコマンドを入力します。
wls:/soainfra/serverConfig> reloadCustomRules(name='rule_file')
reloadCustomRules
の詳細は、Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスの「診断フレームワークのカスタムWLSTコマンド」の章を参照してください。
例12-1は、カスタム・ルール・ファイルのサンプルを示しています。oracle.soa.bpel.engine.ws
モジュールの*-diagnostic.log
にERROR
レベル・メッセージが見つかった場合、soa.composite.trail
ダンプが実行されます。ルールをロードするためにシステムを再起動すると、収集された診断データの正確さが実際に損なわれます。
例12-1 サンプル・カスタム・ルール・ファイル
<?xml version="1.0" encoding="UTF-8"?>
<diagnosticRules xmlns="http://www.oracle.com/DFW/DiagnosticsFrameworkRules"
xmlns:xs="http://www.w3.org/2001/XMLSchema-instance">
<logDetectionConditions>
<condition module="oracle.soa.bpel.engine.ws"/>
</logDetectionConditions>
<defaultActions>
<dumpAction name="soa.composite.trail">
<argument name="ecid" value="ECID" valueType="Fact" mandatory="true"/>
</dumpAction>
</defaultActions>
</diagnosticRules>
Oracle WebLogic Serverで使用可能な診断ダンプに加え、Oracle SOA Suiteでは、表12-3に示す診断ダンプの作成をサポートしています。
表12-3 Oracle SOA Suite診断ダンプ
ダンプ | 説明 |
---|---|
|
ランタイム環境のダンプ。 |
|
ランタイム・プラットフォーム構成のダンプ。 |
|
データベースのダンプ。 |
|
デプロイされたコンポジット・メタデータのダンプ。 |
|
インスタンス監査証跡のダンプ。 |
|
イベントのダンプ。 |
|
デプロイされたコンポジットWSDL/スキーマ・キャッシュのダンプ。 |
|
静的ダンプ(システム、呼出し、エンジンおよび監査スレッド数)ならびにランタイムのスケジュール済メッセージ数と稼働中メッセージ数のダンプ。 |
|
平均インスタンス処理時間のダンプ。 |
|
平均インスタンス処理遅延のダンプ(非同期プロセス用)。 |
|
同期ビジネス・プロセス・ダンプ統計(最小、最大および平均処理時間(ミリ秒単位)など)、ならびに処理されたインスタンスの数。 |
|
非同期BPELプロセス・ダンプ統計(最小、最大および平均処理時間(ミリ秒単位)など)、ならびに処理されたインスタンスの数。 |
|
リクエスト・レベルのダンプ統計(最小、最大および平均処理時間(ミリ秒単位)など)、ならびにBPELプロセス・サービス・エンジンの各種レイヤーを通して流れながら処理されたリクエストの数。 |
|
リシーケンサ・グループ処理遅延のダンプ。 |
|
アダプタのコネクション・ファクトリの構成。複数のコンポジットが同じJava Naming and Directory Interface(JNDI)を使用しているかどうかを識別するために使用します。 |
|
JCAアダプタの接続プール統計と接続プール・リーク。現在のオープン接続の統計が表示され、接続プールのチューニングを行うことができます。 |
|
アダプタDMSの統計(メッセージ・サイズ、フォルト数など)。 |
診断フレームワークは診断のダンプを出力および記録します。WLSTのlistDumps
およびdescribeDump
コマンドを使用して、診断ダンプすべての詳細を表示できます。
ダンプをリストする手順は次のとおりです。
SOAインフラストラクチャがインストールされているサーバーに接続します。
wls:/offline> connect('user_name', 'password', 't3://myhost:8001') Connecting to t3://myhost:8001 with userid user_name ... Successfully connected to managed Server 'soa_server1' that belongs to domain 'soainfra'.
診断フレームワークのダンプのリストを表示します。
wls:/soainfra/serverConfig> listDumps() odl.activeLogConfig jvm.classhistogram dms.ecidctx jvm.flightRecording wls.image odl.logs dms.metrics odl.quicktrace http.requests jvm.threads Use the command describeDump(name=<dumpName>) for help on a specific dump.
Oracle SOA Suiteのダンプのリストを表示します。
wls:/soainfra/serverConfig> listDumps(appName='soa-infra') adf.ADFConfigDiagnosticDump soa.composite soa.composite.trail soa.config soa.db soa.edn soa.env soa.wsdl bpel.dispatcher bpel.apt bpel.apd bpel.sps bpel.aps bpel.rs mediator.resequencer soa.adapter.ra soa.adapter.connpool soa.adapter.stats Use the command describeDump(name=<dumpName>) for help on a specific dump.
Oracle SOA Suiteのダンプは、次の項で説明されています。
listDumps
およびdescribeDump
の詳細は、Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスの「診断フレームワークのカスタムWLSTコマンド」の章を参照してください。
診断フレームワークのダンプの詳細は、『Oracle Fusion Middleware管理者ガイド』の「問題の診断」の章を参照してください。
表12-4に、ランタイム環境の診断ダンプの詳細を示します。
表12-4 ランタイム環境診断のダンプ
ダンプ名 | ダンプ・パラメータ/ダンプ・モード | 取得される情報 |
---|---|---|
|
|
|
次のWLSTコマンドライン構文を入力し、ダンプの説明を表示し、soa.env
のダンプを実行します。
wls:/soainfra/serverConfig> describeDump(name='soa.env', appName='soa-infra') Name: soa.env Description: SOA diagnostic dump that captures SOA runtime environment info: version, label, topology. ... Mandatory Arguments: Optional Arguments: wls:/soainfra/serverConfig> executeDump(name='soa.env', appName='soa-infra') Begin dumping EMInstanceProperties key=soaClusterName value=NULL key=label value=PCBPEL_11.1.1.6.0_GENERIC_111018.1315.1477 key=CompositeLabel value=NULL key=version value=11.1.1.6.0 key-HttpUrl value=http://myhost.us.example.com:8001 End dumping EMInstanceProperties Cluster Info: ----------------------------------------------- cluster name:null cluster is leader:true cluster is standalone:true
表12-5に、ランタイム・プラットフォーム構成の診断ダンプの詳細を示します。
表12-5 ランタイム・プラットフォーム構成診断のダンプ
ダンプ名 | ダンプ・パラメータ/ダンプ・モード | 取得される情報 |
---|---|---|
|
|
サービス・エンジンの構成: 次の構成はMDSに保持されます(
|
次のWLSTコマンドライン構文を入力し、ダンプの説明を表示し、soa.config
のダンプを実行します。
wls:/soainfra/serverConfig> describeDump(name='soa.config', appName='soa-infra') Name: soa.config Description: SOA diagnostic dump that captures SOA runtime configuration info, such as deployed-composites.xml, service engine configurations, etc. Mandatory Arguments: Optional Arguments: Name Type Description zip BOOLEAN Boolean flag (default to 'true') indicating if the dump files need to be compressed into one single zip file, true - compress dump result into a single zip, false, otherwise, default: true output STRING Path to Output destination, a directory where the dump content will be written to, default to DFW dump path if not specified ... wls:/soainfra/serverConfig> executeDump(name='soa.config', appName='soa-infra') . . . . . . Start dumping artifacts from MDS URI:deployed-composites/deployed-composites.xml to /tmp/soa_ dumps139780820495.tmp/soa_config734535543.d Finished dumping specified MDS metadata to /tmp/soa_dumps139780820495.tmp/soa_ config734535543.d Start dumping artifacts from MDS URI:soa/configuration/default/ to /tmp/soa_ dumps139780820495.tmp/soa_config734535543.d/se-configurations Finished dumping specified MDS metadata to: /tmp/soa_dumps139780820495.tmp/soa_ config734535543.d/se-configurations MDS artifacts dumped, next, compressing all dump files into: /tmp/oracle-dfw--1770056289547048694.tmp/soa_config364634563344231671.zip
executeDump
コマンドは、MDSリポジトリからdeployed-composites.xml
をダンプし、インストールされているすべてのサービス・エンジンのサービス・エンジン構成を、圧縮した単一のZIPファイル(soa_config364634563344231671.zip
)にします。
次のWLSTコマンドライン構文を入力し、zip
パラメータfalse
に設定してsoa.config
のダンプを実行します。この設定は、ダンプ・テキスト・ファイルおよびアーティファクトを、単一のZIPファイルに圧縮せずにダンプ・パス・ロケーションに書き込みます。
. . . . . . wls:/soainfra/serverConfig> executeDump(name='soa.config', appName='soa-infra', args={'zip':'false'})Start dumping artifacts from MDS URI:deployed-composites/deployed-composites.xml to: /tmp/oracle-dfw-7178460573556479044.tmp/soa_config199325881615155981.d Finished dumping specified MDS metadata to: /tmp/oracle-dfw-7178460573556479044.tmp/soa_config199325881615155981.d Start dumping artifacts from MDS URI:soa/configuration/default/ to: /tmp/oracle-dfw-7178460573556479044.tmp/soa_ config199325881615155981.d/se-configurations Finished dumping specified MDS metadata to: /tmp/oracle-dfw-7178460573556479044.tmp/soa_ config199325881615155981.d/se-configurations
デフォルトのダンプ・パスで、内容を点検します。
[jdoe@myhost /tmp]$ ls -alR oracle-dfw-7178460573556479044.tmp oracle-dfw-7178460573556479044.tmp: total 52 drwxr----- 3 jdoe dba 4096 Oct 24 15:43 . drwxrwxrwt 104 root root 36864 Oct 24 15:37 .. drwxr----- 4 jdoe dba 4096 Oct 24 15:43 soa_config199325881615155981.d -rw-r----- 1 jdoe dba 561 Oct 24 15:43 soa_config199325881615155981.txt oracle-dfw-7178460573556479044.tmp/soa_config199325881615155981.d: total 16 drwxr----- 4 jdoe dba 4096 Oct 24 15:43 . drwxr----- 3 jdoe dba 4096 Oct 24 15:43 .. drwxr----- 2 jdoe dba 4096 Oct 24 15:43 deployed-composites drwxr----- 2 jdoe dba 4096 Oct 24 15:43 se-configurations oracle-dfw-7178460573556479044.tmp/soa_ config199325881615155981.d/deployed-composites: total 12 drwxr----- 2 jdoe dba 4096 Oct 24 15:43 . drwxr----- 4 jdoe dba 4096 Oct 24 15:43 .. -rw-r----- 1 jdoe dba 1437 Oct 24 15:43 deployed-composites.xml oracle-dfw-7178460573556479044.tmp/soa_ config199325881615155981.d/se-configurations: total 56 drwxr----- 2 jdoe dba 4096 Oct 24 15:43 . drwxr----- 4 jdoe dba 4096 Oct 24 15:43 .. -rw-r----- 1 jdoe dba 267 Oct 24 15:43 adapter-config.xml -rw-r----- 1 jdoe dba 425 Oct 24 15:43 b2b-config.xml -rw-r----- 1 jdoe dba 2040 Oct 24 15:43 bpel-config.xml -rw-r----- 1 jdoe dba 1525 Oct 24 15:43 bpmn-config.xml -rw-r----- 1 jdoe dba 895 Oct 24 15:43 businessrules-config.xml -rw-r----- 1 jdoe dba 119 Oct 24 15:43 cep-config.xml -rw-r----- 1 jdoe dba 215 Oct 24 15:43 edn-config.xml -rw-r----- 1 jdoe dba 836 Oct 24 15:43 mediator-config.xml -rw-r----- 1 jdoe dba 1148 Oct 24 15:43 soa-infra-config.xml -rw-r----- 1 jdoe dba 2693 Oct 24 15:43 workflow-config.xml -rw-r----- 1 jdoe dba 2146 Oct 24 15:43 workflow-identity-config.xml -rw-r----- 1 jdoe dba 605 Oct 24 15:43 workflow-notification
次のWLSTコマンドライン構文を入力し、指定した出力ディレクトリのZIPファイルにすべてのダンプを圧縮するsoa.config
のダンプを実行します。
wls:/soainfra/serverConfig> executeDump(name='soa.config', appName='soa-infra'
,args={'output':'/home/myhome/CFG_DUMP_DIR_APP_ZIP'})
表12-6に、データベース診断ダンプの詳細を示します。取得されるデータベース情報のタイプには、Oracle SOA SuiteスキーマおよびMDSスキーマに関する状態別の件数や増加パターンなどのデータ形状情報が含まれます。
表12-6 データベース診断のダンプ
ダンプ名 | ダンプ・パラメータ/ダンプ・モード | 取得される情報 |
---|---|---|
|
|
JDBCベースのアクセスを使用して問合せを実行し、結果をダンプしたBPELデータベース表増加データ SELECT dt.table_name table_name,ds.bytes/1024/1024 segment_size_mb, ds.extents extents_used, dt.num_rows total_rows, to_char(dt.last_analyzed,'YYYY-MM-DD HH24:MI:SS') last_analyzed_date FROM dba_segments ds, dba_tables dt WHERE dt.owner = ds.owner and dt.owner = 'schema_user_name' and dt.tablespace_name = ds.tablespace_name and dt.table_name = ds.SEGMENT_NAME and ds.segment_type = 'TABLE' and dt.table_name in ('CUBE_INSTANCE', 'MEDIATOR_CASE_INSTANCE','COMPOSITE_ INSTANCE', 'AUDIT_TRAIL', 'WORK_ITEM', 'DLV_MESSAGE', 'XML_DOCUMENT','DOCUMENT_CI_REF') |
次のWLSTコマンドライン構文を入力し、ダンプの説明を表示し、soa.db
のダンプを実行します。
wls:/soainfra/serverConfig> describeDump(name='soa.db', appName='soa-infra') Name: soa.db Description: SOA diagnostic dump for SOA runtime DB usage info, e.g. bpel growth statistics Mandatory Arguments: Optional Arguments: wls:/soainfra/serverConfig> executeDump(name='soa.db', appName='soa-infra') EXECUTE QUERY SELECT dt.table_name table_name,ds.bytes/1024/1024 segment_size_mb, ds.extents extents_used, dt.num_rows total_rows, to_char(dt.last_analyzed, 'YYYY-MM-DD HH24:MI:SS') last_analyzed_date FROM dba_segments ds, dba_tables dt WHERE dt.owner = ds.owner and dt.owner ='schema_user_name' and dt.tablespace_name = ds.tablespace_name and dt.table_name = ds.SEGMENT_NAME and ds.segment_type = 'TABLE' and dt.table_name in ('CUBE_INSTANCE', 'MEDIATOR_CASE_INSTANCE','COMPOSITE_INSTANCE', 'AUDIT_TRAIL', 'WORK_ITEM', 'DLV_MESSAGE','XML_DOCUMENT','DOCUMENT_CI_REF') COMMENT: BPEL DB GROWTH DATA. TABLE_NAME SEGMENT_SIZE_MB EXTENTS_USED TOTAL_ROWS LAST_ANALYZED_DATE ------------------------------------------------------------------------- ResultSet Metadata:weblogic.jdbc.wrapper.ResultSetMetadata_oracle_jdbc_driver_ OracleResultSetMetadata@76a4b0 RECORD #1: TABLE_NAME: COMPOSITE_INSTANCE SEGMENT_SIZE_MB:0 EXTENTS_USED:1 TOTAL_ROWS:9 LAST_ANALYZED_DATE:2011-09-30 22:02:25 RECORD #2: TABLE_NAME:DOCUMENT_CI_REF SEGMENT_SIZE_MB:0 EXTENTS_USED:1 TOTAL_ROWS:0 LAST_ANALYZED_DATE:2011-09-30 22:02:34 RECORD #3: TABLE_NAME:WORK_ITEM SEGMENT_SIZE_MB:0 EXTENTS_USED:1 TOTAL_ROWS:0 LAST_ANALYZED_DATE:2011-09-30 22:02:36 RECORD #4: TABLE_NAME:AUDIT_TRAIL SEGMENT_SIZE_MB:0 EXTENTS_USED:1 TOTAL_ROWS:8 LAST_ANALYZED_DATE:2011-09-30 22:02:39
このダンプは、問合せ文字列および結果セットのレコードを表示します。
表12-7に、デプロイ済コンポジット・メタデータの診断ダンプの詳細を示します。取得される情報のタイプには、インシデントの発生時に処理された現在のコンポジット、MDSアーティファクト参照(例: ネームスペース・エクスポート)および異常のあるトランザクションが含まれます。
表12-7 デプロイ済コンポジット・メタデータ診断のダンプ
ダンプ名 | ダンプ・パラメータ/ダンプ・モード | 取得される情報 |
---|---|---|
|
|
MDSからのコンポジット・メタデータには、次のものが含まれます。
|
次のWLSTコマンドライン構文を入力し、ダンプの説明を表示し、soa.composite
のダンプを実行します。
wls:/soainfra/serverConfig> describeDump(name='soa.composite' , appName='soa-infra') Name: soa.composite Description: SOA diagnostic dump that captures composite MDS artifacts, and scratch area entries listing for composite's scratch area, dump MDS artifacts for composites that either match specified parameters: composite name/partition/revision, or associated with an ECID (Execution Context ID identifying a message flow across multiple composite instance(s), support wild card '*' as composite name/partition/revision, meaning matching composites with any composite name/any partition/any revision. Rules for actual parameter evaluation: if ecid is specified, use it to match composites associated with the ECID, composite name/partition/revision not used. ; if ecid is not specified, then use composite name/partition/revision to match composites; if composite name/partition/revision are not specified (all missing), try to get ECID from dump context; if ECID is obtained from dump context, use it to match composites associated with it, if no ECID from dump context, try to obtain composite name from dump context, if composite name obtained from dump context, then apply dump to all deployed composites. Mandatory Arguments: Optional Arguments: Name Type Description ecid STRING ECID (Execution Context ID - for tracking message flow across multiple composite instances), when present, will be used to locate composites associated with it, and other composite matching parameters ignored; it can be obtained from dump context if not specified as dump parameter, see rules for actual parameter evaluation for details. zip BOOLEAN Boolean flag (default to 'true') indicating if the dump files need to be compressed into one single zip file, true - dump into a single zip file, false, otherwise, default: true. revision STRING Revision of composite , e.g. '1.0', '2.0', can be wild card meaning matching any revision, when missing, assume default composite's revision in the composite series. partition STRING Partition of composite, default to partition(s) associated with resolved revision(s) can be wild card '*', meaning matching any partition. compositeName STRING Composite name, e.g., 'OrderProcessing', can be wild card '*', meaning matching any composite. output STRING Output destination directory where dump contents are written to, default to DFW dump path. wls:/soainfra/serverConfig> executeDump(name='soa.composite', appName='soa-infra',args=('compositeName':'WSInMedPubBpelSubFileOut', 'revision':'1.0','partition':'default','output':'/home/myhome/COMPOSITE_DUMP_ MDS_ZIP'}) . . . . . . Start dumping composite [name=WSInMedPubBpelSubFileOut, partition=partition_1, revision= 1.0 ] MDS metadata to :/tmp/soa_dumps1019331262763443905.tmp/ soa_composite4533356433976235311.d/partition_1/WSInMedPubBpelSubFileOut_ rev1.0 Finished dumping composite MDS metadata to :/tmp/soa_dumps 1019331262763443905.tmp/soa_composite4533356433976235311.d/default /WSInMedPubBpelSubFileOut_rev1.0
ダンプ出力ファイルは、指定のダンプ場所である/home/myhome/COMPOSITE_DUMP_MDS_ZIP
に作成されます。
「Location」フィールドには、指定の場所に圧縮されたダンプ結果が表示されます。ナビゲータの左側には、ZIPファイルのMDSアーティファクトが表示されます(例: .edl
ファイル、.bpel
ファイルなど)。下部の.txt
ファイルは、ZIPファイル内のメインのダンプ・ファイルです。
次のWLSTコマンドライン構文を入力し、すべてのSOAコンポジット・アプリケーション、リビジョンおよびパーティションを含むsoa.composite
のダンプを実行します。
wls:/soainfra/serverConfig> executeDump(name='soa.composite',
appName='soa-infra',args=('compositeName':'*',
'revision':'*','partition':'*','output':'/home/myhome//COMPOSITE_DUMP_
DIR_ALLCOMP_ALL_REV_ALL_PART'})
「Location」フィールドには、指定の場所に圧縮されたダンプ結果が表示されます。
すべてのリビジョンを含むすべてのパーティションのすべてのSOAコンポジット・アプリケーションがダンプされます。
表12-8に、インスタンス監査証跡の診断ダンプの詳細を示します。取得される情報のタイプには、SOAコンポジット・アプリケーション・インスタンスの監査証跡、個々のサービス・コンポーネントの監査証跡、フォルト、センサー、およびECIDによって識別されるメッセージ・フローに関連するイベント配信ネットワーク(EDN)情報が含まれます。
表12-8 インスタンス監査証跡診断のダンプ
ダンプ名 | ダンプ・パラメータ/ダンプ・モード | 取得される情報 |
---|---|---|
|
|
|
次のWLSTコマンドライン構文を入力し、ダンプの説明を表示し、soa.composite.trail
のダンプを実行します。
wls:/soainfra/serverConfig> describeDump(name='soa.composite.trail' , appName='soa-infra') Name: soa.composite.trail Description: SOA diagnostic dump for a given ECID (Execution Context ID identifying a message flow across multiple composite instances), captures composite application instances audit trail, components audit trail, faults, sensors, etc. associated with the message flow identified by the ECID; Rules for actual parameter evaluation: if ecid is specified, use it to match composites associated with the ECID, if ecid is not specified, try to get ECID from dump context, if ECID is obtained from dump context, use it to match composites associated with it, if no ECID from dump context, throw exception. Mandatory Arguments: Optional Arguments: Name Type Description ecid STRING ECID (Execution Context ID- for tracking message flow across multiple composite instances). zip BOOLEAN Boolean flag (default to 'true') indicating if the dump files need to be compressed into one single zip file, true - compress dump result into a single zip, false, otherwise, default: true wls:/soainfra/serverConfig> executeDump(name='soa.composite.trail', appName='soa-infra',args={'ecid':'cf1cec292805f383:-598c1140:1388238a4ce:-8000- 00000000000028c1'}) Executing SOA Diagnostic Dump: soa.composite.trail Description: SOA diagnostic dump that, for a given ECID (Execution Context ID identifying a message flow across multiple composite instances), captures composite application instances audit trail, components audit trail, faults, sensors, etc. associated with the message flow indentified by the ECID; Rules for actual parameter evaluation: if ecid is specified, use it to match composites associated with the ECID, if ecid is not specified, try to get ECID from dump context, if ECID is obtained from dump context, use it to match composites associated with it,if no ECID from dump context, throw exception. Parameters: Optional::ecid::STRING::ECID(Execution Context ID - for tracking message flow across multiple composite instances), Optional::zip::BOOLEAN::Boolean flag (default to 'true') indicating if the dump files need to be compressed into one single zip file, true - compress dump result into a single zip, false, otherwise, default: true. Parameter Values: parameter::ecid=cf1cec292805f383:-598c1140:1388238a4ce:-8000-00000000000028c1 parameter::zip=NULL Normalized dump parameters: ecid=cf1cec292805f383:-598c1140:1388238a4ce:-8000-00000000000028c1 zip=true Start dumping audit trails for ECID = [cf1cec292805f383:-598c1140:1388238a4ce:-8000-00000000000028c1], to destination : /tmp/oracle-dfw-3352979816637176191.tmp FAULTS= Trail data =>/tmp/oracle-dfw-3352979816637176191.tmp/soa_ dumps2431385805259626695.tmp/soa_composite_trail4522512822868494030.d/audit_ trail.xml EDN.INFO = /tmp/oracle-dfw-3352979816637176191.tmp/soa_ dumps2431385805259626695.tmp/soa_composite_trail4522512822868494030.d/edn_ info.txt composite.1.DN=default/CompositeWithEDN_11G!1.0 composite.1.ID=3 composite.1.TenantID=-1 composite.1.Created=Fri Jul 13 15:32:03 PDT 2012 composite.1.State=-1 composite.1.StateAsString=STATE_UNKNOWN composite.1.Status=null No trail found... composite.1.component.1.Name=BpelSub composite.1.component.1.Type=bpel composite.1.component.1.ID=bpel:1 composite.1.component.1.State=5 composite.1.component.1.StateAsString=STATE_SUSPENDED composite.1.component.1.Status=completed Trail data =>/tmp/oracle-dfw-3352979816637176191.tmp/soa_ dumps2431385805259626695.tmp/soa_composite_ trail4522512822868494030.d/default/CompositeWithEDN_11G_1.0_3/BpelSub_bpel_1_ component.xml SENSOR.INFO = /tmp/oracle-dfw-3352979816637176191.tmp/soa_ dumps2431385805259626695.tmp/soa_composite_ trail4522512822868494030.d/default/CompositeWithEDN_11G_1.0_3_sensor.txt composite.2.DN=partition_1/CompositeWithEDN_11G!1.0 composite.2.ID=2 composite.2.TenantID=-1 composite.2.Created=Fri Jul 13 15:31:58 PDT 2012 composite.2.State=-1 composite.2.StateAsString=STATE_UNKNOWN composite.2.Status=null No trail found... composite.2.component.1.Name=BpelSub composite.2.component.1.Type=bpel composite.2.component.1.ID=bpel:2 composite.2.component.1.State=5 composite.2.component.1.StateAsString=STATE_SUSPENDED composite.2.component.1.Status=completed Trail data =>/tmp/oracle-dfw-3352979816637176191.tmp/soa_ dumps2431385805259626695.tmp/soa_composite_ trail4522512822868494030.d/partition_1/CompositeWithEDN_11G_1.0_2/BpelSub_bpel_ 2_component.xml SENSOR.INFO = /tmp/oracle-dfw-3352979816637176191.tmp/soa_ dumps2431385805259626695.tmp/soa_composite_ trail4522512822868494030.d/partition_1/CompositeWithEDN_11G_1.0_2_sensor.txt composite.3.DN=partition_1/CompositeWithEDN_11G!1.0 composite.3.ID=1 composite.3.TenantID=-1 composite.3.Created=Fri Jul 13 15:31:24 PDT 2012 composite.3.State=-1 composite.3.StateAsString=STATE_UNKNOWN composite.3.Status=null No trail found... composite.3.component.1.Name=MediatorPub composite.3.component.1.Type=mediator composite.3.component.1.ID=mediator:7CC2E450CD3A11E1BF3F897791557FF9 composite.3.component.1.State=2 composite.3.component.1.StateAsString=STATE_COMPLETED_SUCCESSFULLY composite.3.component.1.Status=null Trail data =>/tmp/oracle-dfw-3352979816637176191.tmp/soa_ dumps2431385805259626695.tmp/soa_composite_ trail4522512822868494030.d/partition_1/CompositeWithEDN_11G_1.0_1/MediatorPub_ mediator_7CC2E450CD3A11E1BF3F897791557FF9_component.xml SENSOR.INFO = /tmp/oracle-dfw-3352979816637176191.tmp/soa_ dumps2431385805259626695.tmp/soa_composite_ trail4522512822868494030.d/partition_1/CompositeWithEDN_11G_1.0_1_sensor.txt Number of composite instance associated with the ECID [cf1cec292805f383:-598c1140:1388238a4ce:-8000-00000000000028c1]: 3 Audit trails dumped for ECID = [cf1cec292805f383:-598c1140:1388238a4ce:-8000-00000000000028c1], at the location :/tmp/oracle-dfw-3352979816637176191.tmp Compressing dump files from directory: [/tmp/oracle-dfw-3352979816637176191.tmp/soa_dumps2431385805259626695.tmp/soa_ composite_trail4522512822868494030.d] to [/tmp/oracle-dfw-3352979816637176191.tmp/soa_composite_ trail4522512822868494030.zip].
ECIDの取得方法は、第14.1「BPELプロセス・サービス・コンポーネントの監査証跡とプロセス・フローの監視」を参照してください。
表12-9に、イベント診断ダンプの詳細を示します。取得される情報のタイプには、EDNビジネス・イベント・バス・ステータス情報およびEDNデータベース・ログ・レコードが含まれます。
表12-9 イベント診断のダンプ
ダンプ名 | ダンプ・パラメータ/ダンプ・モード | 取得される情報 |
---|---|---|
|
|
すべての情報はダンプ・テキスト・ファイルに書き込まれます。 |
次のWLSTコマンドライン構文を入力し、ダンプの説明を表示し、soa.edn
のダンプを実行します。
wls:/soainfra/serverConfig> describeDump(name='soa.edn', appName='soa-infra') Name: soa.edn Description: SOA diagnostic dump that captures EDN BusinessEventBus status info, and optionally, EDN DB Log records. Mandatory Arguments: Optional Arguments: Name Type Description dumpEDNDBLOG BOOLEAN Flag indicating whether EDN DB logs included; false: EDN DB log not included. default: false. wls:/soainfra/serverConfig> executeDump(name='soa.edn', appName='soa-infra') Executing SOA Diagnostic Dump: soa.edn Description: SOA diagnostic dump that captures EDN BusinessEventBus status info, and optionally, EDN DB Log records. Parameters: Optional::dumpEDNDBLOG::BOOLEAN::Flag indicating whether EDN DB log included or not, true: EDN DB log included, false: EDN DB log not included, default: false. Parameter Values: parameter::dumpEDNDBLOG=NULL Type:oracle.integration.platform.blocks.event.saq.SAQBusinessEventBus Configuration:null Status: running=true started=true ThreadCount:3 RetryCount:3 In Global: Tx:false Cluster Info:oracle.integration.platform.blocks.cluster.CoherenceCluster Interface1mpt@163bd717 SharedEDN:false OOAO Queue Name:edn_ooao_queue Java Subscriber Name:edn java subscriber Subscription Info: No namespace subscription... QName subscriptions: ============================================================= qname={http://schemas.oracle.com/events/edl/ActionOccur}ADEvent subscriptions= id=default/WSInMedPubBpelSubFileOut!1.0*soa_7a055d6a-8402-49c2-ac56-5f85cbf3d7f/ BpelSub, consistencyLevel=ONE_AND_ONLY_ONE, filter=XPath Filter: starts-with(/ be:business-event/be:content/ns0:ActionOccurrence/ns0:ParentEntityType/@value, 'A'), runAsRoles=[$publisher] id=partition_1/WSInMedPubBpelSubFileOut!1.0*soa_80a169ab1-395a-4b87-9986-9fa2742a8bd3/ BpelSub, consistencyLevel=ONE_AND_ONLY_ONE, filter=XPath Filter: starts-with(/ be:business-event/be:content/ns0:ActionOccurrence/ns0:ParentEntityType/@value, 'A'), runAsRoles=[$publisher] EventThreadContextInfo: EventTargets: Event:partition_1/WSInMedPubBpelSubFileOut!1.0*soa0a169ab1-395a-4b87-9986-9fa2742a9bd3/ BpelSub:::oracle.fabric.BPELServiceEngine@163bd6b5 Event:default/WSInMedPubBpelSubFileOut!1.0*soa7a055d6a-8402-49c2-ac56-5f85cbf3 d7f/BpelSub:::oracle.fabric.BPELServiceEngine@163bd6b5 EDN DB Log enabled:false
executeDump
コマンドは、イベント・バス・ステータス変数(1mpt@163bd717
)およびイベント・パブリッシュ/サブスクリプション情報をダンプします。edn-db-log
がfalse
に設定されているため、ログ・メッセージ情報はダンプされません。edn-db-log
は、次のURLで有効にできます。
http://host_name:port/soa-infra/events/edn-db-log
注意:
|
表12-10は、指定のパラメータ(コンポジット名、パーティションおよびリビジョン)に一致するコンポジットについてキャッシュされたサービス定義情報の詳細を示します。
表12-10 デプロイ済コンポジットWSDL/スキーマ・キャッシュ診断のダンプ
ダンプ名 | ダンプ・パラメータ/ダンプ・モード | 取得される情報 |
---|---|---|
|
|
|
次のWLSTコマンドライン構文を入力し、ダンプの説明を表示し、soa.wsdl
のダンプを実行します。
wls:/soainfra/serverConfig> describeDump(name='soa.wsdl', appName='soa-infra') Name: soa.wsdl Description: SOA diagnostic dump that captures services definition info cached for composite(s) that match specified parameters: composite namne partition/revision, support wild card '*' as composite name/ partition/revision, meaning matching composites with any composite name/any partition/any revision. Rules for actual parameter evaluation: if ecid is specified, use it to match composites associated with the ECID, composite name/partition/revision not used. ; if ecid is not specified, then use composite name/partition/revision to match composites; if composite name/partition/revision are not specified (all missing), try to get ECID from dump context; if ECID is obtained from dump context, use it to match composites associated with it, if no ECID from dump context, try to obtain composite name from dump context, if composite name obtained from dump context, then apply dump to all deployed composites. Mandatory Arguments: Optional Arguments: Name Type Description ecid STRING ECID (Execution Context ID - for tracking message flow across multiple composite instances), when present, will be used to locate coposites associated with it and other composite matching parameters are ignored; it can be obtained from dump context if not specified as dump parameter; see rules for actual parameter evaluation for details. revision STRING Revision of composite , e.g. '1.0', '2.0', can be wild card meaning matching any revision, when missing, assume default composite's revision in the composite series. partition STRING Partition of composite, default to partition(s) associated with resolved revision(s) can be wild card '*', meaning matching any partition. compositeName STRING Composite name, e.g., 'OrderProcessing', can be wild card '*', meaning matching any composite. wls:/soainfra/serverConfig> executeDump(name='soa.wsdl', appName='soa-infra' ,arg=('compositeName':'WSInMedPubBpelSubFileOut', 'revision':'1.0','partition':'partition_1'})compositeDN:partition_ 1/WSInMedPubBpelSubFileOut!1.0*soa_8a169ab1-2060-4b87-9986-9fa2742a8bd3 . . . . . . ---------------------------------------------------------------------- is default in series:true composite application name:partition_1 composite name:WSInMedPubBpelSubFileOut composite state:on composite mode:active WSDLManager Instance:oracle.fabric.common.wsdl.WSDLManager@164ec201 Cached wsdl Definitions for the specified composite: including any shared wsdls if there are any: key=http://xmlns.oracle.com/bpel/workflow/taskService value=QName:{http://xmlns.oracle.com/bpel/workflow/taskService} TaskServicetarget name space:http://xmlns.oracle.com/bpel/workflow/taskService key=urn:MyTestWsdl value=QName:{urn:MyTestWsdl}target name space:urn:MyTestwsdl key=http://xmlns.oracle.com/adapter/file/LixinSandboxes/WSInMedPubBpelSubFile Out/FileWrite value=QName:{http://xmlns.oracle.com/pcbpel/adapter/file/LixinSandboxes/ WSInMedPubBpelSubFileOut/FileWrite}FileWritetarget name space:http: //xmlns.oracle.com/pcbpel/adapter/file/LixinSandboxes/ WSInMedPubBpelSubFileOut/FileWrite count of all cached entries:3 SchemaManager instance:oracle.fabric.common.wsdl.SchemaManager@164ec1f8 SchemaManager.isPostDeploy():true SchemaManager.isShared():false SchemaManager.schemaAddressSinceLastBuild():false Cached schema count:0 WSDLManager instance:oracle.fabric.common.wsdl.WSDLManager@14b5b8b0 cached wsdl definitions for the specified composite: including shared wsdls if there is any: --------------------------------------------------------------------------- key=http://xmlns.oracle.com/bpel/workflow/taskService value=QName:{http://xmlns.oracle.com/bpel/workflow/taskService} TaskServicetarget name space:http://xmlns.oracle.com/bpel/workflow/taskService count of all cached entries:1 SchemaManager instance:oracle.fabric.common.wsdl.SchemaManager@145b8cc SchemaManager.isPostDeploy():false SchemaManager.isShared():true SchemaManager.schemaAddressSinceLastBuild():true Cached schema count:0 WSDLManager instance:oracle.fabric.common.wsdl.WSDLManager@14b58b0 WSDLManager instance:oracle.fabric.common.wsdl.WSDLManager@14b58b0 cached wsdl definitions for the specified composite: including shared wsdls if there is any: ------------------------------------------------- key=http://xmlns.oracle.com/bpel/workflow/taskService value=QName:{http://xmlns.oracle.com/bpel/workflow/taskService} TaskServicetarget name space:http://xmlns.oracle.com/bpel/workflow/taskService count of all cached entries:1 SchemaManager instance:oracle.fabric.common.wsdl.SchemaManager@145b8cc SchemaManager.isPostDeploy():false SchemaManager.isShared():true SchemaManager.schemaAddressSinceLastBuild():true Cached schema count:0
表12-11に、ディスパッチャの静的構成の診断ダンプの詳細を示します。
表12-11 ディスパッチャの静的構成の診断ダンプ
ダンプ名 | ダンプ・パラメータ/ダンプ・モード | 取得される情報 |
---|---|---|
|
|
静的プール構成(ディスパッチャ構成)
ランタイム・メッセージ・キュー・サイズ:
ランタイム・メッセージ・キューのブレークダウン・サイズ(処理済メッセージ合計数、エラーが発生したメッセージの合計数、メッセージの平均保留時間および平均実行時間):
|
この項で説明されているWLSTコマンドに加え、システムMBeanブラウザを通してディスパッチャの静的構成の診断情報を取得することもできます。このオプションでは、起動キュー、配信キューおよびインスタンス・キューのスケジュール済メッセージと稼働中メッセージに関するより具体的な詳細を取得できます。詳細は、第12.2.8.2項「システムMBeanブラウザを使用したディスパッチャの静的構成の診断ダンプの取得」を参照してください。
次のWLSTコマンドライン構文を入力し、ダンプの説明を表示して、bpel.dispatcher
のダンプを実行します。
wls:/soainfra/serverConfig> describeDump(name='bpel.dispatcher', appName='soa-infra') Name: bpel.dispatcher Description: BPEL dispatcher config info. This dumps the information about the static (System, Invoke, Engine and Audit thread counts) and runtime Scheduled and Working Message Counts Mandatory Arguments: Optional Arguments: Name Type Description format STRING passing value of 'xml' will produce the output in xml format - args={'format':'xml'} wls:/soainfra/serverConfig> executeDump(name='bpel.dispatcher', appName='soa-infra') BPEL Service Engine Dispatcher Info: Static Pool Configurations Audit Thread Count: 3 Engine Threads: 30 Invoke Thread Count: 20 Non-Blocking Invoke Thread Count: 2 System Threads: 2 Runtime Message Queue Sizes Total Scheduled Message Count: 352 Total Working Message Count: 50 Runtime Message Queue Breakdown Sizes Audit Queue : Total Processed Messages :0 Total Errored Messages :0 Average Message Pending Time :n/a Average Message Execution Time :n/a | Scheduled | Working ---------------- | ---------- | ------- audit | 0 | 0 Engine Queue : Total Processed Messages :879 Total Errored Messages :0 Average Message Pending Time :2304.08 Average Message Execution Time :905.56 | Scheduled | Working ---------------- | ---------- | ------- domain | 0 | 0 process | 0 | 0 delivery | 253 | 19 instance | 56 | 11 Invoke Queue : Total Processed Messages :714 Total Errored Messages :0 Average Message Pending Time :1385.2 Average Message Execution Time :954.33 | Scheduled | Working ---------------- | ---------- | ------- invoke | 0 | 0 Non-Blocking Invoke Queue : Total Processed Messages :0 Total Errored Messages :0 Average Message Pending Time :n/a Average Message Execution Time :n/a | Scheduled | Working ---------------- | ---------- | ------- non-block-invoke | 0 | 0 System Queue : Total Processed Messages :1 Total Errored Messages :1 Average Message Pending Time :272 Average Message Execution Time :11014 | Scheduled | Working ---------------- | ---------- | ------- system | 0 | 0 maintenance | 0 | 0
次のWLSTコマンドライン構文を入力し、bpel.dispatcher
のダンプをXML形式で実行します。
executeDump(name='bpel.dispatcher', appName='soa-infra', args={'format':'xml'})
<dispatcher-trace invokeThreadCount="20" systemThreadCount="2"
nonBlockInvokeThreadCount="2" auditThreadCount="5" engineThreadCount="30">
<systemSet totalErroredMsgs="1" avgMsgPendingTime="277"
avgMsgExecTime="11014" totalProcessedMsgs="1">
<systemQueue>
<scheduled count="0"/>
<working count="0"/>
</systemQueue>
<maintenanceQueue>
<scheduled count="0"/>
<working count="0"/>
</maintenanceQueue>
</systemSet>
<invokeSet totalErroredMsgs="0" avgMsgPendingTime="803.82"
avgMsgExecTime="987.51" totalProcessedMsgs="385">
<invokeQueue>
<scheduled count="43"/>
<working count="20"/>
</invokeQueue>
</invokeSet>
<engineSet totalErroredMsgs="0" avgMsgPendingTime="2391.25"
avgMsgExecTime="1127.45" totalProcessedMsgs="343">
<domainQueue>
<scheduled count="0"/>
<working count="0"/>
</domainQueue>
<processQueue>
<scheduled count="43"/>
<working count="20"/>
</processQueue>
<deliveryQueue>
<scheduled count=147"/>
<working count="14"/>
</deliveryQueue>
<instanceQueue>
<scheduled count="75"/>
<working count="16"/>
</instanceQueue>
</engineSet>
<auditSet totalErroredMsgs="0" avgMsgPendingTime="n/a"
avgMsgExecTime="n/a" totalProcessedMsgs="0">
<auditQueue>
<scheduled count="0"/>
<working count="0"/>
</auditQueue>
</auditSet>
<non-block-invokeSet totalErroredMsgs="0" avgMsgPendingTime="n/a"
avgMsgExecTime="n/a" totalProcessedMsgs="0">
<non-block-invokeQueue>
<scheduled count="0"/>
<working count="20"/>
</non-block-invokeQueue>
</non-block-invokeSet>
</dispatcher-trace>
「readXMLDispatcherTrace」プロパティを呼び出すことで、ディスパッチャの静的構成の診断ダンプをシステムMBeanブラウザに表示することもできます。このオプションでは、起動キュー、配信キューおよびインスタンス・キューの現在処理中のメッセージや処理がスケジュールされたメッセージに関して、WLST executeDump
コマンド(第12.2.8.1項「WLSTコマンド(ダンプの説明および実行)」を参照)で取得するより具体的な詳細を取得できます。
ナビゲーション・ツリーで「SOA」フォルダを開きます。
「soa-infra」を右クリックして、「管理」→「システムMBeanブラウザ」の順に選択します。
「アプリケーション定義のMBean」→「oracle.as.soainfra.bpm」→「Server: server_name」→「bpel」→「CubeDispatcher」の順に選択します。
「readXMLDispatcherTrace」をクリックします。
「呼出し」をクリックします。
結果はプロパティ・ウィンドウに表示されます。
表12-12に、インスタンス平均処理時間の診断ダンプの詳細を示します。この情報は、BPELプロセス・サービス・エンジンに保持されるインスタンスの作成および最終変更のタイムスタンプから取得されます。
表12-12 インスタンス平均処理時間の診断ダンプ
ダンプ名 | ダンプ・パラメータ/ダンプ・モード | 取得される情報 |
---|---|---|
|
|
様々なプロセスのインスタンスが実行時に必要とする平均時間。この情報は永続ストアから取得され、プロセスが呼び出したパートナの所要時間を含みます。平均時間は秒単位です。 |
次のWLSTコマンドライン構文を入力し、ダンプの説明を表示して、bpel.apt
のダンプを実行します。, Candidate
wls:/soainfra/serverConfig> describeDump(name='bpel.apt', appName='soa-infra') Name: bpel.apt Description: BPEL Instance Average Procesing Time information. This information is obtained from the creation and last modify timestamp for the instance in the BPEL Engine persistence repository Mandatory Arguments: Optional Arguments: Name Type Description format STRING passing value of 'xml' will produce the output in xml format - args={'format':'xml'} wls:/soainfra/serverConfig> executeDump(name='bpel.apt', appName='soa-infra') BPEL Service Engine Instance Average Processing Time Info: Composite | Component | Instances | Average Processing Time (secs) -------------| -------------- |-------------|-------------------------------- forEach | DummyService | 2| 0.01 | Test | 3| 0.09 -------------| -------------- |-------------|-------------------------------- LinkInvoke | AsynchBPEL | 1| 0.01 | LinkInvoke | 2| 0.11 | SyncBPEL | 2| 0.01 -------------| -------------- |-------------|-------------------------------- RelaxSyntax | SyncBPELService| 2| 0.02 -----------------------------------------------------------------------------
次のWLSTコマンドライン構文を入力し、bpel.apt
のダンプをXML形式で実行します。
executeDump(name='bpel.apt', appName='soa-infra', args={'format':'xml'})
<AvgInstanceProcessingTime timestamp="2012-03-15 13:11:40.442">
<Composite name="forEach">
<Component name="DummyService" instances="2" Avg="0.01"/>
<Component name="Test" instances="3" Avg="9.09"/>
</Composite>
<Composite name="LinkInvoke">
<Component name="AsynchBPEL" instances="1" Avg="0.01"/>
<Component name="LinkInvoke" instances="2" Avg="0.11"/>
<Component name="SyncBPEL" instances="2" Avg="0.01"/>
</Composite>
<Composite name="RelaxSyntax">
<Component name="SyncBPELService" instances="2" Avg="0.02"/>
</Composite>
</AvgInstanceProcessingTime>
表12-13は、非同期プロセスの平均インスタンス処理遅延の診断ダンプの詳細を示します。このダンプは、BPELプロセス・サービス・エンジンがデータベースから保存されているメッセージを取り出してそのメッセージの処理を開始するまでの平均所要時間を示します。この統計は、インメモリーからではなく、データベースから生成されます。
表12-13 平均インスタンス処理遅延の診断ダンプ
ダンプ名 | ダンプ・パラメータ/ダンプ・モード | 取得される情報 |
---|---|---|
|
|
プロセス・インスタンスをトリガーする受信メッセージの受信からBPELサービス・エンジンが実際にメッセージの処理を開始するまでの起動処理の平均遅延。 注意: 第12.2.9項「平均インスタンス処理時間の診断ダンプ(bpel.apt)」で説明されているダンプは、プロセス・インスタンスの合計実行時間を示します。これは、アクティビティを処理するための時間の関数で、パートナ(1つ以上がコールされている場合)の所要時間も含まれます。
ただし、受信メッセージは処理される前にまず非同期通信用のデータベースに格納されるため、システムのボトルネックを診断するためにより具体的な詳細が必要とされる場合があります。したがって、データベースからメッセージを選択するBPELプロセス・サービス・エンジンの遅延の詳細も、 このダンプ情報は、インメモリーからではなく、データベースから生成されます。BPELプロセス・サービス・エンジンの各種レイヤーでの遅延に関するさらなる詳細とより効果的な分析については、第14.6.1項「「リクエストのブレークダウン」表の下位レベルの詳細の表示」を参照してください。 |
注意:
|
次のWLSTコマンドライン構文を入力し、ダンプの説明を表示して、bpel.apd
のダンプを実行します。
wls:/soainfra/serverConfig> describeDump(name='bpel.apd', appName='soa-infra') Name: bpel.apd Description: BPEL Instance Average Processing Delay information (for Asynchronous Processes). This provides dump for information regarding the following: Average Invoke Processing Delay: Time delay between receipt of incoming message that triggers the process instance and the time engine actually start processing the message. Mandatory Arguments: Optional Arguments: Name Type Description format STRING passing value of 'xml' will produce the output in xml format - args={'format':'xml'} wls:/soainfra/serverConfig> executeDump(name='bpel.apd', appName='soa-infra') ********Average Invoke Processing Delay******** Composite| Component| Partner Link| Operation| Avg Invoke Processing Delay (secs) -------- | -------- | ---------------|----------------------------------------- Call | AsynchBP | asynchBP_client| process| 0.05 -------- | -------- | -------------- |-----------|----------------------------- Test | Caller2 | caller2_client| process| 0.04 -------- | -------- | -------------- |-----------|----------------------------- EvnTest | EDNProc | null| null| 0.03 -------- | -------- | -------------- |-----------|----------------------------- forEach | Echo | client| initiate| 0.07 -------- | -------- | -------------- |-----------|-----------------------------
次のWLSTコマンドライン構文を入力し、bpel.apd
のダンプをXML形式で実行します。
executeDump(name='bpel.apd', appName='soa-infra', args={'format':'xml'})
<AvgInstanceProcessingDelays timestamp="2012-03-15 13:11:40.442">
<AvgInvokeProcessingDelays>
<Composite name="Call">
<Component name="AsynchBP">
<Partner Link name="asynchBP_client">
<Operation name="process" Avg="0.05"/>
</Partner Link>
</Component>
</Composite>
<Composite name="Test">
<Component name="Caller2">
<Partner Link name="Caller2_client">
<Operation name="process" Avg="0.04"/>
</Partner Link>
</Component>
</Composite>
<Composite name="EvnTest">
<Component name="EDNProc">
<Partner Link name="null">
<Operation name="null" Avg="0.03"/>
</Partner Link>
</Component>
</Composite>
<Composite name="forEach">
<Component name="Echo">
<Partner Link name="client">
<Operation name="initiate" Avg="0.07"/>
</Partner Link>
</Component>
</Composite>
</AvgInvokeProcessingDelays>
</AvgInstanceProcessingDelays
表12-14は、同期プロセス統計の診断ダンプの詳細を示します。このダンプは、最小、最大および平均処理時間(ミリ秒単位)、ならびに処理されたインスタンスの数を示します。第14.6.1項「「リクエストのブレークダウン」表の下位レベルの詳細の表示」で説明されているシステムMBeanブラウザの「StatsLastN」プロパティを、この診断ダンプを取得するように構成する必要があります。ただし、オプションのダンプ・パラメータのduration
とbuffer
が指定されており、「StatsLastN」が構成されていない場合、このダンプ・コマンドはスループット(毎秒のトランザクション数)の統計情報を提供します。
表12-14 同期プロセス統計の診断ダンプ
ダンプ名 | ダンプ・パラメータ/ダンプ・モード | 取得される情報 |
---|---|---|
|
|
同期プロセスの最小、最大および平均処理時間(ミリ秒単位)、ならびに処理されたインスタンスの数。 |
次のWLSTコマンドライン構文を入力し、ダンプの説明を表示して、bpel.sps
のダンプを実行します。
wls:/soainfra/serverConfig> describeDump(name='bpel.sps', appName='soa-infra')
Description: Statistics for Synchronous Business Processes
This dump provides process level (Synchronous BPEL Processes only) statistics
such as min, max and average processing time (in milli-secs) and count of
instances processed. Note that statsLastN must be configured to obtain this
output. However, if optional parameters duration and buffer are specified and
statsLastN is not configured, this dump command would enable the stats for the
throughput (transaction per sec) information
Run Mode: asynchronous
Mandatory Arguments:
Optional Arguments:
Name Type Description
buffer STRING Range for buffer: 100-100000. Example: args={'buffer':'100'}
duration STRING Range for duration: 1-10000. Example: args={'duration':'1'}
format STRING Passing value of 'xml' will produce the output in xml format.
Example: args={'format':'xml'}
次のWLSTコマンドライン構文を入力し、「StatsLastN」を構成してbpel.sps
のダンプを実行します。
wls:/soainfra/serverConfig> executeDump(name='bpel.sps',
appName='soa-infra')
Synchronous Process Stats
Process Id: |
------------------------------------------------------------------------------|
default/Synchronous!1.0*soa_13036d87-f3ec-4954-9777-e93248c43086/BPELProcess1 |
|Minimum(m-sec) |Maximum(m-sec) |Average(m-sec) |Count
------------------------------------------------|-----
| 3 | 3 | 3.0 | 1
次のWLSTコマンドライン構文を入力し、「StatsLastN」を構成してXML形式でbpel.sps
のダンプを実行します。
wls:/soainfra/serverConfig> executeDump(name='bpel.sps', appName='soa-infra',
args={'format':'xml'})
<statistics>
<stats key="default/Synchronous!1.0*soa_13036d87-f3ec-4954-9777-
e93248c43086/BPELProcess1" min="3" max="3" average="3.0" count="1">
</stats>
</statistics>
次のWLSTコマンドライン構文を入力し、duration
およびbuffer
パラメータのスループット値を指定して、bpel.sps
のダンプを実行します。
wls:/soainfra/serverConfig> executeDump(name='bpel.sps', appName='soa-infra',
args={'duration':'10', 'buffer':'1000'})
Synchronous Process Stats (with Throughput)
Timestamp Start: 2012-07-25 10:41:16.457
Timestamp End: 2012-07-25 10:42:16.462
Sampling Window (seconds): 60
Buffer Size: 1000
Process Id:
-------------------------------------------------------------------
default/MsgProps20!1.0*soa_fe114dd1-fcfa-494a-920d-6ebd9b670/SyncM |
default/MsgProps!1.0*soa_78ab10-e820-4aa-86e3-87b8c88a1/SyncMsg |
|Minimum(m-sec) |Maximum(m-sec) |Average(m-sec) |Count |Throughput (tps)
------------------------------------------------------------------------
125 | 125 | 125.0 | 1 | 0.01
15 | 15 | 15.0 | 1 | 0.01
次のWLSTコマンドライン構文を入力し、duration
およびbuffer
パラメータのスループット値を指定し、StatsLastNを構成しないで、XML形式でbpel.sps
のダンプを実行します。
wls:/soainfra/serverConfig> executeDump(name='bpel.sps', appName='soa-infra',
args={'format':'xml', 'duration':'10', 'buffer':'1000'})
<statistics timestamp-start ='2012-07-25 10:10:09.128' timestamp-end
='2012-07-25 10:10:19.13'>
<stats key="default/MtomTestClient!1.0*soa_65dc8543-3e2949e1-a07a-637c25c722
a1/BPELProcess1" min="1292" max="1292" average="1292.0" count="1" throughput=
"0.1">
</stats>
<stats key="default/WSBPELFAProj!1.0*soa_352731eb-44c5-4db6-aff1-e6a440f3a343/WSBPELFAProcess" min="287" max="287"
average="287.0" count="1" throughput="0.1">
</stats>
</statistics>
表12-15は、非同期プロセス統計の診断ダンプの詳細を示します。このダンプは、プロセス・レベル(非同期BPELプロセスのみ)の統計(最小、最大および平均処理時間(ミリ秒単位)など)、ならびに処理されたインスタンスの数を提供します。第14.6.1項「「リクエストのブレークダウン」表の下位レベルの詳細の表示」で説明されているシステムMBeanブラウザの「StatsLastN」プロパティを、この出力を取得するように構成する必要があります。ただし、オプションのパラメータのduration
とbuffer
が指定されており、「StatsLastN」が構成されていない場合、このダンプ・コマンドはスループット(毎秒のトランザクション数)の統計情報を提供します。
表12-15 非同期プロセス統計の診断ダンプ
ダンプ名 | ダンプ・パラメータ/ダンプ・モード | 取得される情報 |
---|---|---|
|
|
非同期プロセスの最小、最大および平均処理時間(ミリ秒単位)、ならびに処理されたインスタンスの数。 |
次のWLSTコマンドライン構文を入力し、ダンプの説明を表示して、bpel.aps
のダンプを実行します。
wls:/soainfra/serverConfig> describeDump(name='bpel.aps', appName='soa-infra')
Name: bpel.aps
Description: Statistics for Asynchronous Business Processes
This dump provides process level (Asynchronous BPEL Processes only) statistics
such as min, max and average processing time (in milli-secs) and count of
instances processed. Note that statsLastN must be configured to obtain this
output. However, if optional parameters duration and buffer are specified and
statsLastN is not configured, this dump command would enable the stats for the
throughput (transaction per sec) information
Run Mode: asynchronous
Mandatory Arguments:
Optional Arguments:
Name Type Description
buffer STRING Range for buffer: 100-100000 .Example: args={'buffer':'100'}
duration STRING Range for duration: 1-10000 .Example: args={'duration':'1'}
format STRING Passing value of 'xml' will produce the output in xml
format. Example: args={'format':'xml'}
次のWLSTコマンドライン構文を入力し、「StatsLastN」を構成してbpel.aps
のダンプを実行します。
wls:/soainfra/serverConfig> executeDump(name='bpel.aps',
appName='soa-infra')
Asynchronous Process Stats
Process Id: |
------------------------------------------------------------------------------|
default/Asynchronous!1.0*soa_5c3b99b2-e1ad-4a24-9d13-f02dd8a268e/BPELProcess1 |
default/Asynchronous!1.0*soa_5c3b99b2-e1ad-4a24-9d13-f02dd8a268e/BPELProcessC |
|Minimum(m-sec) |Maximum(m-sec) |Average(m-sec) |Count
------------------------------------------------|-----
| 4 | 4 | 4.0 | 0
| 70 | 70 | 70.0 | 1
次のWLSTコマンドライン構文を入力し、「StatsLastN」を構成してXML形式でbpel.aps
のダンプを実行します。
executeDump(name='bpel.aps', appName='soa-infra', args={'format':'xml'})
<statistics>
<stats key="default/Asynchronous!1.0*soa_5c3b99b2-e1ad-4a24-9d13-f02dd8a268e/
BPELProcess1 min="4" max="4" average="4.0" count="0">
</stats>
<stats key="default/Asynchronous!1.0*soa_5c3b99b2-e1ad-4a24-9d13-f02dd8a268e/
BPELProcess1Client min="70" max="70" average="70.0" count="1">
</stats>
</statistics>
次のWLSTコマンドライン構文を入力し、duration
およびbuffer
パラメータのスループット値を指定して、bpel.aps
のダンプを実行します。
wls:/soainfra/serverConfig> executeDump(name='bpel.aps', appName='soa-infra',
args={'duration':'60', 'buffer':'1000'})
Asynchronous Process Stats (with Throughput)
Timestamp Start: 2012-07-25 10:15:31.207
Timestamp End: 2012-07-25 10:16:31.232
Sampling Window (seconds): 60
Buffer Size: 1000
Process Id: |Minimum(m-sec)
------------------------------------------------------------------------------
default/ch10.4fromParts2!1.0*soa_86cfa7a5-76f3-49fa-908a-1f9b8c | 3111
|Maximum(m-sec) |Average(m-sec) |Count |Throughput (tps)
------------------------------------------------------------------------------
| 3111 | 3111.0 | 1 | 0.01
次のWLSTコマンドライン構文を入力し、duration
およびbuffer
パラメータのスループット値を指定し、「StatsLastN」を構成しないで、XML形式でbpel.aps
のダンプを実行します。
wls:/soainfra/serverConfig> executeDump(name='bpel.aps', appName='soa-infra',
args={'format':'xml', 'duration':'60', 'buffer':'1000'})
<statistics timestamp-start ="2012-07-25 10:19:10.937' timestamp-end
='2012-07-25 10:21:10.946">
<stats key="/default/ch11.6flow!1.0*soa_bb2b4125-068b-40d8-9eed-28b71fef6c36f/Test"
min="322" max="322" average="322.0" count="1" throughput="0.01">
</stats>
<stats key="default/ch11.7forEachSeq!1.0*soa_c7bb5f85-dcbc-4c96-a3aa-977fe5ef17cd/Test"
min="356" max="356" average="356.0" count="1" throughput="0.01">
</stats>
<stats key="default/ch11.7forEachPar!1.0*soa_8271932d-5af1-4ebe-b8ed-e1d8b3302b75/Test"
min="2492" max="2492" average="2492.0" count="1" throughput="0.01">
</stats>
</statistics>
表12-16に、リクエスト診断ダンプの詳細を示します。このダンプは、最小、最大および平均処理時間(ミリ秒単位)、ならびにBPELプロセス・サービス・エンジンの各種レイヤーを通して流れながら処理されたリクエストの数を示します。第14.6.1項「「リクエストのブレークダウン」表の下位レベルの詳細の表示」で説明されているシステムMBeanブラウザの「StatsLastN」プロパティを、この診断ダンプを取得するように構成する必要があります。ただし、オプションのダンプ・パラメータのduration
とbuffer
が指定されており、「StatsLastN」が構成されていない場合、このダンプ・コマンドはスループット(毎秒のトランザクション数)の統計情報を提供します。
表12-16 リクエスト統計の診断ダンプ
ダンプ名 | ダンプ・パラメータ/ダンプ・モード | 取得される情報 |
---|---|---|
|
|
最小、最大および平均処理時間(ミリ秒単位)、ならびにBPELプロセス・サービス・エンジンの各種レイヤーを通して流れながら処理されたリクエストの数。 |
次のWLSTコマンドライン構文を入力し、ダンプの説明を表示し、bpel.rs
のダンプを実行します。
wls:/soainfra/serverConfig> describeDump(name='bpel.rs', appName='soa-infra')
Name: bpel.rs
Description: Statistics for Requests processing by Engine.
This dump provides request level statistics such as min, max and average
processing time (in milli-secs) and count of requests processed as the request
flows though various layers of engine. Note that statsLastN must be configured
to obtain this output. However, if optional parameters duration and buffer are
specified and statsLastN is not configured, this dump command would enable the
stats for the defined interval duration and return statistics which will also
include the throughput (transaction per sec) information
Run Mode: asynchronous
Mandatory Arguments:
Optional Arguments:
Name Type Description
buffer STRING Range for buffer: 100-100000. Example: args={'buffer':'100'}
duration STRING Range for duration: 1-10000 .Example: args={'duration':'1'}
format STRING Passing value of 'xml' will produce the output in xml
format. Example: args={'format':'xml'}
次のWLSTコマンドライン構文を入力し、「StatsLastN」を構成してbpel.rs
のダンプを実行します。
wls:/soainfra/serverConfig> executeDump(name='bpel.rs', appName='soa-infra')
または
wls:/soainfra/serverConfig> executeDump(name='bpel.rs', appName='soa-infra',
args={'format':'xml'})
<stats key="eng-composite-request" min="0" max="0" average="0.0" count="0">
<stats key="eng-single-request" min="2" max="3059" average="62.58" count="51">
<stats key="create-and-invoke" min="2" max="3059" average="62.54" count="51">
<stats key="glue-requests-store" min="0" max="1016" average="20.84" count="51">
<stats key="storeBatchEvent" min="0" max="42" average="1.31" count="51">
</stats>
<stats key="scope-serialize" min="0" max="857" average="16.92" count="51">
</stats>
</stats>
<stats key="create-instance" min="0" max="117" average="2.47" count="51">
<stats key="get-process-descriptor" min="0" max="0" average="0.0" count="51">
</stats>
<stats key="factory-create" min="0" max="86" average="1.72" count="51">
</stats>
<stats key="init-root-scope" min="0" max="22" average="0.52" count="51">
</stats>
<stats key="declare-wi-lookup-table" min="0" max="1" average="0.01" count="51">
</stats>
<stats key="init-request-context" min="0" max="0" average="0.0" count="51">
</stats>
</stats>
<stats key="log-sync-stats" min="0" max="3" average="0.05" count="51">
</stats>
<stats key="lookup-process" min="0" max="0" average="0.0" count="51">
</stats>
<stats key="log-requests-stats" min="0" max="1" average="0.01" count="51">
</stats>
<stats key="recycle-objects" min="0" max="0" average="0.0" count="153">
</stats>
<stats key="invoke-method" min="0" max="1445" average="28.58" count="51">
<stats key="audit-counter-create" min="0" max="1430" average="28.23"
count="51">
<stats key="eng-manage" min="0" max="499" average="9.9" count="51">
<stats key="sensor-send-activity-data" min="0" max="0" average="0.0"
count="102">
</stats>
<stats key="monitor-send-activity-data" min="0" max="0" average="0.0"
count="102">
</stats>
</stats>
<stats key="monitor-send-activity-data" min="0" max="0" average="0.0" count="51">
</stats>
<stats key="sensor-send-activity-data" min="0" max="1" average="0.01" count="51">
</stats>
</stats>
***
<stats key="check-access-control" min="0" max="15" average="0.1" count="153">
</stats>
<stats key="check-block-conditions" min="0" max="42" average="0.59" count="153">
<stats key="eng-finalize" min="0" max="42" average="0.55" count="153">
<stats key="eng-manage" min="0" max="9" average="0.13" count="102">
</stats>
<stats key="eng-until" min="0" max="41" average="0.35" count="153">
<stats key="monitor-send-activity-data" min="0" max="0" average="0.0"
count="153">
</stats>
<stats key="sensor-send-activity-data" min="0" max="0" average="0.0" count="153">
</stats>
</stats>
</stats>
<stats key="check-expirable" min="0" max="1" average="0.0" count="153">
</stats>
<stats key="get-node" min="0" max="1" average="0.0" count="153">
</stats>
</stats>
<stats key="get-workitem" min="0" max="35" average="0.24" count="153">
<stats key="load-workitem" min="0" max="5" average="0.03" count="153">
</stats>
<stats key="load-instance-for-workitem" min="0" max="30" average="0.2"
count="153">
<stats key="load-instance" min="0" max="25" average="0.16" count="153">
<stats key="actual-instance-load" min="0" max="25" average="0.16" count="153">
<stats key="cube-instance-load-context" min="0" max="0" average="0.0"
count="153">
</stats>
</stats>
</stats>
<stats key="check-bpel-process-state" min="0" max="1" average="0.0"
count="153">
</stats>
<stats key="populate-context" min="0" max="25" average="0.0" count="153">
</stats>
</stats>
</stats>
</stats>
</stats>
</stats>
<stats key="recycle-objects" min="0" max="1" average="0.01" count="51">
</stats>
</stats>
</stats>
</statistics>
次のWLSTコマンドライン構文を入力し、duration
およびbuffer
パラメータのスループット値を指定し、「StatsLastN」を構成しないで、bpel.rs
のダンプを実行します。
wls:/soainfra/serverConfig> executeDump(name='bpel.rs', appName='soa-infra',
args={'duration':'10', 'buffer':'1000'})
または
wls:/soainfra/serverConfig> executeDump(name='bpel.rs', appName='soa-infra',
args={'format':'xml','duration':'10', 'buffer':'1000'})
<statistics timestamp-start ='2012-07-25 10:12:27.536' timestamp-end
='2012-07-25 10:12:27.546'>
<stats key="eng-composite-request" min="0" max="0" average="0.0" count="0">
<stats key="eng-single-request" min="19" max="55" average="31.75" count="4">
<stats key="create-and-invoke" min="19" max="55" average="31.75" count="4">
<stats key="glue-requests-store" min="2" max="14" average="5.75" count="4">
<stats key="storeBatchEvent" min="1" max="2" average="1.75" count="4">
</stats>
<stats key="scope-serialize" min="8" max="18" average="2.5" count="4">
</stats>
</stats>
<stats key="create-instance" min="0" max="9" average="2.5" count="4">
<stats key="get-process-descriptor" min="0" max="0" average="0.0" count="4">
</stats>
<stats key="factory-create" min="0" max="0" average="0.0" count="4">
</stats>
<stats key="init-root-scope" min="0" max="9" average="2.5" count="4">
</stats>
<stats key="declare-wi-lookup-table" min="0" max="0" average="0.0" count="4">
</stats>
<stats key="init-request-context" min="0" max="0" average="0.0" count="4">
</stats>
</stats>
<stats key="log-sync-stats" min="0" max="0" average="0.0" count="4">
</stats>
<stats key="lookup-process" min="0" max="0" average="0.0" count="4">
</stats>
<stats key="log-requests-stats" min="0" max="0" average="0.0" count="4">
</stats>
<stats key="recycle-objects" min="0" max="0" average="0.0" count="23">
</stats>
<stats key="invoke-method" min="1" max="9" average="3.0" count="4">
<stats key="audit-counter-create" min="1" max="1" average="1.0" count="4">
<stats key="eng-manage" min="0" max="1" average="0.5" count="4">
<stats key="sensor-send-activity-data" min="0" max="0" average="0.0" count="8">
</stats>
<stats key="monitor-send-activity-data" min="0" max="0" average="0.0" count="8">
</stats>
</stats>
<stats key="monitor-send-activity-data" min="0" max="0" average="0.0" count="4">
</stats>
<stats key="sensor-send-activity-data" min="0" max="0" average="0.0" count="4">
</stats>
表12-17は、リシーケンサ・グループ処理遅延の診断ダンプの詳細を示します。
表12-17 リシーケンサ・グループ処理遅延の診断ダンプ
ダンプ名 | ダンプ・パラメータ/ダンプ・モード | 取得される情報 |
---|---|---|
|
|
グループ情報:
コンテナ情報:
|
次のWLSTコマンドライン構文を入力し、mediator.resequencer
のダンプの説明を表示します。
wls:/soainfra/serverConfig> describeDump(name='mediator.resequencer',
appName='soa-infra')
次の情報が表示されます。
Name: mediator.resequencer Description: diagnostic information about the groups, which have not been processed beyond user specified maximum unprocess time Run Mode: asynchronous Mandatory Arguments: Name Type Description resequencerMaxUnprocessTime INTEGER maximum duration for which the group has not been processed, duration should be specified in minutes Optional Arguments:
次のWLSTコマンドライン構文を入力し、mediator.resequencer
のダンプを実行します。
wls:/soainfra/serverConfig> executeDump(name='mediator.resequencer', appName='soa-infra', args={'resequencerMaxUnprocessTime':'minutes'}
minutesは、ダンプに含まれる前にリシーケンサ・グループを保留できる分数で置き換えます。次のような情報が表示されます。
Database Timestamp in UTC :2012-03-29 06:29:31.0 Max unprocess time condition:1 Mediator Resquencer pending group data COMPONENT_DN,OPERATION,GROUP_ID,STATUS,COMPONENT_STATUS,LAST_RECEIVED_TIME, CONTAINER_ID, PENDING MESSAGE COUNT default/Standard!2.0/Mediator1,execute,1001,0,0,2012-03-29 06:24:22.509394,EC09D271796511E18F5CBD26553417B4,1 ------------------------------------------------------------------------------ Containerid Data containerId,renewalTime EC09D271796511E18F5CBD26553417B4,java.util.GregorianCalendar[time=1333002526625 ,areFieldsSet=true,areAllFieldsSet=true,lenient=true,zone=sun.util.calendar.Zon eInfo[id="GMT-07:00",offset=-25200000,dstSavings=0,useDaylight=false,transition s=0,lastRule=null],firstDayOfWeek=1,minimalDaysInFirstWeek=1,ERA=1,YEAR=2012,MO NTH=2,WEEK_OF_YEAR=13,WEEK_OF_MONTH=5,DAY_OF_MONTH=28,DAY_OF_YEAR=88,DAY_OF_ WEEK=4,DAY_OF_WEEK_IN_MONTH=4,AM_PM=1,HOUR=11,HOUR_OF_ DAY=23,MINUTE=28,SECOND=46,MILLISECOND=625,ZONE_OFFSET=-25200000,DST_OFFSET=0]
表12-18に、コネクション・ファクトリ構成のダンプの詳細を示します。
表12-18 アダプタ診断ダンプ
ダンプ名 | ダンプ・パラメータ/ダンプ・モード | 取得される情報 |
---|---|---|
|
|
コネクション・ファクトリ情報をダンプします。
複数のコンポジットが同じJNDIを使用しているかどうかを示します。 |
次のWLSTコマンドライン構文を入力し、soa.adapter.ra
のダンプの説明を表示します。
wls:/soainfra/serverConfig> describeDump(name='soa.adapter.ra
',
appName='soa-infra')
次の情報が表示されます。
Name: soa.adapter.ra Description: SOA adapter diagnostic dump that captures connection factory configurations. Rules for actual parameter evaluation: if ecid is specified, use it to match composites associated with the ECID, composite name/partition/revision not used; if ecid is not specified, then use jndiName & adapterType to retrieve the connection factory attributes; if jndiName and adapterType are not specified, then use composite name/partition/revision to match composites; if no composite name/partition/revision are specified, then all the composites with jca binding are dumped. Mandatory Arguments: Optional Arguments: Name Type Description ecid STRING ECID(Execution Context ID - for tracking message flow across multiple composite instances), when presents, will be used to locate composites associated with it, and other composite matching parameters ignored; it can be obtained from dump context if not specified as dump parameter, see rules for actual parameter evaluation for details. revision STRING Revision of composite, e.g. '1.0', '2.0', can be wild card '*', meaning matching any revision, when missing, assume default composite's revision in the composite series. adapterType STRING Resource Adapter type partition STRING Partition of composite, default to partition(s) associated with resolved revision(s), can be wild card '*', meaning matching any partition. compositeName STRING Composite name, e.g., 'OrderProcessing', can be wild card '*',meaning matching any composite. jndiName STRING Adapter Connection Pool JNDI
次のWLSTコマンドライン構文を入力し、soa.adapter.ra
のダンプを実行します。
wls:/soainfra/serverConfig> executeDump(name='soa.adapter.ra',
appName='soa-infra', args={'compositeName':'fa', 'partition':'default',
'revision':'1.0'})
次の情報が表示されます。
CompositeDN = default/fa!1.0*soa_7ce2ebd9-ce17-4b5a-b436-2567eab33af2 Endpoint Name = service Endpoint type = Service JNDI Name = eis/FileAdapter Adapter Type = FileAdapter Pool Parameters - ================== initial-capacity = 10 test-connections-on-create = false test-connections-on-reserve = false connection-creation-retry-frequency-seconds = 2 shrinking-enabled = true ignore-in-use-connections-enabled = true highest-num-waiters = 0 shrink-frequency-seconds = 60 connection-reserve-timeout-seconds = 5 highest-num-unavailable = 0 max-capacity = 2147483647 profile-harvest-frequency-seconds = 300 capacity-increment = 100 test-connections-on-release = false match-connections-supported = false test-frequency-seconds = 0 Transaction Support = NoTransaction Connection Factory Properties - =============================== outboundDataSource = none outboundDataSourceLocal = none outboundLockTypeForWrite = none controlDir = ${user.dir} inboundDataSource = none workingDirectory = default ================================================================ CompositeDN = default/fa!1.0*soa_7ce2ebd9-ce17-4b5a-b436-2567eab33af2 Endpoint Name = reference Endpoint type = Reference JNDI Name = eis/FileAdapter Adapter Type = FileAdapter Pool Parameters - ================== initial-capacity = 10 test-connections-on-create = false test-connections-on-reserve = false connection-creation-retry-frequency-seconds = 2 shrinking-enabled = true ignore-in-use-connections-enabled = true highest-num-waiters = 0 shrink-frequency-seconds = 60 connection-reserve-timeout-seconds = 5 highest-num-unavailable = 0 max-capacity = 2147483647 profile-harvest-frequency-seconds = 300 capacity-increment = 100 test-connections-on-release = false match-connections-supported = false test-frequency-seconds = 0 Transaction Support = NoTransaction Connection Factory Properties - =============================== outboundDataSource = none outboundDataSourceLocal = none outboundLockTypeForWrite = none controlDir = ${user.dir}inboundDataSource = noneworkingDirectory = default
表12-19はアダプタ接続プールのダンプを示します。
表12-19 アダプタ診断ダンプ
ダンプ名 | ダンプ・パラメータ/ダンプ・モード | 取得される情報 |
---|---|---|
|
|
構成されたコネクション・ファクトリJNDIの接続プール統計をダンプします。 |
次のWLSTコマンドライン構文を入力し、soa.adapter.connpool
のダンプの説明を表示します。
wls:/soainfra/serverConfig> describeDump(name='soa.adapter.connpool',
appName='soa-infra')
次の情報が表示されます。
Name: soa.adapter.connpool Description: SOA adapter diagnostic dump that captures the Connection pool stats for configured adapters JNDI. Rules for actual parameter evaluation: if ecid is specified, use it to match composites associated with the ECID, composite name/partition/revision not used; if ecid is not specified, then use jndiName & adapterType to retrieve the connection pool attributes; if jndiName and adapterType are not specified, then use composite name/partition/revision to match composites; if no composite name/partition/revision are specified, then all the composites with jca binding are dumped. Mandatory Arguments: Optional Arguments: Name Type Description ecid STRING ECID(Execution Context ID - for tracking message flow across multiple composite instances), when presents, will be used to locate composites associated with it, and other composite matching parameters ignored; it can be obtained from dump context if not specified as dump parameter, see rules for actual parameter evaluation for details. revision STRING Revision of composite, e.g. '1.0', '2.0', can be wild card '*', meaning matching any revision, when missing, assume default composite's revision in the composite series. adapterType STRING Resource Adapter type partition STRING Partition of composite, default to partition(s) associated with resolved revision(s), can be wild card '*', meaning matching any partition. compositeName STRING Composite name, e.g., 'OrderProcessing', can be wild card '*',meaning matching any composite. jndiName STRING Adapter Connection Pool JNDI
次のWLSTコマンドライン構文を入力し、soa.adapter.connpool
のダンプを実行します。
wls:/soainfra/serverConfig> executeDump(name='soa.adapter.connpool',
appName='soa-infra', args={'compositeName':'fa', 'partition':'default',
'revision':'1.0'})
次の情報が表示されます。
CompositeDN=default/fa!1.0*soa_7ce2ebd9-ce17-4b5a-b436-2567eab33af2 Endpoint Name = service Endpoint type = Service JNDI Name =eis/FileAdapter Adapter Type =FileAdapter ConnectionPool Attributes: ========================== Important ConnectionPool Attributes: ==================================== InitialCapacity = 10 MaxCapacity = 2147483647 CurrentCapacity = 10 State = Running FreeConnectionsCurrentCount = 10 NumUnavailableCurrentCount = 0 NumberDetectedLeaks = 0 ConnectionsDestroyedByErrorTotalCount = 0 ConnectionsRejectedTotalCount = 0 Other ConnectionPool Attributes: ================================ ActiveConnectionsCurrentCount = 0 FreePoolSizeHighWaterMark = 0 PoolSizeLowWaterMark = 0 ConnectionsMatchedTotalCount = 0 LastShrinkTime = 0 FreeConnectionsHighCount = 10 ConnectionsDestroyedTotalCount = 0 ConnectionsDestroyedByShrinkingTotalCount = 0 ShrinkingEnabled = true ConnectionsCreatedTotalCount = 10 NumUnavailableHighCount = 0 MaxIdleTime = 0 LoggingEnabled = true ConnectionIdleProfileCount = 0 ConnectionProfilingEnabled = false ShrinkCountDownTime = -10565 FreePoolSizeLowWaterMark = 0 ActiveConnectionsHighCount = 0 ProxyOn = false NumWaitersCurrentCount = 0 NumWaiters = 0 CloseCount = 0 PoolSizeHighWaterMark = 0 AverageActiveUsage = 0 RecycledTotal = 0 ConnectionLeakProfileCount = 0 HighestNumWaiters = 0 ShrinkPeriodMinutes = 1 NumberDetectedIdle = 0 CapacityIncrement = 1 ================================================================ CompositeDN=default/fa!1.0*soa_7ce2ebd9-ce17-4b5a-b436-2567eab33af2 Endpoint Name = reference Endpoint type = Reference JNDI Name =eis/FileAdapter Adapter Type =FileAdapter ConnectionPool Attributes: ========================== Important ConnectionPool Attributes: ==================================== InitialCapacity = 10 MaxCapacity = 2147483647 CurrentCapacity = 10 State = Running FreeConnectionsCurrentCount = 10 NumUnavailableCurrentCount = 0 NumberDetectedLeaks = 0 ConnectionsDestroyedByErrorTotalCount = 0 ConnectionsRejectedTotalCount = 0 Other ConnectionPool Attributes: ================================ ActiveConnectionsCurrentCount = 0 FreePoolSizeHighWaterMark = 0 PoolSizeLowWaterMark = 0 ConnectionsMatchedTotalCount = 0 LastShrinkTime = 0 FreeConnectionsHighCount = 10 ConnectionsDestroyedTotalCount = 0 ConnectionsDestroyedByShrinkingTotalCount = 0 ShrinkingEnabled = true ConnectionsCreatedTotalCount = 10 NumUnavailableHighCount = 0 MaxIdleTime = 0 LoggingEnabled = true ConnectionIdleProfileCount = 0 ConnectionProfilingEnabled = false ShrinkCountDownTime = -10565 FreePoolSizeLowWaterMark = 0 ActiveConnectionsHighCount = 0 ProxyOn = false NumWaitersCurrentCount = 0 NumWaiters = 0 CloseCount = 0 PoolSizeHighWaterMark = 0 AverageActiveUsage = 0 RecycledTotal = 0 ConnectionLeakProfileCount = 0 HighestNumWaiters = 0 ShrinkPeriodMinutes = 1 NumberDetectedIdle = 0 CapacityIncrement = 1
表12-20はアダプタ診断ダンプを示します。
表12-20 アダプタ診断ダンプ
ダンプ名 | ダンプ・パラメータ/ダンプ・モード | 取得される情報 |
---|---|---|
|
|
|
次のWLSTコマンドライン構文を入力し、soa.adapter.stats
のダンプの説明を表示します。
wls:/soainfra/serverConfig> describeDump(name='soa.adapter.stats', appName='soa-infra')
次の情報が表示されます。
Name: soa.adapter.stats Description: SOA adapter diagnostic dump that captures DMS adapter statistics.Rules for actual parameter evaluation: if composite name/partition/revision are specified, dumps the DMS stats for that composite; if no composite name/partition/revision are specified, then all the composites with jca binding are dumped. Mandatory Arguments: Optional Arguments: Name Type Description revision STRING Revision of composite, e.g. '1.0', '2.0', can be wild card '*', meaning matching any revision, when missing, assume default composite's revision in the composite series. partition STRING Partition of composite, default to partition(s) associated with resolved revision(s), can be wild card '*', meaning matching any partition. compositeName STRING Composite name, e.g., 'OrderProcessing', can be wild card '*',meaning matching any composite.
次のWLSTコマンドライン構文を入力し、soa.adapter.stats
のダンプを実行します。
wls:/soainfra/serverConfig> wls:/soainfra/serverConfig>
executeDump(name='soa.adapter.stats', appName='soa-infra',
args={'compositeName':'fa',
'partition':'default', 'revision':'1.0'})
次の情報が表示されます。
CompositeDN -default/fa!1.0 Service Name -service Process Incoming Message Metrics - ================================ processIncomingMessages.time (Elapsed time in milliseconds ) - 4787 msecs processIncomingMessages.completed (Elapsed time in milliseconds ) - 2 ops processIncomingMessages.minTime (Elapsed time in milliseconds ) - 32 msecs processIncomingMessages.maxTime (Elapsed time in milliseconds ) - 4755 msecs processIncomingMessages.avg (Elapsed time in milliseconds ) - 2393.5 msecs processIncomingMessages.active (Elapsed time in milliseconds ) - 0 threads processIncomingMessages.maxActive (Elapsed time in milliseconds ) - 1 threads Error Metrics - ============= Errors.count (Number of events errored during binding processing ) - 0 ops Process Incoming Message Events - =============================== processIncomingMessagesEvents.count ( Number of processed events ) - 2 ops
スレッド・ダンプが必要な問題を診断する際は、スレッド・アクティビティに関する十分なコンテキストがあると役立ちます。診断フレームワーク・ダンプjvm.threads
は、SOAコンポジット・アプリケーションのDMS実行コンテキスト(EC)スレッド・スタック・データを提供します。次のプロパティは、SOAコンポジット・アプリケーション・インスタンスの実行が開始されると挿入され、HTTPリクエストが完了するとリセットされます。
composite_name
component_name
composite_instance_id
activity_name
(BPELプロセスで実行されるアクティビティをリストします。名前のないアクティビティ(スコープ・アクティビティなど)は取得されません。)
jvm.threads
ダンプを実行すると、この情報が表形式で出力されます。このダンプは、jvm.threads
ダンプの実行時にそれぞれのスレッドがどこにあるかを識別します。
これは、どのSOAコンポジット・アプリケーションの処理が低速かを診断するうえで役立ちます。
次のWLSTコマンドライン構文を入力し、jvm.threads
のダンプを実行します。
executeDump(name='jvm.threads')
===== THREAD CONTEXT INFORMATION ===== id ECID RID Context Values ------- ------------------------------------------------------------- ----- --------------- id=23 e6e3527fc0d0bfd2:-6c720372:139026855d8:-8000-0000000000001d3f 0:1 WEBSERVICE_ PORT.name=CatchException_pt composite_name=ExceptionHandler!1.0 J2EE_MODULE.name=fabric component_name=CommsUtilityWS WEBSERVICE_NAMESPACE.name=http://xmlns. oracle.com/ExceptionHandler/CatchException J2EE_APP.name=soa-infraWEBSERVICE.name= catchexception_client_ep composite_instance_id=1 id=61 e6e3527fc0d0bfd2:-6c720372:139026855d8:-8000-000000000000003c 0 id=70 e6e3527fc0d0bfd2:-6c720372:139026855d8:-8000-0000000000001e84 0 id=2170 e6e3527fc0d0bfd2:-6c720372:139026855d8:-8000-0000000000001d3f 0 DSID=0000J^2fPtuDSc Y5Hro2yf1G8M9Z000002 id=1616 e6e3527fc0d0bfd2:-6c720372:139026855d8:-8000-0000000000000004 0 id=2179 e6e3527fc0d0bfd2:-6c720372:139026855d8:-8000-000000000000002b 0 dbRID=0:10 id=2195 e6e3527fc0d0bfd2:-6c720372:139026855d8:-8000-0000000000001e7e 0 dbRID=0:2 id=2196 e6e3527fc0d0bfd2:-6c720372:139026855d8:-8000-0000000000001e82 0 dbRID=0:2 id=2197 e6e3527fc0d0bfd2:-6c720372:139026855d8:-8000-0000000000001e80 0 dbRID=0:5 ===== END OF THREAD CONTEXT INFORMATION =====
この情報はAdminServer-diagnostic.log
ファイル・ログで参照することもできます。
jvm.threads
ダンプの詳細は、『Oracle Fusion Middleware管理者ガイド』の「問題の診断」の章を参照してください。
ナウン・タイプのDMSメトリックは、Oracle SOA Suite MBeanとして公開され、問題を診断する際に使用します。この項では、サポートされるDMSメトリックについて説明します。DMSナウンを使用して、Oracle WebLogic Server管理コンソールの監視を作成できます。
DMSメトリックは、BPELプロセス・サービス・エンジンの「統計」ページに表示されるグラフィカルな詳細を提供します。詳細は、第14.6項「BPELプロセス・サービス・エンジンのリクエスト統計とスレッド・パフォーマンス統計の監視」および第14.9項「BPELプロセス・サービス・エンジンでのリクエストの所要時間に関する統計の表示」を参照してください。
表12-21に、サポートされるサービス・エンジンのセンサーを示します。
表12-21 サービス・エンジンのセンサー
ナウン・パス | ナウンのタイプと説明 | センサー | タイプ |
---|---|---|---|
様々なリクエスト・タイプには、監査、配信、ドメイン、インスタンス、起動、メンテナンス、非ブロック起動、プロセスおよびシステムがあります。 |
|
|
|
|
|
|
フェーズ・イベント フェーズ・イベント フェーズ・イベント フェーズ・イベント 状態 |
リクエスト・タイプは、監査、エンジン、起動、非ブロック起動およびシステムです。 |
|
|
状態 状態 |
|
|
|
フェーズ イベント |
|
|
フェーズ イベント |
|
|
|
フェーズ イベント |
|
|
|
フェーズ イベント |
|
|
|
フェーズ イベント |
|
|
|
フェーズ イベント |
|
|
|
フェーズ イベント |
|
|
|
|
状態 状態 状態 |
表12-22に、サポートされるバインディング・センサーを示します。
表12-22 バインディング・センサー
ナウン・パス | ナウン・タイプ | センサー | タイプ |
---|---|---|---|
|
|
|
フェーズ フェーズ フェーズ |
表12-23に、サポートされるコンポジット・センサーを示します。
表12-23 コンポジット・センサー
ナウン・パス | ナウン・タイプ | センサー | タイプ |
---|---|---|---|
|
|
|
状態 イベント フェーズ フェーズ |
|
|
|
イベント フェーズ |
|
|
標準偏差(入手次第ユーザー・インタフェースにより計算される) |
イベント フェーズ フェーズ |
|
|
|
イベント |
|
|
|
イベント |
|
|
|
フェーズ |
表12-24に、サポートされる参照およびサービスのセンサーを示します。
表12-24 参照およびサービスのセンサー
ナウン・パス | ナウン・タイプ | センサー | タイプ |
---|---|---|---|
|
|
|
イベント イベント フェーズ |
|
|
|
イベント イベント イベント |
表12-25に、サポートされるOracle B2Bバインディング・センサーを示します。
表12-25 Oracle B2Bバインディング・センサー
ナウン・パス | ナウン・タイプ | センサー | タイプ |
---|---|---|---|
|
|
|
イベント イベント フェーズ・イベント 状態 |
|
|
|
イベント イベント フェーズ・イベント 状態 |
|
|
|
状態 状態 イベント |
|
|
|
イベント |
|
|
|
状態 状態 状態 |
|
|
|
イベント イベント フェーズ・イベント 状態 |
|
|
|
イベント イベント フェーズ・イベント 状態 |
表12-26に、サポートされるOracle User Messaging Serviceのセンサーを示します。
表12-26 Oracle User Messaging Serviceイベント・ブリッジのメトリック
ナウン・パス | ナウン・タイプ | センサー | タイプ |
---|---|---|---|
|
|
|
イベント イベント フェーズ・イベント イベント |
|
|
|
イベント イベント フェーズ・イベント 状態 |
|
|
|
状態 |
監視を作成し、Oracle SOA Suite MBeanから収集したメトリックに基づく診断可能な条件で通知を送信できます。監視式がtrueに評価される(たとえば、ヒープ領域が指定容量を超える)と、通知が送信されます。
監視を作成する際は、次のようないくつかのオプションがあります。
デプロイメント、メモリーおよびWebサービス・コールの経過時間のために事前に構成されたルールと監視は、sca_createWatches
WLSTコマンドによって有効にします。
Oracle WebLogic Server管理コンソールでOracle SOA Suiteの監視を手動で作成します。
表12-27に示すメッセージIDが診断用に割り当てられています。
Oracle WebLogic Server管理コンソールで監視を手動で作成する場合は、表12-27のネーミング規則に従う必要があります。Oracle SOA Suite関連の監視の接頭辞は、SOA
-
message_ID
です。
事前に構成された監視を有効にすると、名前が自動的に作成されます。
表12-27 メッセージの接頭辞
シナリオ | メッセージID | 実行されるダンプ | 監視は事前に構成されていますか |
---|---|---|---|
メモリー |
|
|
はい。第12.5.1項「事前構成済ルールおよび監視の有効化」を参照してください。 |
デプロイメントのハング |
|
|
はい。第12.5.1項「事前構成済ルールおよび監視の有効化」を参照してください。 |
データ・ソース |
|
|
いいえ。作成方法は、第12.5.2項「Oracle SOA Suite監視および通知の手動作成」を参照してください。 |
Webサービス・コールの経過時間 |
|
|
はい。第12.5.1項「事前構成済ルールおよび監視の有効化」を参照してください。 |
リシーケンサ・グループ保留中 |
|
|
いいえ。作成方法は、第12.5.2項「Oracle SOA Suite監視および通知の手動作成」を参照してください。 |
WLDF通知を監視にリンクすることもできます。初期状態のOracle Fusion Middleware診断フレームワークの通知(名前はFMWDFW通知)をリンクすると、SOA固有の一連のダンプが実行されます。これらのダンプでは、状況および環境に関するランタイム情報が提供されます。実行するダンプのリストは、事前定義のXMLインシデント・ルール・ファイルによって決まります。
その他の通知(電子メールなど)を監視にリンクすることもできます。
次の事前構成済の診断フレームワーク・ルールは、Oracle SOA Suiteとともに自動的にインストールされます。
OWS-04086
エラーの発生時にインシデントを作成するためのログ検出条件ルール。
DMS実行コンテキスト(EC)でSOAコンポジット・アプリケーション名の存在をチェックして、soa.wsdl
およびsoa.composite.trail
診断ダンプを実行されるダンプのリストに追加する条件ルール。
これらのルールの使用を有効化して次の監視を生成するには、ドメインの作成後にsca_createWatches
WLSTコマンドを実行する必要があります。
デプロイメント監視(しきい値は5分)
メモリー監視(空きヒープ率のしきい値25%)
Webサービス・コールの経過時間の監視(しきい値は5分)
事前構成済の監視を有効にする手順は次のとおりです。
WLSTを使用してOracle WebLogic Serverインスタンスに接続し、編集セッションを開始します。接続と編集セッションの開始の詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』の「WLSTコマンドおよび変数リファレンス」に関する章を参照してください。
次のWLSTコマンドを実行して、事前構成済の監視を有効にします。
wls:/soainfra/serverConfig> sca_createWatches()
監視が有効になって、手動で作成した監視とともにOracle WebLogic Server管理コンソールの「Module_Name」ページの設定の下部に表示されます。
Oracle SOA SuiteでのWLSTコマンドの実行の詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』の「Oracle SOA SuiteカスタムWLSTコマンド」に関する章を参照してください。
Oracle SOA Suite監視および通知を手動で作成する手順は次のとおりです。
Oracle WebLogic Server管理コンソールにログインします。
http://host:port/console
「ドメイン構造」で、「診断」を開き、「診断モジュール」を選択します。
「診断モジュールのサマリー」ページが表示されます。
サーバーまたはサーバー・リソースの側面を監視する診断システム・モジュールを構成します。複数のシステム・モジュールを構成してサーバーの様々な側面を監視できますが、サーバーでアクティブ化できるモジュールは1つのみです。
「診断システム・モジュール」セクションで、「Module-[Module_Name]」(例: Module-FMWDFW)をクリックします。
「Module_Nameの設定」ページで、「監視と通知」→「監視」の順に選択します。
「監視」セクションで、「新規」をクリックします。
「診断監視の作成」ページが表示されます。
監視を作成するために次の詳細を入力し、「次へ」をクリックします。
フィールド | 説明 |
---|---|
監視名 |
監視の名前を入力します(この例では、 監視の名前は、次のパターンに準拠する必要があります。 message-id#soa-infra#some_other_text 例: これが必要なのは、監視条件がtrueに評価された場合に、監視名によって診断フレームワーク・インシデント処理が調整されるためです。このパターンに従っていない場合は、Oracle SOA Suiteインシデントの作成時に、Oracle SOA Suiteのダンプはトリガーされません。 その他の情報は、表12-27を参照してください。 FMWDFW通知を使用して監視が設定されている場合は、通知ハンドラにより、監視名に指定されている |
監視のタイプ |
オプションを選択します。
|
監視の有効化 |
監視を有効にする場合に選択します。 |
式を監視に追加するための「監視ルール式の構成」ページが表示されます。
「式の追加」をクリックします。
式の追加ウィザードが表示されます。
「MBeanサーバーの場所」リストで、構成する式のOracle WebLogic Server MBeanサーバーを選択します(例: ServerRuntime)。
「次へ」をクリックします。
「次のリストからMBeanのタイプを選択」ボタンをクリックします。
「MBeanタイプ」リストで、診断情報の収集に使用するMBeanを選択します(この例では、Oracle WebLogic Server MBean weblogic.management.runtime.JRockitRuntimeMBeanが選択されています)。
「次へ」をクリックします。
「インスタンスの選択」ページが表示されます。
「インスタンス」リストから、インスタンス名を選択するか、式のメトリックの識別に使用するインスタンス名パターンを指定します。
「次へ」をクリックします。
監視ルール式を作成するために次の詳細を入力し、「終了」をクリックします。
フィールド | 説明 |
---|---|
メッセージ属性 |
メッセージ属性を選択します(この例ではHeapFreePercentが選択されています)。 選択肢に表示される属性は、ステップ11で選択したMBeanの一部です。たとえば、次のように選択したとします。
oracle.dms.name=/soainfra/engines/bpel/request/system.type=soa_infra_bpel_requests
active_count、active_maxValue、active_minValue、scheduled_countなど、割り当てられている属性が表示されます。 |
演算子 |
演算子を選択します(この例では<が選択されています)。 |
値 |
値を入力します(この例では100が指定されています)。 |
「監視ルール式の構成」ページに、作成した監視ルール式が表示されます。
「次へ」をクリックします。
「監視アラームの構成」ページが表示されます。
必要に応じて、監視のアラームおよびアラームのリセット値を指定します。
「次へ」をクリックします。
「監視通知の構成」ページが表示されます。
「使用可能」表で、監視に割り当てる通知を選択し、「>」をクリックします。
監視ルール式がtrueに評価されると、通知がトリガーされます。FMWDFW通知が選択されている場合、通知は診断フレームワークによって処理され、監視にリンクされます。FMWDFW通知はOracle SOA Suiteに自動的に付属しています。この通知では第12.2項「Oracle SOA Suite診断ダンプの実行」で説明されているOracle SOA Suiteのダンプが作成されるため、この通知を選択することをお薦めします。
通知ハンドラで、適切なOracle SOA Suiteダンプが格納された問題インシデント・パッケージがADRに作成されます。インシデント・パッケージ名は、監視名に指定されているメッセージIDに対応します。後で標準的なADRツールを使用して、インシデント・パッケージのダンプを表示できます。この機能を使用して、問題シナリオの修正処理を適用できます。
「終了」をクリックします。
作成した監視が「Module_Nameの設定」ページの下部に表示されます。さらに、Oracle WebLogic Serverに自動的に付属している3種類のWLDF監視(Deadlock、StuckThreadおよびUncheckedException)も表示されます。
「名前」列で、特定の監視名をクリックして、その監視の構成の詳細を表示します。
コンポジットから外部参照へのWebサービス・バインディング・コールが完了するまでの所要時間を追跡する監視を作成できます。指定の時間しきい値を超えると、インシデントを作成したり、アラートをトリガーしたりできます。この監視は、次のシナリオで役立ちます。
呼び出された外部参照の動作が遅すぎるために、この参照による処理を待機する間にメッセージが収集される結果となっているシナリオを識別する場合
厳しいサービス・レベル合意(SLA)が配備されており、呼び出されたサービスによってSLA違反が発生している際は通知を受け取りたい場合
Webサービス・バインディング・コールの経過時間を識別する監視を作成する手順は次のとおりです。
第12.5.2項「Oracle SOA Suite監視および通知の手動作成」で説明されている手順を使用し、次のガイドラインに従って監視を作成してください。
「SOAインフラストラクチャの共通プロパティ」ページで、「詳細SOAインフラ拡張構成プロパティ」セクションの「CreateWSCallTrackingMBean」プロパティをtrue
に設定します。このプロパティは、Webサービス・バインディング・コールの経過時間を追跡するためのMBeanの作成を制御して、SOAインフラストラクチャのすべてのSOAコンポジット・アプリケーションにグローバルに適用します。外部参照に対する各Webサービス・バインディング・コールについて、時間を追跡するための新しいMBeanが登録され、その後登録解除されます。このプロパティはデフォルトでfalse
に設定されています。システムに問題が発生するまでは、このプロパティはtrue
に設定しないでください。
「SOAインフラストラクチャの共通プロパティ」ページへのアクセスの詳細は、第3.1項「SOAインフラストラクチャ・プロパティの構成」を参照してください。
監視名としてSOA-900005#soa-infra#WSExtElapsedTimeWatch
を指定します。
「監視のタイプ」リストから「収集対象メトリック」を選択します。
「カスタムMBeanのタイプ」フィールドにCreateWSCallTrackingMBean
を指定します。このMBeanは「MBeanタイプ」フィールドからは選択できません。
SOAコンポジット・アプリケーションから外部参照へのWebサービス・バインディング・コールが完了するまでの経過時間(ミリ秒単位)を追跡するためのルール式を指定します(分単位)。たとえば、この式は、監視がトリガーされたときにインシデントを作成します。
(${ServerRuntime//[oracle.fabric.management.wldf.mbean.WSExternalBindingWatchMXBeanImpl]//ElapsedTime} > 2
監視がトリガーされたとき、Oracle SOA Suite ADRディレクトリにインシデントが作成されます。ディレクトリ内のreadme
ファイルには、インシデントに関する情報が表示されます。この例では、BPELサービス・コンポーネント・インスタンス20004
が、WSDL定義のポートCommsUtilityPort
をコールしました。経過時間は244013
です(2.44013
分で、これは監視のルール式に設定されている経過時間の2
分を超えています)。例12-2に詳細を示します。
例12-2 インシデントの詳細
WatchDomainName: soainfra Watch Data: ServerRuntime//[oracle.fabric.management.wldf.mbean.WSExternalBindingWatch MXBeanImpl]//ElapsedTime : oracle.soa.config:Application=soa-infra.j2eeType= CompositeReferenceWatch.name=bpel#20004/soainfra/AdminServer/soainfra/default/ ExceptionHandler/1.0/soa.2075e8a1-5c69-4e5o-a679-c0ba2f6ae6/REFERENCEs/ CommsUtilityS/PORTs/CommsUtilityPort//ElapsedTime:244013
また、sca_createWatches
WLSTコマンドを使用して、この監視を自動的に作成することもできます。詳細は、第12.5.1項「事前構成済ルールおよび監視の有効化」を参照してください。
メッセージ待機時間や処理遅延の数が特定の制限を超えた場合にアラートを送信する監視を作成できます。
この監視は、システムMBeanブラウザの「CubeDispatcher」プロパティの「DispatcherStatsMap」属性で制御します。この設定には次のようにアクセスできます。
「soa-infra」を右クリックして、「管理」→「システムMBeanブラウザ」の順に選択します。
「アプリケーション定義のMBean」→「oracle.as.soainfra.bpm」→「Server : server_name」→「bpel」→「CubeDispatcher」の順に開きます。
「CubeDispatcher」をクリックします。
第12.5.2項「Oracle SOA Suite監視および通知の手動作成」で説明されている手順に従い、次のガイドラインを使用して、監視作成ウィザードの「式の追加」セクションで監視を作成します。
「ServerRuntime」を選択して、「次へ」をクリックします。
「カスタムMBeanのタイプ」フィールドにcom.collaxa.cube.engine.dispatch.DispatcherMXBeanAdapter
を指定して、「次へ」をクリックします。このMBeanは「MBeanタイプ」フィールドからは選択できません。
「カスタム・インスタンス」フィールドにoracle.as.soainfra.bpm:Application=soa-infra,name=CubeDispatcher,type=bpel
と指定して、「次へ」をクリックします。
「属性式」フィールドにDispatcherStatsMap(invokeSet)(invoke)(scheduled)
と指定します。
このページの残りのフィールドに入力して、「次へ」をクリックします。
リシーケンサ・グループがメッセージを処理する際の所要時間を追跡する監視を作成できます。指定した時間しきい値を超えた場合は、通知を生成できます。
リシーケンサの監視および通知を作成する手順は次のとおりです。
第12.5.2項「Oracle SOA Suite監視および通知の手動作成」で説明されている手順を使用し、次のガイドラインに従ってください。
「Module-FMWDFW」モジュールで監視と通知を作成します。
「診断監視の作成」ページで、次のパターンに準拠する監視名を指定する必要があります。
MED-900000#soa-infra#some_other_text
たとえば、MED-900000#soa-infra#PendingGroups
と指定します。
式を作成する際は、次のMBeanタイプを選択します。
oracle.tip.mediator.dfw.MediatorDiagnostic
式のインスタンスに選択できるオプションは1つのみです。
oracle.mediator:name=MediatorDiagnostic,type=MediatorDiagnostic
「メッセージ属性」フィールドにResequencerMaxUnprocessTime
を選択します。値には、通知をトリガーする前にグループを保留できる分数を入力します。
演算子として、大なり記号(>)を選択します。
完成した式は、次のようになります。
(${ServerRuntime//[oracle.tip.mediator.dwf.MediatorDiagnostic]oracle.mediator:name =MediatorDiagnostic,type=MediatorDiagnostic//resequencerMaxUnprocessTime} > '15')
サンプル・カスタム・ルール・ファイルを作成する手順は次のとおりです。
監視ルール式はダンプ・コンテキストでは提供されないため、ダンプ生成時に指定された条件は示されません。soa-infra#custom-rules.xml
というカスタム・ファイルを使用して、ダンプ生成ルールを登録できます。詳細は、第12.1.3項「事前定義のインシデント処理ルール」を参照してください。
前述の説明に従って、監視を作成します。
soa-infra#custom-rules.xml
という名前のファイルを次のいずれかの場所に作成します。
サーバー・レベルの構成: FMW_HOME
/user_projects/
domains/
domain_name
/config/fmwconfig/servers/
server_name
/dfw
ドメイン・レベルの構成: FMW_HOME
/user_projects/
domains/
domain_name
/config/fmwconfig
/dfw
新しいファイルにルールを定義します。例12-3は、リシーケンサ・サンプル・ファイルを示します。
ドメインを再起動するか、ファイルを動的にロードします。動的ロードの詳細は、第12.1.3項「事前定義のインシデント処理ルール」を参照してください。
WLDFによってダンプが生成されます。
例12-3は、グループがメッセージの処理を10分間停止すると診断ダンプを生成するサンプル・カスタム・ルール・ファイルを示します。
例12-3 リシーケンサ・ダンプのサンプル・カスタム・ルール・ファイル
<?xml version="1.0" encoding="UTF-8"?> <diagnosticRules xmlns="http://www.oracle.com/DFW/DiagnosticsFrameworkRules" xmlns:xs="http://www.w3.org/2001/XMLSchema-instance"> <processingRules> <rule name="memory diagnosis rule"> <ruleCondition> <condition name="MESSAGE_ID" value="MED-900000" operator="EQ"/> </ruleCondition> <ruleActions> <dumpAction name="mediator.resequencer"> <argument name="resequencerMaxUnprocessTime" value="10" valueType="literal"/> </dumpAction> </ruleActions> </rule> </processingRules> </diagnosticRules>
インシデントが自動で作成されなかった場合は、WLSTコマンドexecuteDump
を使用して既存のダンプを手動で実行し、インシデントを作成できます。
ダンプを手動でトリガーして実行する手順は、次のとおりです。
executeDump
コマンドを指定し、ダンプの内容をファイルに配置します(この例では、soa.config
が実行されたダンプです)。次の出力が作成されます。
wls:/soainfra/serverConfig> executeDump(name='soa.config', appName='soa-infra') Start Dumping deployedCompositesCatalog from MDS URI:deployed-composites/deployed-composites.xml to: /myhome/fmwhome/user_ projects/domains/mydomain/servers/myserver/adr/diag/ofm/mydomain/ myserver/incident/incdir_9/deployedCompositesCatalog Finished dumping specified MDS metadata to : /myhome/fmwhome/user_ projects/domains/mydomain/servers/myserver/adr/diag/ofm/mydomain/myserver/incid ent/incdir_9/deployedCompositesCatalog Start Dumping soaServiceEnginesConfigurations from MDS URI:soa/configuration/default to: /myhome/fmwhome/user_projects/ domains/mydomain/servers/myserver/AdminServer/adr/diag/ofm/mydomain/ myserver/incident/incdir_9/soaServiceEnginesConfigurations Finished dumping specified MDS metadata to : /myhome/fmwhome/user_projects/ domains/mydomain/servers/myserver/AdminServer/adr/diag/ofm/mydomain/ myserver/incident/incdir_9/soaServiceEnginesConfigurations
executeDump
コマンドを指定し、ダンプの内容を画面に表示します。
executeDump(name='soa.edn') Type:oracle.integration.platform.blocks.event.saq.SAQBusinessEventBus Configuration:null Status: running=true started=true ThreadCount:3 RetryCount:3 In Global: Tx:false Cluster Info:oracle.integration.platform.blocks.cluster.CoherenceCluster Interface1mpt@163bd717 SharedEDN:false OOAO Queue Name:edn_ooao_queue Java Subscriber Name:edn java subscriber Subscription Info: No namespace subscription... QName subscriptions: ============================================================= qname={http://schemas.oracle.com/events/edl/ActionOccur}ADEvent subscriptions= id=default/WSInMedPubBpelSubFileOut!1.0*soa_7a055d6a-8402-49c2-ac56-5f85cbf3d7f/ BpelSub, consistencyLevel=ONE_AND_ONLY_ONE, filter=XPath Filter: starts-with(/ be:business-event/be:content/ns0:ActionOccurrence/ns0:ParentEntityType/@value, 'A'), runAsRoles=[$publisher] id=partition_1/WSInMedPubBpelSubFileOut!1.0*soa_80a169ab1-395a-4b87-9986-9fa2742a8bd3/ BpelSub, consistencyLevel=ONE_AND_ONLY_ONE, filter=XPath Filter: starts-with(/ be:business-event/be:content/ns0:ActionOccurrence/ns0:ParentEntityType/@value, 'A'), runAsRoles=[$publisher] EventThreadContextInfo: EventTargets: Event:partition_1/WSInMedPubBpelSubFileOut!1.0*soa0a169ab1-395a-4b87-9986-9fa2742a9bd3/ BpelSub:::oracle.fabric.BPELServiceEngine@163bd6b5 Event:default/WSInMedPubBpelSubFileOut!1.0*soa7a055d6a-8402-49c2-ac56-5f85cbf3 d7f/BpelSub:::oracle.fabric.BPELServiceEngine@163bd6b5 EDN DB Log enabled:false
インシデントが自動で作成されなかった場合は、手動で作成することもできます。たとえば、パフォーマンスの問題に気付いたときに、Oracleサポート・サービスに送信するインシデントを作成する場合に便利です。インシデントには、SOAメッセージIDのマッピングに従ってSOAダンプを含めることができます。
これは、次のWLSTコマンドを使用して実行できます。
createIncident(messageId="SOA-90000", appName="soa-infra")
これにはWLDF監視の通知実行と同様の効果があり、この場合、監視のメッセージIDはSOA-90000
、アプリケーション名はsoa-infra
となります。
executeDump
の詳細は、Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスの「診断フレームワークのカスタムWLSTコマンド」の章を参照してください。
ADRCIは、問題を調査したり、新たな障害の診断データをパッケージ化してOracleサポートにアップロードする際に使用可能なコマンドライン・ユーティリティです。またADRCIを使用して、ADR内のダンプ・ファイルの名前を表示したり、コンテンツ・フィルタを指定して(または未指定で)XMLタグが取り除かれた状態でアラート・ログを表示することもできます。
ADRCIは次のディレクトリにインストールされています。
MW_HOME/wlserver_10.3/server/adr
ADRCIの詳細は、『Oracle Databaseユーティリティ』の「ADRCI: ADRコマンド・インタプリタ」の章を参照してください。
その他のツールの詳細は、『Oracle Database管理者ガイド』の「診断データの管理」の章を参照してください。
診断フレームワークには、次のような問題およびインシデントに関する情報を表示する際に使用できるWLSTコマンドが用意されています。
複数のOracle WebLogic Serverにまたがる問題の問合せ
複数のOracle WebLogic Serverにまたがるインシデントの問合せ
Oracle WebLogic Serverのインシデントに関連付けられているダンプ・ファイルの表示
これらのWLSTコマンドの詳細は、『Oracle Fusion Middleware管理者ガイド』の診断フレームワークの理解に関する項、およびOracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスの「診断フレームワークのカスタムWLSTコマンド」の章を参照してください。