思杰 Scout

简介

• 收集： 对您在站点中选择的计算机运行一次性诊断收集。然后，您可以将文件上传到 Citrix 或将其保存在本地。
• 跟踪和重现： 在您选择的计算机上启动手动跟踪。然后，您在这些计算机上重现问题。重现问题后，跟踪将停止。Scout 然后收集其他诊断信息并将文件上传到 Citrix，或将文件保存在本地。
• 计划： 计划在您选择的计算机上每天或每周在指定时间进行诊断收集。文件会自动上传到 Citrix。
• 运行状况检查： 运行检查以评估站点及其组件的运行状况和可用性。您可以对 Delivery Controller、Virtual Delivery Agent (VDA)、StoreFront™ 服务器和 Citrix 许可证服务器运行运行状况检查。如果在检查期间发现问题，Scout 会提供详细报告。每次 Scout 启动时，它都会检查更新的运行状况检查脚本。如果有新版本可用，Scout 会自动下载它们，以便在下次运行运行状况检查时使用。

• 在本地部署中，从 Delivery Controller™ 运行 Scout 以捕获诊断信息或对一个或多个 Virtual Delivery Agent (VDA)、Delivery Controller、StoreFront 服务器和许可证服务器运行检查。您还可以从 VDA 运行 Scout 以收集本地诊断信息。
• 在使用 Citrix DaaS（以前称为 Citrix Virtual Apps and Desktops 服务）的 Citrix Cloud 环境中，从 VDA 运行 Scout 以收集本地诊断信息。

收集了哪些信息

• Citrix Virtual Apps and Desktops 在 HKEY_LOCAL_MACHINE\SOFTWARE\Citrix 下创建的注册表项。
• Citrix 命名空间下的 Windows 管理规范 (WMI) 信息。
• 正在运行的进程。
• 存储在 %PROGRAMDATA%\Citrix\CDF 中的 Citrix 进程的崩溃转储。
• Citrix 策略信息，采用 CSV 格式。
• 安装和升级信息。收集内容可包括完整的产品元安装程序日志、失败的 MSI 日志、MSI 日志分析器的输出、StoreFront 日志、许可兼容性检查日志以及初步站点升级测试的结果。

• 跟踪信息在收集时会进行压缩，以保持在计算机上的占用空间较小。
• 在每台计算机上，Citrix Telemetry Service 最多保留八天的压缩近期跟踪信息。
• 从 Citrix Virtual Apps and Desktops 7 1808 开始，AOT 跟踪默认保存到本地磁盘。（在早期版本中，跟踪保存在内存中。）默认路径 = C:\Users\CitrixTelemetryService\AppData\Local\CitrixAOT。
• 从 Citrix Virtual Apps and Desktops 7 1811 开始，保存到网络共享的 AOT 跟踪会与其他诊断信息一起收集。
• 您可以使用 Enable-CitrixTrace cmdlet 或 HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Telemetry DefaultListen 注册表字符串修改最大大小（默认值 = 10 MB）和切片持续时间。
• 跟踪会追加到文件中，直到文件达到 MaxSize 的 10%。

Scout 配置

1. 导航到 C:\Program Files\Citrix\Telemetry Service
2. 打开 ScoutUI.exe.config 文件。
3. 将 LinuxVDATelemetryServicePort 或 LinuxVDATelemetryWakeupPort 的值更改为在 Linux VDA 上配置的值：

• <add key="LinuxVDATelemetryServicePort" value="7502"/>
• <add key="LinuxVDATelemetryWakeupPort" value="7503"/>

1. 保存更改并关闭文件。
2. 再次打开 Scout 以确保它加载最新配置。

关于运行状况检查

运行运行状况检查

1. 启动 Scout。从计算机的“开始”菜单中，选择“Citrix > Citrix Scout”。在打开的页面上，单击“运行状况检查”。
2. 选择计算机。单击“查找计算机”以发现计算机。“选择计算机”页面列出了在此站点中发现的所有 VDA、Delivery Controller 和许可证服务器。您可以按计算机名称筛选显示。选中要从中收集诊断信息的每台计算机旁边的复选框，然后单击“继续”。
   要添加其他组件类型（例如 StoreFront 服务器和 VDA 计算机），请参阅 手动添加计算机 和 导入 VDA 计算机。您无法手动添加 Citrix Provisioning™ 服务器或许可证服务器。
   Scout 会自动在每台选定的计算机上启动验证测试，确保其符合 验证测试 中列出的条件。如果验证失败，则会在“状态”列中发布一条消息，并且该计算机的复选框将被清除。您可以：
   • 解决问题，然后再次选中该计算机的复选框。这将触发验证测试的重试。
   • 跳过该计算机（取消选中其复选框）。不会对该计算机运行运行状况检查。
   验证测试完成后，单击“继续”。
3. 对选定的计算机运行运行状况检查。摘要列出了运行测试的计算机（您选择的通过验证测试的计算机）。单击“开始检查”。
   检查期间和检查之后：
   • “状态”列指示计算机的当前检查状态。
   • 要停止所有正在进行的检查，请单击页面右下角的“停止检查”。（您无法取消单个计算机的运行状况检查，只能取消所有选定计算机的运行状况检查。已完成检查的计算机的信息将保留。）.
   • 当所有选定计算机的检查完成后，右下角的“停止检查”按钮将变为“完成”。
   • 如果检查失败，可以单击“操作”列中的“重试”。
   • 如果检查完成且未发现任何问题，则“操作”列为空。
   • 如果检查发现问题，请单击“查看详细信息”以显示结果。
   • 所有选定计算机的检查完成后，请勿单击“返回”。（如果单击，检查结果将丢失。）
4. 检查完成后，单击“完成”返回 Scout 启动页面。

权限和要求

• 要收集诊断信息：
  • 对于要从中收集诊断信息的每台计算机，您必须是本地管理员和域用户。
  • 您必须具有在每台计算机的 LocalAppData 目录中写入的权限。
• 要运行运行状况检查：
  • 您必须是域用户组的成员。
  • 您必须是完全管理员，或者具有对站点具有只读和 运行环境测试 权限的自定义角色。
  • 将脚本执行策略设置为至少 RemoteSigned 以允许脚本运行。例如：Set-ExecutionPolicy RemoteSigned。注意： 其他脚本执行权限也可以。
• 启动 Scout 时使用 以管理员身份运行。

• Scout 必须能够与计算机通信。
• 必须启用文件和打印机共享。
• 必须启用 PSRemoting 和 WinRM。计算机还必须运行 PowerShell 3.0 或更高版本。
• 计算机上必须运行 Citrix Telemetry Service。
• 计算机上必须启用 Windows Management Infrastructure (WMI) 访问。
• 要设置诊断信息收集计划，计算机必须运行 兼容的 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（最低版本）。
• WMI 未在计算机上运行 - 确保已启用 Windows Management Instrumentation (WMI) 访问。
• WMI 连接被阻止 - 在 Windows 防火墙服务中启用 WMI。
• 需要更高版本的 Citrix Telemetry Service - （仅针对“收集”和“跟踪与重现”检查版本。）升级计算机上的 Telemetry Service 版本（请参阅 安装和升级）。如果您不升级该服务，则该计算机将不包括在收集或跟踪与重现操作中。
• Scout 无法连接到此计算机上的 systemd 套接字 - 请确保：
  • 端口 7503 已打开。验证 systemd ctxtelemetry.socket 是否正在计算机上的端口 7503 上侦听。如果 ctxtelemetry.socket 端口已更改，则端口可能不同。请参阅 Scout 配置 以调整端口。
  • 网络连接正常工作。（这可能包括验证您的防火墙是否已正确配置。）
• Linux VDA 遥测服务未在此计算机上启动 - 确保：
  • 端口 7502 已打开。验证 Linux VDA 遥测服务是否已安装并在此计算机上启动。如果遥测服务端口已更改，则端口可能不同。请参阅Scout 配置 以调整端口。
  • 网络连接正常工作。（这可能包括验证您的防火墙是否已正确配置。）

版本兼容性

安装和升级

上传授权

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

查找计算机

手动添加计算机

• 域中的 Citrix 许可证服务器会自动发现。您无法手动添加许可证服务器。
• 运行状况检查目前不支持 Citrix Provisioning 服务器。

导入 VDA 计算机

1. 在 Delivery Controller 或 Connector 上，使用 PowerShell 命令生成计算机列表文件。在 Connector 上，您必须输入 Citrix 凭据并在弹出对话框中选择客户。
   Get-BrokerMachine| foreach { $_.DnsName } | out-file C:\machineList.txt
2. 将 machineList.txt 文件复制到您要启动 Scout Health Check 的已加入域的计算机。
3. 在 Scout Health Check 页面上，单击 添加计算机。
4. 选择 Windows VDA 计算机类型。
5. 单击 导入 VDA 计算机。
6. 选择 machineList.txt 文件。
7. 单击 打开。

收集诊断信息

1. 启动 Scout。从计算机的 开始 菜单中，选择 Citrix > Citrix Scout。在打开的页面上，单击 收集。
2. 选择计算机。
   • 在 Controller 上，选择计算机 页面列出了站点中的所有 VDA 和 Controller。您可以按计算机名称筛选显示。要手动添加其他计算机（例如 StoreFront 或 Citrix Provisioning 服务器），请参阅 手动添加计算机。
   • 在其他组件（例如 VDA 服务器）上，选择计算机 页面仅列出本地计算机。不支持手动添加计算机。
   选择要从中收集诊断信息的每台计算机旁边的复选框，然后单击“继续”。
   Scout 会自动在每台选定的计算机上启动验证测试，确保其符合 (#verification-tests) 中列出的条件。如果验证失败，状态列中会显示一条消息，并且该计算机的复选框将被取消选中。您可以选择：
   • 解决问题，然后再次选中该计算机的复选框。这将触发验证测试的重试。
   • 跳过该计算机（使其复选框保持未选中状态）。将不会从该计算机收集诊断信息。
   验证测试完成后，单击“继续”。
3. 收集诊断信息。摘要列出了所有已收集诊断信息的计算机（您选择并通过验证测试的计算机）。单击“开始收集”。
   收集期间：
   • 状态列指示计算机的当前收集状态。
   • 要停止单个计算机上正在进行的收集，请在该计算机的操作列中单击“取消”。
   • 要停止所有正在进行的收集，请单击页面右下角的“停止收集”。已完成收集的计算机的诊断信息将保留。要恢复收集，请在每台计算机的操作列中单击“重试”。
   • 当所有选定计算机的收集完成后，右下角的“停止收集”按钮将变为“继续”。
   • 要再次收集诊断信息，请在该计算机的操作列中单击“再次收集”。较新的收集会覆盖较早的收集。
   • 如果收集失败，您可以在操作列中单击“重试”。只有成功的收集才会上传或保存。
   • 所有选定计算机的收集完成后，请勿单击“返回”。（如果单击，收集将丢失。）
   收集完成后，单击“继续”。
4. 保存或上传收集的数据。选择是将文件上传到 Citrix，还是将其保存到本地计算机。
   如果您选择立即上传文件，请继续执行步骤 5。
   如果您选择将文件保存到本地：
   • 将显示 Windows 保存对话框。导航到所需位置。
   • 本地保存完成后，将显示文件的路径名并提供链接。您可以查看该文件。您可以稍后将文件上传到 Citrix。请参阅 CTX136396。
   单击 Done 返回 Scout 启动页面。您无需完成此过程中的任何其他步骤。
5. 对上传进行身份验证，并可选择指定代理。有关详细信息，请参阅 上传授权。
   • 如果您尚未通过 Scout 进行身份验证，请继续执行此步骤。
   • 如果您已通过 Scout 进行身份验证，则默认使用存储的授权令牌。如果这是您想要执行的操作，请选择此选项并单击 Continue。系统不会提示您输入此收集的凭据。继续执行步骤 6。
   • 如果您之前已进行身份验证，但想要重新授权并获取新令牌，请单击 Change/Reauthorize 并继续执行此步骤。
   选择是使用 Citrix 凭据还是 Citrix Cloud 凭据来验证上传。单击 Continue。凭据页面仅在您未使用存储的令牌时显示。
   在凭据页面上：
   • 如果要为文件上传使用代理服务器，请单击 Configure proxy。您可以指示 Scout 使用为浏览器 Internet 属性配置的代理设置。或者，您可以输入代理服务器的 IP 地址和端口号。关闭代理对话框。
   • 对于 Citrix Cloud 帐户，请单击 Generate token。您的默认浏览器将启动到 Citrix Cloud 页面，其中显示一个令牌。复制令牌，然后将其粘贴到 Scout 页面上。
   • 对于 Citrix 帐户，请输入您的凭据。
   完成后，点击“继续”。
6. 输入有关上传的信息。
   • 名称字段包含所收集诊断文件的默认名称。这对于大多数收集来说已足够，尽管您可以更改名称。（如果删除默认名称并使名称字段为空，则将使用默认名称。）
   • （可选）指定一个 8 位数的 Citrix 支持案例编号。
   • 在可选的“描述”字段中，描述问题并指明问题发生的时间（如果适用）。
   完成后，点击“开始上传”。
   上传期间，页面左下角会显示已完成上传的近似百分比。要取消正在进行的上传，请点击“停止上传”。
   上传完成后，将显示其位置的 URL 并提供链接。您可以点击该链接转到 Citrix 位置以查看上传分析，也可以复制该链接。
   点击“完成”返回 Scout 启动页面。

跟踪和重现

1. 启动 Scout。从计算机的“开始”菜单中，选择“Citrix > Citrix Scout”。在启动页面上，点击“跟踪和重现”。
2. 选择计算机。“选择计算机”页面列出了站点中的所有 VDA 和控制器。您可以按计算机名称筛选显示。选中要从中收集跟踪和诊断的每台计算机旁边的复选框。然后点击“继续”。
   要手动添加其他计算机（例如 StoreFront 或 Citrix Provisioning 服务器），请参阅手动添加计算机。
   Scout 会自动在每台选定的计算机上启动验证测试，确保它符合 验证测试 中列出的条件。如果某台计算机的验证失败，状态列中会显示一条消息，并且该计算机的复选框会被取消选中。您可以选择：
   • 解决问题，然后再次选中该计算机的复选框。这将触发验证测试的重试。
   • 跳过该计算机（使其复选框保持未选中状态）。不会从该计算机收集诊断信息和跟踪。
   验证测试完成后，单击继续。
3. 启动跟踪。摘要列出了所有从中收集跟踪的计算机。单击开始跟踪。
   在一台或多台选定的计算机上，重现您遇到的问题。在此过程中，跟踪收集会继续。重现问题后，在 Scout 中单击继续。这将停止跟踪。
   停止跟踪后，指示您是否在跟踪期间重现了问题。
4. 从计算机收集诊断信息。单击开始收集。收集期间：
   • “状态”列指示计算机的当前收集状态。
   • 要停止单台计算机上正在进行的收集，请在该计算机的操作列中单击取消。
   • 要停止所有正在进行的收集，请单击页面右下角的停止收集。已完成收集的计算机的诊断信息将保留。要恢复收集，请在每台计算机的操作列中单击重试。
   • 当所有选定计算机的收集完成后，右下角的停止收集按钮将变为继续。
   • 要再次从计算机收集诊断信息，请在该计算机的操作列中单击再次收集。新的收集会覆盖之前的收集。
   • 如果收集失败，您可以在操作列中单击重试。只有成功的收集才会上传或保存。
   • 所有选定计算机的收集完成后，请勿单击返回。（如果单击，收集的数据将丢失。）
   收集完成后，点击“继续”。
5. 保存或上传收集。选择是将文件上传到 Citrix 还是本地保存。
   如果您选择现在上传文件，请继续执行步骤 6。
   如果您选择将文件保存到本地：
   • 将出现一个 Windows 保存对话框。选择所需位置。
   • 本地保存完成后，将显示并链接文件的路径名。您可以查看该文件。请记住：您可以稍后从 Citrix 上传文件；有关 Citrix Insight Services，请参阅 CTX136396。
   点击“完成”返回 Scout 启动页面。您无需完成此过程中的任何其他步骤。
6. 对上传进行身份验证并可选地指定代理。有关此过程的详细信息，请查看 上传授权。
   • 如果您尚未通过 Scout 进行身份验证，请继续执行此步骤。
   • 如果您已通过 Scout 进行身份验证，则默认使用存储的授权令牌。如果这是您想要执行的操作，请选择此选项并点击“继续”。系统不会提示您输入此收集的凭据。继续执行步骤 7。
   • 如果您之前已进行身份验证，但想重新授权并获取新令牌，请点击“更改/重新授权”并继续执行此步骤。
   选择您是要使用 Citrix 凭据还是 Citrix Cloud 凭据来验证上传。点击“继续”。凭据页面仅在您未使用存储令牌时显示。
   在凭据页面上：
   • 如果您想为文件上传使用代理服务器，请点击“配置代理”。您可以指示 Scout 使用为浏览器 Internet 属性配置的代理设置。或者，您可以输入代理服务器的 IP 地址和端口号。关闭代理对话框。
   • 对于 Citrix Cloud 帐户，点击“生成令牌”。您的默认浏览器将启动到 Citrix Cloud 页面，其中显示一个令牌。复制该令牌，然后将其粘贴到 Scout 页面上。
   • 对于 Citrix 帐户，输入您的凭据。
   完成后，单击 继续。
7. 提供有关上传的信息。
   输入上传详细信息：
   • 名称字段包含所收集诊断文件的默认名称。这对于大多数收集来说已足够，尽管您可以更改名称。（如果删除默认名称并使名称字段为空，则会使用默认名称。）
   • （可选）指定一个 8 位数的 Citrix 支持案例编号。
   • 在可选的“描述”字段中，描述问题并指明问题发生的时间（如果适用）。
   完成后，单击 开始上传。
   上传期间，页面左下角会显示上传完成的大致百分比。要取消正在进行的上传，请单击 停止上传。
   上传完成后，将显示其位置的 URL 并提供链接。您可以点击该链接前往 Citrix 位置查看上传分析，也可以复制该链接。
   单击 完成 返回 Scout 启动页面。

启用附加日志收集

1. 启动 Citrix Scout。
2. 单击“设置”齿轮图标。
3. 单击“使用更多工具启用附加日志收集”。
4. 单击 保存。

1. 在 Scout 主页上，单击“跟踪和重现”。
2. 在“选择计算机”页面上，单击本地计算机右侧的齿轮图标。
3. 在“选择日志记录所需的工具：”页面上，单击“下载工具”。
4. 在“下载工具”页面上，选择要使用的工具，然后单击“下载”。然后将下载这些工具，Wireshark 除外。Wireshark 只能手动下载和安装。 注意：如果您选择手动下载其他工具，则必须将下载的 .zip 文件的内容提取到 C:\ProgramData\Citrix\TelemetryService\CDC\Lib\Resources\Tools\<toolname>。例如，如果您下载 DebugView.zip 文件，则需要将该文件的内容解压缩到 C:\ProgramData\Citrix\TelemetryService\CDC\Lib\Resources\Tools\DebugView\。
5. 在“选择日志记录所需的工具：”页面上，单击“刷新状态”。所有选定的工具在“状态”列下显示为“存在”。
6. 选择用于日志记录的工具，然后单击“下一步”。
7. 按照跟踪和重现 说明进行操作。
8. 完成后，检查 zip 文件中的日志。日志已压缩到 CDCLogs 文件夹中。

安排收集

1. 启动 Scout。从计算机的“开始”菜单中，选择 Citrix > Citrix Scout。在打开的页面上，单击“计划”。
2. 选择计算机。列出了站点中的所有 VDA 和控制器。您可以按计算机名称筛选显示。
   当您使用图形界面安装 VDA 和控制器时，如果您设置了 Call Home 计划（请参阅 Citrix Call Home），Scout 默认会显示这些设置。您可以使用此版本的 Scout 首次启动计划的收集，或更改以前配置的计划。
   尽管您在组件安装期间按每台计算机启用了/禁用了 Call Home，但在 Scout 中配置的计划会影响您选择的所有计算机。
   选中要从中收集诊断信息的每台计算机旁边的复选框，然后单击“继续”。
   要手动添加其他计算机（例如 StoreFront 或 Citrix Provisioning 服务器），请参阅 手动添加计算机。
   Scout 会自动对每台选定的计算机启动验证测试，确保其符合 验证测试 中的条件。如果某台计算机的验证失败，则会在“状态”列中发布一条消息，并且该计算机的复选框将被取消选中。您可以选择：
   • 解决问题，然后再次选中该计算机的复选框。这将触发验证测试的重试。
   • 跳过该计算机（使其复选框保持未选中状态）。不会从该计算机收集诊断信息（或跟踪）。
   验证测试完成后，单击“继续”。
   摘要页面列出了应用了计划的计算机。单击“继续”。
3. 设置计划。指明您希望何时收集诊断信息。请记住：该计划会影响所有选定的计算机。
   • 要为选定的计算机配置每周计划，请单击“每周”。选择星期几。输入收集开始的时间（24 小时制）。
   • 要为选定的计算机配置每日计划，请单击“每日”。输入收集开始的时间（24 小时制）。
   • 要取消所选计算机的现有计划（而不是替换为另一个计划），请单击“关闭”。这将取消之前为这些计算机配置的任何计划。
   单击“继续”。
4. 对上传进行身份验证，并可选择指定代理。有关此过程的详细信息，请查看上传授权。请记住：在使用 Scout 计划时，不能使用存储的令牌进行身份验证。
   选择是使用 Citrix 凭据还是 Citrix Cloud 凭据来验证上传。单击“继续”。
   在凭据页面上：
   • 如果要使用代理服务器进行文件上传，请单击“配置代理”。您可以指示 Scout 使用为浏览器 Internet 属性配置的代理设置。或者，您可以输入代理服务器的 IP 地址和端口号。关闭代理对话框。
   • 对于 Citrix Cloud 帐户，请单击“生成令牌”。您的默认浏览器将启动到 Citrix Cloud 页面，其中显示一个令牌。复制该令牌，然后将其粘贴到 Scout 页面上。
   • 对于 Citrix 帐户，请输入您的凭据。
   完成后，单击“继续”。
   查看已配置的计划。单击“完成”返回 Scout 启动页面。
   在收集过程中，每台选定计算机的 Windows 应用程序日志都包含有关收集和上传的条目。

数据屏蔽

使用情况数据收集