<URL di tracciaUrls>

Articolo
07/19/2023

Panoramica

L'elemento <traceUrls> contiene una raccolta di <add> elementi, ognuno dei quali definisce un URL per abilitare la traccia.

Nota

Event Tracing for Windows (ETW) è una struttura di traccia ad alta velocità fornita dal sistema operativo. Usando un meccanismo di buffering e registrazione implementato nel kernel, ETW fornisce un meccanismo di traccia per gli eventi generati da applicazioni in modalità utente e driver di dispositivo in modalità kernel. Inoltre, ETW offre la possibilità di abilitare e disabilitare la registrazione in modo dinamico, semplificando l'esecuzione di traccia dettagliata negli ambienti di produzione senza richiedere riavvii o riavvii delle applicazioni. Il meccanismo di registrazione usa buffer per processore scritti su disco da un thread writer asincrono. Ciò consente alle applicazioni server su larga scala di scrivere eventi con un disturbo minimo.

Compatibilità

Versione	Note
IIS 10.0	L'elemento `<traceUrls>` non è stato modificato in IIS 10.0.
IIS 8,5	L'elemento `<traceUrls>` non è stato modificato in IIS 8.5.
IIS 8,0	L'elemento `<traceUrls>` non è stato modificato in IIS 8.0.
IIS 7,5	L'elemento `<traceUrls>` non è stato modificato in IIS 7.5.
IIS 7.0	L'elemento `<traceUrls><httpTracing>` della raccolta è stato introdotto in IIS 7.0.
IIS 6.0	N/D

Installazione

L'elemento <traceUrls> della <httpTracing> raccolta è incluso nell'installazione predefinita di IIS 7.

Procedure

Non esiste un'interfaccia utente per l'elemento <httpTracing> per IIS 7. Per esempi di come accedere all'elemento <httpTracing> a livello di codice, vedere la sezione Esempi di codice di questo documento.

Configurazione

Attributi

Nessuno.

Elementi figlio

Elemento	Descrizione
`add`	Elemento facoltativo. Aggiunge un URL di traccia alla raccolta di URL di traccia.
`clear`	Elemento facoltativo. Rimuove tutti i riferimenti agli URL di traccia dalla raccolta URL di traccia.
`remove`	Elemento facoltativo. Rimuove un riferimento a un URL di traccia dalla raccolta URL di traccia.

Esempio di configurazione

Nell'esempio seguente verrà abilitata la traccia per la home page di esempio fornita con IIS 7 quando viene inserito in un file Web.config nella radice del sito Web predefinito.

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

Codice di esempio

Negli esempi seguenti viene abilitata la traccia per la home page di esempio fornita con IIS 7 nel sito Web denominato Contoso aggiungendo una voce alla <traceUrls> raccolta per tale sito.

AppCmd.exe

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

Nota

È necessario assicurarsi di impostare il parametro commit su apphost quando si usa AppCmd.exe per configurare queste impostazioni. Questa operazione esegue il commit delle impostazioni di configurazione nella sezione percorso appropriata nel file di 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()

Share via