Archivo de registro W3C central <centralW3CLogFile>
Información general
El elemento <centralW3CLogFile> especifica la configuración central del registro W3C para todos los sitios de un servidor.
Nota:
Debe establecer el atributo centralLogFileMode del elemento <log> primario en CentralW3C para que los atributos del elemento <centralW3CLogFile> tengan efecto. Si el atributo centralLogFileMode del elemento <log> se establece en CentralBinary o Site, se omitirán los atributos del elemento <centralW3CLogFile>.
Nota:
Los archivos de registro en formato W3C son archivos basados en texto que la mayoría de las utilidades de análisis de registros pueden procesar. Los archivos de registro binarios usan un formato de almacenamiento propietario que requiere el uso de una aplicación que puede procesar archivos de registro en ese formato, como la utilidad LogParser de Microsoft.
Compatibilidad
| Versión | Notas |
|---|---|
| IIS 10.0 | El elemento <centralW3CLogFile> no se modificó en IIS 10.0. |
| IIS 8.5 | El elemento <centralW3CLogFile> no se modificó en IIS 8.5. |
| IIS 8.0 | El elemento <centralW3CLogFile> no se modificó en IIS 8.0. |
| IIS 7.5 | El elemento <centralW3CLogFile> no se modificó en IIS 7.5. |
| IIS 7.0 | El elemento <centralW3CLogFile> del elemento <log> se introdujo en IIS 7.0. |
| IIS 6,0 | El elemento <log> reemplaza la marca CentralW3CLoggingEnabled de IIS 6.0. |
Configuración
El elemento <centralW3CLogFile> del elemento <log> se incluye en la instalación predeterminada de IIS 7.
Procedimientos
Habilitación del registro central de W3C para un servidor
Abra el Administrador de Internet Information Services (IIS):
Si usa Windows Server 2012 o Windows Server 2012 R2:
- En la barra de tareas, haga clic en Administrador del servidor, en Herramientas y, a continuación, en Administrador de Internet Information Services (IIS).
Si usa Windows 8 o Windows 8.1:
- Mantenga presionada la tecla Windows, presione la letra X y haga clic en Panel de control.
- En Panel de control, haga clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).
Si usa Windows Server 2008 o Windows Server 2008 R2:
- En la barra de tareas, haga clic en Inicio, seleccione Herramientas administrativas y, a continuación, haga clic en Administrador de Internet Information Services (IIS).
Si usa Windows Vista o Windows 7:
- En la barra de tareas, haga clic en Inicio y, luego, haga clic en Panel de control.
- Haga doble clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).
En el panel Conexiones, haga clic en el nombre del servidor.
En el panel Inicio del servidor, haga doble clic en Registro.
En la página Registro, en Un archivo de registro por día, seleccione Servidor en la lista desplegable y, a continuación, elija W3C en la lista desplegable Formato.
Haga clic en Aplicar en el panel Acciones.
Configuración
Atributos
| Atributo | Descripción | ||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
directory |
Atributo de cadena opcional. Especifica el directorio en el que se escriben las entradas del registro. El valor predeterminado es %SystemDrive%\inetpub\logs\LogFiles. |
||||||||||||||||||||||||||||||||||||||||||||||
enabled |
Atributo Boolean opcional. Especifica si el registro W3C central está habilitado. El valor predeterminado es true. |
||||||||||||||||||||||||||||||||||||||||||||||
localTimeRollover |
Atributo Boolean opcional. Especifica si se crea un nuevo archivo de registro en función de la hora local o de la hora universal coordinada (UTC). Un valor true significa que el nuevo archivo de registro se basa en la hora local; false significa que se basa en UTC. El valor predeterminado es false. |
||||||||||||||||||||||||||||||||||||||||||||||
logExtFileFlags |
Atributo flags opcional. Especifica los campos que se van a registrar. El atributo logExtFileFlags puede tener uno de los siguientes valores o una lista de estos valores. El valor predeterminado es una lista de estos valores: Date, Time, ClientIP, UserName, SiteName, ServerIP, Method, UriStem, UriQuery, HttpStatus, TimeTaken,Win32Status, ServerPort, UserAgent, HttpSubStatus.
|
||||||||||||||||||||||||||||||||||||||||||||||
period |
Atributo enum opcional. Especifica la frecuencia con la que se cierra el archivo de registro actual y se inicia un nuevo archivo de registro. El atributo period puede ser uno de los siguientes valores posibles. El valor predeterminado es Daily.
|
||||||||||||||||||||||||||||||||||||||||||||||
truncateSize |
Atributo int64 opcional. Especifica el tamaño, en bytes, en el que se truncará el contenido del archivo de registro. Este atributo debe establecerse cuando el valor del atributo period es maxSize. El tamaño debe estar entre 1048576 (1 megabyte) y 4294967295 (4 gigabytes). El valor predeterminado es 20971520 (20 megabytes). |
Elementos secundarios
Ninguno.
Ejemplo de configuración
En el ejemplo de configuración siguiente se especifica que IIS usará el registro W3C central y configura la rotación de archivos de registro W3C diariamente.
<log centralLogFileMode="CentralW3C">
<centralBinaryLogFile enabled="true" directory="%SystemDrive%\inetpub\logs\LogFiles" />
<centralW3CLogFile enabled="true" directory="%SystemDrive%\inetpub\logs\LogFiles" period="Daily" />
</log>
Código de ejemplo
Los ejemplos de código siguientes especifican que IIS usará el registro W3C central y configurará la rotación de archivos de registro W3C diariamente.
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
Nota:
Debe asegurarse de establecer el parámetro de confirmación en apphost cuando use AppCmd.exe para configurar estas opciones. Esto confirma los valores de configuración en la sección de ubicación adecuada del archivo 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()