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 应用程序日志都会包含有关收集和上载的条目。