Seguimiento de diagnóstico y registro de mensajes en el adaptador de Oracle E-Business Suite
El seguimiento de diagnóstico ayuda a diagnosticar de forma eficaz los problemas que pueden surgir al usar los adaptadores. En este tema se proporciona información sobre los tres tipos siguientes de seguimiento admitidos con el adaptador de Microsoft BizTalk para Oracle E-Business Suite:
Seguimiento del lado servidor de Oracle mediante un identificador de cliente
Seguimiento de WCF entre el cliente del adaptador y el adaptador
Seguimiento de WCF dentro del adaptador
Seguimiento del lado servidor de Oracle mediante un identificador de cliente
Oracle le permite realizar el seguimiento del lado servidor para las operaciones realizadas por las aplicaciones cliente en la base de datos de Oracle. Dado que las solicitudes de las aplicaciones cliente se pueden enrutar a diferentes sesiones de base de datos, resulta difícil realizar un seguimiento del origen de la solicitud. Sin embargo, Oracle facilita el seguimiento de aplicaciones de un extremo a otro mediante identificadores de cliente.
El adaptador de Oracle E-Business expone la OracleConnectionClientId propiedad de enlace que permite especificar el identificador de cliente en tiempo de diseño de la conexión utilizada por el adaptador para conectarse a Oracle. El identificador de cliente del adaptador le ayuda a realizar un seguimiento selectivo de las operaciones realizadas por el cliente del adaptador en Oracle y también permite filtrar y ver los seguimientos del servidor de Oracle en función del identificador de cliente. Para obtener información sobre cómo puede habilitar el seguimiento de identificadores de cliente en Oracle, consulte https://go.microsoft.com/fwlink/p/?LinkId=135746.
Seguimiento de WCF 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 de servicio de adaptador, consumir complemento de servicio de 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 de devenv.exe.config ubicado en <la unidad> de instalación:\Archivos de programa\Microsoft Visual Studio <versión>\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 <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. El seguimiento de WCF proporciona más información.
Importante
Asegúrese de mitigar las posibles amenazas de seguridad de exponer datos empresariales confidenciales que se pueden producir al habilitar el seguimiento. Para obtener recomendaciones, consulte los procedimientos recomendados para el seguimiento de datos de instancias y mensajes.
Seguimiento de WCF 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 de servicio de adaptador, consumir complemento de servicio de 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 de devenv.exe.config ubicado en <la unidad> de instalación:\Archivos de programa\Microsoft Visual Studio <versión>\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 2006 R2, este archivo está disponible normalmente en <unidad> de instalación:\Archivos de programa\Microsoft BizTalk Server 2006. Para BizTalk Server, este archivo está disponible normalmente en <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.OracleEBS" 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
Puedes usar la herramienta Visor de seguimiento del servicio Windows Communication Foundation (WCF) para ver los seguimientos. El uso del Visor de seguimientos de servicio para ver los seguimientos correlacionados y la solución de problemas proporciona más detalles sobre esta herramienta.
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 le 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, consulte Administración y seguimiento de los artefactos.
También puede usar el Concentrador de grupos para ver los datos de instancia y mensajes de seguimiento, incluidos los procedimientos recomendados, guardar consultas de seguimiento, etc.