Direcciones URL de seguimiento <traceUrls>

Información general

El elemento <traceUrls> contiene una colección de elementos <add>, cada uno de los cuales define una dirección URL para habilitar el seguimiento.

Nota:

El Seguimiento de eventos para Windows (ETW) es una utilidad de seguimiento de alta velocidad y de uso general proporcionada por el sistema operativo. Gracias al mecanismo de almacenamiento en búfer y registro implementado en el kernel, ETW proporciona un mecanismo de seguimiento para los eventos generados por aplicaciones en modo usuario y controladores de dispositivos en modo kernel. Además, ETW le ofrece la posibilidad de habilitar y deshabilitar el registro dinámicamente, lo que facilita el seguimiento detallado en entornos de producción sin necesidad de arrancar el sistema o reiniciar las aplicaciones. El mecanismo de registro usa búferes por procesador que un subproceso de escritura asincrónico escribe en el disco. Esto permite que las aplicaciones de servidor a gran escala escriban eventos con una alteración mínima.

Compatibilidad

Versión	Notas
IIS 10.0	El elemento <traceUrls> no se modificó en IIS 10.0.
IIS 8.5	El elemento <traceUrls> no se modificó en IIS 8.5.
IIS 8.0	El elemento <traceUrls> no se modificó en IIS 8.0.
IIS 7.5	El elemento <traceUrls> no se modificó en IIS 7.5.
IIS 7.0	El elemento <traceUrls> de la colección <httpTracing> se introdujo en IIS 7.0.
IIS 6,0	N/D

Configuración

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

Procedimientos

No hay ninguna interfaz de usuario para el elemento <httpTracing> para IIS 7. Para obtener ejemplos de cómo acceder al elemento <httpTracing> mediante programación, consulte la sección Ejemplos de código de este documento.

Configuración

Atributos

Ninguno.

Elementos secundarios

Elemento	Descripción
add	Elemento opcional. Agrega una dirección URL de seguimiento a la colección de direcciones URL de seguimiento.
clear	Elemento opcional. Quita todas las referencias a direcciones URL de seguimiento de la colección de direcciones URL de seguimiento.
remove	Elemento opcional. Quita una referencia a una dirección URL de seguimiento de la colección de direcciones URL de seguimiento.

Ejemplo de configuración

En el ejemplo siguiente se habilitará el seguimiento de la página principal de ejemplo que se incluye con IIS 7 cuando se coloca en un archivo Web.config en la raíz del sitio web predeterminado.

<configuration>
   <system.webServer>
      <httpTracing>
         <traceUrls>
            <add value="/iisstart.htm" />
         </traceUrls>
      </httpTracing>
   </system.webServer>
</configuration>

Código de ejemplo

En los ejemplos siguientes se habilita el seguimiento de la página principal de ejemplo que se incluye con IIS 7 en el sitio web denominado Contoso agregando una entrada a la colección <traceUrls> para ese sitio.

AppCmd.exe

appcmd.exe set config "Contoso" -section:system.webServer/httpTracing /+"traceUrls.[value='/iisstart.htm']" /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 httpTracingSection = config.GetSection("system.webServer/httpTracing", "Contoso");
         ConfigurationElementCollection traceUrlsCollection = httpTracingSection.GetCollection("traceUrls");

         ConfigurationElement addElement = traceUrlsCollection.CreateElement("add");
         addElement["value"] = @"/iisstart.htm";
         traceUrlsCollection.Add(addElement);

         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 httpTracingSection As ConfigurationSection = config.GetSection("system.webServer/httpTracing", "Contoso")

      Dim traceUrlsCollection As ConfigurationElementCollection = httpTracingSection.GetCollection("traceUrls")
      Dim addElement As ConfigurationElement = traceUrlsCollection.CreateElement("add")
      addElement("value") = "/iisstart.htm"
      traceUrlsCollection.Add(addElement)

      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var httpTracingSection = adminManager.GetAdminSection("system.webServer/httpTracing", "MACHINE/WEBROOT/APPHOST/Contoso");

var traceUrlsCollection = httpTracingSection.ChildElements.Item("traceUrls").Collection;
var addElement = traceUrlsCollection.CreateNewElement("add");
addElement.Properties.Item("value").Value = "/iisstart.htm";
traceUrlsCollection.AddElement(addElement);

adminManager.CommitChanges();

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set httpTracingSection = adminManager.GetAdminSection("system.webServer/httpTracing", "MACHINE/WEBROOT/APPHOST/Contoso")

Set traceUrlsCollection = httpTracingSection.ChildElements.Item("traceUrls").Collection
Set addElement = traceUrlsCollection.CreateNewElement("add")
addElement.Properties.Item("value").Value = "/iisstart.htm"
traceUrlsCollection.AddElement addElement

adminManager.CommitChanges()