Oracle Database アダプターの診断トレースとメッセージ ログ

  • [アーティクル]

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

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

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

アダプター クライアントとアダプターの間の 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 トレース では、より適切な情報が提供されます。

重要

トレースを有効にして、機密ビジネス データを公開する潜在的なセキュリティ上の脅威を軽減してください。 推奨事項については、「Oracle Database アダプターをセキュリティで保護するためのベスト プラクティス」を参照してください。

アダプター内の 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の場合、このファイルは通常、インストール ドライブ>:\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.OracleDB" 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管理コンソールを使用すると、送信ポートや受信ポートなどの項目に対してさまざまな追跡オプションを構成できます。 追跡構成設定を使用すると、受信イベント データと送信イベント データ、メッセージ プロパティ、メッセージ本文、オーケストレーションを追跡できます。 成果物の管理に関する 詳細情報が含まれています。

参照

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