Übersicht über den Nachrichtenfluss

In einem verteilten System mit untereinander verbundenen Diensten müssen kausale Beziehungen zwischen den Diensten bestimmt werden. Es ist unerlässlich, die verschiedenen Komponenten eines Anforderungsflusses zu verstehen, wenn kritische Szenarien wie Systemüberwachung, Fehlerbehebung und Fehlerursachenanalyse unterstützt werden sollen. Um eine Korrelation der Ablaufverfolgungen verschiedener Dienste zu ermöglichen, wurde in .NET Framework 4 eine entsprechende Unterstützung über folgende Funktionen hinzugefügt:

• Analytische Ablaufverfolgung: Hierbei handelt es sich um eine Ablaufverfolgungsfunktion mit hoher Leistung und geringer Ausführlichkeit, die auf der Ereignisablaufverfolgung für Windows (Event Tracing for Windows, ETW) aufbaut.

• End-to-End-Aktivitätsmodell für WCF/WF-Dienste: Diese Funktion unterstützt die Korrelation von Ablaufverfolgungen, die vom System.ServiceModel-Namespace und vom System.Workflow.ComponentModel-Namespace generiert wurden.

• ETW-Nachverfolgung für WF: Diese Funktion verwendet Überwachungsdatensätze, die von WF-Diensten generiert wurden, um einen Überblick über den aktuellen Status und Fortschritt eines bestimmten Workflows zu geben.

Anhand der in einem Überwachungs- oder Ablaufverfolgungsdatensatz protokollierten Fehler können Codefehler oder fehlerhaft formatierte Nachrichten aufgefunden werden. Mit der ActivityId-Eigenschaft des Knotens Korrelation im Nachrichtenheader des Ereignisses kann die Aktivität ermittelt werden, die den Fehler verursacht hat. Weitere Informationen zur Aktivierung der Ablaufverfolgung des Nachrichtenflusses nach Aktivitäts-ID finden Sie unter Konfigurieren der Ablaufverfolgung des Nachrichtenflusses. In diesem Thema wird veranschaulicht, wie die Ablaufverfolgung des Nachrichtenflusses im Projekt aktiviert wird, das im Lernprogramm "Erste Schritte" erstellt wurde.

So aktivieren Sie die Ablaufverfolgung des Nachrichtenflusses im Lernprogramm "Erste Schritte"

1. Öffnen Sie die Ereignisanzeige, indem Sie auf Start und Ausführen klicken und dann eventvwr.exe eingeben.

2. Wenn Sie die analytische Ablaufverfolgung nicht aktiviert haben, erweitern Sie Anwendungs- und Dienstprotokolle, Microsoft, Windows und Anwendungsserver - Anwendungen. Wählen Sie Ansicht und Analytische und Debugprotokolle einblenden aus. Klicken Sie mit der rechten Maustaste auf Analytisch, und wählen Sie Protokoll aktivieren aus. Lassen Sie die Ereignisanzeige geöffnet, damit die Ablaufverfolgungen eingesehen werden können.

3. Öffnen Sie das Beispiel, das im Tutorial: Erste Schritte mit Windows Communication Foundation-Anwendungen in Visual Studio 2012 erstellt wurde. Beachten Sie, dass Sie Visual Studio 2012 als Administrator ausführen müssen, um den Dienst erstellen zu können. Wenn Sie die WCF-Beispiele installiert haben, können Sie das Beispiel 'Erste Schritte' öffnen, das das vollständige im Tutorial erstellte Projekt enthält.

4. Klicken Sie mit der rechten Maustaste auf das Projekt Service, und wählen Sie Hinzufügen sowie Neues Element aus. Wählen Sie Anwendungskonfigurationsdatei aus, und klicken Sie auf OK.

5. Fügen Sie der im vorherigen Schritt erstellten Datei App.Config den folgenden Code hinzu.

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

6. Führen Sie die Serveranwendung ohne Debuggen aus, indem Sie STRG+F5 drücken. Führen Sie das Clientprojekt aus, indem Sie mit der rechten Maustaste auf das Projekt Client klicken und anschließend Debuggen sowie Neue Instanz starten auswählen.

7. Um die Ereignisse vom Client zum Server zu verfolgen, fügen Sie der Anwendungskonfigurationsdatei im Projekt Client Folgendes hinzu.

   <diagnostics>
     <endToEndTracing propagateActivity="true" messageFlowTracing="true"/>
   </diagnostics>
   

8. Fügen Sie in Program.cs im Client die folgende using-Direktive hinzu.

   using System.Diagnostics;
   

9. Legen Sie in der Main-Methode in der Datei program.cs im Clientprojekt die Ablaufverfolgungs-GUID fest, die im Ereignisprotokoll weitergegeben werden soll.

   Guid guid = Guid.NewGuid();
   Trace.CorrelationManager.ActivityId = guid;
   

10. Aktualisieren und überprüfen Sie das Protokoll Analytisch. Suchen Sie nach einem Ereignis mit der Ereignis-ID 220. Wählen Sie das Ereignis aus, und klicken Sie im Vorschaubereich auf die Registerkarte Details. Dieses Ereignis enthält die Korrelations-ID für die aufrufende Aktivität.

    <Correlation ActivityID="{A066CCF1-8AB3-459B-B62F-F79F957A5036}" />
    

    Hinweis

    Alle Ereignisse mit derselben GUID in der ActivityID beziehen sich auf eine Anforderung. Damit können Nachrichten von einem bestimmten Client mit einem bestimmten Dienst korreliert werden. Wenn der Client einen anderen Dienst aufgerufen hat, kann der Client anhand der ActivityID identifiziert werden.

11. Gelegentlich kann die ActivityID von der ursprünglichen GUID in eine neue ActivityID geändert werden. In diesem Fall wird ein Übertragungsereignis ausgegeben. Diese Ereignis-ID lautet 499, und das Ereignis enthält die folgenden Daten im Header.

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

    Hinweis

    Im Übertragungsereignis wird die Änderung der aktiven ActivityID von der als ActivityID angegebenen GUID in die GUID aufgezeichnet, die als RelatedActivityID angegeben ist. Nach Ausgabe des Übertragungsereignisses enthalten sämtliche Ereignisse die neue GUID als ActivityID.