Параметры файла журнала по умолчанию для logFile веб-сайтов <>

Обзор

Элемент <logFile> элемента <siteDefaults> содержит атрибуты, позволяющие настроить ведение журнала по умолчанию для сайта в IIS 7 и более поздних версиях.

Например, можно включить или отключить ведение журнала, настроить формат файла журнала IIS, указать категории сведений для хранения в файле журнала и изменить каталог, в котором хранится файл журнала. Кроме того, элемент можно использовать <logFile> для управления тем, как часто СЛУЖБЫ IIS создают новый файл журнала на основе размера файла журнала или интервала времени и максимального размера (в байтах), который может стать файлом журнала.

По умолчанию IIS 7 и более поздних версий использует формат файла журнала W3C. Этот параметр можно изменить, изменив атрибут logFormat на IIS, NCSA или Custom.

• Задание атрибутов ведения журнала ODBC в элементе <odbcLogging> . Эти атрибуты указывают имя источника данных системы (DSN), имя таблицы, имя пользователя и пароль для подключения ODBC.
• Задание правильных настраиваемых атрибутов ведения журнала в <logFile> элементе. Эти атрибуты должны задать для формата файла журнала значение Custom, а пользовательский идентификатор подключаемого модуля журнала — "{FF16065B-DE82-11CF-BC0A-00AA00611E0}".

Дополнительные сведения о ведении журнала ODBC см. в элементе <odbcLogging> .

Вы можете определить категории сведений, которые службы IIS регистрируют, изменив атрибут logExtFileFlags . Значения по умолчанию: Date, ClientIPUserAgentHttpStatusWin32StatusTimeTakenServerPortHttpSubStatusTimeServerIPRefererUserNameMethodUriStemUriQueryи .

IIS 8.5 позволяет регистрировать настраиваемые поля в дополнение к стандартному набору журналов. Формат файла журнала должен быть W3C для добавления настраиваемых полей. Дополнительные сведения см. в разделе customFields.

Compatibility

Настройка

Элемент <logFile> включен в установку IIS 7 и более поздних версий по умолчанию.

Как сделать

Изменение параметров ведения журнала по умолчанию для сервера

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. В области "Главная" дважды щелкните "Ведение журнала".
   

4. В области ведения журнала выберите формат файла журнала в поле "Формат ", а затем введите путь к каталогу, в котором хранятся файлы журнала в поле "Каталог " или нажмите кнопку "Обзор", чтобы выбрать каталог, в котором хранятся файлы журнала.
   

5. Если вы решили использовать формат файла журнала W3C:

   • Щелкните "Выбрать поля" , чтобы выбрать типы сведений для журнала.
   • В диалоговом окне "Поля ведения журнала W3C " установите флажки для параметров, которые вы хотите записать, снимите флажки для параметров, которые не нужно регистрировать, а затем нажмите кнопку "ОК".
     

Настройка ведения журнала etW или файлов для журналов W3C

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

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

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

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

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

2. В области "Подключения" разверните имя сервера.

3. На домашней панели сайта дважды щелкните "Ведение журнала".

4. На домашней странице ведения журнала для назначения событий журнала выберите только файл журнала, только событие ETW или файл журнала и событие ETW.

   

Настройка очистки журнала W3C по количеству записей

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

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

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

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

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

2. В области "Подключения" выберите сервер и дважды щелкните редактор конфигурации.

3. В редакторе конфигурации для раздела разверните system.applicationHostузел и выберите сайты.

4. Разверните siteDefaults и разверните logFile.

5. Для flushByEntryCountW3Clog введите количество событий, которые необходимо хранить в буфере, прежде чем они будут удалены в файл журнала.

6. В области действий нажмите кнопку "Применить".

   

Настройка максимальной длины строки журнала

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

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

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

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

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

2. В области "Подключения" разверните сервер и дважды щелкните редактор конфигурации.

3. В редакторе конфигурации для раздела разверните system.applicationHostузел и выберите сайты.

4. Разверните siteDefaults и разверните logFile.

5. В поле maxLogLineLength введите максимальное количество байтов в одной строке файла журнала.

6. В области действий нажмите кнопку "Применить".

   

Конфигурация

Attributes

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

Пример конфигурации

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

<system.applicationHost>
   <sites>
      <siteDefaults>
         <logFile logFormat="W3C"
            directory="%SystemDrive%\inetpub\logs\LogFiles"
            enabled="true">
            <customFields>
               <clear/>
               <add logFieldName="ContosoField" sourceName="ContosoSource"
                  sourceType="ServerVariable" />
            </customFields>
         </logFile>
      </siteDefaults>
   </sites>
</system.applicationHost>

Пример кода

Следующие примеры кода настраивают параметры по умолчанию logFile для IIS 7.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.logFile.enabled:"True" /commit:apphost
appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.logFile.logFormat:"W3C" /commit:apphost
appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.logFile.directory:"%SystemDrive%\inetpub\logs\LogFiles" /commit:apphost

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.GetApplicationHostConfiguration();
         ConfigurationSection sitesSection = config.GetSection("system.applicationHost/sites");
         ConfigurationElement siteDefaultsElement = sitesSection.GetChildElement("siteDefaults");

         ConfigurationElement logFileElement = siteDefaultsElement.GetChildElement("logFile");
         logFileElement["logFormat"] = @"W3C";
         logFileElement["directory"] = @"%SystemDrive%\inetpub\logs\LogFiles";
         logFileElement["enabled"] = true;

         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.GetApplicationHostConfiguration
      Dim sitesSection As ConfigurationSection = config.GetSection("system.applicationHost/sites")
      Dim siteDefaultsElement As ConfigurationElement = sitesSection.GetChildElement("siteDefaults")

      Dim logFileElement As ConfigurationElement = siteDefaultsElement.GetChildElement("logFile")
      logFileElement("logFormat") = "W3C"
      logFileElement("directory") = "%SystemDrive%\inetpub\logs\LogFiles"
      logFileElement("enabled") = True

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST");
var siteDefaultsElement = sitesSection.ChildElements.Item("siteDefaults");

var logFileElement = siteDefaultsElement.ChildElements.Item("logFile");
logFileElement.Properties.Item("logFormat").Value = "W3C";
logFileElement.Properties.Item("directory").Value = "%SystemDrive%\\inetpub\\logs\\LogFiles";
logFileElement.Properties.Item("enabled").Value = true;

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")
Set siteDefaultsElement = sitesSection.ChildElements.Item("siteDefaults")

Set logFileElement = siteDefaultsElement.ChildElements.Item("logFile")
logFileElement.Properties.Item("logFormat").Value = "W3C"
logFileElement.Properties.Item("directory").Value = "%SystemDrive%\inetpub\logs\LogFiles"
logFileElement.Properties.Item("enabled").Value = True

adminManager.CommitChanges()