XenApp and XenDesktop

Citrix Scout

简介

Citrix Scout 收集可以用于在 XenApp 和 XenDesktop 部署中进行主动维护的诊断信息。Citrix 通过 Citrix Insight Services 提供综合的自动分析。您还可以使用 Scout 自己或在 Citrix Support 的指导下对问题进行故障排除。可以将收集文件上载到 Citrix 以供分析以及获取 Citrix 支持提供的指导。也可以将收集信息保存在本地供自己查看,以及以后将收集文件上载到 Citrix 以供分析。

Scout 提供三个主要过程:

  • 收集: 在站点中所选计算机上运行一次性诊断信息收集。然后,将包含收集信息的文件上载到 Citrix 或保存在本地。
  • 跟踪和重现: 在所选计算机上启动手动跟踪。然后,在这些计算机上重新创建问题。重现问题后,将停止跟踪。然后,Scout 将收集其他诊断信息并将包含跟踪和收集信息的文件上载到 Citrix 或保存在本地。
  • 计划安排: 安排在所选计算机上在每天或每周的指定时间执行诊断信息收集。包含每次收集信息的文件会自动上载到 Citrix。

本文所述图形界面是使用 Scout 的主要方式。也可以使用 PowerShell 界面配置一次性或计划的诊断信息收集和上载。请参阅 Call Home

Scout 运行位置:

  • 在本地 XenApp 和 XenDesktop 部署中,从 Delivery Controller 运行 Scout 来捕获一个或多个 Virtual Delivery Agent (VDA) 和 Delivery Controller 中的诊断信息。还可以从 VDA 运行 Scout 来收集本地诊断信息。
  • 在使用 XenApp and XenDesktop Service 的 Citrix Cloud 环境中,从 VDA 运行 Scout 来收集本地诊断信息。

收集内容

Scout 收集的诊断信息包括 Citrix Diagnostic Facility (CDF) 跟踪日志文件。还包括称为 AlwaysOn 跟踪 (AOT) 的一部分 CDF 跟踪。对常见问题(例如,VDA 注册和应用程序/桌面启动)进行故障排除时,AOT 信息很有用。系统不会收集任何其他 Windows 事件跟踪 (ETW) 信息。

收集的信息包括:

  • 由 XenApp 和 XenDesktop 在 HKEY_LOCAL_MACHINE\SOFTWARE\CITRIX 下创建的注册表项。
  • 位于 Citrix 命名空间下的 Windows Management Instrumentation (WMI) 信息。
  • 运行的进程。
  • Citrix 进程的存储于 %PROGRAM DATA%\Citrix\CDF 中的故障转储。

关于跟踪信息:

  • 跟踪信息在收集时进行压缩处理,在计算机上占用空间较少。
  • 在每台计算机上,Citrix Telemetry Service 最多保留 10 MB 压缩后的近期跟踪信息,最长时间期限为 8 天。
  • 跟踪信息保留在内存中,以避免在置备的计算机上发生 IOPS。
  • 跟踪缓冲区采用循环机制在内存中保留跟踪信息。

有关 Scout 收集的数据点列表,请参阅 Scout 关键数据点

必备项和注意事项

权限

  • 您必须是要从中收集诊断信息的每台计算机的本地管理员和域用户。
  • 必须对每台计算机上的 LocalAppData 目录具有写入权限。
  • 启动 Scout 时使用以管理员身份运行

对于要从中收集诊断信息的每台计算机:

  • Scout 必须能够与计算机通信。
  • 必须打开文件和打印机共享。
  • 必须启用 PSRemoting 和 WinRM。计算机还必须运行 PowerShell 3.0 或更高版本。
  • 计算机上必须运行 Citrix Telemetry Service。
  • 要设置诊断信息收集的计划,计算机必须运行随 XenApp 和 XenDesktop 7.14 或受支持的更高版本随附的 Scout 版本。

Scout 在所选计算机上运行验证测试,以确保满足上述要求。

验证测试

在开始收集诊断信息之前,验证测试将针对选定的每台计算机自动运行。这些测试将确保满足上面列出的要求。如果某台计算机的测试失败,Scout 将显示一条消息,提供建议的更正措施。

错误消息 更正措施
Scout 无法访问此计算机 确保已打开计算机电源。确保网络连接正确运行。(这可以包括验证您的防火墙是否已正确配置。)确保已打开文件和打印机共享。请参阅 Microsoft 文档以了解相关说明。
启用 PSRemoting 和 WinRM 可以同时启用 PowerShell 远程处理和 WinRM。使用“以管理员身份运行”,运行 Enable-PSRemoting cmdlet。有关详细信息,请参阅 Microsoft 帮助中的 cmdlet。
Scout 要求 PowerShell 3.0 (最低版本) 在计算机上安装 PowerShell 3.0(或更高版本),然后启用 PowerShell 远程处理。
无法访问此计算机上的 LocalAppData 目录 确保帐户对计算机上的 LocalAppData 目录具有写入权限。
找不到 Citrix Telemetry Service 确保 Citrix Telemetry Service 已在计算机上安装并启动。
无法获取计划 将计算机(最低)升级到 XenApp 和 XenDesktop 7.14。

版本兼容性

此版本的 Scout (3.x) 要在(最低)XenApp 和 XenDesktop 7.14 Controller 和 VDA 上运行。

早期 XenApp 和 XenDesktop 部署提供了早期版本的 Scout。有关早期版本的信息,请参阅 CTX130147

如果将 7.14 之前的 Controller 或 VDA 升级到版本 7.14(或受支持的更高版本),早期版本的 Scout 会替换为当前版本。

功能 Scout 2.23 Scout 3.0
支持 XenApp 和 XenDesktop 7.14(最低版本)
支持 XenDesktop 5.x、7.1 至 7.13
支持 XenApp 6.x、7.5 至 7.13
与产品一起提供 7.1 至 7.13 自 7.14 起
可以从 CTX 文章中下载
捕获 CDF 跟踪
捕获 AlwaysOn 跟踪 (AOT)
允许收集诊断数据 一次最多 10 台计算机(默认) 无限制(受资源可用性约束)
允许诊断数据发送到 Citrix
允许诊断数据保存在本地
支持 Citrix Cloud 凭据
支持 Citrix 凭据
支持使用代理服务器进行上载
调整计划 不适用
脚本支持 命令行(仅限本地 Controller) 使用 Call Home cmdlet 的 PowerShell(安装了遥测的任何计算机)

安装

默认情况下,安装 VDA 或 Controller 时,Scout 会自动作为 Citrix Telemetry Service 的一部分安装。

如果在安装 VDA 时忽略 Citrix Telemetry Service,或者以后删除了该服务,请运行 XenApp 或 XenDesktop ISO 中 x64\Virtual Desktop Components 或 x86\Virtual Desktop Components 文件夹中的 TelemetryServiceInstaller_xx.msi。

上载授权

如果您计划将诊断收集信息上载到 Citrix,必须有 Citrix 或 Citrix Cloud 帐户。(这些是访问 Citrix 下载或访问 Citrix Cloud 控制中心时使用的凭据。)验证了您的帐户凭据后,系统会发出令牌。

  • 如果您使用 Citrix 帐户进行身份验证,发出令牌的过程不可见。您只需输入您的帐户凭据。Citrix 验证凭据后,您可以继续使用 Scout 向导。
  • 如果您使用 Citrix Cloud 帐户进行身份验证,则单击链接访问 Citrix Cloud(在您的默认浏览器中使用 HTTPS)。输入您的 Citrix Cloud 凭据后,将显示令牌。请将令牌复制并粘贴到 Scout 中。然后您就可以继续使用 Scout 向导。

令牌存储在运行 Scout 的计算机本地。如果要下次使用该令牌,请选择收集跟踪和重现,然后选中存储令牌并在将来跳过此步骤复选框。

您每次在 Scout 的打开页面上选择计划时都必须重新授权。创建或更改计划时不能使用存储的令牌。

使用代理进行上载

如果要使用代理服务器将收集信息上载到 Citrix,可以指示 Scout 使用为浏览器的 Internet 属性配置的代理设置,也可以指定代理服务器的 IP 地址和端口号。

收集诊断信息

收集过程包括选择计算机、开始收集诊断信息以及将包含收集信息的文件上载到 Citrix 或将其保存在本地。

步骤 1. 启动 Scout。

从计算机的“开始”菜单依次选择:Citrix > Citrix Scout。在打开的页面上,单击收集

步骤 2. 选择计算机。

“选择计算机”页面上列出站点中的所有 VDA 和 Controller。可以按计算机名称过滤显示内容。选中要从中收集诊断信息的每台计算机旁边的复选框,然后单击继续

Scout 将自动在选择的每台计算机上启动验证测试,确保计算机满足验证测试中所列的条件。如果验证失败,将在状态列中发布一条消息,且取消选中相应计算机的复选框。您可以执行下列操作之一:

  • 解决问题,然后重新选中相应计算机的复选框。这将触发重试验证测试。
  • 跳过相应的计算机(让其复选框处于取消选中状态)。系统将不会从该计算机收集诊断信息。

验证测试完成后,单击继续

步骤 3. 从计算机收集诊断信息。

摘要中列出将从中收集诊断信息的所有计算机(您选择的通过验证测试的计算机)。单击开始收集

在收集期间:

  • 状态列指示计算机的当前收集状态。
  • 要停止单台计算机上正在进行的收集,请在该计算机对应的“操作”列中单击取消
  • 要停止所有正在进行的收集,请单击页面右下角的停止收集。系统会保留已完成收集的计算机的诊断信息。要恢复收集,请在每台计算机对应的“操作”列中单击重试
  • 完成所有选定计算机的收集时,右下角的停止收集按钮将变为继续
  • 如果某台计算机的收集已成功,而您要重新从该计算机收集诊断信息,请在该计算机的“操作”列中单击重新收集。较新的收集信息将覆盖较早的收集信息。
  • 如果收集失败,可以在“操作”列中单击重试。仅成功完成的收集信息会上载或保存。
  • 完成所有选定计算机的收集后,请勿单击返回。如果单击该按钮并确认提示,收集信息将会丢失。

收集完成时,单击继续

步骤 4. 保存或上载收集信息。

选择是将包含所收集诊断信息的文件上载到 Citrix,还是将其保存在本地计算机上。

如果选择立即上载该文件,请继续执行步骤 5。

如果选择在本地保存该文件:

  • 此时将显示 Windows 保存对话框。导航到所需位置。
  • 完成本地保存时,将显示文件的路径名并提供链接。您可以查看该文件。您可以在以后从 Citrix 上载该文件;请参阅 CTX136396 了解 Citrix Insight Services,或参阅 Smart Tools 支持

单击完成返回 Scout 的打开页面。在此过程中,不需要完成任何进一步的步骤。

步骤 5. 为上载验证身份及(可选)指定代理。

有关此过程的详细信息,请查看上载授权

  • 如果您之前没有通过 Scout 进行身份验证,请继续执行此步骤。
  • 如果您之前已通过 Scout 完成身份验证,默认使用存储的授权令牌。如果您没有问题,请选择此选项并单击继续。系统不会提示您为此收集提供凭据;继续执行步骤 6。
  • 如果您之前已通过身份验证,但希望重新授权并让系统发出新令牌,请单击更改/重新授权并继续执行此步骤。

选择您要使用 Citrix 凭据还是 Citrix Cloud 凭据对上载进行身份验证。单击继续。仅当您不使用存储的令牌时才会显示凭据页面。

在凭据页面上:

  • 如果要使用代理服务器进行文件上载,请单击配置代理。您可以指示 Scout 使用为浏览器的 Internet 属性配置的代理设置,也可以输入代理服务器的 IP 地址和端口号。关闭代理对话框。
  • 对于 Citrix Cloud 帐户,请单击生成令牌。您的默认浏览器将启动并打开显示令牌的 Citrix Cloud 页面。请将令牌复制并粘贴到 Scout 页面中。
  • 对于 Citrix 帐户,请输入您的凭据。

完成后,请单击继续

步骤 6. 提供有关上载的信息。

输入上载详细信息:

  • 名称字段包含将包含所收集诊断信息的文件的默认名称。尽管您可以更改该名称,但这对于大多数收集来说应该足够了。(如果您删除默认名称,并使名称字段留空,系统将使用默认名称。)
  • (可选)指定 8 位数的 Citrix 支持案例号。
  • 在可选的说明字段中,描述问题并指示问题的发生时间(如果适用)。

完成时,单击开始上载

在上载期间,页面左下部分显示已完成的上载百分比近似值。要取消正在进行的上载,请单击停止上载

上载完成时,将显示其位置的 URL 并提供链接。您可以访问该链接前往 Citrix 位置查看上载的分析情况,也可以复制该链接。

单击完成返回 Scout 的打开页面。

跟踪和重现

跟踪和重现过程包括选择计算机、在这些计算机上开始跟踪、在这些计算机上重现问题、完成诊断信息收集以及将包含跟踪和收集信息的文件上载到 Citrix 或将其保存在本地。

此过程与标准收集过程类似。但是,您可以在计算机上开始跟踪,然后在这些计算机上重现问题。所有诊断信息收集包括 AOT 信息;此过程会添加 CDF 跟踪以帮助进行故障排除。

步骤 1. 启动 Scout。

从计算机的“开始”菜单依次选择:Citrix > Citrix Scout。在打开的页面上,单击跟踪和重现

步骤 2. 选择计算机。

“选择计算机”页面上列出站点中的所有 VDA 和 Controller。可以按计算机名称过滤显示内容。选中要从中收集跟踪和诊断信息的每台计算机旁边的复选框,然后单击继续

Scout 会在选择的每台计算机上启动验证测试,确保计算机满足验证测试中所列的条件。如果某台计算机的验证失败,将在状态列中发布一条消息,且取消选中该计算机的复选框。您可以执行下列操作之一:

  • 解决问题,然后重新选中相应计算机的复选框。这将触发重试验证测试。
  • 跳过相应的计算机(让其复选框处于取消选中状态)。系统将不会从该计算机收集诊断和跟踪信息。

验证测试完成后,单击继续

步骤 3. 跟踪。

摘要中列出将从中收集跟踪信息的所有计算机。单击 Start Tracing(开始跟踪)。

在一台或多台选定的计算机上,重现遇到的问题。在您执行该操作时,跟踪收集操作继续进行。完成问题重现后,在 Scout 中单击继续。这将停止跟踪。

停止跟踪后,请指示是否在跟踪期间重现了问题。

步骤 4. 从计算机收集诊断信息。

单击开始收集

在收集期间:

  • 状态列指示计算机的当前收集状态。
  • 要停止单台计算机上正在进行的收集,请在该计算机对应的“操作”列中单击取消
  • 要停止所有正在进行的收集,请单击页面右下角的停止收集。系统 会保留已完成收集的计算机的诊断信息。要恢复收集,请在每台计算机对应的“操作”列中单击重试
  • 完成所有选定计算机的收集时,右下角的停止收集按钮将变为继续
  • 如果某台计算机的收集已成功,而您要重新从该计算机收集诊断信息,请在该计算机的“操作”列中单击重新收集。较新的收集信息将覆盖较早的收集信息。
  • 如果收集失败,可以在“操作”列中单击重试。仅成功完成的收集信息会上载或保存。
  • 完成所有选定计算机的收集后,请勿单击返回按钮。如果单击该按钮并确认提示,收集信息将会丢失。

收集完成时,单击继续

步骤 5. 保存或上载收集信息。

选择是将包含所收集诊断信息的文件上载到 Citrix,还是将其保存在本地计算机上。

如果选择立即上载该文件,请继续执行步骤 6。

如果选择在本地保存该文件:

  • 此时将显示 Windows 保存对话框。选择所需位置。
  • 完成本地保存时,将显示文件的路径名并提供链接。您可以查看该文件。谨记:您可以在以后从 Citrix 上载该文件;请参阅 CTX136396 了解 Citrix Insight Services,或参阅 Citrix Smart Tools

单击完成返回 Scout 的打开页面。在此过程中,不需要完成任何进一步的步骤。

步骤 6. 为上载验证身份及(可选)指定代理。

有关此过程的详细信息,请查看上载授权

  • 如果您之前没有通过 Scout 进行身份验证,请继续执行此步骤。
  • 如果您之前已通过 Scout 完成身份验证,默认使用存储的授权令牌。如果您没有问题,请选择此选项并单击继续。系统不会提示您为此收集提供凭据;继续执行步骤 7。
  • 如果您之前已通过身份验证,但希望重新授权并让系统发出新令牌,请单击更改/重新授权并继续执行此步骤。

选择您要使用 Citrix 凭据还是 Citrix Cloud 凭据对上载进行身份验证。单击继续。仅当您不使用存储的令牌时才会显示凭据页面。

在凭据页面上:

  • 如果要使用代理服务器进行文件上载,请单击配置代理。您可以指示 Scout 使用为浏览器的 Internet 属性配置的代理设置,也可以输入代理服务器的 IP 地址和端口号。关闭代理对话框。
  • 对于 Citrix Cloud 帐户,请单击生成令牌。您的默认浏览器将启动并打开显示令牌的 Citrix Cloud 页面。请将令牌复制并粘贴到 Scout 页面中。
  • 对于 Citrix 帐户,请输入您的凭据。

完成后,请单击继续

步骤 7. 提供有关上载的信息。

输入上载详细信息:

  • 名称字段包含将包含所收集诊断信息的文件的默认名称。尽管您可以更改该名称,但这对于大多数收集来说应该足够了。(如果您删除默认名称,并使名称字段留空,系统将使用默认名称。)
  • (可选)指定 8 位数的 Citrix 支持案例号。
  • 在可选的说明字段中,描述问题并指示问题的发生时间(如果适用)。

完成时,单击开始上载

在上载期间,页面左下部分显示已完成的上载百分比近似值。要取消正在进行的上载,请单击停止上载

上载完成时,将显示其位置的 URL 并提供链接。您可以访问该链接前往 Citrix 位置查看上载的分析情况,也可以复制该链接。

单击完成返回 Scout 的打开页面。

计划收集

计划过程包括选择计算机以及设置或取消计划。计划的收集信息会自动上载到 Citrix。(您可以使用 PowerShell 界面在本地保存计划的收集信息。请参阅 Citrix Call Home。)

步骤 1. 启动 Scout。

从计算机的“开始”菜单依次选择:Citrix > Citrix Scout。在打开的页面上,单击计划

步骤 2. 选择计算机。

“选择计算机”页面上列出站点中的所有 VDA 和 Controller。可以按计算机名称过滤显示内容。

使用图形界面安装 VDA 和 Controller 时,系统曾让您选择是否参与 Call Home。有关详细信息,请参阅 Citrix Call Home。(Call Home 具有相当于 Scout 的计划功能。)默认情况下,Scout 显示这些设置。可以使用此版本的 Scout 首次开始计划的收集,也可以更改以前配置的计划。

请注意,尽管您基于每台计算机启用/禁用了 Citrix Call Home,在 Scout 中设置计划时使用相同命令,却会影响选择的所有计算机。

选中要从中收集诊断信息的每台计算机旁边的复选框,然后单击继续

Scout 会在选择的每台计算机上启动验证测试,确保计算机满足验证测试中所列的条件。如果某台计算机的验证失败,将在状态列中发布一条消息,且取消选中该计算机的复选框。您可以执行下列操作之一:

  • 解决问题,然后重新选中相应计算机的复选框。这将触发重试验证测试。
  • 跳过相应的计算机(让其复选框处于取消选中状态)。将不会从该计算机收集诊断(或跟踪)信息。

验证测试完成后,单击继续

摘要页面上列出将应用计划的计算机。单击继续

步骤 3. 设置计划。

指示要何时收集诊断信息。谨记:计划会影响所有选定计算机。

  • 要为选定计算机配置每周计划,请单击每周。选择星期几,并输入开始收集诊断信息的一天中的时间(24 小时制)。
  • 要为选定计算机配置每天计划,请单击每天。输入开始收集诊断信息的一天中的时间(24 小时制)。
  • 要为选定计算机取消现有计划(且不替换为其他计划),请单击关闭。这将取消之前为这些计算机配置的任何计划。

单击继续

步骤 4. 为上载验证身份及(可选)指定代理。

有关此过程的详细信息,请查看上载授权。谨记:使用 Scout 计划时,不能使用存储的令牌进行身份验证。

选择您要使用 Citrix 凭据还是 Citrix Cloud 凭据对上载进行身份验证。单击继续

在凭据页面上:

  • 如果要使用代理服务器进行文件上载,请单击配置代理。您可以指示 Scout 使用为浏览器的 Internet 属性配置的代理设置,也可以输入代理服务器的 IP 地址和端口号。关闭代理对话框。
  • 对于 Citrix Cloud 帐户,请单击生成令牌。您的默认浏览器将启动并打开显示令牌的 Citrix Cloud 页面。请将令牌复制并粘贴到 Scout 页面中。
  • 对于 Citrix 帐户,请输入您的凭据。

完成后,请单击继续

查看配置的计划。单击完成返回 Scout 的打开页面。

进行每个计划的收集时,每个选定计算机的 Windows 应用程序日志都会包含有关收集和上载的条目。

Citrix Scout