次の方法で共有

Oracle E-Business Suite アダプターでの診断トレースとメッセージ ログ

  • [アーティクル]

診断トレースは、アダプターの使用時に発生する可能性のある問題を効果的に診断するのに役立ちます。 このトピックでは、Microsoft BizTalk Adapter for Oracle E-Business Suite でサポートされる次の 3 種類のトレースについて説明します。

  • クライアント識別子を使用した Oracle サーバー側トレース

  • アダプター クライアントとアダプターの間の WCF トレース

  • アダプター内の WCF トレース

クライアント識別子を使用した Oracle サーバー側のトレース

Oracle を使用すると、Oracle データベース上のクライアント アプリケーションによって実行される操作のサーバー側トレースを実行できます。 クライアント アプリケーションからの要求は異なるデータベース セッションにルーティングできるため、要求の発信元を追跡することが困難になります。 ただし、Oracle は、クライアント識別子を使用してエンドツーエンドのアプリケーション トレースを容易にします。

Oracle E-Business アダプターは、アダプターが Oracle に接続するために使用する接続の設計時にクライアント識別子を指定できるバインディング プロパティを公開 OracleConnectionClientId します。 アダプター クライアント識別子は、Oracle 上のアダプター クライアントによって実行される操作の選択的なトレースに役立ちます。また、クライアント識別子に基づいて Oracle サーバー トレースをフィルター処理して表示することもできます。 Oracle でクライアント識別子のトレースを有効にする方法については、「」を参照してください https://go.microsoft.com/fwlink/p/?LinkId=135746。

アダプター クライアントとアダプターの間の WCF トレース

アダプター クライアントは、WCF トレースを有効にして、アダプター クライアントとアダプターの間の問題をトレースできます。 WCF トレースは、WCF サービス モデルを使用してアダプター クライアントから送信される入力 XML をトレースするために使用され、シリアル化の問題の診断に役立ちます。 WCF トレースは、WCF チャネル モデルや、アダプターからアダプター クライアントへの出力メッセージには使用されません。 BizTalk アプリケーションと WCF サービス モデル アプリケーションの WCF トレースをアクティブ化するには、それぞれの構成ファイルに抜粋を追加します。 また、デザイン時と実行時の両方でトレースを有効にすることもできます。

  • デザイン時のトレース。 デザイン時のエクスペリエンスでは、アダプター サービス参照プラグインの追加、アダプター サービス アドインの使用、またはアダプター メタデータの追加ウィザードを使用できます。 これらのツールはすべて Visual Studio から使用できます。 そのため、デザイン時エクスペリエンスのトレースを有効にするには、インストール ドライブ>:\Program Files\Microsoft Visual Studio version\Common7\IDE にある devenv.exe.config ファイルに<抜粋を追加する必要があります。><

  • 実行時のトレース。 実行時トレースの場合は、使用しているアプリケーションに応じて抜粋を追加する必要があります。

    • BizTalk Server アプリケーションの場合は、BizTalk 構成ファイル (通常は BTSNTSvc.exe.config) に抜粋を追加する必要があります。BizTalk Serverの場合、このファイルは通常、インストール ドライブ>:\Program Files\Microsoft BizTalk Serverで<使用できます。

    • WCF サービス モデル .NET アプリケーションの場合は、抜粋をプロジェクトの app.config ファイルに追加する必要があります。

    WCF トレースを有効にするには、 タグ内に次の抜粋を <configuration> 追加します。

<system.diagnostics>
    <sources>
      <source name ="System.ServiceModel" switchValue="Verbose">
        <listeners>
          <add name="xml" />
        </listeners>
      </source>
      <source name ="System.ServiceModel.MessageLogging"
              switchValue="Verbose, ActivityTracing">
        <listeners>
          <add name="xml" />
        </listeners>
      </source>
      <source name ="System.Runtime.Serialization" switchValue="Verbose">
        <listeners>
          <add name="xml" />
        </listeners>
      </source>
   </sources>
   <sharedListeners>
      <add name="xml" type="System.Diagnostics.XmlWriterTraceListener"
           traceOutputOptions="LogicalOperationStack"
           initializeData="C:\log\WCFTrace.svclog" />
   </sharedListeners>
   <trace autoflush="true" />
  </system.diagnostics>
  <system.serviceModel>
    <diagnostics>
      <messageLogging
           logEntireMessage="true"
           logMalformedMessages="false"
           logMessagesAtServiceLevel="true"
           logMessagesAtTransportLevel="false"/>
    </diagnostics>
  </system.serviceModel>

これにより、WCF トレースが C:\log\WCFTrace.svclog に保存されます。 WCF トレース では、詳細が提供されます。

重要

トレースを有効にするときに発生する可能性のある機密性の高いビジネス データを公開する潜在的なセキュリティ上の脅威を軽減してください。 推奨事項については、「 メッセージおよびインスタンス データ追跡のベスト プラクティス」を参照してください。

アダプター内の WCF トレース

アダプターは、エラー、警告、情報メッセージなど、さまざまなカテゴリの有用な情報をトレース ファイルに記録します。 このような情報は、アダプター内のプロセス フローを理解し、アダプターに関する問題を診断する場合に役立ちます。 各構成ファイルに抜粋を追加することで、BizTalk アプリケーションと WCF サービス モデル アプリケーションの WCF LOB アダプター SDK とアダプター トレースをアクティブ化できます。 また、デザイン時と実行時の両方でトレースを有効にすることもできます。

  • デザイン時のトレース。 デザイン時のエクスペリエンスでは、アダプター サービス参照プラグインの追加、アダプター サービス アドインの使用、またはアダプター メタデータの追加ウィザードを使用できます。 これらのツールはすべて Visual Studio から使用できます。 そのため、デザイン時エクスペリエンスのトレースを有効にするには、インストール ドライブ>:\Program Files\Microsoft Visual Studio version\Common7\IDE にある devenv.exe.config ファイルに<抜粋を追加する必要があります。><

  • 実行時のトレース。 実行時トレースの場合は、使用しているアプリケーションに応じて抜粋を追加する必要があります。

    • BizTalk Server アプリケーションの場合は、BizTalk 構成ファイル (通常は BTSNTSvc.exe.config) に抜粋を追加する必要があります。BizTalk Server 2006 R2 の場合、このファイルは通常<、インストール ドライブ>:\Program Files\Microsoft BizTalk Server 2006 で使用できます。 BizTalk Serverの場合、このファイルは通常、インストール ドライブ>:\Program Files\Microsoft BizTalk Serverで<使用できます。

    • WCF サービス モデル .NET アプリケーションの場合は、抜粋をプロジェクトの app.config ファイルに追加する必要があります。

    WCF LOB アダプター SDK とアダプター トレースを有効にするには、 タグ内に次の抜粋を <configuration> 追加します。

<system.diagnostics>
    <sources>
      <source name="Microsoft.ServiceModel.Channels" switchValue="Error">
        <listeners>
          <add name="xml" />
        </listeners>
      </source>
      <source name="Microsoft.Adapters.OracleEBS" switchValue="Information">
        <listeners>
          <add name="xml" />
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="xml" type="System.Diagnostics.XmlWriterTraceListener"
   traceOutputOptions="LogicalOperationStack"
          initializeData="C:\log\AdapterTrace.svclog" />
    </sharedListeners>
    <trace autoflush="true" />
  </system.diagnostics>

これにより、WCF トレースが C:\log\AdapterTrace.svclog に保存されます。

トレースの表示

Windows Communication Foundation (WCF) サービス トレース ビューアー ツールを使用して、トレースを表示できます。 相関トレースとトラブルシューティングを表示するためにサービス トレース ビューアーを使用すると、 このツールの詳細が提供されます。

BizTalk アプリケーションの追跡の構成

BizTalk Server管理コンソールを使用すると、送信ポートや受信ポートなどの項目に対してさまざまな追跡オプションを構成できます。 追跡構成設定を使用すると、受信イベント データと送信イベント データ、メッセージ プロパティ、メッセージ本文、オーケストレーションを追跡できます。 BizTalk アプリケーションの追跡の構成の詳細については、「成果物の 管理と追跡」を参照してください。

グループ ハブを使用して、ベスト プラクティス、追跡クエリの保存など、 追跡対象のメッセージとインスタンス データを表示することもできます。

参照

アダプターのトラブルシューティング