WCF LOB アダプター SDK を使用してアダプターをトレースする
WCF LOB Adapter SDK トレースは、Systems.Diagnostics の上に構築されています。 WCF LOB アダプター SDK ランタイムには Microsoft.ServiceModel.Channels トレース ソースを使用します。 アダプター サービス参照プラグインの追加とアダプター サービス アドインの使用には、Microsoft.ServiceModel.Channels.Tools.MetadataSearchBrowse トレース ソースを使用します。 WCF トレースは、System.ServiceModel という名前のソースに書き込まれます。
アダプター開発者は、Microsoft.ServiceModel.Channels.Common.AdapterTrace クラスを使用して、アダプターのトレース ソース名を指定できます。 アダプター開発ウィザードは、アダプター開発者がアダプター コードにインストルメンテーションを提供するために使用できるトレース ラッパー クラスを生成します。
WCF トレースの詳細については、「 トレース」を参照してください。
WCF でのトレースの分析の詳細については、「 サービス トレース ビューアー ツール (SvcTraceViewer.exe)」を参照してください。
トレース ラッパー ユーティリティ クラスのサンプル
public class EchoAdapterUtilities
{
static AdapterTrace trace = new AdapterTrace("Microsoft.Adapters.Samples.Echo.EchoAdapter");
/// <summary>
/// Gets the AdapterTrace
/// </summary>
public static AdapterTrace Trace
{
get
{
return trace;
}
}
}
その後、アダプター開発者は、アダプター コード全体で前のユーティリティ クラスを使用して、アダプター コンシューマーにインストルメンテーション データを提供できます。
EchoAdapterUtilities.Trace.Trace(System.Diagnostics.TraceEventType.Information, "EchoAdapterConnection::Open", "Connection successfully opened!");
アダプターと WCF LOB アダプター SDK ランタイムのトレースを有効にする
WCF LOB アダプター SDK で提供されるトレースを有効にするには、アダプターを使用してアプリケーションの app.config ファイルに次のセクションを追加します。
<system.diagnostics>
<sources>
<source name="Microsoft.Adapters.Samples.Echo.EchoAdapter" switchValue="Verbose">
<listeners>
<add name="xmlTrace" />
</listeners>
</source>
<source name="Microsoft.ServiceModel.Channels" switchValue="Verbose">
<listeners>
<add name="xmlTrace" />
</listeners>
</source>
</sources>
<sharedListeners>
<add initializeData="C:\logs\TestEchoAdapter_Browse.svclog" type="System.Diagnostics.XmlWriterTraceListener" name="xmlTrace">
<filter type="" />
</add>
</sharedListeners>
<trace autoflush="true" />
</system.diagnostics>
add 要素を使用して、使用するトレース リスナーの名前と種類を指定できます。 この構成例では、リスナーに "xmlTrace" という名前を付け、使用する型として標準.NET Frameworkトレース リスナー (System.Diagnostics.XmlWriterTraceListener) を追加しました。 ソースごとに任意の数のトレース リスナーを追加できます。 たとえば、次の例では、.NET Frameworkトレース リスナー System.Diagnostics.TextWriterTraceListener を使用する "textTrace" という名前の別のリスナーも追加しました。 トレース リスナーがトレースをファイルに出力する場合は、構成ファイルで出力ファイルの場所と名前を指定する必要があります。 これを行うには、initializeData をそのリスナーのファイル名に設定します。
アダプター サービス参照プラグインの追加のトレースを有効にする
このプラグインのトレースを有効にするには、 にある devenv.exe.config ファイルに次のセクションを \Program Files (x86)\Microsoft Visual Studio\Common7\IDE追加します。
<system.diagnostics>
<sources>
<source name="Microsoft.ServiceModel.Channels.Tools.MetadataSearchBrowse" switchValue="Verbose, ActivityTracing">
<listeners>
<add name="textTrace"/>
</listeners>
</source>
</sources>
<sharedListeners>
<add initializeData="C:\logs\aasr.svclog" type="System.Diagnostics.XmlWriterTraceListener" name="xmlTrace">
<filter type="" />
</add>
<add initializeData="C:\logs\aasr.log" type="System.Diagnostics.TextWriterTraceListener" name="textTrace">
<filter type="" />
</add>
</sharedListeners>
<trace autoflush="true" indentsize="4" />
</system.diagnostics>
アダプター サービス アドインの使用のトレースを有効にする
このアドインのトレースを有効にするには、 にある BTSNTSVC.exe.config ファイル \Program Files (x86)\Microsoft BizTalk Serverに次のセクションを追加します。
<system.diagnostics>
<sources>
<source name="Microsoft.ServiceModel.Channels.Tools.MetadataSearchBrowse" switchValue="Verbose, ActivityTracing">
<listeners>
<add name="textTrace"/>
</listeners>
</source>
</sources>
<sharedListeners>
<add initializeData="C:\logs\aasr.svclog" type="System.Diagnostics.XmlWriterTraceListener" name="xmlTrace">
<filter type="" />
</add>
<add initializeData="C:\logs\aasr.log" type="System.Diagnostics.TextWriterTraceListener" name="textTrace">
<filter type="" />
</add>
</sharedListeners>
<trace autoflush="true" indentsize="4" />
</system.diagnostics>