Eventi di rilevamento in Traccia eventi per Windows

Articolo
04/10/2024

L'esempio EtwTracking illustra come abilitare il rilevamento di Windows Workflow Foundation in un servizio flusso di lavoro e creare gli eventi di rilevamento in ETW (Event Trace for Windows). Per creare record di rilevamento del flusso di lavoro in ETW, nell'esempio viene usato il partecipante del rilevamento ETW (EtwTrackingParticipant).

Il flusso di lavoro nell'esempio riceve una richiesta, assegna il reciproco dei dati di input alla variabile di input e restituisce di nuovo il reciproco al client. Quando i dati di input sono pari a 0, si verifica un'eccezione di divisione per zero non gestita che causa l'interruzione del flusso di lavoro. Con il rilevamento abilitato, il record di rilevamento errori viene creato in ETW consentendo la risoluzione dell'errore in un secondo momento. Il partecipante del rilevamento ETW viene configurato con un profilo di rilevamento per sottoscrivere i record di rilevamento. Il profilo di rilevamento viene definito nel file Web.config e fornito come parametro di configurazione al partecipante del rilevamento ETW. Quest'ultimo viene configurato nel file Web.config del servizio flusso di lavoro e viene applicato al servizio come comportamento del servizio. In questo esempio gli eventi di rilevamento vengono visualizzati nel registro eventi tramite Visualizzatore eventi.

Dettagli relativi al rilevamento del flusso di lavoro

Windows Workflow Foundation fornisce un'infrastruttura di rilevamento per rilevare l'esecuzione di un'istanza del flusso di lavoro. L'esecuzione del rilevamento crea un'istanza del flusso di lavoro per generare eventi correlati al ciclo di vita del flusso di lavoro, eventi dalle attività del flusso di lavoro ed eventi personalizzati. Nella tabella seguente sono indicati in dettaglio i componenti primari dell'infrastruttura di rilevamento.

Componente	Descrizione
Esecuzione del rilevamento	Fornisce l'infrastruttura per la creazione dei record di rilevamento.
Partecipanti del rilevamento	Accede ai record di rilevamento. .NET Framework 4.6.1 viene fornito con un partecipante del rilevamento che scrive record di rilevamento come eventi ETW (Event Trace for Windows).
Profilo di rilevamento	Meccanismo di filtro che consente a un partecipante del rilevamento di sottoscrivere un subset dei record di rilevamento creati da un'istanza del flusso di lavoro.

Nella tabella seguente vengono indicati in dettaglio i record di rilevamento creati dall'esecuzione del flusso di lavoro.

Record di rilevamento	Descrizione
Record di rilevamento dell'istanza del flusso di lavoro.	Descrivono il ciclo di vita dell'istanza del flusso di lavoro. Ad esempio un record di istanza viene creato quando viene avviato o completato il flusso di lavoro.
Record di rilevamento dello stato dell'attività.	Illustrano in dettaglio l'esecuzione dell'attività. Questi record indicano lo stato di un'attività del flusso di lavoro, ad esempio quando un'attività viene pianificata, quando viene completata o quando viene generato un errore.
Record di ripresa del segnalibro.	Generato quando viene ripreso un segnalibro all'interno di un'istanza del flusso di lavoro.
Record di rilevamento personalizzati.	Un autore del flusso di lavoro può creare record di rilevamento personalizzati e generarli all'interno dell'attività personalizzata.
ActivityScheduledRecord	Questo record viene creato quando un'attività pianifica un'altra attività.
FaultPropagationRecord	Questo record viene creato quando un errore viene propagato da un'attività.
CancelRequestedRecord	Questo record viene creato quando un'attività viene annullata da un'altra attività.

Il partecipante del rilevamento sottoscrive un subset dei record di rilevamento creati usando profili di rilevamento. Un profilo di rilevamento contiene query di rilevamento che consentono la sottoscrizione di un particolare tipo di record di rilevamento. I profili di rilevamento possono essere specificati nel codice o nella configurazione.

Per usare questo esempio

In Visual Studio aprire il file della soluzione EtwTrackingParticipantSample.sln.
Per compilare la soluzione, premere CTRL+MAIUSC+B.
Per eseguire la soluzione, premere F5.

Per impostazione predefinita, il servizio è in ascolto sulla porta 53797 (http://localhost:53797/SampleWorkflowService.xamlx).
In Esplora file aprire il client di test WCF.

Il client di test WCF (WcfTestClient.exe) si trova nella cartella <cartella di installazione di Visual Studio>\Common7\IDE\.

La cartella di installazione di Visual Studio predefinita è C:\Programmi\Microsoft Visual Studio 10.0.
Nel client di test WCF scegliere Aggiungi servizio dal menu File.

Aggiungere l'indirizzo dell'endpoint nella casella di input. Il valore predefinito è http://localhost:53797/SampleWorkflowService.xamlx.
Aprire l'applicazione Visualizzatore eventi.

Prima di richiamare il servizio, avviare il Visualizzatore eventi dal menu Start, selezionare Esegui e digitare eventvwr.exe. Assicurarsi che il registro eventi sia in ascolto di eventi di rilevamento creati dal servizio flusso di lavoro.
Nella visualizzazione struttura ad albero del Visualizzatore eventi passare a Visualizzatore eventi, Registri applicazioni e servizi, Microsoft. Fare clic con il pulsante destro del mouse su Microsoft e scegliere Visualizza, quindi Visualizza registri analitici e di debug per abilitare i registri analitici e di debug.

Assicurarsi che l'opzione Visualizza registri analitici e di debug sia selezionata.
Nella visualizzazione struttura ad albero nel Visualizzatore eventi passare a Visualizzatore eventi, Registri applicazioni e servizi, Microsoft, Windows, Application Server-Applications. Fare clic con il pulsante destro del mouse su Analitico e scegliere Abilita log per abilitare il log Analitico.
Eseguire il test del servizio tramite il client di prova WCF facendo doppio clic su GetData.

Verrà visualizzato il metodo GetData. La richiesta accetta un parametro e assicura che il valore sia 0, ovvero l'impostazione predefinita.

Fare clic su Richiama.
Osservare gli eventi creati dal flusso di lavoro.

Tornare al Visualizzatore eventi e passare a Visualizzatore eventi, Registri applicazioni e servizi, Microsoft, Windows, Application Server-Applications. Fare clic con il pulsante destro del mouse su Analitico e scegliere Aggiorna.

Gli eventi del flusso di lavoro vengono visualizzati nel visualizzatore eventi. Si noti che vengono visualizzati gli eventi di esecuzione del flusso di lavoro e che uno di questi è un'eccezione non gestita che corrisponde all'errore nel flusso di lavoro. Inoltre, viene creato un evento di avviso dall'attività del flusso di lavoro indicante che l'attività sta generando un errore.
Ripetere i passaggi 9 e 10 con un input di dati diverso da 0, in modo che non venga generato alcun errore.

I profili di rilevamento consentono di sottoscrivere gli eventi creati dall'esecuzione quando lo stato di un'istanza del flusso di lavoro viene modificato. A seconda dei requisiti di monitoraggio, è possibile creare un profilo molto generico che sottoscrive un piccolo set di modifiche dello stato di alto livello in un flusso di lavoro. D'altra parte, è possibile creare un profilo molto preciso il cui output è dettagliato abbastanza per ricostruire l'esecuzione in un secondo momento. Nell'esempio vengono illustrati gli eventi creati dall'esecuzione del flusso di lavoro in ETW usando l'oggetto HealthMonitoring Tracking Profile che crea un piccolo set di eventi. Un profilo diverso che crea più eventi di rilevamento del flusso di lavoro viene fornito anche nel file Web.config denominato Troubleshooting Tracking Profile. Quando viene installato .NET Framework 4.6.1, un profilo predefinito con un nome vuoto viene configurato nel file Machine.config. Questo profilo viene usato dalla configurazione del comportamento di rilevamento ETW quando non viene specificato alcun nome di profilo né un nome di profilo vuoto.

Il profilo di rilevamento del monitoraggio dell'integrità crea record di istanza del flusso di lavoro e record di propagazione degli errori di attività. Questo profilo viene creato aggiungendo il profilo di rilevamento seguente a un file di configurazione Web.config.

<tracking>
  <profiles>
    <trackingProfile name="HealthMonitoring Tracking Profile">
      <workflow activityDefinitionId="*">
        <workflowInstanceQueries>
          <workflowInstanceQuery>
            <states>
              <state name="Started"/>
              <state name="Completed"/>
              <state name="Aborted"/>
              <state name="UnhandledException"/>
            </states>
          </workflowInstanceQuery>
        </workflowInstanceQueries>
        <faultPropagationQueries>
          <faultPropagationQuery faultSourceActivityName ="*" faultHandlerActivityName="*"/>
        </faultPropagationQueries>
      </workflow>
    </trackingProfile>
  </profiles>
</tracking>

Il profilo può essere modificato impostando la configurazione EtwTrackingParticipant sugli elementi seguenti.

<behaviors>
  <serviceBehaviors>
    <behavior>
      <etwTracking profileName="HealthMonitoring Tracking Profile"/>
    </behavior>
  </serviceBehaviors>
</behaviors>

Per eseguire la pulizia (facoltativo)

Aprire il Visualizzatore eventi.
Passare a Visualizzatore eventi, Registri applicazioni e servizi, Microsoft, Windows, Application Server-Applications. Fare clic con il pulsante destro del mouse su Analitico e scegliere Disabilita log.
Passare a Visualizzatore eventi, Registri applicazioni e servizi, Microsoft, Windows, Application Server-Applications. Fare clic con il pulsante destro del mouse su Analitico e scegliere Cancella log.
Scegliere l'opzione Cancella per cancellare gli eventi.

Problema noto

Nota

Nel Visualizzatore eventi potrebbe non essere possibile decodificare gli eventi ETW. Si potrebbe visualizzare un messaggio di errore simile al seguente.

Impossibile trovare la descrizione dell'ID evento <id> dall'origine Microsoft-Windows-Application Server-Applications. Il componente che genera questo evento non è installato nel computer locale o l'installazione è danneggiata. È possibile installare o riparare il componente nel computer locale.

Se si rileva questo errore, fare clic su Aggiorna nel riquadro Azioni. La decodifica dell'evento dovrebbe ora essere eseguita in modo corretto.

Vedi anche

Esempi di monitoraggio di AppFabric

Condividi tramite