思杰 Scout

简介

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

• 在本地部署中，从 Delivery Controller™ 运行 Scout 以捕获诊断信息或对一个或多个 Virtual Delivery Agent (VDA)、Delivery Controller、StoreFront 服务器、Federated Authentication Service (FAS) 服务器和许可证服务器运行检查。您也可以从 VDA 运行 Scout 以收集本地诊断信息。
  注意：
  目前，Scout 不支持在 FAS 服务器上诊断 FAS 配置问题的健康检查。

• 在使用了 Citrix DaaS（以前称为 Citrix Virtual Apps and Desktops™ 服务）的 Citrix Cloud 环境中，从 VDA 运行 Scout 以收集本地诊断信息。

收集了什么

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

• 跟踪信息在收集时会进行压缩，以减小在计算机上的占用空间。
• 在每台计算机上，Citrix Telemetry Service 最多保留八天的压缩近期跟踪信息。
• 从 Citrix Virtual Apps and Desktops 7 1808 开始，AOT 跟踪默认保存到本地磁盘。（在早期版本中，跟踪保存在内存中。）默认路径 = C:\ProgramData\Citrix\TelemetryService\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。有关详细信息，请参阅 cmdlet 的 Microsoft 帮助。
• 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 配置 以调整端口。
  • 网络连接正常工作。（这可能包括验证您的防火墙是否已正确配置。）

版本兼容性

安装和升级

上传授权

查找计算机

• Scout 必须在 StoreFront 计算机本身上运行。在“收集”、“跟踪和重现”和“计划”过程中，在 Delivery Controller 上运行 Scout 不会发现 StoreFront 服务器组的成员。
• 该计算机上必须存在 Citrix.StoreFront PowerShell 模块。
• 仅当服务器组包含多个服务器时，才会发现其他 StoreFront 服务器。在单服务器部署中，仅列出本地服务器。

手动添加计算机

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

导入 VDA 计算机

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

收集诊断信息

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

跟踪和重现

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

启用附加日志收集

• Procdump 日志：下载 Procdump 并将其放置在 %ProgramData%\Citrix\TelemetryService\CDC\Lib\Resources\Tools\Procdump\procdump.exe
• StoreFront 日志：下载 DbgView 并将其放置在 %ProgramData%\Citrix\TelemetryService\CDC\Lib\Resources\Tools\DebugView\Dbgview.exe
• Procmon 日志：下载 Process Monitor 并将其放置在 %ProgramData%\Citrix\TelemetryService\CDC\Lib\Resources\Tools\ProcessMonitor\Procmon.exe
• Wireshark 日志：在您的系统上手动安装 Wireshark。

1. 在 Scout 主页上，单击“跟踪和重现”。
2. 在“选择或添加计算机”页面上，勾选本地计算机的复选框以从该页面收集数据。状态必须显示为 已验证。
3. 选中“使用 Citrix 数据收集工具启用其他日志收集”复选框以启用其他日志收集。
4. 单击“上传控制文件”按钮以加载一个 CTL 文件。此按钮允许您在 AOT 收集列表中添加其他 GUID，以便使用 Scout 进行 AOT 收集。
5. 单击“继续”并按照 跟踪和重现 说明进行操作。
6. 完成后，检查 zip 文件中的日志。日志已压缩到 CDCLogs 文件夹中。
   

安排收集

1. 启动 Scout。从计算机的“开始”菜单中，选择“Citrix > Citrix Scout”。在打开的页面上，单击“计划”。
2. 选择计算机。站点中的所有 VDA 和控制器都已列出。您可以按计算机名称筛选显示。
   在 StoreFront 上，“选择计算机”页面列出了本地计算机以及同一 StoreFront 服务器组中自动发现的任何其他服务器。要包含自动发现组之外的服务器，请参阅手动添加计算机。
   使用图形界面安装 VDA 和 Controller 时，如果设置了 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 应用程序日志都包含有关收集和上传的条目。

数据屏蔽

使用情况数据收集

Scout 功能的命令行界面

• 帮助
• 收集诊断信息
• 启动跟踪
• 停止跟踪
• 列出正在进行的跟踪会话
• 启动和停止 CDC