Central Binary Log File <centralBinaryLogFile>

Gambaran Umum

Elemen <centralBinaryLogFile> menentukan pengaturan log biner pusat untuk semua situs di server.

Catatan

Anda perlu mengatur atribut centralLogFileMode dari elemen induk <log> ke CentralBinary agar atribut pada <centralW3CLogFile> elemen memiliki efek. Jika atribut centralLogFileMode dari <log> elemen diatur ke CentralW3C atau Site, atribut pada <centralW3CLogFile> elemen akan diabaikan.

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 <centralBinaryLogFile> tidak dimodifikasi di IIS 10.0.
IIS 8.5	Elemen <centralBinaryLogFile> tidak dimodifikasi di IIS 8.5.
IIS 8.0	Elemen <centralBinaryLogFile> tidak dimodifikasi di IIS 8.0.
IIS 7.5	Elemen <centralBinaryLogFile> tidak dimodifikasi dalam IIS 7.5.
IIS 7.0	Elemen <centralBinaryLogFile><log> elemen diperkenalkan di IIS 7.0.
IIS 6.0	Elemen menggantikan <log> bendera IIS 6.0 CentralBinaryLoggingEnabled .

Siapkan

Elemen <centralBinaryLogFile><log> elemen disertakan dalam penginstalan default IIS 7.

Bagaimana Caranya

Cara mengaktifkan pengelogan biner pusat untuk server

1. Buka Manajer 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 Manajer 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 taskbar, klik Mulai, arahkan ke Alat Administratif, lalu klik Manajer 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.
   

4. Pada halaman Pengelogan , di bawah Satu file log per, pilih Server dari daftar drop-down, lalu pilih Biner dari daftar drop-down Format .
   

5. Klik Terapkan di panel Tindakan .

Konfigurasi

Atribut

Atribut	Deskripsi
directory	Atribut string opsional. Menentukan direktori tempat entri log ditulis.
enabled	Atribut Boolean opsional. Menentukan apakah pengelogan biner pusat diaktifkan. Selain itu, centralLogFileMode harus diatur ke CentralBinary untuk sepenuhnya mengaktifkan pengelogan biner pusat. Nilai defaultnya adalah false.
localTimeRollover	Atribut Boolean opsional. Menentukan apakah file log baru dibuat berdasarkan waktu setempat atau Waktu Universal Terkoordinasi (UTC). Nilai true berarti file log baru didasarkan pada waktu lokal; false berarti didasarkan pada UTC. Nilai defaultnya adalah false.
period	Atribut enum opsional. Menentukan seberapa sering konten file log harus dibersihkan. Atribut periode dapat menjadi salah satu nilai yang mungkin berikut. Nilai defaultnya adalah Daily. Nilai Deskripsi MaxSize File log dibersihkan setiap kali file log mencapai ukuran yang ditentukan oleh atribut truncateSize . Nilai numerik adalah 0. Daily File log dihapus setiap hari. Nilai numerik adalah 1. Weekly File log dibersihkan seminggu sekali. Nilai numerik adalah 2. Monthly File log dibersihkan sebulan sekali. Nilai numerik adalah 3. Hourly File log dihapus setiap jam. Nilai numerik adalah 4.
truncateSize	Atribut int64 opsional. Menentukan ukuran di mana konten file log harus dipotok. Atribut ini harus diatur ketika nilai atribut periode dimaksimalkan. Ukurannya harus antara 1048576 (1 megabyte) dan 4294967295 (4 gigabyte). Nilai defaultnya adalah 20971520 (20 megabyte).

Elemen Anak

Tidak ada.

Sampel Konfigurasi

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>

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