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

アダプター クライアントは、診断トレースを有効にして、アダプターの使用中に発生した問題を効果的に診断できます。 アダプター クライアントは、次の 3 つの異なるレベルでトレースをアクティブ化できます。

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

• アダプター内

• アダプターと基幹業務 (LOB) アプリケーションの間

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

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

アダプター クライアントは、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 トレース の詳細については、以下を参照してください。

アダプター内のトレース

BizTalk アダプター パックのアダプターは、エラー、警告、情報など、さまざまなカテゴリの有用な情報をトレース ファイルに記録します。 このような情報は、アダプター内のプロセス フローを理解し、アダプターに関する問題を診断する場合に役立ちます。 WCF LOB アダプター SDK と BizTalk アプリケーションと 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 LOB アダプター SDK とアダプター トレースを有効にするには、タグ内に次の抜粋を追加する <configuration> 必要があります。

<system.diagnostics>  
    <sources>  
      <source name="Microsoft.ServiceModel.Channels" switchValue="Error">  
        <listeners>  
          <add name="xml" />  
        </listeners>  
      </source>  
      <source name="Microsoft.Adapters.Siebel" 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 に保存されます。

アダプターと LOB アプリケーションの間のトレース

LOB アプリケーション内で疑われる問題を診断するには、アダプターと LOB アプリケーション間の通信のトレースを有効にする必要があります。 アダプターは、この情報にアクセスするために LOB トレース (クライアント/サーバー側) にも依存します。 LOB トレースを有効にする詳細については、このドキュメントから除外されています。

さらに、Siebel アダプターはバインド プロパティ (LogData) を提供します。このプロパティが True に設定され、トレース レベルが Verbose に設定されている場合、Siebel アダプターはアダプターと Siebel システム間の情報フローをログに記録します。 この情報は、同じトレース ファイル内のアダプター トレースと共にログに記録されます。

このバインディング プロパティの詳細については、「 BizTalk Adapter for Siebel Binding Properties」を参照してください。

トレースの表示

Windows Communication Foundation (WCF) サービス トレース ビューアー ツールを使用して、トレースを表示できます。 ツールの詳細については、「 相関トレースとトラブルシューティングの表示にサービス トレース ビューアーを使用する」を参照してください。

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

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

グループ ハブを使用して 、追跡チェックリストやベスト プラクティスなど、追跡されたメッセージとインスタンス データを表示することもできます。

参照

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