Registro (<log>)

Artículo
03/25/2024

Información general

El elemento <log> especifica varias opciones de registro globales para Internet Information Services (IIS) 7. Por ejemplo, el atributo centralLogFileMode especifica si el registro de nivel de sitio, el registro W3C central o el registro binario central están habilitados.

El registro de nivel de sitio crea directorios de archivos de registro individuales para cada sitio del servidor, donde cada carpeta contiene solo los archivos de registro de ese sitio. El registro central permite el uso de un único archivo de registro para todos los sitios durante el período de tiempo especificado por el atributo period para el elemento <centralBinaryLogFile> o <centralW3CLogFile>. El período de tiempo puede ser diario, semanal, mensual, por hora, o bien un tamaño máximo de archivo.

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 `<log>` no se modificó en IIS 10.0.
IIS 8.5	El elemento `<log>` no se modificó en IIS 8.5.
IIS 8.0	El elemento `<log>` no se modificó en IIS 8.0.
IIS 7.5	El elemento `<log>` no se modificó en IIS 7.5.
IIS 7.0	El elemento `<log>` se introdujo en IIS 7.0.
IIS 6,0	El elemento `<log>` reemplaza los siguientes atributos de IIS 6.0: CentralBinaryLoggingEnabled CentralW3CLoggingEnabled LogInUTF8

Configuración

El elemento <log> se incluye en la instalación predeterminada de IIS 7.

Procedimientos

Habilitación del registro binario central 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 Binario en la lista desplegable Formato.
Haga clic en Aplicar en el panel Acciones.

Procedimiento para habilitar el 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

centralLogFileMode

Atributo enum opcional.

Especifica el modo de registro central para el servidor.

El atributo centralLogFileMode puede tener uno de los siguientes valores posibles. El valor predeterminado es Site.

Valor	Descripción
`Site`	Configura todos los sitios para usar el registro de sitios en lugar del registro central. Esta es la configuración predeterminada. El valor numérico es 0.
`CentralBinary`	Crea un archivo de registro para todos los sitios web de un servidor web. Los datos del archivo de registro son datos sin formato y basados en binarios que no se pueden personalizar. El valor numérico es 1.
`CentralW3C`	Registra las solicitudes de todos los sitios en un servidor web en un único archivo de registro central en un formato ASCII personalizable y basado en texto. El valor numérico es 2.

logInUTF8 Atributo Boolean opcional.

Especifica si IIS debe registrar todas las cadenas en UTF-8. Esta configuración se aplica en todo el servidor a todos los registros en modo de texto.

El valor predeterminado es true.

Elementos secundarios

Elemento	Descripción
`centralBinaryLogFile`	Elemento opcional. Especifica la configuración central del registro binario para todos los sitios de un servidor.
`centralW3CLogFile`	Elemento opcional. Especifica la configuración central del registro W3C para todos los sitios de un servidor.

Ejemplo de configuración

En el ejemplo de configuración siguiente se especifica que IIS usará el registro de nivel de sitio.

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

En el ejemplo de configuración siguiente se especifica que IIS usará el registro binario central y configura la rotación de archivos de registro binario diariamente.

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

En el ejemplo de configuración siguiente se especifica que IIS usará el registro W3C central y se configura la rotación de archivos de registro W3C de forma diaria.

<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 binario central y configurará la rotación de archivos de registro binario diariamente.

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

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"] = @"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()

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:

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

Compartir a través de

Registro (<log>)

Información general

Compatibilidad

Configuración

Procedimientos

Habilitación del registro binario central para un servidor

Procedimiento para habilitar el registro central de W3C para un servidor

Configuración

Atributos

Elementos secundarios

Ejemplo de configuración

Código de ejemplo

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

Comentarios

Recursos adicionales