Ablaufverfolgungen zur Diagnose

Ablaufverfolgung bedeutet das Veröffentlichen spezifischer Meldungen, die während der Anwendungsausführung generiert werden. Wenn Sie mit der Ablaufverfolgung arbeiten, müssen Sie einen Mechanismus zum Sammeln und Aufzeichnen der gesendeten Meldungen einrichten. Ablaufverfolgungsmeldungen werden von Listenern empfangen. Der Zweck eines Listeners ist das Sammeln, Speichern und Weiterleiten von Ablaufverfolgungsmeldungen. Listener leiten die Ablaufverfolgungsausgabe an ein entsprechendes Ziel, beispielsweise ein Protokoll, ein Fenster oder eine Textdatei.

Ein solcher Listener, der DefaultTraceListener, wird bei Aktivierung der Ablaufverfolgung automatisch erstellt und initialisiert. Wenn die Ausgabe der Ablaufverfolgung an zusätzliche Quellen geleitet werden soll, müssen Sie zusätzliche Ablaufverfolgungslistener erstellen und initialisieren. Erstellen Sie Listener, die auf Ihre individuellen Anforderungen abgestimmt sind. Beispiel: Sie brauchen ein Textprotokoll der gesamten Ablaufverfolgungsausgabe. In diesem Fall erstellen Sie einen Listener, der die gesamte Ausgabe in eine neue Textdatei schreibt, sobald er aktiviert wird. Oft ist die Anzeige der Ausgabe jedoch nur während der Anwendungsausführung erwünscht. In diesem Fall erstellen Sie einen Listener, der die gesamte Ausgabe an ein Konsolenfenster leitet. Der EventLogTraceListener kann die Ablaufverfolgungsausgabe an ein Ereignisprotokoll leiten, und der TextWriterTraceListener kann die Ablaufverfolgungsausgabe in einen Datenstrom schreiben.

Aktivieren der Ablaufverfolgung

Um die Ablaufverfolgung während der Transaktionsverarbeitung zu aktivieren, müssen Sie die Konfigurationsdatei der Anwendung bearbeiten. Nachfolgend finden Sie ein Beispiel:

<configuration>  
<system.diagnostics>  
     <sources>  
          <source name="System.Transactions" switchValue="Warning">  
               <listeners>  
                    <add name="tx"
                     type="System.Diagnostics.XmlWriterTraceListener"
                     initializeData= "tx.log" />  
               </listeners>  
          </source>  
     </sources>  
</system.diagnostics>  
</configuration>  

System.Transactions-Ablaufverfolgungen werden in die Quelle mit dem Namen "System.Transactions" geschrieben. Mit add können Sie den Namen und den Typ des Ablaufverfolgungslisteners angeben, den Sie verwenden möchten. In unserer Beispielkonfiguration haben wir den Listener "tx" genannt und den standardmäßigen Ablaufverfolgungslistener .NET Framework (XmlWriterTraceListener) als zu verwendenden Typ angegeben. Verwenden Sie initializeData, um den Namen der Protokolldatei für diesen Listener festzulegen. Außerdem können Sie einen einfachen Dateinamen durch einen vollqualifizierten Pfad ersetzen.

Jedem Typ von Ablaufverfolgungsmeldung wird eine Ebene zugewiesen, um seinen Wichtigkeitsgrad anzugeben. Befindet sich die Ablaufverfolgungsebene der Anwendungsdomäne auf der gleichen Ebene wie ein Ereignistyp, oder einer niedrigeren, wird diese Meldung erzeugt. Die Ablaufverfolgungsebene wird von der switchValue-Einstellung in der Konfigurationsdatei kontrolliert. Die Ebenen, die diagnostischen Ablaufverfolgungsmeldungen zugeordnet werden, sind in der folgenden Tabelle definiert.

Ablaufverfolgungsebene	Beschreibung
Kritisch	Schwerwiegende Fehler wie die nachfolgend aufgeführten sind aufgetreten: - Ein Fehler, der die Benutzerfunktionalität unmittelbar beeinträchtigen kann - Ein Ereignis, das den Eingriff eines Administrators erfordert, um die Beeinträchtigung der Funktionalität zu vermeiden - Codefehler - Diese Ablaufverfolgungsebene kann zudem genügenden Kontext zum Interpretieren anderer wichtiger Ablaufverfolgungen bereitstellen. Dies kann helfen, die Sequenz von Vorgängen zu identifizieren, die zu einem schwerwiegenden Fehler führt.
Fehler	Ein Fehler (beispielsweise ungültiges Konfigurations- oder Netzwerkverhalten) ist aufgetreten, der zu einer Beeinträchtigung der Benutzerfunktionalität führen kann.
Warnung	Es besteht eine Bedingung, die zu einem Fehler oder einem schwerwiegenden Ausfall führen kann (z. B. Speicherbelegung oder Annäherung an einen Grenzwert). Die normale Verarbeitung von Benutzercodefehlern (z. B. Transaktionsabbruch, Timeouts oder Authentifizierungsfehler) kann ebenfalls eine Warnung auslösen.
Information	Meldungen, die bei der Überwachung und Diagnose des Systemstatus, der Leistungsmessung oder Profilerstellung nützlich sind. Dazu gehören Transaktions- und Eintragungslebensdauer-Ereignisse wie beispielsweise eine Transaktion, die erstellt oder für die ein Commit ausgeführt wird, das Überschreiten einer wichtigen Begrenzung oder die Speicherbelegung bedeutender Ressourcen. Ein Entwickler kann dann solche Informationen zur Kapazitätsplanung und Leistungsverwaltung nutzen.

Ablaufverfolgungscodes

In der folgenden Tabelle sind die Ablaufverfolgungscodes aufgeführt, die von der System.Transactions-Infrastruktur generiert werden. Außerdem werden der Codebezeichner und dieEventType -Enumerationsebene für die Ablaufverfolgung sowie zusätzliche Daten aus dem TraceRecord für die Ablaufverfolgung in der Tabelle angegeben. Zudem wird auch die entsprechende Ablaufverfolgungsebene der Ablaufverfolgung im TraceRecord gespeichert.

TraceCode	EventType	Zusätzliche Daten in TraceRecord
TransactionCreated	Info	TransactionTraceId
TransactionPromoted	Info	Local TransactionTraceId, Distributed TransactionTraceId
EnlistmentCreated	Info	TransactionTraceId, EnlistmentTraceId, EnlistmentType (durable/volatile), EnlistmentOptions
EnlistmentCallbackNegative	Warnung	TransactionTraceId, EnlistmentTraceId Callback (forcerollback/aborted/indoubt)
TransactionRollbackCalled	Warnung	TransactionTraceId
TransactionAborted	Warnung	TransactionTraceId
TransactionInDoubt	Warnung	TransactionTraceId
TransactionScopeCreated	Info	TransactionScopeResult, das folgendes sein kann: - Neue Transaktion - Transaktion ausgeführt - Abhängige Transaktion ausgeführt - Mit aktueller Transaktion - Keine Transaktion Neue aktuelle TransactionTraceId
TransactionScopeDisposed	Info	TransactionTraceId der vom Bereich "erwarteten" aktuellen Transaktion
TransactionScopeIncomplete	Warnung	TransactionTraceId der vom Bereich "erwarteten" aktuellen Transaktion
TransactionScopeNestedIncorrectly	Warnung	TransactionTraceId der vom Bereich "erwarteten" aktuellen Transaktion
TransactionScopeCurrentTransactionChanged	Warnung	Alte aktuelle TransactionTraceId, sonstige TransactionTraceId
TransactionScopeTimeout	Warnung	TransactionTraceId der vom Bereich "erwarteten" aktuellen Transaktion
DependentCloneCreated	Info	TransactionTraceId, Typ der erzeugten abhängigen Transaktion (RollbackIfNotComplete/BlockCommitUntilComplete)
DependentCloneComplete	Info	TransactionTraceId
RecoveryComplete	Info	Ressourcen-Manager-GUID (von Basis)
Reenlist	Info	Ressourcen-Manager-GUID (von Basis)
TransactionSerialized	Info	TransactionTraceId
TransactionException	Fehler	Ausnahmemeldung
InvalidOperationException	Fehler	Ausnahmemeldung
InternalError	Kritisch	Ausnahmemeldung
TransferEvent		Wenn eine Transaktion deserialisiert oder von einer System.Transactions-Transaktion zu einer verteilten Transaktion erweitert wird, werden die aktuelle ActivityID aus ExecutionContext und die ID der verteilten Transaktion geschrieben. Wenn DTC verwalteten Code zurückruft, wird die ID der verteilten Transaktion für die Dauer des Rückrufs als ActivityID in ExecutionContext festgelegt.
ConfiguredDefaultTimeoutAdjusted	Warnung	Keine zusätzlichen Daten
TransactionTimeout	Warnung	Die TransactionTraceId der Transaktion hat das Zeitlimit überschritten.

Das XML-Schema für jedes der vorangehenden zusätzlichen Datenelemente hat das folgende Format.

TransactionTraceIdentifier

<TransactionTraceIdentifier>

<TransactionIdentifier >

string representation of transaction id

</TransactionIdentifier>

< CloneIdentifier >

the clone id number

</CloneIdentifier>

</TransactionTraceIdentifier>

EnlistmentTraceIdentifier

<EnlistmentTraceIdentifier>

<ResourceManagerId>

string form of guid

</ResourceManagerId>

<TransactionTraceIdentifier>

<TransactionIdentifier >

string representation of transaction id

</TransactionIdentifier>

<CloneIdentifier >

the clone id number

</CloneIdentifier>

<TransactionTraceIdentifier>

<EnlistmentIdentifier>

the enlistment id number

</EnlistmentIdentifier>

</EnlistmentTraceIdentifier>

Ressourcen-Manager-Bezeichner

<ResourceManagerId>

string form of guid

</ResourceManagerId>

Sicherheitsprobleme bei der Ablaufverfolgung

Wenn Sie als Administrator die Ablaufverfolgung aktivieren, könnten vertrauliche Informationen in ein Ablaufverfolgungsprotokoll geschrieben werden, auf das standardmäßig öffentlich zugegriffen werden kann. Um mögliche Sicherheitsrisiken zu mindern, sollten Sie das Ablaufverfolgungsprotokoll an einem sicheren Ort speichern, der durch Zugriffsberechtigungen für Freigaben und Dateisysteme kontrolliert wird.