<add> WCF<add> of WCF

Настройте участника отслеживания, который будет прослушивать записи отслеживания, прямо исходящие из среды выполнения, и обрабатывать их (в зависимости от настройки).Configure a tracking participant that listens to the tracking records being emitted from the runtime directly and process them in whatever way it was configured. Включает запись результата в определенном виде (например, в виде файла, консоли, ETW), обработку или сбор записей или любое другое требуемое сочетание.This includes writing to a specific output (e.g., file, Console, ETW), processing/aggregating the records, or any other combination that might be required.

Дополнительные сведения об участниках отслеживания и отслеживания рабочих процессов см. в статье участники отслеживания рабочих процессов и трассировки и отслеживания.For more information in workflow tracking and tracking participants, see Workflow Tracking and Tracing and Tracking Participants.

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

СинтаксисSyntax

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

Атрибуты и элементыAttributes and Elements

В следующих разделах описаны атрибуты, дочерние и родительские элементы.The following sections describe attributes, child elements, and parent elements.

АтрибутыAttributes

ЭлементElement ОписаниеDescription
namename Строка, задающая имя участника отслеживания.A string that specifies the name of a tracking participant.
profileNameprofileName Строка, задающая имя профиля отслеживания, который определяет, на какие записи отслеживания подписан участник.A string that specifies the name of the tracking profile which defines the tracking records the tracking participant has subscribed to.
типtype Строка, задающая тип участника отслеживания.A string that specifies the type of a tracking participant.

Дочерние элементыChild Elements

Отсутствует.None.

Родительские элементыParent Elements

ЭлементElement ОписаниеDescription
<participants> Список участников отслеживанияA list of tracking participants

RemarksRemarks

Участники отслеживания используются для выдачи данных отслеживания из рабочего процесса и их сохранения на различные носители.Tracking participants are used to get the tracking data emitted from the workflow and store it into different mediums. Подобным образом любая последующая обработка записей отслеживания также может быть выполнена внутри участника отслеживания.Likewise, any post processing on the tracking Records can also be done within the tracking participant.

События отслеживания могут использоваться несколькими участниками отслеживания одновременно.Multiple tracking participants can consume the tracking events simultaneously. Каждый участник отслеживания может быть связан с отдельным профилем отслеживания.Each tracking participant can be associated with a different tracking profile.

Имеется стандартный участник отслеживания, который вносит записи отслеживания в сеанс ETW.A standard tracking participant is provided which writes the tracking records to an ETW session. Участник настраивается в службе рабочего процесса путем добавления в файл конфигурации поведения, связанного с отслеживанием.The participant is configured on a workflow service by adding a tracking-specific behavior in a configuration file. Включив участника отслеживания ETW, можно будет просматривать записи отслеживания в обозревателе событий.Enabling an ETW tracking participant allows tracking records to be viewed in the event viewer. Если это не отвечает заданным требованиям, то можно создать своего собственного участника отслеживания.If that does not meet your requirements, you can also write a custom tracking participant.

ПримерExample

В следующем примере конфигурации показан стандартный участник отслеживания ETW, который настраивается в файле Web.config.The following configuration example shows the standard ETW tracking participant being configured in the Web.config file.

Идентификатор поставщика, который используется участником отслеживания ETW для внесения записей отслеживания в ETW, задан в разделе <diagnostics>.The Provider Id that the ETW Tracking Participant uses for writing the Tracking Records to ETW is defined in the <diagnostics> section. Участник отслеживания имеет связанный с ним профиль для указания записей отслеживания, на которые он подписан.The tracking participant has a profile associated with it to specify the tracking records it has subscribed to. Это определяется атрибутом profileName элемента <add>.This is defined by the profileName attribute of the <add> element. После их определения участник отслеживания добавляется к поведению службы <etwTracking>.Once these are defined, the Tracking Participant is added to the <etwTracking> service behavior. При этом выбранные участники отслеживания добавляются в расширения экземпляра рабочего процесса, чтобы они начали получать записи отслеживания.This will add the selected Tracking Participants to the Workflow instance’s extensions, so that they begin to receive the Tracking Records.

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

См. такжеSee also