Freigeben über

Nachverfolgen von Ereignissen in der Ereignisablaufverfolgung in Windows

  • Artikel

Dieses Thema gilt für Windows Workflow Foundation 4.

In diesem Beispiel wird veranschaulicht, wie die Windows Workflow Foundation (WF)-Nachverfolgung in einem Workflowdienst aktiviert und die Überwachungsereignisse in der Ereignisablaufverfolgung für Windows (ETW) ausgegeben werden. In dem Beispiel wird der ETW-Überwachungsteilnehmer (EtwTrackingParticipant) zur Ausgabe von Workflowüberwachungsdatensätzen in ETW verwendet.

Der Workflow in dem Beispiel erhält eine Anforderung, weist den Umkehrwert der Eingabedaten der Eingabevariablen zu und gibt den Umkehrwert an den Client zurück. Wenn die Eingabedaten 0 betragen, tritt eine nicht behandelte Ausnahme aufgrund einer Division durch 0 (null) auf, aufgrund der der Workflow abgebrochen wird. Wenn die Nachverfolgung aktiviert ist, wird der Fehlerdatensatz an ETW ausgegeben, sodass der Fehler später behoben werden kann. Der ETW-Überwachungsteilnehmer ist mit einem Überwachungsprofil konfiguriert, um Überwachungsdatensätze zu abonnieren. Das Überwachungsprofil ist in der Datei "Web.config" definiert und für den ETW-Überwachungsteilnehmer als Konfigurationsparameter bereitgestellt. Der ETW-Überwachungsteilnehmer ist in der Datei "Web.config" des Workflowdiensts konfiguriert und wird auf den Dienst als Dienstverhalten angewendet. In diesem Beispiel zeigen Sie die Überwachungsereignisse im Ereignisprotokoll mithilfe der Ereignisanzeige an.

Workflowüberwachungsdetails

Windows Workflow Foundation stellt eine Überwachungsinfrastruktur bereit, um die Ausführung einer Workflowinstanz nachzuverfolgen. Die Überwachungslaufzeit erstellt eine Workflowinstanz, um Ereignisse in Verbindung mit dem Workflowlebenszyklus, Ereignisse aus den Workflowaktivitäten sowie benutzerdefinierte Ereignissen auszugeben. In der folgenden Tabelle sind die primären Komponenten der Überwachungsinfrastruktur aufgeführt.

Komponente Beschreibung

Überwachungslaufzeit

Stellt die Infrastruktur bereit, um Überwachungsdatensätze auszugeben.

Überwachungsteilnehmer

Greift auf die Überwachungsdatensätze zu. .NET Framework 4 wird mit einem Überwachungsteilnehmer geliefert, der Überwachungsdatensätze als Ereignisse der Ereignisablaufverfolgung für Windows (ETW) schreibt.

Überwachungsprofil

Ein Filtermechanismus, der einem Überwachungsteilnehmer das Abonnieren einer Teilmenge der Überwachungsdatensätze ermöglicht, die von einer Workflowinstanz ausgegeben werden.

In der folgenden Tabelle sind die Überwachungsdatensätze aufgeführt, die von der Workflowlaufzeit ausgegeben werden.

Überwachungsdatensatz Beschreibung

Überwachungsdatensätze zur Workflowinstanz.

Beschreibt den Lebenszyklus der Workflowinstanz. Wenn der Workflow gestartet oder abgeschlossen wird, wird beispielsweise ein Instanzdatensatz ausgegeben.

Überwachungsdatensätze zum Aktivitätszustand.

Führen Einzelheiten zur Aktivitätsausführung auf. Diese Datensätze geben den Zustand einer Workflowaktivität an, z. B. wenn eine Aktivität geplant oder abgeschlossen wird oder wenn ein Fehler ausgelöst wird.

Datensatz zur Wiederaufnahme von Lesezeichen.

Wird immer dann ausgegeben, wenn ein Lesezeichen in einer Workflowinstanz wieder aufgenommen wird.

Benutzerdefinierte Überwachungsdatensätze.

Ein Workflowautor kann benutzerdefinierte Überwachungsdatensätze erstellen und in einer benutzerdefinierten Aktivität ausgeben.

ActivityScheduledRecord

Dieser Datensatz wird ausgegeben, wenn eine Aktivität eine andere Aktivität plant.

FaultPropagationRecord

Dieser Datensatz wird ausgegeben, wenn ein Fehler von einer Aktivität weitergegeben wird.

CancelRequestedRecord

Dieser Datensatz wird ausgegeben, wenn eine Aktivität von einer anderen Aktivität abgebrochen wird.

Der Überwachungsteilnehmer abonniert eine Teilmenge der ausgegebenen Überwachungsdatensätze mithilfe von Überwachungsprofilen. Ein Überwachungsprofil enthält Überwachungsabfragen, die das Abonnieren eines bestimmten Typs von Überwachungsdatensätzen ermöglichen. Überwachungsprofile können im Code oder in der Konfiguration angegeben werden.

So verwenden Sie dieses Beispiel

  1. Öffnen Sie die Projektmappendatei "EtwTrackingParticipantSample.sln" in Visual Studio 2010.

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

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

    Standardmäßig überwacht der Dienst Port 53797 (https://localhost:53797/SampleWorkflowService.xamlx).

  4. Öffnen Sie den WCF-Testclient mit Windows Explorer.

    Der WCF-Testclient (WcfTestClient.exe) befindet sich im Ordner "<Visual Studio 2010-Installationsordner>\Common7\IDE\".

    Der standardmäßige Visual Studio 2010-Installationsordner ist "C:\Programme\Microsoft-Visual Studio 10.0".

  5. Wählen Sie im WCF-Testclient im Menü Datei die Option Dienst hinzufügen aus.

    Fügen Sie die Endpunktadresse im Eingabefeld hinzu. Der Standard lautet "https://localhost:53797/SampleWorkflowService.xamlx".

  6. Öffnen Sie die Ereignisanzeige.

    Starten Sie vor dem Aufrufen des Diensts die Ereignisanzeige über das Menü Start, wählen Sie Ausführen aus, und geben Sie eventvwr.exe ein. Stellen Sie sicher, dass das Ereignisprotokoll eine Überwachung für vom Workflowdienst ausgegebene Überwachungsereignisse ausführt.

  7. Navigieren Sie in der Strukturansicht der Ereignisanzeige zu Ereignisanzeige, Anwendungs- und Dienstprotokolle und Microsoft. Klicken Sie mit der rechten Maustaste auf Microsoft, wählen Sie Ansicht aus, und stellen Sie sicher, dass Analytische und Debugprotokolle einblenden ausgewählt ist, um die analytischen Protokolle und die Debugprotokolle zu aktivieren.

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

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

  9. Testen Sie den Dienst mithilfe des WCF-Testclients, indem Sie auf GetData doppelklicken.

    Dadurch wird die GetData-Methode geöffnet. Die Anforderung akzeptiert einen Parameter und stellt sicher, dass der Wert 0 beträgt, was dem Standard entspricht.

    Klicken Sie auf Aufrufen.

  10. Achten Sie auf die vom Workflow ausgegebenen Ereignisse.

    Wechseln Sie zurück zur Ereignisanzeige, und navigieren Sie zu Ereignisanzeige, Anwendungs- und Dienstprotokolle, Microsoft, Windows, Anwendungsserver-Anwendungen. Klicken Sie mit der rechten Maustaste auf Analytisch, und wählen Sie Aktualisieren.

    Die Workflowereignisse werden in der Ereignisanzeige angezeigt. Beachten Sie, dass Workflowausführungsereignisse angezeigt werden und dass es sich bei einem dieser Ereignisse um eine unbehandelte Ausnahme handelt, die dem Fehler im Workflow entspricht. Es wird auch ein Warnungsereignis von der Workflowaktivität ausgegeben, das angibt, dass die Aktivität einen Fehler auslöst.

  11. Wiederholen Sie Schritt 9 und 10, und geben Sie andere Daten als 0 ein, damit kein Fehler ausgelöst wird.

Mithilfe von Nachverfolgungsprofilen können Sie Ereignisse abonnieren, die von der Laufzeit ausgegeben werden, wenn sich der Zustand eines Workflowinstanz ändert. In Abhängigkeit von Ihren Überwachungsanforderungen können Sie ein Profil erstellen, das sehr grob gehalten ist und einen kleinen Satz von unspezifischen Zustandsänderungen eines Workflows abonniert. Sie können jedoch auch ein sehr präzises Profil erstellen, dessen Ausgabe so umfangreich ist, dass später die Ausführung rekonstruiert werden kann. In dem Beispiel sind die Ereignisse veranschaulicht, die mithilfe des HealthMonitoring Tracking Profile, das eine geringe Menge von Ereignissen ausgibt, von der Workflowlaufzeit an ETW ausgegeben werden. Ein anderes Profil, das weitere Workflownachverfolgungsereignisse ausgibt, wird auch in der Datei "Web.config" mit dem Namen Troubleshooting Tracking Profile bereitgestellt. Wenn .NET Framework 4 installiert ist, wird ein Standardprofil mit einem leeren Namen in der Datei "Machine.config" konfiguriert. Dieses Profil wird von der ETW-Überwachungsverhaltenskonfiguration verwendet, wenn kein Profilname oder ein leerer Profilname angegeben wird.

Das Nachverfolgungsprofil für die Systemüberwachung gibt Workflowinstanzdatensätze und Aktivitätsdatensätze für die Fehlerweitergabe aus. Dieses Profil wird erstellt, indem einer Web.config-Konfigurationsdatei das folgende Nachverfolgungsprofil hinzugefügt wird.

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

Das Profil kann geändert werden, indem die EtwTrackingParticipant-Konfiguration folgendermaßen geändert wird.

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

So führen Sie eine Bereinigung aus (optional)

  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.

Bekannte Probleme

Dd807395.note(de-de,VS.100).gifHinweis:
Es gibt ein bekanntes Problem in der Ereignisanzeige, bei dem bei der Decodierung von ETW-Ereignissen ein Fehler auftritt. Möglicherweise wird eine Fehlermeldung ähnlich der Folgenden angezeigt.

Die Beschreibung für die Ereignis-ID <ID> aus der Quelle Microsoft Windows-Anwendungsserver-Anwendungen wurde nicht gefunden. Entweder ist die Komponente, die dieses Ereignis auslöst, nicht auf dem lokalen Computer installiert, oder die Installation ist beschädigt. Sie können die Komponente auf dem lokalen Computer installieren oder reparieren.

Wenn dieser Fehler auftritt, klicken Sie im Aktionsbereich auf "Aktualisieren". Das Ereignis sollte jetzt ordnungsgemäß decodiert werden.

Dd807395.Important(de-de,VS.100).gif 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\WF\Basic\Tracking\EtwTracking