Beispiel 4: Aktualisieren einer Ablaufverfolgungssitzung

  • Artikel

Während eine Ablaufverfolgungssitzung ausgeführt wird, können Sie die folgenden Eigenschaften einer Echtzeit- oder protokollierten Ablaufverfolgungssitzung aktualisieren:

  • Konvertieren Sie eine Echtzeitablaufverfolgungssitzung in eine Ablaufverfolgungssitzung (mithilfe von -f).

  • Erstellen Sie ein neues Ablaufverfolgungsprotokoll für eine vorhandene Ablaufverfolgungsprotokollsitzung (mithilfe von -f).

  • Fügen Sie einer vorhandenen Ablaufverfolgungsprotokollsitzung (mithilfe von -rt) echtzeitbasierte Nachrichtenübermittlung hinzu.

  • Ändern Sie die maximale Anzahl von Puffern (mithilfe von -max), aber nicht die minimale Anzahl von Puffern.

  • Ändern Sie das Intervall für die Spülzeit (mithilfe von -ft).

  • Leeren Sie die Ablaufverfolgungspuffer (mithilfe -von Tracelog -flush).

Sie können keinen Tracelog-Update-Befehl verwenden, um die Flags und die Ebene eines Ablaufverfolgungsanbieters zu ändern. Verwenden Sie stattdessen den Befehl "tracelog-enable ", wie in Beispiel 5 gezeigt: Aktivieren von Ablaufverfolgungsanbietern.

Die Parameter "-rt " und "-f " funktionieren in einem Tracelog-Update-Befehl anders. Der Parameter "-rt " fügt einer Ablaufverfolgungsprotokollsitzung echtzeitbasierte Nachrichtenübermittlung hinzu. Daher werden neue Ablaufverfolgungsmeldungen direkt an den Ablaufverfolgungsanwender und an das Ablaufverfolgungsprotokoll gesendet. Bevor Sie einer Ablaufverfolgungsprotokollsitzung jedoch die Nachrichtenübermittlung in Echtzeit hinzufügen können, müssen die Puffer mit dem Befehl "Tracelog -flush " geleert werden. Wenn der Parameter "-f " verwendet wird, um eine Echtzeitablaufverfolgungssitzung zu aktualisieren, ersetzt er die Nachrichtenübermittlung in Echtzeit durch übermittlung an das Ablaufverfolgungsprotokoll. Daher werden neue Ablaufverfolgungsmeldungen nur an das Ablaufverfolgungsprotokoll gesendet; sie werden nicht mehr direkt an den Rückverfolgungsverbraucher gesendet.

Mit dem folgenden Befehl wird eine Echtzeitablaufverfolgungssitzung namens "MyTrace" in eine Ablaufverfolgungsprotokollsitzung geändert. Der Befehl verwendet den Parameter "-f ", um den Speicherort der Protokolldatei "C:\tracing\MyTrace.etl" anzugeben. Außerdem wird der Parameter "-max " mit dem Wert 35 verwendet, um die maximale Anzahl von Puffern auf 35 zu erhöhen.

tracelog -update MyTrace -f c:\tracing\mytrace.etl -max 35

Als Reaktion zeigt Tracelog die Eigenschaften der Ablaufverfolgungssitzung an, einschließlich der Eigenschaften, die gerade geändert wurden.

Als Ergebnis dieses Befehls werden alle vom Anbieter generierten neuen Ablaufverfolgungsmeldungen und alle Ablaufverfolgungsmeldungen, die beim Senden des Befehls im Puffer gespeichert sind, nur in die Protokolldatei geschrieben. Sie werden nicht mehr direkt an den Ablaufverfolgungsanwender gesendet, wie in einer Echtzeitablaufverfolgungssitzung.

Wenn Sie einer Echtzeitablaufverfolgungssitzung ein Ablaufverfolgungsprotokoll hinzufügen möchten, damit Ablaufverfolgungsmeldungen an den Consumer der Ablaufverfolgung und an das Ablaufverfolgungsprotokoll gesendet werden, schließen Sie die Parameter "-rt " und "-f " ein, wie im folgenden Befehl gezeigt.

tracelog -update MyTrace -rt -f c:\tracing\mytrace.etl -max 35

Sie können die Ablaufverfolgungspuffer auch leeren, während eine Sitzung ausgeführt wird. Dies ist eine erzwungene Spülung, die nicht mit dem Flush-Timer koordiniert wird. Das System löscht die Puffer erneut, wenn der Leerzeitgeber abläuft und die Ablaufverfolgungssitzung beendet wird.

Verwenden Sie zum Leeren der Puffer einer vorhandenen Ablaufverfolgungssitzung den Parameter "-flush ", wie im folgenden Beispiel gezeigt. Der Parameter "-flush" ist kein Unterparameter des Befehls "tracelog -update ".

tracelog -flush MyTrace

Als Antwort zeigt Tracelog die überarbeiteten Eigenschaften der Ablaufverfolgungssitzung an.