Archivos de registro de un elemento <logFile> de sitio web

Información general

El elemento <logFile> del elemento <site> contiene atributos que permiten configurar el registro de un sitio en IIS 7 y versiones posteriores.

Por ejemplo, puede habilitar o deshabilitar el registro, configurar el formato del archivo de registro de IIS, especificar las categorías de información que se almacenarán en el archivo de registro y cambiar el directorio donde se almacena el archivo de registro. También puede usar el elemento <logFile> para controlar la frecuencia con la que IIS crea un archivo de registro basado en el tamaño del archivo de registro o el intervalo de tiempo y el tamaño máximo (en bytes) que puede convertirse un archivo de registro.

De manera predeterminada, IIS 7 y versiones posteriores usan el formato de archivo de registro World Wide Web Consortium (W3C). Puede cambiar esta configuración cambiando el atributo logFormat a IIS, NCSA o Personalizado.

• Establecer los atributos de registro ODBC en el elemento <odbcLogging>. Estos atributos especifican el nombre de origen de datos del sistema (DSN), el nombre de tabla, el nombre de usuario y la contraseña para la conexión ODBC.
• Establecer los atributos de registro personalizados correctos en el elemento <logFile>. Estos atributos deben establecer el formato de archivo de registro en "Custom" y el id. de clase de complemento de registro personalizado en "{FF16065B-DE82-11CF-BC0A-00AA006111E0}".

Para obtener más información sobre el registro ODBC, vea el elemento <odbcLogging>.

Puede definir las categorías de información que registra IIS editando el atributo logExtFileFlags. Los valores predeterminados son Date, Time, ClientIP, UserName, ServerIP, Method, UriStem, UriQuery, TimeTaken, HttpStatus, Win32Status, ServerPort, UserAgent, HttpSubStatus y Referer.

IIS 8.5 permite registrar campos personalizados además del conjunto de registros estándar. El formato del archivo de registro debe ser W3C para agregar campos personalizados. Para obtener más información, vea customFields.

Compatibilidad

Configuración

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

Procedimientos

Procedimientos para editar la configuración de registro de un sitio

1. 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, después, 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, después, 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, después, haga doble clic en Administrador de Internet Information Services (IIS).

2. En el panel Conexiones, expanda el nombre del servidor, luego la opción Sitios y, después, haga clic en el sitio web en el que quiera configurar el registro.

3. En el panel Inicio, haga doble clic en Registro.
   

4. En el panel Registro, seleccione el formato de archivo de registro en el cuadro Formato y escriba la ruta de acceso al directorio donde almacena los archivos de registro en el cuadro Directorio o bien haga clic en Examinar... para elegir el directorio en el que quiere almacenar los archivos de registro.
   

5. Si decide usar el formato de archivo de registro W3C:

   • Haga clic en Seleccionar campos para elegir los tipos de información que se van a registrar.
   • En el cuadro de diálogo Campos de registro de W3C, active las casillas de las opciones que quiere registrar, desactive las casillas de las opciones que no quiere registrar y, después, haga clic en Aceptar.
     

Procedimientos para configurar el registro de archivos o ETW para registros W3C

1. Abra el Administrador de Internet Information Services (IIS):

   • Si usa Windows Server 2012 R2:

     • En la barra de tareas, haga clic en Administrador del servidor, en Herramientas y, después, en Administrador de Internet Information Services (IIS).

   • Si usa 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, después, haga doble clic en Administrador de Internet Information Services (IIS).

2. En el panel Conexiones, expanda el nombre del servidor, expanda Sitios y, después, seleccione un sitio.

3. En el panel Inicio del sitio, haga doble clic en Registro.

4. En la página principal de Registro, en Destino de eventos de registro, seleccione Solo archivo de registro, Solo evento ETW o Archivo de registro y evento ETW.

   

Procedimiento para configurar el vaciado de un registro W3C por recuento de entradas

1. Abra el Administrador de Internet Information Services (IIS):

   • Si usa Windows Server 2012 R2:

     • En la barra de tareas, haga clic en Administrador del servidor, en Herramientas y, después, en Administrador de Internet Information Services (IIS).

   • Si usa 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, después, haga doble clic en Administrador de Internet Information Services (IIS).

2. En el panel Conexiones, expanda el servidor y, después, haga doble clic en Editor de configuración.

3. En el Editor de configuración, para la Sección, expanda system.applicationHost y, después, seleccione Sitios.

4. Haga clic en (Colección) y, después, haga clic en los puntos suspensivos.

5. Seleccione el sitio que quiere configurar y, después, expanda logFile.

6. En flushByEntryCountW3Clog, escriba el número de eventos que se almacenarán en el búfer antes de vaciarlos en el archivo de registro.

7. En el panel Acción, haga clic en Aplicar.

   

Procedimiento para configurar la longitud máxima de la línea de registro

1. Abra el Administrador de Internet Information Services (IIS):

   • Si usa Windows Server 2012 R2:

     • En la barra de tareas, haga clic en Administrador del servidor, en Herramientas y, después, en Administrador de Internet Information Services (IIS).

   • Si usa 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, después, haga doble clic en Administrador de Internet Information Services (IIS).

2. En el panel Conexiones, expanda el servidor y, después, haga doble clic en Editor de configuración.

3. En el Editor de configuración, para la Sección, expanda system.applicationHost y, después, seleccione Sitios.

4. Haga clic en (Colección) y, después, haga clic en los puntos suspensivos.

5. Seleccione el sitio que quiere configurar y, después, expanda logFile.

6. En maxLogLineLength, escriba el número máximo de bytes en una sola línea de un archivo de registro.

7. En el panel Acción, haga clic en Aplicar.

   

Configuración

Atributos

Elementos secundarios

Ejemplo de configuración

En el ejemplo de configuración siguiente se usa el atributo logExtFileFlags del elemento <logFile> a fin de especificar la configuración que IIS registra para un sitio web denominado Contoso. El atributo period hace que IIS cree un archivo de registro W3C cada hora; el atributo localTimeRollover especifica que IIS usa la hora en el servidor local para determinar cuándo crear y asignar un nombre a un nuevo archivo de registro.

<site name="Contoso" id="2" serverAutoStart="true">
   <application path="/" applicationPool="Contoso">
      <virtualDirectory path="/" physicalPath="C:\Contoso\Content" />
   </application>
   <bindings>
      <binding protocol="http" bindingInformation="*:80:www.contoso.com" />
   </bindings>
   <logFile
      period="Hourly"
      localTimeRollover="true"
      logExtFileFlags="Date, Time, ClientIP, UserName, ServerIP, Method, UriStem, UriQuery, HttpStatus, TimeTaken, ServerPort, UserAgent, HttpSubStatus" />
</site>

Código de ejemplo

En los ejemplos siguientes se configura el registro de un sitio denominado Contoso. Cada ejemplo habilita el registro para el sitio y configura el registro de sitio a fin de generar un nuevo archivo de registro diariamente. También configuran IIS para usar la hora en el servidor local a fin de generar los nombres de archivo de registro y determinar cuándo generar nuevos archivos de registro.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /[name='Contoso'].logFile.logFormat:"W3C" 
appcmd.exe set config -section:system.applicationHost/sites /[name='Contoso'].logFile.period:"Daily" 
appcmd.exe set config -section:system.applicationHost/sites /[name='Contoso'].logFile.localTimeRollover:"True" 
appcmd.exe set config -section:system.applicationHost/sites /[name='Contoso'].logFile.enabled:"True" /commit:apphost

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 sitesSection = config.GetSection("system.applicationHost/sites");
         ConfigurationElementCollection sitesCollection = sitesSection.GetCollection();

         ConfigurationElement siteElement = FindElement(sitesCollection, "site", "name", @"Contoso");
         if (siteElement == null) throw new InvalidOperationException("Element not found!");

         ConfigurationElement logFileElement = siteElement.GetChildElement("logFile");
         logFileElement["logFormat"] = @"W3C";
         logFileElement["period"] = @"Daily";
         logFileElement["localTimeRollover"] = true;
         logFileElement["enabled"] = true;

         serverManager.CommitChanges();
      }
   }

   private static ConfigurationElement FindElement(ConfigurationElementCollection collection, string elementTagName, params string[] keyValues)
   {
      foreach (ConfigurationElement element in collection)
      {
         if (String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase))
         {
            bool matches = true;
            for (int i = 0; i < keyValues.Length; i += 2)
            {
               object o = element.GetAttributeValue(keyValues[i]);
               string value = null;
               if (o != null)
               {
                  value = o.ToString();
               }
               if (!String.Equals(value, keyValues[i + 1], StringComparison.OrdinalIgnoreCase))
               {
                  matches = false;
                  break;
               }
            }
            if (matches)
            {
               return element;
            }
         }
      }
      return null;
   }
}

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 sitesSection As ConfigurationSection = config.GetSection("system.applicationHost/sites")
       Dim sitesCollection As ConfigurationElementCollection = sitesSection.GetCollection
       Dim siteElement As ConfigurationElement = FindElement(sitesCollection, "site", "name", "Contoso")

       If (siteElement Is Nothing) Then
          Throw New InvalidOperationException("Element not found!")
       End If

       Dim logFileElement As ConfigurationElement = siteElement.GetChildElement("logFile")
       logFileElement("logFormat") = "W3C"
       logFileElement("period") = "Daily"
       logFileElement("localTimeRollover") = True
       logFileElement("enabled") = True

       serverManager.CommitChanges()
   End Sub

   Private Function FindElement(ByVal collection As ConfigurationElementCollection, ByVal elementTagName As String, ByVal ParamArray keyValues() As String) As ConfigurationElement
      For Each element As ConfigurationElement In collection
         If String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase) Then
            Dim matches As Boolean = True
            Dim i As Integer
            For i = 0 To keyValues.Length - 1 Step 2
               Dim o As Object = element.GetAttributeValue(keyValues(i))
               Dim value As String = Nothing
               If (Not (o) Is Nothing) Then
                  value = o.ToString
               End If
               If Not String.Equals(value, keyValues((i + 1)), StringComparison.OrdinalIgnoreCase) Then
                  matches = False
                  Exit For
               End If
            Next
            If matches Then
               Return element
            End If
         End If
      Next
      Return Nothing
   End Function


End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST");
var sitesCollection = sitesSection.Collection;

var siteElementPos = FindElement(sitesCollection, "site", ["name", "Contoso"]);
if (siteElementPos == -1) throw "Element not found!";

var siteElement = sitesCollection.Item(siteElementPos);
var logFileElement = siteElement.ChildElements.Item("logFile");
logFileElement.Properties.Item("logFormat").Value = "W3C";
logFileElement.Properties.Item("period").Value = "Daily";
logFileElement.Properties.Item("localTimeRollover").Value = true;
logFileElement.Properties.Item("enabled").Value = true;

adminManager.CommitChanges();

function FindElement(collection, elementTagName, valuesToMatch) {
   for (var i = 0; i < collection.Count; i++) {
      var element = collection.Item(i);
      if (element.Name == elementTagName) {
         var matches = true;
         for (var iVal = 0; iVal < valuesToMatch.length; iVal += 2) {
            var property = element.GetPropertyByName(valuesToMatch[iVal]);
            var value = property.Value;
            if (value != null) {
               value = value.toString();
            }
            if (value != valuesToMatch[iVal + 1]) {
               matches = false;
               break;
            }
         }
         if (matches) {
            return i;
         }
      }
   }
   return -1;
}

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")
Set sitesCollection = sitesSection.Collection
siteElementPos = FindElement(sitesCollection, "site", Array("name", "Contoso"))

If siteElementPos = -1 Then
   WScript.Echo "Element not found!"
   WScript.Quit
End If

Set siteElement = sitesCollection.Item(siteElementPos)
Set logFileElement = siteElement.ChildElements.Item("logFile")
logFileElement.Properties.Item("logFormat").Value = "W3C"
logFileElement.Properties.Item("period").Value = "Daily"
logFileElement.Properties.Item("localTimeRollover").Value = True
logFileElement.Properties.Item("enabled").Value = True

adminManager.CommitChanges()

Function FindElement(collection, elementTagName, valuesToMatch)
   For i = 0 To CInt(collection.Count) - 1
      Set element = collection.Item(i)
      If element.Name = elementTagName Then
         matches = True
         For iVal = 0 To UBound(valuesToMatch) Step 2
            Set property = element.GetPropertyByName(valuesToMatch(iVal))
            value = property.Value
            If Not IsNull(value) Then
               value = CStr(value)
            End If
            If Not value = CStr(valuesToMatch(iVal + 1)) Then
               matches = False
               Exit For
            End If
         Next
         If matches Then
            Exit For
         End If
      End If
   Next
   If matches Then
      FindElement = i
   Else
      FindElement = -1
   End If
End Function