Microsoft Configuration Manager
Troubleshooting

Cmtrace

In brief

The CMTrace article now more clearly describes highlighting, filtering, error lookup, file associations, default paths, and File and Tools menu actions. It also updates wording, capitalization, formatting, and the article date.

What Intune admins need to know

Administrators can use the revised guidance for clearer CMTrace log-viewing and troubleshooting instructions; no action is specified.

This summary was assembled from the tracked documentation change. Verify important details in the full Microsoft Learn article.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

  • payur
  • hugowu
  • qiani description: Learn about how to use the CMTrace tool to view log files for Configuration Manager. The tool lets you highlight, filter, and look up errors. ms.date: 2024-12-04T00:2026-10-22T00:00:00.0000000Z ms.subservice: core-infra ms.topic: how-to ms.collection: tier3

Applies to: Configuration Manager (current branch)

CMTrace is one of the Configuration Manager tools. It allows youYou can use it to view and monitor log files, including the following types:

  • Log files in Configuration Manager or Client Component Manager (CCM) format
  • Plain ASCII or Unicode text files, such as Windows Installer logs

The tool helps toyou analyze log files by highlighting, filtering, and error lookup.

Note

CMTrace isn't automatically registered with Windows to open the .log.log file extension. For more information, see File associations.

Configuration Manager version 2107 includes multiple performance improvements to the CMTrace log viewer.

Configuration Manager automatically installs CMTrace in the following locations:

  • The site server's tools directory. For example: cd.latest\SMSSETUP\Tools\CMTrace.exe
  • The Managementmanagement point's installation directory. For example: C:\SMS_CCM\CMTrace.exe
  • The client installation directory. For example: C:\Windows\CCM\CMTrace.exe
  • OSOperating system deployment boot images. For example: X:\sms\bin\x64\CMTrace.exe

If you have a copy of CMTrace in another location, consider removing it and using a copy in one of the default paths. If it's inyou use a custom location that meets your business requirements, then make sureensure you have a process to keep it up to date. If your custom location might be of benefit to other customers, file product feedback.

For more information, see Direct links to Community hub items.

File menu

The following actions are available in the File menu:menu provides the following actions:

  • Open
  • Open on Server
  • Print
  • Preferences

The File menu also lists the last eight recent files. Quickly reopen one of these logs by selecting it from the File menu.

Open

Displays the Open dialog box to browse for a log file.

Filter the view for files of the following types:

Open on Server

Browse the Configuration Manager logs folder on a site system computer with the standard Browse dialog box. dialog. You can also browse the network for a remote computer.

When you select a remote computer to browse, CMTrace checks for the Configuration Manager share. If it can't find a share with Configuration Manager log files, it displays an error message.

Print

Display the standard Windows Print dialog box. dialog. This action sends the current log file to a printer. It formats the output according to the settings on the Printing tab of CMTrace Preferences.

Preferences

- **Update Interval**: Controls how often CMTrace checks for changes to log files and loads new lines. By default, this value is 500 milliseconds.
- **Highlight**: Sets the color that CMTrace uses when highlighting log lines that you choose. By default, this color is basic yellow (Red: 255, Green: 255, Blue: 0).
- **Columns**: Configures the columns that are visible in the log view and the order in which they appear. By default, it displays **Log Text, Component, Text**, **Component**, **Date/Time,Time**, and Thread.**Thread**.
  • Printing tab

    • Columns: Configure which columns it uses when printing log files and the order in which they appear. By default, it prints the same columns as it displays.
    • Orientation: Sets the default print orientation when printing log files. Override this setting in the Print dialog box. dialog. By default, it uses Portrait orientation.
  • Advanced tab

    • Refresh Interval: Forces CMTrace to update the log view at a specified interval when loading a large number of lines. By default, this option is disabled with a value of zero.

Tools menu

The following actions are available in the Tools menu:menu provides the following actions:

  • Find
  • Find Next

Find Next

FindsFind the next matching string, as you previously specified in the Find dialog box. dialog.

Copy to Clipboard

CopiesCopy the selected lines as plain text to the Windows clipboard. If you're examining Configuration Manager and CCM log files, itthis action copies the columns in the same order as the view. It separates each column by a tab character. Use this action when copying logs into email messages or other documents.

Highlight

Enter a string that CMTrace uses to search the text of each log entry. It then highlights any log text that matches the string you enter.

  • The highlight uses the color you specifiedspecify in Preferences.
  • To turn off highlighting, clearingclear the string from this field.
  • If you enter a decimal or hexadecimal number, CMTrace tries to match the value to the Thread column. Use this behavior to highlight the processing of a single thread, without filtering out other threads that might interact with it.
  • To compare strings by case, enable the option for Case sensitive.

Show/Hide Details

Show or hide all columns other than the log text. It also expands the log text column to the width of the window. Use this action when you're viewing view logs on a computer with low display resolution. It displays more of the log text.

Note

When viewing plain-textplaintext files, CMTrace automatically hides details because they're always empty.

Show/Hide Info Pane

Show or hide the Info pane. Use this action when you're viewing view logs on a computer with low display resolution. It displays more logging details.

Log pane

The log pane is at the top of the CMTrace window. It displays lines from log files.

When you select a line, it's temporarily highlighted using the Windows selection color scheme.scheme temporarily highlights it.

Highlighted lines match the criteria you define withby using the Highlight option in the Tools menu. The highlight uses the color that you specify in Preferences.

CMTrace displays lines with errors by using a red background and yellow text color. In CCM-format logs, log entries haveinclude an explicit type value that indicates the entry as an error. For other log formats, CMTrace does a case-insensitive search in each entry for any text string matching "error".

It displays lines with warnings by using a yellow background. In CCM-format logs, log entries haveinclude an explicit type value that indicates the entry as a warning. For other log formats, CMTrace does a case-insensitive search in each entry for any text string matching "warn".

Info pane

The Info pane is at the bottom of the CMTrace window. It includes the following features:

  • Details about the currently selected log entry
  • A text box that displays the log text
  • It displays carriage returns so that formatted text is easier to read
  • Easier to read long entries that aren't fully visible in the Log pane

Show or hide the Info pane withby using the Show/Hide Info Pane option on the Tools menu. If the Info pane takes up more than half of the log window, CMTrace automatically hides it.

Progress bar

When you first open a log file, CMTrace replaces the Info pane bywith a progress bar. This progress bar indicates how much of the existing file contents it's loaded. TheWhen the progress reaches 100 percent, CMTrace removes the progress bar,bar and replaces it with the Info pane. When you load large files, this behavior provides you with an indication of how long the load might take.

Status bar

File associations

CMTrace can associate itself with .log and .lo_ file name extensions. When the program starts, it checks the registry to determine whether it's already associated with these file name extensions. If CMTrace isn't already associated with any file name extensions, you're prompted to associate the file name extensions with CMTrace. If you select Do not ask me this again, CMTrace skips this check whenever it's run runs on this computer.

Drag-and-drop

By default, CMTrace saves the last log location that you opened. This behavior is useful on the site server, as it defaults to the logs path every time.

The first time you launch it on a client, it defaults to the current working directory. This location maymight be the path where you saved CMTrace, or a path like %userprofile%\Desktop.

The Last Directory value in the registry key HKEY_CURRENT_USER\Software\Microsoft\Trace32 controls this default location. If you set this value to %windir%\CCM\Logs on your clients, then CMTrace opens files in the client log location the first time you run it. \ No newline at end of file

Daily Intune.Admin.News

Get daily email updates

Get a concise summary of the latest Microsoft Intune updates delivered straight to your inbox.

Loading the secure signup form…