次の方法で共有

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

  • [アーティクル]

診断トレースは、アダプターの使用時に発生する可能性のある問題を効果的に診断するのに役立ちます。 アダプター クライアントは、次の 2 つのレベルで診断トレースをアクティブ化できます。

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

  • アダプター内

    このセクションでは、これらのレベルでのトレースのアクティブ化について説明します。

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

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

  • デザイン時のトレース。 デザイン時のエクスペリエンスでは、アダプター サービス参照プラグインの追加、アダプター サービス アドインの使用、またはアダプター メタデータの追加ウィザードを使用できます。 これらのツールはすべて Visual Studio から使用できます。 そのため、デザイン時エクスペリエンスのトレースを有効にするには、インストール ドライブ>:\Program Files\Microsoft Visual Studio バージョン\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 トレースの詳細については、「 トレース」を参照してください。

重要

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

アダプター内のトレース

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

  • デザイン時のトレース。 デザイン時のエクスペリエンスでは、アダプター サービス参照プラグインの追加、アダプター サービス アドインの使用、またはアダプター メタデータの追加ウィザードを使用できます。 これらのツールはすべて Visual Studio から使用できます。 そのため、デザイン時エクスペリエンスのトレースを有効にするには、インストール ドライブ>:\Program Files\Microsoft Visual Studio バージョン\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.Sql" 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 アプリケーションの追跡の構成の詳細については、「 アイテムの管理」を参照してください。

正常性とアクティビティの追跡 (HAT) を使用して、履歴または追跡されたデータを表示することもできます。 詳細については、「 履歴データと追跡データの表示」を参照してください。

参照

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