查看日志文件
您可以收集和查看与 Workspace Environment Management (WEM) 相关的日志。您可以使用日志自行解决问题,或者在联系 Citrix 技术支持寻求帮助时提供日志。您可以收集与以下相关的日志:
与代理相关的日志
您可以收集与 WEM 代理相关的日志。您可以在安装 WEM 代理的计算机上收集的日志包括:
-
WEM 代理日志
-
Citrix WEM Agent Init.log。初始化日志允许您在 CMD 或 UI 模式下排除代理的问题。日志是在登录时或刷新时创建的。如果代理程序无法启动,请查看此日志文件以了解错误详细信息。错误显示为 例外。默认情况下,此日志文件在用户的配置文件夹 (%userprofile%) 中创建。
-
Citrix WEM Agent.log。用于解决 CMD 或 UI 模式下代理的问题的主日志。日志列出了代理处理的说明。如果未能将操作分配给当前用户,请查看此日志文件以了解错误详细信息。错误显示为 例外。默认情况下,此日志文件在用户的配置文件夹 (%userprofile%) 中创建。要更改默认设置,请转到 管理控制台 > 高级设置 > 配置 > 代理选项 ,然后配置 启用代理日志记录 设置。要查看更多详细信息,请在 代理选项选项 卡上启用 调试模式 。或者,您可以通过配置以下注册表项来启用日志记录:
Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Norskale\Agent Host
名称:AgentDebugModeLocalOverride
类型:DWORD
值:0
将值设置为 1 以启用日志文件,将值设置为 0 将其禁用。要使更改生效,请重新启动 Citrix WEM 代理主机服务。默认情况下,禁用日志记录。
小心:
注册表编辑不当会导致严重问题,可能需要重新安装操作系统。Citrix 无法保证因注册表编辑器使用不当导致出现的问题能够得以解决。使用注册表编辑器需自担风险。在编辑注册表之前,请务必进行备份。
-
Citrix WEM Agent Host Service Debug.log。允许您对 Citrix WEM 代理主机服务问题进行故障排除的日志。默认情况下,此日志文件位于
%PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Agent
中。要启用日志记录,请务必为 管理控制台 > 高级设置 > 配置 > 服务选项选项卡上的相关配置 启用 调试模式 。或者,您可以通过配置以下注册表项来启用日志记录:Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Norskale\Agent Host
名称:AgentServiceDebugModeLocalOverride
类型:DWORD
值:0
将值设置为 1 以启用日志文件,将值设置为 0 将其禁用。要使更改生效,请重新启动 Citrix WEM 代理主机服务。默认情况下,禁用日志记录。
小心:
注册表编辑不当会导致严重问题,可能需要重新安装操作系统。Citrix 无法保证因注册表编辑器使用不当导致出现的问题能够得以解决。使用注册表编辑器需自担风险。在编辑注册表之前,请务必进行备份。
-
-
Windows 事件日志。写入 Windows 事件日志的信息。在 事件查看器 > 应用程序和服务日志 > WEM 代理服务 窗格中查看日志。
-
Windows 通信基金会 (WCF) 跟踪。当您遇到与 WEM 代理和 WEM Infrastructure Service 之间的通信相关问题时很有用的日志。要启用日志记录,必须启用 WCF 跟踪。有关详细信息,请参阅 Windows 通信基础跟踪记录。
与基础架构服务相关的日志
您可以收集与 WEM Infrastructure Service 相关的日志。您可以在安装 WEM Infrastructure Service 的计算机上收集的日志包括:
-
Windows 事件日志。写入 Windows 事件日志的信息。在 事件查看器 > 应用程序和服务日志 > WEM 基础设施服务 窗格中查看日志。
-
Citrix WEM Infrastructure Service Debug.log。允许您对 Citrix WEM Infrastructure Service (Norskale Broker Service.exe) 问题进行故障排除的日志。默认情况下,此日志文件位于
%PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Infrastructure Services
中。要启用此日志文件,请按照以下步骤启用调试模式:- 从 “开始” 菜单中打开 WEM 基础设施服务配置实用程序 。
- 在 高级设置 选项卡上,选择 启用调试模式。
- 单击 保存配置 ,然后单击 是 启动服务以应用更改。
- 关闭 WEM Infrastructure Service Configuration Utility 窗口。
-
WCF 跟踪。当您遇到与 WEM Infrastructure Service 相关的通信问题时很有用的日志。要启用日志记录,必须启用 WCF 跟踪。有关详细信息,请参阅 Windows 通信基础跟踪记录。
与管理控制台相关的日志
您可以收集与 WEM 管理控制台相关的日志。您可以在安装管理控制台的计算机上收集的日志包括:
-
Citrix WEM Console Trace.log。用于解决 WEM 管理控制台问题的日志。默认情况下,此日志文件在用户的配置文件夹 (%userprofile%) 中创建。要启用日志记录,请按照以下步骤启用调试模式:
- 从 “开始” 菜单中打开 WEM 管理控制台 ,然后单击 “ 连接”。
- 在 “ 新建基础架构服务器连接 ” 窗口中,检查信息,然后单击 “ 连接”。
- 在 关 于选项卡上,单击 选项 ,然后选择 启用调试模式。
- 单击 应用 以应用更改。
-
WCF 跟踪。当您遇到与 WEM 管理控制台和 WEM 数据库之间的通信有关的问题时,这些日志非常有用。要启用日志记录,必须启用 WCF 跟踪。有关详细信息,请参阅 Windows 通信基础跟踪记录。
与 WEM 数据库相关的日志
您可以收集与 WEM 数据库相关的日志。使用 WEM 数据库管理实用程序创建或升级数据库时,将创建日志。查看以下日志文件了解详细信息:
-
Citrix WEM Database Management Utility Debug Log.log。允许您对 WEM 数据库问题进行故障排除的日志。默认情况下,此日志文件是创建的,位于
C:\Program Files (x86)\Citrix\Workspace Environment Management Infrastructure Services
中。
与 WEM Web 控制台相关的日志
您可以收集与 WEM Web 控制台相关的日志。日志是在您使用 WEM Web 控制台配置实用程序配置 Web 控制台时创建的。此外,在 Web 控制台服务运行时会创建日志。有关更多详细信息,请参阅以下日志文件:
-
Web 控制台配置 Utility.log。允许您解决 WEM Web 控制台配置实用程序问题的日志。默认情况下,此日志文件是创建的,位于
C:\ProgramData
中。 -
Citrix WEM 公开 API.log。该日志可让您对 WEM Web 控制台服务问题进行故障排除。当您使用 Web 控制台配置实用程序 配置 Web 控制台 服务以启用日志记录时,请确保启用 “ 启用控制台日志记录 ” 选项。此日志文件位于
C:\ProgramData
。
Windows 通信基金会跟踪
您可以查看 Windows 通信基金会 (WCF) 跟踪以帮助您解决以下问题:
排除代理与基础架构服务之间的通信问题
如果 WEM 代理无法与 WEM Infrastructure Service 正确通信,则可以查看 VUEMUIAgent.exe 服务的 WCF 跟踪。请按照以下步骤启用 WCF 跟踪:
- 登录到 WEM 代理计算机。
- 右键单击任务栏中的代理图标,然后选择 退出 关闭代理。
- 在
%PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Agent
中找到 VUEMUIAgent.exe.config 文件,然后创建该文件的备份副本。 - 在记事本或写字板中打开文件,然后将以下代码片段插入到
<configuration>
和</configSections>
标记之间的部分中。 -
保存该文件。
<system.diagnostics> <sources> <source name="System.ServiceModel" switchValue="Information, ActivityTracing" propagateActivity="true"> <listeners> <add name="traceListener" type="System.Diagnostics.XmlWriterTraceListener" initializeData= "c:\trace\vuemUIAgent-Traces.svclog" /> </listeners> </source> </sources> </system.diagnostics> <!--NeedCopy-->
- 在代理计算机上,在 C 驱动器 (C:\Trace) 上创建一个名为“Trace”的根文件夹。如果文件夹已存在,请跳过此步骤。
- 重现您遇到的问题,然后结束 VUEMUIAgent.exe 过程。
- 查看
C:\Trace
中名为vuemUIAgent-Traces.svclog
的日志文件。
您还可以查看 Citrix.Wem.Agent.Service.exe 服务的 WCF 跟踪。请按照以下步骤进行操作:
- 登录到 WEM 代理计算机。
- 右键单击任务栏中的代理图标,然后选择 退出 关闭代理。
- 结束 Citrix WEM Agent Host Service。
- 找到
%PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Agent
中的 Citrix.wem.agent.service.exe.config 文件,然后创建该文件的备份副本。 - 在记事本或写字板中打开文件,然后将以下片段插入到文件中,从
</configSections>
标记之后的第四行开始。 -
保存该文件。
<system.diagnostics> <sources> <source name="System.ServiceModel" switchValue="Information, ActivityTracing" propagateActivity="true"> <listeners> <add name="traceListener" type="System.Diagnostics.XmlWriterTraceListener" initializeData= "c:\trace\NorskaleAgentHostService-Traces.svclog" /> </listeners> </source> </sources> </system.diagnostics> <!--NeedCopy-->
- 在代理计算机上,在 C 驱动器 (C:\Trace) 上创建一个名为“Trace”的根文件夹。如果文件夹已存在,请跳过此步骤。
- 启动名为 Citrix WEM 代理主机服务的 Windows 服务,然后重现遇到的问题。
- 查看
C:\Trace
中名为NorskaleAgentHostService-Traces.svclog
的日志文件。
排查与 WEM Infrastructure Service 相关的通信
如果您遇到与 WEM Infrastructure Service 相关的通信问题,可以查看 Norskale Broker Service 的 WCF 跟踪信息。请按照以下步骤启用 WCF 跟踪:
- 登录到安装 WEM Infrastructure Service 的计算机。
- 终止 Citrix WEM 基础架构服务。
- 在
%PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Infrastructure Services
中找到 Norskale Broker Service.exe.config 文件,然后创建该文件的备份副本。 -
在记事本或写字板中打开文件,然后将以下片段插入到文件中,从
<configuration>
标记之后的第三行开始。<system.diagnostics> <sources> <source name="System.ServiceModel" switchValue="Information, ActivityTracing" propagateActivity="true"> <listeners> <add name="traceListener" type="System.Diagnostics.XmlWriterTraceListener" initializeData= "c:\trace\NorskaleInfrastructureBrokerService-Traces.svclog" /> </listeners> </source> </sources> </system.diagnostics> <!--NeedCopy-->
- 保存该文件。
- 在 WEM Infrastructure Service 计算机上,在 C 驱动器 (C:\Trace) 上创建一个名为“Trace”的根文件夹。如果文件夹已存在,请跳过此步骤。
- 启动 Citrix WEM 基础架构服务,然后重现您遇到的问题。
- 查看
C:\Trace
中名为NorskaleInfrastructureBrokerService-Traces.svclog
的日志文件。
对 WEM 管理控制台和 WEM 数据库之间的通信进行故障排除
如果遇到与 WEM 管理控制台和 WEM 数据库之间的通信相关的问题,可以查看 Norskale Administration Console.exe 服务的 WCF 跟踪。请按照以下步骤启用 WCF 跟踪:
- 登录到 WEM 管理控制台计算机。
- 关闭 WEM 管理控制台。
- 在
%PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Administration Console
中找到 Norskale 管理控制台 .exe.config 文件,然后创建该文件的备份副本。 -
在记事本或写字板中打开文件,然后将以下片段添加到文件中,从
<configuration>
标记后的第三行开始。<system.diagnostics> <sources> <source name="System.ServiceModel" switchValue="Information, ActivityTracing" propagateActivity="true"> <listeners> <add name="traceListener" type="System.Diagnostics.XmlWriterTraceListener" initializeData= "c:\trace\WEMConsole-Traces.svclog" /> </listeners> </source> </sources> </system.diagnostics> <!--NeedCopy-->
- 保存该文件。
- 在管理控制台计算机上,在 C 驱动器 (C:\Trace) 上创建一个名为“Trace”的根文件夹。如果文件夹已存在,请跳过此步骤。
- 打开 WEM 管理控制台,然后重现遇到的问题。
- 查看
C:\Trace
中名为WEMConsole-Traces.svclog
的日志文件。