CMTrace

Gilt für: Configuration Manager (Current Branch)

CMTrace ist eines der Tools für den Configuration Manager. Hiermit können Sie Protokolldateien anzeigen und überwachen, einschließlich der folgenden Typen:

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

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

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

Hinweis

CMTrace wird nicht automatisch bei Windows registriert, um die .log-Dateierweiterung zu öffnen. Weitere Informationen finden Sie unter Dateizuordnungen.

Configuration Manager Version 2107 enthält mehrere Leistungsverbesserungen für die CMTrace-Protokollanzeige.

Speicherorte

Der Configuration Manager installiert CMTrace automatisch an den folgenden Speicherorten:

  • Das Toolsverzeichnis des Standortservers. Beispiel: cd.latest\SMSSETUP\Tools\CMTrace.exe
  • Das Installationsverzeichnis des Verwaltungspunkts. Beispiel: C:\SMS_CCM\CMTrace.exe
  • Das Installationsverzeichnis des Clients. Beispiel: C:\Windows\CCM\CMTrace.exe
  • Startimages für die Betriebssystembereitstellung. Beispiel: X:\sms\bin\x64\CMTrace.exe

Wenn Sie eine Kopie von CMTrace an einem anderen Speicherort haben, sollten Sie erwägen, sie zu entfernen und eine Kopie in einem der Standardpfade zu verwenden. Wenn sich die Datei an einem benutzerdefinierten Speicherort befindet, der Ihren Geschäftsanforderungen entspricht, stellen Sie sicher, dass Sie über einen Prozess verfügen, um sie auf dem neuesten Stand zu halten. Wenn Ihr benutzerdefinierter Standort für andere Kunden von Vorteil sein kann, geben Sie Produktfeedback ein.

Weitere Informationen finden Sie unter Direkte Links zu Communityhub-Elementen.

Verwendung

Ausführen 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 führen Sie aus den folgenden Menüs aus:

Menü "Datei"

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

Im Menü "Datei" werden auch die letzten acht zuletzt verwendeten Dateien aufgelistet. Öffnen Sie eines dieser Protokolle schnell erneut, indem Sie es aus dem 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 aktiviert:

  • Vorhandene Zeilen ignorieren: Wenn ausgewählt, 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 vollständigen 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 angezeigt, als wären sie eine einzige Protokolldatei. Das zusammengeführte Protokoll aktualisiert sich gleich und unterstützt alle anderen CMTrace-Features so, als wäre es eine einzige Protokolldatei.

Auf Server öffnen

Durchsuchen Sie den Ordner "Configuration Manager-Protokolle" auf einem Standortsystemcomputer mit dem Standarddialogfeld "Durchsuchen". Sie können auch das Netzwerk nach einem Remotecomputer durchsuchen.

Wenn Sie einen Remotecomputer zum Durchsuchen auswählen, sucht CMTrace nach der Freigabe des Configuration Manager. Wenn keine Freigabe mit Configuration Manager-Protokolldateien gefunden werden kann, wird eine Fehlermeldung angezeigt.

Verwenden Sie die Aktion "Öffnen ", um eine direkte Verbindung mit einem bekannten Computer herzustellen, ohne zu browsen. Geben Sie dann einen Servernamen ein, und geben Sie im UNC-Format frei.

Print

Anzeigen des Standarddialogfelds "Drucken" in Windows. Durch diese Aktion wird die aktuelle Protokolldatei an einen Drucker gesendet. Es formatiert die Ausgabe gemäß den Einstellungen auf der Registerkarte Drucken der CMTrace-Einstellungen.

Einstellungen

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

  • Registerkarte "Allgemein"

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

    • Hervorheben: Legt die Farbe fest, die CMTrace verwendet, wenn Sie von Ihnen ausgewählte Protokollzeilen hervorheben. Standardmäßig ist diese Farbe Basisgelb (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/Uhrzeit und Thread angezeigt.

  • Registerkarte "Drucken"

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

    • Ausrichtung: Legt die Standarddruckausrichtung beim Drucken von Protokolldateien fest. Setzen Sie diese Einstellung im Dialogfeld "Drucken" außer Kraft. Standardmäßig wird das Hochformat verwendet.

  • Registerkarte "Erweitert"

    • Aktualisierungsintervall: Erzwingt, dass CMTrace die Protokollansicht in einem angegebenen Intervall aktualisiert, wenn eine große Anzahl von Zeilen geladen wird. Standardmäßig ist diese Option mit dem Wert Null deaktiviert.

      Hinweis

      Ändern Sie im Allgemeinen nicht das Aktualisierungsintervall. Dies kann die Zeit zum Öffnen großer Protokolldateien erheblich verlängern.

Menü 'Extras'

Die folgenden Aktionen sind im Menü "Extras " verfügbar:

Suchen

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

Weitersuchen

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

In Zwischenablage kopieren

Kopiert die ausgewählten Zeilen als Nur-Text in die Windows-Zwischenablage. Wenn Sie den Configuration Manager und die CCM-Protokolldateien untersuchen, werden die Spalten in derselben Reihenfolge wie die Ansicht kopiert. Er trennt jede Spalte durch ein Tabstoppzeichen. Verwenden Sie diese Aktion, wenn Sie Protokolle in E-Mail-Nachrichten oder andere Dokumente kopieren.

Highlight

Geben Sie eine Zeichenfolge ein, mit der CMTrace den Text jedes Protokolleintrags durchsucht. Anschließend wird Protokolltext hervorgehoben, der mit der von Ihnen eingegebenen Zeichenfolge übereinstimmt.

  • Die Markierung verwendet die Farbe, die Sie in den Einstellungen festgelegt haben.

  • Um die Hervorhebung zu deaktivieren, löschen Sie die Zeichenfolge 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 damit interagieren könnten.

  • Um Zeichenfolgen nach Groß- und Kleinschreibung zu vergleichen, aktivieren Sie die Option Groß-/Kleinschreibung beachten.

Filter

Ein- oder Ausblenden von 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 nach Eingabetext, der "die Aktion" oder "die Gruppe" enthält.
  • Filtern Sie InventoryAgent.log, bei denen der Eingabetext das Wort "Ziel" enthält.

Fehlersuche

Geben oder fügen Sie einen Fehlercode im Dezimal- oder Hexadezimalformat 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 diese Aktion:

  • Wenn CMTrace Protokolldateiinformationen zu schnell anzeigt

  • Wenn Sie die Protokollüberwachung anhalten, gehen die von CMTrace angezeigten Informationen nicht verloren, wenn die aktuelle Datei in ein neues Protokoll überführt wird

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

Details ein-/ausblenden

Alle Spalten außer dem Protokolltext ein- oder ausblenden. Außerdem wird die Protokolltextspalte auf die Breite des Fensters erweitert. Verwenden Sie diese Aktion, wenn Sie Protokolle auf einem Computer mit niedriger Bildschirmauflösung anzeigen. Es wird mehr vom Protokolltext angezeigt.

Hinweis

Beim Anzeigen von Nur-Text-Dateien blendet CMTrace Details automatisch aus, da diese immer leer sind.

Infobereich ein-/ausblenden

Ein- oder Ausblenden des Infobereichs. Verwenden Sie diese Aktion, wenn Sie Protokolle auf einem Computer mit niedriger Bildschirmauflösung anzeigen. Es werden weitere Protokollierungsdetails angezeigt.

Protokollbereich

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

Wenn Sie eine Linie auswählen, wird sie vorübergehend mithilfe des Windows-Auswahlfarbschemas hervorgehoben.

Hervorgehobene Linien entsprechen den Kriterien, die Sie mit der Option "Hervorheben" im Menü "Extras " definiert haben. Die Markierung verwendet die Farbe, die Sie in den Einstellungen angegeben haben.

CMTrace zeigt fehlerhafte Zeilen mit rotem Hintergrund und gelber Textfarbe an. In Protokollen im CCM-Format haben Protokolleinträge einen expliziten Typwert, der den Eintrag als Fehler angibt. Bei anderen Protokollformaten sucht CMTrace in jedem Eintrag ohne Berücksichtigung der Groß-/Kleinschreibung nach einer Textzeichenfolge, die mit "error" übereinstimmt.

Es zeigt Linien mit Warnungen auf einem gelben Hintergrund an. In Protokollen im CCM-Format haben Protokolleinträge einen expliziten Typwert, der den Eintrag als Warnung angibt. Bei anderen Protokollformaten sucht CMTrace in jedem Eintrag ohne Berücksichtigung der Groß-/Kleinschreibung nach einer Textzeichenfolge, die mit "warn" übereinstimmt.

Infobereich

Der Infobereich befindet sich am unteren Rand des CMTrace-Fensters. Es beinhaltet die folgenden Features:

  • Details zum aktuell ausgewählten Protokolleintrag

  • Ein Textfeld, in dem der Protokolltext angezeigt wird

  • Wagenrücklaufzeichen werden angezeigt, sodass formatierter Text einfacher zu lesen ist

  • Einfacher zu lesende lange Einträge, die im Protokollbereich nicht vollständig sichtbar sind

Ein- oder Ausblenden des Infobereichs mit der Option "Infobereich ein-/ausblenden " im Menü "Extras ". Wenn der Infobereich mehr als die Hälfte des Protokollfensters einnimmt, blendet CMTrace ihn automatisch aus.

Statusanzeige

Wenn Sie eine Protokolldatei zum ersten Mal öffnen, ersetzt CMTrace den Infobereich durch eine Statusanzeige. Dieser Status gibt an, wie viel des vorhandenen Dateiinhalts geladen wird. Der Fortschritt erreicht 100 Prozent, CMTrace entfernt den Fortschrittsbalken und ersetzt ihn durch den Infobereich. Wenn Sie große Dateien laden, erhalten Sie aufgrund dieses Verhaltens einen Hinweis darauf, wie lange das Laden dauern könnte.

Statusleiste

Bei Protokolldateien im Configuration Manager- und CCM-Format zeigt die Status-Leiste 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 ganz unten 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 Dateizuordnungen und Drag-and-Drop.

Dateizuordnungen

CMTrace kann sich mit .log und .lo_ Dateinamenerweiterungen verknüpfen. Wenn das Programm gestartet wird, überprüft es die Registrierung, um zu ermitteln, ob es bereits mit diesen Dateinamenerweiterungen verknüpft ist. Wenn CMTrace noch keiner Dateinamenerweiterung zugeordnet ist, werden Sie aufgefordert, die Dateinamenerweiterungen CMTrace zuzuordnen. Wenn Sie "Nicht mehr fragen" auswählen, überspringt CMTrace diese Überprüfung, wenn es auf diesem Computer ausgeführt wird.

Drag & Drop

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

Weitere Tipps

Registrierungsschlüssel "Letztes Directory"

Standardmäßig speichert CMTrace den zuletzt geöffneten Protokollspeicherort. Dieses Verhalten ist auf dem Standortserver nützlich, da es jedes Mal standardmäßig auf den Protokollpfad festgelegt wird.

Wenn Sie es zum ersten Mal auf einem Client starten, wird standardmäßig das aktuelle Arbeitsverzeichnis verwendet. Dieser Speicherort kann der Pfad sein, in dem Sie CMTrace gespeichert haben, oder ein Pfad wie %userprofile%\Desktop.

Der Wert "Last Directory " im Registrierungsschlüssel HKEY_CURRENT_USER\Software\Microsoft\Trace32 steuert diesen Standardspeicherort. Wenn Sie diesen Wert %windir%\CCM\Logs auf "Auf Ihren Clients" festlegen, öffnet CMTrace Dateien am Clientprotokollspeicherort bei der ersten Ausführung.

Nächste Schritte

OneTrace ist der Protokoll-Viewer beim Support Center. Es funktioniert ähnlich wie CMTrace, mit Verbesserungen. Weitere Informationen finden Sie im Support Center OneTrace.

  • Last updated on