網站 < logFile 的記錄檔>

概觀

元素 <logFile> 的 <site> 元素包含屬性，可讓您在 IIS 7 和更新版本上設定月臺的記錄。

例如，您可以啟用或停用記錄、設定 IIS 記錄檔的格式、指定要儲存在記錄檔中的資訊類別，以及變更儲存記錄檔的目錄。 您也可以使用 <logFile> 元素來控制 IIS 根據記錄檔大小或時間間隔建立新記錄檔的頻率，以及記錄檔可以變成的位元組大小上限，) 以位元組為單位 (大小上限。

根據預設，IIS 7 和更新版本會使用 World Wide Web Consortium (W3C) 記錄檔格式。 您可以將 logFormat 屬性修改為 IIS、 NCSA或 Custom來變更此設定。

• 在 專案中設定 ODBC 記錄屬性 <odbcLogging> 。 這些屬性會指定 ODBC 連線的系統資料來源名稱 (DSN) 、資料表名稱、使用者名稱和密碼。
• 在 元素中 <logFile> 設定正確的自訂記錄屬性。 這些屬性必須將記錄檔格式設定為 「Custom」，並將自訂記錄外掛程式類別識別碼設定為 「{FF16065B-DE82-11CF-BC0A-00AA006111E0}」。

如需 ODBC 記錄的詳細資訊，請參閱 <odbcLogging> 元素。

您可以編輯 logExtFileFlags 屬性，以定義 IIS 記錄的資訊類別。 預設值為 Date 、、、、 ClientIPUriStemMethodServerIPUriQueryUserNameUserAgentServerPortHttpStatusTimeTakenWin32Status 、、 HttpSubStatus 和 。 RefererTime

除了標準記錄集之外，IIS 8.5 還可讓您記錄自訂欄位。 記錄檔格式必須是 W3C，才能新增自訂欄位。 如需詳細資訊，請參閱customFields。

相容性

安裝程式

專案 <logFile> 包含在 IIS 7 和更新版本的預設安裝中。

作法

如何編輯網站的記錄設定

1. (IIS) 管理員開啟 Internet Information Services：

   • 如果您使用 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. (IIS) 管理員開啟 Internet Information Services：

   • 如果您使用 Windows Server 2012 R2：

     • 在工作列上，依序按一下 [伺服器管理員]、[工具]，然後按一下 [Internet Information Services] ([IIS) 管理員]。

   • 如果您使用 Windows 8.1：

     • 按住Windows鍵，按字母X，然後按一下[主控台]。
     • 按一下 [ 系統管理工具]，然後按兩下 [Internet Information Services] ([IIS) 管理員]。

2. 在 [ 連線 ] 窗格中，展開伺服器名稱、展開 [站台]，然後選取月臺。

3. 在網站的首頁窗格中，按兩下 [記錄]。

4. 在 [記錄 ] 首頁的 [ 記錄事件目的地] 中，選取 [僅限記錄檔]、[ 僅限 ETW 事件] 或 [記錄檔] 和 [ETW 事件]。

   

如何依專案計數設定排清 W3C 記錄

1. (IIS) 管理員開啟 Internet Information Services：

   • 如果您使用 Windows Server 2012 R2：

     • 在工作列上，依序按一下 [伺服器管理員]、[工具]，然後按一下 [Internet Information Services] ([IIS) 管理員]。

   • 如果您使用 Windows 8.1：

     • 按住Windows鍵，按字母X，然後按一下[主控台]。
     • 按一下 [ 系統管理工具]，然後按兩下 [Internet Information Services] ([IIS) 管理員]。

2. 在 [ 連線 ] 窗格中展開伺服器，然後按兩下 [ 組態編輯器]。

3. 在 [ 組態編輯器] 中，針對 [ 區段] 展開 system.applicationHost ，然後選取 [月臺]。

4. 按一下 [ (集合]) ，然後按一下省略號。

5. 選取您要設定的網站，然後展開 logFile。

6. 針對 flushByEntryCountW3Clog，輸入要儲存在緩衝區中的事件數目，再排清到記錄檔。

7. 在 [ 動作 ] 窗格中，按一下 [ 套用]。

   

如何設定記錄行長度上限

1. (IIS) 管理員開啟 Internet Information Services：

   • 如果您使用 Windows Server 2012 R2：

     • 在工作列上，依序按一下 [伺服器管理員]、[工具]，然後按一下 [Internet Information Services] ([IIS) 管理員]。

   • 如果您使用 Windows 8.1：

     • 按住Windows鍵，按字母X，然後按一下[主控台]。
     • 按一下 [ 系統管理工具]，然後按兩下 [Internet Information Services] ([IIS) 管理員]。

2. 在 [ 連線 ] 窗格中展開伺服器，然後按兩下 [ 組態編輯器]。

3. 在 [ 組態編輯器] 中，針對 [ 區段] 展開 system.applicationHost ，然後選取 [月臺]。

4. 按一下 [ (集合]) ，然後按一下省略號。

5. 選取您要設定的網站，然後展開 logFile。

6. 針對 maxLogLineLength，在記錄檔的單一行中輸入最大位元組數。

7. 在 [ 動作 ] 窗格中，按一下 [ 套用]。

   

組態

屬性

子元素

組態範例

下列組態範例會使用 專案的 logExtFileFlags 屬性 <logFile> ，指定名為 Contoso 的網站 IIS 記錄的設定。 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