WCF-Dienste und Ereignisablaufverfolgung für Windows

In diesem Beispiel wird gezeigt, wie die analytische Ablaufverfolgung von Windows Communication Foundation (WCF) verwendet wird, um Ereignisse in der Ereignisablaufverfolgung für Windows (ETW) auszugeben. Die analytische Ablaufverfolgung besteht aus Ereignissen, die an Schlüsselpunkten im WCF-Stapel ausgegeben werden und die Problembehandlung der WCF-Dienste in der Produktionsumgebung zulassen.

Die analytische Ablaufverfolgung in WCF ist eine Methode der Ablaufverfolgung, die in einer Produktionsumgebung mit minimalen Auswirkungen auf die Leistung aktiviert werden kann. Diese Ablaufverfolgungen werden als Ereignisse zu einer ETW-Sitzung ausgegeben.

Dieses Beispiel enthält einen grundlegenden WCF-Dienst, in dem Ereignisse vom Dienst an das Ereignisprotokoll ausgegeben werden. Dieses kann mit der Ereignisanzeige angezeigt werden. Es ist auch möglich, eine dedizierte ETW-Sitzung zu starten, die Ereignisse des WCF-Diensts überwacht. Das Beispiel enthält ein Skript zum Erstellen einer dedizierten ETW-Sitzung, in der Ereignisse in einer Binärdatei gespeichert werden, die mithilfe der Ereignisanzeige gelesen werden kann.

So verwenden Sie dieses Beispiel

1. Öffnen Sie mit Visual Studio 2010 die EtwAnalyticTraceSample.sln-Projektmappendatei.

2. Drücken Sie F6, um die Projektmappe zu erstellen.

3. Drücken Sie STRG+F5, um die Projektmappe auszuführen.

   Klicken Sie im Webbrowser auf Calculator.svc. Der URI des WSDL-Dokuments für den Dienst wird daraufhin im Browser angezeigt. Kopieren Sie diesen URI.

   Standardmäßig beginnt der Dienst damit, Anforderungen auf Port 1378 (https://localhost:1378/Calculator .svc) zu überwachen.

4. Führen Sie den WCF-Testclient (WcfTestClient.exe) aus.

   Der WCF-Testclient (WcfTestClient.exe) befindet sich unter <Visual Studio 2010-Installationsverzeichnis>\Common7\IDE\ WcfTestClient.exe (das Standardinstallationsverzeichnis von Visual Studio 2010 ist C:\Programme\Microsoft Visual Studio 10.0).

5. Fügen Sie im WCF-Testclient den Dienst hinzu, indem Sie Datei und dann Dienst hinzufügen auswählen.

   Fügen Sie die Endpunktadresse im Eingabefeld hinzu. Die Standardadresse ist https://localhost:1378/Calculator.svc.

6. Öffnen Sie die Ereignisanzeige.

   Starten Sie vor dem Aufrufen des Diensts die Ereignisanzeige, und stellen Sie sicher, dass das Ereignisprotokoll eine Überwachung für von WCF ausgegebene Überwachungsereignisse ausführt.

7. Wählen Sie aus dem Menü Start die Option Verwaltung und dann Ereignisanzeige aus. Aktivieren Sie die Protokolle Analytisch und Debuggen.

8. Navigieren Sie in der Strukturansicht der Ereignisanzeige zu Ereignisanzeige, Anwendungs- und Dienstprotokolle, Microsoft, Windows und dann zu Anwendungsserver-Anwendungen. Klicken Sie mit der rechten Maustaste auf Anwendungsserver-Anwendungen, und wählen Sie Ansicht und danach Analytische und Debugprotokolle einblenden aus.

   Stellen Sie sicher, dass die Option Analytische und Debugprotokolle einblenden aktiviert ist.

9. Aktivieren Sie das Protokoll Analytisch.

   Navigieren Sie in der Strukturansicht der Ereignisanzeige zu Ereignisanzeige, Anwendungs- und Dienstprotokolle, Microsoft, Windows und dann zu Anwendungsserver-Anwendungen. Klicken Sie mit der rechten Maustaste auf Analytisch, und wählen Sie Protokoll aktivieren aus.

So testen Sie den Dienst

1. Wechseln Sie zurück zum WCF-Testclient, doppelklicken Sie auf Divide, und behalten Sie die Standardwerte bei, die als Nenner 0 angeben.

   Wenn der Nenner 0 ist, löst der Dienst einen Fehler aus.

2. Beachten Sie die vom Dienst ausgegebenen Ereignisse.

   Wechseln Sie zurück zur Ereignisanzeige, und navigieren Sie zu Ereignisanzeige, Anwendungs- und Dienstprotokolle, Microsoft, WCF und dann zu WF-Entwicklung. Klicken Sie mit der rechten Maustaste auf Analytisch, und wählen Sie Aktualisieren aus.

   Die analytischen Ablaufverfolgungsereignisse in WCF werden in der Ereignisanzeige angezeigt. Beachten Sie, dass ein Fehler als Ablaufverfolgungsereignis in der Ereignisanzeige angezeigt wird, da ein Fehler vom Dienst ausgelöst wurde.

3. Wiederholen Sie Schritt 1 und 2 mit gültigen Eingaben. Der Wert des N2-Parameters kann eine beliebige Zahl außer 0 sein.

   Aktualisieren Sie den analytischen Kanal, um die WCF-Ereignisse anzuzeigen, wobei keine Fehlerereignisse vorhanden sind.

Im Beispiel werden die von einem WCF-Dienst ausgegebenen analytischen Ablaufverfolgungsereignisse veranschaulicht.

So führen Sie eine (optionale) Bereinigung durch

1. Öffnen Sie die Ereignisanzeige.

2. Navigieren Sie zu Ereignisanzeige, Anwendungs- und Dienstprotokolle, Microsoft, Windows, Anwendungsserver-Anwendungen. Klicken Sie mit der rechten Maustaste auf Analytisch, und wählen Sie Protokoll deaktivieren aus.

3. Navigieren Sie zu Ereignisanzeige, Anwendungs- und Dienstprotokolle, Microsoft, Windows, Anwendungsserver-Anwendungen. Klicken Sie mit der rechten Maustaste auf Analytisch, und wählen Sie Protokoll löschen aus.

4. Wählen Sie die Option Löschen aus, um die Ereignisse zu löschen.

Hinweis:

Die Beispiele sind möglicherweise bereits auf dem Computer installiert. Überprüfen Sie das folgende (standardmäßige) Verzeichnis, bevor Sie fortfahren. <Installationslaufwerk>:\WF_WCF_Samples Wenn dieses Verzeichnis nicht vorhanden ist, rufen Sie Windows Communication Foundation (WCF) and Windows Workflow Foundation (WF) Samples for .NET Framework 4 auf, um alle Windows Communication Foundation (WCF)- und WF-Beispiele herunterzuladen. Dieses Beispiel befindet sich im folgenden Verzeichnis. <Installationslaufwerk>:\WF_WCF_Samples\WCF\Basic\Management\ETWTracing