Nachverfolgen eines Adapters mit dem WCF LOB Adapter SDK

Artikel
10/14/2023

Die WCF LOB-Adapter-SDK-Ablaufverfolgung basiert auf Systems.Diagnostics. Sie verwenden die Ablaufverfolgungsquelle Microsoft.ServiceModel.Channels für die WCF LOB Adapter SDK-Runtime. Sie verwenden die Ablaufverfolgungsquelle Microsoft.ServiceModel.Channels.Tools.MetadataSearchBrowse zum Hinzufügen des Adapterdienstverweis-Plug-Ins und Zum Verwenden des Adapterdienst-Add-Ins. WCF-Ablaufverfolgungen werden in die Quelle system.ServiceModel geschrieben.

Der Adapterentwickler kann mithilfe der Microsoft.ServiceModel.Channels.Common.AdapterTrace-Klasse einen Namen der Ablaufverfolgungsquelle für den Adapter bereitstellen. Der Adapterentwicklungs-Assistent generiert eine Ablaufverfolgungs-Wrapperklasse, die vom Adapterentwickler verwendet werden kann, um Instrumentierung im Adaptercode bereitzustellen.

Informationen zur WCF-Ablaufverfolgung finden Sie unter Ablaufverfolgung.

Informationen zum Analysieren von Ablaufverfolgungen in WCF finden Sie unter Service Trace Viewer Tool (SvcTraceViewer.exe).

Beispielklasse des Ablaufverfolgungs-Wrappers

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

Die vorherige Hilfsprogrammklasse kann dann vom Adapterentwickler im gesamten Adaptercode verwendet werden, um Instrumentierungsdaten für die Adapterverbraucher bereitzustellen.

EchoAdapterUtilities.Trace.Trace(System.Diagnostics.TraceEventType.Information, "EchoAdapterConnection::Open", "Verbindung erfolgreich geöffnet!");

Aktivieren der Ablaufverfolgung für die Adapter- und WCF LOB Adapter SDK-Runtime

Sie können die im WCF LOB Adapter SDK bereitgestellte Ablaufverfolgung aktivieren, indem Sie den folgenden Abschnitt in der app.config-Datei der Anwendung mithilfe des Adapters hinzufügen.

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

Sie können das add-Element verwenden, um den Namen und Den Typ des Ablaufverfolgungslisteners anzugeben, den Sie verwenden möchten. In unserer Beispielkonfiguration haben wir den Listener "xmlTrace" genannt und den Standard .NET Framework Ablaufverfolgungslistener (System.Diagnostics.XmlWriterTraceListener) als den typ hinzugefügt, den wir verwenden möchten. Sie können jeder Quelle beliebig viele Ablaufverfolgungslistener hinzufügen. In den folgenden Beispielen haben wir beispielsweise auch einen weiteren Listener namens "textTrace" hinzugefügt, der den .NET Framework Ablaufverfolgungslistener System.Diagnostics.TextWriterTraceListener verwendet. Wenn der Ablaufverfolgungslistener die Ablaufverfolgung an eine Datei ausgibt, müssen Sie den Speicherort der Ausgabedatei angeben und sie in der Konfigurationsdatei benennen. Hierzu legen Sie initializeData auf den Namen der Datei für diesen Listener fest.

Aktivieren der Ablaufverfolgung für das Add Adapter Service Reference Plug-In

Sie können die Ablaufverfolgung für dieses Plug-In aktivieren, indem Sie den folgenden Abschnitt in der devenv.exe.config Datei in \Program Files (x86)\Microsoft Visual Studio\Common7\IDEhinzufügen.

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

Aktivieren der Ablaufverfolgung für das Add-In "Adapterdienst nutzen"

Sie können die Ablaufverfolgung für dieses Add-In aktivieren, indem Sie den folgenden Abschnitt in der BTSNTSVC.exe.config Datei hinzufügen, die sich in \Program Files (x86)\Microsoft BizTalk Serverbefindet.

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

Weitere Informationen

Problembehandlung beim Erstellen eines Adapters mit dem WCF LOB Adapter SDK

Freigeben über