Запись событий трассировки страниц ASP.NET в трассировке IIS 7.0

2023-07-19

В ASP.NET сегодня разработчики могут добавлять события трассировки на страницы ASPX с помощью вызовов Trace.Write() и Trace.Warn() в разделах скриптов своей страницы. Как правило, эти трассировки используются для отладки приложения, которое не работает должным образом.

Эти события появляются при включении трассировки для страницы (задано значение <%@ Page Trace="True" %>). Эти события можно просмотреть только по умолчанию при просмотре приложения с сервера (т. е. Localhost) или при включении трассировки приложений, чтобы сохранить последнее заданное количество сеансов.

Однако в этом процессе возникают следующие проблемы:

Эти трассировки не сохраняются, поэтому если процесс исчезает, то и ваши трассировки
Эти трассировки собираются независимо от кода состояния для запроса, т. е. если он завершается успешно или неудачно, вы получаете трассировки.
Эти трассировки отображаются полностью отдельно от любых других трассировок инфраструктуры, предоставляемых СЛУЖБАми IIS 7.0 и более поздних версий или ASP.net

В СЛУЖБАх IIS 7.0 и более поздних версий эти трассировки можно собирать в трассировке неудачных запросов или трассировке трассировки etW, а также просматривать их в обычном режиме. Кроме того, эти трассировки можно просматривать вместе с IIS и трассировками ASP.net инфраструктуры.

В данном пошаговом руководстве представлены следующие задачи.

Настройка трассировки неудачных запросов для записи вызовов трассировки страницы ASP.net.Запись и предупреждение
Создание условия сбоя и просмотр итоговой записи трассировки, поиск вызовов Trace.Write и Trace.Warn

Предварительные требования

Ниже приведены предварительные требования, необходимые для выполнения задач, описанных в этой статье.

Шаг 1. Установка IIS 7.0 или более поздней версии

Сначала необходимо установить СЛУЖБЫ IIS 7.0 или более поздней версии. Чтобы проверка, если установлены службы IIS, перейдите по папке http://localhost. Если отображается страница "В разработке", служба IIS установлена. Если службы IIS не установлены, см. инструкции по установке IIS 7.0 и более поздних версий.

Обязательно установите следующие компоненты IIS:

ASP (в разделе World Wide Web Services => Application Development Features => ASP)
Трассировка (в разделе Службы Интернета => работоспособность & диагностика => трассировка)

Шаг 2. Вход с правами администратора

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

Примечание

При входе в группу "Администраторы" вы по умолчанию не предоставляете полные права администратора. Необходимо запустить много приложений от имени администратора. Щелкните правой кнопкой мыши значок приложения и выберите "Запуск от имени администратора".

Шаг 3. Создание резервной копии

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

Нажмите кнопку Пуск —> Все программы —> стандартные —> (r-щелчок)Командная строка —> запуск от имени администратора.
Выполните следующую команду в этой командной строке:
```
%windir%\system32\inetsrv\appcmd add backup
```

Добавление нового вызова Trace.Write() & Trace.Warn() на пример ASPX-страницы

В этой задаче вы добавляете Trace.Write() & вызовы Warn() на пример aspx-страницы и просматриваете полученные трассировки в браузере.

Используйте командную строку администратора и перейдите в каталог %systemdrive%\inetpub\wwwroot .
Используйте выбранный редактор и создайте страницу aspx с именем trace.aspx, поместив на страницу следующий код:
```
<%@ Page language="C#" trace="true" %>

<%
  Trace.Write("Hey, there");
  Trace.Warn("Doh, a warning");

  Response.Write("hello, world");
%>
```
Перейдите по адресу http://localhost/trace.aspx. Отображается следующее:

Обратите внимание на события выше: "Эй, там" и "Doh, предупреждение".

Мы только что добавили новое событие на нашу страницу. Теперь посмотрите, можно ли получить трассировку неудачных запросов, чтобы записать ее.

Добавление нового вызова Trace.Write() & Trace.Warn() в пример ASPX-страницы

Теперь страница инструментируется с помощью вызовов Trace.Write & Trace.Warn. Настройте трассировку неудачных запросов для записи вызовов Trace.Write() страницы ASPX & Warn().

В этом сценарии необходимо использовать область page поставщика ASP.Net с вызовами Trace.Write, соответствующими уровню детализации детализации, и вызовами Trace.Warn(), соответствующими уровню детализации предупреждения. Если установить уровень детализации в значение Verbose, вы удостоверяете оба значения.

Шаг 1. Включение трассировки неудачных запросов для сайта

Сначала для сайта должна быть включена трассировка неудачных запросов. Инструкции по включению см. в пошаговом руководстве howTO-FailureRequestTracing, задача 1.

Шаг 2. Создание правила трассировки неудачных запросов для записи событий Trace.Write() & Warn()

В командной строке администратора введите start inetmgr. На панели Подключения разверните имя компьютера, затем папку Сайты, а затем щелкните веб-сайт по умолчанию. В разделе IIS дважды щелкните Правила трассировки неудачных запросов.
В области Действия нажмите кнопку Добавить. , чтобы запустить мастер добавления правила трассировки неудачных запросов . На странице Укажите трассировку содержимого щелкните параметр ASP.NET (*.aspx) для трассировки и нажмите кнопку Далее.
На экране Определение условий трассировки проверка поле Коды состояния проверка и введите "200" в качестве кода состояния для трассировки.
Щелкните Далее. Откроется страница Выбор поставщиков трассировки . Выберите поле ASPNET проверка и проверка страницы в разделе "Области" (снимите флажки все остальные области, которые установлены, кроме страницы). В разделе Детализация выберите Подробный.
Нажмите кнопку Готово. Вы увидите следующее определение для веб-сайта по умолчанию:

Шаг 3. Тестирование и просмотр

На этом шаге мы создадим запрос, http://localhost/trace.aspx а затем проверка файл журнала трассировки неудачных запросов, чтобы просмотреть события трассировки.

Чтобы убедиться, что он сработал, выполните приведенные далее действия.

Откройте новое окно интернет-Обозреватель с правами администратора.
Введите адрес http://localhost/trace.aspx.
Мы создали трассировку запроса, поэтому откройте окно Обозреватель с правами администратора, введите CTRL-O, чтобы открыть файл, и перейдите в папку inetpub\logs\FailedReqLogFiles\W3SVC1. В раскрывающемся списке Файлы HTML выберите Все файлы.
Выберите последний файл FR#######.xml. Отображается следующее:

События выше отображаются в журнале трассировки. Обратите внимание, что имя подтипа события "Doh, a warning" имеет значение AspNetPageTraceWarnEvent, то есть событие Trace.Warn().

Все вызовы Trace.Write() имеют очень высокую детализацию (детализация = "Verbose"); Следовательно, причина для <уровня>5</Level>, а все вызовы Trace.Warn() регистрируются как предупреждения.

Примечание

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

Сводка

Мы завершили добавление сообщений трассировки на страницу ASPX. Мы настроили службы IIS для записи этих трассировок, если они включены, в файле журнала трассировки неудачных запросов. Помните, что эти записи трассировки регистрируются в журналах трассировки только в том случае, если задана директива trace="true" страницы, а при трассировке определен поставщик ASP.NET с областью "Страница" (с помощью трассировки трассировки запросов windows или неудачных запросов).