File Log untuk LogFile Situs <Web>

Gambaran Umum

Elemen <logFile><site> elemen berisi atribut yang memungkinkan Anda mengonfigurasi pengelogan untuk situs di IIS 7 dan yang lebih baru.

Misalnya, Anda dapat mengaktifkan atau menonaktifkan pengelogan, mengonfigurasi format file log IIS, menentukan kategori informasi untuk disimpan dalam file log, dan mengubah direktori tempat file log disimpan. Anda juga dapat menggunakan <logFile> elemen untuk mengontrol seberapa sering IIS membuat file log baru berdasarkan ukuran file log atau interval waktu dan ukuran maksimum (dalam byte) yang dapat menjadi file log.

Secara default, IIS 7 dan yang lebih baru menggunakan format file log World Wide Web Consortium (W3C). Anda dapat mengubah pengaturan ini dengan memodifikasi atribut logFormat ke IIS, NCSA, atau Kustom.

• Mengatur atribut pengelogan ODBC di <odbcLogging> elemen . Atribut ini menentukan Nama Sumber Data Sistem (DSN), nama tabel, nama pengguna, dan kata sandi untuk koneksi ODBC.
• Mengatur atribut pengelogan kustom yang benar dalam <logFile> elemen . Atribut ini harus mengatur format file log ke "Kustom" dan ID kelas plug-in log kustom ke "{FF16065B-DE82-11CF-BC0A-00AA006111E0}".

Untuk informasi selengkapnya tentang pengelogan ODBC, lihat <odbcLogging> elemen .

Anda dapat menentukan kategori informasi yang dicatat IIS dengan mengedit atribut logExtFileFlags . Nilai defaultnya adalah Date, , Time, UserNameClientIP, ServerIP, Method, UriStem, UriQueryTimeTaken, HttpStatus, , Win32Status, ServerPort, UserAgent, HttpSubStatus, , dan Referer.

IIS 8.5 memungkinkan Anda mencatat bidang kustom selain kumpulan standar yang dicatat. Format file log harus W3C untuk menambahkan bidang kustom. Untuk informasi selengkapnya, lihat customFields.

Kompatibilitas

Siapkan

Elemen <logFile> ini disertakan dalam penginstalan default IIS 7 dan yang lebih baru.

Bagaimana Caranya

Cara mengedit pengaturan pengelogan untuk situs

1. Buka Pengelola Layanan Informasi Internet (IIS):

   • Jika Anda menggunakan Windows Server 2012 atau Windows Server 2012 R2:

     • Pada bilah tugas, klik Manajer Server, klik Alat, lalu klik Pengelola Layanan Informasi Internet (IIS).

   • Jika Anda menggunakan Windows 8 atau Windows 8.1:

     • Tahan tombol Windows, tekan huruf X, lalu klik Panel Kontrol.
     • Klik Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).

   • Jika Anda menggunakan Windows Server 2008 atau Windows Server 2008 R2:

     • Pada bilah tugas, klik Mulai, arahkan ke Alat Administratif, lalu klik Pengelola Layanan Informasi Internet (IIS).

   • Jika Anda menggunakan Windows Vista atau Windows 7:

     • Pada taskbar, klik Mulai, lalu klik Panel Kontrol.
     • Klik dua kali Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).

2. Di panel Koneksi , perluas nama server, perluas Situs, lalu klik situs Web tempat Anda ingin mengonfigurasi pengelogan.

3. Di panel Beranda , klik dua kali Pengelogan.
   

4. Di panel Pengelogan , pilih format file log dalam kotak Format , lalu ketik jalur ke direktori tempat Anda menyimpan file log dalam kotak Direktori atau klik Telusuri... untuk memilih direktori tempat menyimpan file log.
   

5. Jika Anda memilih untuk menggunakan format file log W3C:

   • Klik Pilih Bidang untuk memilih tipe informasi yang akan dicatat.
   • Dalam kotak dialog Bidang Pengelogan W3C , pilih kotak centang untuk opsi yang ingin Anda catat, kosongkan kotak centang untuk opsi yang tidak ingin Anda catat, lalu klik OK.
     

Cara mengonfigurasi ETW atau pengelogan file untuk log W3C

1. Buka Pengelola Layanan Informasi Internet (IIS):

   • Jika Anda menggunakan Windows Server 2012 R2:

     • Pada bilah tugas, klik Manajer Server, klik Alat, lalu klik Pengelola Layanan Informasi Internet (IIS).

   • Jika Anda menggunakan Windows 8.1:

     • Tahan tombol Windows, tekan huruf X, lalu klik Panel Kontrol.
     • Klik Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).

2. Di panel Koneksi , perluas nama server, perluas Situs, lalu pilih situs.

3. Di panel beranda situs, klik dua kali Pengelogan.

4. Di beranda Pengelogan , untuk Tujuan Peristiwa Log, pilih File log saja, hanya peristiwa ETW, atau File log dan peristiwa ETW.

   

Cara mengonfigurasi pembersihan log W3C menurut jumlah entri

1. Buka Pengelola Layanan Informasi Internet (IIS):

   • Jika Anda menggunakan Windows Server 2012 R2:

     • Pada bilah tugas, klik Manajer Server, klik Alat, lalu klik Pengelola Layanan Informasi Internet (IIS).

   • Jika Anda menggunakan Windows 8.1:

     • Tahan tombol Windows, tekan huruf X, lalu klik Panel Kontrol.
     • Klik Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).

2. Di panel Koneksi , perluas server, lalu klik dua kali Editor Konfigurasi.

3. Di Editor Konfigurasi, untuk Bagian, perluas system.applicationHost, lalu pilih situs.

4. Klik (Koleksi), lalu klik elipsis.

5. Pilih situs yang ingin Anda konfigurasi, lalu perluas logFile.

6. Untuk flushByEntryCountW3Clog, masukkan jumlah peristiwa yang akan disimpan di buffer sebelum dihapus ke file log.

7. Di panel Tindakan , klik Terapkan.

   

Cara mengonfigurasi panjang baris log maksimum

1. Buka Pengelola Layanan Informasi Internet (IIS):

   • Jika Anda menggunakan Windows Server 2012 R2:

     • Pada bilah tugas, klik Manajer Server, klik Alat, lalu klik Pengelola Layanan Informasi Internet (IIS).

   • Jika Anda menggunakan Windows 8.1:

     • Tahan tombol Windows, tekan huruf X, lalu klik Panel Kontrol.
     • Klik Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).

2. Di panel Koneksi , perluas server, lalu klik dua kali Editor Konfigurasi.

3. Di Editor Konfigurasi, untuk Bagian, perluas system.applicationHost, lalu pilih situs.

4. Klik (Koleksi), lalu klik elipsis.

5. Pilih situs yang ingin Anda konfigurasi, lalu perluas logFile.

6. Untuk maxLogLineLength, masukkan jumlah maksimum byte dalam satu baris file log.

7. Di panel Tindakan , klik Terapkan.

   

Konfigurasi

Atribut

Elemen Anak

Sampel Konfigurasi

Contoh konfigurasi berikut menggunakan atribut logExtFileFlags dari <logFile> elemen untuk menentukan pengaturan yang dicatat IIS untuk situs Web bernama Contoso. Atribut periode menyebabkan IIS membuat file log W3C baru setiap jam; atribut localTimeRollover menentukan bahwa IIS menggunakan waktu di server lokal untuk menentukan kapan harus membuat dan memberi nama file log baru.

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

Kode Sampel

Contoh berikut mengonfigurasi pengelogan untuk situs bernama Contoso. Setiap contoh memungkinkan pengelogan untuk situs dan mengonfigurasi pengelogan situs untuk menghasilkan file log baru setiap hari. Mereka juga mengonfigurasi IIS untuk menggunakan waktu di server lokal untuk menghasilkan nama file log dan menentukan kapan harus menghasilkan file log baru.

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