Seguimiento de diagnóstico y registro de mensajes para el adaptador de Siebel
Los clientes del adaptador pueden habilitar el seguimiento de diagnóstico para diagnosticar eficazmente los problemas detectados al usar los adaptadores. Los clientes del adaptador pueden activar el seguimiento en tres niveles diferentes:
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 de las XCL de entrada procedentes del cliente del adaptador mediante el modelo de servicio WCF y resulta ú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, debe agregar 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. El seguimiento de WCF proporciona más información.
Importante
Asegúrese de mitigar las posibles amenazas de seguridad de exponer datos empresariales confidenciales habilitando el seguimiento. Consulte Procedimientos recomendados para proteger el adaptador de Siebel.
Seguimiento dentro del adaptador
Los adaptadores del paquete de adaptadores de BizTalk registran diferentes categorías de información útil para el archivo de seguimiento, como errores, advertencias e 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, debe agregar 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.Siebel" 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 guardaría los seguimientos de WCF en C:\log\AdapterTrace.svclog.
Seguimiento entre el adaptador y la aplicación lob
Debe habilitar el seguimiento para la comunicación entre el adaptador y la aplicación loB para diagnosticar problemas sospechosos en la aplicación loB. Los adaptadores también dependen del seguimiento de LOB (cliente o servidor) para obtener acceso a esta información. Los detalles de activar el seguimiento de LOB se excluyen de este documento.
Además, el adaptador de Siebel proporciona una propiedad de enlace (LogData), que si se establece en True y si el nivel de seguimiento se establece en Verbose, el adaptador de Siebel registra el flujo de información entre el adaptador y el sistema Siebel. Esta información se registra junto con los seguimientos del adaptador en el mismo archivo de seguimiento.
Para obtener más información sobre esta propiedad de enlace, vea Leer sobre el adaptador de BizTalk para propiedades de enlace de Siebel.
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 seguimientos de servicio para ver seguimientos correlacionados y solución de problemas.
Configuración del seguimiento de aplicaciones de BizTalk
La Consola de administración de BizTalk le permite configurar varias opciones de seguimiento para cosas como puertos de envío, puertos de recepción. Las opciones de configuración de seguimiento permiten realizar un seguimiento de los datos de eventos entrantes o 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 Administrar artefactos.
También puede usar el centro de grupos para ver los datos de instancia y mensajes de seguimiento, incluida una lista de comprobación de seguimiento y procedimientos recomendados.