Tracciare un adattatore con WCF LOB Adapter SDK

Articolo
10/14/2023

La traccia di WCF LOB Adapter SDK è basata su Systems.Diagnostics. Si usa l'origine di traccia Microsoft.ServiceModel.Channels per il runtime di WCF LOB Adapter SDK. Usare l'origine di traccia Microsoft.ServiceModel.Channels.Tools.MetadataSearchBrowse per aggiungere plug-in di riferimento al servizio adapter e utilizzare il componente aggiuntivo del servizio adapter. Le tracce WCF vengono scritte nell'origine denominata System.ServiceModel.

Lo sviluppatore dell'adattatore può fornire un nome di origine di traccia per l'adattatore usando la classe Microsoft.ServiceModel.Channels.Common.AdapterTrace. La Creazione guidata adapter genera una classe wrapper di traccia che può essere usata dallo sviluppatore dell'adattatore per fornire la strumentazione nel codice dell'adattatore.

Per informazioni sulla traccia WCF, vedere Traccia.

Per informazioni sull'analisi delle tracce in WCF, vedere Service Trace Viewer Tool (SvcTraceViewer.exe).

Classe di utilità Wrapper trace di esempio

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 di utilità precedente può quindi essere usata dallo sviluppatore dell'adattatore in tutto il codice dell'adattatore per fornire i dati di strumentazione per i consumer dell'adattatore.

EchoAdapterUtilities.Trace.Trace(System.Diagnostics.TraceEventType.Information, "EchoAdapterConnection::Open", "Connection successfully opened!");

Abilitare la traccia per l'adapter e il runtime dell'SDK dell'adapter LOB WCF

È possibile abilitare la traccia fornita in WCF LOB Adapter SDK aggiungendo la sezione seguente nel file app.config dell'applicazione usando l'adapter.

<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>

È possibile usare l'elemento add per specificare il nome e il tipo del listener di traccia che si desidera utilizzare. Nella configurazione di esempio è stato denominato "xmlTrace" del listener e aggiunto il listener di traccia standard di .NET Framework (System.Diagnostics.XmlWriterTraceListener) come tipo da usare. Per ogni origine di traccia è possibile aggiungere il numero desiderato di listener. Negli esempi seguenti, ad esempio, è stato aggiunto anche un altro listener denominato "textTrace" che usa il listener di traccia di .NET Framework System.Diagnostics.TextWriterTraceListener. Se il listener di traccia genera la traccia in un file, nel file di configurazione è necessario specificare il percorso e il nome del file di output. Questa operazione viene eseguita impostando initializeData sul nome del file per il listener.

Abilitazione della traccia per il plug-in aggiungi riferimento al servizio adapter

È possibile abilitare la traccia per questo plug-in aggiungendo la sezione seguente nel file devenv.exe.config che si trova in \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>

Abilitare la traccia per il componente aggiuntivo Consume Adapter Service

È possibile abilitare la traccia per questo componente aggiuntivo aggiungendo la sezione seguente nel file BTSNTSVC.exe.config che si trova in \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>

Vedere anche

Risolvere i problemi dell'adapter creato con WCF LOB Adapter SDK

Condividi tramite