記錄檔記錄檔 <>

發行項
07/19/2023

概觀

元素 <log> 會指定 Internet Information Services (IIS) 7 的數個全域記錄選項。例如， centralLogFileMode 屬性會指定是否啟用月臺層級記錄、中央 W3C 記錄或中央二進位記錄。

月臺層級記錄會為伺服器上的每個月臺建立個別記錄檔目錄，其中每個資料夾只包含該網站的記錄檔。中央記錄可讓您針對或 <centralW3CLogFile> 元素的period屬性 <centralBinaryLogFile> 所指定的期間內，針對所有月臺使用單一記錄檔。時間週期可以是每日、每週、每月、每小時或檔案大小上限。

注意

W3C 格式的記錄檔是以文字為基礎的檔案，大部分的記錄剖析公用程式都可以處理。二進位記錄檔會使用專屬的儲存格式，需要使用可處理該格式之記錄檔的應用程式，例如 Microsoft 的 LogParser 公用程式。

相容性

版本	備註
IIS 10.0	未在 IIS 10.0 中修改專案 `<log>` 。
IIS 8.5	未在 IIS 8.5 中修改專案 `<log>` 。
IIS 8.0	未在 IIS 8.0 中修改專案 `<log>` 。
IIS 7.5	未在 IIS 7.5 中修改專案 `<log>` 。
IIS 7.0	元素 `<log>` 是在 IIS 7.0 中引進。
IIS 6.0	元素 `<log>` 會取代下列 IIS 6.0 屬性： CentralBinaryLoggingEnabled CentralW3CLoggingEnabled LogInUTF8

安裝程式

元素 <log> 包含在 IIS 7 的預設安裝中。

作法

如何啟用伺服器的中央二進位記錄

開啟 [Internet Information Services (IIS) 管理員：
- 如果您使用 Windows Server 2012 或 Windows Server 2012 R2：
  - 在工作列上，依序按一下 [伺服器管理員]、[工具]，然後按一下 [Internet Information Services (IIS) Manager]。
- 如果您使用 Windows 8 或 Windows 8.1：
  - 按住Windows鍵，按字母X，然後按一下[主控台]。
  - 按一下 [系統管理工具]，然後按兩下 [ Internet Information Services (IIS) Manager]。
- 如果您使用 Windows Server 2008 或 Windows Server 2008 R2：
  - 在工作列上，按一下 [ 開始]，指向 [ 系統管理工具]，然後按一下 [ Internet Information Services (IIS) 管理員]。
- 如果您使用 Windows Vista 或 Windows 7：
  - 在工作列上，按一下 [開始]，然後按一下[主控台]。
  - 按兩下 [系統管理工具]，然後按兩下 [ Internet Information Services] (IIS) Manager。
在 [ 連線] 窗格中，按一下伺服器名稱。
在伺服器的 [ 首頁] 窗格中，按兩下 [記錄]。
在 [記錄] 頁面的[每一個記錄檔] 下，從下拉式清單中選取 [伺服器]，然後從 [格式] 下拉式清單中選擇 [二進位]。
在 [動作] 窗格中按一下 [套用]。

如何啟用伺服器的中央 W3C 記錄

開啟 [Internet Information Services (IIS) 管理員：
- 如果您使用 Windows Server 2012 或 Windows Server 2012 R2：
  - 在工作列上，依序按一下 [伺服器管理員]、[工具]，然後按一下 [Internet Information Services (IIS) Manager]。
- 如果您使用 Windows 8 或 Windows 8.1：
  - 按住Windows鍵，按字母X，然後按一下[主控台]。
  - 按一下 [系統管理工具]，然後按兩下 [ Internet Information Services (IIS) Manager]。
- 如果您使用 Windows Server 2008 或 Windows Server 2008 R2：
  - 在工作列上，按一下 [ 開始]，指向 [ 系統管理工具]，然後按一下 [ Internet Information Services (IIS) 管理員]。
- 如果您使用 Windows Vista 或 Windows 7：
  - 在工作列上，按一下 [開始]，然後按一下[主控台]。
  - 按兩下 [系統管理工具]，然後按兩下 [ Internet Information Services] (IIS) Manager。
在 [ 連線] 窗格中，按一下伺服器名稱。
在伺服器的 [ 首頁] 窗格中，按兩下 [記錄]。
在 [記錄] 頁面的[每一個記錄檔]下，從下拉式清單中選取 [伺服器]，然後從 [格式] 下拉式清單中選擇[W3C]。
在 [動作] 窗格中按一下 [套用]。

組態

屬性

屬性描述

centralLogFileMode

選擇性列舉屬性。

指定伺服器的中央記錄模式。

centralLogFileMode屬性可以有下列其中一個可能的值。預設值為 Site。

值	描述
`Site`	設定所有月臺使用月臺記錄，而不是集中記錄。這是預設值。數值為 0。
`CentralBinary`	為網頁伺服器上的所有網站建立一個記錄檔。記錄檔中的資料是以二進位為基礎且無法自訂的未格式化資料。數值為 1。
`CentralW3C`	以文字為基礎的可自訂 ASCII 格式，將網頁伺服器上的所有網站要求記錄到單一中央記錄檔。數值為 2。

logInUTF8 選擇性的 Boolean 屬性。

指定 IIS 是否應記錄 UCS 轉換格式 8 (UTF-8) 中的所有字串。此設定會將全伺服器套用至所有文字模式記錄。

預設值是 true。

子元素

元素	描述
`centralBinaryLogFile`	選擇性項目。指定伺服器上所有月臺的中央二進位記錄檔設定。
`centralW3CLogFile`	選擇性項目。指定伺服器上所有網站的中央 W3C 記錄設定。

組態範例

下列組態範例會指定 IIS 將使用月臺層級記錄。

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

下列組態範例會指定 IIS 將使用中央二進位記錄，並每天設定二進位記錄檔輪替。

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

下列組態範例會指定 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 將使用中央二進位記錄，並每天設定二進位記錄檔輪替。

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設定這些設定時，請務必將認可參數 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()

下列程式碼範例會指定 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()

共用方式為

記錄檔記錄檔 <>

概觀

相容性

安裝程式

作法

如何啟用伺服器的中央二進位記錄

如何啟用伺服器的中央 W3C 記錄

組態

屬性

子元素

組態範例

範例程式碼

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

意見反應

其他資源