Bagikan melalui


Log <log>

Gambaran Umum

Elemen menentukan <log> beberapa opsi pengelogan global untuk Internet Information Services (IIS) 7. Misalnya, atribut centralLogFileMode menentukan apakah pengelogan tingkat situs, pengelogan W3C pusat, atau pengelogan biner pusat diaktifkan.

Pengelogan tingkat situs membuat direktori file log individual untuk setiap situs di server Anda, di mana setiap folder hanya berisi file log untuk situs tersebut. Pengelogan pusat memungkinkan penggunaan satu file log untuk semua situs untuk periode waktu yang ditentukan oleh atribut periode untuk <centralBinaryLogFile> elemen atau <centralW3CLogFile> . Periode waktu dapat berupa harian, mingguan, bulanan, per jam, atau ukuran file maksimum.

Catatan

File log dalam format W3C adalah file berbasis teks yang dapat diproses oleh sebagian besar utilitas penguraian log. File log biner menggunakan format penyimpanan kepemilikan yang memerlukan penggunaan aplikasi yang dapat memproses file log dalam format tersebut, seperti utilitas LogParser Microsoft .

Kompatibilitas

Versi Catatan
IIS 10.0 Elemen <log> tidak dimodifikasi dalam IIS 10.0.
IIS 8.5 Elemen <log> tidak dimodifikasi dalam IIS 8.5.
IIS 8.0 Elemen <log> tidak dimodifikasi dalam IIS 8.0.
IIS 7.5 Elemen <log> tidak dimodifikasi dalam IIS 7.5.
IIS 7.0 Elemen ini <log> diperkenalkan di IIS 7.0.
IIS 6.0 Elemen <log> menggantikan atribut IIS 6.0 berikut:
  • CentralBinaryLoggingEnabled
  • CentralW3CLoggingEnabled
  • LogInUTF8

Siapkan

Elemen <log> ini disertakan dalam penginstalan default IIS 7.

Bagaimana Caranya

Cara mengaktifkan pengelogan biner pusat untuk server

  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 , klik nama server.

  3. Di panel Beranda server, klik dua kali Pengelogan.
    Cuplikan layar Pengelogan dipilih di panel Beranda SERVER.

  4. Pada halaman Pengelogan , di bawah Satu file log per, pilih Server dari daftar drop-down, lalu pilih Biner dari daftar drop-down Format .
    Cuplikan layar pengaturan Satu file log per Server dan Format File Log ke Biner di panel Pengelogan.

  5. Klik Terapkan di panel Tindakan .

Cara mengaktifkan pengelogan W3C pusat untuk server

  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 , klik nama server.

  3. Di panel Beranda server, klik dua kali Pengelogan.
    Cuplikan layar ikon Pengelogan dipilih di panel Beranda SERVER.

  4. Pada halaman Pengelogan , di bawah Satu file log per, pilih Server dari daftar drop-down, lalu pilih W3C dari daftar drop-down Format .
    Cuplikan layar pengaturan Satu file log per Server dan Format File Log ke W 3 C di panel Pengelogan.

  5. Klik Terapkan di panel Tindakan .

Konfigurasi

Atribut

Atribut Deskripsi
centralLogFileMode Atribut enum opsional.

Menentukan mode pengelogan pusat untuk server.

Atribut centralLogFileMode dapat memiliki salah satu nilai berikut yang mungkin. Default adalah Site.
Nilai Deskripsi
Site Mengonfigurasi semua situs untuk menggunakan pengelogan situs alih-alih pengelogan pusat. Ini adalah pengaturan default.

Nilai numerik adalah 0.
CentralBinary Membuat satu file log untuk semua situs Web pada server Web. Data dalam file log adalah data berbasis biner dan tidak diformat yang tidak dapat disesuaikan.

Nilai numerik adalah 1.
CentralW3C Mencatat permintaan untuk semua situs di server Web ke satu file log terpusat dalam format ASCII berbasis teks yang dapat disesuaikan.

Nilai numerik adalah 2.
logInUTF8 Atribut Boolean opsional.

Menentukan apakah IIS harus mencatat semua string dalam Format Transformasi UCS 8 (UTF-8). Pengaturan ini menerapkan seluruh server untuk semua pengelogan mode teks.

Nilai defaultnya adalah true.

Elemen Anak

Elemen Deskripsi
centralBinaryLogFile Elemen opsional.

Menentukan pengaturan log biner pusat untuk semua situs pada server.
centralW3CLogFile Elemen opsional.

Menentukan pengaturan log W3C pusat untuk semua situs pada server.

Sampel Konfigurasi

Sampel konfigurasi berikut menentukan bahwa IIS akan menggunakan pengelogan tingkat situs.

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

Sampel konfigurasi berikut menentukan bahwa IIS akan menggunakan pengelogan biner pusat, dan mengonfigurasi rotasi file log biner setiap hari.

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

Sampel konfigurasi berikut menentukan bahwa IIS akan menggunakan pengelogan W3C pusat, dan mengonfigurasi rotasi file log W3C setiap hari.

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

Kode Sampel

Sampel kode berikut menentukan bahwa IIS akan menggunakan pengelogan biner pusat, dan mengonfigurasi rotasi file log biner setiap hari.

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

Catatan

Anda harus memastikan untuk mengatur parameter penerapan ke apphost saat Anda menggunakan AppCmd.exe untuk mengonfigurasi pengaturan ini. Ini menerapkan pengaturan konfigurasi ke bagian lokasi yang sesuai dalam file 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()

Sampel kode berikut menentukan bahwa IIS akan menggunakan pengelogan W3C pusat, dan mengonfigurasi rotasi file log W3C setiap hari.

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

Catatan

Anda harus memastikan untuk mengatur parameter penerapan ke apphost saat Anda menggunakan AppCmd.exe untuk mengonfigurasi pengaturan ini. Ini menerapkan pengaturan konfigurasi ke bagian lokasi yang sesuai dalam file 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()