Central Binary Log File <centralBinaryLogFile>

Übersicht

Das <centralBinaryLogFile>-Element gibt die zentralen Binär-Protokolleinstellungen für alle Websites auf einem Server an.

Hinweis

Sie müssen das centralLogFileMode-Attribut des übergeordneten <log>-Elements auf CentralBinary festlegen, damit die Attribute für das <centralW3CLogFile>-Element wirksam werden. Wenn das centralLogFileMode-Attribut des <log>-Elements auf CentralW3C oder Site festgelegt ist, werden die Attribute für das <centralW3CLogFile>-Element ignoriert.

Hinweis

Protokolldateien im W3C-Format sind textbasierte Dateien, die von den meisten Protokollanalyseprogrammen verarbeitet werden können. Binäre Protokolldateien verwenden ein proprietäres Speicherformat, das die Verwendung einer Anwendung erfordert, die Protokolldateien in diesem Format verarbeiten kann, z. B. das Hilfsprogramm LogParser von Microsoft.

Kompatibilität

Version	Hinweise
IIS 10.0	Das <centralBinaryLogFile> Element wurde in IIS 10.0 nicht geändert.
IIS 8.5	Das <centralBinaryLogFile> Element wurde in IIS 8.5 nicht geändert.
IIS 8.0	Das <centralBinaryLogFile> Element wurde in IIS 8.0 nicht geändert.
IIS 7.5	Das <centralBinaryLogFile>-Element wurde in IIS 7.5 nicht geändert.
IIS 7.0	Das <centralBinaryLogFile>-Element des <log>-Elements wurde in IIS 7.0 eingeführt.
IIS 6.0	Das <log>-Element ersetzt das CentralBinaryLoggingEnabled-Flag von IIS 6.0.

Setup

Das <centralBinaryLogFile>-Element des <log>-Elements ist in der Standardinstallation von IIS 7 enthalten.

Gewusst wie

Aktivieren der zentralen Binärprotokollierung für einen Server

1. Öffnen Sie den Internet Information Services (IIS) Manager:

   • Wenn Sie Windows Server 2012 oder Windows Server 2012 R2 verwenden:

     • Klicken Sie der der Taskleiste auf Server-Managerdann auf Toolsund dann auf den Internet Information Services (IIS) Manager.

   • Wenn Sie Windows 8 oder Windows 8.1 verwenden:

     • Halten Sie die Windows-Taste gedrückt, drücken Sie den Buchstaben X, und klicken Sie dann auf "Systemsteuerung".
     • Klicken Sie auf Verwaltungund doppelklicken Sie dann auf den Internet Information Services (IIS) Manager.

   • Wenn Sie Windows Server 2008 oder Windows Server 2008 R2 verwenden:

     • Klicken Sie auf der Taskleiste auf Start, zeigen Sie auf Verwaltungund dann auf den Internet Information Services (IIS) Manager.

   • Wenn Sie Windows Vista oder Windows 7 verwenden:

     • Klicken Sie auf der Taskleiste auf "Start" und dann auf "Systemsteuerung".
     • Doppelklicken Sie auf Verwaltungund doppelklicken Sie dann auf den Internet Information Services (IIS) Manager.

2. Klicken Sie im Bereich Verbindungen auf den Servernamen.

3. Doppelklicken Sie im Bereich Start des Servers auf Protokollierung.
   

4. Wählen Sie auf der Seite Protokollierung unter Eine Protokolldatei pro in der Dropdownliste Server aus und wählen Sie dann Binär aus der Dropdownliste Format aus.
   

5. Wählen Sie im Bereich Aktionen die Option Übernehmen aus.

Konfiguration

Attribute

Attribut	Beschreibung
directory	Optionales Zeichenfolgeattribut. Gibt das Verzeichnis an, in das Protokolleinträge geschrieben werden.
enabled	Optionales boolesches Attribut. Gibt an, ob die zentrale binäre Protokollierung aktiviert ist. Darüber hinaus muss centralLogFileMode auf CentralBinary festgelegt werden, um die zentrale binäre Protokollierung vollständig zu aktivieren. Der Standardwert ist false.
localTimeRollover	Optionales boolesches Attribut. Gibt an, ob eine neue Protokolldatei basierend auf der Ortszeit oder der koordinierten Weltzeit (Coordinated Universal Time, UTC), erstellt wird. Ein Wert von true bedeutet, dass die neue Protokolldatei auf der lokalen Zeit basiert, wohingegen false bedeutet, dass sie auf UTC basiert. Der Standardwert ist false.
period	Optionales Enumerationsattribut. Gibt an, wie häufig der Inhalt der Protokolldatei gelöscht werden soll. Die zulässigen Werte für das period-Attribut sind im Folgenden aufgeführt. Der Standardwert ist Daily. Wert Beschreibung MaxSize Protokolldateien werden gelöscht, wenn die Protokolldatei die durch das truncateSize-Attribut angegebene Größe erreicht. Der numerische Wert ist 0. Daily Protokolldateien werden täglich gelöscht. Der numerische Wert ist 1. Weekly Protokolldateien werden einmal pro Woche gelöscht. Der numerische Wert ist 2. Monthly Protokolldateien werden einmal im Monat gelöscht. Der numerische Wert ist 3. Hourly Protokolldateien werden jede Stunde gelöscht. Der numerische Wert ist 4.
truncateSize	Optionales int64-Attribut. Gibt die Größe an, bei der der Inhalt der Protokolldatei abgeschnitten werden soll. Dieses Attribut muss festgelegt werden, wenn der Wert des periodischen Attributs maxSize ist. Die Größe muss zwischen 1048576 (1 MB) und 4294967295 (4 Gigabyte) betragen. Der Standardwert ist 20971520 (20 Megabyte).

Untergeordnete Elemente

Keine.

Konfigurationsbeispiel

Im folgenden Konfigurationsbeispiel wird angegeben, dass IIS die zentrale binäre Protokollierung verwendet und den Wechsel der binären Protokolldatei täglich konfiguriert.

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

Beispielcode

Die folgenden Codebeispiele geben an, dass IIS die zentrale binäre Protokollierung verwendet und den Wechsel der binären Protokolldateien täglich konfiguriert.

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

Hinweis

Sie müssen unbedingt den Commitparameterapphost festlegen, wenn Sie AppCmd.exe verwenden, um diese Einstellungen zu konfigurieren. Dadurch werden die Konfigurationseinstellungen auf den entsprechenden Speicherortabschnitt in der Datei ApplicationHost.config festgelegt.

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