产品文档
Citrix Analytics
查看 PDF

Citrix Virtual Apps and Desktops™ 数据源

September 16, 2025
投稿者: 
C C

本文介绍了如何使用 StoreFront 将本地 Citrix Virtual Apps and Desktops 站点连接到 Citrix Analytics 的步骤。本文中提及的载入步骤适用于以下两种产品/服务：Citrix Analytics for Performance（性能分析）和 Citrix Analytics for Security（安全分析）。

有关每种产品/服务特定的载入步骤，请参阅以下文章：

使用 StoreFront 载入 Citrix Virtual Apps™ and Desktops 本地站点

如果您的组织使用本地 StoreFront™ 部署，则必须配置 StoreFront 服务器，以便 Citrix Workspace™ 应用程序能够将事件发送到 Citrix Analytics。Citrix Analytics 处理事件，以提供有关 Citrix IT 基础架构性能和用户行为的可操作见解。

有关如何为 Citrix Analytics 配置 StoreFront 部署的更多信息，请参阅 StoreFront 文档中的 Citrix Analytics 服务一文。

以前，使用 Citrix Apps and Desktops 本地站点的客户必须使用站点聚合才能载入 Citrix Analytics for Security™ 和 Performance 的本地站点。

您现在可以载入 Citrix Apps and Desktops 本地站点，而无需依赖站点聚合。

您可以在工作区应用程序中看到“连接 StoreFront 部署”选项，即使您没有将任何站点添加到站点聚合中。

Connect StoreFront deployment

先决条件

开始之前，请确保以下各项：

  • 您的 StoreFront 版本必须为 1906 或更高版本。

  • StoreFront 部署必须能够连接到以下地址：

  • StoreFront 部署必须打开端口 443 以进行出站 Internet 连接。网络上的任何代理服务器都必须允许此通信与 Citrix Analytics 进行。

  • 如果 StoreFront 部署托管在使用 Web 代理连接到 Internet 的 Web 服务器上，则必须手动配置每个应用商店的代理以允许出站流量。StoreFront 不会自动使用主机 Web 服务器的代理设置。有关详细信息，请参阅 配置托管在使用 HTTP 代理的 Web 服务器上的 StoreFront 部署。

  • 必须使用以下客户端之一访问 StoreFront 部署：

    • 适用于 HTML5 兼容浏览器中的网站的 Citrix Receiver™。

      注意

      如果您是 HTML5 用户，在 StoreFront 上启用某些配置后，Citrix Virtual Apps and Desktops 可以启动事件。有关配置步骤的信息，请参阅 Citrix Workspace 应用程序 for HTML5 文档中的 安装一文。对于与打印相关的事件，必须在 StoreFront 上配置额外的策略。有关详细信息，请参阅 Citrix Workspace 应用程序 for HTML5 文档中的 PDF 打印一文。

    • 适用于 Windows 的 Citrix Workspace 应用程序 1907 或更高版本。

    • 适用于 Linux 的 Citrix Workspace 应用程序 2006 或更高版本。

    • 适用于 Mac 的 Citrix Workspace 应用程序 2006 或更高版本

  • 如果您使用的是 Citrix Virtual Apps and Desktops 7 1912 LTSR，则支持的 StoreFront 版本为 1912。

连接到 StoreFront 部署

您可以通过以下方式连接到 StoreFront 部署：

  • 使用“应用程序和桌面 – Workspace 应用程序”站点卡和“应用程序和桌面 – 监视”站点卡

  • 使用“建议”面板

使用“应用程序和桌面 – Workspace 应用程序”站点卡和“应用程序和桌面 – 监视”站点卡进行连接

  1. 导航到“设置 > 数据源 > 安全”。在“应用程序和桌面 - Workspace 应用程序”站点卡上，单击垂直省略号 (⋮)，然后选择“连接 StoreFront 部署”。

    Connect store security

  2. 导航到“设置 > 数据源 > 性能”。在“应用程序和桌面 - 监视”站点卡上，单击垂直省略号 (⋮)，然后选择“连接 StoreFront 部署”。

    Connect stores performance

    StoreFront 载入向导或“连接 StoreFront 部署”弹出窗口随即显示。

  3. 单击“下载软件包”。

    StoreFront Onboarding wizard

    注意

    该文件包含敏感信息。请将文件保存在安全的位置。

  4. 要配置 StoreFront 部署，请执行以下操作：

    1. 将安装软件包复制到 StoreFront 服务器。

    2. 解压缩复制的文件，然后导航到 PowerShell 中的文件夹。

    3. 您必须以管理员身份运行以下命令才能载入 StoreFront：

      .\Manage-CitrixAnalytics.ps1 –param OnboardStorefront
<!--NeedCopy-->

      StoreFront admin mode

      有关更多选项或参数，请参阅 PowerShell 脚本部分。

    4. 打开 StoreFront 服务器并执行 PowerShell 脚本。

    5. 如果运行 OnboardStorefront 后 StoreFront 站点仍未显示在 Citrix Analytics Service GUI 中，请运行 iisreset 命令。

    6. 登录到 Citrix Analytics Service GUI，并验证群集 ID 是否与脚本在控制台中记录的群集 ID 匹配。

    7. 配置完成后，登录到 Citrix Analytics 以查看连接的 StoreFront 部署。

  5. 配置成功后，单击“完成”。

  6. 单击“启用数据处理”以允许 Citrix Analytics 处理数据。

PowerShell 脚本

已引入新的 PowerShell 脚本，以简化 StoreFront 载入 Citrix Analytics Service 的过程。此 PowerShell 脚本可自动执行先决条件检查、安装和配置 StoreFront 的过程。PowerShell 脚本需要以管理员模式运行。

StoreFront admin mode

客户可以在 StoreFront 上执行此 PowerShell 脚本，以载入、取消载入、执行自检、故障排除以及验证载入 Citrix Analytics Service GUI 是否成功。当客户首次执行该脚本时，将显示一条安全警告消息以确认发布者。如果发布者受信任，请选择“始终运行”选项。

PowerShell scripts always run

PowerShell 脚本位于“连接 StoreFront 部署”页面上的 zip 文件中，其中包含 StoreFrontConfiguration.json 文件、一些 CCAuth 和 dll 文件。PowerShell 脚本日志保存在“下载”文件夹下的 cas-logs 文件中。

PowerShell 脚本支持以下参数：

  • SelfCheck：SelfCheck 参数用于验证是否已满足 StoreFront 载入的先决条件。它会检查 StoreFront 安装、所需版本、出站连接、cURL Analytics 服务器网络连接、Internet 连接、服务器组配置以及任何现有的 Citrix Analytics Service 配置。使用以下命令运行 selfcheck：

     .\Manage-CitrixAnalytics.ps1 –param SelfCheck
 <!--NeedCopy-->

  • OnboardStorefront：OnboardStoreFront 参数会快速执行自检，以验证 Citrix Analytics Service 配置的设置就绪情况。如果设置已就绪，它将导入 Citrix Analytics Service 配置，并将更改发布到服务器组中的其他服务器。对于服务器组，PublishConfiguration 命令会自动从脚本运行，以将 StoreFront 配置发布到该 StoreFront 中的所有服务器。您会看到一个弹出窗口，要求确认 PublishConfiguration 操作。选择“全部是”按钮。

    PowerShell script yes to all

    配置发布成功完成后，脚本会调用 Citrix Analytics Service API，以检查 StoreFront 是否已载入 Citrix Analytics Service GUI。要调用此 API，需要私钥进行身份验证。要生成此私钥，您需要 CCAuth 和 dll 文件以及下载的 JSON 文件中提供的凭据。

    注意

    StoreFront 载入过程完成后，StoreFront 可能需要两到五分钟才能显示在 Citrix Analytics Service GUI 中。如果 StoreFront 站点未显示在 Citrix Analytics Service GUI 中，则必须执行 IISRESET 以重置 Internet 信息服务。

    使用以下命令运行 OnboardStoreFront：

     .\Manage-CitrixAnalytics.ps1 –param OnboardStorefront
 <!--NeedCopy-->

  • IsOnboarded：IsOnboarded 参数用于验证 StoreFront 是否已载入 Citrix Analytics Service GUI。脚本会等待一分钟后退出，但是，StoreFront 在成功载入后可能需要长达五分钟才能显示在 GUI 中。您必须运行此命令进行验证。此命令还具有 CCAuth 和 dll 文件依赖项。使用以下命令运行 IsOnboarded：

     .\Manage-CitrixAnalytics.ps1 –param IsOnboarded
 <!--NeedCopy-->

  • Troubleshoot：等待五分钟后，如果 StoreFront 站点仍未显示在 Citrix Analytics Service GUI 中，则必须执行 IISRESET 以重置 Internet 信息服务。如果 StoreFront 站点仍未显示在 GUI 中，请使用 Troubleshoot 参数。它可帮助您排查任何连接问题并收集日志。使用以下命令运行 Troubleshoot：

     .\Manage-CitrixAnalytics.ps1 –param TroubleShoot
 <!--NeedCopy-->

    故障排除参数适用于以下两种用例：

    • 用例 1：作为自检的一部分，如果 curlAnalytics 失败，则会创建防火墙规则。此防火墙规则会打开 443 端口并验证其与 Analytics 的连接。如果未连接，则表示 Analytics 服务器不可访问，脚本将在此处退出。在与 Citrix Analytics Service 的连接恢复后，重新运行脚本。

    • 用例 2：如果 cURL 运行正常，但 StoreFront 站点仍未反映在 GUI 中，则管理员必须从 下载 DebugView 下载 DebugView 工具 zip 文件，解压缩，并将其放置在“下载”文件夹下。PowerShell 脚本首先卸载 Citrix Analytics Service（如果已配置）。它会启用详细日志记录。然后，它会启动 DebugView 工具并重新安装 Citrix Analytics Service。最后，它会停止 DebugView 并禁用详细日志记录。

    可以捕获调试视图日志并与 Citrix 支持部门共享。Citrix 管理员会进一步调试并尝试找出问题并解决。日志将生成并保存为 DebugView 文件夹中的日志文件。

    您需要与 Citrix 管理员共享以下三个日志文件：

    • DebugView 日志文件 (Downloads\DebugView\log)
    • StoreFront 日志文件 (C:\Program Files\Citrix\Receiver StoreFront\Admin\trace)
    • CAS 日志文件。这些日志是脚本执行的一部分，并保存在“下载 > cas-logs”文件夹下。

    对于服务器组，当脚本尝试取消载入或载入 StoreFront 时，PublishConfiguration 命令会自动运行。PublishConfiguration 命令有助于将 StoreFront 配置发布到该 StoreFront 中的所有服务器。您会看到一个弹出窗口，要求确认此操作。选择“全部是”按钮。

    PowerShell script yes to all

  • DeboardStoreFront：DeboardStoreFront 参数用于从 Citrix Analytics Service 取消载入 StoreFront 服务器。使用以下命令运行 DeboardStoreFront：

     .\Manage-CitrixAnalytics.ps1 –param DeboardStoreFront
 <!--NeedCopy-->

    PowerShell 脚本首先从 StoreFront 中删除所有 Citrix Analytics Service 配置，并验证删除是否成功。然后，它会检查 ServerGroup 是否存在，然后发布配置，以便将删除的配置发布到所有 StoreFront。最后，它会调用 DeleteSiteOnboarded。如果站点未从 Citrix Analytics Service GUI 中删除，则需要手动删除 StoreFront 部署中的 StoreFront 站点以及 StoreFront 部署下的 Workspace 应用程序站点卡中的站点。

    对于服务器组，PublishConfiguration 命令会自动从脚本运行，以将 StoreFront 配置发布到该 StoreFront 中的所有服务器。您会看到一个弹出窗口，要求确认此操作。选择“全部是”按钮。

    PowerShell script yes to all

使用“建议”面板进行连接

“数据源”页面上的“建议”面板向用户介绍了载入数据源的重要性。它可帮助用户轻松载入数据源，并提供一个选项供用户查看并确保已载入所有可用数据源。

  1. 如果您使用的是 Security Analytics 产品/服务，请选择“设置 > 数据源 > 安全”。

  2. 如果您使用的是 Performance Analytics 产品/服务，请导航到“设置 > 数据源 > 性能”。

  3. 在“数据源”页面上，查看“建议”面板上的信息和建议，以载入 StoreFront 部署。

    Review Recommendations Panel

    注意

    载入 StoreFront 数据源可使 Workspace 应用程序将有关端点可见性的遥测数据发送到 Analytics。

  4. 单击“开始载入”。“指定已部署的 StoreFront 实例”页面随即显示。

    Specify Storefront INstances

  5. 为确保 Analytics 成功载入数据源，请指定“已部署的 StoreFront 实例总数”。

    注意：

    “已部署的 StoreFront 实例总数”是 StoreFront 组的总数，而不是单个 StoreFront 服务器的数量。

  6. 单击“继续”。StoreFront 载入向导或“连接 StoreFront 部署”弹出窗口随即显示。

  7. 在“连接 StoreFront 部署”页面上，单击“下载软件包”以下载安装软件包。

    StoreFront Onboarding wizard

    注意

    该文件包含敏感信息。请将文件保存在安全的位置。

    您只能下载一个软件包并使用它载入一个 StoreFront 组。如果您有多个 StoreFront 组，则必须为每个 StoreFront 组单独下载软件包。一个 StoreFront 组使用一个软件包完成载入后，请再次下载软件包并继续载入下一个 StoreFront 组。

    如果由于某些问题，StoreFront 载入未在两天内使用一个软件包正确完成，则必须在两天后重新下载新软件包。因为如果未在两天内成功载入，软件包中的密钥将过期。

  8. 要配置 StoreFront 部署，请执行以下操作：

    1. 将安装软件包复制到 StoreFront 服务器。

    2. 解压缩复制的文件，然后导航到 PowerShell 中的文件夹。

    3. 运行以下命令以载入 StoreFront：

      .\Manage-CitrixAnalytics.ps1 –param OnboardStorefront
<!--NeedCopy-->

    4. 打开 StoreFront 服务器并执行 PowerShell 脚本。

    5. 如果 StoreFront 站点未显示在 Citrix Analytics Service GUI 中，请运行以下命令：

      Execute iisreset
<!--NeedCopy-->

    6. 记录并验证 PowerShell 脚本中提供的群集 ID。

    7. 配置完成后，登录到 Citrix Analytics 以查看连接的 StoreFront 部署。

  9. 配置成功后，单击“完成”。

如果您通过“建议”面板进行载入，系统会获取您已载入 Citrix Analytics Service 的 StoreFront 部署数量。“建议”面板随即显示，您可以查看已载入的 StoreFront 部署。您可以查看“建议”面板中的消息，然后单击“标记为完成”。

注意

“建议”面板和消息仅在所有声明的 StoreFront 部署都已载入时才会消失。

  1. 单击“启用数据处理”以允许 Citrix Analytics 处理数据。

查看“建议”面板

您可以在“建议”面板中比较声明的 StoreFront 部署数量与已载入的 StoreFront 部署数量。

如果声明的 StoreFront 部署数量与已载入的 StoreFront 部署数量相同，则会显示“全部已载入”消息，指示所有 StoreFront 部署均已载入。您可以查看“建议”面板中的消息，然后单击“标记为完成”。

注意

如果要载入更多 StoreFront 部署，请单击“查看载入步骤”，StoreFront 载入向导或“连接 StoreFront 部署”弹出窗口将再次显示。

Review Onboarded StoreFront Instances

如果声明的 StoreFront 部署数量少于已载入的 StoreFront 部署数量，请单击“编辑计数”，“指定已部署的 StoreFront 实例”页面随即显示。然后，您可以输入“已部署的 StoreFront 实例总数”，然后单击“继续”。StoreFront 载入向导或“连接 StoreFront 部署”弹出窗口将再次显示。按照步骤载入更多 StoreFront 部署。

注意：

“已部署的 StoreFront 实例总数”是 StoreFront 组的总数，而不是单个 StoreFront 服务器的数量。

Complete StoreFront Onboarding

查看已连接的 StoreFront 部署

StoreFront 部署仅在配置成功后才会显示在站点卡上。站点卡显示有多少 StoreFront 部署已与 Citrix Analytics 建立连接。

  • 如果您使用的是 Performance Analytics 产品/服务，您会在“应用程序和桌面 - 监视”站点卡上看到以下信息：

    Performance Analytics View store

  • 如果您使用的是 Security Analytics 产品/服务，您会在“Workspace 应用程序”站点卡上看到以下信息：

    View stores

单击站点卡上的 StoreFront 部署数量以查看服务器组。

每个 StoreFront 部署都由一个基本 URL 和一个 ServerGroupID 表示。

StoreFront group

如果您使用的是 Security Analytics 产品/服务，站点卡还会显示有关接收到的事件的以下信息：

  • 过去一小时内从 StoreFront 部署接收到的事件，这是默认时间选择。您还可以选择 1 周 (1 W) 并查看数据。单击接收到的事件数量以在 自助服务搜索页面上查看事件。

    Security Analytics received events

  • 启用数据处理后，站点卡可能会显示“未接收到数据”状态。此状态出现的原因有两个：

    1. 如果您是首次启用数据处理，事件需要一些时间才能到达 Citrix Analytics 中的事件中心。当 Citrix Analytics 收到事件时，状态会更改为“数据处理已启用”。如果一段时间后状态未更改，请刷新“数据源”页面。

    2. Citrix Analytics 在过去一小时内未从数据源接收到任何事件。

      No virtual data apps

添加或删除 StoreFront 部署

要添加 StoreFront 部署，请在“StoreFront 部署”部分中单击“连接到 StoreFront 部署”。下载配置文件并按照步骤配置 StoreFront 部署。

Add stores

要停止从已配置的 StoreFront 部署传输事件并将其从 Citrix Analytics 中删除，请执行以下操作：

  1. 转到要从 Citrix Analytics 中删除的 StoreFront 部署。运行以下命令以从 StoreFront 服务器中删除配置设置：

    Remove-STFCasConfiguration
<!--NeedCopy-->

  2. 如果您使用的是多服务器部署，请运行以下命令以传播更改并从 StoreFront 服务器组中的所有服务器中删除配置设置：

    Publish-STFServerGroupConfiguration
<!--NeedCopy-->

  3. 运行以下命令以验证配置设置是否已成功删除。如果设置已成功删除，则该命令不返回任何内容。

    Get-STFCasConfiguration
<!--NeedCopy-->

  4. 重新登录到 Citrix Analytics，然后在“StoreFront 部署”部分中选择 StoreFront 部署。单击垂直省略号 (⋮)，然后选择“从 Analytics 中删除 StoreFront 部署”。

    Remove store

    注意

    在从 Citrix Analytics 中删除 StoreFront 部署之前，请在该部署上运行指定的命令。如果您未能运行这些命令，Citrix Analytics 将继续接收事件，并且 StoreFront 部署将在下一个事件池化周期再次添加。

配置托管在使用 HTTP 代理的 Web 服务器上的 StoreFront 部署

如果 StoreFront 托管在使用 Web 代理连接到 Internet 的 Web 服务器上，则必须手动配置应用商店才能向 Citrix Analytics 注册。此配置要求您将 <system.net> 部分添加到应用商店的 web.config 文件中。您必须配置 StoreFront 部署中将事件发送到 Citrix Analytics 的每个应用商店。

您可以通过两种方法将 <system.net> 部分添加到应用商店的 web.config 文件中：

  • 通过 PowerShell 为一个或多个应用商店设置应用商店代理配置（推荐方法）。

  • 手动将 <system.net> 部分添加到应用商店的 web.config 文件中。

有关这些方法的更多信息，请参阅 StoreFront 文档中的 配置 StoreFront 以使用 Web 代理联系 Citrix Cloud 并向 Citrix Analytics 注册一文。

Citrix Virtual Apps and Desktops™ 数据源
September 16, 2025
投稿者: 
C C
September 16, 2025
投稿者: 
C C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.