Файлы журнала для файла журнала веб-сайта <>

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

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

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

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

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

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

Категории сведений, регистрируемых в iis, можно определить, изменив атрибут logExtFileFlags . Значения по умолчанию: , , , UserNameClientIP, MethodServerIP, , UriQueryTimeTakenUriStem, HttpStatus, , Win32Status, ServerPortUserAgent, HttpSubStatusи .RefererTimeDate

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

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

Настройка

Элемент <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 выберите поля проверка для параметров, которые нужно записать в журнал, снимите флажки проверка для параметров, которые не нужно регистрировать, и нажмите кнопку ОК.
     

Настройка ведения журнала трассировки событий Windows или файлов для журналов 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. Щелкните (Коллекция) и нажмите кнопку с многоточием.

5. Выберите сайт, который требуется настроить, а затем разверните узел logFile.

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

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

   

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

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

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

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

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

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

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

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

4. Щелкните (Коллекция) и нажмите кнопку с многоточием.

5. Выберите сайт, который требуется настроить, а затем разверните узел logFile.

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

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

   

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

Атрибуты

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

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

В следующем примере конфигурации используется атрибут <logFile>logExtFileFlags элемента для указания параметров, регистрируемых iis для веб-сайта Contoso. Атрибут period приводит к тому, что службы IIS создают новый файл журнала W3C каждый час; Атрибут localTimeRollover указывает, что службы IIS используют время на локальном сервере, чтобы определить, когда следует создать файл журнала и присвоить ей имя.

<site name="Contoso" id="2" serverAutoStart="true">
   <application path="/" applicationPool="Contoso">
      <virtualDirectory path="/" physicalPath="C:\Contoso\Content" />
   </application>
   <bindings>
      <binding protocol="http" bindingInformation="*:80:www.contoso.com" />
   </bindings>
   <logFile
      period="Hourly"
      localTimeRollover="true"
      logExtFileFlags="Date, Time, ClientIP, UserName, ServerIP, Method, UriStem, UriQuery, HttpStatus, TimeTaken, ServerPort, UserAgent, HttpSubStatus" />
</site>

Пример кода

В следующих примерах настраивается ведение журнала для сайта Contoso. Каждый пример включает ведение журнала для сайта и настраивает ведение журнала сайта для ежедневного создания нового файла журнала. Они также настраивают службы IIS для использования времени на локальном сервере для создания имен файлов журнала и определения времени создания новых файлов журнала.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /[name='Contoso'].logFile.logFormat:"W3C" 
appcmd.exe set config -section:system.applicationHost/sites /[name='Contoso'].logFile.period:"Daily" 
appcmd.exe set config -section:system.applicationHost/sites /[name='Contoso'].logFile.localTimeRollover:"True" 
appcmd.exe set config -section:system.applicationHost/sites /[name='Contoso'].logFile.enabled:"True" /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");
         ConfigurationElementCollection sitesCollection = sitesSection.GetCollection();

         ConfigurationElement siteElement = FindElement(sitesCollection, "site", "name", @"Contoso");
         if (siteElement == null) throw new InvalidOperationException("Element not found!");

         ConfigurationElement logFileElement = siteElement.GetChildElement("logFile");
         logFileElement["logFormat"] = @"W3C";
         logFileElement["period"] = @"Daily";
         logFileElement["localTimeRollover"] = true;
         logFileElement["enabled"] = true;

         serverManager.CommitChanges();
      }
   }

   private static ConfigurationElement FindElement(ConfigurationElementCollection collection, string elementTagName, params string[] keyValues)
   {
      foreach (ConfigurationElement element in collection)
      {
         if (String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase))
         {
            bool matches = true;
            for (int i = 0; i < keyValues.Length; i += 2)
            {
               object o = element.GetAttributeValue(keyValues[i]);
               string value = null;
               if (o != null)
               {
                  value = o.ToString();
               }
               if (!String.Equals(value, keyValues[i + 1], StringComparison.OrdinalIgnoreCase))
               {
                  matches = false;
                  break;
               }
            }
            if (matches)
            {
               return element;
            }
         }
      }
      return null;
   }
}

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 sitesCollection As ConfigurationElementCollection = sitesSection.GetCollection
       Dim siteElement As ConfigurationElement = FindElement(sitesCollection, "site", "name", "Contoso")

       If (siteElement Is Nothing) Then
          Throw New InvalidOperationException("Element not found!")
       End If

       Dim logFileElement As ConfigurationElement = siteElement.GetChildElement("logFile")
       logFileElement("logFormat") = "W3C"
       logFileElement("period") = "Daily"
       logFileElement("localTimeRollover") = True
       logFileElement("enabled") = True

       serverManager.CommitChanges()
   End Sub

   Private Function FindElement(ByVal collection As ConfigurationElementCollection, ByVal elementTagName As String, ByVal ParamArray keyValues() As String) As ConfigurationElement
      For Each element As ConfigurationElement In collection
         If String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase) Then
            Dim matches As Boolean = True
            Dim i As Integer
            For i = 0 To keyValues.Length - 1 Step 2
               Dim o As Object = element.GetAttributeValue(keyValues(i))
               Dim value As String = Nothing
               If (Not (o) Is Nothing) Then
                  value = o.ToString
               End If
               If Not String.Equals(value, keyValues((i + 1)), StringComparison.OrdinalIgnoreCase) Then
                  matches = False
                  Exit For
               End If
            Next
            If matches Then
               Return element
            End If
         End If
      Next
      Return Nothing
   End Function


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 sitesCollection = sitesSection.Collection;

var siteElementPos = FindElement(sitesCollection, "site", ["name", "Contoso"]);
if (siteElementPos == -1) throw "Element not found!";

var siteElement = sitesCollection.Item(siteElementPos);
var logFileElement = siteElement.ChildElements.Item("logFile");
logFileElement.Properties.Item("logFormat").Value = "W3C";
logFileElement.Properties.Item("period").Value = "Daily";
logFileElement.Properties.Item("localTimeRollover").Value = true;
logFileElement.Properties.Item("enabled").Value = true;

adminManager.CommitChanges();

function FindElement(collection, elementTagName, valuesToMatch) {
   for (var i = 0; i < collection.Count; i++) {
      var element = collection.Item(i);
      if (element.Name == elementTagName) {
         var matches = true;
         for (var iVal = 0; iVal < valuesToMatch.length; iVal += 2) {
            var property = element.GetPropertyByName(valuesToMatch[iVal]);
            var value = property.Value;
            if (value != null) {
               value = value.toString();
            }
            if (value != valuesToMatch[iVal + 1]) {
               matches = false;
               break;
            }
         }
         if (matches) {
            return i;
         }
      }
   }
   return -1;
}

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")
Set sitesCollection = sitesSection.Collection
siteElementPos = FindElement(sitesCollection, "site", Array("name", "Contoso"))

If siteElementPos = -1 Then
   WScript.Echo "Element not found!"
   WScript.Quit
End If

Set siteElement = sitesCollection.Item(siteElementPos)
Set logFileElement = siteElement.ChildElements.Item("logFile")
logFileElement.Properties.Item("logFormat").Value = "W3C"
logFileElement.Properties.Item("period").Value = "Daily"
logFileElement.Properties.Item("localTimeRollover").Value = True
logFileElement.Properties.Item("enabled").Value = True

adminManager.CommitChanges()

Function FindElement(collection, elementTagName, valuesToMatch)
   For i = 0 To CInt(collection.Count) - 1
      Set element = collection.Item(i)
      If element.Name = elementTagName Then
         matches = True
         For iVal = 0 To UBound(valuesToMatch) Step 2
            Set property = element.GetPropertyByName(valuesToMatch(iVal))
            value = property.Value
            If Not IsNull(value) Then
               value = CStr(value)
            End If
            If Not value = CStr(valuesToMatch(iVal + 1)) Then
               matches = False
               Exit For
            End If
         Next
         If matches Then
            Exit For
         End If
      End If
   Next
   If matches Then
      FindElement = i
   Else
      FindElement = -1
   End If
End Function