NetScaler 遥测程序

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

您可以使用以下方式上传所需的遥测数据：

自动收集模式 - 升级到 14.1 25.56 或更高版本 / 13.1-53.22 或更高版本 版本后默认启用此模式。自动模式创建一个出站连接以使用自动启用的通道（端点 URL）并自动上传遥测数据。您只需确保端点 URL 可访问。由于上传是自动进行的，因此除非先决条件不满足，否则您无需采取任何行动。有关更多信息，请参阅自动收集模式。
手动收集模式 - 仅当自动模式被禁用时才启用此模式。您必须从本地 NetScaler 控制台中的 NetScaler 遥测主页下载所需的遥测数据，并在 30 天内完成首次上传到 NetScaler 控制台服务。后续上传必须每 90 天进行一次才能保持合规。有关更多信息，请参阅手动收集模式。

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

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

作为 NetScaler 遥测程序的一部分，以下配置被推送到托管 NetScaler 实例：

AppFlow 配置： 启用 ns 功能 AppFlow
遥测指标配置文件配置： 添加分析配置文件 telemetry_metrics_profile -type timeseries -outputMode prometheus -metrics ENABLED -serveMode Pull -schemaFile "./telemetry_collect_ns_metrics_schema.json" -metricsExportFrequency 300

笔记：

为了实现最佳遥测收集效果，我们建议您升级到最新的 NetScaler 控制台版本。

从 14.1-43.x / 13.1-57.x 版本开始，如果您的 NetScaler 实例中存在遥测指标配置文件配置，NetScaler Console 会将其删除。删除遥测指标配置文件配置不会影响 NetScaler 实例中的任何现有功能。
如果您没有使用 NetScaler 或 NetScaler 控制台分析功能，则可以使用以下命令删除 AppFlow 配置：

禁用 ns 功能 AppFlow

下表提供了有关最新版本和早期版本中的 AppFlow 和遥测指标配置文件配置的详细信息：

建造	作为遥测程序的一部分推送的配置	遥测模式	需要采取的行动
14.1-43.x / 13.1-57.x	不	自动和手动	配置不会推送到 NetScaler 实例，并且如果存在遥测指标配置文件配置，则会从 NetScaler 实例中删除。如果您没有使用 NetScaler 或 NetScaler 控制台分析功能，您可以使用 `禁用 ns 功能 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 配置。
14.1-25.56 / 13.1-53.22	是的。 AppFlow 和遥测指标配置文件	自动（不满足任何先决条件）或手动	如果缺少这些配置，NetScaler 控制台会每 24 小时继续检查这些配置，并将其推送到 NetScaler 实例。如果您不想推送配置，则必须处于自动模式（满足所有先决条件）或升级到最新版本。

笔记：

/nsconfig/.telemetry.conf 文件使用以下命令进行更新，以用于网关遥测。 NetScaler 控制台每小时检查一次此命令，如果缺少此命令则添加：
ns_telemetry_server，<Console IP>，5140

一些遥测参数是通过从 NetScaler 控制台推送到 NetScaler 实例的脚本收集的。这些脚本是只读的，不会改变 NetScaler 中的任何内容。

通过遥测收集的信息（例如电子邮件地址、用户名和 IP 地址）通过使用单向散列算法在源头对信息进行散列，实现安全的假名化。因此，Citrix 无法访问或读取这些值。此遥测数据仅用于逻辑资产匹配目的。

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

类别	描述	我们用它做什么？	必需/可选
许可证以及 NetScaler 部署和使用情况遥测	有关许可证授权、分配、使用情况和高级 NetScaler 部署数据以及 NetScaler 功能使用情况的信息。	许可证合规性以及管理、衡量和改进服务。	必需的
NetScaler 控制台部署和功能使用情况遥测	有关控制台部署和功能使用的信息。	管理、衡量和改进服务。	选修的

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

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 License Telemetry FAQ。