Seguimiento de diagnóstico y registro de mensajes para el adaptador de base de datos de Oracle

Artículo
07/21/2023

El seguimiento de diagnóstico ayuda a diagnosticar de forma eficaz los problemas que se pueden encontrar al usar los adaptadores. En este tema se proporciona información sobre los dos tipos siguientes de seguimiento admitidos con el adaptador de Microsoft BizTalk para oracle Database:

Seguimiento de WCF entre el cliente del adaptador y el adaptador
Seguimiento de WCF dentro del adaptador

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 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, 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 información más buena.

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 base de datos de Oracle.

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 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.OracleDB" 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. Consulte Uso del Visor de seguimiento 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 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. La administración de artefactos incluye más información.

Consulte también

Solución de problemas del adaptador de base de datos de Oracle

Compartir a través de