Ablaufverfolgungs-URLs <traceUrls>

Artikel
03/27/2024

Übersicht

Das <traceUrls>-Element enthält eine Sammlung von <add>-Elementen, die jeweils eine URL zum Aktivieren der Ablaufverfolgung definieren.

Hinweis

Die Ereignisablaufverfolgung für Windows (Event Tracing for Windows, ETW) ist eine universelle und schnelle Ablaufverfolgungsfunktion, die vom Betriebssystem bereitgestellt wird. Mithilfe eines im Kernel implementierten Pufferungs- und Protokollierungsmechanismus bietet die Ereignisablaufverfolgung für Windows einen Ablaufverfolgungsmechanismus für Ereignisse, die sowohl von Benutzermodusanwendungen als auch von Kernelmodus-Gerätetreibern ausgelöst werden. Darüber hinaus gibt Ihnen die Ereignisablaufverfolgung für Windows die Möglichkeit, die Protokollierung dynamisch zu aktivieren und zu deaktivieren, was eine problemlose detaillierte Ablaufverfolgung in Produktionsumgebungen ganz ohne System- oder Anwendungsneustarts ermöglicht. Der Protokollierungsmechanismus verwendet prozessorspezifische Puffer, die durch einen asynchronen Schreibthread auf den Datenträger geschrieben werden. Dadurch können große Serveranwendungen Ereignisse mit minimalen Störungen schreiben.

Kompatibilität

Version	Hinweise
IIS 10.0	Das `<traceUrls>`-Element wurde in IIS 10.0 nicht geändert.
IIS 8.5	Das `<traceUrls>`-Element wurde in IIS 8.5 nicht geändert.
IIS 8.0	Das `<traceUrls>`-Element wurde in IIS 8.0 nicht geändert.
IIS 7.5	Das `<traceUrls>`-Element wurde in IIS 7.5 nicht geändert.
IIS 7.0	Das `<traceUrls>`-Element der `<httpTracing>`-Sammlung wurde in IIS 7.0 eingeführt.
IIS 6.0	N/V

Setup

Das <traceUrls>-Element der <httpTracing>-Sammlung ist in der Standardinstallation von IIS 7 enthalten.

Gewusst wie

Für IIS 7 steht keine Benutzeroberfläche für das <httpTracing>-Element zur Verfügung. Beispiele für den programmgesteuerten Zugriff auf das <httpTracing>-Element finden Sie im Abschnitt Codebeispiele dieses Dokuments.

Konfiguration

Attribute

Keine

Untergeordnete Elemente

Element	Beschreibung
`add`	Optionales Element. Fügt der Sammlung von Ablaufverfolgungs-URLs einen Ablaufverfolgungs-URL hinzu.
`clear`	Optionales Element. Entfernt alle Verweise auf Ablaufverfolgungs-URLs aus der Sammlung von Ablaufverfolgungs-URLs.
`remove`	Optionales Element. Entfernt einen Verweis auf eine Ablaufverfolgungs-URL aus der Sammlung von Ablaufverfolgungs-URLs.

Konfigurationsbeispiel

Wenn das folgende Beispiel in einer Datei vom Typ „Web.config“ im Stammverzeichnis der Standardwebsite platziert wird, wird die Ablaufverfolgung für die exemplarische Startseite aktiviert, die zusammen mit IIS 7 bereitgestellt wird.

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

Beispielcode

In den folgenden Beispielen wird die Ablaufverfolgung für die exemplarische Startseite, die zusammen mit IIS 7 bereitgestellt wird, auf einer Website mit dem Namen „Contoso“ aktiviert, indem ein Eintrag zur <traceUrls>-Sammlung für diese Site hinzugefügt wird.

AppCmd.exe

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

Hinweis

Legen Sie den commit-Parameter auf apphost fest, wenn Sie „AppCmd.exe“ verwenden, um diese Einstellungen zu konfigurieren. Dadurch werden die Konfigurationseinstellungen auf den entsprechenden Speicherortabschnitt in der Datei „ApplicationHost.config“ festgelegt.

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()

Freigeben über