Traza del flujo de trabajo

Este tema es aplicable a Windows Workflow Foundation 4.

La traza del flujo de trabajo ofrece una forma de capturar la información de diagnóstico con los agentes de escucha de seguimiento de .NET Framework. Se puede habilitar la traza si se detecta un problema con la aplicación y se deshabilita de nuevo una vez resuelto el problema. Hay dos maneras de poder habilitar la traza de depuración para los flujos de trabajo. Puede configurarlo con el visor del seguimiento de eventos o puede usar System.Diagnostics para enviar los eventos de seguimiento a un archivo.

Habilitar la traza de depuración en ETW

Para habilitar la traza mediante ETW, habilite el canal de depuración en el visor de eventos:

1. Desplácese hasta el nodo de registros analíticos y de depuración en el visor de eventos.

2. En la vista de árbol del visor de eventos, desplácese hasta Visor de eventos ->Registros de aplicaciones y servicios->Microsoft ->Windows ->Servidor de aplicaciones-Aplicación. Haga clic con el botón secundario en Servidor de aplicaciones-Aplicación y seleccione Ver->Mostrar registros analíticos y de depuración. Haga clic con el botón secundario en Depuración y seleccione Habilitar registro.

3. Cuando un flujo de trabajo ejecuta la depuración y los seguimientos se emiten en el canal de depuración de ETW, se pueden ver en el Visor de eventos. Desplácese hasta Visor de eventos ->Registros de aplicaciones y servicios->Microsoft ->Windows ->Aplicaciones de servidor-Aplicaciones. Haga clic con el botón secundario en Depuración y seleccione Actualizar.

4. El tamaño predeterminado del búfer de traza analítica es solo de 4 kilobytes (KB); se recomienda aumentar el tamaño a 32 KB. Para ello, realice los pasos siguientes.

   1. Ejecute el siguiente comando en el directorio de .NET Framework actual (por ejemplo, C:\Windows\Microsoft.NET\Framework\v4.0.21203): wevtutil um Microsoft.Windows.ApplicationServer.Applications.man

   2. Cambie el valor de <bufferSize> del archivo Windows.ApplicationServer.Applications.man a 32.

      <channel name="Microsoft-Windows-Application Server-Applications/Analytic" chid="ANALYTIC_CHANNEL" symbol="ANALYTIC_CHANNEL" type="Analytic" enabled="false" isolation="Application" message="$(string.MICROSOFT_WINDOWS_APPLICATIONSERVER_APPLICATIONS.channel.ANALYTIC_CHANNEL.message)" >
                  <publishing>
                    <bufferSize>32</bufferSize>
                  </publishing>
                </channel>
      

   3. Ejecute el siguiente comando en el directorio de .NET Framework actual (por ejemplo, C:\Windows\Microsoft.NET\Framework\v4.0.21203): wevtutil im Microsoft.Windows.ApplicationServer.Applications.man

Nota:
Si está utilizando .NET Framework 4 Client Profile, en primer lugar debe registrar el manifiesto ETW ejecutando el siguiente comando desde el directorio de .NET Framework 4: ServiceModelReg.exe –i –c:etw

Habilitar la traza de depuración con N:System.Diagnostics

Se pueden configurar estos agentes de escucha en el archivo App.config de la aplicación de flujo de trabajo o Web.config para un servicio del flujo de trabajo. En este ejemplo, se configura TextWriterTraceListener para guardar la información de traza en el archivo MyTraceLog.txt del directorio actual.

<configuration>
  <system.diagnostics>
    <sources>
      <source name="System.Activities" switchValue="Information">
        <listeners>
          <add name="textListener" />
          <remove name="Default" />
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="textListener"
           type="System.Diagnostics.TextWriterTraceListener"
           initializeData="MyTraceLog.txt"
           traceOutputOptions="ProcessId, DateTime" />
    </sharedListeners>
    <trace autoflush="true" indentsize="4">
      <listeners>
        <add name="textListener" />
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>