CMTrace

• 27/26/2019
• 8 Minuten zu lesen
• • m
  • d

Gilt für: Configuration Manager (aktueller Zweig)

CMTrace ist eines der Tools von Configuration Manager. Es ermöglicht das Anzeigen und Überwachen von Protokolldateien, einschließlich der folgenden Typen:

• Protokolldateien im Configuration Manager- oder Client Component Manager (CCM)-Format

• Plain ASCII- oder Unicode-Textdateien, wie z. B. Windows Installer-Protokolle

Das Tool hilft bei der Analyse von Protokolldateien durch Hervorhebung, Filterung und Fehlersuche.

Ab Version 1806 wird das CMTrace-Protokollanzeigetool automatisch zusammen mit dem Configuration Manager-Client installiert. Es wird dem Client-Installationsverzeichnis hinzugefügt, das standardmäßig %WinDir%\CCM\CMTrace.exe ist.

Ab Version 1906 ist OneTrace ein neuer Protokollbetrachter mit Support Center. Es funktioniert ähnlich wie CMTrace, mit einigen Verbesserungen. Weitere Informationen finden Sie unter Support Center OneTrace.

Benutzung

Starten Sie CMTrace.exe. Wenn Sie das Tool zum ersten Mal ausführen, wird eine Aufforderung zur Dateizuordnung angezeigt. Weitere Informationen finden Sie unter Dateizuordnungen.

Die meisten Aktionen in CMTrace können Sie über die folgenden Menüs ausführen:

• Datei
• Werkzeuge

Dateimenü

Die folgenden Aktionen sind im Menü Datei verfügbar:

• Öffnen
• Auf Server öffnen
• Drucken
• Einstellungen

Im Menü „Datei“ werden auch die letzten acht Dateien aufgelistet. Öffnen Sie eines dieser Protokolle schnell erneut, indem Sie es im Menü „Datei“ auswählen.

Öffnen

Zeigt das Dialogfeld „Öffnen“ an, um nach einer Protokolldatei zu suchen.

Filtern Sie die Ansicht nach Dateien der folgenden Typen:

• Protokolldateien (*.log)
• Alte Protokolldateien (*.lo_)
• Alle Dateien (*.*)

Die folgenden beiden Optionen sind standardmäßig nicht ausgewählt:

• Vorhandene Zeilen ignorieren: Wenn diese Option ausgewählt ist, ignoriert CMTrace den vorhandenen Inhalt der ausgewählten Protokolldatei und zeigt neue Zeilen nur an, wenn sie hinzugefügt werden. Verwenden Sie diese Option, um nur neue Aktionen zu überwachen, wenn Sie nicht den gesamten Verlauf der Protokolldatei benötigen.

• Ausgewählte Dateien zusammenführen: Wenn Sie diese Option aktivieren und mehr als eine Protokolldatei auswählen, führt CMTrace die ausgewählten Protokolle in der Ansicht zusammen. Sie werden so angezeigt, als ob sie eine einzige Protokolldatei wären. Das zusammengeführte Protokoll wird genauso aktualisiert und unterstützt alle anderen CMTrace-Funktionen wie eine einzelne Protokolldatei.

Auf Server öffnen

Durchsuchen Sie den Configuration Manager-Protokollordner auf einem Computer des Standortsystems mit dem Standard-Dialogfeld Durchsuchen. Sie können auch das Netzwerk nach einem Remote-Computer durchsuchen.

Wenn Sie einen Remote-Computer zum Durchsuchen auswählen, sucht CMTrace nach der Configuration Manager-Freigabe. Wenn es keine Freigabe mit Configuration Manager-Protokolldateien finden kann, wird eine Fehlermeldung angezeigt.

Um eine direkte Verbindung zu einem bekannten Computer herzustellen, ohne ihn zu durchsuchen, verwenden Sie die Aktion Öffnen. Geben Sie dann einen Servernamen und eine Freigabe im UNC-Format ein.

Drucken

Das Standarddialogfeld von Windows zum Drucken anzeigen. Diese Aktion sendet die aktuelle Protokolldatei an einen Drucker. Sie formatiert die Ausgabe entsprechend den Einstellungen auf der Registerkarte Drucken der CMTrace-Voreinstellungen.

Voreinstellungen

Konfigurieren Sie die Einstellungen für CMTrace. Die folgenden Optionen sind verfügbar:

• Registerkarte Allgemein

  • Aktualisierungsintervall: Steuert, wie oft CMTrace nach Änderungen in den Protokolldateien sucht und neue Zeilen lädt. Standardmäßig beträgt dieser Wert 500 Millisekunden.

  • Hervorhebung: Legt die Farbe fest, die CMTrace zum Hervorheben der von Ihnen gewählten Protokollzeilen verwendet. Standardmäßig ist diese Farbe gelb (Rot: 255, Grün: 255, Blau: 0).

  • Spalten: Konfiguriert die Spalten, die in der Protokollansicht sichtbar sind, und die Reihenfolge, in der sie angezeigt werden. Standardmäßig werden Protokolltext, Komponente, Datum/Zeit und Thread angezeigt.

• Registerkarte Drucken

  • Spalten: Legen Sie fest, welche Spalten beim Drucken von Protokolldateien verwendet werden und in welcher Reihenfolge sie erscheinen. Standardmäßig werden die gleichen Spalten gedruckt, die auch angezeigt werden.

  • Orientierung: Legt die Standarddruckausrichtung beim Drucken von Protokolldateien fest. Diese Einstellung kann im Dialogfeld „Drucken“ überschrieben werden. Standardmäßig wird die Ausrichtung Hochformat verwendet.

• Registerkarte Erweitert

  • Aktualisierungsintervall: Zwingt CMTrace, die Protokollansicht in einem bestimmten Intervall zu aktualisieren, wenn eine große Anzahl von Zeilen geladen wird. Standardmäßig ist diese Option mit einem Wert von Null deaktiviert.

    Hinweis

    Im Allgemeinen sollten Sie das Aktualisierungsintervall nicht ändern. Es kann die Zeit, die zum Öffnen großer Protokolldateien benötigt wird, erheblich verlängern.

Menü „Tools“

Im Menü „Tools“ sind die folgenden Aktionen verfügbar:

• Suchen
• Nächste Suche
• Kopieren in die Zwischenablage
• Hervorheben
• Filter
• Fehlersuche
• Pause
• Details ein-/ausblenden
• Infobereich ein-/ausblenden

Suchen

Suchen Sie die geöffnete Protokolldatei nach einer angegebenen Textzeichenfolge.

Findet die nächste übereinstimmende Zeichenfolge, die Sie zuvor im Dialogfeld Suchen angegeben haben.

Kopieren in die Zwischenablage

Kopiert die ausgewählten Zeilen als reinen Text in die Windows-Zwischenablage. Wenn Sie Configuration Manager- und CCM-Protokolldateien untersuchen, werden die Spalten in der gleichen Reihenfolge wie in der Ansicht kopiert. Jede Spalte wird durch ein Tabulatorzeichen getrennt. Verwenden Sie diese Aktion, wenn Sie Protokolle in E-Mail-Nachrichten oder andere Dokumente kopieren.

Highlight

Geben Sie eine Zeichenfolge ein, die CMTrace verwendet, um den Text jedes Protokolleintrags zu durchsuchen. Es hebt dann jeden Protokolltext hervor, der mit der von Ihnen eingegebenen Zeichenkette übereinstimmt.

• Die Hervorhebung verwendet die Farbe, die Sie in den Einstellungen angegeben haben.

• Um die Hervorhebung zu deaktivieren, löschen Sie die Zeichenkette aus diesem Feld.

• Wenn Sie eine Dezimal- oder Hexadezimalzahl eingeben, versucht CMTrace, den Wert mit der Spalte Thread abzugleichen. Verwenden Sie dieses Verhalten, um die Verarbeitung eines einzelnen Threads hervorzuheben, ohne andere Threads herauszufiltern, die mit ihm interagieren könnten.

• Um Zeichenketten nach Groß- und Kleinschreibung zu vergleichen, aktivieren Sie die Option für Groß- und Kleinschreibung.

Filter

Zeigen oder verbergen Sie Protokollzeilen basierend auf den angegebenen Kriterien. Wenden Sie Filter auf jede der vier Spalten an, unabhängig davon, ob sie sichtbar sind. Diese Einstellungen gelten für jede geöffnete Protokolldatei.

Beispiele:

• Filtern Sie smsts.log auf Eintragstext, der „die Aktion“ oder „die Gruppe“ enthält.
• Filtern Sie InventoryAgent.log, wenn der Eintragstext „Ziel“ enthält.

Fehlersuche

Geben Sie einen Fehlercode im dezimalen oder hexadezimalen Format ein, um eine Beschreibung anzuzeigen. Mögliche Fehlerquellen sind: Windows, WMI oder Winhttp.

Pause

Setzen Sie die Protokollüberwachung aus oder starten Sie sie neu. Die folgenden Anwendungsfälle sind einige der möglichen Gründe für die Verwendung dieser Aktion:

• Wenn CMTrace die Protokolldateiinformationen zu schnell anzeigt

• Wenn Sie die Protokollüberwachung unterbrechen, Wenn Sie die Protokollüberwachung unterbrechen, gehen die von CMTrace angezeigten Informationen nicht verloren, wenn die aktuelle Datei in ein neues Protokoll übergeht

• Wenn Sie verhindern möchten, dass CMTrace neue Daten anzeigt, während Sie die Protokolldatei untersuchen

Details anzeigen/ausblenden

Alle Spalten außer dem Protokolltext anzeigen oder ausblenden. Außerdem wird die Spalte mit dem Protokolltext auf die Breite des Fensters vergrößert. Verwenden Sie diese Aktion, wenn Sie Protokolle auf einem Computer mit geringer Bildschirmauflösung anzeigen. Sie zeigt mehr vom Protokolltext an.

Infobereich ein-/ausblenden

Den Infobereich ein- oder ausblenden. Verwenden Sie diese Aktion, wenn Sie Protokolle auf einem Computer mit niedriger Bildschirmauflösung anzeigen. Es zeigt mehr Details zur Protokollierung an.

Protokollbereich

Der Protokollbereich befindet sich oben im CMTrace-Fenster. Es zeigt Zeilen aus Protokolldateien an.

Wenn Sie eine Zeile auswählen, wird sie vorübergehend mit dem Windows-Auswahlfarbschema hervorgehoben.

Hervorgehobene Zeilen entsprechen den Kriterien, die Sie mit der Option Hervorheben im Menü Extras definieren.

CMTrace zeigt Zeilen mit Fehlern mit einem roten Hintergrund und gelber Textfarbe an. In Protokollen im CCM-Format haben die Protokolleinträge einen expliziten Typwert, der den Eintrag als Fehler kennzeichnet. Bei anderen Protokollformaten sucht CMTrace in jedem Eintrag unabhängig von der Groß- und Kleinschreibung nach jeder Textzeichenfolge, die mit „Fehler“ übereinstimmt.

Zeilen mit Warnungen werden mit gelbem Hintergrund angezeigt. In Protokollen im CCM-Format haben die Protokolleinträge einen expliziten Typwert, der den Eintrag als Warnung kennzeichnet. Bei anderen Protokollformaten sucht CMTrace in jedem Eintrag unabhängig von der Groß- und Kleinschreibung nach jeder Textzeichenfolge, die mit „warn“ übereinstimmt.

Infobereich

Der Infobereich befindet sich am unteren Rand des CMTrace-Fensters. Er enthält die folgenden Funktionen:

• Details über den aktuell ausgewählten Protokolleintrag

• Ein Textfeld, das den Protokolltext anzeigt

• Es zeigt Zeilenumbrüche an, damit formatierter Text leichter zu lesen ist

• Lange Einträge, die im Log-Fenster nicht vollständig sichtbar sind, sind leichter zu lesen

Mit der Option Info-Fenster ein-/ausblenden im Menü Extras können Sie das Info-Fenster ein- oder ausblenden. Wenn der Infobereich mehr als die Hälfte des Protokollfensters einnimmt, blendet CMTrace ihn automatisch aus.

Fortschrittsanzeige

Wenn Sie eine Protokolldatei zum ersten Mal öffnen, ersetzt CMTrace den Infobereich durch eine Fortschrittsanzeige. Dieser Fortschrittsbalken zeigt an, wie viel des vorhandenen Dateiinhalts er geladen hat. Wenn der Fortschritt 100 Prozent erreicht, entfernt CMTrace den Fortschrittsbalken und ersetzt ihn durch das Info-Fenster. Wenn Sie große Dateien laden, gibt Ihnen dieses Verhalten einen Hinweis darauf, wie lange das Laden dauern könnte.

Statusleiste

Für Protokolldateien im Configuration Manager- und CCM-Format zeigt die Statusleiste die verstrichene Zeit für die ausgewählten Protokolleinträge an. Wenn Sie einen einzelnen Eintrag auswählen, zeigt das Tool die Zeit vom ersten Protokolleintrag bis zum ausgewählten Eintrag an. Wenn Sie mehrere Einträge auswählen, wird die Zeit vom obersten ausgewählten Eintrag bis zum untersten ausgewählten Eintrag berechnet. CMTrace formatiert diese Informationen wie folgt:

Elapsed time is <hours>h <minutes>m <seconds>s <milliseconds>ms (<seconds+milliseconds> seconds)

Windows-Shell-Integration

CMTrace unterstützt Dateiverknüpfungen und Drag-and-Drop.

Dateiverknüpfungen

CMTrace kann sich mit den Dateinamenerweiterungen .log und .lo_ verknüpfen. Wenn das Programm startet, überprüft es die Registrierung, um festzustellen, ob es bereits mit diesen Dateinamenerweiterungen verknüpft ist. Wenn CMTrace noch nicht mit Dateinamenerweiterungen verknüpft ist, werden Sie aufgefordert, die Dateinamenerweiterungen mit CMTrace zu verknüpfen. Wenn Sie die Option Nicht mehr nachfragen wählen, überspringt CMTrace diese Prüfung, wenn es auf diesem Computer ausgeführt wird.

Drag-and-drop

CMTrace unterstützt grundlegende Drag-and-drop-Funktionen. Ziehen Sie eine Protokolldatei aus dem Windows Explorer in CMTrace, um sie zu öffnen.

Sonstige Tipps

Registrierungsschlüssel „Letztes Verzeichnis“

Standardmäßig speichert CMTrace den zuletzt von Ihnen geöffneten Protokollort. Dieses Verhalten ist auf dem Site-Server nützlich, da es jedes Mal den Protokollpfad verwendet.

Beim ersten Start auf einem Client wird standardmäßig das aktuelle Arbeitsverzeichnis verwendet. Dieses Verzeichnis kann der Pfad sein, in dem Sie CMTrace gespeichert haben, oder ein Pfad wie %userprofile%\Desktop.

Der Wert „Letztes Verzeichnis“ im Registrierungsschlüssel HKEY_CURRENT_USER\Software\Microsoft\Trace32 steuert dieses Standardverzeichnis. Wenn Sie diesen Wert auf Ihren Clients auf %windir%\CCM\Logs setzen, öffnet CMTrace bei der ersten Ausführung Dateien am Speicherort des Client-Protokolls.

Siehe auch

• Protokolldateien

• Support Center Log File Viewer

• Support Center OneTrace