Seguimiento de diagnóstico y registro de mensajes para el adaptador de SAP
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 tres niveles:
Entre el cliente del adaptador y el adaptador
Dentro del adaptador
Entre el adaptador y la aplicación de línea de negocio (LOB)
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 BizTalk Server aplicaciones, 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 SAP.
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 BizTalk Server aplicaciones, 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.SAP" 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.
Seguimiento entre el adaptador y la aplicación lob
Para diagnosticar problemas que sospecha que están relacionados con la aplicación loB, debe habilitar el seguimiento para la comunicación entre el adaptador y la aplicación loB. Los adaptadores también dependen del seguimiento de LOB (cliente o servidor) para acceder a esta información. El adaptador de SAP permite a los clientes del adaptador activar el seguimiento en el sistema SAP especificando el parámetro "RfcSdkTrace" en el URI de conexión. Debe especificar este parámetro para permitir que el SDK de RFC realice un seguimiento del flujo de información en el sistema SAP. Para más información sobre el URI de conexión, consulte Creación del URI de conexión del sistema SAP.
Además, también puede crear una variable de entorno de RFC_TRACE que establezca el nivel de seguimiento para el SDK de RFC. RFC_TRACE es una variable de entorno definida por SAP y la usa el SDK de RFC. Si esta variable no está definida o se establece en 0, el nivel de seguimiento del SDK de RFC es mínimo. Si la variable se establece en 1 o 2, el nivel de seguimiento es más detallado.
Nota
Independientemente de si se establece la variable de entorno RFC_TRACE, el seguimiento del SDK de RFC solo está habilitado si el parámetro "RfcSdkTrace" está establecido en true en el URI de conexión. El valor de esta variable de entorno rige únicamente el nivel de seguimiento del SDK de RFC. Si RfcSdkTrace se establece en true, los seguimientos del mensaje entre el adaptador y el sistema SAP se copian en la carpeta "system32" del equipo. Para guardar los seguimientos del SDK de RFC en otra ubicación, puede establecer la variable de entorno RFC_TRACE_DIR. Para más información sobre estas variables de entorno, consulte la documentación de SAP.
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.