Fichier journal binaire central <centralBinaryLogFile>

Vue d’ensemble

L’élément <centralBinaryLogFile> définit les paramètres de journal binaire central pour tous les sites sur un serveur.

Remarque

Vous devez définir l’attribut centralLogFileMode de l’élément parent <log>sur CentralBinary pour que les attributs de l’élément <centralW3CLogFile> s’appliquent. Si l’attribut centralLogFileMode de l’élément <log> est défini sur CentralW3C ou Site, les attributs de l’élément <centralW3CLogFile> sont ignorés.

Remarque

Les fichiers journaux au format W3C sont des fichiers texte que la plupart des utilitaires d’analyse de journal peuvent traiter. Les fichiers journaux binaires utilisent un format de stockage propriétaire qui nécessite l’utilisation d’une application capable de traiter les fichiers journaux dans ce format, comme l’utilitaire LogParser de Microsoft.

Compatibilité

Version	Notes
IIS 10.0	L’élément <centralBinaryLogFile> n’a pas été modifié dans IIS 10.0.
IIS 8.5	L’élément <centralBinaryLogFile> n’a pas été modifié dans IIS 8.5.
IIS 8.0	L’élément <centralBinaryLogFile> n’a pas été modifié dans IIS 8.0.
IIS 7.5	L’élément <centralBinaryLogFile> n’a pas été modifié dans IIS 7.5.
IIS 7.0	L’élément <centralBinaryLogFile> de l’élément <log> a été introduit dans IIS 7.0.
IIS 6.0	L’élément <log> remplace l’indicateur IIS 6.0 CentralBinaryLoggingEnabled.

Programme d’installation

L’élément <centralBinaryLogFile> de l’élément <log> est inclus dans l’installation par défaut d’IIS 7.

Procédure

Comment activer la journalisation binaire centralisée pour un serveur

1. Ouvrez le Gestionnaire des services internet (IIS) :

   • Si vous utilisez Windows Server 2012 ou Windows Server 2012 R2 :

     • Dans la barre des tâches, cliquez sur Gestionnaire de serveur, cliquez sur Outils, puis sur Gestionnaire des services internet (IIS).

   • Si vous utilisez Windows 8 ou Windows 8.1 :

     • Maintenez la touche Windows enfoncée, appuyez sur la lettre X, puis cliquez sur Panneau de configuration.
     • Cliquez sur Outils d'administration, puis double-cliquez sur Gestionnaire des services internet (IIS).

   • Si vous utilisez Windows Server 2008 ou Windows Server 2008 R2 :

     • Cliquez sur Démarrer, placez le curseur sur Outils d'administration, puis cliquez sur Gestionnaire des services internet (IIS).

   • Si vous utilisez Windows Vista ou Windows 7 :

     • Dans la barre des tâches, cliquez sur Démarrer, puis sur Panneau de configuration.
     • Double-cliquez sur Outils d'administration, puis double-cliquez sur Gestionnaire des services internet (IIS).

2. Dans le volet Connexions, cliquez sur le nom du serveur internet.

3. Dans le volet Accueil du serveur, double-cliquez sur Journalisation.
   

4. Dans la page Journalisation, sous un fichier journal par, sélectionnez Serveur dans la liste déroulante, puis choisissez Binaire dans la liste déroulante Format.
   

5. Cliquez sur Appliquer dans le volet Actions.

Configuration

Attributs

Attribut	Description
directory	Attribut de chaîne facultatif. Spécifie le répertoire où les entrées de journal sont écrites.
enabled	Attribut booléen facultatif. Spécifie si la journalisation binaire centralisée est activée. De plus, centralLogFileMode doit être défini sur CentralBinary pour activer entièrement la journalisation binaire centrale. La valeur par défaut est false.
localTimeRollover	Attribut booléen facultatif. Définit si un nouveau fichier journal est créé en fonction de l’heure locale ou de l’heure universelle coordonnée (UTC). La valeur true signifie que le nouveau fichier journal est basé sur l’heure locale ; false signifie qu’il est basé sur UTC. La valeur par défaut est false.
period	Attribut d’énumération facultatif. Définit la fréquence à laquelle le contenu du fichier journal doit être effacé. L’attribut de point peut être l’une des valeurs possibles suivantes. La valeur par défaut est Daily. Valeur Description MaxSize Les fichiers journaux sont effacés chaque fois que le fichier journal atteint la taille spécifiée par l’attribut truncateSize. La valeur numérique est 0. Daily Les fichiers journaux sont effacés tous les jours. La valeur numérique est 1. Weekly Les fichiers journaux sont effacés une fois par semaine. La valeur numérique est 2. Monthly Les fichiers journaux sont effacés une fois par mois. La valeur numérique est 3. Hourly Les fichiers journaux sont effacés toutes les heures. La valeur numérique est 4.
truncateSize	Attribut int64 facultatif. Définit la taille à laquelle le contenu du fichier journal doit être tronqué. Cet attribut doit être défini lorsque la valeur de l’attribut de période est maxSize. La taille doit être comprise entre 1048576 (1 mégaoctet) et 4294967295 (4 gigaoctets). La valeur par défaut est 20971520 (20 mégaoctets).

Éléments enfants

Aucune.

Exemple Configuration

L’exemple de configuration suivant spécifie que IIS utilisera la journalisation binaire centralisée et configure la rotation quotidienne des fichiers journaux binaires.

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

Exemple de code

Les exemples de code suivants spécifient que IIS utilisera la journalisation binaire centralisée et configure la rotation quotidienne des fichiers journaux binaires.

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

Remarque

Vous devez veiller à définir le paramètre commit sur apphost quand vous utilisez AppCmd.exe pour configurer ces paramètres. Cela valide les paramètres de configuration à l’emplacement de la section appropriée dans le fichier 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()