通过

如何为 Windows Mobile 和 Windows CE 设备配置日志记录

  • 项目

应用到: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

Microsoft System Center Configuration Manager 2007 的移动设备日志记录使管理员可以评估和解决移动设备及服务器上的移动设备管理活动。Configuration Manager 2007 中用于移动设备的日志记录功能已显著增强。现在，Configuration Manager 2007 可以使用 SMSTrace.exe 读取设备客户端日志，还可以使用日志记录框架配置移动设备上日志记录的详细级别。用户可以通过移动设备上的注册表设置配置移动设备客户端日志记录框架。提供三个范围级别，用户可以在其中配置设置：

  • 组件

  • 全局

  • 默认值

设置范围

每个可以记录的过程指定组件名称。如果在组件范围内指定日志记录设置，则只有在组件范围存在时才使用该范围。如果组件范围中不存在日志记录设置，则使用在全局范围中声明的日志记录设置。如果全局范围中没有日志记录设置，则使用在日志记录框架中定义的默认设置。

全局范围中的日志记录设置存储在以下注册表项中： HKLM\Comm\ApplicationDownload\Logging.

组件范围中的日志记录设置存储在全局注册表项的子项中。组件名称就是子项的名称，如以下示例所示：HKLM\Comm\ApplicationDownload\Logging\<组件名称>。例如，如果过程将“Component1”作为组件名称，则可以通过以下注册表项中的设置控制该组件的过程： HKLM\Comm\ApplicationDownload\Logging\Component1.

最小值和最大值

某些日志记录设置拥有在框架中定义的最小值和最大值。这确保用户无法在注册表中设置会对移动设备造成不利影响的值，或者设置的值过低，从而收集无意义的信息。

如果注册表设置值小于允许的最小值，则使用最小值。如果注册表设置值大于允许的最大值，则使用最大值。

设置

下表列出了可用日志记录设置。全局和组件注册表项中都存在这些设置。设置名称是注册表项中的注册表值名称。

设置名称 类型 最小值 最大值 默认值 描述

LogDirectory

REG_SZ

N/A

N/A

"\Temp\DMClientLogs" 在 Windows Mobile Smartphone 2003 上，该值重定向至 \Storage\temp\DMClientLogs

创建日志文件的目录。

MaxLogSizeBytes

DWORD

1024 (1K)

1048576 (1M)

32K

日志文件大小的最大值（单位为字节），适用于文件滚动更新前的组件。

MaxLogCount

DWORD

2

24

5

组件日志文件的最大数量。如果文件数量超出此限制，则最旧的文件将被删除。

LogLevel

DWORD

0 (VERBOSE)

3 (ERROR)

3 (ERROR)

指定将要写入日志的日志语句的最低类型。如果某个日志语句低于此设置，则忽略此日志语句。如果指定的设置高于“3 (ERROR)”，则所有语句都无法写入日志文件。（这实质上是禁用了日志记录。）

日志记录框架无法迅速检测到设置更改，而是在启动客户端服务时读取设置。如果要应用已更新的设置，必须在更改后重新启动设备管理服务。可以在设备管理控制面板中完成此操作。

面向移动设备客户端安装的日志文件

在移动设备上进行移动设备客户端安装的同时，移动设备上生成日志文件。日志文件可以用于确认安装已完成。成功安装客户端后，可以在移动设备上找到以下日志文件：

  • DMInstaller[日期:时间].log

  • DMClientSetup[日期:时间].log

  • DMSvc[日期:时间].log

命名

日志记录框架为每个组件管理一组日志文件。调用日志记录进程时，该进程创建新的日志文件，或者为组件打开现有日志文件。系统将写入日志文件，直到根据如下所述对日志文件进行滚动更新。所有日志文件名均采用以下格式：

<组件名>-<日期戳>-<时间戳>.log

  • <组件名> 是传递到 InitLogger 函数的组件的名称。

  • <日期戳> 是创建日志文件的日期，格式为 YYYYMMHH。

  • <时间戳> 是创建日志文件的 UTC 时间，格式为 hhmmss。

例如，如果组件名为“Component1”，并且于 2006 年 6 月 13 日下午 1:05 (UTC) 创建日志文件，则日志文件名为 Component1-20060613-130500.log。

滚动更新

如果某个日志文件超出 MaxLogSizeBytes 设置，则系统对其进行“滚动更新”，这表示关闭该日志文件，并创建新的文件。当组件的日志文件总数（当前打开的及已进行滚动更新的日志文件）超出 MaxLogCount 设置时，最旧的文件将被删除。

格式

日志记录框架采用 SMS Trace (smstrace.exe) 日志查看器可读取的格式写入日志条目。每个条目包括以下项目：

  • 日志文本 日志记录宏（VERBOSE、INFO、WARN、ERROR）发出的日志文本

  • 时间戳（当地时间）

  • 日期戳（当地时间）

  • 日志类型 - 0 代表详细，1 代表信息，2 代表警告，3 代表错误

  • 线程

  • 源文件

启用日志记录级别

使用以下指导确定应当使用哪个日志记录级别：

  • 详细：仅将详细日志语句用于可以帮助支持人员和 Microsoft 支持服务解决移动设备问题的语句。详细日志记录提供详细信息。详细日志记录中所记录数据的示例包括：跟踪进入/退出函数，传递到函数的参数等。如果 LogLevel 为 0，则详细日志语句将写入日志文件。

备注

要谨慎使用详细日志记录。如果使用错误设置，日志文件会使移动设备过载。

  • 信息：将信息日志语句用于通知最终用户或支持人员与移动设备功能相关的非错误事件的语句。示例包括开始和结束功能行为 - 例如，“正在下载包”或“已成功下载包”。如果 LogLevel 设置为 1 或更低，则信息日志语句将写入日志文件。

  • 警告：使用警告日志语句通知用户处理的错误条件，这些错误条件不表示移动设备功能失败，但有助于进一步调查。如果 LogLevel 设置为 2 或更低，则警告日志语句将写入日志文件。

  • 错误：使用错误日志语句通知用户表明产品功能失败的错误条件 - 例如，“包下载失败”或“包哈希验证失败”。错误日志语句始终写入日志文件。

在使用 DMCommonInstaller.ini 或 ClientSettings.ini 文件进行安装或升级期间，通过设置值 EnableVerboseLogging=True 来启用详细日志记录。这将在使用此 DMCommonInstaller.ini 或 ClientSettings.ini 文件安装或更新的任何客户端上启动详细记录设置。通过使用注册表配置项目部署上述表格中的所需注册表项和值，可以在由 Microsoft System Center Configuration Manager 2007 管理的特定移动设备上启用详细日志记录或任何记录级别。使用通过配置包分发的配置项目注册表设置，也可以修改日志记录设置。在重新启动移动设备客户端后，对日志记录设置进行的更改随即生效。可以通过执行移动设备的软重置来进行重启。

备注

除了根据 Microsoft 支持人员指示外，不建议使用详细日志记录级别。详细日志记录提供的数据对企业支持人员的帮助不大。

日志记录配置文档示例

由于日志记录设置存储在注册表中，因此可以使用注册表配置服务提供程序 (CSP) 查询或设置移动设备上的日志记录设置。

查询日志记录设置

以下 CSP 示例说明如何查询设备上的全局日志记录设置：

<wap-provisioningdoc>
   <characteristic type="Registry">
      <characteristic type="HKLM\Comm\ApplicationDownload\Logging">
         <parm-query name="LogDirectory"/>
         <parm-query name="MaxLogSizeBytes"/>
         <parm-query name="MaxLogCount"/>
         <parm-query name="LogLevel"/>
      </characteristic>
   </characteristic>
</wap-provisioningdoc>

设置日志记录设置

以下 CSP 示例说明如何设置设备上的全局日志记录设置：

<wap-provisioningdoc>
   <characteristic type="Registry">
      <characteristic type="HKLM\Comm\ApplicationDownload\Logging">
         <parm name="LogDirectory" value="\Temp\Logs" datatype="string"/>
         <parm name="MaxLogSizeBytes" value="7000" datatype="integer"/>
         <parm name="MaxLogCount" value="7" datatype="integer"/>
         <parm name="LogLevel" value="0" datatype="integer"/>
      </characteristic>
   </characteristic>
</wap-provisioningdoc>

日志文件位置

移动设备客户端日志文件位于以下位置：

  • Mobile Device Center 或 ActiveSync Configuration Manager 2007 计算机客户端

  • Windows CE 和 Windows Mobile Pocket PC 设备

  • Windows Mobile 5 Smartphone 和 Windows Mobile 6 Standard 设备

  • Windows Mobile 2003 Smartphone 设备

    位置 路径 日志文件

    在受 ActiveSync 或 Mobile Device Center Configuration Manager 2007 管理的台式机上

    用户临时文件夹中的 %temp%\SmsDm

    DmClientXfer.log

    DmCommonInstaller.log

    DmInvExtension.log

    在所有 Windows CE、Windows Mobile Pocket PC 和 Windows Mobile 6 Professional 设备上

    \temp\DmClientLogs

    DmCertEnroll...log

    DmClientSetup…log

    DmInstaller…log

    DmSvc…log

    DMCertResp.htm（\temp 中）

    在 Windows Mobile Smartphone 5 和 Windows Mobile 6 Standard 设备上

    移动设备存储文件夹中的 \Temp\DmClientLogs 或移动设备文件系统中的 \temp\DMClientLogs

    DmCertEnroll...log

    DmClientSetup…log

    DmInstaller…log

    DmSvc…log

    DMCertResp.htm

    在 Windows Mobile Smartphone 2003 设备上

    \Storage\temp\DMClientLogs

    DmCertEnroll...log

    DmClientSetup…log

    DmInstaller…log

    DmSvc…log

    DMCertResp.htm

    在没有安装 Configuration Manager 2007 客户端的设备管理站点服务器上

    <安装文件夹>\CCM\Logs

    DmClientHealth.log

    DmClientRegistration.log

    DmpDatastore.log

    DmpDiscovery.log

    DmpFileCollection.log

    DmpHardware.log

    DmpIsapi.log

    DmpSoftware.log

    DmpStatus.log

    FspIsapi.log

    <安装文件夹>\Logs

    DmpMSI.log

    DmpSetup.log

    Fspmgr.log

    fspMSI.log

    \%windir%\System32\Logfiles\W3SVC1

    任何 IIS 日志（按日期和时间命名）

    在安装 Configuration Manager 2007 客户端的站点服务器上

    Configuration Manager 2007 安装目录为 \%windir%\System32\CCM。

    DmClientHealth.log

    DmClientRegistration.log

    DmpDatastore.log

    DmpDiscovery.log

    DmpFileCollection.log

    DmpHardware.log

    DmpIsapi.log

    DmpSoftware.log

    DmpStatus.log

    FspIsapi.log

另请参阅

任务

如何为组件启用日志记录

概念

如何验证移动设备客户端安装或升级

其他资源

如何编辑移动设备客户端配置 .ini 文件
注册表属性

有关其他信息，请参阅 Configuration Manager 2007 Information and Support。
要与文档团队联系，请将电子邮件发送至 SMSdocs@microsoft.com。