Citrix 许可数据收集程序
-
以下数据收集程序旨在改善您的产品体验、推动采用并收集基本的许可信息：
- Citrix Licensing Call Home - 此程序是可选的。
- Citrix Licensing 客户体验改善计划 (CEIP) - 此程序是可选的。
- Citrix License Server 事件 – 此程序是可选的。
-
Citrix Licensing Telemetry - 此程序是必需的。
- NetScaler® 遥测程序 - 此程序是必需的。
- 适用于 Netscaler Console 服务
- 适用于本地 Netscaler Console
Citrix 按照您与 Citrix 签订的合同条款处理您的数据，并按照 Citrix Trust Center 上提供的 服务安全附录 中的规定保护您的数据。
有关配置代理服务器的信息，请参阅 入门 文章中的“手动配置代理服务器”。
有关命令行安装的信息，请参阅 使用 Windows 命令行安装许可。
Citrix Licensing Call Home
Call Home 程序可改善您的体验，帮助您了解产品使用情况并推动采用，同时改进 Citrix 产品。此程序与 Citrix 共享系统配置、产品配置和使用数据，包括用户或设备数据。
首次上传大约在 License Server 首次启动或重新启动五分钟后进行，后续上传每天进行一次。此程序是可选的。
重要
Citrix Service Provider 程序需要 Call Home。当 License Server 检测到 Citrix Service Provider 许可证时，它会强制执行每日上传。
如果您想向 Citrix Cloud 注册 License Server 或取消注册，请参阅 使用情况和统计信息 中的“向 Citrix Cloud 注册和取消注册”。
您可以随时使用 Citrix Licensing Manager 更改您对这些程序的参与。有关详细信息，请参阅 使用情况和统计信息 下的“共享使用情况统计信息”。
| 收集的数据 | 说明 | 用途 |
|---|---|---|
| 许可证使用数据 | 有关安装在 License Server 上的 Citrix 许可证的信息，包括产品 ID、许可证类型、数量、用户和设备数据，以及许可证使用信息。 | 我们使用此数据来推动采用，并帮助您了解许可证的长期使用情况。 |
-
License Server 部署和配置数据 有关 License Server 及其部署方式的信息，包括 License Server 版本、操作系统版本和配置状态。 我们使用此数据来为 Citrix 产品的进一步开发提供信息，并改善客户体验。
有关 Call Home 数据元素的列表，请参阅 Citrix Licensing Call Home 数据元素。
Citrix Licensing 客户体验改善计划
CEIP 会定期收集系统和产品配置以及不可识别的使用数据。提供此数据有助于 Citrix 改善客户体验。首次上传大约在 License Server 首次启动或重新启动五分钟后进行，后续上传每天进行一次。此程序是可选的。
您可以随时使用 Citrix Licensing Manager 更改您对这些程序的参与。有关详细信息，请参阅 使用情况和统计信息 下的“共享使用情况统计信息”。
| 收集的数据 | 说明 | 用途 |
|---|---|---|
| 许可证使用数据 | 有关安装在 License Server 上的 Citrix 许可证的信息，包括产品 ID、许可证类型和数量，以及许可证使用信息。 | 我们使用此数据来跟踪许可证的消耗方式和客户群。 |
| License Server 部署和配置数据 | 有关 License Server 及其部署方式的信息，包括 License Server 版本、操作系统版本和配置状态。 | 我们使用此数据来为 Citrix 产品的进一步开发提供信息，并改善客户体验。 |
有关 CEIP 数据元素的列表，请参阅 Citrix Licensing CEIP 数据元素。
Citrix License Server 事件数据
下表显示了从 License Server 收集并用于以下目的的数据：
- 在面向客户的仪表板中显示信息
- 提供有关许可证到期、许可证续订和许可证突发模式的警报和通知。
此功能仅在 License Server 注册到 Citrix Cloud 后可用。
| 收集的数据 | 说明 | 用途 |
|---|---|---|
| 许可证使用数据 | 有关安装在 License Server 上的 Citrix 许可证的信息，包括产品 ID、许可证类型和数量，以及许可证使用信息。 | 我们使用此数据来启用有关许可证到期、许可证续订等的警报和通知。 |
| License Server 系统信息 | 有关 License Server 的信息（例如硬件 ID）。 | 我们使用此数据来识别客户环境中的 License Server。 |
有关如何启用或禁用此功能的信息，请参阅 共享使用情况统计信息 部分。
有关许可证服务器事件数据元素的列表，请参阅 Citrix License Server 事件数据元素
Citrix Licensing Telemetry
Citrix Licensing Telemetry 是一个强制性数据收集程序。当 License Server 安装时，数据自动上传功能已启用。
Citrix 许可证服务器会收集并向 Citrix 报告有限的许可证遥测数据，以支持本地部署产品许可证的许可证合规性。对于这些许可证，Citrix 要求您在每个新版本发布后的 6 个月内升级到最新的许可证服务器版本。对于许可证服务器版本 11.17.2 Build 40000 及更高版本，许可证服务器许可证收集和报告（电子或手动）必须处于活动状态。除非您选择手动报告，否则您同意根据需要调整防火墙以允许电子许可证报告。如果您有任何疑问或疑虑，请联系客户服务。如果不遵守这些要求，Citrix 可能会暂停或终止您的 Citrix 支持，且不承担任何责任，此外 Citrix 还可能采取法律或衡平法规定的其他补救措施。这些要求在法律或法规禁止的范围内不适用。有关更多详细信息，请参阅我们的许可证遥测常见问题解答。
重要提示：
为保持合规，自上次成功上传以来的天数不得超过 90 天。
成功上传遥测数据的先决条件：
从许可证服务器出站连接到 https://cis.citrix.com/。如果不可用，请创建所需的防火墙规则或配置代理。
| 收集的数据 | 描述 | 用途 |
|---|---|---|
| 许可证使用数据 | 有关安装在许可证服务器上的 Citrix 许可证的信息，包括产品 ID、许可证类型和数量、用户和设备数据，以及许可证使用信息。 | 我们将此数据用于我们的合法权益，包括许可证合规性。 |
| 许可证服务器系统信息 | 有关许可证服务器的信息（例如硬件 ID） | 我们使用此数据来识别客户环境中的许可证服务器。 |
有关许可证遥测数据元素的列表，请参阅Citrix 许可证遥测数据元素。
报告选项
许可证管理服务使用内置于许可证服务器中的产品遥测功能，定期以电子方式将数据发送到 Citrix。
首次合规性上传在许可证服务器首次启动或重新启动后大约 24 小时进行，此后每天上传一次。如果您重新安装或执行许可证服务器的就地升级，则计划会重置。如果上传失败，将在 24 小时后再次尝试，直到上传成功或许可证管理服务被禁用。
您可以通过禁用许可证管理服务来选择手动报告此数据。有关如何禁用许可证管理服务的详细信息，请参阅使用命令行启用或禁用许可证管理服务。
向 Citrix 报告所需的文件保留在许可证服务器本地，以启用手动上传。您必须使用 Citrix Insight Services 上传此数据。有关使用 Citrix Insight Services 进行手动上传过程的信息，请参阅知识中心文章 - CTX472950。
注意
在 Citrix Insight Services 中，用户可以上传的最大文件大小是有限制的。有关文件上传要求的详细信息，请参阅知识中心文章 - CTX131233。
从 11.17.2 build 45000 开始，选择手动向 Citrix 报告数据的用户必须上传许可证服务器和 Citrix Virtual Apps and Desktops 数据元素。许可证服务器数据元素捆绑在 upload_compliance*.zip 文件中。Citrix Virtual Apps and Desktops 数据元素捆绑在 upload_usage_*.zip 文件中。
您可以在 c:\Program Files (x86)\Citrix\Licensing\LS\resource\usage 找到 upload_compliance*.zip 文件。您可以将所有 upload_compliance*.zip 文件保存到一个 zip 文件中，然后使用 Citrix Insight Services 将此 .zip 文件发送给 Citrix。
您可以在 c:\Program Files (x86)\Citrix\Licensing\LS\resource\cis bundles\ul_usage 找到 upload_usage_*.zip 文件。您可以将所有 upload_usage_*.zip 文件保存到一个 zip 文件中，然后使用 Citrix Insight Services 将此 .zip 文件发送给 Citrix。
上传成功后，您可以从许可证服务器中删除所有 upload_*.zip 文件。未能删除 .zip 文件可能会导致许可证服务器磁盘空间不足。
要检查最新上传的状态（仅适用于自动上传），您可以评估 C:\Program Files (x86)\Citrix\Licensing\LS\resource\cache\upload_compliance_result.xml 处文本文件的内容。此文件提供有关上次合规性上传的详细信息，包括是否成功或失败以及任何失败的原因。
示例数据：
成功：
<CtxUploaderResult><Code>CTX_UPLOADER_SUCCESS</Code><Msg></Msg><t>1679283497</t><UploadType>CTX_UPLOAD_TYPE_COMPLIANCE</UploadType></CtxUploaderResult>
<!--NeedCopy-->
失败：
<CtxUploaderResult><Code>CTX_UPLOADER_ERROR_NETWORK_OPEN</Code><Msg>SocketOpen(cis.citrix.com:443) exception: {GetAddrInfoW(cis.citrix.com) failed: WSAHOST_NOT_FOUND : code 0x00002af9: No such host is known.
}</Msg><Arg>cis.citrix.com:443</Arg><t>1679283245</t><UploadType>CTX_UPLOAD_TYPE_COMPLIANCE</UploadType></CtxUploaderResult>
<!--NeedCopy-->
如何读取上传的 zip 文件中的数据
upload_compliance*.zip
-
解压缩
upload_compliance*.zip文件。 -
在浏览器中打开
report.xml。 -
在另一个选项卡中打开 Citrix 许可 CEIP 数据元素。
-
将 XML 文件中的标签与 Citrix 许可 CEIP 数据元素 网页中的字段进行比较，并查看说明以了解该字段是什么，然后参考示例获取更多信息。
示例：从
report.xml文件中复制DateSampleStartUTC，并在 Citrix 许可 CEIP 数据元素 中查找。注意：
report.xml中的某些数据经过有意哈希处理以匿名化。
upload_usage_*.zip
-
解压缩
upload_usage*.zip文件。 -
您会找到多个以
ue_lt_*.zip开头的 zip 文件。 -
解压缩其中一个 zip 文件。
-
您会找到一个
ue_lt_*.dat文件，它是一个数据库文件。 -
您可以使用任何 SQL 数据库编辑器工具读取此文件。例如，您可以使用 DB Browser (SQLite) 打开该文件并以 JSON 格式查看它，以使内容可读。下图显示了一个示例视图。
-
现在，在 Citrix Virtual Apps and Desktops 遥测数据元素 或任何其他 Citrix 许可遥测数据元素 中搜索 JSON 键。
例如，在 Citrix Virtual Apps and Desktops 遥测数据元素 中搜索从 dat 文件复制的 EntitlementType，并查看相应的描述和示例以获取更多信息。