Freigeben über


<add> von <participants>

Konfiguriert einen Nachverfolgungsteilnehmer, der den direkt von der Laufzeit ausgegebenen Nachverfolgungsdatensätzen lauscht und sie entsprechend der Weise verarbeitet, wie er konfiguriert wurde. Dies umfasst das Schreiben in ein bestimmtes Ausgabemedium (z. B. Datei, Konsole, ETW), das Verarbeiten/Aggregieren der Datensätze oder eine beliebige andere Kombination, die erforderlich sein könnte.

Weitere Informationen zur Workflowüberwachung und zu Nachverfolgungsteilnehmern finden Sie unter Workflow Tracking and Tracing und Tracking Participants.

Schemahierarchie

<system.serviceModel>
  <tracking>
    <participants>
      <add> von <participants>

Syntax

   <tracking>    <participants>       <add name="String"            profileName="String"           type="String" />    </participants> </tracking> 

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente sowie übergeordnete Elemente beschrieben.

Attribute

Element Beschreibung

name

Eine Zeichenfolge, die den Namen eines Nachverfolgungsteilnehmers angibt.

profileName

Eine Zeichenfolge, die den Namen des Nachverfolgungsprofils angibt. Dieses Profil definiert die Nachverfolgungsdatensätze, die der Nachverfolgungsteilnehmer abonniert hat.

type

Eine Zeichenfolge, die den Typ eines Nachverfolgungsteilnehmers angibt.

Untergeordnete Elemente

Keiner.

Übergeordnete Elemente

Element Beschreibung

<participants>

Eine Liste von Nachverfolgungsteilnehmern

Hinweise

Nachverfolgungsteilnehmer werden verwendet, um die vom Workflow ausgegebenen Nachverfolgungsdaten zu erfassen und in verschiedenen Medien zu speichern. Außerdem kann jede Nachverarbeitung der Nachverfolgungsdatensätze auch innerhalb des Nachverfolgungsteilnehmers erfolgen.

Die Nachverfolgungsereignisse können von mehreren Nachverfolgungsteilnehmern gleichzeitig verarbeitet werden. Jedem Nachverfolgungsteilnehmer kann ein anderes Nachverfolgungsprofil zugeordnet sein.

Standardmäßig wird ein Nachverfolgungsteilnehmer bereitgestellt, der die Nachverfolgungsdatensätze in eine ETW-Sitzung schreibt. Der Teilnehmer wird für einen Workflowdienst konfiguriert, indem einer Konfigurationsdatei ein nachverfolgungsspezifisches Verhalten hinzugefügt wird. Durch Aktivierung eines ETW-Nachverfolgungsteilnehmers können Nachverfolgungsdatensätze in der Ereignisanzeige angezeigt werden. Wenn dies nicht Ihren Anforderungen entspricht, können Sie auch einen benutzerdefinierten Nachverfolgungsteilnehmer schreiben.

Beispiel

In der folgenden Beispielkonfiguration wird der standardmäßige ETW-Nachverfolgungsteilnehmer gezeigt, der in der Datei Web.config konfiguriert ist.

Die Anbieter-ID, die der ETW-Nachverfolgungsteilnehmer verwendet, um die Nachverfolgungsdatensätze an ETW weiterzuleiten, ist im Abschnitt <diagnostics> definiert. Dem Nachverfolgungsteilnehmer ist ein Profil zugeordnet, das die Nachverfolgungsdatensätze angibt, die er abonniert hat. Dieses Profil wird durch das profileName-Attribut des <add>-Elements definiert. Sobald alles definiert ist, wird der Nachverfolgungsteilnehmer dem <etwTracking>-Dienstverhalten hinzugefügt. Dadurch wird der ausgewählte Nachverfolgungsteilnehmer den Erweiterungen der Workflowinstanz hinzugefügt, die daraufhin die Nachverfolgungsdatensätze empfangen.

    
<configuration> 
  <system.web> 
    <compilation targetFrameworkMoniker=".NETFramework,Version=v4.0"/> 
  </system.web> 
  <system.serviceModel> 
    <diagnostics etwProviderId="52A3165D-4AD9-405C-B1E8-7D9A257EAC9F" />              
    <tracking> 
      <participants> 
        <add name="EtwTrackingParticipant" 
             type="System.Activities.Tracking.EtwTrackingParticipant, System.Activities, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" 
             profileName="HealthMonitoring_Tracking_Profile"/> 
      </participants> 
    </tracking> 
    <behaviors> 
      <serviceBehaviors> 
        <behavior> 
          <etwTracking profileName="Sample Tracking Profile"/>
        </behavior> 
      </serviceBehaviors> 
    </behaviors> 
  </system.serviceModel> 
</configuration>

Siehe auch

Verweis

TrackingSection
EtwTrackingBehavior
EtwTrackingBehavior

Weitere Ressourcen

Workflow Tracking and Tracing
Tracking Participants