Vue d'ensemble du flux de messages

Article
05/10/2023

Dans un système distribué contenant des services interconnectés, il est nécessaire de déterminer les relations de causalité entre les services. Il est important de comprendre les différents composants faisant partie d'un flux de demandes pour prendre en charge des scénarios critiques, tels que le contrôle d'état, la résolution des problèmes et l'analyse de la cause première. Pour activer la corrélation des suivis entre différents services, la prise en prendre en charge des fonctionnalités suivantes a été ajoutée dans .NET Framework 4 :

Traçage analytique : fonctionnalité de suivi très performante et à faible niveau de commentaires à l’aide du suivi d’événements Windows (ETW).
Modèle d'activité de bout en bout pour les services WCF/WF : cette fonctionnalité prend en charge la corrélation des suivis générés par les espaces de noms System.ServiceModel et System.Workflow.ComponentModel.
Suivi ETW pour WF : cette fonctionnalité utilise les enregistrements de suivi générés par les services WF pour offrir plus de visibilité dans l’avancement et l’état actuel du workflow.

Les erreurs enregistrées dans un enregistrement de suivi peuvent être utilisées pour rechercher les erreurs de code ou les messages qui ne sont pas correctement formés. La propriété ActivityId du nœud Correlation dans l'en-tête de message de l'événement peut être utilisée pour déterminer l'activité générant une erreur. Pour activer le suivi du flux de messages, consultez Configuration du suivi de flux de messages. Cette rubrique montre comment activer le suivi de flux de messages dans le projet créé dans le didacticiel Mise en route.

Pour activer le suivi de flux de messages dans le didacticiel Mise en route

Ouvrez l’Observateur d’événements en cliquant sur Démarrer, puis sur Exécuter, puis en entrant eventvwr.exe.
Si vous n’avez pas activé le suivi analytique, développez Journaux des applications et des services, Microsoft, Windows et Serveur d’applications - Applications. Sélectionnez Afficher et Afficher les journaux d’analyse et de débogage. Cliquez avec le bouton droit sur Analytique et sélectionnez Activer le journal. Laissez l'Observateur d'événements ouvert pour visualiser les suivis.
Dans Visual Studio 2012, ouvrez l’exemple créé dans le tutoriel de démarrage. Notez que vous devez exécuter Visual Studio 2012 en tant qu’administrateur pour pouvoir créer le service. Si les exemples WCF sont installés, vous pouvez ouvrir le tutoriel de démarrage, qui contient le projet terminé qui a été créé dans le tutoriel.
Cliquez avec le bouton droit sur le projet Service, pointez sur Ajouter, puis sélectionnez Nouvel élément. Sélectionnez Fichier de configuration de l’application, puis cliquez sur OK.

Ajoutez le code suivant au fichier App.Conf créé à l'étape précédente.

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

Exécutez l'application serveur sans déboguer en appuyant sur Ctrl+F5. Exécutez le projet client en cliquant avec le bouton droit sur le projet Client et en sélectionnant Débogage, puis Démarrer une nouvelle instance.
Pour suivre les événements du client vers le serveur, ajoutez le code suivant au fichier de configuration de l'application dans le projet Client.
```
<diagnostics>
  <endToEndTracing propagateActivity="true" messageFlowTracing="true"/>
</diagnostics>
```
Dans le fichier Program.cs du projet client, ajoutez la directive using suivante.
```
using System.Diagnostics;
```
Dans la méthode Main du fichier program.cs du projet client, définissez le GUID Trace à propager dans le journal des événements.
```
Guid guid = Guid.NewGuid();
Trace.CorrelationManager.ActivityId = guid;
```
Activez et consultez le journal Analytique. Recherchez un événement présentant l'ID 220. Sélectionnez l’événement et cliquez sur l’onglet Détails dans le volet d’aperçu. Cet événement contiendra l'ID de corrélation pour l'activité appelante.
```
<Correlation ActivityID="{A066CCF1-8AB3-459B-B62F-F79F957A5036}" />
```
Notes

Tous les événements ayant le même GUID dans l'ActivityID sont liés à une seule demande. Il peut être utilisé pour mettre en corrélation les messages d'un client spécifique avec un service spécifique. Si le client a appelé un autre service, ce même client peut être identifié par ActivityID.
Dans certains cas, l'ActivityID peut varier du GUID d'origine au nouvel ActivityID. Le cas échéant, un événement de transfert est émis. Cet événement porte l'ID 499 et contiendra les données suivantes dans l'en-tête.
```
<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>
```
Notes

L'événement de transfère enregistre la modification de l'ActivityID actif du GUID spécifié en tant qu'ActivityID dans le GUID spécifié comme RelatedActivityID. Une fois l'événement de transfert émis, tous les événements contiendront le nouveau GUID en tant qu'ActivityID.

Partager via

Vue d'ensemble du flux de messages

Pour activer le suivi de flux de messages dans le didacticiel Mise en route

Ressources supplémentaires