Поделиться через

Службы WCF и средство отслеживания событий для Windows

  • Статья

Этот образец демонстрирует использование аналитического отслеживания в Windows Communication Foundation (WCF) для передачи событий в средство отслеживания событий для Windows (ETW). Аналитические трассировки представляют собой события, возникающие в ключевых точках стека WCF и позволяющие отлаживать службы WCF в рабочей среде.

Аналитическое отслеживание служб WCF можно включить в рабочей среде, оказывая минимальное воздействие на производительность. Отслеживаемые события передаются в сеанс трассировки событий Windows.

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

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

  1. Откройте в среде Visual Studio 2010 файл решения EtwAnalyticTraceSample.sln.

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

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

    В веб-обозревателе щелкните файл Calculator.svc. В веб-обозревателе должен появиться URI WSDL-документа для службы. Скопируйте этот URI.

    По умолчанию служба начинает прослушивание запросов на порту 1378 (https://localhost:1378/Calculator.svc).

  4. Запустите тестовый клиент WCF (WcfTestClient.exe).

    Тестовый клиент WCF (WcfTestClient.exe) расположен по адресу <Visual Studio 2010каталог_установки >\Common7\IDE\ WcfTestClient.exe (по умолчанию каталог установки Visual Studio 2010 имеет вид C:\Program Files\Microsoft Visual Studio 10.0).

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

    Добавьте адрес конечной точки в поле ввода. Значение по умолчанию равно https://localhost:1378/Calculator.svc.

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

    Перед запуском службы запустите средство просмотра событий и убедитесь, что журнал событий прослушивает события отслеживания, создаваемые в службе WCF.

  7. В меню Пуск выберите пункт Администрирование, а затем пункт Просмотр событий. Включите Аналитический и Отладочный журналы.

  8. В древовидном представлении средства просмотра событий перейдите последовательно к узлам Средство просмотра событий, Журналы приложений и служб, Microsoft, Windows и Сервер приложений — приложения. Щелкните правой кнопкой мыши пункт Сервер приложений — приложения, выберите пункт Вид и пункт Отобразить аналитический и отладочный журналы.

    Установите флажок Отобразить аналитический и отладочный журналы.

  9. Включите Аналитический журнал.

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

Проверка службы

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

    Если знаменатель равен 0, служба выдает ошибку.

  2. Просмотрите события, переданные из службы.

    Вернитесь в средство просмотра событий и перейдите к окну Средство просмотра событий, Журналы приложений и служб, Microsoft, WCF, а затем Разработка WF. Щелкните правой кнопкой мыши пункт Аналитический и выберите команду Обновить.

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

  3. Повторите шаги 1 и 2, используя уже допустимые входные значения. Значением параметра N2 может быть любое число, отличное от 0.

    Обновите канал аналитики, чтобы убедиться, что события WCF не включают событий, связанных с ошибкой.

Образец иллюстрирует передачу событий аналитического отслеживания из службы WCF.

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

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

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

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

  4. Установите флажок Очистить, чтобы очистить события.

Dd764466.Important(ru-ru,VS.100).gif Примечание
Образцы уже могут быть установлены на компьютере. Перед продолжением проверьте следующий каталог (по умолчанию).

<диск_установки>:\WF_WCF_Samples

Если этот каталог не существует, перейдите на страницу Образцы Windows Communication Foundation (WCF) и Windows Workflow Foundation (WF) для .NET Framework 4, чтобы загрузить все образцы Windows Communication Foundation (WCF) и WF. Этот образец расположен в следующем каталоге.

<диск_установки>:\WF_WCF_Samples\WCF\Basic\Management\ETWTracing