Compartir a través de

Registro predeterminado de solicitudes con error de seguimiento para un <traceFailedRequestsLogging> de un sitio

  • Artículo

Información general

El elemento <traceFailedRequestsLogging> del elemento <siteDefaults> establece las opciones de seguimiento de solicitudes con error para todos los sitios, como el directorio para los archivos de registro de seguimiento de solicitudes con error, el número máximo de archivos de registro de seguimiento de solicitudes con error y si el seguimiento de solicitudes con error está habilitado.

Nota:

Si el elemento <traceFailedRequestsLogging> está configurado en la sección <siteDefaults> y en la sección <site> de un sitio específico, la configuración de la sección <site> se usa para ese sitio.

Nota:

El elemento <traceFailedRequestsLogging> especifica las opciones de nivel global para el seguimiento de solicitudes con error, pero el elemento <system.webServer/tracing/traceFailedRequests> especifica reglas de seguimiento de solicitudes con error.

Compatibilidad

Versión Notas
IIS 10.0 El elemento <traceFailedRequestsLogging> no se modificó en IIS 10.0.
IIS 8.5 El elemento <traceFailedRequestsLogging> no se modificó en IIS 8.5.
IIS 8.0 Se ha aumentado el valor predeterminado del atributo maxLogFileSizeKB.
IIS 7.5 El elemento <traceFailedRequestsLogging> no se modificó en IIS 7.5.
IIS 7.0 El elemento <traceFailedRequestsLogging> del elemento <siteDefaults> se introdujo en IIS 7.0.
IIS 6,0 N/D

Configuración

Después de finalizar la instalación predeterminada de IIS 7 y versiones posteriores, debe instalar el servicio de rol de seguimiento para usar el seguimiento de solicitudes con errores. Después de instalar el servicio de rol, todavía debe habilitar el seguimiento de solicitudes con error en el nivel de sitio, el nivel de aplicación o el nivel de directorio.

Windows Server 2012 o Windows Server 2012 R2

  1. En la barra de tareas, haga clic en Administrador del servidor.
  2. En Administrador del servidor, haga clic en el menú Administrar y, después, haga clic en Agregar roles y características.
  3. En el asistente para Agregar roles y características, haga clic en Siguiente. Seleccione el tipo de instalación y haga clic en Siguiente. Seleccione el servidor de destino y haga clic en Siguiente.
  4. En la página Roles de servidor, expanda Servidor web (IIS), expanda Servidor web, expanda Mantenimiento y diagnósticos y, a continuación, seleccione Seguimiento. Haga clic en Next.
    Screenshot of Tracing selected under Health and Diagnostics in an expanded Web Server list..
  5. En la página Seleccionar características, haz clic en Siguiente.
  6. En la página Confirmar selecciones de instalación, haga clic en Instalar.
  7. En la página Resultados , haga clic en Cerrar.

Windows 8 o Windows 8.1

  1. En la pantalla Inicio, mueva el puntero hasta la esquina inferior izquierda, haga clic con el botón derecho en el botón Inicio y, a continuación, haga clic en Panel de control.
  2. En Panel de control, haga clic en Programas y características y después en Activar o desactivar las características de Windows.
  3. Expanda Internet Information Services, expanda World Wide Web Services, expanda Mantenimiento y diagnóstico y, a continuación, seleccione Seguimiento.
    Screenshot of Tracing selected under Health in a Windows 8 interface.: haga clic en Aceptar.
  4. Haga clic en Cerrar.

Windows Server 2008 o Windows Server 2008 R2

  1. En la barra de tareas, haga clic en Inicio, seleccione Herramientas administrativas y, luego, haga clic en Administrador del servidor.
  2. En el panel de jerarquía del Administrador del servidor, expanda Roles y, luego, haga clic en Servidor web (IIS).
  3. En el panel Servidor web (IIS), desplácese hasta la sección Servicios de rol y, luego, haga clic en Agregar servicios de rol.
  4. En la página Seleccionar servicios de rol del Asistente para agregar servicios de rol, seleccione Seguimiento y haga clic en Siguiente.
    Screenshot of Tracing selected under Health and Diagnostics in the Add Role Services dialog.
  5. En la página Confirmar selecciones de instalación, haz clic en Instalar.
  6. En la página Resultados , haga clic en Cerrar.

Windows Vista o Windows 7

  1. En la barra de tareas, haga clic en Inicio y, luego, haga clic en Panel de control.
  2. En Panel de control, haga clic en Programas y características y después en Activar o desactivar las características de Windows.
  3. Expanda Internet Information Services, después Servicios World Wide Web y, a continuación Estado y diagnóstico.
  4. Seleccione Seguimiento y después haga clic en Aceptar.
    Screenshot of Tracing selected under Health in a Windows Vista or Windows 7 interface.

Procedimientos

Configuración de los valores predeterminados del sitio para un servidor

  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, 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).

  2. En el panel Conexiones, expanda el nombre del servidor y haga clic en el nodo Sitios.

  3. En el panel Sitios del servidor, haga clic en Establecer valores predeterminados del sitio web... en el panel Acciones.
    Screenshot of the Sites pane with the Default Web Site.

  4. En el cuadro de diálogo Valores predeterminados del sitio web, especifique las opciones predeterminadas para todos los sitios web y, a continuación, haga clic en Aceptar.

    Screenshot of the Web Site Defaults dialog with General and Behavior options.

Configuración

Atributos

Atributo Descripción
customActionsEnabled Atributo Boolean opcional.

Especifica si las acciones personalizadas están habilitadas para el seguimiento de solicitudes con error.

El valor predeterminado es false.
directory Atributo de cadena opcional.

Especifica el directorio de registro de seguimiento de solicitudes con error para un sitio.

El valor predeterminado es %SystemDrive%\inetpub\logs\FailedReqLogFiles.
enabled Atributo Boolean opcional.

Especifica si el registro de seguimiento de solicitudes con error está habilitado para un sitio (true) o deshabilitado (false).

El valor predeterminado es false.
maxLogFiles Atributo uint opcional.

Especifica el número máximo de archivos de registro de seguimiento de solicitudes con error que se conservarán para el sitio.

El valor predeterminado es 50.
maxLogFileSizeKB Atributo uint opcional.

Especifica el tamaño máximo de archivo en kilobytes para los registros de seguimiento de solicitudes con error.

Nota: Si los registros de seguimiento de solicitudes con error superan este valor, IIS truncará los registros en el tamaño máximo del archivo y especificará LOG_FILE_MAX_SIZE_TRUNCATE para el evento de seguimiento.

El valor predeterminado es 1024.

Elementos secundarios

Ninguno.

Ejemplo de configuración

En el ejemplo de configuración siguiente se especifican las opciones traceFailedRequestsLogging predeterminadas para IIS 7.

<system.applicationHost>
   <sites>
      <siteDefaults>
         <traceFailedRequestsLogging enabled="true"
            directory="%SystemDrive%\inetpub\logs\FailedReqLogFiles"
            maxLogFiles="20" />
      </siteDefaults>
   </sites>
</system.applicationHost>

Código de ejemplo

Los ejemplos de código siguientes configuran las opciones traceFailedRequestsLogging predeterminadas para IIS 7.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.traceFailedRequestsLogging.enabled:"True" /commit:apphost
appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.traceFailedRequestsLogging.directory:"%SystemDrive%\inetpub\logs\FailedReqLogFiles" /commit:apphost
appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.traceFailedRequestsLogging.maxLogFiles:"20" /commit:apphost

Nota:

Debe asegurarse de establecer el parámetrocommit en apphost cuando use AppCmd.exe para configurar estos valores. 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 sitesSection = config.GetSection("system.applicationHost/sites");
         ConfigurationElement siteDefaultsElement = sitesSection.GetChildElement("siteDefaults");

         ConfigurationElement traceFailedRequestsLoggingElement = siteDefaultsElement.GetChildElement("traceFailedRequestsLogging");
         traceFailedRequestsLoggingElement["enabled"] = true;
         traceFailedRequestsLoggingElement["directory"] = @"%SystemDrive%\inetpub\logs\FailedReqLogFiles";
         traceFailedRequestsLoggingElement["maxLogFiles"] = 20;

         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 sitesSection As ConfigurationSection = config.GetSection("system.applicationHost/sites")
      Dim siteDefaultsElement As ConfigurationElement = sitesSection.GetChildElement("siteDefaults")

      Dim traceFailedRequestsLoggingElement As ConfigurationElement = siteDefaultsElement.GetChildElement("traceFailedRequestsLogging")
      traceFailedRequestsLoggingElement("enabled") = True
      traceFailedRequestsLoggingElement("directory") = "%SystemDrive%\inetpub\logs\FailedReqLogFiles"
      traceFailedRequestsLoggingElement("maxLogFiles") = 20

      serverManager.CommitChanges()
   End Sub

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 siteDefaultsElement = sitesSection.ChildElements.Item("siteDefaults");

var traceFailedRequestsLoggingElement = siteDefaultsElement.ChildElements.Item("traceFailedRequestsLogging");
traceFailedRequestsLoggingElement.Properties.Item("enabled").Value = true;
traceFailedRequestsLoggingElement.Properties.Item("directory").Value = "%SystemDrive%\\inetpub\\logs\\FailedReqLogFiles";
traceFailedRequestsLoggingElement.Properties.Item("maxLogFiles").Value = 20;

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")
Set siteDefaultsElement = sitesSection.ChildElements.Item("siteDefaults")

Set traceFailedRequestsLoggingElement = siteDefaultsElement.ChildElements.Item("traceFailedRequestsLogging")
traceFailedRequestsLoggingElement.Properties.Item("enabled").Value = True
traceFailedRequestsLoggingElement.Properties.Item("directory").Value = "%SystemDrive%\inetpub\logs\FailedReqLogFiles"
traceFailedRequestsLoggingElement.Properties.Item("maxLogFiles").Value = 20

adminManager.CommitChanges()