Seguimiento de un adaptador con el SDK del adaptador de LOB de WCF

Artículo
07/21/2023

El seguimiento del SDK del adaptador de LOB de WCF se basa en Systems.Diagnostics. Use el origen de seguimiento Microsoft.ServiceModel.Channels para el entorno de ejecución del SDK del adaptador de LOB de WCF. Use microsoft.ServiceModel.Channels.Tools.MetadataSearchBrowse trace source for Add Adapter Service Reference Plug-in and Consum Adapter Service Add-in Add.Adapter Service Add-in. Los seguimientos de WCF se escriben en el origen denominado System.ServiceModel.

El desarrollador del adaptador puede proporcionar un nombre de origen de seguimiento para el adaptador mediante la clase Microsoft.ServiceModel.Channels.Common.AdapterTrace. El Asistente para desarrollo de adaptadores genera una clase contenedora de seguimiento que el desarrollador del adaptador puede usar para proporcionar instrumentación en el código del adaptador.

Para obtener información sobre el seguimiento de WCF, vea Seguimiento.

Para obtener información sobre el análisis de seguimientos en WCF, vea Service Trace Viewer Tool (SvcTraceViewer.exe)).

Sample Trace Wrapper Utility (Clase de utilidad)

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

Después, el desarrollador del adaptador puede usar la clase de utilidad anterior en todo el código del adaptador para proporcionar datos de instrumentación para los consumidores del adaptador.

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

Habilitación del seguimiento para el adaptador y el entorno de ejecución del SDK del adaptador de LOB de WCF

Puede habilitar el seguimiento proporcionado en el SDK del adaptador de LOB de WCF agregando la siguiente sección en el archivo app.config de la aplicación mediante el adaptador.

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

Puede usar el elemento add para especificar el nombre y el tipo del agente de escucha de seguimiento que desea usar. En nuestra configuración de ejemplo, llamamos al agente de escucha "xmlTrace" y agregamos el agente de escucha de seguimiento estándar de .NET Framework (System.Diagnostics.XmlWriterTraceListener) como el tipo que queremos usar. Puede agregar cualquier número de escuchas de seguimiento para cada origen. Por ejemplo, en los ejemplos siguientes, también se ha agregado otro agente de escucha denominado "textTrace" que usa el agente de escucha de seguimiento de .NET Framework System.Diagnostics.TextWriterTraceListener. Si la escucha de seguimiento emite el seguimiento a un archivo, debe especificar la ubicación del archivo de salida y el nombre en el archivo de configuración. Esto se hace estableciendo initializeData en el nombre del archivo para ese agente de escucha.

Habilitación del seguimiento para el complemento Agregar referencia de servicio de adaptador

Para habilitar el seguimiento de este complemento, agregue la sección siguiente en el archivo devenv.exe.config ubicado en \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>

Habilitar el seguimiento para el complemento Consumir servicio de adaptador

Para habilitar el seguimiento de este complemento, agregue la sección siguiente en el archivo BTSNTSVC.exe.config ubicado en \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>

Consulte también

Solución de problemas del adaptador creado mediante el SDK del adaptador de LOB de WCF

Compartir a través de