CMTrace

  • 项目

适用于: Configuration Manager(current branch)

CMTrace 是Configuration Manager工具之一。 它允许查看和监视日志文件，包括以下类型：

  • Configuration Manager或客户端组件管理器 (CCM) 格式的日志文件

  • 纯 ASCII 或 Unicode 文本文件，例如 Windows Installer 日志

该工具通过突出显示、筛选和查找错误来帮助分析日志文件。

注意

CMTrace 不会自动注册到 Windows 以打开 .log 文件扩展名。 有关详细信息，请参阅 文件关联。

Configuration Manager版本 2107 包括对 CMTrace 日志查看器的多项性能改进。

位置

Configuration Manager在以下位置自动安装 CMTrace：

  • 站点服务器的工具目录。 例如：cd.latest\SMSSETUP\Tools\CMTrace.exe
  • 管理点的安装目录。 例如：C:\SMS_CCM\CMTrace.exe
  • 客户端安装目录。 例如：C:\Windows\CCM\CMTrace.exe
  • OS 部署启动映像。 例如：X:\sms\bin\x64\CMTrace.exe

如果另一个位置有 CMTrace 的副本，请考虑将其删除并在其中一个默认路径中使用副本。 如果它位于满足业务需求的自定义位置，请确保有一个流程来使其保持最新状态。 如果你的自定义位置可能对其他客户有利，请提交 产品反馈。

有关详细信息，请参阅 指向社区中心项目的直接链接。

用法

运行 CMTrace.exe。 首次运行该工具时，会看到文件关联提示。 有关详细信息，请参阅 文件关联。

可以在 CMTrace 中从以下菜单执行大多数操作：

“文件”菜单

“ 文件 ”菜单中提供了以下操作：

“文件”菜单还列出了最近八个最近使用的文件。 从“文件”菜单中选择其中一个日志，快速重新打开其中一个日志。

打开

显示“打开”对话框以浏览日志文件。

在视图中筛选以下类型的文件：

  • 日志文件 (*.log)
  • 旧日志文件 (*.lo_)
  • 所有文件 (*.*)

默认情况下，不会选择以下两个选项：

  • 忽略现有行：选中后，CMTrace 将忽略所选日志文件的现有内容，并且仅在添加新行时显示它们。 当不需要日志文件的完整历史记录时，此选项仅监视新操作。

  • 合并所选文件：如果启用此选项并选择多个日志文件，CMTrace 会在视图中合并所选日志。 它会像单个日志文件一样显示它们。 合并的日志更新相同，并支持所有其他 CMTrace 功能，就像它是单个日志文件一样。

在服务器上打开

使用标准“浏览”对话框浏览站点系统计算机上的“Configuration Manager日志”文件夹。 还可以浏览远程计算机的网络。

选择要浏览的远程计算机时，CMTrace 会检查Configuration Manager共享。 如果找不到包含Configuration Manager日志文件的共享，则会显示错误消息。

若要在不浏览的情况下直接连接到已知计算机，请使用 “打开” 操作。 然后输入服务器名称并使用 UNC 格式共享。

打印

显示标准 Windows 打印对话框。 此操作会将当前日志文件发送到打印机。 它根据“CMTrace 首选项”的“打印”选项卡上的设置设置输出格式。

首选项

配置 CMTrace 的设置。 可以选择以下选项：

  • “常规”选项卡

    • 更新间隔：控制 CMTrace 检查日志文件更改并加载新行的频率。 默认情况下，此值为 500 毫秒。

    • 突出显示：设置 CMTrace 在突出显示所选日志行时使用的颜色。 默认情况下，此颜色为基本黄色 (红色：255、绿色：255、蓝色：0) 。

    • 列：配置在日志视图中可见的列及其显示顺序。 默认情况下，它显示日志文本、组件、日期/时间和线程。

  • “打印 ”选项卡

    • 列：配置打印日志文件时使用的列及其显示顺序。 默认情况下，它会打印显示的相同列。

    • 方向：设置打印日志文件时的默认打印方向。 在“打印”对话框中替代此设置。 默认情况下，它使用纵向。

  • “高级 ”选项卡

    • 刷新间隔：强制 CMTrace 在加载大量行时按指定的间隔更新日志视图。 默认情况下，此选项被禁用，值为零。

      注意

      通常，不要修改 刷新间隔。 它可以显著增加打开大型日志文件所需的时间。

“工具”菜单

“ 工具 ”菜单中提供了以下操作：

查找

在打开的日志文件中搜索指定的文本字符串。

查找下一个

查找之前在“查找”对话框中指定的下一个匹配字符串。

复制到剪贴板

将所选行作为纯文本复制到 Windows 剪贴板。 如果要检查Configuration Manager和 CCM 日志文件，它将按与视图相同的顺序复制列。 它用制表符分隔每一列。 将日志复制到电子邮件或其他文档中时，请使用此操作。

Highlight

输入 CMTrace 用于搜索每个日志条目的文本的字符串。 然后，它会突出显示与输入的字符串匹配的任何日志文本。

  • 突出显示使用在“首选项”中指定的颜色。

  • 若要关闭突出显示，请清除此字段中的字符串。

  • 如果输入十进制数或十六进制数，CMTrace 会尝试将该值与 Thread 列匹配。 使用此行为可以突出显示单个线程的处理，而不筛选出可能与之交互的其他线程。

  • 若要按大小写比较字符串，请启用 “区分大小写”选项。

筛选器

根据指定的条件显示或隐藏日志行。 将筛选器应用于四个列中的任何一个，而不管它们是否可见。 这些设置适用于每个打开的日志文件。

示例：

  • 筛选包含“操作”或“组”的输入文本 smsts.log 。
  • 筛选 InventoryAgent.log ，其中条目文本包含“destination”。

错误查找

键入或粘贴十进制或十六进制格式的错误代码以显示说明。 可能的错误源包括：Windows、WMI 或 Winhttp。

暂停

暂停或重启日志监视。 以下用例是使用此操作的一些可能原因：

  • 当 CMTrace 显示日志文件信息太快时

  • 暂停日志监视时，如果当前文件滚动到新日志，CMTrace 显示的信息不会丢失

  • 如果要在检查日志文件时阻止 CMTrace 显示新数据

显示/隐藏详细信息

显示或隐藏日志文本以外的所有列。 它还会将日志文本列扩展到窗口的宽度。 在显示分辨率较低的计算机上查看日志时，请使用此操作。 它显示更多日志文本。

注意

查看纯文本文件时，CMTrace 会自动隐藏详细信息，因为它们始终为空。

显示/隐藏信息窗格

显示或隐藏“信息”窗格。 在显示分辨率较低的计算机上查看日志时，请使用此操作。 它显示更多日志记录详细信息。

“日志”窗格

日志窗格位于 CMTrace 窗口的顶部。 它显示日志文件中的行。

选择线条时，会使用 Windows 选择配色方案暂时突出显示该行。

突出显示的行与使用“工具”菜单中的“突出显示”选项定义的条件匹配。 突出显示使用在 “首选项”中指定的颜色。

CMTrace 使用红色背景和黄色文本颜色显示错误行。 在 CCM 格式的日志中，日志条目具有一个显式类型值，该值将条目指示为错误。 对于其他日志格式，CMTrace 在每个条目中执行不区分大小写的搜索，以查找与“error”匹配的任何文本字符串。

它使用黄色背景显示带有警告的行。 在 CCM 格式的日志中，日志条目具有一个显式类型值，该值将条目指示为警告。 对于其他日志格式，CMTrace 在每个条目中对匹配“warn”的任何文本字符串执行不区分大小写的搜索。

“信息”窗格

“信息”窗格位于“CMTrace”窗口的底部。 它包括以下功能：

  • 有关当前所选日志条目的详细信息

  • 显示日志文本的文本框

  • 它显示回车符，以便格式化文本更易于阅读

  • 更易于阅读在“日志”窗格中不完全可见的长条目

使用“工具”菜单上的“显示/隐藏信息窗格”选项显示或隐藏“信息”窗格。 如果“信息”窗格占用了日志窗口的一半以上，则 CMTrace 会自动隐藏它。

进度栏

首次打开日志文件时，CMTrace 会将“信息”窗格替换为进度栏。 此进度指示加载的现有文件内容量。 进度达到 100%，CMTrace 删除进度栏，并将其替换为“信息”窗格。 加载大型文件时，此行为提供负载可能需要多长时间的指示。

状态栏

对于 Configuration Manager 格式和 CCM 格式日志文件，状态栏显示所选日志条目的运行时间。 如果选择单个条目，该工具将显示从第一个日志条目到所选条目的时间。 如果选择多个条目，它将计算从最顶部所选条目到最底部所选条目的时间。 CMTrace 按如下所示设置此信息的格式：

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

Windows shell 集成

CMTrace 支持 文件关联 和 拖放。

文件关联

CMTrace 可以将自身与 .log 和 .lo_ 文件扩展名相关联。 程序启动时，它会检查注册表，以确定它是否已与这些文件扩展名关联。 如果 CMTrace 尚未与任何文件扩展名关联，系统会提示将文件扩展名与 CMTrace 关联。 如果选择“不再询问”，则每当此计算机上运行时，CMTrace 将跳过此检查。

拖放

CMTrace 支持基本的拖放功能。 将日志文件从 Windows 资源管理器拖到 CMTrace 中以将其打开。

其他提示

Last Directory 注册表项

默认情况下，CMTrace 会保存上次打开的日志位置。 此行为在站点服务器上很有用，因为它每次都默认为日志路径。

首次在客户端上启动它时，默认为当前工作目录。 此位置可能是保存 CMTrace 的路径，也可以是类似 %userprofile%\Desktop的路径。

注册表项HKEY_CURRENT_USER\Software\Microsoft\Trace32中的“最后一个目录”值控制此默认位置。 如果在客户端上将此值设置为 %windir%\CCM\Logs ，则 CMTrace 会在首次运行时打开客户端日志位置中的文件。

后续步骤

OneTrace 是支持中心的日志查看器。 它的工作方式与 CMTrace 类似，并进行了改进。 有关详细信息，请参阅 支持中心 OneTrace。