Die Ablaufverfolgung für die gesamte Anwendung kann in der Datei Web.config im Stammverzeichnis der Anwendung aktiviert werden. Standardmäßig können Ablaufverfolgungen auf Anwendungsebene nur auf dem lokalen Webserver-Computer angezeigt werden. Sie müssen
„localOnly“ in der Datei „Web.config“ auf „false“ setzen, damit die Ablaufverfolgungsinformationen auf Anwendungsebene vom Remotecomputer aus sichtbar sind.
Um die Remote-Ablaufverfolgung zu deaktivieren, legen Sie die Eigenschaft „localOnly“ in der Datei „Web.config“ auf „true“ fest. Das folgende Beispiel zeigt eine Anwendungs-Trace-Konfiguration, die
Trace-Informationen für bis zu 40 Anfragen sammelt und es Browsern auf anderen Computern als dem Ursprungsserver ermöglicht, den Trace-Viewer anzuzeigen.
<Konfiguration>
<system.web>
<trace aktiviert="true" requestLimit="40" localOnly="false"/>
</system.web>
</configuration>
Wenn Sie die Ablaufverfolgung für eine Anwendung aktivieren, sammelt ASP.NET Ablaufverfolgungsinformationen für jede Anforderung an die Anwendung, bis die von Ihnen angegebene maximale Anzahl von Anforderungen erreicht ist. Die Standardanzahl der Anfragen beträgt 10. Wenn der Trace-Viewer
sein Anforderungslimit erreicht, stoppt die Anwendung das Speichern von Trace-Anfragen.
Hinweis Wenn Sie die Ablaufverfolgung für eine gesamte Anwendung in der Datei Web.config aktivieren, werden Ablaufverfolgungsinformationen für jede Seite in der Anwendung gesammelt und verarbeitet. Um die Ablaufverfolgung für eine bestimmte Seite in Ihrer Anwendung zu deaktivieren,
legen Sie die Trace-Eigenschaft in der @Page-Direktive der Seite auf „false“ fest. Alle TraceContext.Write- oder TraceContext.Warn-Anweisungen, die Sie in den Seitencode einfügen, werden gespeichert
und
nur an den Trace Viewer zurückgegeben.
Wenn Sie möchten, dass Ablaufverfolgungsinformationen an das Ende der Seite angehängt werden, mit der sie verknüpft sind, legen Sie die pageOutput-Eigenschaft im Abschnitt zur Ablaufverfolgungskonfiguration der Datei Web.config auf „true“ fest. Wenn Sie möchten, dass Trace-Informationen nur im Trace-Viewer angezeigt werden
, legen Sie diese Eigenschaft auf „false“ fest. Wenn Sie die Ablaufverfolgung auf Anwendungsebene aktivieren, aber nicht möchten, dass für bestimmte Seiten Ihrer Anwendung Ablaufverfolgungsinformationen angezeigt werden, verwenden Sie die @Page-Direktive, um
die Trace-Eigenschaft für die Seiten, für die keine Ablaufverfolgungsinformationen angezeigt werden sollen, auf „false“ zu setzen.
Nachfolgend finden Sie alle Eigenschaften, die zum Ändern des Ablaufverfolgungsverhaltens auf Anwendungsebene verwendet werden können.
Objektbeschreibung
„enabled true“, wenn die Ablaufverfolgung auf Anwendungsebene aktiviert ist; andernfalls „false“. Der Standardwert ist false.
pageOutput true, wenn Ablaufverfolgungsinformationen sowohl auf der Anwendungsseite als auch im .axd-Ablaufverfolgungsdienstprogramm angezeigt werden, andernfalls false. Der Standardwert ist false.
Hinweis Seiten, auf denen Tracking aktiviert ist, sind von dieser Einstellung nicht betroffen.
requestLimit Anzahl der auf dem Server gespeicherten Tracking-Anfragen. Der Standardwert ist 10.
TraceMode gibt an, ob Trace-Informationen in der Reihenfolge angezeigt werden, in der sie verarbeitet wurden (SortByTime) oder in alphabetischer Reihenfolge nach benutzerdefinierten Kategorien (SortByCategory). Der Standardwert ist
SortByTime.
localOnly true, wenn der Trace-Viewer (Trace.axd) nur auf dem Host-Webserver verfügbar ist, andernfalls false. Der Standardwert ist wahr.
Aktivieren Sie die Ablaufverfolgung auf Anwendungsebene.
Wenn Sie dies noch nicht getan haben, erstellen Sie eine Textdatei, nennen Sie sie Web.config und speichern Sie sie im Stammverzeichnis Ihrer Anwendung.
Fügen Sie zwischen den öffnenden und schließenden Tags des Elements <configuration> die öffnenden und schließenden Tags des Elements <system.web> hinzu.
Fügen Sie zwischen den <system.web>-Element-Tags ein <trace>-Element hinzu (es ist selbstschließend).
Deklarieren Sie im Element <trace> das Attribut „enabled“ und setzen Sie es auf „true“.
Deklarieren Sie weitere optionale Eigenschaften, um das Tracking-Verhalten Ihrer Anwendung an Ihre Anforderungen anzupassen.
Beispielsweise sammelt die folgende Anwendungsablaufverfolgungskonfiguration Ablaufverfolgungsinformationen für bis zu 40 Anforderungen und ermöglicht Browsern auf anderen Computern als dem Ursprungsserver, den Ablaufverfolgungsviewer anzuzeigen.
<Konfiguration>
<system.web>
<trace aktiviert="true" requestLimit="40" localOnly="false"/>
</system.web>
</configuration>
Beachten Sie, dass beim ASP.NET-Konfigurationssystem die Groß-/Kleinschreibung beachtet wird. Alle aus einem Wort bestehenden Konfigurationsabschnitte werden in Kleinbuchstaben geschrieben, während aus zwei Wörtern zusammengesetzte Abschnitte oder Attribute in Camel-Schreibweise geschrieben werden müssen. Beispielsweise
ist „requestLimit“ ein gültiger Eigenschaftsname, „requestlimit“ führt jedoch zu einem Parserfehler.
Anzeigen von Ablaufverfolgungsinformationen mit Trace Viewer Sobald die Ablaufverfolgung auf Anwendungsebene aktiviert ist, werden bei der Anforderung jeder Seite in der Anwendung alle darin enthaltenen Ablaufverfolgungsanweisungen ausgeführt.
können im
Trace-
Viewer angezeigt werden, indem Trace.axd im Stammverzeichnis der Anwendung angefordert wird .Hinweis Wenn die Ablaufverfolgung auf Anwendungsebene aktiviert ist, können Sie Ablaufverfolgungsanweisungen und
andere
Informationen auf jeder Seite der Anwendung anzeigen, indem Sie die pageOutput-Eigenschaft in der Datei Web.config auf true setzen .
Mit dem Trace-Viewer können Sie bestimmte Anforderungen aus den von der Anwendung angeforderten Seiten auswählen. Der Screenshot unten zeigt einen Trace-Viewer, der nach der Aktivierung der Ablaufverfolgung sieben Anfragen an seine
Anwendung
hat .Trace Viewer
Wenn mehrere Anfragen für eine Tracing-fähige Anwendung eingehen, listet der Trace Viewer sie in der Reihenfolge auf, in der sie verarbeitet wurden. Zu den Informationen auf der Startseite des Trace Viewers gehören: der Zeitpunkt der Anforderung,
die angeforderte Datei, der Statuscode der Anforderung, das mit der Anforderung verknüpfte HTTP-Verb und ein Link „Details anzeigen“, über den Sie detailliertere Informationen zur Anforderung anzeigen können. Die Anzahl der angezeigten Anfragen überschreitet nicht
die requestLimit-Einstellung, die Sie in der Datei Web.config angeben.
Um Trace-Details für eine bestimmte Anfrage anzuzeigen,
navigieren Sie zum Trace-Viewer, der Ihrer Anwendung zugeordnet ist.
Wenn die URL Ihrer Anwendung beispielsweise http://localhost/myapplication lautet, navigieren Sie zu http://localhost/myapplication/trace.axd, um die
Ablaufverfolgungsstatistiken
der Anwendung anzuzeigen .Wählen Sie den Link „Details anzeigen“ für die Anfrage aus, die Sie recherchieren möchten.
Wenn Sie „Details anzeigen“ auswählen, werden dieselben Informationen an eine Seite mit aktivierter Nachverfolgung angehängt.
In manchen Fällen möchten Sie möglicherweise alle im Trace Viewer gespeicherten Anforderungen entfernen. Vielleicht möchten Sie an Dateien in Ihrer Anwendung vorgenommene Änderungen nachverfolgen oder einfach nur Informationen zu einer Datei sehen,
die nicht mit der aktuell angezeigten Anfrage verknüpft ist.
DieAnforderung „Aus Trace Viewer löschen“
zielt auf den Trace Viewer ab, der der Anwendung zugeordnet ist.
Wählen Sie den Link Aktuellen Trace löschen aus, um alle in der Trace Viewer-Anwendung gespeicherten Anforderungen zu entfernen.
Hinweis Der Trace-Viewer verfolgt nur Anfragen, die nach dem Löschen des Datensatzes gestellt werden. Anfragen, die nach Erreichen des Anfragelimits und vor dem Löschen des Datensatzes gestellt wurden, können nicht angezeigt werden.