Отслеживание событий в системе трассировки событий Windows

В примере EtwTracking показано, как включить отслеживание Windows Workflow Foundation (WF) в службе рабочих процессов и вывести события отслеживания в трассировке событий для Windows (ETW). Для создания записей отслеживания рабочих процессов в ETW в этом образце используется участник отслеживания трассировки событий Windows (EtwTrackingParticipant).

В образце рабочий процесс получает запрос, присваивает обратное значение входных данных входной переменной и возвращает обратное значение клиенту. Если входные данные равны 0, то возникнет необрабатываемое исключение деления на ноль, которое приводит к прерыванию рабочего процесса. При включенном отслеживании в трассировке событий Windows создается запись отслеживания ошибки, которая в дальнейшем может быть использована для исправления ошибки. Для подписки на записи отслеживания в участнике отслеживания трассировка событий Windows задается профиль отслеживания. Профиль отслеживания определяется в файле Web.config и предоставляется участнику отслеживания трассировки событий Windows как параметр конфигурации. Участник отслеживания трассировки событий Windows настраивается в файле Web.config службы рабочего процесса и применяется к службе как поведение службы. В этом образце события отслеживания просматриваются в журнале событий с помощью средства просмотра событий.

Подробные сведения об отслеживании рабочего процесса

Windows Workflow Foundation предоставляет инфраструктуру отслеживания для отслеживания выполнения экземпляра рабочего процесса. Среды выполнения отслеживания создает экземпляр рабочего процесса для создания событий, связанных с жизненным циклом рабочего процесса, событиями из действий рабочего процесса и пользовательскими событиями. В следующих сведениях о таблице подробно описаны основные компоненты инфраструктуры отслеживания.

Следующая таблица содержит подробные сведения о записях отслеживания, создаваемых средой выполнения рабочего процесса.

Участник отслеживания подписывается на часть создаваемых записей отслеживания с помощью профилей отслеживания. Профиль отслеживания содержит запросы отслеживания, которые позволяют подписываться на определенный тип записей отслеживания. Профили отслеживания можно указывать в коде или в конфигурации.

Использование этого образца

1. Откройте файл решения EtwTrackingParticipantSample.sln с помощью Visual Studio.

2. Для построения решения нажмите CTRL+SHIFT+B.

3. Чтобы запустить решение, нажмите клавишу F5.

   По умолчанию служба прослушивает порт 53797 (http://localhost:53797/SampleWorkflowService.xamlx).

4. С помощью проводник откройте тестовый клиент WCF.

   Тестовый клиент WCF (WcfTestClient.exe) находится в папке <>установки Visual Studio\Common7\IDE\.

   Папка установки Visual Studio по умолчанию — C:\Program Files\Microsoft Visual Studio 10.0.

5. В тестовом клиенте WCF выберите "Добавить службу " в меню "Файл ".

   Добавьте адрес конечной точки в поле ввода. Значение по умолчанию — http://localhost:53797/SampleWorkflowService.xamlx.

6. Откройте приложение просмотра событий.

   Прежде чем вызывать службу, запустите Просмотр событий из меню "Пуск", выберите "Выполнить" и введите егоeventvwr.exe. Убедитесь, что журнал событий прослушивает события отслеживания, создаваемые службой рабочего процесса.

7. В представлении дерева Просмотр событий перейдите к Просмотр событий, журналам приложений и служб и Корпорации Майкрософт. Щелкните правой кнопкой мыши Корпорацию Майкрософт и выберите пункт "Просмотр" и "Показать журналы аналитики и отладки", чтобы включить журналы аналитики и отладки

   Убедитесь, что параметр Show Analytic and Debug Logs проверка.

8. В представлении дерева в Просмотр событий перейдите к Просмотр событий, приложениям и службам, Microsoft, Windows, приложениям приложений. Щелкните правой кнопкой мыши "Аналитика" и выберите "Включить журнал", чтобы включить журнал Аналитики.

9. Проверьте службу с помощью тестового клиента WCF, дважды щелкнув GetData.

   Откроется метод GetData. Запрос принимает один параметр и проверяет, равно ли значение 0 (значение по умолчанию).

   Нажмите кнопку "Вызвать".

10. Просмотрите события, переданные из рабочего процесса.

    Вернитесь к Просмотр событий и перейдите к Просмотр событий, приложениям и службам, Microsoft, Windows, application Server-Applications. Щелкните "Аналитика" правой кнопкой мыши и выберите "Обновить".

    События рабочего процесса отображаются в средстве просмотра событий. Обратите внимание, что отображаются события выполнения рабочего процесса и одно из них является необработанным исключением, соответствующим ошибке в рабочем процессе. Кроме того, действие рабочего процесса создает событие предупреждения, указывающее, какое действие выдало ошибку.

11. Повторите шаги 9 и 10, введя данные, отличные от 0, чтобы ошибка не появлялась.

Профили отслеживания позволяют подписаться на события, создаваемые средой выполнения при изменении состояния экземпляра рабочего процесса. Исходя из потребностей, можно создать профиль с низкой детализацией, который будет подписан на небольшой набор изменений состояния высокого уровня в рабочем процессе. В то же время можно создать очень точный профиль, выходные данные которого будут достаточно полными для последующей реконструкции выполнения. Образец демонстрирует события, создаваемые средой выполнения рабочего процесса для трассировки событий Windows с помощью HealthMonitoring Tracking Profile, создающего небольшой набор событий. В файле Web.config имеется другой профиль, создающий больше событий отслеживания, он называется Troubleshooting Tracking Profile. При установке платформа .NET Framework 4.6.1 профиль по умолчанию с пустым именем настраивается в файле Machine.config. Этот профиль используется конфигурацией поведения отслеживания ETW при отсутствии имени профиля или при задании пустого имени.

Профиль отслеживания мониторинга работоспособности создает записи экземпляра рабочего процесса и записи распространения ошибок действий. Этот профиль создается путем добавления следующего профиля отслеживания в файл конфигурации Web.config.

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

Профиль может быть изменен путем изменения конфигурации EtwTrackingParticipant на следующую.

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

Очистка (необязательно)

1. Откройте Средство просмотра событий.

2. Перейдите к Просмотр событий, приложениям и службам, Microsoft, Windows, приложениям-приложениям. Щелкните правой кнопкой мыши "Аналитика " и выберите "Отключить журнал".

3. Перейдите к Просмотр событий, приложениям и службам, Microsoft, Windows, приложениям-приложениям. Щелкните "Аналитика" правой кнопкой мыши и выберите "Очистить журнал".

4. Выберите параметр Clear, чтобы очистить события.

Известная проблема

См. также

• Примеры мониторинга AppFabric