Cenni preliminari sul flusso di messaggi

Articolo
06/08/2024

In un sistema distribuito che contiene servizi interconnessi è necessario determinare relazioni causali tra i servizi. È importante comprendere i vari componenti che appartengono a un flusso di richiesta per supportare scenari critici, ad esempio monitoraggio dello stato, risoluzione dei problemi e analisi della causa radice. Per abilitare la correlazione di tracce tra i vari servizi, in .NET Framework 4 è stato aggiunto supporto tramite le funzionalità seguenti:

Traccia analitica: funzionalità di traccia a prestazioni elevate e verbosità ridotta impostata in base a Event Tracing for Windows (ETW).
Modello di attività end-to-end per i servizi WCF/WF: questa funzionalità supporta la correlazione di tracce generate dagli spazi dei nomi System.ServiceModel e System.Workflow.ComponentModel.
Rilevamento ETW per WF: questa funzionalità usa record di rilevamento generati dai servizi WF per fornire visibilità nello stato corrente e in quello di avanzamento del flusso di lavoro.

Gli errori registrati in un record di rilevamento o di traccia possono essere usati per individuare difetti del codice o messaggi in formato non corretto. La proprietà ActivityId del nodo relativo alla correlazione nell'intestazione del messaggio dell'evento può essere usata per determinare l'attività in cui si è verificato l'errore. Per abilitare la traccia del flusso di messaggi in base all'ID attività, vedere Configurazione della traccia del flusso di messaggi. In questo argomento viene illustrato come abilitare la traccia del flusso di messaggi nel progetto creato nell'Esercitazione introduttiva.

Per abilitare la traccia del flusso di messaggi nell'Esercitazione introduttiva

Fare clic sul pulsante Start, scegliere Esegui, quindi immettere eventvwr.exe per aprire il Visualizzatore eventi.
Se la traccia analitica non è stata abilitata, espandere Registri applicazioni e servizi, Microsoft, Windows, Server applicazioni-Applicazioni. Selezionare Visualizza, Visualizza registri analitici e di debug. Fare clic con il pulsante destro del mouse su Analitico e scegliere Abilita log. Lasciare aperto il Visualizzatore eventi in modo che sia possibile visualizzare le tracce.
Aprire l'esempio creato nell'esercitazione introduttiva in Visual Studio 2012. Si noti che è necessario eseguire Visual Studio 2012 come amministratore in modo che sia possibile creare il servizio. Se gli esempi WCF sono installati, sarà possibile aprire la Guida introduttiva contenente il progetto completato creato nell'esercitazione.
Fare clic con il pulsante destro del mouse sul progetto Service, quindi scegliere Aggiungi, Nuovo elemento. Selezionare il modello File di configurazione dell'applicazione, quindi fare clic su OK.

Aggiungere il codice seguente al file App.Config creato nel passaggio precedente.

<system.serviceModel>
  <diagnostics>
    <endToEndTracing propagateActivity="true" messageFlowTracing="true"/>
  </diagnostics>
</system.serviceModel>

Premere CTRL+F5 per eseguire l'applicazione server senza debug. Fare clic con il pulsante destro del mouse sul progetto Client, quindi scegliere Debug, Avvia nuova istanza per eseguire il progetto client.
Per tracciare gli eventi dal client al server, aggiungere il codice seguente al file di configurazione dell'applicazione nel progetto Client.
```
<diagnostics>
  <endToEndTracing propagateActivity="true" messageFlowTracing="true"/>
</diagnostics>
```
In Program.cs nel client aggiungere la direttiva seguente using .
```
using System.Diagnostics;
```
Main Nel metodo nel file program.cs nel progetto client impostare il GUID di traccia da propagare nel registro eventi.
```
Guid guid = Guid.NewGuid();
Trace.CorrelationManager.ActivityId = guid;
```
Aggiornare ed esaminare il registro Analitico. Cercare gli eventi con ID evento 220. Selezionare l'evento, quindi fare clic sulla scheda Dettagli nel riquadro di anteprima. Questo evento conterrà l'ID di correlazione per l'attività chiamante.
```
<Correlation ActivityID="{A066CCF1-8AB3-459B-B62F-F79F957A5036}" />
```
Nota

Tutti gli eventi con stesso GUID in ActivityID sono correlati a una richiesta. In questo modo è possibile correlare messaggi tra un client e un servizio specifici. Se il client ha chiamato un altro servizio, lo stesso client potrebbe essere identificato da ActivityID.
In alcuni casi l'elemento ActivityID può essere modificato dal GUID originale in un nuovo ActivityID. In questo caso viene generato un evento di trasferimento. L'ID evento è 499 e l'evento conterrà i dati seguenti nell'intestazione.
```
<Event xmlns="http://schemas.microsoft.com/win/2004/08/events/event">
    <System>
        <Provider Name="Microsoft-Windows-Application Server-Applications" Guid="{c651f5f6-1c0d-492e-8ae1-b4efd7c9d503}" />
        <EventID>499</EventID>
        ...
        <Correlation ActivityID="{A066CCF1-8AB3-459B-B62F-F79F957A5036}" RelatedActivityID="{85FC0930-9C49-42DA-804B-A7368104BD1B}" />
        ...
   </System>
</Event>
```
Nota

L'evento di trasferimento registra la modifica dell'elemento ActivityID attivo dal GUID specificato come ActivityID al GUID specificato come RelatedActivityID. Dopo che l'evento di trasferimento viene generato, tutti gli eventi conterranno il nuovo GUID come elemento ActivityID.

Condividi tramite

Cenni preliminari sul flusso di messaggi

Per abilitare la traccia del flusso di messaggi nell'Esercitazione introduttiva

Risorse aggiuntive