关于Configuration Manager中的日志文件

  • 项目

适用于: Configuration Manager(current branch)

在 Configuration Manager 中，客户端和站点服务器组件将进程信息记录在各个日志文件中。 可以使用这些日志文件中的信息来帮助排查可能发生的问题。 默认情况下，Configuration Manager启用客户端和服务器组件的日志记录。

本文提供有关Configuration Manager日志文件的一般信息。 它包括要使用的工具、如何配置日志以及查找它们的位置。 有关特定日志文件的详细信息，请参阅 日志文件参考。

运作方式

Configuration Manager中的大多数进程将操作信息写入专用于该进程的日志文件。 日志文件由 .log 或 .lo_ 文件扩展名标识。 Configuration Manager写入文件，.log直到该日志达到其最大大小。 当日志已满时，该文件 .log 将复制到同名但扩展名相同的 .lo_ 文件中，并且进程或组件将继续写入 .log 该文件。 .log当文件再次达到其最大大小时，将.lo_覆盖该文件并重复该过程。 某些组件通过将日期和时间戳追加到日志文件名称并保留 .log 扩展名来建立日志文件历史记录。

日志查看器工具

所有Configuration Manager日志文件都是纯文本文件，因此可以使用记事本等任何文本阅读器查看它们。 日志使用唯一格式设置，最好使用以下专用工具之一进行查看：

CMTrace

若要查看日志，请使用Configuration Manager日志查看器工具 CMTrace。 它位于\SMSSetup\ToolsConfiguration Manager源媒体的 文件夹中。 CMTrace 工具将添加到添加到软件库的所有启动映像中。 CMTrace 日志查看工具与 Configuration Manager 客户端一起自动安装。 有关详细信息，请参阅 CMTrace。

OneTrace

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

支持中心日志文件查看器

支持中心 包括新式日志查看器。 此工具将替换 CMTrace，并提供一个支持选项卡和可停靠窗口的可自定义界面。 它具有快速的表示层，可以在数秒内加载大型日志文件。 有关详细信息，请参阅 支持中心日志文件查看器。

注意

支持中心日志文件查看器和 OneTrace 使用 Windows Presentation Foundation (WPF) 。 此组件在 Windows PE 中不可用。 继续在启动映像中使用 CMTrace 和任务序列部署。

配置日志记录选项

可以更改日志文件的配置，例如详细级别、大小和历史记录。 可通过多种方式更改这些设置：

还可以使用 硬件清单从客户端收集日志设置 。

在客户端安装期间配置日志记录选项

可以在安装过程中设置客户端日志文件的配置。 使用以下属性：

  • CCMENABLELOGGING
  • CCMDEBUGLOGGING
  • CCMLOGLEVEL
  • CCMLOGMAXHISTORY
  • CCMLOGMAXSIZE

有关详细信息，请参阅 客户端安装属性。

使用 Configuration Manager Service Manager 配置日志记录选项

可以更改Configuration Manager存储日志文件的位置及其大小。

若要修改日志文件的大小、更改日志文件的名称和位置，或者要强制多个组件写入单个日志文件，请执行以下步骤：

修改组件的日志记录

  1. 在Configuration Manager控制台中，转到“监视”工作区，展开“系统状态”，然后选择“站点状态”或“组件状态”节点。

  2. 在功能区中，选择“开始”，然后选择“Configuration Manager Service Manager”。

  3. 打开Configuration Manager Service Manager时，连接到要管理的网站。 如果未显示要管理的站点，请选择“ 站点”，选择“ 连接”，然后输入正确站点的站点服务器名称。

  4. 展开站点并转到 “组件” 或 “服务器”，具体取决于要管理的组件所在的位置。

  5. 在右窗格中，选择一个或多个组件。

  6. 在 “组件 ”菜单上，选择“ 日志记录”。

  7. 在“Configuration Manager组件日志记录”对话框中，完成所选内容的可用配置选项。

  8. 选择 “确定” 以保存配置。

使用 Windows 注册表配置日志记录选项

使用服务器或客户端上的 Windows 注册表更改以下日志记录选项：

  • 详细级别
  • 最大历史记录
  • 最大大小

排查问题时，可以为Configuration Manager启用详细日志记录，以便在日志文件中写入其他详细信息。

警告

错误配置这些设置可能会导致Configuration Manager记录大量信息，或者根本不记录信息。 虽然此数据有利于故障排除，但在生产站点中更改这些值时要谨慎。 始终首先在实验室环境中测试这些更改。 可能会发生过多的日志记录，这可能会使在日志文件中查找相关信息变得困难。

对这些注册表设置进行更改后，请重启组件：

  • 如果更改客户端设置，请重启 SMS 代理主机 服务 (CcmExec) 。
  • 如果更改服务器设置，请重启 SMS 执行 服务。

注册表设置因组件而异：

客户端和管理点日志记录选项

若要为客户端或管理点站点系统上的所有组件配置日志记录选项，请在以下 Windows 注册表项下配置这些 REG_DWORD 值：

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\@Global

名称 值 说明
LogLevel 0：详细
1：默认
2：警告和错误
3：仅错误		 要写入日志文件的详细信息级别。
LogMaxHistory 任何大于或等于零的整数，例如：
0：无历史记录
1：默认		 当日志文件达到最大大小时，客户端会将其重命名为备份并创建新的日志文件。 指定要保留的早期版本数。
LogMaxSize 任何大于或等于 10，000 的整数，例如：
250000		 最大日志文件大小（以字节为单位）。 当日志增长到指定大小时，客户端将其重命名为历史记录文件，并创建一个新文件。 默认值为 250，000 字节。

注意

请勿更改此注册表项中可能存在的其他值。

对于高级调试，还可以在以下 Windows 注册表项下添加此 REG_SZ 值：

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\DebugLogging

名称 值 说明
已启用 True：启用调试日志
False：禁用调试日志		 启用调试日志记录以进行故障排除。

此设置会导致客户端记录低级别信息进行故障排除。 避免在生产站点中使用此设置。 可能会发生过多的日志记录，这可能会使在日志文件中查找相关信息变得困难。 请确保在解决问题后关闭此设置。

站点服务器日志记录选项

可以全局配置设置，也可以为Configuration Manager站点服务器上的特定组件配置设置。

在以下 Windows 注册表项下配置这些值：

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing

名称 值 类型 说明
SqlEnabled 1：启用SQL Server跟踪
0：禁用SQL Server跟踪		 REG_DWORD 向所有站点服务器日志添加SQL Server跟踪日志记录。
ArchiveEnabled 1：启用日志存档
0：禁用日志存档		 REG_DWORD 将站点服务器日志存档到单独的位置进行历史保存。
ArchivePath 有效的文件夹路径，例如 C:\Logs\Archive REG_SZ 存档站点服务器日志的路径。

仅出于故障排除目的启用SQL Server跟踪。 避免在生产站点中使用它。 可能会发生过多的日志记录，这可能会使在日志文件中查找相关信息变得困难。 请确保在解决问题后关闭此设置。

注意

请勿更改此注册表项中可能存在的其他值。

若要配置特定服务器组件的日志记录选项，请在以下 Windows 注册表项下配置这些 REG_DWORD 值：

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing\<ComponentName>

名称 值 说明
LoggingLevel 0：详细
1：默认
2：警告和错误
3：仅错误		 要写入日志文件的详细信息级别。
LogMaxHistory 任何大于或等于零的整数，例如：
0：无历史记录
1：默认		 当日志文件达到最大大小时，服务器将其重命名为备份并创建新的日志文件。 指定要保留的早期版本数。
MaxFileSize 任何大于或等于 10，000 的整数，例如：
250000		 最大日志文件大小（以字节为单位）。 当日志增长到指定大小时，客户端将其重命名为历史记录文件，并创建一个新文件。 默认值为 250，000 字节。
DebugLogging 1：启用调试日志
0：禁用调试日志		 启用调试日志记录以进行故障排除。

DebugLogging 设置会导致服务器记录低级别信息以便进行故障排除。 避免在生产站点中使用此设置。 可能会发生过多的日志记录，这可能会使在日志文件中查找相关信息变得困难。 请确保在解决问题后关闭此设置。

注意

请勿更改此注册表项中可能存在的其他值。

站点系统角色日志记录选项

可以全局配置设置，也可以为托管Configuration Manager服务器角色的站点系统上的特定组件配置设置。

若要配置特定服务器组件的日志记录选项，请在以下 Windows 注册表项下配置这些 REG_DWORD 值：

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\<ComponentName>\Logging

例如，对于分发点角色：

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\DP\Logging

名称 值 说明
LogLevel 0：详细
1：默认
2：警告和错误
3：仅错误		 要写入日志文件的详细信息级别。
LogMaxHistory 任何大于或等于零的整数，例如：
0：无历史记录
1：默认		 当日志文件达到最大大小时，服务器将其重命名为备份并创建新的日志文件。 指定要保留的早期版本数。
LogMaxSize 任何大于或等于 10，000 的整数，例如：
250000		 最大日志文件大小（以字节为单位）。 当日志增长到指定大小时，服务器会将其重命名为历史记录文件，并创建一个新文件。 默认值为 250，000 字节。

注意

请勿更改此注册表项中可能存在的其他值。

Configuration Manager控制台日志记录选项

若要更改 Configuration Manager 控制台的 AdminUI.log 的详细级别，请使用以下过程：

  1. 在 XML 编辑器（如记事本）中打开控制台配置文件 Microsoft.ConfigurationManagement.exe.config。 默认配置文件位于以下位置： C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config

  2. 在 system.diagnostics>sources>源 元素下，将 switchValue 属性从 Error 更改为 Verbose。 例如：

    原始： <source name="SmsAdminUISnapIn" switchValue="Error"> 新建： <source name="SmsAdminUISnapIn" switchValue="Verbose" >

  3. 保存文件，然后重启控制台。

在 Configuration Manager 控制台中配置日志记录选项

从控制台在客户端或集合上启用或禁用详细日志记录：

  1. 在Configuration Manager控制台中，转到“资产和符合性”工作区，选择“设备”节点，然后选择目标设备。

  2. 在功能区的“ 主页 ”选项卡上的“ 设备 ”组中，选择“ 客户端诊断”。 选择可用操作之一。

有关详细信息，请参阅 客户端诊断。

客户端日志设置的硬件清单

从版本 2107 开始，可以启用硬件清单来收集客户端日志文件设置。 启用硬件清单类 客户端诊断 (CCM_ClientDiagnostics) ，然后选择以下属性：

  • 已启用调试日志记录
  • 已启用日志记录
  • 日志级别
  • 历史记录文件计数
  • 最大日志文件大小

注意

默认情况下不启用此清单类。

有关详细信息，请参阅 启用或禁用现有硬件清单类。

查找日志文件

Configuration Manager和依赖组件将日志文件存储在不同位置。 这些位置取决于创建日志文件的过程和环境的配置。

以下位置是默认值。 如果在环境中自定义了安装目录，则实际路径可能会有所不同。

  • 客户： C:\Windows\CCM\logs
  • 服务器： C:\Program Files\Microsoft Configuration Manager\Logs
  • 管理点： C:\SMS_CCM\Logs
  • Configuration Manager控制台：C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\AdminUILog
  • Iis： C:\inetpub\logs\logfiles\w3svc1

任务序列日志位置

任务序列日志文件 smsts.log 的位置因任务序列的阶段而异：

  • 在 Windows PE 中 ，先格式化磁盘和分区磁盘 步骤： X:\Windows\temp\smstslog\smsts.log (X 是 Windows PE RAM 驱动器)
  • 在 Windows PE 中，格式化和分区磁盘步骤： X:\smstslog\smsts.log，然后在驱动器准备就绪时复制到C:\_SMSTaskSequence\Logs\smstslog\smsts.log
  • 在安装客户端之前，在新的 Windows OS 中： C:\_SMSTaskSequence\Logs\smstslog\smsts.log
  • 安装客户端后在 Windows 中： C:\Windows\CCM\Logs\smstslog\smsts.log
  • 任务序列完成后，在 Windows 中： C:\Windows\CCM\Logs\smsts.log

提示

只读任务序列变量 _SMSTSLogPath 始终包含当前日志文件的路径。

后续步骤