Application Delivery Management

NetScaler® 遥测程序

Citrix 会出于其合法利益(包括许可证合规性)收集基本的许可证遥测数据以及 NetScaler 部署和功能使用遥测数据。您可以自动或手动上传所需的许可证和功能使用数据,以符合此处所述的 NetScaler 遥测程序要求。Citrix 还会收集 NetScaler Console 配置和功能使用数据,以管理、衡量和改进 Citrix 产品和服务。如果您是现有的 NetScaler Console 客户,则必须确保符合 NetScaler 遥测程序的要求。我们强烈建议将 NetScaler 实例添加到 NetScaler Console,以全面改进和简化 NetScaler 操作,并通过发送 NetScaler 功能使用数据来支持我们产品和服务的增强。了解更多

您可以通过以下方式上传所需的遥测数据:

  • 自动收集模式 - 升级到 14.1 25.56 或更高版本 / 13.1-53.22 或更高版本的内部版本后,此模式默认启用。自动模式会创建出站连接以使用自动启用的通道(端点 URL),并自动上传遥测数据。只需确保端点 URL 可访问即可。由于上传是自动进行的,因此除非先决条件失败,否则无需执行任何操作。有关更多信息,请参阅自动收集模式

  • 手动收集模式 - 仅当自动模式禁用时,此模式才启用。必须从 NetScaler Console 本地部署中的 NetScaler 遥测主页下载所需的遥测数据,并在 30 天内完成首次上传到 NetScaler Console 服务。后续上传必须每 90 天进行一次,以保持合规性。有关更多信息,请参阅手动收集模式

建议使用自动遥测模式并自动上传所需数据,但也可以选择禁用自动模式并手动上传。在自动和手动模式下,都需要上传数据以符合 NetScaler 遥测程序的要求。可以选择禁用可选遥测数据不包含在数据上传中,但必需的许可证合规性和功能使用遥测数据必须在自动和手动模式下提供。

为保持合规性,自上次成功上传以来的天数不得超过 90 天。

作为 NetScaler 遥测程序的一部分,以下配置已推送到受管 NetScaler 实例:

  • AppFlow 配置:enable ns feature AppFlow

  • 遥测指标配置文件配置:add analytics profile telemetry_metrics_profile -type timeseries -outputMode prometheus -metrics ENABLED -serveMode Pull -schemaFile "./telemetry_collect_ns_metrics_schema.json" -metricsExportFrequency 300

注意:

为了实现最佳遥测数据收集,我们建议升级到最新的 NetScaler Console 内部版本。

  • 14.1-43.x / 13.1-57.x 内部版本开始,如果 NetScaler 实例中存在遥测指标配置文件配置,NetScaler Console 将会将其删除。删除遥测指标配置文件配置不会影响 NetScaler 实例中的任何现有功能。

  • 如果您未使用 NetScaler 或 NetScaler Console 分析功能,可以使用以下命令删除 AppFlow 配置:

    disable ns feature AppFlow

下表提供了最新内部版本和早期内部版本中 AppFlow® 和遥测指标配置文件配置的详细信息:

内部版本 作为遥测程序一部分推送的配置 遥测模式 所需操作
14.1-43.x / 13.1-57.x 自动和手动 配置不会推送到 NetScaler 实例,如果 NetScaler 实例中存在遥测指标配置文件配置,则会将其删除。如果您未使用 NetScaler 或 NetScaler Console 分析功能,可以使用 disable ns feature AppFlow 删除 AppFlow 配置。
14.1-29.x / 13.1-55.x 自动和手动 配置不会作为 NetScaler 遥测程序的一部分进行推送。如果 NetScaler 实例中存在这些配置,并且要删除这些配置,请在 NetScaler 上运行 rm analytics profile telemetry_metrics_profile 命令以删除遥测指标配置文件配置,并使用 disable ns feature AppFlow 删除 AppFlow 配置。
14.1-25.56 / 13.1-53.22
是。AppFlow 和遥测指标配置文件配置
自动(满足所有先决条件) 配置会作为 NetScaler 遥测程序的一部分进行推送,但不会每 24 小时检查一次。要删除这些配置,请在 NetScaler 上运行 rm analytics profile telemetry_metrics_profile 命令以删除遥测指标配置文件配置,并使用 disable ns feature AppFlow 删除 AppFlow 配置。
自动(未满足任何先决条件)或手动 如果缺少这些配置,NetScaler Console 会继续每 24 小时检查一次这些配置并将其推送到 NetScaler 实例。如果不想推送这些配置,则必须处于自动模式(满足所有先决条件)或升级到最新内部版本。

注意:

  • /nsconfig/.telemetry.conf 文件会使用以下命令更新 Gateway 遥测。如果缺少此命令,NetScaler Console 会每小时检查一次并添加它:
ns_telemetry_server,<Console IP>,5140
<!--NeedCopy-->
  • 某些遥测参数是通过从 NetScaler Console 推送到 NetScaler 实例的脚本收集的。这些脚本是只读的,不会更改 NetScaler 中的任何内容。

  • 通过遥测收集的信息(例如电子邮件地址、用户名和 IP 地址)通过使用单向哈希算法在源头对信息进行哈希处理,从而安全地进行假名化。因此,Citrix 无法访问或读取这些值。此遥测数据仅用于逻辑资产匹配目的。

下表提供了作为 NetScaler 遥测程序一部分收集的参数详细信息:

类别 描述 用途 必需/可选
许可证、NetScaler 部署和使用遥测 有关许可证权利、分配、使用、高级 NetScaler 部署数据和 NetScaler 功能使用情况的信息。 许可证合规性以及管理、衡量和改进服务。 必需
NetScaler Console 部署和功能使用遥测 有关 Console 部署和功能使用情况的信息。 管理、衡量和改进服务。 可选

有关可选和必需遥测参数列表的更多信息,请参阅数据治理

Citrix 要求从 2024 年 6 月 18 日起,在 3 个月内过渡到最新的 NetScaler Console 内部版本(14.1 25.56 或更高版本 / 13.1–53.22 或更高版本)。升级到 NetScaler Console 14.1 25.56 或更高版本 / 13.1–53.22 或更高版本后,其中一种遥测模式(自动或手动)必须处于活动运行状态。除非选择手动报告,否则即表示同意根据需要调整防火墙以允许自动遥测报告。

注意事项:

  • 必须确保在 2024 年 9 月 18 日之前过渡到最新内部版本(14.1–25.56 及更高版本 / 13.1–53.22 及更高版本)。

  • 如果选择手动遥测模式,则必须在过渡到上述内部版本后的 30 天内完成首次上传,但不得迟于 2024 年 10 月 18 日。此后,必须每 90 天进行一次手动遥测上传,以使 NetScaler Console 本地部署符合 NetScaler 遥测程序的要求。

Citrix 可能会暂停或终止 Citrix 支持,且不承担任何责任,此外,Citrix 还可能根据法律或衡平法采取任何其他补救措施。这些要求在法律或法规禁止的范围内不适用。有关更多信息,请参阅 Citrix 许可证遥测常见问题解答

NetScaler® 遥测程序