Aktivieren der Ablaufverfolgung auf Anwendungsebene

In der Datei Web.config im Stammverzeichnis einer Anwendung können Sie die Ablaufverfolgung für die gesamte Anwendung aktivieren. In der Standardeinstellung kann die Ablaufverfolgung auf Anwendungsebene nur auf dem lokalen Webservercomputer angezeigt werden. Damit die Informationen zur Ablaufverfolgung auf Anwendungsebene für Remotecomputer sichtbar werden, müssen Sie in der Datei Web.config das localOnly-Attribut auf den Wert false festlegen.

Vorsicht   Zum Schutz Ihrer Webanwendungen sollten Sie die Funktion für die Remoteablaufverfolgung nur während der Entwicklung oder der Weitergabe einer Anwendung verwenden. Achten Sie darauf, dass die Funktion deaktiviert ist, bevor Sie die Anwendung auf Produktionswebserver übertragen. Zum Deaktivieren der Remoteablaufverfolgung legen Sie in der Datei Web.config das localOnly-Attribut auf den Wert true fest.

Im folgenden Beispiel wird die Konfiguration einer Anwendungsablaufverfolgung dargestellt, die Ablaufverfolgungsinformationen für bis zu 40 Anforderungen erfasst und es Browsern auf anderen Computern als dem ursprünglichen Server ermöglicht, den Ablaufverfolgungs-Viewer anzuzeigen.

<configuration>
 <system.web>
  <trace enabled="true" requestLimit="40" localOnly="false"/>
 </system.web>
</configuration>

Wenn Sie die Ablaufverfolgung für eine Anwendung aktivieren, erfasst ASP.NET Ablaufverfolgungsinformationen für jede Anforderung an die Anwendung (bis zur angegebenen maximalen Anzahl von Anforderungen). Die Standardanzahl für Anforderungen liegt bei 10. Wenn der Ablaufverfolgungs-Viewer das Anforderungslimit erreicht, werden keine weiteren Ablaufverfolgungsanforderungen von der Anwendung gespeichert.

Hinweis   Wenn Sie die Ablaufverfolgung für eine gesamte Anwendung in der Datei Web.config aktivieren, werden die Ablaufverfolgungsinformationen für jede Seite in dieser Anwendung erfasst und verarbeitet. Um die Ablaufverfolgung für eine bestimmte Seite in der Anwendung zu deaktivieren, legen Sie für das Trace-Attribut in der @ Page-Direktive dieser Seite false fest. Alle im Code einer Seite eingefügten TraceContext.Write-Anweisungen oder TraceContext.Warn-Anweisungen werden gespeichert und nur an den Ablaufverfolgungs-Viewer zurückgegeben.

Wenn Ablaufverfolgungsinformationen an das Ende der Seite angefügt werden sollen, der sie zugeordnet sind, legen Sie in der Datei Web.config im Abschnitt für die Ablaufverfolgungskonfiguration das pageOutput-Attribut auf den Wert true fest. Sollen die Ablaufverfolgungsinformationen lediglich im Ablaufverfolgungs-Viewer angezeigt werden, setzen Sie dieses Attribut auf false. Wenn Sie die Ablaufverfolgung auf Anwendungsebene aktivieren, für bestimmte Seiten der Anwendung jedoch keine Ablaufverfolgungsinformationen angezeigt werden sollen, setzen Sie für die entsprechenden Seiten das Trace-Attribut mit Hilfe der @ Page-Direktive auf false.

Weitere Informationen zum Konfigurieren der ASP.NET-Anwendung finden Sie unter ASP.NET-Konfiguration.

In der folgenden Tabelle sind alle Attribute aufgeführt, mit denen Sie das Verhalten der Ablaufverfolgung auf Anwendungsebene anpassen können.

Attribut	Beschreibung
enabled	true, wenn die Ablaufverfolgung für die Anwendung aktiviert ist; andernfalls false. Der Standardwert ist false.
pageOutput	true, wenn Ablaufverfolgungsinformationen sowohl auf den Seiten einer Anwendung als auch im Dienstprogramm trace.axd angezeigt werden; andernfalls false. Der Standardwert ist false. Hinweis   Seiten, für die die Ablaufverfolgung aktiviert ist, sind von dieser Einstellung nicht betroffen.
requestLimit	Die Anzahl der Ablaufverfolgungsanforderungen, die auf dem Server gespeichert werden. Der Standardwert ist 10.
traceMode	Gibt an, ob Ablaufverfolgungsinformationen in der Reihenfolge ihrer Verarbeitung (SortByTime) oder alphabetisch nach benutzerdefinierten Kategorien (SortByCategory) angezeigt werden. Der Standardwert lautet SortByTime.
localOnly	true, wenn der Ablaufverfolgungs-Viewer (Trace.axd) nur auf dem Hostwebserver verfügbar ist; andernfalls false. Der Standardwert ist true.

So aktivieren Sie die Ablaufverfolgung für eine Anwendung

1. Falls noch nicht vorhanden, erstellen Sie eine Textdatei namens Web.config und speichern sie im Stammverzeichnis der Anwendung.

2. Fügen Sie zwischen dem öffnenden und dem schließenden Tag des <configuration>-Elements das öffnenden und das schließende Tag eines <system.web>-Elements ein.

3. Fügen Sie zwischen den Tags des <system.web>-Elements ein <trace>-Element ein, das sich selbst schließt.

4. Deklarieren Sie im <trace>-Element das enabled-Attribut, und legen Sie es auf den Wert true fest.

5. Deklarieren Sie weitere optionale Attribute, um das Ablaufverfolgungsverhalten der Anwendung Ihren Wünschen entsprechend anzupassen.

   In der folgenden Konfiguration einer Anwendungsablaufverfolgung werden beispielsweise Ablaufverfolgungsinformationen für bis zu 40 Anforderungen erfasst, und der Ablaufverfolgungs-Viewer kann in Browsern auf anderen Computern als dem ursprünglichen Server angezeigt werden.

   <configuration>
    <system.web>
     <trace enabled="true" requestLimit="40" localOnly="false"/>
    </system.web>
   </configuration>
   

   Hinweis   Im ASP.NET-Konfigurationssystem wird zwischen Groß-/Kleinschreibung unterschieden. Alle aus Einzelwörtern bestehenden Konfigurationsabschnitte enthalten Kleinbuchstaben, während in Abschnitten oder Attributen, die Verkettungen von zwei Wörtern darstellen, die Kamel-Schreibweise verwendet wird. Bei requestLimit handelt es sich z. B. um einen gültigen Attributnamen, requestlimit verursacht jedoch einen Parserfehler.

Anzeigen von Ablaufverfolgungsinformationen mit dem Ablaufverfolgungs-Viewer

Immer, wenn bei aktivierter Anwendungsablaufverfolgung eine Seite in der Anwendung angefordert wird, werden alle darin enthaltenen Ablaufverfolgungsanweisungen ausgeführt. Sie können diese Anweisungen sowie die zusätzlichen Ablaufverfolgungsinformationen im Ablaufverfolgungs-Viewer anzeigen, indem Sie im Stammverzeichnis der Anwendung Trace.axd anfordern.

Hinweis   Wenn Sie die Ablaufverfolgung für eine Anwendung aktivieren, können Sie die Ablaufverfolgungsanweisungen und die zusätzlichen Informationen in jeder Seite der Anwendung anzeigen, indem Sie in der Datei Web.config für das pageOutput-Attribut den Wert true festlegen.

Der Ablaufverfolgungs-Viewer ermöglicht es Ihnen, aus den Seiten, die von der Anwendung angefordert wurden, eine bestimmte Anforderung auszuwählen. Die folgende Bildschirmdarstellung zeigt einen Ablaufverfolgungs-Viewer, dessen Anwendung seit der Aktivierung der Ablaufverfolgung sieben Anforderungen erhalten hat.

Ablaufverfolgungs-Viewer

Wenn für eine Anwendung mit aktivierter Ablaufverfolgung mehrere Anforderungen eingegangen sind, werden diese im Ablaufverfolgungs-Viewer in der Reihenfolge ihrer Verarbeitung angezeigt. Die Daten auf der ersten Seite des Ablaufverfolgungs-Viewers umfassen die Uhrzeit der Anforderung, die angeforderte Datei, den Statuscode der Anforderung, das mit der Anforderung verknüpfte HTTP-Verb und einen Link Details anzeigen, über den Sie ausführlichere Informationen zur Anforderung anzeigen können. Die Anzahl der angezeigten Anforderungen überschreitet keinesfalls die in der Datei Web.config angegebene Einstellung für requestLimit.

So zeigen Sie für eine bestimmte Anforderung Ablaufverfolgungsdetails an

1. Navigieren Sie zu dem mit der Anwendung verknüpften Ablaufverfolgungs-Viewer.

   Wenn der URL der Anwendung beispielsweise https://localhost/myapplication lautet, navigieren Sie zu https://localhost/myapplication/trace.axd, um die Ablaufverfolgungsstatistiken für die Anwendung anzuzeigen.

2. Klicken Sie für die Anforderung, die Sie näher untersuchen möchten, auf den Link Details anzeigen.

   Indem Sie auf Details anzeigen klicken, zeigen Sie dieselben Informationen an, die an die Seite mit aktivierter Ablaufverfolgung angefügt wurden.

In bestimmten Situationen möchten Sie vielleicht alle im Ablaufverfolgungs-Viewer gespeicherten Anforderungen löschen. Möglicherweise möchten Sie an Dateien in der Anwendung vorgenommene Änderungen nachverfolgen oder einfach Informationen zu Dateien anzeigen, die nicht mit den aktuell angezeigten Anforderungen verknüpft sind.

So löschen Sie Anforderungen aus dem Ablaufverfolgungs-Viewer

1. Navigieren Sie zu dem mit der Anwendung verknüpften Ablaufverfolgungs-Viewer.

2. Wählen Sie den Link Aktuelle Nachverfolgung löschen, um alle Anforderungen zu löschen, die im Ablaufverfolgungs-Viewer gespeichert sind.

   Hinweis   Der Ablaufverfolgungs-Viewer verfolgt nur die nach dem Löschen des Protokolls gesendeten Anforderungen. Anforderungen, die vor dem Löschen des Protokolls und nach Erreichen des Anforderungslimits erfolgen, können nicht angezeigt werden.

Siehe auch

TraceModeEnum-Enumeration | ASP.NET-Ablaufverfolgung| ASP.NET-Einstellungsschema | Aktivieren der Ablaufverfolgung für eine Seite