Journal <log>

Article
03/19/2024

Vue d’ensemble

L’élément <log> définit plusieurs options de journalisation globales pour les Services internet (IIS) 7. Par exemple, l’attribut centralLogFileMode définit si la journalisation au niveau du site, la journalisation W3C centrale ou la journalisation binaire centrale est activée.

La journalisation au niveau du site crée des répertoires de fichiers journaux individuels pour chaque site sur votre serveur, où chaque dossier contient uniquement les fichiers journaux de ce site. La journalisation centralisée permet l’utilisation d’un fichier journal unique pour tous les sites pour la période spécifiée par l’attribut period de l’élément <centralBinaryLogFile> ou <centralW3CLogFile>. La période peut être quotidienne, hebdomadaire, mensuelle, toutes les heures ou une taille de fichier maximale.

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 `<log>` n’a pas été modifié dans IIS 10.0.
IIS 8.5	L’élément `<log>` n’a pas été modifié dans IIS 8.5.
IIS 8.0	L’élément `<log>` n’a pas été modifié dans IIS 8.0.
IIS 7.5	L’élément `<log>` n’a pas été modifié dans IIS 7.5.
IIS 7.0	L’élément `<log>` a été introduit dans IIS 7.0.
IIS 6.0	L’élément `<log>` remplace les attributs IIS 6.0 suivants : CentralBinaryLoggingEnabled CentralW3CLoggingEnabled LogInUTF8

Programme d’installation

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

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).
Dans le volet Connexions, cliquez sur le nom du serveur internet.
Dans le volet Accueil du serveur, double-cliquez sur Journalisation.
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.
Cliquez sur Appliquer dans le volet Actions.

Comment activer la journalisation W3C centrale pour un serveur

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).
Dans le volet Connexions, cliquez sur le nom du serveur internet.
Dans le volet Accueil du serveur, double-cliquez sur Journalisation.
Dans la page Journalisation, sous un fichier journal par, sélectionnez Serveur dans la liste déroulante, puis choisissez W3C dans la liste déroulante Format.
Cliquez sur Appliquer dans le volet Actions.

Configuration

Attributs

Attribut Description

centralLogFileMode

Attribut d’énumération facultatif.

Définit le mode de journalisation central pour le serveur.

L’attribut centralLogFileMode peut avoir l’une des valeurs possibles suivantes. Par défaut, il s’agit de Site.

Valeur	Description
`Site`	Configure tous les sites pour utiliser la journalisation de site au lieu de la journalisation centrale. Il s’agit du paramètre par défaut. La valeur numérique est 0.
`CentralBinary`	Crée un fichier journal pour tous les sites internet sur un serveur internet. Les données du fichier journal sont des données binaires non mises en forme qui ne sont pas personnalisables. La valeur numérique est 1.
`CentralW3C`	Journalise les demandes de tous les sites sur un serveur internet vers un fichier journal central unique au format ASCII personnalisable basé sur du texte. La valeur numérique est 2.

logInUTF8 Attribut booléen facultatif.

Définit si IIS doit consigner toutes les chaînes au format de transformation UCS 8 (UTF-8). Ce paramètre applique la journalisation en mode texte à l’échelle du serveur.

La valeur par défaut est true.

Éléments enfants

Élément	Description
`centralBinaryLogFile`	Élément facultatif. Définit les paramètres de journal binaire central pour tous les sites sur un serveur.
`centralW3CLogFile`	Élément facultatif. Définit les paramètres de journal W3C centraux pour tous les sites sur un serveur.

Exemple Configuration

L’exemple de configuration suivant définit que IIS utilisera la journalisation au niveau du site.

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

L’exemple de configuration suivant définit 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>

L’exemple de configuration suivant définit que IIS utilisera la journalisation W3C centrale et configure quotidiennement la rotation des fichiers journaux W3C.

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

Exemple de code

Les exemples de code suivants définissent 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()

Les exemples de code suivants définissent que IIS utilisera la journalisation W3C centrale et configure la rotation quotidienne des fichiers journaux W3C.

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

Remarque

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

Partager via

Journal <log>

Vue d’ensemble

Compatibilité

Programme d’installation

Procédure

Comment activer la journalisation binaire centralisée pour un serveur

Comment activer la journalisation W3C centrale pour un serveur

Configuration

Attributs

Éléments enfants

Exemple Configuration

Exemple de code

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

Commentaires

Ressources supplémentaires