Effectuer le suivi d’un adaptateur avec le Kit de développement logiciel (SDK) de l’adaptateur LOB WCF
Le suivi du KIT DE développement logiciel (SDK) de l’adaptateur LOB WCF est basé sur Systems.Diagnostics. Vous utilisez la source de trace Microsoft.ServiceModel.Channels pour le runtime du Kit de développement logiciel (SDK) de l’adaptateur LOB WCF. Vous utilisez la source de trace Microsoft.ServiceModel.Channels.Tools.MetadataSearchBrowse pour ajouter un plug-in de référence de service d’adaptateur et consommer le complément service de l’adaptateur. Les traces WCF sont écrites dans la source nommée System.ServiceModel.
Le développeur de l’adaptateur peut fournir un nom de source de trace pour l’adaptateur à l’aide de la classe Microsoft.ServiceModel.Channels.Common.AdapterTrace. L’Assistant Développement d’adaptateur génère une classe wrapper de trace qui peut être utilisée par le développeur de l’adaptateur pour fournir une instrumentation dans le code de l’adaptateur.
Pour plus d’informations sur le suivi WCF, consultez Traçage.
Pour plus d’informations sur l’analyse des traces dans WCF, consultez Service Trace Viewer Tool (SvcTraceViewer.exe) .
Exemple de classe d’utilitaire Wrapper de trace
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;
}
}
}
La classe utilitaire précédente peut ensuite être utilisée par le développeur de l’adaptateur dans tout le code de l’adaptateur pour fournir des données d’instrumentation aux consommateurs de l’adaptateur.
EchoAdapterUtilities.Trace.Trace(System.Diagnostics.TraceEventType.Information, « EchoAdapterConnection ::Open », « Connexion correctement ouverte ! ») ;
Activer le suivi pour l’adaptateur et le runtime du Kit de développement logiciel (SDK) de l’adaptateur LOB WCF
Vous pouvez activer le suivi fourni dans le Kit de développement logiciel (SDK) de l’adaptateur LOB WCF en ajoutant la section suivante dans le fichier app.config de l’application à l’aide de l’adaptateur.
<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>
Vous pouvez utiliser l’élément add pour spécifier le nom et le type de l’écouteur de trace que vous souhaitez utiliser. Dans notre exemple de configuration, nous avons nommé l’écouteur « xmlTrace » et ajouté l’écouteur de trace .NET Framework standard (System.Diagnostics.XmlWriterTraceListener) comme type que nous voulons utiliser. Vous pouvez ajouter un nombre quelconque d'écouteurs de suivi pour chaque source. Par exemple, dans les exemples suivants, nous avons également ajouté un autre écouteur nommé « textTrace » qui utilise l’écouteur de trace .NET Framework System.Diagnostics.TextWriterTraceListener. Si l'écouteur de suivi émet le suivi dans un fichier, vous devez spécifier le nom et l'emplacement du fichier de sortie dans le fichier de configuration. Pour ce faire, définissez initializeData sur le nom du fichier de cet écouteur.
Activation du suivi pour le plug-in Add Adapter Service Reference
Vous pouvez activer le suivi pour ce plug-in en ajoutant la section suivante dans le fichier devenv.exe.config situé dans \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>
Activer le suivi pour le complément Consume Adapter Service
Vous pouvez activer le suivi pour ce complément en ajoutant la section suivante dans le fichier BTSNTSVC.exe.config situé dans \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>