集中式二进制日志文件 <centralBinaryLogFile>

项目
03/25/2024

概述

<centralBinaryLogFile> 元素指定服务器上所有站点的集中式二进制日志设置。

注意

需要将父 <log> 元素的 centralLogFileMode 属性设置为 CentralBinary，才能使 <centralW3CLogFile> 元素上的属性生效。如果 <log> 元素的 centralLogFileMode 属性设置为 CentralW3C 或 Site，则 <centralW3CLogFile> 元素上的属性将被忽略。

注意

W3C 格式的日志文件是大多数日志分析实用工具可处理的基于文本的文件。二进制日志文件使用专有存储格式，该格式需要使用能够处理采用该格式的日志文件的应用程序，例如 Microsoft 的 LogParser 实用工具。

兼容性

版本	说明
IIS 10.0	`<centralBinaryLogFile>` 元素在 IIS 10.0 中未进行修改。
IIS 8.5	`<centralBinaryLogFile>` 元素在 IIS 8.5 中未进行修改。
IIS 8.0	`<centralBinaryLogFile>` 元素在 IIS 8.0 中未进行修改。
IIS 7.5	`<centralBinaryLogFile>` 元素在 IIS 7.5 中未进行修改。
IIS 7.0	`<log>` 元素的 `<centralBinaryLogFile>` 元素是在 IIS 7.0 中引入的。
IIS 6.0	`<log>` 元素取代了 IIS 6.0 的 CentralBinaryLoggingEnabled 标志。

安装

<log> 元素的 <centralBinaryLogFile> 元素包含在 IIS 7 的默认安装中。

操作方式

如何为服务器启用集中式二进制日志记录

打开 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)管理器”。
在“连接”窗格中，单击服务器名称。
在服务器的“主页”窗格中，双击“日志记录”。
在“日志记录”页上“一个日志文件/每”下的下拉列表中选择“服务器”，然后从“格式”下拉列表中选择“二进制”。
在“操作”窗格中，单击“应用”。

配置

特性

属性说明

directory 可选的字符串属性。

指定写入日志条目的目录。

enabled 可选布尔属性。

指定是否启用集中二进制日志记录。此外，必须将 centralLogFileMode 设置为 CentralBinary 才能完全启用集中式二进制日志记录。

默认值为 false。

localTimeRollover 可选布尔属性。

指定是基于本地时间还是协调世界时 (UTC) 创建新日志文件。值 true 表示新日志文件基于本地时间；false 表示基于 UTC。

默认值为 false。

period

可选 enum 属性。

指定清除日志文件内容的频率。

period 属性可为以下值之一。

默认值为 Daily。

值	说明
`MaxSize`	只要日志文件达到 truncateSize 属性指定的大小，日志文件就会被清除。数值为 `0`。
`Daily`	每天清除日志文件。数值为 `1`。
`Weekly`	每周清除一次日志文件。数值为 `2`。
`Monthly`	每月清除一次日志文件。数值为 `3`。
`Hourly`	每小时清除一次日志文件。数值为 `4`。

truncateSize 可选 int64 属性。

指定日志文件内容应截断的大小。当 period 属性的值为 maxSize 时，必须设置此属性。大小须介于 1048576 (1 MB) 和 4294967295 (4 GB) 之间。

默认值为 20971520 (20 MB)。

子元素

无。

配置示例

以下配置示例指定 IIS 将使用集中式二进制日志记录，并配置每天进行二进制日志文件轮换。

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

代码示例

以下代码示例指定 IIS 将使用集中式二进制日志记录，并配置每天进行二进制日志文件轮换。

AppCmd.exe

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

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

注意

使用 AppCmd.exe 配置这些设置时，必须确保将 commit 参数设置为 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"] = @"CentralBinary";
         ConfigurationElement centralBinaryLogFileElement = logSection.GetChildElement("centralBinaryLogFile");
         centralBinaryLogFileElement["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") = "CentralBinary"
      Dim centralBinaryLogFileElement As ConfigurationElement = logSection.GetChildElement("centralBinaryLogFile")
      centralBinaryLogFileElement("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 = "CentralBinary";
var centralBinaryLogFileElement = logSection.ChildElements.Item("centralBinaryLogFile");
centralBinaryLogFileElement.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 = "CentralBinary"
Set centralBinaryLogFileElement = logSection.ChildElements.Item("centralBinaryLogFile")
centralBinaryLogFileElement.Properties.Item("period").Value = "Daily"

adminManager.CommitChanges()

通过