Workspace Environment Management

查看日志文件

您可以收集和查看与 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 中。要启用此日志文件,请按照以下步骤启用调试模式:

    1. 从 “开始” 菜单中打开 WEM 基础设施服务配置实用程序 。
    2. 高级设置 选项卡上,选择 启用调试模式
    3. 单击 保存配置 ,然后单击 启动服务以应用更改。
    4. 关闭 WEM Infrastructure Service Configuration Utility 窗口。
  • WCF 跟踪。当您遇到与 WEM Infrastructure Service 相关的通信问题时很有用的日志。要启用日志记录,必须启用 WCF 跟踪。有关详细信息,请参阅 Windows 通信基础跟踪记录

与管理控制台相关的日志

您可以收集与 WEM 管理控制台相关的日志。您可以在安装管理控制台的计算机上收集的日志包括:

  • Citrix WEM Console Trace.log。用于解决 WEM 管理控制台问题的日志。默认情况下,此日志文件在用户的配置文件夹 (%userprofile%) 中创建。要启用日志记录,请按照以下步骤启用调试模式:

    1. 从 “开始” 菜单中打开 WEM 管理控制台 ,然后单击 “ 连”。
    2. 在 “ 新建基础架构服务器连接 ” 窗口中,检查信息,然后单击 “ 连”。
    3. 于选项卡上,单击 选项 ,然后选择 启用调试模式
    4. 单击 应用 以应用更改。
  • 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 跟踪:

  1. 登录到 WEM 代理计算机。
  2. 右键单击任务栏中的代理图标,然后选择 退出 关闭代理。
  3. %PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Agent 中找到 VUEMUIAgent.exe.config 文件,然后创建该文件的备份副本。
  4. 在记事本或写字板中打开文件,然后将以下代码片段插入到 <configuration></configSections> 标记之间的部分中。
  5. 保存该文件。

    <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-->
    
  6. 在代理计算机上,在 C 驱动器 (C:\Trace) 上创建一个名为“Trace”的根文件夹。如果文件夹已存在,请跳过此步骤。
  7. 重现您遇到的问题,然后结束 VUEMUIAgent.exe 过程。
  8. 查看 C:\Trace 中名为 vuemUIAgent-Traces.svclog 的日志文件。

您还可以查看 Citrix.Wem.Agent.Service.exe 服务的 WCF 跟踪。请按照以下步骤进行操作:

  1. 登录到 WEM 代理计算机。
  2. 右键单击任务栏中的代理图标,然后选择 退出 关闭代理。
  3. 结束 Citrix WEM Agent Host Service。
  4. 找到 %PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Agent 中的 Citrix.wem.agent.service.exe.config 文件,然后创建该文件的备份副本。
  5. 在记事本或写字板中打开文件,然后将以下片段插入到文件中,从 </configSections> 标记之后的第四行开始。
  6. 保存该文件。

    <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-->
    
  7. 在代理计算机上,在 C 驱动器 (C:\Trace) 上创建一个名为“Trace”的根文件夹。如果文件夹已存在,请跳过此步骤。
  8. 启动名为 Citrix WEM 代理主机服务的 Windows 服务,然后重现遇到的问题。
  9. 查看 C:\Trace 中名为 NorskaleAgentHostService-Traces.svclog 的日志文件。

排查与 WEM Infrastructure Service 相关的通信

如果您遇到与 WEM Infrastructure Service 相关的通信问题,可以查看 Norskale Broker Service 的 WCF 跟踪信息。请按照以下步骤启用 WCF 跟踪:

  1. 登录到安装 WEM Infrastructure Service 的计算机。
  2. 终止 Citrix WEM 基础架构服务。
  3. %PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Infrastructure Services 中找到 Norskale Broker Service.exe.config 文件,然后创建该文件的备份副本。
  4. 在记事本或写字板中打开文件,然后将以下片段插入到文件中,从 <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-->
    
  5. 保存该文件。
  6. 在 WEM Infrastructure Service 计算机上,在 C 驱动器 (C:\Trace) 上创建一个名为“Trace”的根文件夹。如果文件夹已存在,请跳过此步骤。
  7. 启动 Citrix WEM 基础架构服务,然后重现您遇到的问题。
  8. 查看 C:\Trace 中名为 NorskaleInfrastructureBrokerService-Traces.svclog 的日志文件。

对 WEM 管理控制台和 WEM 数据库之间的通信进行故障排除

如果遇到与 WEM 管理控制台和 WEM 数据库之间的通信相关的问题,可以查看 Norskale Administration Console.exe 服务的 WCF 跟踪。请按照以下步骤启用 WCF 跟踪:

  1. 登录到 WEM 管理控制台计算机。
  2. 关闭 WEM 管理控制台。
  3. %PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Administration Console 中找到 Norskale 管理控制台 .exe.config 文件,然后创建该文件的备份副本。
  4. 在记事本或写字板中打开文件,然后将以下片段添加到文件中,从 <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-->
    
  5. 保存该文件。
  6. 在管理控制台计算机上,在 C 驱动器 (C:\Trace) 上创建一个名为“Trace”的根文件夹。如果文件夹已存在,请跳过此步骤。
  7. 打开 WEM 管理控制台,然后重现遇到的问题。
  8. 查看 C:\Trace 中名为 WEMConsole-Traces.svclog 的日志文件。
查看日志文件