思杰探查器
引言部分
Citrix Scout 收集诊断信息，这些信息可用于 XenApp 和 XenDesktop® 部署中的主动维护。Citrix 通过 Citrix Insight Services 提供全面、自动化的分析。您还可以使用 Scout 自行或在 Citrix 支持的指导下排查问题。您可以将收集文件上传到 Citrix 以进行分析并获得 Citrix 支持的指导。或者，您可以将收集文件保存到本地以供自行查看，然后稍后将收集文件上传到 Citrix 进行分析。
Scout 提供三个主要过程：
- 收集： 在您在站点中选择的计算机上运行一次性诊断信息收集。然后，您可以将包含收集信息的文件上传到 Citrix 或将其保存到本地。
- 跟踪和重现： 在您选择的计算机上启动手动跟踪。然后，您在这些计算机上重现问题。重现问题后，跟踪将停止。然后，Scout 收集其他诊断信息，并将包含跟踪和收集信息的文件上传到 Citrix，或将其保存到本地。
- 计划： 计划在您选择的计算机上每天或每周的指定时间进行诊断信息收集。包含每个收集信息的文件将自动上传到 Citrix。
本文中描述的图形界面是使用 Scout 的主要方式。或者，您可以使用 PowerShell 界面配置一次性或计划的诊断信息收集和上传。请参阅 Call Home。
运行 Scout 的位置：
- 在本地 XenApp 和 XenDesktop 部署中，从 Delivery Controller™ 运行 Scout 以从一个或多个虚拟投递代理 (VDA) 和 Delivery Controller 捕获诊断信息。您还可以从 VDA 运行 Scout 以收集本地诊断信息。
- 在使用了 Citrix Cloud™ 环境中 XenApp 和 XenDesktop 服务的环境中，从 VDA 运行 Scout 以收集本地诊断信息。
收集的内容
Scout 收集的诊断信息包括 Citrix Diagnostic Facility (CDF) 跟踪日志文件。还包括称为 Always-on Tracing (AOT) 的 CDF 跟踪子集。AOT 信息在排查常见问题（例如 VDA 注册和应用程序/桌面启动）时会很有帮助。不收集其他 Event Tracing for Windows (ETW) 信息。
收集的信息包括：
- Registry entries created by XenApp and XenDesktop under HKEY_LOCAL_MACHINE\SOFTWARE\CITRIX.
- Citrix 命名空间下的 Windows 管理规范 (WMI) 信息。
- 正在运行的进程。
- Crash dumps of Citrix processes that are stored in %PROGRAM DATA%\Citrix\CDF.
关于跟踪信息：
- 跟踪信息在收集时会进行压缩，以保持在计算机上的占用空间较小。
- 在每台计算机上，Citrix Telemetry Service 最多保留 10 MB 压缩的最新跟踪信息，最长保留时间为八天。
- 跟踪信息保存在内存中，以避免对预配计算机造成 IOPs 影响。
- 跟踪缓冲区使用循环机制在内存中保留跟踪信息。
有关 Scout 收集的数据点的列表，请参阅 Scout 关键数据点。
先决条件和注意事项
访问权限
- 您必须是您从中收集诊断信息的每台计算机的本地管理员和域用户。
- 您必须拥有在每台计算机上写入 LocalAppData 目录的权限。
- 启动 Scout 时，请使用 以管理员身份运行。
对于您从中收集诊断信息的每台计算机：
- Scout 必须能够与计算机通信。
- 必须启用文件和打印机共享。
- 必须启用 PSRemoting 和 WinRM。计算机还必须运行 PowerShell 3.0 或更高版本。
- Citrix 遥测服务必须在计算机上运行。
- 要设置诊断收集计划，计算机必须运行 XenApp and XenDesktop 7.14 或更高支持版本提供的 Scout 版本。
Scout 会对您选择的计算机运行验证测试，以确保满足这些要求。
验证性测试
在诊断收集开始之前，将为每台选定的计算机自动运行验证测试。这些测试可确保满足上述要求。如果某台计算机的测试失败，Scout 将显示一条消息，其中包含建议的纠正措施。
| 错误消息 | 纠正性措施 |
|---|---|
| Scout 无法访问此计算机 | 确保计算机已开机。确保网络连接正常工作。（这可能包括验证您的防火墙是否已正确配置。）确保文件和打印机共享已打开。有关说明，请参阅 Microsoft 文档。 |
| Enable PSRemoting and WinRM | 您可以同时启用 PowerShell 远程处理和 WinRM。使用“以管理员身份运行”，运行 Enable-PSRemoting cmdlet。有关详细信息，请参阅该 cmdlet 的 Microsoft 帮助。 |
| Scout requires PowerShell 3.0 (minimum) | 在计算机上安装 PowerShell 3.0（或更高版本），然后启用 PowerShell 远程处理。 |
| 无法访问此计算机上的 LocalAppData 目录 | 确保帐户具有向计算机上的 LocalAppData 目录写入的权限。 |
| 无法找到 Citrix 遥测服务 | 确保 Citrix 遥测服务已安装并在计算机上启动。 |
| 无法获取计划 | 将计算机升级到至少虚拟应用和虚拟桌面 7.14 版本。 |
版本间的兼容性
此版本 Scout (3.x) 要求在 XenApp 和 XenDesktop 7.14（最低版本）的控制器和 VDA 上运行。
早期版本的 Scout 随早期 XenApp and XenDesktop 部署提供。有关该早期版本的信息，请参阅 CTX130147。
如果您将早于 7.14 版本的控制器或 VDA 升级到 7.14 版（或更高支持版本），则早期版本的 Scout 将替换为当前版本。
| 功能 | 思科特 2.23 | 思科特 3.0 |
|---|---|---|
| Support XenApp and XenDesktop 7.14 (minimum) | 是 | 是 |
| 提供对 XenDesktop 5.x 版本以及 7.1 至 7.13 版本的支持 | 是 | 否 |
| 支持 XenApp 6.x 版本，以及 XenApp 7.5 至 7.13 版本 | 是 | 否 |
| 随产品一同交付 | 7.1 到 7.13 | 从 7.14 开始 |
| 可从 CTX 文章下载 | 是 | 否 |
| 捕获 CDF 跟踪 | 是 | 是 |
| 捕获始终开启的跟踪 (AOT) | 否 | 是 |
| 允许诊断数据的收集 | 一次最多 10 台计算机（默认） | 无限制（取决于资源可用性） |
| 允许将诊断数据发送到 Citrix | 是 | 是 |
| 允许将诊断数据保存到本地 | 是 | 是 |
| 支持 思杰云 凭据 | 否 | 是 |
| 支持 Citrix 凭据 | 是 | 是 |
| 支持代理服务器上传 | 是 | 是 |
| 调整计划 | 不适用 | 是 |
| 脚本支持 | 命令行（仅限本地控制器） | 使用 Call Home cmdlet 的 PowerShell（任何安装了遥测功能的计算机） |
安装
默认情况下，当您安装 VDA 或 Controller 时，Scout 会作为 Citrix 遥测服务的一部分自动安装。
如果您在安装 VDA 时省略了 思杰遥测服务，或稍后删除了该服务，请从 XenApp 或 XenDesktop ISO 上的 x64\虚拟桌面组件 或 x86\虚拟桌面组件 文件夹运行 TelemetryServiceInstaller_xx.msi。
上传授权许可
如果您计划将诊断集合上传到 Citrix，则必须拥有 Citrix 或 Citrix Cloud 帐户。（这些是您用于访问 Citrix 下载或访问 Citrix Cloud Control Center 的凭据。）验证您的帐户凭据后，将颁发一个令牌。
- 如果您使用 Citrix 帐户进行身份验证，则令牌颁发过程不可见。您只需输入您的帐户凭据。Citrix 验证凭据后，您就可以在 Scout 向导中继续操作。
- 如果您使用 Citrix Cloud 帐户进行身份验证，则单击链接以使用默认浏览器通过 HTTPS 访问 Citrix Cloud。输入您的 Citrix Cloud 凭据后，将显示令牌。复制令牌，然后将其粘贴到 Scout 中。然后，您就可以在 Scout 向导中继续操作。
该令牌存储在运行 Scout 的计算机本地。如果您希望下次选择收集或跟踪和重现时使用该令牌，请选中存储令牌并在将来跳过此步骤复选框。
每次在 Scout 启动页面上选择计划时，都必须重新授权。创建或更改计划时不能使用存储的令牌。
使用代理进行上传
如果您想使用代理服务器将集合上传到 Citrix，可以指示 Scout 使用为浏览器 Internet 属性配置的代理设置，也可以指定代理服务器的 IP 地址和端口号。
收集诊断信息
收集过程包括选择计算机、启动诊断信息收集，然后将包含收集信息的文件上传到 Citrix 或将其保存到本地。
步骤 1. 启动 Scout。
从计算机的“开始”菜单中：Citrix > Citrix Scout。在启动页面上，单击收集。
步骤 2. 选择计算机。
“选择计算机”页面列出了站点中的所有 VDA 和控制器。您可以按计算机名称筛选显示。选择要从中收集诊断信息的每台计算机旁边的复选框，然后单击继续。
Scout 会自动对您选择的每台计算机启动验证测试，确保其符合(/zh-cn/xenapp-and-xendesktop/7-15-ltsr/manage-deployment/cis/scout.html)中列出的条件。如果验证失败，则会在“状态”列中发布一条消息，并且该计算机的复选框将取消选中。您可以选择：
- 解决问题，然后再次选中该计算机的复选框。这将触发验证测试的重试。
- 跳过该计算机（使其复选框保持未选中状态）。将不会从该计算机收集诊断信息。
验证测试完成后，单击继续。
步骤 3. 从计算机收集诊断信息。
摘要列出了将从中收集诊断信息的所有计算机（您选择的通过验证测试的计算机）。单击开始收集。
收集期间：
- “状态”列指示计算机的当前收集状态。
- 要停止单台计算机上正在进行的收集，请单击该计算机的“操作”列中的取消。
- 要停止所有正在进行的收集，请单击页面右下角的停止收集。已完成收集的计算机的诊断信息将保留。要恢复收集，请单击每台计算机的“操作”列中的重试。
- 当所有选定计算机的收集完成后，右下角的停止收集按钮将变为继续。
- 如果计算机的收集成功，并且您想再次从该计算机收集诊断信息，请单击该计算机的“操作”列中的再次收集。较新的收集将覆盖较早的收集。
- 如果收集失败，您可以单击“操作”列中的重试。只有成功的收集才会上传或保存。
- 所有选定计算机的收集完成后，请勿单击返回。如果您单击该按钮并确认提示，则收集将丢失。
当收集完成后，点击 继续。
步骤 4. 保存或上传收集的数据。
选择是将包含所收集诊断信息的文件上传到 Citrix，还是将其保存到本地计算机。
如果您选择现在上传文件，请继续执行步骤 5。
如果您选择将文件保存到本地：
- 将出现一个 Windows 保存对话框。导航到所需位置。
- 本地保存完成后，将显示并链接文件的路径名。您可以查看该文件。您可以稍后从 Citrix 上传该文件；有关 Citrix Insight Services，请参阅 CTX136396，或参阅 Smart Tools support。
点击 完成 返回 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 和控制器。您可以按计算机名称筛选显示。选中要从中收集跟踪和诊断信息的每台计算机旁边的复选框，然后单击继续。
Scout 会对您选择的每台计算机启动验证测试，确保其符合 (/zh-cn/xenapp-and-xendesktop/7-15-ltsr/manage-deployment/cis/scout.html) 中列出的条件。如果某台计算机的验证失败，则“状态”列中会显示一条消息，并且该计算机的复选框将取消选中。您可以选择：
- 解决问题，然后再次选中该计算机的复选框。这将触发验证测试的重试。
- 跳过该计算机（保持其复选框未选中）。将不会从该计算机收集诊断信息和跟踪。
验证测试完成后，单击继续。
步骤 3. 跟踪。
摘要列出了将从中收集跟踪的所有计算机。单击开始跟踪。
在一台或多台选定的计算机上，重现您遇到的问题。在您执行此操作时，跟踪收集会继续。重现问题完成后，在 Scout 中单击继续。这将停止跟踪。
停止跟踪后，请指明您是否在跟踪期间重现了问题。
步骤 4. 从计算机收集诊断信息。
单击开始收集。
收集期间：
- “状态”列指示计算机当前的收集状态。
- 要停止单个计算机上正在进行的收集，请在该计算机的“操作”列中单击“取消”。
- 要停止所有正在进行的收集，请单击页面右下角的“停止收集”。已完成收集的计算机的诊断信息将保留。要恢复收集，请在每台计算机的“操作”列中单击“重试”。
- 当所有选定计算机的收集完成后，右下角的“停止收集”按钮将变为“继续”。
- 如果计算机的收集成功，并且您想再次从该计算机收集诊断信息，请在该计算机的“操作”列中单击“再次收集”。较新的收集将覆盖较早的收集。
- 如果收集失败，您可以在“操作”列中单击“重试”。只有成功的收集才会被上传或保存。
- 所有选定计算机的收集完成后，请勿单击“返回”按钮。如果单击该按钮并确认提示，则收集将丢失。
收集完成后，单击“继续”。
步骤 5. 保存或上传收集。
选择是将包含所收集诊断信息的文件上传到 Citrix，还是将其保存在本地计算机上。
如果您选择立即上传文件，请继续执行步骤 6。
如果您选择在本地保存文件：
- 将出现一个 Windows“保存”对话框。选择所需位置。
- 本地保存完成后，将显示并链接文件的路径名。您可以查看该文件。请记住：您可以稍后从 Citrix 上传文件；有关 Citrix Insight Services，请参阅 CTX136396，或参阅 Citrix Smart Tools。
点击“完成”返回 Scout 启动页面。您无需完成此过程中的任何其他步骤。
步骤 6. 验证上传并可选地指定代理。
查看上传授权了解此过程的详细信息。
- 如果您之前未通过 Scout 进行身份验证，请继续执行此步骤。
- 如果您之前已通过 Scout 进行身份验证，则默认使用存储的授权令牌。如果您同意，请选择此选项并点击“继续”。系统不会提示您输入此集合的凭据；请继续执行步骤 7。
- 如果您之前已进行身份验证，但想要重新授权并颁发新令牌，请点击“更改/重新授权”并继续执行此步骤。
选择您是要使用 Citrix 凭据还是 Citrix Cloud 凭据来验证上传。点击“继续”。凭据页面仅在您未使用存储的令牌时显示。
在凭据页面上：
- 如果要使用代理服务器进行文件上传，请点击“配置代理”。您可以指示 Scout 使用为浏览器 Internet 属性配置的代理设置，也可以输入代理服务器的 IP 地址和端口号。关闭代理对话框。
- 对于 Citrix Cloud 帐户，点击“生成令牌”。您的默认浏览器将启动到 Citrix Cloud 页面，其中显示一个令牌。复制令牌，然后将其粘贴到 Scout 页面上。
- 对于 Citrix 帐户，输入您的凭据。
完成后，点击“继续”。
步骤 7. 提供有关上传的信息。
输入上传详细信息：
- 名称字段包含将包含所收集诊断信息的文件默认名称。这对于大多数集合来说应该足够了，尽管您可以更改名称。（如果您删除默认名称并使名称字段为空，则将使用默认名称。）
- （可选）指定一个 8 位数的 Citrix 支持案例编号。
- 在可选的“描述”字段中，描述问题并指明问题发生的时间（如果适用）。
完成后，单击 Start Upload（开始上传）。
上传期间，页面左下角会显示上传完成的大致百分比。要取消正在进行的上传，请单击 Stop Upload（停止上传）。
上传完成后，将显示并链接其位置的 URL。您可以按照链接转到 Citrix 位置以查看上传分析，也可以复制该链接。
单击 Done（完成）返回 Scout 启动页面。
安排数据收集
计划过程包括选择计算机，然后设置或取消计划。计划的收集会自动上传到 Citrix。（您可以使用 PowerShell 界面在本地保存计划的收集。请参阅 Citrix Call Home。）
步骤 1. 启动 Scout。
从计算机的“开始”菜单中：Citrix > Citrix Scout。在启动页面上，单击 Schedule（计划）。
步骤 2. 选择计算机。
“选择计算机”页面列出了站点中的所有 VDA 和控制器。您可以按计算机名称筛选显示。
当您使用图形界面安装 VDA 和控制器时，系统会提供参与 Call Home 的机会。有关详细信息，请参阅 Citrix Call Home。（Call Home 包含与 Scout 等效的计划功能。）Scout 默认显示这些设置。您可以使用此版本的 Scout 首次启动计划的收集，或更改以前配置的计划。
请记住，尽管您是按每台计算机启用/禁用 Call Home，但在 Scout 中设置计划会使用相同的命令，但会影响您选择的所有计算机。
选中要从中收集诊断信息的每台计算机旁边的复选框，然后单击 Continue（继续）。
Scout 会对您选择的每台计算机启动验证测试，确保其符合 (/zh-cn/xenapp-and-xendesktop/7-15-ltsr/manage-deployment/cis/scout.html) 中列出的条件。如果某台计算机的验证失败，则会在“状态”列中发布一条消息，并且该计算机的复选框将取消选中。您可以选择以下任一操作：
- 解决问题，然后再次选中该计算机的复选框。这将触发验证测试的重试。
- 跳过该计算机（保持其复选框未选中）。将不会从该计算机收集诊断信息（或跟踪）。
验证测试完成后，单击 继续。
摘要页面列出了将应用计划的计算机。单击 继续。
步骤 3. 设置计划。
指示您希望何时收集诊断信息。请记住：该计划会影响所有选定的计算机。
- 要为选定的计算机配置每周计划，请单击 每周。选择星期几并输入诊断信息收集开始的时间（24 小时制）。
- 要为选定的计算机配置每日计划，请单击 每日。输入诊断信息收集开始的时间（24 小时制）。
- 要取消选定计算机的现有计划（且不替换为其他计划），请单击 关闭。这将取消之前为这些计算机配置的任何计划。
单击 继续。
步骤 4. 验证上传并可选地指定代理。
查看 (/zh-cn/xenapp-and-xendesktop/7-15-ltsr/manage-deployment/cis/scout.html) 以了解此过程的详细信息。请记住：在使用 Scout 计划时，您不能使用存储的令牌进行身份验证。
选择您是要使用 Citrix 凭据还是 Citrix Cloud 凭据来验证上传。单击 继续。
在凭据页面上：
- 如果您想使用代理服务器进行文件上传，请单击“配置代理”。您可以指示 Scout 使用为浏览器 Internet 属性配置的代理设置，或者您可以输入代理服务器的 IP 地址和端口号。关闭代理对话框。
- 对于 Citrix Cloud 帐户，请单击“生成令牌”。您的默认浏览器将启动到 Citrix Cloud 页面，其中显示一个令牌。复制该令牌，然后将其粘贴到 Scout 页面上。
- 对于 Citrix 帐户，请输入您的凭据。
完成后，单击“继续”。
查看已配置的计划。单击“完成”返回 Scout 启动页面。
每次计划收集发生时，每台选定计算机的 Windows 应用程序日志都包含有关收集和上传的条目。