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