Citrix 许可遥测数据元素
许可服务器数据元素
元数据字段
| 字段 | 描述 | 示例 |
|---|---|---|
| ClientTool | 此字段未使用。 | 不适用 |
| UploadUser | 此字段未使用。 | 不适用 |
UTCDate |
UTC 格式的报告生成时间。 | 2022-10-10T06:11:14Z |
| Date | 本地时间格式的报告生成时间。 | 2022 年 10 月 10 日 02:11:14 |
| Product | 上传名称。 | LicenseServerCompliance |
| ProductVersion | 这是上传的版本。 | 2.0 |
| ProductUTCDeployDate | 表示许可服务器的安装时间。 | 2022-08-16T00:00:00Z |
| SiteID | 此字段未使用。 | 不适用 |
| SiteName | 此字段未使用。 | 不适用 |
| Component | 此字段未使用。 | 不适用 |
| UI | 此字段确保上传文件的完整性。 | 8826d6ac8e1c8e68e471ae90c2bacbe1854f8281a6f5ae40cc7b74114e026abc |
许可服务器和许可证使用信息
| 字段名称 | 描述 | 示例值 |
|---|---|---|
| 许可服务器信息 | ||
| GUID | 在安装期间创建并在升级期间保留的唯一标识符。此字段用于识别哪些上传来自同一服务器。 | a5ae17c9-8a4a-4318-938f-a8c6da2aa2ef |
| HardwareId | 此字段是许可服务器实例的唯一标识符。 | E824249098A96BF0 |
| FQDN | 许可服务器计算机和域名。此值用于帮助在报告体验中识别许可服务器。用于将许可服务器回拨到后端办公室中的许可证分配记录。 | CITRIX-12T5MRV4 |
| InstallUTC | 此值表示许可服务器的安装时间。 | 2016-10-12T00:00:00Z |
| ProductVersion | 标识许可服务器版本。 | 11.16.6.0. build 35000 |
| SGPClockErrorCode | 指示许可服务器进入许可证突发模式的原因的错误代码。 | 0 |
| SGPMaxDays | 许可证突发模式中剩余的最大天数。 | 15 |
| 清单 | ||
| 功能 | ||
| ID | 此值表示许可证使用关联的产品代码。 | CAG_AAC_CCU |
| UDBinFileCreatedUTC | 用于跟踪用户或设备许可证的文件创建时间戳。 | 2016-11-09T00:55:56Z |
| UDReportGenerationUTC | 生成用户或设备报告的时间戳。 | 2016-11-09T00:55:56Z |
| UDAdminUsersReleased | 由 udadmin 释放的用户数。 |
3 |
| UDAdminDevicesReleased | 由 udadmin 释放的设备数。 |
3 |
SADate |
此字段用于构建许可证使用情况随时间变化的视图。 | 有关示例，请参阅下一节中的 SADate。 |
| SADate | ||
| id | 通过 SADate 元素的 ID 属性捕获 SA 日期。 |
2022.1231 |
| DateSampleStartUTC | 正在收集的样本的开始时间。 | 2016-11-08T01:08:13Z |
| DateSampleStopUTC | 正在收集的样本的结束时间。 | 2016-11-09T00:55:56Z |
| CountUsedMax | 此值表示此客户使用的最大许可证数量。 | 6 |
| CCUDevices | 列出使用 Citrix 并发许可证的设备 ID。这有助于获取许可证使用情况随时间的变化。 | |
| Active | 如果值为“1”，则表示它在当前清单中。如果值为“0”，则它仅出现在历史记录中，并且不再是当前清单的一部分，因为它已被删除或已过期。 | 1 |
| Licensees | 被许可方字段包含三个子字段，即 CountTotal、Users 和 Devices。 | 有关示例，请参阅下一节中的 被许可方。 |
| CountInstalled | 已安装的许可证数量。 | 1203 |
| Pool | 有关示例，请参阅下一节中的 池。 | |
| CCUDevices | ||
| DevId | 指定唯一的并发设备标识符。这仅适用于并发许可证。 | C39A925064A3 |
| 被许可方 | ||
| CountTotal | 在采集样本时正在使用的许可证总数。总数是用户和设备的总和。 | 3 |
| Users | 分配了用户许可证的特定用户，计入总数。这仅适用于用户/设备许可证。 | 有关示例，请参阅下一节中的 用户。 |
| Devices | 分配了设备许可证的特定设备，计入总数。这仅适用于用户/设备许可证。 | 有关示例，请参阅下一节中的 设备。 |
| 用户 | ||
| timeLastLogin | 用户的上次登录时间事件。 | 2022-07-12T10:00:00 |
| ID | 分配了用户许可证的特定用户，计入总数。 |
user@domain.com 或 user |
| 设备 | ||
| timeLastLogin | 此设备的上次登录时间事件。 | 2022-07-12T10:00:00 |
| DevId | 指定分配了设备许可证的唯一设备标识符，计入总数。 | C39A925064A3 |
| Name | 设备的友好名称。 | User1Desktop |
| 池 | ||
| Serial | 此信息允许 Citrix 识别产品授权给谁。 | OR10:13 |
| DateExpiration | 影响池中许可证数量的最新到期日期。 | 2020 年 12 月 1 日。 |
| DateIssued | 许可证文件颁发日期。首先到期的许可证文件的颁发日期。 | 2003 年 12 月 1 日 |
| VendorStr | 表示许可信息，告知产品必须以何种版本和模式运行。 |
<![CDATA[;LT=Retail;GP=2;PSL=10;CL=ENT,ADV,STD,AST;SA=1;ODP=0]]>. |
| CountInstalled | 给定功能的池中安装的许可证数量。 | 100 |
| CountOverdraft | 超出安装数量使用的许可证数量。 | 0 |
| UsageSamples | 有关示例，请参阅下一节中的 样本。 | |
| DateStart | 许可证生效的日期。 | 2014 年 12 月 31 日 |
| 样本 | ||
| Timestamp | 样本采集的时间戳。 | 2016-11-09T00:55:56Z |
| CountInUse | 在特定时间戳正在使用的许可证数量。 | 3 |
| OverDraft | 超出安装数量使用的许可证数量。 | 0 |
| Installed | 在特定时间戳安装的许可证数量。 | 100 |
| 启动计数数据元素 | ||
| LPE | 与许可服务器通信的每个服务器的产品、版本和版本信息。左侧示例 - Apps and Desktops Premium - 2012。 | <ID><![CDATA[XDT_PLT_2020.1201]]></ID> |
| Count | 连接到许可服务器的 LPE 总数。 | 2 |
| 补充宽限期 | ||
| ID | 此字段表示许可证突发模式详细信息关联的产品代码。 | XDT_ENT_UD |
SADate |
此字段表示触发许可证突发模式的 CSS 日期。 | 2019.1201 |
| SGPErrorCode | 触发许可证突发模式的错误代码。 | -4 |
| LicCount | 触发许可证突发模式的许可证计数。 | 100 |
| DateTriggerUTC | 针对 ID 和 SADate 触发许可证突发模式的 UTC 日期。 |
2022-07-19T14:35:59Z |
| DateTriggerLocal | 针对 ID 和 SADate 触发许可证突发模式的本地日期。 |
2022-07-19T10:35:59 |
Citrix Virtual Apps and Desktops™ 数据元素
元数据字段
| 字段 | 描述 | 示例 |
|---|---|---|
| ClientTool | 此字段未使用。 | 不适用 |
| UploadUser | 此字段未使用。 | 不适用 |
UTCDate |
UTC 格式的报告生成时间。 | 2022-06-30T15:31:34Z |
| Date | 指示上传捆绑包创建日期。 | 2022 年 6 月 30 日 11:31:34 |
| Product | 标识上传捆绑包。 | LicenseServer.OnPremUsage |
| ProductVersion | 清单架构版本。 | 1.0 |
| ProductDeployUTCDate | 表示许可服务器的安装时间。 | 2022-03-21T00:00:00Z |
| GUID | 在安装期间创建并在升级期间保留的唯一标识符。此字段用于识别哪些上传来自同一服务器。 | a5ae17c9-8a4a-4318-938f-a8c6da2aa2ef |
| UploadType | 指示许可证上传是手动还是自动。 | Auto |
| Ccid | 指示 Citrix Cloud 客户 ID；仅适用于已注册的许可服务器。 | xaxddaily1 |
| OrgID | 指示已安装许可证所关联的组织 ID；仅适用于已注册的许可服务器。 | 23456123 |
| TotalFiles | 上传捆绑包中的文件总数。 | 6 |
| SerialNumbers → Serial → ID | 表示与已安装许可证关联的产品代码。 | XDS_ADV_CCS |
| SerialNumbers → Serial → SADate | 表示与已安装许可证关联的 CSS 日期。 | 2023.1201 |
| SerialNumbers → Serial → SN | 此信息可帮助我们识别产品授权给谁。 | eval1 |
| File → Name | 上传文件的名称。 | ue_lt_1683864965.zip |
| File → UI | 用于指示文件完整性的哈希值。 | 4d14a58f98b1ae2e9d965b2980b67853cfcac7c76e655952bd056ad6dc7a80ae |
| File → EventStartTS | 指示捆绑数据开始时间。 | 1697417241680 |
| File → EventEndTS | 指示捆绑数据结束时间。 | 1697430741834 |
| File → OfferingType → Name | 指示产品。 | Broker |
| FilesUI | 用于指示捆绑包完整性的哈希值。 | 4d14a58f98b1ae2e9d965b2980b67853cfcac7c76e655952bd056ad6dc7a80ff |
| ManifestUI | 用于指示清单完整性的哈希值。 | 4d14a58f98b1ae2e9d965b2980b67853cfcac7c76e655952bd056ad6dc7a8345 |
标头
| Field | Description | Example |
|---|---|---|
| ver | 许可证使用事件的版本。 | 1.0 |
| id | 使用事件的唯一标识符。 | d4ce7919-5d80-44de-a8fa-102923fe0ead |
| type | CAS 用于识别云使用事件的事件类型。 | Cloud.Licensing |
| st | Broker 中生成事件的时间戳。 | 2011-08-12T20:17:46.384Z |
| prod | 使用事件的原始产品和部署。 | XenDesktop.Broker |
| prodVer | DaaS 或 Citrix Virtual Apps and Desktops 产品版本。 | 7.25.0.0 |
| user | 指定用于识别启动会话的用户唯一用户 ID。 | fullName: User-Steven |
| samName: CTXLAB\User-Steven | ||
| upn:User-Steven@ctxlabs.onmicrosoft.com | ||
| userLicenseId: User-Steven@CTXLABS04 | ||
| userSid: S-1-5-21-3711855558-820010554-2448362978-22222 | ||
| tenant -> id | Citrix Cloud™ 帐户的客户 ID。对于本地环境，该值始终为 “CitrixOnPremises”。 | joj1mh0598tj |
| dvc -> dvcId | 指定用于识别启动会话的设备的唯一设备 ID。 | AE18C4D5 |
| dvc -> dvcName | 设备的友好名称。 | Steven’s PC |
有效负载
| 字段 | 描述 | 示例 |
|---|---|---|
| appProtectionKeyLoggingRequired | 指示会话启动时是否启用了键盘记录保护。 | False |
| appProtectionScreenCaptureRequired | 指示会话启动时是否启用了屏幕捕获保护。 | False |
| cspTenantCustomerId | CSP 租户的 Citrix Cloud 帐户的客户 ID。如果客户 ID 不可用（例如在本地部署中），此字段将留空。 | 6c2vtxgxyftt |
| isAnonymousUser | 指示是否启动了未经身份验证的会话。 | False |
| licenseActivityTimeStamp | 生成有效负载时的时间戳。 | 2011-08-12T20:17:46.384Z |
| licenseActivityType | 许可事件类型。此字段指示许可事件类型是分配操作还是释放操作。 | Connect |
| licenseModel | 部署的许可模型。 | UserDevice |
| productEdition | 部署的产品版本。 | Premium or Advanced |
| productId | 部署中产品的产品 ID。 | CAVDS |
| protocol | 用于启动会话的协议。 | HDX™ |
| sessionKey | 会话的唯一标识符。 | uq390c5fc3-86eb-4df3-bd9a-f4a8fed2c9e2 |
| sessionSupport | 会话支持类型。 | SingleSession |
| sessionType | 会话类型 | Application |
| ver | 有效负载版本。 | 1.3 |
| workerSid | 用于会话的 VDA 的唯一标识符。 | S-1-5-21-3711855558-820010554-2448362978-27640 |
| isWindows365 | 指示会话是否为 Windows 365 启动。 | True |
| entitlementType | 客户的许可授权类型 | Production |
| siteId | 站点的唯一标识符 | a35647d0-901c-4477-87e0-dcd781d455f4 |
| desktopGroupId | 桌面或交付组的唯一标识符 | e9d859dc-1bfc-4b3e-bad3-41806bb4e694 |
| clientType | Citrix Workspace™ 应用程序类型 | Windows |
| clientVersion | Citrix Workspace 应用程序版本 | 23.5.1.83 |
| workerCloudType | 用于 VDA 预配的公共云类型。 | Azure |
| enabledFeatures | 指示为会话启用的功能。例如，在启用了 AppProtectionScreenCaptureRequired 和 SessionRecording 的会话中，此字段的值为 66。 | 66 |
| isEvents | 许可服务器中的严重故障 | Unable to create ST Database. |
| heartBeatTime | 许可服务器到 CIS 或 CAS 的心跳时间 | 1689058813 |
下表指定了 enabledFeatures 下不同功能的编号：
| 功能 | enabledFeature 编号 |
|---|---|
| AppProtectionKeyLoggingRequired | 1 |
| AppProtectionScreenCaptureRequired | 2 |
| AnonymousUser | 4 |
| Windows 365 | 8 |
| SaaS | 32 |
| SessionRecording | 64 |
| WEM | 128 |
Citrix Secure Private Access™ 数据元素
管理员有效负载 v1.0
事件标头
| 字段 | 描述 | 示例 |
|---|---|---|
| ver | 标头版本。硬编码：“ver”: “1.0” | 1.0 |
| id | 唯一事件 ID (GUID) | 1fced2a0-52e7-4c48-bf4e-6f2e06136e11 |
| type
|
事件类型名称。硬编码 | admin
|
| “type”: “admin” | ||
| st | UTC 格式的时间戳 | 2011-08-12T20:17:46.384Z |
| prod
|
产品名称。硬编码。
“prod”: “AccessSecurity.OnPrem” |
AccessSecurity.OnPrem
|
| prodVer | 产品版本 | 2402 |
| user
|
用于识别已登录管理员的唯一 ID。
|
{
“fullName”: “Username”,”fullName”: “Username”, “samName”: “用户的 SAM 帐户名”, “upn”: “用户的 UPN 名称”, “userSid”: “用户的 SID” } |
事件有效负载
| 字段 | 描述 | 示例 |
|---|---|---|
| actualtemplatecode
|
有效负载模板版本。
硬编码：“actualtemplatecode”: “1.0” |
1.0
|
| adminLoginType
|
管理员的 RBAC
|
type: enum
值：fulladmin/readonly/helpdesk |
| clientType | 管理员登录来源。管理员控制台/Director/公共 API 等。如果未从客户端收到 User-Agent，则会发送“其他”。 | AdminConsole/CitrixMonitor/Others |
| tenantName | 多租户部署（服务提供商）的租户名称或单租户的站点名称。 | SPASite1 |
| enabledFeatures | 指示为会话启用的功能。 | 1 |
配置有效负载 v1.0
事件标头
| 字段 | 描述 | 示例 |
|---|---|---|
| ver | 标头版本。硬编码：“ver”: “1.0” | 1.0 |
| id | 唯一事件 ID (GUID) | 1fced2a0-52e7-4c48-bf4e-6f2e06136e11 |
| type
|
事件类型名称。硬编码 | config
|
| “type”: “config” | ||
| st | UTC 格式的时间戳 | 2011-08-12T20:17:46.384Z |
| prod
|
产品名称。硬编码 | AccessSecurity.OnPrem
|
| “prod”: “AccessSecurity.OnPrem” | ||
| prodVer | 产品版本 | 2405 |
事件负载
| 字段 | 描述 | 示例 |
|---|---|---|
| actualtemplatecode
|
负载模板版本。硬编码。
“actualtemplatecode”: “1.0” |
1.0
|
| appsPublished
|
已发布的内部和外部应用程序列表。包括 Web/SaaS 和 TCP/UDP 应用程序。
|
[
{ “name”:”jira”, “type”: “web”, “internal”: true }, { “name”:”Office 365”, “type”: “saas”, “internal”: false }, { “name”:”eng_printer”, “type”: “tcp”, “internal”: true } ] |
用户负载 v1.5
事件标头
| 字段 | 描述 | 示例 |
|---|---|---|
| ver | 标头版本。硬编码：“ver”: “1.0” | 1.0 |
| id | 唯一事件 ID (GUID) | 1fced2a0-52e7-4c48-bf4e-6f2e06136e11 |
| type
|
事件类型名称 | user
|
| “type”: “user” | ||
| st | UTC 格式的时间戳 | 2011-08-12T20:17:46.384Z |
| prod
|
产品名称。硬编码
“prod”: “AccessSecurity.OnPrem” |
AccessSecurity.OnPrem
|
| prodVer | 产品版本 | 2402 |
| user
|
用于识别用户的唯一 ID。
|
{
“fullName”: “Username”, (optional) “samName”: “User’s SAM account name”, “upn”: “User’s UPN name”, “userSid”: “User’s SID” } |
| dvc
|
PII 数据，如果启用，这些值必须进行混淆处理。
dvcId - 用于识别启动应用程序的设备的唯一设备 ID。 dvcName - 设备的友好名称。 |
{
“dvcId”: “AE18C4D5”, “dvcName”: “User’s PC” } |
事件负载
| 字段 | 描述 | 示例 |
|---|---|---|
| actualtemplatecode
|
负载模板版本。
硬编码：“actualtemplatecode”: “1.5” |
1.5
|
| transportProtocolType | 连接类型：TCP 或 EDP 或 0（适用于 Web\SaaS） | tcp |
| ngsRecordType | 应用程序类型：websaas 或 tcpudp | websaas |
| tenantName | 多租户部署（服务提供商）的租户名称或单租户的站点名称。 | SPAOPDEVSite |
| SPAOPDEVSite
|
用户将为该事件访问的应用程序列表。
|
{
“published” : { “internal” : [“issues.citrite.net”], “external” : [“citrixsys.splunk.com”, “www.office365.com”] }, “unpublished” : { “internal” : [], “external” : [“www.okta.com”, “www.cloudcentral.com”] } } |
| clientInfo | 此字段指示客户端是否为 Citrix Enterprise Browser、Citrix Secure Access、Citrix Workspace App、RfWeb 及其版本。 | {“name”: “ceb”, “version”: “21.4.0”} |
| platformType | 此字段显示代理操作系统类型。 | Win/MacOS/iOS/Android |
| enabledFeatures | 表示为会话启用的功能。 | 1 |
用户负载 v1.0
事件标头
| 字段 | 描述 | 示例 |
|---|---|---|
| ver | 标头版本。硬编码：“ver”: “1.0” | 1.0 |
| id | 唯一事件 ID (GUID) | 1fced2a0-52e7-4c48-bf4e-6f2e06136e11 |
| type
|
事件类型名称。硬编码
“type”: “PolicyDocument.Download” |
PolicyDocument.Download
|
| st | UTC 格式的时间戳 | 2011-08-12T20:17:46.384Z |
| prod
|
产品名称。硬编码。 | AccessSecurity.OnPrem
|
| “prod”: “AccessSecurity.OnPrem” | ||
| prodVer | 产品版本 | 2402 |
| $schema
|
对架构的引用，硬编码 |
https://cas.citrix.com/schemas/event.json
|
“$schema”: "https://cas.citrix.com/schemas/event.json"
|
||
| tenant
|
组织（客户）识别信息
“tenant”: { “id”: “” } Secure Private Access 插件不跟踪客户 ID 或组织 ID。它必须为空。 |
“tenant”: {
“id”: “” } “user”: { “UPN”: "User UPN name"} |
| user
|
用户识别映射信息，仅限 UPN。
“UPN”: <用户名（可选编码）> 如果启用了混淆处理（请参阅事件负载 enabledFeatures），则进行编码。 |
|
事件负载
| 字段 | 描述 | 示例 |
|---|---|---|
| actualtemplatecode
|
负载模板版本。
硬编码：“actualtemplatecode”: “1.0” |
1.0
|
| ngsUsername
|
UPN 格式的用户名（明文/编码）。
如果启用了混淆处理（请参阅事件负载 enabledFeatures），则进行编码 |
User UPN name
Encoded UPN name
|
| ngsProductName
|
产品名称。硬编码。 | AccessSecurity.OnPrem
|
| “ngsProductName”: “AccessSecurity.OnPrem” | ||
| transportProtocolType | 连接类型：TCP 或 UDP 或 0（适用于 Web\SaaS） | tcp |
| ngsRecordType | 应用程序类型：websaas 或 tcpudp | websaas |
| tenantName | 多租户部署（服务提供商）的租户名称或单租户的站点名称。 | SPAOPDEVSite |
| enabledFeatures | 表示为会话启用的功能。当前未使用。 | 1 |
已复制!
失败!