Seguimiento de diagnóstico y registro de mensajes en el adaptador de SQL
El seguimiento de diagnóstico ayuda a diagnosticar de forma eficaz los problemas que se pueden encontrar al usar los adaptadores. Los clientes del adaptador pueden activar el seguimiento de diagnóstico en dos niveles:
Entre el cliente del adaptador y el adaptador
Dentro del adaptador
En esta sección se proporciona información sobre cómo activar el seguimiento en estos niveles.
Seguimiento entre el cliente del adaptador y el adaptador
Los clientes del adaptador pueden habilitar el seguimiento de WCF para realizar un seguimiento de los problemas entre el cliente del adaptador y el adaptador. El seguimiento de WCF se usa para realizar un seguimiento del XML de entrada que procede del cliente del adaptador mediante el modelo de servicio WCF y es útil para diagnosticar problemas de serialización. El seguimiento de WCF no se usa para el modelo de canal WCF ni para los mensajes de salida del adaptador al cliente del adaptador. Puede activar el seguimiento de WCF para aplicaciones de BizTalk y aplicaciones de modelo de servicio WCF agregando un extracto a los archivos de configuración respectivos. Además, puede habilitar el seguimiento en tiempo de diseño y en tiempo de ejecución.
Seguimiento en tiempo de diseño. Para la experiencia en tiempo de diseño, puede usar el complemento Agregar referencia del servicio adaptador, consumir complemento de servicio adaptador o el Asistente para agregar metadatos del adaptador. Todas estas herramientas se pueden usar desde Visual Studio. Por lo tanto, para habilitar el seguimiento de la experiencia en tiempo de diseño, debe agregar el extracto al archivo devenv.exe.config ubicado en <la unidad> de instalación:\Archivos de programa\Microsoft Visual Studio <version>\Common7\IDE.
Seguimiento en tiempo de ejecución. Para el seguimiento en tiempo de ejecución, debe agregar el extracto en función de la aplicación que use.
Para una aplicación de BizTalk Server, debe agregar el extracto al archivo de configuración de BizTalk, normalmente BTSNTSvc.exe.config. Para BizTalk Server, este archivo está disponible normalmente en <la unidad> de instalación:\Archivos de programa\Microsoft BizTalk Server.
Para una aplicación .NET del modelo de servicio WCF, debe agregar el extracto al archivo app.config del proyecto.
Para habilitar el seguimiento de WCF, agregue el siguiente extracto dentro de la
<configuration>etiqueta .
<system.diagnostics>
<sources>
<source name ="System.ServiceModel" switchValue="Verbose">
<listeners>
<add name="xml" />
</listeners>
</source>
<source name ="System.ServiceModel.MessageLogging"
switchValue="Verbose, ActivityTracing">
<listeners>
<add name="xml" />
</listeners>
</source>
<source name ="System.Runtime.Serialization" switchValue="Verbose">
<listeners>
<add name="xml" />
</listeners>
</source>
</sources>
<sharedListeners>
<add name="xml" type="System.Diagnostics.XmlWriterTraceListener"
traceOutputOptions="LogicalOperationStack"
initializeData="C:\log\WCFTrace.svclog" />
</sharedListeners>
<trace autoflush="true" />
</system.diagnostics>
<system.serviceModel>
<diagnostics>
<messageLogging
logEntireMessage="true"
logMalformedMessages="false"
logMessagesAtServiceLevel="true"
logMessagesAtTransportLevel="false"/>
</diagnostics>
</system.serviceModel>
Esto guarda los seguimientos de WCF en C:\log\WCFTrace.svclog. Para obtener más información sobre el seguimiento de WCF, vea Seguimiento.
Importante
Asegúrese de mitigar las posibles amenazas de seguridad de exponer datos empresariales confidenciales habilitando el seguimiento. Para obtener recomendaciones, consulte Procedimientos recomendados para proteger el adaptador de SQL.
Seguimiento dentro del adaptador
Los adaptadores registran diferentes categorías de información útil para el archivo de seguimiento, como errores, advertencias y mensajes de información. Esta información es útil para comprender el flujo de proceso dentro del adaptador y diagnosticar problemas con el adaptador. Puede activar el SDK del adaptador de LOB de WCF y el seguimiento de adaptadores para aplicaciones de BizTalk y aplicaciones de modelo de servicio WCF agregando un extracto a los archivos de configuración respectivos. Además, puede habilitar el seguimiento en tiempo de diseño y en tiempo de ejecución.
Seguimiento en tiempo de diseño. Para la experiencia en tiempo de diseño, puede usar el complemento Agregar referencia del servicio adaptador, consumir complemento de servicio adaptador o el Asistente para agregar metadatos del adaptador. Todas estas herramientas se pueden usar desde Visual Studio. Por lo tanto, para habilitar el seguimiento de la experiencia en tiempo de diseño, debe agregar el extracto al archivo devenv.exe.config ubicado en <la unidad> de instalación:\Archivos de programa\Microsoft Visual Studio <version>\Common7\IDE.
Seguimiento en tiempo de ejecución. Para el seguimiento en tiempo de ejecución, debe agregar el extracto en función de la aplicación que use.
Para una aplicación de BizTalk Server, debe agregar el extracto al archivo de configuración de BizTalk, normalmente BTSNTSvc.exe.config. Para BizTalk Server, este archivo está disponible normalmente en <la unidad> de instalación:\Archivos de programa\Microsoft BizTalk Server.
Para una aplicación .NET del modelo de servicio WCF, debe agregar el extracto al archivo app.config del proyecto.
Para habilitar el SDK del adaptador de LOB de WCF y el seguimiento del adaptador, agregue el siguiente extracto dentro de la
<configuration>etiqueta .
<system.diagnostics>
<sources>
<source name="Microsoft.ServiceModel.Channels" switchValue="Error">
<listeners>
<add name="xml" />
</listeners>
</source>
<source name="Microsoft.Adapters.Sql" switchValue="Information">
<listeners>
<add name="xml" />
</listeners>
</source>
</sources>
<sharedListeners>
<add name="xml" type="System.Diagnostics.XmlWriterTraceListener"
traceOutputOptions="LogicalOperationStack"
initializeData="C:\log\AdapterTrace.svclog" />
</sharedListeners>
<trace autoflush="true" />
</system.diagnostics>
Esto guarda los seguimientos de WCF en C:\log\AdapterTrace.svclog.
Visualización de los seguimientos
Puede usar la herramienta Visor de seguimiento de servicio de Windows Communication Foundation (WCF) para ver los seguimientos. Para obtener más información sobre la herramienta, consulte Uso del Visor de seguimiento de servicio para ver seguimientos correlacionados y problemas.
Configuración del seguimiento de aplicaciones de BizTalk
La consola de administración de BizTalk Server permite configurar varias opciones de seguimiento para elementos como puertos de envío y puertos de recepción. Las opciones de configuración de seguimiento permiten realizar un seguimiento de los datos de eventos entrantes y salientes, las propiedades del mensaje, los cuerpos de los mensajes y las orquestaciones. Para obtener más información sobre cómo configurar el seguimiento de las aplicaciones de BizTalk, vea Managing Artifacts(Administrar artefactos).
También puede usar el seguimiento de actividad y mantenimiento (HAT) para ver datos históricos o de seguimiento. Para obtener más información, consulte Visualización de datos históricos y de seguimiento.