Anforderungsfehler verfolgen <traceFailedRequests>

Artikel
03/25/2024

Übersicht

Mit dem <traceFailedRequests>traceFailedRequests-Element können Sie die Fehleranforderungsablaufverfolgung für eine Website, Anwendung oder ein Verzeichnis konfigurieren. Dieses Element kann eine Auflistung von <add>-Elementen enthalten, die Ablaufverfolgungsregeln definieren, von denen jede die Erweiterung der Anforderungs-URL angibt, auf die die Regel angewendet wird, die Ablaufverfolgungsanbieter und Bereiche, die aktiviert werden sollen, und die Bedingungen, die dazu führen, dass diese Regel die Ereignisse protokolliert.

Kompatibilität

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

Setup

Nachdem Sie die Standardinstallation von IIS 7 und höher abgeschlossen haben, müssen Sie den Ablaufverfolgungsrollendienst installieren, um die Ablaufverfolgung fehlgeschlagener Anforderungen zu verwenden. Nachdem Sie den Rollendienst installiert haben, müssen Sie dennoch die Ablaufverfolgung fehlgeschlagener Anforderungen auf Standortebene, Anwendungsebene oder Verzeichnisebene aktivieren.

Windows Server 2012 oder Windows Server 2012 R2

Klicken Sie auf der Taskleiste auf Server-Manager.
Klicken Sie im Server-Manager auf Verwalten und dann auf Rollen und Features hinzufügen.
Klicken Sie im Assistenten zum Hinzufügen von Rollen und Features auf Weiter. Wählen Sie den Installationstyp aus, und klicken Sie auf Weiter. Wählen Sie den Zielserver aus, und klicken Sie auf Weiter.
Erweitern Sie auf der Seite Serverrollen den Webserver (IIS)erweitern Sie den Webserver, erweitern Sie Integrität und Diagnose, und wählen Sie dann Ablaufverfolgung. Klicken Sie auf Weiter.
.
Klicken Sie auf der Seite Features auswählen auf Weiter.
Klicken Sie auf der Seite Installationsauswahl bestätigen auf Installieren.
Klicken Sie auf der Seite Ergebnisse auf Schließen.

Windows 8 oder Windows 8.1

Bewegen Sie auf dem Startbildschirm den Mauszeiger ganz nach links unten, klicken Sie mit der rechten Maustaste auf die Starttaste und klicken Sie dann auf Systemsteuerung.
Klicken Sie in der Systemsteuerungauf Programme und dann auf „Windows-Features aktivieren oder deaktivieren“.
Erweitern Sie Internetinformationsdienste, erweitern Sie World Wide Web Services, erweitern SieIntegrität und Diagnose, und wählen Sie dann Ablaufverfolgung.
- Klicken Sie auf OK.
Klicken Sie auf Schließen.

Windows Server 2008 oder Windows Server 2008 R2

Klicken Sie auf der Taskleiste auf Start, zeigen Sie auf Verwaltungstools, und klicken Sie dann auf Server-Manager.
Erweitern Sie im Hierarchiebereich des Server-Managers die Rollenund klicken Sie dann auf den Webserver (IIS) .
Scrollen Sie im Bereich Webserver (IIS) zum Abschnitt Rollendienste, und klicken Sie dann auf Rollendienste hinzufügen.
Wählen Sie auf der Seite Rollendienste auswählen des Assistenten zum Hinzufügen von RollendienstenNachverfolgung aus, und klicken Sie dann auf Weiter.
Klicken Sie auf der Seite Installationsauswahl bestätigen auf Installieren.
Klicken Sie auf der Seite Ergebnisse auf Schließen.

Windows Vista oder Windows 7

Klicken Sie auf der Taskleiste auf Start und dann auf Systemsteuerung.
Klicken Sie in der Systemsteuerungauf Programme und Funktionenund dann auf Windows-Features aktivieren oder deaktivieren.
Erweitern Sie Internetinformationsdienste, und World Wide Web Services, und dann Integrität und Diagnose.
Wählen Sie Nachverfolgungaus und klicken Sie dann auf OK.

Gewusst wie

Aktivieren der Ablaufverfolgung

Öffnen Sie den Internet Information Services (IIS) Manager:
- Wenn Sie Windows Server 2012 oder Windows Server 2012 R2 verwenden:
  - Klicken Sie der der Taskleiste auf Server-Managerdann auf Toolsund dann auf den Internet Information Services (IIS) Manager.
- Wenn Sie Windows 8 oder Windows 8.1 verwenden:
  - Halten Sie die Windows-Taste gedrückt, drücken Sie den Buchstaben X, und klicken Sie dann auf "Systemsteuerung".
  - Klicken Sie auf Verwaltungund doppelklicken Sie dann auf den Internet Information Services (IIS) Manager.
- Wenn Sie Windows Server 2008 oder Windows Server 2008 R2 verwenden:
  - Klicken Sie auf der Taskleiste auf Start, zeigen Sie auf Verwaltungund dann auf den Internet Information Services (IIS) Manager.
- Wenn Sie Windows Vista oder Windows 7 verwenden:
  - Klicken Sie auf der Taskleiste auf Start und dann auf Systemsteuerung.
  - Doppelklicken Sie auf Verwaltungund doppelklicken Sie dann auf den Internet Information Services (IIS) Manager.
Wählen Sie im Bereich Verbindungen die Serververbindung, den Standort, die Anwendung oder das Verzeichnis aus, für die Sie die Nachverfolgung für fehlerhafte Anforderungen konfigurieren möchten.
Klicken Sie im Bereich Aktionen auf Fehlgeschlagene Anforderungsablaufverfolgung...
Wählen Sie im Dialogfeld Einstellungen für die Anforderungsablaufverfolgung der Website bearbeiten das Kontrollkästchen Aktivieren, um die Ablaufverfolgung zu aktivieren, lassen Sie den Standardwert stehen oder geben Sie ein neues Verzeichnis im Feld Verzeichnisein, in dem Sie fehlgeschlagene Anforderungsprotokolldateien speichern möchten. Geben Sie die Anzahl der fehlgeschlagenen Anforderungsablaufverfolgungsdateien im Feld Maximale Anzahl von Ablaufverfolgungsdateien ein und klicken Sie dann auf OK.

Konfigurieren von Fehlerdefinitionen

Öffnen Sie den Internet Information Services (IIS) Manager:
- Wenn Sie Windows Server 2012 oder Windows Server 2012 R2 verwenden:
  - Klicken Sie der der Taskleiste auf Server-Managerdann auf Toolsund dann auf den Internet Information Services (IIS) Manager.
- Wenn Sie Windows 8 oder Windows 8.1 verwenden:
  - Halten Sie die Windows-Taste gedrückt, drücken Sie den Buchstaben X, und klicken Sie dann auf "Systemsteuerung".
  - Klicken Sie auf Verwaltungund doppelklicken Sie dann auf den Internet Information Services (IIS) Manager.
- Wenn Sie Windows Server 2008 oder Windows Server 2008 R2 verwenden:
  - Klicken Sie auf der Taskleiste auf Start, zeigen Sie auf Verwaltungund dann auf den Internet Information Services (IIS) Manager.
- Wenn Sie Windows Vista oder Windows 7 verwenden:
  - Klicken Sie auf der Taskleiste auf Start und dann auf Systemsteuerung.
  - Doppelklicken Sie auf Verwaltungund doppelklicken Sie dann auf den Internet Information Services (IIS) Manager.
Wählen Sie im Bereich Verbindungen die Verbindung, den Standort, die Anwendung oder das Verzeichnis aus, für die Sie die Nachverfolgung für fehlerhafte Anforderungen konfigurieren möchten.
Doppelklicken Sie unter Home auf Nachverfolgungsregeln für fehlerhafte Anforderungen.
Klicken Sie im Bereich Aktionen auf Hinzufügen...
Wählen Sie auf der Seite Inhalt zur Ablaufverfolgung angeben des Assistenten zum Hinzufügen der Regel zur Ablaufverfolgung von Fehlgeschlagenen Anforderungen den Inhaltstyp aus, den Sie nachverfolgen möchten und klicken Sie dann auf Weiter.
Wählen Sie auf der Seite Ablaufverfolgungsbedingungen definieren die Bedingungen aus, die Sie nachverfolgen möchten, und klicken Sie dann auf Weiter. Zu den Ablaufverfolgungsbedingungen können eine beliebige Kombination von Statuscodes, ein Zeitlimit, das eine Anforderung in Anspruch nehmen sollte, oder der Schweregrad des Ereignisses gehören. Wenn Sie alle Bedingungen angeben, generiert die erste Bedingung, die erfüllt ist, die Ablaufverfolgungsprotokolldatei für die fehlerhafte Anforderung.
Wählen Sie auf der Seite Ablaufverfolgungsanbieter auswählen einen oder mehrere der Ablaufverfolgungsanbieter unter Anbieter aus.
Wählen Sie auf der Seite Ablaufverfolgungsanbieter auswählen unter Ausführlichkeit mindestens eine der Ausführlichkeitsstufen aus.
Wenn Sie den ASPNET oder WWW Server-Ablaufverfolgungsanbieter in Schritt 8 ausgewählt haben, wählen Sie einen oder mehrere Funktionsbereiche für den Anbieter aus, der unter Bereiche der Seite Ablaufverfolgungsanbieter auswählen nachverfolgt werden soll.
Klicken Sie auf Fertig stellen.

Konfiguration

Sie können das <traceFailedRequests>-Element auf Serverebene in der Datei ApplicationHost.config oder auf Website-, Anwendungs- oder URL-Ebene in der entsprechenden Datei Web.config konfigurieren.

Attribute

Keine

Untergeordnete Elemente

Element	Beschreibung
`add`	Optionales Element. Fügt der Auflistung von Pfaddefinitionen einen Pfad hinzu.
`remove`	Optionales Element. Entfernt einen Verweis auf einen Pfad aus der Pfaddefinitionsauflistung.
`clear`	Optionales Element. Entfernt alle Verweise auf Pfade aus der Pfaddefinitionsauflistung.

Konfigurationsbeispiel

Im folgenden Konfigurationsbeispiel wird die Ablaufverfolgung auf Serverebene in der Datei ApplicationHost.config konfiguriert. Es legt die Ablaufverfolgung für alle .aspx Dateien fest, verwendet das <traceAreas> Element, um den ASPNET-Anbieter und die Ablaufverfolgung für alle ASP.NET Bereiche festzulegen, die Infrastruktur,Modul ,Page und AppServices sind. Im Beispiel wird auch das Attribut Ausführlichkeit verwendet, um die Menge der Informationen, die an die Ablaufverfolgungsdatei zurückgegeben werden, auf Warnung festzulegen. Schließlich verwendet das Beispiel das <failureDefinitions> Element, um nur Anforderungen zu verfolgen, die einen HTTP 404-Statuscode generieren.

<tracing>
   <traceFailedRequests>
      <add path="*.aspx">
         <traceAreas>
            <add provider="ASPNET" areas="Infrastructure,Module,Page,AppServices" verbosity="Warning" />
         </traceAreas>
         <failureDefinitions statusCodes="404" />
      </add>
   </traceFailedRequests>
</tracing>

Beispielcode

In den folgenden Beispielen werden ausführliche Fehler bei der Anforderungsablaufverfolgung für HTTP 500-Fehler in ASP.NET Inhalt aller Anforderungen an *.aspx Seiten aktiviert.

AppCmd.exe

appcmd.exe set config "Contoso" -section:system.webServer/tracing/traceFailedRequests /+"[path='*.aspx']" 

appcmd.exe set config "Contoso" -section:system.webServer/tracing/traceFailedRequests /+"[path='*.aspx'].traceAreas.[provider='ASPNET',areas='Infrastructure,Module,Page,AppServices',verbosity='Verbose']" 

appcmd.exe set config "Contoso" -section:system.webServer/tracing/traceFailedRequests /[path='*.aspx'].failureDefinitions.statusCodes:"500"

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.GetWebConfiguration("Contoso");
         ConfigurationSection traceFailedRequestsSection = config.GetSection("system.webServer/tracing/traceFailedRequests");
         ConfigurationElementCollection traceFailedRequestsCollection = traceFailedRequestsSection.GetCollection();

         ConfigurationElement addElement = traceFailedRequestsCollection.CreateElement("add");
         addElement["path"] = @"*.aspx";

         ConfigurationElementCollection traceAreasCollection = addElement.GetCollection("traceAreas");
         ConfigurationElement addElement1 = traceAreasCollection.CreateElement("add");
         addElement1["provider"] = @"ASPNET";
         addElement1["areas"] = @"Infrastructure,Module,Page,AppServices";
         addElement1["verbosity"] = @"Verbose";
         traceAreasCollection.Add(addElement1);

         ConfigurationElement failureDefinitionsElement = addElement.GetChildElement("failureDefinitions");
         failureDefinitionsElement["statusCodes"] = @"500";
         traceFailedRequestsCollection.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.GetWebConfiguration("Contoso")
      Dim traceFailedRequestsSection As ConfigurationSection = config.GetSection("system.webServer/tracing/traceFailedRequests")
      Dim traceFailedRequestsCollection As ConfigurationElementCollection = traceFailedRequestsSection.GetCollection

      Dim addElement As ConfigurationElement = traceFailedRequestsCollection.CreateElement("add")
      addElement("path") = "*.aspx"
      Dim traceAreasCollection As ConfigurationElementCollection = addElement.GetCollection("traceAreas")
      Dim addElement1 As ConfigurationElement = traceAreasCollection.CreateElement("add")
      addElement1("provider") = "ASPNET"
      addElement1("areas") = "Infrastructure,Module,Page,AppServices"
      addElement1("verbosity") = "Verbose"
      traceAreasCollection.Add(addElement1)

      Dim failureDefinitionsElement As ConfigurationElement = addElement.GetChildElement("failureDefinitions")
      failureDefinitionsElement("statusCodes") = "500"
      traceFailedRequestsCollection.Add(addElement)

      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Contoso";
var traceFailedRequestsSection = adminManager.GetAdminSection("system.webServer/tracing/traceFailedRequests", "MACHINE/WEBROOT/APPHOST/Contoso");
var traceFailedRequestsCollection = traceFailedRequestsSection.Collection;

var addElement = traceFailedRequestsCollection.CreateNewElement("add");
addElement.Properties.Item("path").Value = "*.aspx";
var traceAreasCollection = addElement.ChildElements.Item("traceAreas").Collection;

var addElement1 = traceAreasCollection.CreateNewElement("add");
addElement1.Properties.Item("provider").Value = "ASPNET";
addElement1.Properties.Item("areas").Value = "Infrastructure,Module,Page,AppServices";
addElement1.Properties.Item("verbosity").Value = "Verbose";
traceAreasCollection.AddElement(addElement1);

var failureDefinitionsElement = addElement.ChildElements.Item("failureDefinitions");
failureDefinitionsElement.Properties.Item("statusCodes").Value = "500";
traceFailedRequestsCollection.AddElement(addElement);

adminManager.CommitChanges();

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Contoso"
Set traceFailedRequestsSection = adminManager.GetAdminSection("system.webServer/tracing/traceFailedRequests", "MACHINE/WEBROOT/APPHOST/Contoso")
Set traceFailedRequestsCollection = traceFailedRequestsSection.Collection

Set addElement = traceFailedRequestsCollection.CreateNewElement("add")
addElement.Properties.Item("path").Value = "*.aspx"
Set traceAreasCollection = addElement.ChildElements.Item("traceAreas").Collection

Set addElement1 = traceAreasCollection.CreateNewElement("add")
addElement1.Properties.Item("provider").Value = "ASPNET"
addElement1.Properties.Item("areas").Value = "Infrastructure,Module,Page,AppServices"
addElement1.Properties.Item("verbosity").Value = "Verbose"
traceAreasCollection.AddElement addElement1

Set failureDefinitionsElement = addElement.ChildElements.Item("failureDefinitions")
failureDefinitionsElement.Properties.Item("statusCodes").Value = "500"
traceFailedRequestsCollection.AddElement addElement

adminManager.CommitChanges()

Freigeben über