Aggiunta di URL <di traccia>

Articolo
07/19/2023

Panoramica

L'elemento <add><traceUrls> della raccolta aggiunge un URL di traccia alla raccolta di URL per la traccia ETW.

Nota

Event Tracing for Windows (ETW) è una funzionalità di traccia generica ad alta velocità fornita dal sistema operativo. Usando un meccanismo di memorizzazione nel buffer 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 dell'applicazione. 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 disturbo minimo.

Compatibilità

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

Installazione

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

Procedure

Non esiste alcuna 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

Attributo	Descrizione
`Value`	Attributo stringa obbligatorio. Specifica l'URL da tracciare.

Elementi figlio

Nessuno.

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 di 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 raccolta per tale <traceUrls> 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. In questo modo le impostazioni di configurazione vengono confermate nella sezione relativa al percorso appropriato nel file 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()

Condividi tramite