查看日志文件

Last published : Nov 13, 2026
您可以收集和查看与 Workspace Environment Management™ (WEM) 相关的日志。您可以使用这些日志自行排查问题，或者在联系 Citrix 技术支持寻求帮助时提供这些日志。您可以收集与以下各项相关的日志：
Related information
参考

与代理相关的日志

您可以收集与 WEM 代理相关的日志。您可以在安装了 WEM 代理的计算机上收集的日志包括：
  • WEM 代理日志
    • Citrix WEM Agent Init.log。此初始化日志可让您在 CMD 或 UI 模式下排查代理问题。该日志在登录或刷新时创建。如果代理无法启动，请查看此日志文件以获取错误详细信息。错误显示为 exceptions。默认情况下，此日志文件在用户配置文件文件夹 (%userprofile%) 中创建。
    • Citrix WEM Agent.log。此主要日志可让您在 CMD 或 UI 模式下排查代理问题。该日志列出了代理处理的指令。如果操作未能分配给当前用户，请查看此日志文件以获取错误详细信息。错误显示为 exceptions。默认情况下，此日志文件在用户配置文件文件夹 (%userprofile%) 中创建。要更改默认设置，请转至管理控制台 > 高级设置 > 配置 > 代理选项，然后配置启用代理日志记录设置。要查看更多详细信息，请在代理选项选项卡上启用调试模式。或者，您可以通过配置以下注册表项来启用日志记录：
      计算机\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Norskale\代理主机
      名称: AgentDebugModeLocalOverride
      类型: DWORD
      值: 0
      将值设置为 1 以启用日志文件，设置为 0 以禁用日志文件。要使更改生效，请重新启动 Citrix WEM Agent Host Service。默认情况下，日志记录处于禁用状态。
      注意：
      不正确地编辑注册表可能会导致严重问题，可能需要重新安装操作系统。Citrix 无法保证可以解决因不正确使用注册表编辑器而导致的问题。请自行承担使用注册表编辑器的风险。在编辑注册表之前，请务必备份注册表。
    • Citrix WEM Agent Host Service Debug.log。允许您排查 Citrix WEM 代理主机服务问题的日志。默认情况下，此日志文件位于 %PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Agent。要启用日志记录，请务必在管理控制台 > 高级设置 > 配置 > 服务选项选项卡上为相关配置集启用调试模式。或者，您可以通过配置以下注册表项来启用日志记录：
      计算机\HKEY_LOCAL_MACHINE\系统\当前控制集\控制\Norskale\代理主机
      名称: AgentServiceDebugModeLocalOverride
      类型: DWORD
      值: 0
      将值设置为 1 以启用日志文件，设置为 0 以禁用日志文件。要使更改生效，请重新启动 Citrix WEM 代理主机服务。默认情况下，日志记录处于禁用状态。
      注意：
      不正确地编辑注册表可能会导致严重问题，可能需要重新安装操作系统。Citrix 无法保证可以解决因不正确使用注册表编辑器而导致的问题。请自行承担使用注册表编辑器的风险。在编辑注册表之前，请务必备份注册表。
  • Windows 事件日志。写入 Windows 事件日志的信息。在事件查看器 > 应用程序和服务日志 > WEM 代理服务窗格中查看日志。
  • Windows Communication Foundation (WCF) 跟踪。当您遇到 WEM 代理和 WEM 基础结构服务之间通信相关的问题时，这些日志会很有帮助。要启用日志记录，必须启用 WCF 跟踪。有关详细信息，请参阅Windows Communication Foundation 跟踪。

与基础结构服务相关的日志

您可以收集与 WEM 基础结构服务相关的日志。您可以在安装了 WEM 基础结构服务的计算机上收集的日志包括：
  • Windows 事件日志。写入 Windows 事件日志的信息。在事件查看器 > 应用程序和服务日志 > Norskale Broker Service 窗格中查看日志。
  • Citrix WEM Infrastructure Service Debug.log。允许您排查 Citrix WEM 基础结构服务 (Norskale Broker Service.exe) 问题的日志。默认情况下，此日志文件位于 %PROGRAMFILES(X86)%\ Norskale\Norskale Infrastructure Services。要启用此日志文件，请按照以下步骤启用调试模式：
    1. 从“开始”菜单打开 WEM 基础结构服务配置实用程序。
    2. 在高级设置选项卡上，选择启用调试模式。
    3. 单击保存配置，然后单击是以启动服务来应用更改。
    4. 关闭 WEM 基础结构服务配置实用程序窗口。
  • WCF 跟踪。当您遇到与 WEM 基础结构服务相关的通信问题时，这些日志会很有帮助。要启用日志记录，必须启用 WCF 跟踪。有关详细信息，请参阅 Windows Communication Foundation 跟踪。

与管理控制台相关的日志

您可以收集与 WEM 管理控制台相关的日志。可以在安装了管理控制台的计算机上收集的日志包括：
  • Citrix WEM Console Trace.log。此日志可帮助您排查 WEM 管理控制台的问题。默认情况下，此日志文件在用户配置文件文件夹 (%userprofile%) 中创建。要启用日志记录，请按照以下步骤启用调试模式：
    1. 从“开始”菜单打开 WEM 管理控制台，然后单击“连接”。
    2. 在“新建基础结构服务器连接”窗口中，检查信息，然后单击“连接”。
    3. 在“关于”选项卡上，单击“选项”，然后选择“启用调试模式”。
    4. 单击“应用”以应用更改。
  • WCF 跟踪。当您遇到与 WEM 管理控制台和 WEM 数据库之间的通信相关的问题时，这些日志会很有帮助。要启用日志记录，必须启用 WCF 跟踪。有关详细信息，请参阅 Windows Communication Foundation 跟踪。

与 WEM 数据库相关的日志

您可以收集与 WEM 数据库相关的日志。当您使用 WEM 数据库管理实用程序创建或升级数据库时，会创建日志。查看以下日志文件以了解详细信息：
  • Citrix WEM Database Management Utility Debug Log.log。此日志可帮助您排查 WEM 数据库的问题。此日志文件默认创建，位于 C:\Program Files (x86)\Norskale\Norskale Infrastructure Services。

Windows 通信基础 跟踪

您可以查看 Windows Communication Foundation (WCF) 跟踪，以帮助您排查以下问题：

解决代理与基础架构服务之间的通信问题

如果 WEM 代理未与 WEM 基础架构服务正确通信，您可以查看 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>
  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 代理主机服务。
  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>
  7. 在代理计算机上，在 C 盘 (C:\Trace) 上创建一个名为“Trace”的根文件夹。如果文件夹已存在，请跳过此步骤。
  8. 启动名为 Citrix WEM Agent Host Service 的 Windows 服务，然后重现您遇到的问题。
  9. 在 C:\Trace 中查看名为 NorskaleAgentHostService-Traces.svclog 的日志文件。

排查与 WEM 基础架构服务相关的通信问题

如果遇到与 WEM 基础架构服务相关的通信问题，可以查看 Norskale Broker Service 的 WCF 跟踪。请按照以下步骤启用 WCF 跟踪：
  1. 登录到安装了 WEM 基础架构服务的计算机。
  2. 终止 Norskale 基础架构服务。
  3. 在 %PROGRAMFILES(X86)%\Norskale\Norskale 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>
  5. 保存文件。
  6. 在 WEM 基础架构服务计算机上，在 C 盘 (C:\Trace) 上创建一个名为“Trace”的根文件夹。如果文件夹已存在，请跳过此步骤。
  7. 启动 Norskale Infrastructure Service，然后重现您遇到的问题。
  8. 在 C:\Trace 中查看名为 NorskaleInfrastructureBrokerService-Traces.svclog 的日志文件。

排查 WEM 管理控制台与 WEM 数据库之间的通信问题

如果您遇到 WEM 管理控制台与 WEM 数据库之间通信相关的问题，您可以查看 Norskale Administration Console.exe 服务的 WCF 跟踪。请按照以下步骤启用 WCF 跟踪：
  1. 登录到 WEM 管理控制台计算机。
  2. 关闭 WEM 管理控制台。
  3. 在 %PROGRAMFILES(X86)%\Norskale\Norskale Administration Console 中找到 Norskale Administration Console.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>
  5. 保存文件。
  6. 在管理控制台计算机上，在 C 盘上创建一个名为“Trace”的根文件夹 (C:\Trace)。如果该文件夹已存在，请跳过此步骤。
  7. 打开 WEM 管理控制台，然后重现您遇到的问题。
  8. 在 C:\Trace 中查看名为 WEMConsole-Traces.svclog 的日志文件。