Compartir a través de

Cómo habilitar el seguimiento en BAM

Puede habilitar el seguimiento en BAM para ayudar a solucionar problemas dentro de los cinco componentes de BAM siguientes:

  • Utilidad de administración de BAM

  • Bus de eventos de BAM

  • Portal de BAM

  • Alertas de BAM

  • BAM WCF Interceptor

Habilitación del seguimiento para la utilidad de administración de BAM

Puede obtener información sobre los errores de implementación habilitando el seguimiento de la utilidad de administración de BAM. Puede hacerlo de dos maneras. Puede habilitar el seguimiento a través de la línea de comandos para comandos de BM.exe específicos, o puede modificar el archivo de configuración de la utilidad de administración de BAM para habilitar el seguimiento de todos los comandos de BM.exe.

Uso de la línea de comandos

El seguimiento de la línea de comandos BM.exe se activa mediante el modificador -Trace:on|off. El uso del modificador Trace invalida la configuración en el archivo de configuración.

El interruptor se usa junto con cualquier comando BM.exe normal.

Por ejemplo:

bm.exe deploy-all -DefinitionFile:PO.xml –Trace:On

Uso del archivo de configuración

Puede habilitar el seguimiento modificando el archivo de configuración de BM.exe.config ubicado en la carpeta \Archivos de programa (x86)\Microsoft BizTalk Server <VERSION>Tracking. Este archivo contiene una sección system.diagnostics que contiene los elementos de seguimiento. Quite el comentario para habilitar el seguimiento. De forma predeterminada, el seguimiento no está habilitado.

<system.diagnostics>

<!-- To turn on BAM tracing, remove this comment or use the "-trace:on" command-line switch

<switches>

<add name="bm" value="1" />

<add name="Microsoft.BizTalk.Bam.Management" value="1" />

</switches>

-->

Habilitando el seguimiento para el bus de eventos de BAM

Habilitar el seguimiento para el bus de eventos bam puede ayudarle a diagnosticar dos clases de errores de almacenamiento de base de datos:

  • Errores de almacenamiento que se originan en eventos del servicio BizTalk Server al usar el Editor de perfiles de seguimiento.

  • Errores de almacenamiento generados al usar las API de flujo de eventos almacenados en búfer.

    Para habilitar el seguimiento del bus de eventos bam, edite o agregue la siguiente sección del archivo BTSNTSvc.exe.config ubicado en la carpeta \Archivos de programa (x86)\Microsoft BizTalk Server <VERSION> .

    <system.diagnostics>

    <switches>

    <add name="Microsoft.BizTalk.Bam.EventBus" value="1" />

    </switches>

    <trace autoflush="true" indentsize="4">

    <listeners>

    <add name="Text" type="System.Diagnostics.TextWriterTraceListener" initializeData="c:\tdds.log"/>

    </listeners>

    </trace>

    </system.diagnostics>

Para habilitar el seguimiento del bus de eventos de BAM

  1. Edite el archivo \Archivos de programa (x86)\Microsoft BizTalk Server <VERSION>BTSNTSvc.exe.config.

  2. Busque la <etiqueta system.diagnostics> y </system.diagnostics> . Si no están presentes en el archivo, copie el código enumerado anteriormente y péguelo en el archivo de configuración.

  3. Descomentar la sección de diagnósticos del sistema moviendo el delimitador de comentario final ("-->") de después de la etiqueta </system.diagnostics> a antes de la etiqueta <system.diagnostics>.

  4. Guarde el archivo.

Habilitación del seguimiento para el portal de BAM

Habilitar el seguimiento para el portal de BAM le permite solucionar problemas de conectividad.

El portal de BAM es una aplicación ASP.NET y sigue el protocolo estándar para el seguimiento. En el archivo \Archivos de programa (x86)\Microsoft BizTalk Server <VERSION>BAMPortal\web.config, hay una sección denominada <seguimiento> que puede habilitar.

Para habilitar el seguimiento del portal de BAM

  1. Edite el archivo \Archivos de programa (x86)\Microsoft BizTalk Server <VERSION>BAMPortal\web.config.

  2. Busque las <etiquetas system.diagnostics> y </system.diagnostics> .

  3. Descomente la sección de diagnósticos del sistema moviendo el delimitador de comentario final ('-->') desde después de la etiqueta </system.diagnostics> a antes de la etiqueta <system.diagnostics>.

  4. Modifique el atributo initializeData para especificar la ubicación para escribir el registro de seguimiento.

  5. Busque la etiqueta <system.web>.

  6. En la sección system.web, busque la etiqueta de seguimiento y descomente el comando trace moviendo el delimitador que está después de la etiqueta de seguimiento hacia antes de ella.

  7. Guarde el archivo.

    <!--

    TRACING: To turn tracing on:

    1) Uncomment this tag and specify a file path for trace output

    2) Uncomment the <trace tag> under <system.web>

    The trace will be saved to the file pointed to by "initializeData" below.

    Ensure that the target directory exists (C:\temp by default).

    Make sure that the IIS worker process user account (usually Network Service or ASPNET)

    and the BAM Portal user have write permissions for the trace log file directory (C:\temp below).

    To turn tracing on, you will need to uncomment the <trace> tag under <system.web>

    <system.diagnostics>

    <trace autoflush="true" indentsize="2">

    <listeners>

    <add name="BAMPortalListener"

    type="System.Diagnostics.TextWriterTraceListener"

    initializeData="C:\temp\BAMPortalTrace.log" />

    </listeners>

    </trace>

    </system.diagnostics>

    -->

    <!--

    TRACING: To turn tracing on:

    1) Uncomment this tag

    2) Uncomment the <system.diagnostics> tag above and specify a file path for trace output

    <trace enabled="true"

    requestLimit="40"

    pageOutput="false"

    traceMode="SortByTime"

    localOnly="true"

    writeToDiagnosticsTrace="true" />

    -->

Alertas de BAM

Habilitar el seguimiento para las alertas de BAM le ayuda a solucionar errores de entrega de alertas.

Las alertas de BAM se basan en la infraestructura de SQL Server Notification Services. Para habilitar el seguimiento en las alertas de BAM, consulte los temas de solución de problemas de los Servicios de Notificación en https://go.microsoft.com/fwlink/?LinkId=79416.

Interceptores de BAM

Para habilitar el seguimiento de un extremo a otro de los interceptores de BAM, modifique el archivo de configuración de la aplicación, ya sea Web.config para aplicaciones hospedadas en web o Appname.config para aplicaciones autohospedados. A continuación se muestra un ejemplo de cómo puede modificar el archivo:

<system.diagnostics>
  </sources>
    <source name="Microsoft BizTalk Bam Interceptors" switchValue="All">
      <listeners>

        <add name="myListener"
             type="System.Diagnostics.TextWriterTraceListener"
             initializeData="TextWriterOutput.log" />
      </listeners>
    </source>
  </sources>
</system.diagnostics>

El interceptor de BAM para Windows Workflow Foundation y Windows Communication Foundation se escribe en el origen denominado "Microsoft BizTalk Bam Interceptors".

Nota:

La cadena de origen distingue mayúsculas de minúsculas y debe aparecer exactamente como se muestra. Si la cadena es diferente de la que se muestra, no recibirá información de seguimiento para los interceptores de BAM.

Para controlar el nivel de seguimiento, establezca switchValue. Los niveles de seguimiento disponibles se resumen en la tabla siguiente.

Nivel de seguimiento Descripción
Crítico Registros Fail-Fast y entradas del registro de eventos, e información de correlación de trazas.
Error Registra todas las excepciones.
Advertencia Existe una condición que puede provocar posteriormente un error o un error crítico.
Información Se generan mensajes útiles para supervisar y diagnosticar el estado del sistema, medir el rendimiento o generar la generación de perfiles. Puede usar esta información para la planificación de la capacidad y la administración del rendimiento.
Verboso Seguimiento de nivel de depuración tanto para el código de usuario como para el servicio.
Todos Todos los mensajes.

Nota:

El seguimiento puede afectar negativamente al rendimiento. Habilitar solo el seguimiento cuando se realizan actividades de solución de problemas.

Visualización del archivo de seguimiento de WCF

Para analizar el seguimiento de WCF, use la herramienta Visor de seguimiento del servicio WCF. Para obtener más información sobre la herramienta Visor de seguimiento de servicio, vea https://go.microsoft.com/fwlink/?LinkId=75218.

Véase también

Administración de BAM