Compartir a través de

Cómo habilitar el seguimiento en BAM

  • Artículo

Es posible habilitar el seguimiento en BAM para contribuir a la resolución de problemas en los siguientes cinco componentes de BAM:

  • Utilidad de administración de BAM

  • Bus de eventos BAM

  • Portal de BAM

  • Alertas de BAM

  • Interceptor de WCF de BAM

Habilitar el seguimiento de la utilidad de administración de BAM

La habilitación del seguimiento de la utilidad de administración de BAM permite obtener información sobre errores de implementación. Existen dos maneras de hacerlo: se puede habilitar el seguimiento de comandos de BM.exe específicos a través de la línea de comandos, o bien se 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.

Usar la línea de comandos

BM.exe seguimiento de línea de comandos se activa mediante el modificador -Trace:on|off . Al utilizar el conmutador Trace, se invalidan las opciones del archivo de configuración.

El conmutador se utiliza junto con cualquier comando normal de BM.exe.

Por ejemplo:

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

Usar el archivo de configuración

Puede habilitar el seguimiento modificando el archivo de configuración de BM.exe.config ubicado en la carpeta \Program Files (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. El seguimiento no está habilitado de forma predeterminada.

<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>

-->

Habilitar el seguimiento del bus de eventos BAM

La habilitación del seguimiento del bus de eventos BAM puede ayudar a diagnosticar dos clases de errores de almacenamiento en la base de datos:

  • Errores de almacenamiento derivados de eventos del servicio de BizTalk Server al utilizar el Editor de perfiles de seguimiento.

  • Errores de almacenamiento generados al utilizar las API de secuencias de eventos almacenadas 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 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 existen en el archivo, copie el código que figura arriba y péguelo en el archivo de configuración.

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

  4. Guarde el archivo.

Habilitar el seguimiento del Portal de BAM

La habilitación del seguimiento del portal de BAM permite solucionar los problemas relacionados con la conectividad.

El portal de BAM es una aplicación ASP.NET y sigue el protocolo estándar en lo que respecta al 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. Quite la marca de comentario de la sección de diagnóstico del sistema moviendo el delimitador de comentario final ("-->") de después de la <etiqueta /system.diagnostics> a antes de la <etiqueta system.diagnostics> .

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

  5. Busque <system.web> tag.

  6. En la sección system.web, busque la etiqueta de seguimiento y quite la marca de comentario del comando trace moviendo el delimitador ("-->") desde después de la etiqueta de seguimiento a 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

La habilitación del seguimiento de las alertas de BAM ayuda a solucionar los errores relacionados con la entrega de las 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 Notification Services 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>

Los interceptores de BAM para Windows Workflow Foundation y Windows Communication Foundation se escriben en el origen denominado "Microsoft BizTalk Bam Interceptors".

Nota

La cadena de origen hace distinción entre mayúsculas y minúsculas y debe aparecer exactamente como se muestra. Si la cadena es distinta a la que se muestra, no recibirá información de seguimiento correspondiente a los interceptores de BAM.

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

Nivel de seguimiento Descripción
Crítico Registra las entradas Fail-Fast y Event Log, además de realizar el seguimiento de la información de correlación.
Error Registra todas las excepciones.
Advertencia Existe una condición que puede generar un error o un error crítico posteriormente.
Información Se han generado mensajes útiles para supervisar y diagnosticar el estado del sistema, medir el rendimiento o perfilar. Puede utilizar esa información para el diseño de la capacidad y la gestión del rendimiento.
Verbose Seguimiento de nivel de depuración para el código de usuario y el servicio.
Todo Todos los mensajes.

Nota

El seguimiento puede afectar de forma negativa al rendimiento. Actívelo únicamente cuando realice actividades relacionadas con la solución de problemas.

Ver el archivo de seguimiento de WCF

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

Consulte también

Administración de BAM