ヘッダーをスキップ
Oracle® Fusion Middleware Oracle Service Bus管理者ガイド
11gリリース1 (11.1.1.9)
B61436-08
  ドキュメント・ライブラリへ移動
ライブラリ
製品リストへ移動
製品
目次へ移動
目次

前
 
 

J Oracle Service Busの問題の診断

この付録ではService Busに関する問題の識別方法と、WebLogic診断 フレームワーク(WLDF)およびOracle Fusion Middleware診断フレームワーク(DFW)を使用して適切な修正を行う方法について説明しています。

この付録の内容は次のとおりです。

J.1 Service Busの診断について

Service BusではOracleの診断フレームワーク(DFW)およびWebLogic診断フレームワーク(WLDF)を使用して、Oracle Service Busの問題を診断できます。WLDFでは、ユーザーが監視と通知を使用して診断シナリオをモニターできます。これに対し、DFWではService Bus固有の診断シナリオを、表示と分析用にフォーマットされたデータ・ダンプにユーザーが収集することができます。

WebLogicとSOAスイートにはいずれも、ユーザーの診断を助ける事前定義された複数の診断ダンプが用意されています。また、Service Busでは次の診断ダンプがサポートされています。

  • 派生リソースのキャッシュ

  • JMSリクエスト/レスポンス相関表

  • MQリクエスト/レスポンス相関表

診断フレームワーク、監視および通知の詳細は、『Oracle Fusion Middleware管理者ガイド』の診断の問題に関する説明を参照してください。SOAスイートを使用した診断フレームワークの使用法の詳細(生成するダンプ、監視と通知の設定および事前定義診断ダンプを含む)は、『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』のSOAコンポジット・アプリケーションを使用した問題の診断に関する説明を参照してください。

J.2 WebLogic診断フレームワークについて

WLDFはOracle WebLogic Serverに付属しており、サーバーのプロセス内で実行され標準的なサーバーのライフサイクルに参加する、一連のサービスを定義および実装するモニターおよび診断フレームワークです。WLDFでは、ユーザーが診断データを取得し、特定の状況が発生したときの監視と通知を設定します。監視と通知を使用して診断データを収集し、問題を特定します。このデータにより、ユーザーは障害が発生したときにその障害を切り分けることができます。

WLDFの詳細については、『Oracle Fusion Middleware Oracle WebLogic Serverのコンフィグレーションと診断フレームワークの使い方』を参照してください。

J.3 自動診断リポジトリについて

自動診断リポジトリ(ADR)は、トレースやダンプなどの診断データ用のファイル・ベースの階層型リポジトリです。Oracle Fusion Middlewareコンポーネントはすべてのインシデント・データをADRに保管し、各Oracle WebLogic Serverは診断データをADR内の各自のホーム・ディレクトリのサブディレクトリに保管します。ADRのの詳細は、『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』のSOAコンポジット・アプリケーションを使用した問題の診断に関する説明を参照してください。

J.4 サポートされるOracle Service Bus診断ダンプ

Oracle WebLogic ServerおよびOracle SOAスイートで使用できる診断ダンプに加え、Service Busでは表J-1の診断ダンプの作成がサポートされています。

表J-1 サポートされるOracle Service Bus診断ダンプ

ダンプ 説明

OSB.derived-caches

サーバー上でのすべてのService Bus派生リソースのキャッシュに関する統計のコレクション

OSB.jms-async-table

Service Bus JMSリクエスト/レスポンス相関表

OSB.mq-async-table

Service Bus MQリクエスト/レスポンス相関表


J.4.1 使用可能な診断ダンプのリスト

診断フレームワークは診断ダンプを出力し、記録します。WLSTのlistDumpsコマンドおよびdescribeDumpコマンドを使用して、サポートされているすべての診断ダンプに関する詳細をリストできます。


注意:

MW_HOME/oracle_common/common/binからWLSTを起動する必要があります。そうしない場合、ODF機能はありません。

サポートされるダンプをリストするには、次の手順を実行します。

  1. SOAインフラストラクチャがインストールされいてるサーバーに接続します。

    wls:/offline> connect('user_name', 'password',
    't3://myhost:7001')
    Connecting to t3://myhost:8001 with userid user_name ...
    Successfully connected to managed Server 'soa_server1' that belongs to
    domain 'soainfra'.
    
  2. サポートされる診断フレームワークのダンプをリストします。

    wls:/soainfra/serverConfig> listDumps()
    odl.activeLogConfig
    jvm.classhistogram
    dms.ecidctx
    wls.image
    odl.logs
    dms.metrics
    odl.quicktrace
    http.requests
    jvm.threads
    
    Use the command describeDump(name=<dumpName>) for help on a specific dump.
    
  3. サポートされるOracle Service Busのダンプをリストします。

    wls:/soainfra/serverConfig> listDumps(appName='OSB')
    OSB.derived-caches
    OSB.jms-async-table
    OSB.mq-async-table
    
    Use the command describeDump(name='<dumpName>') for help on a specific dump.
    

    listDumpsおよびdescribeDumpの詳細については、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』診断フレームワークのカスタムWLSTコマンドに関する説明を参照してください。

    診断フレームワークのダンプの詳細は、『Oracle Fusion Middleware管理者ガイド』の問題の診断に関する説明を参照してください。

J.4.2 派生リソースのキャッシュ診断のダンプ(OSB.derived-caches)

表J-2は、Service Bus派生リソースのキャッシュ診断のダンプに関する詳細を示しています。取得される情報には、各キャッシュ・タイプの名前、各キャッシュの統計情報およびキャッシュされた各エントリの情報などがあります。

表J-2 JMS相関表診断ダンプ

ダンプ名 ダンプ・パラメータ/ダンプ・モード 取得される情報

OSB.derived-caches

なし

OSB実行時に管理される各派生リソースのキャッシュについて、次の情報が提供されます。

  • 派生リソースのキャッシュ・タイプ

  • 製品のバージョン

  • 構成済キャッシュ・エントリの合計

  • 使用中のキャッシュ・エントリ数

  • サーバーが最後に起動されてからのキャッシュ・サーバーでのエントリの合計ヒット数

  • サーバーが最後に開始されてから、キャッシュ済情報へのアクセス試行中の失敗数合計

  • サーバーが最後に起動されてからのキャッシュのヒット率

各キャッシュ・エントリについて次の情報が提供されます。

  • キャッシュされている参照

  • 日時の作成

  • キャッシュ・エントリの計算に費やされた時間これは、キャッシュ情報を作成するためにかかった時間です(ミリ秒単位)。


表J-3は、診断情報に含まれる各Service Busキャッシュのリストです。

表J-3 Oracle Service Bus派生リソースのキャッシュ

キャッシュ 説明

アーカイブClassLoader

依存性対応アーカイブ・クラス・ローダー。

アーカイブ・サマリー

アーカイブ・サマリー

CodecFactory

Codecファクトリ

EffectiveWSDL

ビジネス・サービスまたはプロキシ・サービスのWSDLリソース、あるいはサービスから派生した、EffectiveWSDLオブジェクト

Flow_Info

分割-結合オブジェクト

LightweightEffectiveWSDL

ビジネス・サービスまたはプロキシ・サービスのWSDLリソース、あるいはサービスから派生した、EffectiveWSDLオブジェクト

MflExecutor

MFLエグゼキュータ

RouterRuntime

プロキシ・サービスのコンパイル済ルーター・ランタイム

RuntimeEffectiveWSDL

ビジネス・サービスまたはプロキシ・サービスのWSDL、あるいはサービスから派生した、セッションの有効なeffectiveWSDLオブジェクト

RuntimeEffectiveWSPolicy

ビジネス・サービスまたはプロキシ・サービスのWSポリシー

SchemaTypeSystem

MFL、XSおよびWSDLドキュメントの型のシステム情報

ServiceAlertsStatisticInfo

ビジネス・サービスまたはプロキシ・サービスのサービス・アラート統計

ServiceInfo

ビジネス・サービスまたはプロキシ・サービス、あるいはWSDLドキュメントのコンパイル済サービス情報

Wsdl_Info

WSDL情報オブジェクト

WsPolicyMetadata

コンパイル済WSポリシーのメタデータ

XMLSchema_Info

XMLスキーマ・オブジェクトのXMLスキーマ情報

XqueryExecutors

XQueryエグゼキュータ

XsltExecutor

XSLTエグゼキュータ

alsb.transports.ejb.
bindingtype

EJBビジネス・サービスのEJBバインディング情報

alsb.transports.jejb.business.
bindingtype

JEJBビジネス・サービスのJEJBバインディング情報

alsb.transports.jejb.proxy.
bindingtype

JEJBプロキシ・サービスのJEJBバインディング情報


J.4.2.1 WLSTコマンド・ダンプの説明と実行

  1. OSB.derived-cachesのダンプ情報を表示するには、次のWLSTコマンド・ライン構文を入力します。

    wls:/soainfra/serverConfig> describeDump(name='OSB.derived-caches',appName='OSB')
    

    次の情報が表示されます。

    Name: OSB.derived-caches
    Description: Dump of the caches used for OSB derived resources.
    Mandatory Arguments:
    Optional Arguments:
    
  2. OSB.derived-cachesのダンプを実行するには、次のWLSTコマンド・ライン構文を入力します。

    wls:/soainfra/serverConfig> executeDump(name='OSB.derived-caches', appName='OSB')
    

    次のような情報が表示されます(わかりやすいように、このダンプの一部は切り捨てられています)。

    <derivedCaches xmlns="http://www.bea.com/wli/config/xmltypes">
     <version>11.1.1.7</version> 
      <derivedCache cacheType="RuntimeEffectiveWSDL">
        <configuredEntries>2147483647</configuredEntries>
        <cacheEntriesInUse>0</cacheEntriesInUse>
        <totalHits>0</totalHits>
        <totalMisses>0</totalMisses>
        <hitRatio>0.0</hitRatio>
        <cacheEntries/>
      </derivedCache>
     ...
     <derivedCache cacheType="ServiceAlertsStatisticInfo">
        <configuredEntries>2147483647</configuredEntries>
        <cacheEntriesInUse>9</cacheEntriesInUse>
        <totalHits>0</totalHits>
        <totalMisses>51</totalMisses>
        <hitRatio>0.0</hitRatio>
        <cacheEntries>
            <cacheEntry>
                <ref>services/bs_dq_uri4.BusinessService</ref>
                <creationTime>2012-03-22T23:44:53.737-07:00</creationTime>
                <computeTimeMSecs>0</computeTimeMSecs>
            </cacheEntry>
            <cacheEntry>
                <ref>services/bs_dq_nopooling.BusinessService</ref>
                <creationTime>2012-03-22T23:44:53.736-07:00</creationTime>
                <computeTimeMSecs>0</computeTimeMSecs>
            </cacheEntry>
            <cacheEntry>
                <ref>services/bs_dq_uri1.BusinessService</ref>
                <creationTime>2012-03-22T23:44:53.738-07:00</creationTime>
                <computeTimeMSecs>0</computeTimeMSecs>
            </cacheEntry>
            <cacheEntry>
                <ref>services/proxy_dq_uri.ProxyService</ref>
                <creationTime>2012-03-22T23:44:53.736-07:00</creationTime>
                <computeTimeMSecs>0</computeTimeMSecs>
            </cacheEntry>
            <cacheEntry>
                <ref>services/bs_dq_conn_pooling.BusinessService</ref>
                <creationTime>2012-03-22T23:44:53.736-07:00</creationTime>
                <computeTimeMSecs>0</computeTimeMSecs>
            </cacheEntry>
            <cacheEntry>
                <ref>services/bs_dq_conn_nopooling.BusinessService</ref>
                <creationTime>2012-03-22T23:44:53.737-07:00</creationTime>
                <computeTimeMSecs>0</computeTimeMSecs>
            </cacheEntry>
            <cacheEntry>
                <ref>services/bs_dq_uri2.BusinessService</ref>
                <creationTime>2012-03-22T23:44:53.737-07:00</creationTime>
                <computeTimeMSecs>0</computeTimeMSecs>
            </cacheEntry>
            <cacheEntry>
                <ref>services/bs_dq_pooling.BusinessService</ref>
                <creationTime>2012-03-22T23:44:53.736-07:00</creationTime>
                <computeTimeMSecs>0</computeTimeMSecs>
            </cacheEntry>
            <cacheEntry>
                <ref>services/bs_dq_uri3.BusinessService</ref>
                <creationTime>2012-03-22T23:44:53.737-07:00</creationTime>
                <computeTimeMSecs>0</computeTimeMSecs>
            </cacheEntry>
        </cacheEntries>
     </derivedCache>
     ...
    </derivedCaches>
    

J.4.3 JMS相関表診断ダンプ(OSB.jms-async-table)

表J-4は、Service Bus JMSリクエスト/レスポンス相関表診断ダンプの詳細を示しています。取得される情報には、各メッセージの相関ID、有効期限および宛先などがあります。

表J-4 JMS相関表診断ダンプ

ダンプ名 ダンプ・パラメータ/ダンプ・モード 取得される情報

OSB.jms-async-table

なし

Service Busのバージョンに加え、各サービスの参照では保留中の各メッセージについて次の情報が表示されます。

  • 相関ID (実際の相関IDでもメッセージIDでも可能です)

  • 有効期限の日時

  • メッセージの宛先


J.4.3.1 WLSTコマンド・ダンプの説明と実行

  1. OSB.jms-async-tableのダンプ情報を表示するには、次のWLSTコマンド・ライン構文を入力します。

    wls:/soainfra/serverConfig> describeDump(name='OSB.jms-async-table',appName='OSB')
    

    次の情報が表示されます。

    Name: OSB.jms-async-table
    Description: Dump of the OSB JMS Async Table of pending messages
    Mandatory Arguments:
    Optional Arguments:
    
  2. OSB.jms-async-tableのダンプを実行するには、次のWLSTコマンド・ライン構文を入力します。

    wls:/soainfra/serverConfig> executeDump(name='OSB.jms-async-table', appName='OSB')
    

    次のような情報が表示されます。

    <transportDiagnosticsContents xmlns="http://www.bea.com/wli/sb/transportdiags">
     <version>11.1.1.7</version>
     <transportDiagnostics transportType="jms">
       <correlationTable>
         <services>
           <service>
             <ref>default/testJmsResponseRollback_out</ref>
             <message>
               <correlationMsgId responsePattern="JMSCorrelationID">
                 ID:42454153155cc06b7f5ab312000001363d5bd59effff8d4
               </correlationMsgId>
             <expirationTime>2012-03-22T19:53:43.621-07:00</expirationTime>
             <msgDestination>testJmsResponseRollback_outRequest</msgDestination>
             </message>
           </service>
         </services>
       </correlationTable>
     </transportDiagnostics>
    </transportDiagnosticsContents>
    

J.4.4 MQ相関表診断ダンプ(OSB.mq-async-table)

表J-5は、Service Bus MQリクエスト/レスポンス相関表診断ダンプの詳細を示しています。取得される情報には、各メッセージの相関ID、有効期限および宛先などがあります。

表J-5 MQ相関表診断ダンプ

ダンプ名 ダンプ・パラメータ/ダンプ・モード 取得される情報

OSB.mq-async-table

なし

Service Busのバージョンに加え、各サービスの参照では保留中の各メッセージについて次の情報が表示されます。

  • 相関ID (実際の相関IDでもメッセージIDでも可能です)

  • 有効期限の日時

  • メッセージの宛先


J.4.4.1 WLSTコマンド・ダンプの説明と実行

  1. OSB.mq-async-tableのダンプ情報を表示するには、次のWLSTコマンド・ライン構文を入力します。

    wls:/soainfra/serverConfig> describeDump(name='OSB.mq-async-table',appName='OSB')
    

    次の情報が表示されます。

    Name: OSB.mq-async-table
    Description: Dump of the OSB MQ Async Table of pending messages
    Mandatory Arguments:
    Optional Arguments:
    
  2. OSB.mq-async-tableのダンプを実行するには、次のWLSTコマンド・ライン構文を入力します。

    wls:/soainfra/serverConfig> executeDump(name='OSB.mq-async-table', appName='OSB')
    

    次のような情報が表示されます。

    <transportDiagnosticsContents xmlns="http://www.bea.com/wli/sb/transportdiags">
     <version>11.1.1.7</version>
     <transportDiagnostics transportType="mq">
       <correlationTable>
         <services>
           <service>
             <ref>services/mq_Biz_cached</ref>
             <message>
               <correlationMsgId responsePattern="MQCorrelationID">
                 000000000000000000000000000000000000000000000000
               </correlationMsgId>
               <expirationTime>2012-03-22T23:48:09.085-07:00</expirationTime>
               <msgDestination>rc_req</msgDestination>
             </message>
           </service>
         </services>
       </correlationTable>
     </transportDiagnostics>
    </transportDiagnosticsContents>
    

J.5 RDAを使用した診断ダンプの生成

WSLTを使用したService Bus診断ダンプの生成に加え、Oracle Remote Diagnostic Agent (RDA)も使用できます。次の手順を実行する前に、RDAがシステムにインストールされていることを確認してください。


ヒント:

Service BusでのRDAの使用法の詳細は、OracleサポートのOracle Service Bus (OSB)でのRDAを使用した分析情報の収集方法に関する記事を参照してください。このドキュメントのIDは1352549.1です。

RDAを使用して診断ダンプを生成するには、次の手順を実行します。

  1. コマンド・ラインから次のコマンドを実行します。

    Windowsの場合

    rda.cmd -vSCRP OSB
    

    UNIXまたはLINUXの場合

    rda.sh -vSCRP OSB
    
  2. コマンド・ラインでプロンプトに従って情報を入力します。Oracle Service Bus情報の収集にRDAを使用するか聞かれたら、デフォルト(Y)を受け入れます。


    注意:

    RDAツールの実行とオプションの詳細は、ご使用のFusion Middlewareのホーム・ディレクトリ内のRDAディレクトリにあるREADMEファイルを参照してください。

  3. Webブラウザに結果を表示できます。指定した出力ディレクトリからファイルにアクセスします。

    このファイルの名前はprefix__start.htmです(prefixは、指定した接頭辞)。