WebSphere Application Server Network Deployment for i5/OS, Version 6.1   
             オペレーティング・システム: i5/OS

             目次と検索結果のパーソナライズ化

Web サービスのトレース

Web サービス・ランタイム・コンポーネント (非管理対象クライアント、管理対象クライアント、およびサーバー・アプリケーションを含む) をトレースできます。ランタイム・コンポーネント内では、処理アクションに加えてプロシージャーの入り口および出口もトレース可能です。 ユーザー定義の例外と、Java Message Service (JMS) または HTTP を使用して Web サービスを要求する SOAP メッセージをトレースできます。

始める前に

com.ibm.ws.webservices.engine.*=all=enabled 仕様は、Web サービス・ランタイムのみをトレースします。ユーザー定義の例外および SOAP メッセージをトレースするための設定についてはステップ 4 を参照してください。また、tcpmon プロセスによる SOAP メッセージのトレースについては、tcpmon による SOAP メッセージのトレースを調べてください。

このタスクについて

以下のタスクでは、Web サービスのトレースを使用可能にする方法について説明します。

プロシージャー

  1. Web サービス非管理クライアントのトレースを使用可能にします。
    1. app_server_root/properties/TraceSettings.properties ファイルを、クライアント・アプリケーション Java アーカイブ (JAR) ファイルと同じディレクトリーにコピーして、トレース・プロパティー・ファイルを作成します。
    2. トレース・データを出力するために、プロパティー・ファイルを編集して、traceFileName の値を変更します。 例えば、traceFileName=/myDir/myAppClient.trc のようになります。
    3. プロパティー・ファイルを編集して、com.ibm.ejs.ras.*=all=enabled を除去し、 com.ibm.ws.webservices.engine.*=all=enabled を追加します。
    4. -DtraceSettingsFile=<trace_properties_file> オプションを、クライアントの実行に使用する java コマンド行に追加します。ここで、trace_properties_file は、サブステップ a から c で作成したプロパティー・ファイルの名前です。 例えば、java -DtraceSettingsFile=TraceSettings.properties myApp.myAppMainClass のようになります。
  2. 以下のオプションを使用して launchClient コマンド行ツールを起動し、Web サービス管理対象クライアントのトレースを使用可能にします。

    -CCtrace=com.ibm.ws.webservices.engine.*=all=enabled

    -CCtracefile=traceFileName

    以下に例を示します。
    app_server_root/bin/launchClient MyAppClient.ear
    -CCtrace=com.ibm.ws.webservices.engine.*=all=enabled -CCtracefile=myAppClient.trc
    詳しくは、launchClient ツールを参照してください。
  3. Java 2 Enterprise Edition (J2EE) サーバー・アプリケーション用 Web サービスのトレースを使用可能にします。
    1. WebSphere Application Server を始動します。
    2. 管理コンソールを開きます。
    3. サーバー」>「アプリケーション・サーバー」> 「server」とクリックします。
    4. ログ詳細レベルの変更」をクリックします。
    5. テキスト・ボックスのトレース・ストリングを追加、または削除します。このタスクの場合は、トレース・ストリング *=info を削除し、トレース・ストリング com.ibm.ws.webservices.engine.*=all=enabled を追加します。 テキスト・ボックス中のトレース・ストリングは、次の 2 つの方法 のどちらかで指定できます。
      • テキスト・ボックスに直接トレース・ストリングを入力します。各トレース・ストリングはスペースなしのコロン (:) で区切る必要があります。以下に例を示します。
        com.ibm.ws.webservices.trace.MessageTrace=finest:com.ibm.ws.webservices.
        engine.Message=finest
      • リストされているセクションから定義済みトレース・ストリングを選択します。定義済みセクションは、*[All Components] で始まります。定義済みトレース・ストリングの Web サービス・コンポーネントは、com.ibm..ws.* セクションにリストされています。
        • プラス (+) 記号をクリックして、com.ibm.ws.* セクションを拡張します。
        • 定義済みトレース・ストリングをクリックします。例えば、SOAP メッセージング・トレースの定義済みトレース・ストリングを追加したい場合は、com.ibm.ws.webservices.trace.MessageTrace をクリックすることができます。
        • ドロップダウン・リストからトレースのオプションをクリックします。例えば、 off、fatal、severe、warning、audit、info、config、detail、fine、finer、finest、および all を選択することができます。オプション「finest」を選択することを、お勧めします。オプションをクリックすると、そのオプションがトレース・ストリングの末尾に追加されます。 以下に例を示します。
          com.ibm.ws.webservices.trace.MessageTrace=finest
    6. 保管」または「適用」をクリックします。
    詳しくは、トレースの使用可能化を参照してください。
  4. SOAP メッセージのトレース、ユーザー定義の例外、またはその両方を使用可能にします。 SOAP メッセージのトレースには、以下のトレース仕様が使用されます。
    • com.ibm.ws.webservices.trace.MessageTrace=all

      この仕様は、SOAP メッセージの内容 (バイナリー添付ファイル・データを含む) をトレースします。

      SOAP メッセージのコンテキスト・タイプがテキストまたは xml 以外の場合、メッセージには添付ファイルが含まれている可能性があります。この場合、メッセージはトレース・ファイルに 16 進ダンプ形式で表示されます。以下の例は、非テキスト SOAP メッセージの 16 進ダンプ形式の行を示しています。
      0000: 0D 0A 2D 2D 2D 2D 2D 2D - 3D 5F 50 61 72 74 5F 36 ..------=_Part_6
      • トレース・ファイルの各行に、16 バイトのメッセージが表示されます。
      • 最初の 4 桁は 16 進数で、その値は行の最初のバイトの SOAP メッセージへのバイト・オフセットです。
      • 次の 16 個の 2 桁の 16 進数は、メッセージの連続バイトそれぞれの内容です。
      • そのバイトの ASCII 表記が、行の最後の 16 文字で表示されています。印刷不能な文字はピリオドで表されています。
    • *=off:com.ibm.ws.webservices.*=all

      この設定を使用すると、すべての Web サービス情報 (SOAP メッセージおよびユーザー定義の例外を含む) をトレースできます。

    com.ibm.ws.webservices.trace.UserExceptionTrace=all トレース・ストリングを指定して、ユーザー定義の例外のロギングを使用可能にできます。デフォルトでは、ユーザー定義の例外はログに記録されません。 ユーザー定義の例外は、Web サービス記述言語 (WSDL) ファイルに定義されている操作の例外です。

    ユーザー定義の例外は、エラー・フリー条件を表す場合があります。例えば、ユーザー定義の OverdrawnException 例外は、makeWithdrawl メソッドのサービス・エンドポイント・インプリメンテーションで発生する場合があります。 この例外は、サービス・エンドポイント・インプリメンテーションのエラ ーを示しているのではなく、予期される状態を示しています。 このようなタイプの例外は通常の処理中に発生する可能性があるため、デフォルトではログに記録されません。ユーザー定義の例外がログに記録される場合、情報は SystemOut.log ファイルではなく、trace.log ファイルに送信されます。

    また、他のトレース・ポイントに加えて、以下のトレース・ストリングを使用することによっても、ユーザー定義の例外のトレースを使用可能にできます。
    • com.ibm.ws.webservices.*=all

      すべての Web サービス・ランタイム・トレース・ログをオンにします。

    • com.ibm.ws.webservices.trace.*=all

      MessageTrace および UserExceptionTrace をオンにします。

結果

これで、非管理対象クライアント、管理対象クライアント、およびサーバー・アプリケーションのトレースが使用可能になりました。トレース・ストリング仕様によって、ランタイム・コンポーネント、ユーザー定義の例外、および SOAP メッセージのいずれがトレースに含まれるかが決まります。

次の作業

メッセージ・データを分析します。



関連タスク
Web サービスのトラブルシューティング
tcpmon による SOAP メッセージのトレース
タスク・トピック    

ご利用条件 | フィードバック

最終更新: Jan 21, 2008 8:28:52 PM EST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.nd.iseries.doc/info/iseriesnd/ae/twbs_tracewbscomp.html