Central W3C Log File <centralW3CLogFile>

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

Элемент <centralW3CLogFile> задает параметры центрального журнала W3C для всех сайтов на сервере.

Примечание

Необходимо задать для атрибута centralLogFileMode родительского <log> элемента значение CentralW3C , чтобы атрибуты <centralW3CLogFile> элемента имели эффект. Если атрибут <log>centralLogFileMode элемента имеет значение CentralBinary или Site, атрибуты <centralW3CLogFile> элемента будут игнорироваться.

Примечание

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

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

Версия Примечания
IIS 10.0 Элемент <centralW3CLogFile> не был изменен в IIS 10.0.
IIS 8,5 Элемент <centralW3CLogFile> не был изменен в IIS 8.5.
IIS 8,0 Элемент <centralW3CLogFile> не был изменен в IIS 8.0.
IIS 7,5 Элемент <centralW3CLogFile> не был изменен в IIS 7.5.
IIS 7.0 Элемент <centralW3CLogFile> элемента появился <log> в IIS 7.0.
IIS 6,0 Элемент <log> заменяет флаг IIS 6.0 CentralW3CLoggingEnabled .

Настройка

Элемент <centralW3CLogFile><log> элемента включен в установку IIS 7 по умолчанию.

Инструкции

Включение централизованного ведения журнала W3C для сервера

  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. На странице Ведение журнала в разделе Один файл журнала в раскрывающемся списке выберите Сервер, а затем в раскрывающемся списке Формат выберите W3C.
    Снимок экрана: экран ведения журнала с выделенным раскрывающимся списком

  5. Щелкните Применить в области Действия.

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

Атрибуты

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

Указывает каталог, в который записываются записи журнала.

Значение по умолчанию — %SystemDrive%\inetpub\logs\LogFiles.
enabled Дополнительный логический атрибут.

Указывает, включено ли централизованное ведение журнала W3C.

Значение по умолчанию — true.
localTimeRollover Дополнительный логический атрибут.

Указывает, создается ли новый файл журнала на основе местного времени или времени в формате UTC. Значение true означает, что новый файл журнала основан на местном времени; Значение false означает, что оно основано на формате UTC.

Значение по умолчанию — false.
logExtFileFlags Необязательный атрибут flags.

Указывает поля для записи в журнал.

Атрибут logExtFileFlags может иметь одно из следующих значений или список этих значений. По умолчанию используется список следующих значений: Date, Time, ClientIP, UserName, ServerIPSiteNameUriQueryMethodUriStem, HttpStatus, TimeTaken,Win32Status , ServerPort, , , UserAgent, . HttpSubStatus
Значение Описание
Date Дата, в которую произошло действие.

Числовое значение равно 1.
Time Время в формате UTC, в которое произошло действие.

Числовое значение равно 2.
ClientIP IP-адрес отправившего запрос клиента.

Числовое значение равно 4.
UserName Имя пользователя, прошедшего проверку подлинности, который обращается к серверу. Анонимные пользователи обозначаются дефисом.

Числовое значение равно 8.
SiteName Имя сервера, на котором была создана запись файла журнала.

Числовое значение равно 16.
ComputerName Имя компьютера, с которого был сделан запрос.

Числовое значение равно 32.
ServerIP IP-адрес сервера, на котором была создана запись файла журнала.

Числовое значение равно 64.
Method Запрошенное действие, например метод GET .

Числовое значение равно 128.
UriStem Целевой объект действия, например, Default.htm.

Числовое значение равно 256.
UriQuery Запрос, если таковой был, который клиент пытался выполнить. Запрос универсального кода ресурса (URI) требуется только для динамических страниц.

Числовое значение равно 512.
HttpStatus Код состояния HTTP.

Числовое значение равно 1024.
Win32Status Код состояния Windows.

Числовое значение равно 2048.
BytesSent Количество байтов, отправленных сервером.

Числовое значение равно 4096.
BytesRecv Количество байтов, полученных сервером.

Числовое значение равно 8192.
TimeTaken Время выполнения действия в миллисекундах.

Числовое значение равно 16384.
ServerPort Номер порта сервера, настроенный для службы.

Числовое значение равно 32768.
UserAgent Тип браузера, используемый клиентом.

Числовое значение равно 65536.
Cookie Содержимое файла cookie, отправленного или полученного, если файл cookie был отправлен или получен.

Числовое значение равно 131072.
Referer Сайт, который пользователь в последний раз посещал. Этот сайт предоставил ссылку на текущий сайт.

Числовое значение равно 262144.
ProtocolVersion Версия протокола, используемая клиентом.

Числовое значение равно 524288.
Host Имя заголовка узла, если есть заголовок узла.

Числовое значение равно 1048576.
HttpSubStatus Код ошибки подсостояние.

Числовое значение равно 2097152.
period Необязательный атрибут перечисления.

Указывает, как часто закрывается текущий файл журнала и запускается новый файл журнала.

Атрибут period может быть одним из следующих возможных значений.

Значение по умолчанию — Daily.
Значение Описание
MaxSize Запускайте новые файлы журнала всякий раз, когда файл журнала достигает размера, указанного атрибутом truncateSize .

Числовое значение равно 0.
Daily Каждый день запускайте новые файлы журналов.

Числовое значение равно 1.
Weekly Запускайте новые файлы журналов раз в неделю.

Числовое значение равно 2.
Monthly Запускайте новые файлы журналов раз в месяц.

Числовое значение равно 3.
Hourly Каждый час запускайте новые файлы журналов.

Числовое значение равно 4.
truncateSize Необязательный атрибут int64.

Указывает размер (в байтах), при котором содержимое файла журнала будет усечено. Этот атрибут необходимо задать, если значение атрибута period равно maxSize. Размер должен быть от 1048576 (1 мегабайт) до 4294967295 (4 гигабайта).

Значение по умолчанию — 20971520 (20 мегабайт).

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

Отсутствует.

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

Следующий пример конфигурации указывает, что СЛУЖБЫ IIS будут использовать централизованное ведение журнала W3C, и настраивает смену файлов журнала W3C на ежедневной основе.

<log centralLogFileMode="CentralW3C">
   <centralBinaryLogFile enabled="true" directory="%SystemDrive%\inetpub\logs\LogFiles" />
   <centralW3CLogFile enabled="true" directory="%SystemDrive%\inetpub\logs\LogFiles" period="Daily" />
</log>

Пример кода

В следующих примерах кода указывается, что СЛУЖБЫ IIS будут использовать централизованное ведение журнала W3C и настраивать смену файлов журнала W3C на ежедневной основе.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/log /centralLogFileMode:"CentralW3C" /commit:apphost

appcmd.exe set config -section:system.applicationHost/log /centralW3CLogFile.period:"Daily" /commit:apphost

Примечание

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

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 logSection = config.GetSection("system.applicationHost/log");
         logSection["centralLogFileMode"] = @"CentralW3C";
         ConfigurationElement centralW3CLogFileElement = logSection.GetChildElement("centralW3CLogFile");
         centralW3CLogFileElement["period"] = @"Daily";

         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 logSection As ConfigurationSection = config.GetSection("system.applicationHost/log")
      logSection("centralLogFileMode") = "CentralW3C"
      Dim centralW3CLogFileElement As ConfigurationElement = logSection.GetChildElement("centralW3CLogFile")
      centralW3CLogFileElement("period") = "Daily"

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";

var logSection = adminManager.GetAdminSection("system.applicationHost/log", "MACHINE/WEBROOT/APPHOST");
logSection.Properties.Item("centralLogFileMode").Value = "CentralW3C";
var centralW3CLogFileElement = logSection.ChildElements.Item("centralW3CLogFile");
centralW3CLogFileElement.Properties.Item("period").Value = "Daily";

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"

Set logSection = adminManager.GetAdminSection("system.applicationHost/log", "MACHINE/WEBROOT/APPHOST")
logSection.Properties.Item("centralLogFileMode").Value = "CentralW3C"
Set centralW3CLogFileElement = logSection.ChildElements.Item("centralW3CLogFile")
centralW3CLogFileElement.Properties.Item("period").Value = "Daily"

adminManager.CommitChanges()