Profile Management

检查 Profile Management 日志文件

日志文件在排查系统行为问题时非常有用。在 (/zh-cn/profile-management/current-release/troubleshoot/self-troubleshoot.html) 之后,启用 Profile Management 日志记录并重现问题以检查日志文件。

详细步骤如下:

  1. (#enable-profile-management-logging) 所有事件和操作。
  2. 在计算机上重现问题。
  3. 检查 %SystemRoot%\system32\LogFiles\UserProfileManager 文件夹中的 Profile Management 日志文件(例如,#computername#.#domainname#_pm.log),查找错误和警告。通过分别搜索单词 ERROR 或 WARNINGS 来定位它们。

    有关日志文件的更多信息,请参阅本文后面的 (#reference)。

  4. 检查用户存储的路径是否正确。
  5. 检查是否已正确读取 Active Directory 中的所有信息。
  6. 检查时间戳以查看是否存在耗时过长的操作。

提示:

您可以使用 Microsoft Excel 查看 Profile Management 日志文件。有关更多信息,请参阅知识中心文章 CTX200674

启用 Profile Management 日志记录

仅在排查 Profile Management 部署中的问题时,才为所有事件和操作启用 Profile Management 日志记录。解决问题后,请禁用日志记录并删除日志文件,因为它们可能包含敏感信息。

本节将指导您如何使用 GPO 和 UPMPolicyDefaults_all.ini 为所有事件和操作启用日志记录。

您还可以使用 Citrix Studio 和 Workspace Environment Management (WEM) 实现此目标。有关详细信息,请参阅 决定集中配置 Profile Management 的位置

使用 GPO 启用日志记录

要使用 GPO 为所有事件和操作启用 Profile Management 日志记录,请执行以下步骤:

  1. 打开组策略管理编辑器,然后创建组策略对象。

  2. 访问 策略 > 管理模板: 策略定义 (ADMX 文件) > Citrix 组件 > Profile Management > 日志设置

  3. 启用 Profile Management 日志记录,如下所示:

    1. 双击 启用日志记录
    2. 单击 已启用
    3. 单击 确定
  4. 启用 Profile Management 以记录所有事件和操作:

    1. 双击 日志设置
    2. 选择所有事件和操作。有关其说明的详细信息,请参阅 事件和操作
    3. 单击 确定
  5. 要更改日志文件的默认最大大小,请执行以下步骤:

    1. 双击 日志文件的最大大小
    2. 点击启用,然后在最大大小(字节)字段中输入大小。
    3. 点击确定

    提示:

    达到最大大小时,Profile Management 会保留一个备份文件(例如,Logfilename.log.bak)。

  6. 在计算机上运行 gpupdate /force 命令。

    这些策略将在计算机上生效。

有关日志设置策略的详细信息,请参阅Profile Management 策略说明和默认值

使用 .ini 文件启用日志记录

要使用 UPMPolicyDefaults_all.ini 为所有事件和操作启用 Profile Management 日志记录,请执行以下步骤:

  1. 在 Profile Management 安装文件夹中打开 UPMPolicyDefaults_all.ini(默认情况下为 C:\Program Files\Citrix\User Profile Manager)。
  2. 搜索日志设置以找到相关设置。

    与日志记录相关的设置

  3. LoggingEnabled 输入 1
  4. 为从 LogLevelWarningsLogLevelUserName 的每个参数输入 1。有关这些参数的详细信息,请参阅事件和操作
  5. 要更改日志文件的默认最大大小,请根据需要为 MaxLogSize 输入大小。
  6. 要更改日志文件的默认文件夹,请根据需要为 PathToLogFile 输入路径。

参考

本节提供以下信息:

日志类型

此表列出了可用于排查 Profile Management 故障的日志。

非正式名称 日志文件名 位置 日志信息类型
Profile Management 日志文件 #computername#.#domainname#_pm.log %SystemRoot%\system32\LogFiles\UserProfileManager 信息性消息、警告和错误会写入 Profile Management 日志文件。域名是计算机的域。如果无法确定计算机名称,则此日志文件名为 UserProfileManager.log。如果无法确定域但计算机名称可用,则日志文件名为 #computername#_pm.log。
Profile Management 配置日志文件 #computername#.#domainname#_pm_config.log %SystemRoot%\system32\LogFiles\UserProfileManager 即使关闭日志记录,配置日志文件也会捕获 GPO 和 .ini 文件设置。如果无法确定计算机名称,则此日志文件名为 UserProfileManager_pm_config。如果无法确定域但计算机名称可用,则日志文件名为 #computername#_pm_config.log。
Windows 事件日志 Application.evtx %SystemRoot%\System32\winevt\Logs\ 您使用 Microsoft 事件查看器查看的 Windows 事件主要用于错误报告。只有错误才会写入其中。

事件和操作

此表列出了 Profile Management 可以记录的事件和操作。

类型 描述 .ini 中的参数
常见警告 所有常见警告。 LogLevelWarnings
常见信息 所有常见信息。 LogLevelInformation
文件系统通知 每当处理的文件或文件夹发生更改时,都会创建一个日志条目。 LogLevelFileSystemNotification
文件系统操作 由 Profile Management 执行的文件系统操作。 LogLevelFileSystemActions
注册表操作 由 Profile Management 执行的注册表操作。 LogLevelRegistryActions
注销时的注册表差异 会话中已更改的 HKCU 配置单元中的所有注册表项。重要提示:此设置会在日志文件中生成大量输出。 LogLevelRegistryDifference
活动目录操作 每次 Profile Management 查询 Active Directory 时,都会向日志文件写入一个条目。 LogLevelActiveDirectoryActions
策略值 当 Profile Management 服务启动或发生策略刷新时,策略值会写入日志文件。 LogLevelPolicyUserLogon
登录 登录期间的一系列操作会写入日志文件。 LogLevelLogon
注销 注销期间的一系列操作会写入日志文件。 LogLevelLogoff
个性化用户信息 在适用情况下,用户和域名会记录到日志文件的专用列中。 LogLevelUserName

日志文件字段

Profile Management 日志文件中的每一行都有多个字段,字段之间用分号分隔。下表列出了日志文件字段。

字段 描述
日期 日志条目的日期
时间 日志条目的时间(包括毫秒)
严重性 INFORMATION、WARNING 或 ERROR
用户的域(如适用)
用户名 用户的名称(如适用)
会话 ID 会话 ID(如适用)
线程 ID 创建此行的线程 ID
函数和描述 当时正在运行的 Profile Management 函数的名称,以及日志消息
检查 Profile Management 日志文件