用于网站的默认日志文件设置 <logFile>

概述

<siteDefaults> 元素的 <logFile> 元素包含可用于为 IIS 7 及更高版本上的站点配置默认日志记录的属性。

例如，你可以启用或禁用日志记录、配置 IIS 日志文件的格式、指定要存储在日志文件中的信息类别，以及更改日志文件的存储目录。 还可以使用 <logFile> 元素来控制 IIS 根据日志文件大小或时间间隔创建新日志文件的频率，以及日志文件可以达到的最大大小（以字节为单位）。

默认情况下，IIS 7 及更高版本使用万维网联合会 (W3C) 日志文件格式。 可以通过将 logFormat 属性修改为 IIS、NCSA 或 Custom 来更改此设置。

• 在 <odbcLogging> 元素中设置 ODBC 日志记录属性。 这些属性指定 ODBC 连接的系统数据源名称 (DSN)、表名、用户名和密码。
• 在 <logFile> 元素中设置正确的自定义日志记录属性。 这些属性必须将日志文件格式设置为“Custom”，并将自定义日志插件类 ID 设置为“{FF16065B-DE82-11CF-BC0A-00AA006111E0}”。

有关 ODBC 日志记录的详细信息，请参阅 <odbcLogging> 元素。

可以通过编辑 logExtFileFlags 属性来定义 IIS 记录的信息类别。 默认值为 Date、Time、ClientIP、UserName、ServerIP、Method、UriStem、UriQuery、TimeTaken、HttpStatus、Win32Status、ServerPort、UserAgent、HttpSubStatus 和 Referer。

除了标准记录集之外，IIS 8.5 还支持记录自定义字段。 日志文件格式必须是 W3C 才能添加自定义字段。 有关详细信息，请参阅 customFields。

兼容性

安装

<logFile> 元素包含在 IIS 7 及更高版本的默认安装中。

操作方式

如何编辑服务器的默认日志记录设置

1. 打开 Internet Information Services (IIS) 管理器：

   • 如果使用的是 Windows Server 2012 或 Windows Server 2012 R2：

     • 在任务栏上，单击“服务器管理器”，单击“工具”，然后单击“Internet Information Services (IIS) 管理器”。

   • 如果使用的是 Windows 8 或 Windows 8.1：

     • 按住 Windows 键，按字母 X，然后单击“控制面板”。
     • 单击“管理工具”，然后双击“Internet Information Services (IIS) 管理器”。

   • 如果使用的是 Windows Server 2008 或 Windows Server 2008 R2：

     • 在任务栏上，单击“开始”，指向“管理工具”，然后单击“Internet Information Services (IIS) 管理器”。

   • 如果使用的是 Windows Vista 或 Windows 7：

     • 在任务栏上，单击“开始”，然后单击“控制面板”。
     • 双击“管理工具”，然后双击“Internet Information Services (IIS) 管理器”。

2. 在“连接”窗格中，单击要为其配置日志记录的服务器名称。

3. 在“开始”窗格中，双击“日志记录”。
   

4. 在“日志记录”窗格的“格式”框中，选择日志文件格式，然后在“目录”框中键入存储日志文件的目录的路径，或单击“浏览...”以选择要在其中存储日志文件的目录。
   

5. 如果选择使用 W3C 日志文件格式：

   • 单击“选择字段”以选择要记录的信息类型。
   • 在“W3C 日志记录字段”对话框中，选中要记录的选项的复选框，清除不想记录的选项的复选框，然后单击“确定”。
     

如何为 W3C 日志配置 ETW 或文件日志记录

1. 打开 Internet Information Services (IIS) 管理器：

   • 如果使用的是 Windows Server 2012 R2：

     • 在任务栏上，单击“服务器管理器”，单击“工具”，然后单击“Internet Information Services (IIS) 管理器”。

   • 如果使用的是 Windows 8.1：

     • 按住 Windows 键，按字母 X，然后单击“控制面板”。
     • 单击“管理工具”，然后双击“Internet Information Services (IIS) 管理器”。

2. 在“连接”窗格中，展开“站点”节点。

3. 在站点的主窗格中，双击“日志记录”。

4. 在“日志记录”主页中，对于“日志事件目标”，选择“仅日志文件”、“仅 ETW 事件”或“日志文件和 ETW 事件”。

   

如何配置按条目计数刷新 W3C 日志

1. 打开 Internet Information Services (IIS) 管理器：

   • 如果使用的是 Windows Server 2012 R2：

     • 在任务栏上，单击“服务器管理器”，单击“工具”，然后单击“Internet Information Services (IIS) 管理器”。

   • 如果使用的是 Windows 8.1：

     • 按住 Windows 键，按字母 X，然后单击“控制面板”。
     • 单击“管理工具”，然后双击“Internet Information Services (IIS) 管理器”。

2. 在“连接”窗格中选择服务器，然后双击“配置编辑器”。

3. 在“配置编辑器”的“部分”中，展开 system.applicationHost，然后选择“站点”。

4. 展开 siteDefaults，然后展开 logFile。

5. 对于“flushByEntryCountW3Clog”，输入在将事件刷新到日志文件之前存储在缓冲区中的事件数。

6. 在“操作”窗格中，单击“应用”。

   

如何配置最大日志行长度

1. 打开 Internet Information Services (IIS) 管理器：

   • 如果使用的是 Windows Server 2012 R2：

     • 在任务栏上，单击“服务器管理器”，单击“工具”，然后单击“Internet Information Services (IIS) 管理器”。

   • 如果使用的是 Windows 8.1：

     • 按住 Windows 键，按字母 X，然后单击“控制面板”。
     • 单击“管理工具”，然后双击“Internet Information Services (IIS) 管理器”。

2. 在“连接”窗格中，展开服务器，然后双击“配置编辑器”。

3. 在“配置编辑器”的“部分”中，展开 system.applicationHost，然后选择“站点”。

4. 展开 siteDefaults，然后展开 logFile。

5. 对于“maxLogLineLength”，输入日志文件单行的最大字节数。

6. 在“操作”窗格中，单击“应用”。

   

配置

特性

子元素

配置示例

以下配置示例指定默认 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>

代码示例

以下代码示例配置 IIS 7 的默认 logFile 选项。

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()