Freigeben über


Konfigurieren der Nachverfolgung

In diesem Thema werden die in Windows Server AppFabric verfügbaren Nachverfolgungsprofile beschrieben sowie deren Konfiguration für einen Dienst. Für Server, Sites und Webanwendungen können keine Nachverfolgungsprofile konfiguriert werden.

Nachverfolgungsprofile

Die Workflow-Laufzeit erzeugt einen Strom von Ereignissen, die auf deren Ausführung folgen. Der Ereignisstrom kann von einem oder mehreren Consumern überwacht werden, die auch als Nachverfolgungskomponenten bezeichnet werden. Sie können den Ereignisstrom für eine bestimmte Nachverfolgungskomponente anpassen, indem Sie ein Nachverfolgungsprofil angeben. Ein Nachverfolgungsprofil besteht aus einer deklarativen Definition von Filtern auf den Ereignistyp sowie den Daten, die von der Workflowinstanz für ein angegebenes Ereignis abgefragt werden müssen (z. B. der Wert einer Variablen).

Das folgende Konfigurationsbeispiel zeigt die grundlegende Struktur sowie die Attribute einer Nachverfolgungsprofildefinition (bei diesem Beispiel handelt es sich um das Standardprofil Systemüberwachung, das in der Datei Web.config im Stammverzeichnis deklariert ist).

<trackingProfile name="HealthMonitoring Tracking Profile">
   <workflow activityDefinitionId="*">
         <workflowInstanceQueries>
               <workflowInstanceQuery>
                     <states>
                           <state name="Started" />
                           <state name="Completed" />
                           <state name="Terminated" />
                           <state name="Canceled" />
                           <state name="Unsuspended" />
                           <state name="Persisted" />
                           <state name="Aborted" />
                           <state name="UnhandledException" />
                     </states>
               </workflowInstanceQuery>
         </workflowInstanceQueries>
         <activityStateQueries>
               <activityStateQuery activityName="*">
                     <states>
                           <state name="Closed" />
                     </states>
               </activityStateQuery>
         </activityStateQueries>
         <faultPropagationQueries>
               <faultPropagationQuery faultSourceActivityName="*" faultHandlerActivityName="*" />
         </faultPropagationQueries>
         <customTrackingQueries>
               <customTrackingQuery name="*" activityName="*" />
         </customTrackingQueries>
   </workflow>
</trackingProfile>

AppFabric enthält fünf vordefinierte Nachverfolgungsprofile, einschließlich der Option, Nachverfolgungsprofile zu deaktivieren. In der folgenden Tabelle werden diese Profile beschrieben.

Nachverfolgungsprofil Beschreibung

Nachverfolgungsprofil Nur Fehler

Abonniert die folgenden WF-Nachverfolgungsereignisse:

  • Ausnahmefehler

  • Abgebrochene Instanzen

  • Ungültige Propagierungsereignisse

Nachverfolgungsprofil Systemüberwachung

Abonniert alle im Nachverfolgungsprofil „Nur Fehler“ enthaltenen WF-Nachverfolgungsereignisse, zuzüglich der folgenden:

  • Alle WF-Instanzstatusänderungs-Ereignisse für die Status Gestartet, Abgeschlossen, Beendet, Abgebrochen, Fortgesetzt, Persistent, Abgebrochen und Ausnahmefehler.

  • Ereignisse geschlossener und fehlerhafter WF-Aktivitäten

  • Alle von WF-Aktivitäten gesendeten benutzerdefinierten Nachverfolgungsdatensätze

Nachverfolgungsprofil End-to-End

Abonniert alle im Nachverfolgungsprofil „Systemüberwachung“ enthaltenen WF-Nachverfolgungsereignisse, zuzüglich der folgenden:

  • Alle WF-Instanzereignisse

  • WF-Aktivitätsereignisse für den Status Wird ausgeführt und Geschlossen

  • Alle von WF-Aktivitäten gesendeten benutzerdefinierten Nachverfolgungsdatensätze

Nachverfolgungsprofil Problembehebung

Dieses Profil enthält alle im Nachverfolgungsprofil „End-to-End“ enthaltenen WF-Nachverfolgungsereignisse. Dies ist das ausführlichste Nachverfolgungsprofil, und es abonniert alle Nachverfolgungsdatensätze, die von WF-Instanzen gesendet werden.

Nachverfolgungsprofil Aus

Das Nachverfolgungsprofil ist nicht konfiguriert. Instrumentationsereignisse sind nicht aktiviert, weshalb auch keine Metriken im Dashboard angezeigt werden.

Hinweis

Bestimmte Funktionen in AppFabric sind davon abhängig, dass mindestens das Nachverfolgungsprofil Systemüberwachung verwendet wird. Wenn die Überwachungsstufe „Aus“ oder „Nur Fehler“ ist, bzw. wenn die Stufe durch Deaktivieren des Nachverfolgungsprofils oder Festlegen des Nachverfolgungsprofils Nur Fehler angepasst wurde, wird im Dashboard nicht der Verlauf Nachverfolgte WF-Instanzen angezeigt. Darüber hinaus müssen Sie, wenn Sie ein eigenes, benutzerdefiniertes Profil erstellen, alle Attribute des Standardprofils Systemüberwachung einschließen, damit alle AppFabric-Überwachungstools voll funktionsfähig bleiben. So erfordert beispielsweise das Cmdlet Clear-MonitoringDatabase, dass das Profil WF-Instanzabschlussereignisse abonniert, damit im Löschmodus nur abgeschlossene nachverfolgte WF-Instanzen aus dem Überwachungsspeicher gelöscht werden.

Konfigurieren eines Nachverfolgungsprofils

Das folgende Verfahren zeigt, wie das Nachverfolgungsprofil für Ihren Dienst geändert wird.

So konfigurieren Sie das Nachverfolgungsprofil für einen Dienst

  1. Starten Sie IIS-Manager, oder wechseln Sie zu ihm.

  2. Wählen Sie im Bereich Verbindungen den Server, die Site oder die Webanwendung aus, der bzw. die konfiguriert werden soll.

  3. Suchen Sie im mittleren Bereich des IIS-Managerfensters den Abschnitt mit dem Titel AppFabric. Doppelklicken Sie auf das Symbol Dienste.

  4. Wählen Sie den zu bearbeitenden Dienst aus der Liste Dienste aus. Klicken Sie mit der rechten Maustaste auf den Dienst, und klicken Sie dann im Kontextmenü auf Konfigurieren.

  5. Klicken Sie, wenn das Dialogfeld Dienst konfigurieren angezeigt wird, auf die Registerkarte Überwachung.

  6. Suchen Sie den Abschnitt Workflow-Nachverfolgungsprofil. Das Name des aktuell verwendeten Nachverfolgungsprofils wird angezeigt. Klicken Sie zum Ändern des Nachverfolgungsprofils auf Konfigurieren.

  7. Das Workflow-Nachverfolgungsprofil (Dialogfeld) wird angezeigt. Mithilfe dieses Dialogfelds können Sie ein anderes Nachverfolgungsprofil auswählen oder durch Klicken auf Neues hinzufügen ein benutzerdefiniertes Nachverfolgungsprofil importieren. Hierdurch wird das Nachverfolgungsprofil hinzufügen (Dialogfeld) angezeigt, in dem Sie ein benutzerdefiniertes Nachverfolgungsprofil auswählen und als aktives Nachverfolgungsprofil für diesen Dienst festlegen können.

  8. Klicken Sie auf OK, um das Dialogfeld zu schließen und Ihre Änderungen zu speichern, oder klicken Sie auf Abbrechen, um das Dialogfeld ohne Speichern von Änderungen zu schließen.

Siehe auch

Verweis

WCF und WF für den Server, für die Site oder für die Webanwendung konfigurieren: Überwachung (Registerkarte)
Dienst konfigurieren: Überwachung (Registerkarte)
Workflow-Nachverfolgungsprofil (Dialogfeld)

Konzepte

Überwachen von Webanwendungen

Weitere Ressourcen

Nachverfolgungsprofile

  2011-12-05