Traccia del flusso di lavoro

  • Articolo

La traccia del flusso di lavoro consente di acquisire informazioni diagnostiche usando i listener di traccia di .NET Framework. La traccia può essere abilitata in seguito al rilevamento di un problema con l'applicazione, quindi nuovamente disabilitata quando il problema viene risolto. Sono disponibili due modi per abilitare la traccia di debug per i flussi di lavoro: è possibile configurarla usando il visualizzatore di Traccia eventi oppure usare l'oggetto System.Diagnostics per inviare eventi di traccia a un file.

Abilitazione della traccia di debug in ETW

Per abilitare la traccia tramite ETW, abilitare il canale Debug in Visualizzatore eventi:

  1. Passare al nodo dei registri analitici e di debug in Visualizzatore eventi.

  2. Nella visualizzazione struttura ad albero del Visualizzatore eventi passare a Visualizzatore eventi->Registri applicazioni e servizi->Microsoft->Windows->Application Server-Applications. Fare clic con il pulsante destro del mouse su Application Server-Applications e scegliere Visualizza->Visualizza registri analitici e di debug. Fare clic con il pulsante destro del mouse su Debug e scegliere Abilita log.

  3. Quando un flusso di lavoro esegue il debug e le tracce vengono create nel canale di debug ETW, queste ultime possono essere visualizzate in Visualizzatore eventi. Passare a Visualizzatore eventi->Registri applicazioni e servizi->Microsoft->Windows->Application Server-Applications. Fare clic con il pulsante destro del mouse su Debug e scegliere Aggiorna.

  4. La dimensione del buffer di traccia analitica predefinita è solo 4 kilobyte (KB). Si consiglia di aumentare la dimensione a 32 KB. A questo scopo, eseguire i passaggi seguenti.

    1. Eseguire il comando seguente nella directory del framework corrente (ad esempio, C:\Windows\Microsoft.NET\Framework\v4.0.21203): wevtutil um Microsoft.Windows.ApplicationServer.Applications.man

    2. Impostare su 32 il valore di <bufferSize> nel file Windows.ApplicationServer.Applications.man.

      <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. Eseguire il comando seguente nella directory del framework corrente (ad esempio, C:\Windows\Microsoft.NET\Framework\v4.0.21203): wevtutil im Microsoft.Windows.ApplicationServer.Applications.man

Nota

Se si usa .NET Framework 4 Client Profile, è necessario registrare innanzitutto il manifesto ETW eseguendo il comando seguente dalla directory di .NET Framework 4: ServiceModelReg.exe –i –c:etw

Abilitazione della traccia di debug tramite l'oggetto System.Diagnostics

Questi listener possono essere configurati nel file App.config dell'applicazione flusso di lavoro o nel file Web.config per un servizio flusso di lavoro. In questo esempio viene configurato un oggetto TextWriterTraceListener per salvare le informazioni sulla traccia nel file MyTraceLog.txt nella directory corrente.

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

Vedi anche