Fichier journal central W3C <centralW3CLogFile>
Vue d’ensemble
L’élément <centralW3CLogFile> spécifie les paramètres de journal W3C centraux pour tous les sites sur un serveur.
Remarque
Vous devez définir l’attribut centralLogFileMode de l’élément parent <log>sur CentralW3C pour que les attributs de l’élément <centralW3CLogFile> s’appliquent. Si l’attribut centralLogFileMode de l’élément <log> est défini sur CentralBinary 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 <centralW3CLogFile> n’a fait l’objet d’aucune modification dans IIS 10.0. |
| IIS 8.5 | L’élément <centralW3CLogFile> n’a fait l’objet d’aucune modification dans IIS 8.5. |
| IIS 8.0 | L’élément <centralW3CLogFile> n’a fait l’objet d’aucune modification dans IIS 8.0. |
| IIS 7.5 | L’élément <centralW3CLogFile> n’a fait l’objet d’aucune modification dans IIS 7.5. |
| IIS 7.0 | L’élément <centralW3CLogFile> 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 CentralW3CLoggingEnabled. |
Programme d’installation
L’élément <centralW3CLogFile> de l’élément <log> est inclus dans l’installation par défaut d’IIS 7.
Procédure
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 Internet Information Services (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 Internet Information Services (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 | ||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
directory |
Attribut de chaîne facultatif. Spécifie le répertoire où les entrées de journal sont écrites. La valeur par défaut est %SystemDrive%\inetpub\logs\LogFiles. |
||||||||||||||||||||||||||||||||||||||||||||||
enabled |
Attribut booléen facultatif. Spécifie si la journalisation W3C centralisée est activée. La valeur par défaut est true. |
||||||||||||||||||||||||||||||||||||||||||||||
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. |
||||||||||||||||||||||||||||||||||||||||||||||
logExtFileFlags |
Attribut d’indicateurs facultatifs. Spécifie les champs à journaliser. L’attribut logExtFileFlags peut avoir l’une des valeurs suivantes ou une liste de ces valeurs. La valeur par défaut est une liste de ces valeurs : Date, Time, ClientIP, UserName, SiteName, ServerIP, Method, UriStem, UriQuery, HttpStatus, TimeTaken, Win32Status, ServerPort, UserAgent, HttpSubStatus.
|
||||||||||||||||||||||||||||||||||||||||||||||
period |
Attribut d’énumération facultatif. Spécifie la fréquence à laquelle le fichier journal actuel est fermé et un nouveau fichier journal est démarré. L’attribut de point peut être l’une des valeurs possibles suivantes. Par défaut, il s’agit de Daily.
|
||||||||||||||||||||||||||||||||||||||||||||||
truncateSize |
Attribut int64 facultatif. Spécifie la taille, en octets, à laquelle le contenu du fichier journal sera 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 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 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
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 dans la section d’emplacement 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"] = @"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()