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

Добавление неудачных запросов <трассировки>

  • Статья

Общие сведения

Каждый <add> элемент в <traceFailedRequests> коллекции может содержать элемент, определяющий <traceAreas> поставщики трассировки и области, относящиеся к поставщику, которые будут создавать события трассировки для текущего правила трассировки. Он также может содержать <failureDefinition> элемент , который можно использовать для настройки условий сбоя для запроса, включая время, необходимое для ответа сервера, код состояния HTTP и объем сведений, включенных в трассировку.

Совместимость

Версия Примечания
IIS 10.0 Элемент <add> не был изменен в IIS 10.0.
IIS 8,5 Элемент <add> не был изменен в IIS 8.5.
IIS 8,0 Элемент <add> не был изменен в IIS 8.0.
IIS 7,5 Элемент <add> не был изменен в IIS 7.5.
IIS 7.0 Элемент <add> коллекции появился <traceFailedRequests> в IIS 7.0.
IIS 6,0 Н/Д

Настройка

После завершения установки iis 7 и более поздних версий по умолчанию необходимо установить службу роли трассировки, чтобы использовать трассировку неудачных запросов. После установки службы ролей по-прежнему необходимо включить трассировку неудачных запросов на уровне сайта, приложения или каталога.

Windows Server 2012 или Windows Server 2012 R2

  1. На панели задач щелкните Диспетчер сервера.
  2. В диспетчер сервера откройте меню Управление и выберите пункт Добавить роли и компоненты.
  3. В мастере добавления ролей и компонентов нажмите кнопку Далее. Выберите тип установки и нажмите кнопку Далее. Выберите целевой сервер и нажмите кнопку Далее.
  4. На странице Роли сервера разверните узел Веб-сервер (IIS),Веб-сервер, Затем — Работоспособность и диагностика, а затем выберите Трассировка. Щелкните Далее.
    Снимок экрана: страница .
  5. На странице Выбор компонентов нажмите кнопку Далее.
  6. На странице Подтверждение выбранных элементов для установки нажмите кнопку Установить.
  7. На странице Результаты нажмите кнопку Закрыть.

Windows 8 или Windows 8.1

  1. На начальном экране переместите указатель в левый нижний угол, щелкните правой кнопкой мыши кнопку Пуск и выберите панель управления.
  2. В панель управления выберите Программы и компоненты, а затем — Включить или отключить компоненты Windows.
  3. Разверните узел Службы IIS, Веб-службы, Работоспособность и диагностика, а затем выберите Трассировка.
    Снимок экрана: дерево Интернета в панель управления с развернутой службой - Нажмите кнопку ОК.
  4. Щелкните Закрыть.

Windows Server 2008 или Windows Server 2008 R2

  1. На панели задач нажмите кнопку Пуск, выберите Администрирование, а затем диспетчер сервера.
  2. В области иерархии диспетчер сервера разверните узел Роли и выберите Веб-сервер (IIS).
  3. На панели Веб-сервер (IIS) прокрутите страницу до раздела Службы ролей и щелкните Добавить службы ролей.
  4. На странице Выбор служб ролеймастера добавления служб ролей выберите Трассировка и нажмите кнопку Далее.
    Снимок экрана: страница
  5. На странице Подтверждение выбранных элементов для установки нажмите кнопку Установить.
  6. На странице Результаты нажмите кнопку Закрыть.

Windows Vista или Windows 7

  1. На панели задач нажмите кнопку Пуск, а затем панель управления.
  2. В панель управления выберите Программы и компоненты, а затем — Включить или отключить компоненты Windows.
  3. Разверните узел Службы IIS, затем Веб-службы, а затем Работоспособность и диагностика.
  4. Выберите Трассировка и нажмите кнопку ОК.
    Снимок экрана: дерево служб Интернета с развернутой службой работоспособности и диагностикой, выбранной и контурной трассировкой.

Инструкции

Включение трассировки

  1. Откройте диспетчер служб IIS:

    • Если вы используете Windows Server 2012 или Windows Server 2012 R2:

      • На панели задач щелкните диспетчер сервера, выберите Сервис, а затем диспетчер служб IIS.

    • Если вы используете Windows 8 или Windows 8.1:

      • Удерживая нажатой клавишу Windows, нажмите букву X и щелкните панель управления.
      • Щелкните Администрирование, а затем дважды щелкните Диспетчер служб IIS.

    • Если вы используете Windows Server 2008 или Windows Server 2008 R2:

      • На панели задач нажмите кнопку Пуск, наведите указатель на пункт Администрирование, а затем выберите Пункт Диспетчер служб IIS.

    • Если вы используете Windows Vista или Windows 7:

      • На панели задач нажмите кнопку Пуск, а затем панель управления.
      • Дважды щелкните Администрирование, а затем дважды щелкните Диспетчер служб IIS.

  2. В области Подключения выберите подключение к серверу, сайт, приложение или каталог, для которых требуется настроить трассировку неудачных запросов.

  3. В области Действия щелкните Трассировка неудачных запросов...
    Снимок экрана: диалоговое окно диспетчера служб IIS с выбранным параметром Трассировка неудачных запросов в области Действий.

  4. В диалоговом окне Изменение параметров трассировки неудачных запросов веб-сайта установите флажок Включить проверка, чтобы включить трассировку, оставьте значение по умолчанию или введите новый каталог, в котором нужно хранить файлы журналов неудачных запросов, в поле Каталог введите количество файлов трассировки неудачных запросов, которые нужно сохранить в поле Максимальное число файлов трассировки. и нажмите кнопку ОК.
    Снимок экрана: диалоговое окно

Настройка определений сбоев

  1. Откройте диспетчер служб IIS:

    • Если вы используете Windows Server 2012 или Windows Server 2012 R2:

      • На панели задач щелкните диспетчер сервера, выберите Сервис, а затем диспетчер служб IIS.

    • Если вы используете Windows 8 или Windows 8.1:

      • Удерживая нажатой клавишу Windows, нажмите букву X и щелкните панель управления.
      • Щелкните Администрирование, а затем дважды щелкните Диспетчер служб IIS.

    • Если вы используете Windows Server 2008 или Windows Server 2008 R2:

      • На панели задач нажмите кнопку Пуск, наведите указатель на пункт Администрирование, а затем выберите Пункт Диспетчер служб IIS.

    • Если вы используете Windows Vista или Windows 7:

      • На панели задач нажмите кнопку Пуск, а затем панель управления.
      • Дважды щелкните Администрирование, а затем дважды щелкните Диспетчер служб IIS.

  2. На панели Подключения перейдите к подключению, сайту, приложению или каталогу, для которого требуется настроить трассировку неудачных запросов.

  3. На домашней панели дважды щелкните Правила трассировки неудачных запросов.
    Снимок экрана: диалоговое окно диспетчера служб IIS с выбранными правилами трассировки неудачных запросов на домашней панели.

  4. В области Действия нажмите кнопку Добавить...

  5. На странице Указание содержимого для трассировки мастера добавления правила трассировки неудачных запросов выберите тип контента, который требуется отследить, и нажмите кнопку Далее.
    Снимок экрана: страница

  6. На странице Определение условий трассировки выберите условия, которые требуется выполнить трассировку, и нажмите кнопку Далее. Условия трассировки могут включать любое сочетание кодов состояния, ограничение времени, которое должен принимать запрос, или серьезность события. Если указать все условия, первое условие, которое выполняется, создает файл журнала трассировки неудачных запросов.
    Снимок экрана: страница

  7. На странице Выбор поставщиков трассировки выберите один или несколько поставщиков трассировки в разделе Поставщики.
    Снимок экрана: страница

  8. На странице Выбор поставщиков трассировки выберите один или несколько уровней детализации в разделе Детализация.
    Снимок экрана: страница

  9. Если вы выбрали поставщик трассировки ASPNET или WWW Server на шаге 8, выберите одну или несколько функциональных областей для трассировки поставщика в разделе Области на странице Выбор поставщиков трассировки .

  10. Нажмите кнопку Готово.

Параметр Configuration

Атрибуты

Атрибут Описание
customActionExe Необязательный строковый атрибут.

Указывает исполняемый файл, запускаемый при достижении условия сбоя (например, чтобы запустить файл VBScript, укажите "Cscript.exe"). Все переменные командной строки будут развернуты. Например, "%windir%" будет развернут до пути к каталогу Windows.
customActionParams Необязательный строковый атрибут.

Содержит параметры для передачи в исполняемый файл, указанный в атрибуте customActionExe. Переменные командной строки, такие как "%windir%", будут расширены. Можно также использовать переменные параметров, такие как "%1" и "%2" в указанной строке (например, "MyScript.vbs %1 %2").
customActionTriggerLimit Необязательный атрибут uint.

Указывает максимальное число выполнений программы, указанной атрибутом customActionExe, в течение времени существования рабочего процесса для определения неудачного запроса. Это значение сбрасывается при каждом перезапуске рабочего процесса. Допустимые значения — от 0 до 10 000. Эту функцию можно использовать, например, для создания дампа памяти после следующего сбоя, но не после последующих сбоев.

Примечание: Если указанное значение CustomActionTriggerLimit достигается во время выполнения рабочего процесса, последующие неудачные запросы записываются в журнал, но программа, указанная в CustomActionExe, не будет запущена. Записи в журнале failed-requests указывают на то, что достигнуто значение CustomActionTriggerLimit. Значение по умолчанию — 1.
path Обязательный строковый атрибут.

Указывает путь, для которого требуется регистрировать события трассировки. Путь относится к URL-адресу (виртуальный каталог или каталог). Вложенные пути нельзя использовать. Кроме того, путь должен быть локальным для каталога, в котором задано определение. Можно использовать подстановочные знаки, например "*.aspx". Для трассировки документа по умолчанию используйте "/" в качестве значения пути.

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

Элемент Описание
traceAreas Обязательный элемент.

Настраивает трассировку для заданного пути.
failureDefinitions Обязательный элемент.

Определяет условия сохранения трассировок для запроса.

Образец конфигурации

В следующем примере конфигурации трассировка настраивается на уровне сервера в файле ApplicationHost.config. Он задает трассировку для всех ASPX-файлов, использует <traceAreas> элемент для задания поставщика ASPNET и трассировки для всех ASP.NET областей, таких как Инфраструктура, Модуль, Страница и AppServices. В примере также используется атрибут verbosity для установки предупреждения для объема сведений, возвращаемых в файл трассировки. Наконец, в примере элемент используется <failureDefinitions> для трассировки только запросов, которые создают код состояния HTTP 404.

<tracing>
   <traceFailedRequests>
      <add path="*.aspx">
         <traceAreas>
            <add provider="ASPNET" areas="Infrastructure,Module,Page,AppServices" verbosity="Warning" />
         </traceAreas>
         <failureDefinitions statusCodes="404" />
      </add>
   </traceFailedRequests>
</tracing>

Пример кода

В следующих примерах включена трассировка подробных неудачных запросов для ошибок HTTP 500 в ASP.NET содержимого на всех запросах к *.aspx-страницам.

AppCmd.exe

appcmd.exe set config "Contoso" -section:system.webServer/tracing/traceFailedRequests /+"[path='*.aspx']" 

appcmd.exe set config "Contoso" -section:system.webServer/tracing/traceFailedRequests /+"[path='*.aspx'].traceAreas.[provider='ASPNET',areas='Infrastructure,Module,Page,AppServices',verbosity='Verbose']" 

appcmd.exe set config "Contoso" -section:system.webServer/tracing/traceFailedRequests /[path='*.aspx'].failureDefinitions.statusCodes:"500"

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetWebConfiguration("Contoso");
         ConfigurationSection traceFailedRequestsSection = config.GetSection("system.webServer/tracing/traceFailedRequests");
         ConfigurationElementCollection traceFailedRequestsCollection = traceFailedRequestsSection.GetCollection();

         ConfigurationElement addElement = traceFailedRequestsCollection.CreateElement("add");
         addElement["path"] = @"*.aspx";

         ConfigurationElementCollection traceAreasCollection = addElement.GetCollection("traceAreas");
         ConfigurationElement addElement1 = traceAreasCollection.CreateElement("add");
         addElement1["provider"] = @"ASPNET";
         addElement1["areas"] = @"Infrastructure,Module,Page,AppServices";
         addElement1["verbosity"] = @"Verbose";
         traceAreasCollection.Add(addElement1);

         ConfigurationElement failureDefinitionsElement = addElement.GetChildElement("failureDefinitions");
         failureDefinitionsElement["statusCodes"] = @"500";
         traceFailedRequestsCollection.Add(addElement);

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample
   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetWebConfiguration("Contoso")
      Dim traceFailedRequestsSection As ConfigurationSection = config.GetSection("system.webServer/tracing/traceFailedRequests")
      Dim traceFailedRequestsCollection As ConfigurationElementCollection = traceFailedRequestsSection.GetCollection

      Dim addElement As ConfigurationElement = traceFailedRequestsCollection.CreateElement("add")
      addElement("path") = "*.aspx"
      Dim traceAreasCollection As ConfigurationElementCollection = addElement.GetCollection("traceAreas")
      Dim addElement1 As ConfigurationElement = traceAreasCollection.CreateElement("add")
      addElement1("provider") = "ASPNET"
      addElement1("areas") = "Infrastructure,Module,Page,AppServices"
      addElement1("verbosity") = "Verbose"
      traceAreasCollection.Add(addElement1)

      Dim failureDefinitionsElement As ConfigurationElement = addElement.GetChildElement("failureDefinitions")
      failureDefinitionsElement("statusCodes") = "500"
      traceFailedRequestsCollection.Add(addElement)

      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Contoso";
var traceFailedRequestsSection = adminManager.GetAdminSection("system.webServer/tracing/traceFailedRequests", "MACHINE/WEBROOT/APPHOST/Contoso");
var traceFailedRequestsCollection = traceFailedRequestsSection.Collection;

var addElement = traceFailedRequestsCollection.CreateNewElement("add");
addElement.Properties.Item("path").Value = "*.aspx";
var traceAreasCollection = addElement.ChildElements.Item("traceAreas").Collection;

var addElement1 = traceAreasCollection.CreateNewElement("add");
addElement1.Properties.Item("provider").Value = "ASPNET";
addElement1.Properties.Item("areas").Value = "Infrastructure,Module,Page,AppServices";
addElement1.Properties.Item("verbosity").Value = "Verbose";
traceAreasCollection.AddElement(addElement1);

var failureDefinitionsElement = addElement.ChildElements.Item("failureDefinitions");
failureDefinitionsElement.Properties.Item("statusCodes").Value = "500";
traceFailedRequestsCollection.AddElement(addElement);

adminManager.CommitChanges();

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Contoso"
Set traceFailedRequestsSection = adminManager.GetAdminSection("system.webServer/tracing/traceFailedRequests", "MACHINE/WEBROOT/APPHOST/Contoso")
Set traceFailedRequestsCollection = traceFailedRequestsSection.Collection

Set addElement = traceFailedRequestsCollection.CreateNewElement("add")
addElement.Properties.Item("path").Value = "*.aspx"
Set traceAreasCollection = addElement.ChildElements.Item("traceAreas").Collection

Set addElement1 = traceAreasCollection.CreateNewElement("add")
addElement1.Properties.Item("provider").Value = "ASPNET"
addElement1.Properties.Item("areas").Value = "Infrastructure,Module,Page,AppServices"
addElement1.Properties.Item("verbosity").Value = "Verbose"
traceAreasCollection.AddElement addElement1

Set failureDefinitionsElement = addElement.ChildElements.Item("failureDefinitions")
failureDefinitionsElement.Properties.Item("statusCodes").Value = "500"
traceFailedRequestsCollection.AddElement addElement

adminManager.CommitChanges()