URLs de Rastreamento <traceUrls>

Artigo
03/25/2024

Visão geral

O elemento <traceUrls> contém uma coleção de elementos <add>, cada um deles define uma URL para habilitar o rastreamento.

Observação

O ETW (Rastreamento de Eventos para Windows) é um recurso de rastreamento de alta velocidade de uso geral fornecido pelo sistema operacional. Usando um mecanismo de buffer e registro em log implementado no kernel, o ETW fornece um mecanismo de rastreamento para eventos gerados por aplicativos no modo de usuário e drivers de dispositivo no modo kernel. Além disso, o ETW oferece a capacidade de habilitar e desabilitar o registro em log dinamicamente, facilitando a execução de rastreamento detalhado em ambientes de produção, sem a necessidade de inicializações ou reinicializações de aplicativo. O mecanismo de registro em log usa buffers por processador que são gravados em disco por um thread de gravador assíncrono. Isso permite que aplicativos de servidor em grande escala gravem eventos com o mínimo de interferência.

Compatibilidade

Versão	Observações
IIS 10.0	O elemento `<traceUrls>` não foi modificado no IIS 10.0.
IIS 8.5	O elemento `<traceUrls>` não foi modificado no IIS 8.5.
IIS 8.0	O elemento `<traceUrls>` não foi modificado no IIS 8.0.
IIS 7.5	O elemento `<traceUrls>` não foi modificado no IIS 7.5.
IIS 7.0	O elemento `<traceUrls>` da coleção `<httpTracing>` foi introduzido no IIS 7.0.
IIS 6,0	N/D

Instalação

O elemento <traceUrls> da coleção <httpTracing> está incluído na instalação padrão do IIS 7.

Instruções

Não há nenhuma interface do usuário para o elemento <httpTracing> para IIS 7. Para obter exemplos de como acessar o elemento <httpTracing> programaticamente, consulte a seção Exemplos de Código desse documento.

Configuração

Atributos

Nenhum.

Elementos filho

Elemento	Descrição
`add`	Elemento opcional. Adiciona uma URL de rastreamento à coleção de URLs de rastreamento.
`clear`	Elemento opcional. Remove todas as referências a URLs de rastreamento da coleção de URLs de rastreamento.
`remove`	Elemento opcional. Remove uma referência a uma URL de rastreamento da coleção de URLs de rastreamento.

Exemplo de configuração

O exemplo a seguir habilitará o rastreamento para a home page de exemplo que é fornecida com o IIS 7, quando colocada em um arquivo Web.config na raiz do Site Padrão.

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

Exemplo de código

Os exemplos a seguir permitem o rastreamento da home page de exemplo que é fornecida com o IIS 7 no site chamado Contoso, adicionando uma entrada à coleção <traceUrls> desse site.

AppCmd.exe

appcmd.exe set config "Contoso" -section:system.webServer/httpTracing /+"traceUrls.[value='/iisstart.htm']" /commit:apphost

Observação

Defina o parâmetro commit para apphost quando usar AppCmd.exe para definir essas configurações. Isso confirma as definições de configuração para a seção de local apropriado no arquivo 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()

Compartilhar via