Citrix Virtual Apps and Desktops

Citrix Virtual Apps and Desktops 遥测数据元素

February 17, 2025

投稿者:

Broker

会话

标头

键	说明	示例
ver	指示遥测使用事件的版本。	1
id	指示使用事件的唯一标识符。	d4ce7919-5d80-44de-a8fa-102923fe0ead
类型	指示 Citrix Analytic Service 用于识别云使用事件的事件类型。	SendBrokerTelemetryData
st	指示在 Broker 中生成事件时的时间戳。	2011-08-12T20:17:46.384Z
prod	识别使用事件的起源产品和部署。	XenDesktop.Broker
prodVer	指示 Citrix DaaS/Citrix Virtual Apps and Desktops 产品版本。	7.25.0.0
user	识别用户 ID 以唯一地标识发起会话启动的用户。	fullName: C648FE671A44B3F7 samName:C758LH671A44B3F7 upn: C7948FE671A44B3F7 userLicenseId:C265FE671A44B3F7 userSid: C097FE671A44B3F7




tenant -> id	指示 Citrix Cloud 帐户的客户 ID。对于本地部署，该值始终为“CitrixOnPremises”。	joj1mh0598tj
dvc -> dvcId	指示设备 ID，以唯一地标识从中发起会话启动的设备。	AE18C4D5
dvc -> dvcName	指示设备的友好名称。	C758LH671A44B3F7

有效负载

字段	说明	示例
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 或 Advanced
productId	指示部署中地产品的产品 ID。	CAVDS
protocol	指示用于启动会话的协议。	HDX
sessionKey	指示会话的唯一标识符。	uq390c5fc3-86eb-4df3-bd9a-f4a8fed2c9e2
sessionSupport	指示会话支持类型。	SingleSession
sessionType	指示会话类型。	应用程序
ver	指示有效负载版本。	1.3
workerSid	指示用于会话的 VDA 的唯一标识符。此值已加密。	1E5LH671A44B3F7（始终加密）
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	指示中的严重故障。	无法创建 ST 数据库。
heartBeatTime	指示许可证服务器到 CIS 或 Citrix Analytic Service 的检测信号时间。	1689058813

加密许可遥测数据

考虑到许可证遥测中发送的信息的敏感性，Citrix 为您提供了用于加密数据的选项。

下表列出了可加密的数据：

字段	说明	示例
user	识别用户 ID 以唯一地标识发起会话启动的用户。	fullName: `C648FE671A44B3F7` samName: `C758LH671A44B3F7` upn: `C7948FE671A44B3F7` userLicenseId: `C265FE671A44B3F7` userSid: `C097FE671A44B3F7`




dvc -> dvcName	指示设备的友好名称。	`C758LH671A44B3F7`
workerSid	指示用于会话的 VDA 的唯一标识符。	`1E5LH671A44B3F7`
AdminLoginList	指示唯一管理员 SamAccountName 的列表	`{AdminLoginList: [UFMJ+JvXOTHO9mQDsOweiw= =]}`

要启用或禁用加密，请在 Delivery Controller 上运行以下 PowerShell 命令。

从 Delivery Controller 主机打开 PowerShell 窗口。
运行命令 asnp citrix 以加载 Citrix 特定的 PowerShell 模块。
运行以下命令以启用或禁用加密：

默认情况下，此值为 0 或 false，这将禁用许可证遥测数据的加密。

启用方法：
```
  Set-BrokerServiceConfigurationData Core.ScrambleLicensingData -SettingValue $true
 
```
注意：

对于 Citrix Service Provider (CSP) 客户，默认禁用加密。

启用加密后，可以使用以下命令将其禁用：
```
  Set-BrokerServiceConfigurationData Core.ScrambleLicensingData -SettingValue $false
 
```

Citrix Virtual Apps and Desktops 2402 LTSR CU1 遥测数据元素

Broker

使用情况

标头

键	说明	示例
ver	指示遥测事件的版本。	1
id	指示使用事件的唯一标识符。	d4ce7919-5d80-44de-a8fa-102923fe0ead
类型	指示 Citrix Analytic Service 用于识别云使用事件的事件类型。	SendBrokerTelemetryData
st	指示在 Broker 中生成事件时的时间戳。	2011-08-12T20:17:46.384Z
prod	识别使用事件的起源产品和部署。	XenDesktop.Broker（云端） OnPrem.Broker（本地）
prod	识别使用事件的起源产品和部署。	XenDesktop.Broker（云端） OnPrem.Broker（本地）
prodVer	指示 Citrix DaaS/Citrix Virtual Apps and Desktops 产品版本。	7.25.0.0

有效负载

字段	说明	示例
TotalPublishedApps	指示已发布的应用程序总数。	10
TotalPublishedDesktops	指示已发布的桌面总数。	10
VDAs.Total	指示 VDA 总数。	10
VDAs.OSTypes	：指示按操作系统类型（例如 Windows、Linux 和 Mac）划分地 VDA 总数。	10
VDAs.OSVersions	指示 Windows 10、11、2022、2019 等操作系统版本的总数。	10
VDAs.HostingLocations.Azure	指示每个受支持的托管位置（例如 Azure、AWS、GCP、Nutanix、VMWare、XenServer 和 HyperV）的 VDA 数量。	10
VDAs.HostingLocations.AWS
VDAs.HostingLocations.Nutanix
VDAs.HostingLocations.VMWare
VDAs.HostingLocations.XenServer
VDAs.HostingLocations.HyperV
VDAs.ProvisionedMethod.MCS	指示 Machine Creation Service (MCS) 预配的计算机数量。	10
VDAs.ProvisionedMethod.ManualOr3P	指示手动或第三方预配的计算机数量。	10
VDAs.SessionSupport.StaticSingle	指示静态分配的单个会话的计算机数量。	10
VDAs.SessionSupport.DynamicSingle	指示动态分配的单个会话的计算机数量。	10
VDAs.SessionSupport.Multi	指示多会话计算机的总数。	10
VDAs.RemotePCAccess.Windows	指示按操作系统类型（Win、Mac、Linux）划分的 Remote PC Access 计算机数量。	10
VDAs.RemotePCAccess.Linux
VDAs.RemotePCAccess.MacOS
VDAs.ActiveSessionRecordingAgents	指示具有活动 Session Recording Agent 的 VDA 数量。	5
VDAs.Subscriptions	指示 VDA 的公有云订阅数量。	2
VDAs.LocationTypes	指示 VDA 的位置类型数量。	2
AutoScale.DGWithAutoscaleEnabled	指示启用了 AutoScale 的交付组数量。	2
AutoScale.TotalMachinesCtrlByAutoscale	指示 AutoScale 控制的计算机数量。	5
AutoScale.VerticalAutoscaleEnabledByDGandSite	指示 DG 和站点启用了垂直 AutoScale 的计算机数量。	2
AutoScale.TaggedBasedAutoscaledDG	指示基于标记的自动缩放的交付组的数量。	2
DeliveryGroup.TotalRebootSchedulesEnabled	指示启用了重新启动计划的交付组数量。	2
DeliveryGroup.Total	指示交付组总数。	10
Policy.TotalPolicySets	指示策略集的数量。	3
Policy.TotalPolicies	指示组策略的数量。	2
Policy.TotalPolicySettings	指示组设置的数量。	2
PublishedPackageApps.AppVSingleAdmin	指示在 AppV 单管理模式下发布的封装应用程序的总数。	2
PublishedPackageApps.AppVDualAdmin	指示在 AppV 双管理模式下发布的封装应用程序的总数。	2
PublishedPackageApps.Msix	指示在 MSIX 模式下发布的封装应用程序的总数。	2
PublishedPackageApps.AppAttach	指示在 AppAttach 模式下发布的封装应用程序的总数。	2
PublishedPackageApps.FlexApp	指示在 FlexApp 模式下发布的封装应用程序的总数。	2

会话

标头

字段	说明	示例
ver	指示许可证使用事件的版本。	1
id	指示使用事件的唯一标识符。	d4ce7919-5d80-44de-a8fa-102923fe0ead
类型	指示 Citrix Analytic Service 用于识别云使用事件的事件类型。	Cloud.Licensing
st	指示在 Broker 中生成事件时的时间戳。	2011-08-12T20:17:46.384Z
prod	识别使用事件的起源产品和部署。	XenDesktop.Broker（云端） OnPrem.Broker（本地）
prod	识别使用事件的起源产品和部署。	XenDesktop.Broker（云端） OnPrem.Broker（本地）
prodVer	指示 Citrix DaaS 或 Citrix Virtual Apps and Desktops 产品版本。	7.25.0.0
user	识别用户 ID 以唯一地标识发起会话启动的用户。此值已加密。	fullName: C648FE671A44B3F7 （始终加密） samName:C758LH671A44B3F7 （始终加密） upn: C7948FE671A44B3F7 （始终加密） userLicenseId:C265FE671A44B3F7 （始终加密） userSid: C097FE671A44B3F7 （始终加密）




tenant -> id	指示 Citrix Cloud 帐户的客户 ID。对于本地部署，此字段不适用且没有值。	joj1mh0598tj
dvc -> dvcId	指示设备 ID，以唯一地标识从中发起会话启动的设备。	AE18C4D5
dvc -> dvcName	指示设备的友好名称。此值已加密。	C758LH671A44B3F7 （始终加密）

有效负载

字段	说明	示例
appProtectionKeyLoggingRequired	指示会话是否在启用了键盘记录保护的情况下启动。	False
appProtectionScreenCaptureRequired	指示会话启动时是否启用了屏幕截图保护功能。	False
cspTenantCustomerId	指示 CSP 租户 Citrix Cloud 帐户的客户 ID。对于本地部署，此字段不适用且没有值。	6c2vtxgxyftt
isAnonymousUser	指示是否启动未经身份验证的会话。	False
licenseActivityTimeStamp	指示生成有效负载时的时间戳。	2011-08-12T20:17:46.384Z
licenseActivityType	指示许可事件类型。此字段指示许可事件类型是用于分配还是释放操作。	Connect
licenseModel	指示部署的许可模型。	UserDevice
productEdition	指示部署的产品版本。	Premium
productId	指示部署中地产品的产品 ID。	CAVDS
protocol	指示用于启动会话的协议。	HDX
sessionKey	指示会话的唯一标识符。	uq390c5fc3-86eb-4df3-bd9a-f4a8fed2c9e2
sessionSupport	指示会话支持类型。	SingleSession
sessionType	指示会话类型。	应用程序
ver	指示有效负载版本。	1.3
workerSid	指示用于会话的 VDA 的唯一标识符。此值已加密。	1E5LH671A44B3F7（始终加密）
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
launchRequestSource	记录用于请求启动的产品。它可以是本地 StoreFront 或云端 StoreFront。	0（StoreFront 或第三方）
launchRequestSource	记录用于请求启动的产品。它可以是本地 StoreFront 或云端 StoreFront。	1 (Workspace)
isEvents	指示中的严重故障。	无法创建 ST 数据库。
heartBeatTime	指示许可证服务器到 CIS 或 Citrix Analytic Service 的检测信号时间。	1689058813
vdaTelemetry	指示为 App Layering、用户个性化层、用户配置文件管理、Workspace Environment Management 和 HDX 功能捕获的有效负载。	vdaTelemetry SessionTelemetry CPM_feature: 32 HDX1: 66 HDX2: 0 MachineTelemetry AL_productVersion: 23.12.0.1001 UPL_isEnabled: 1 CPM_version: 22.3.4000 wem_enableMethod: 1 wem_agentVersion: 2402.1

Studio

使用情况

标头

字段	说明	示例
ver	指示许可证使用事件的版本。	1
id	指示使用事件的唯一标识符。	8c2e20a5-ca3f-4401-ad69-d037933c40a0
类型	指示 Citrix Analytic Service 用于识别云使用事件的事件类型	Studio.Usage
st	指示在 Studio 中生成事件时的时间戳。	2024-03-22T01:32:23.4056195Z
prod	识别使用事件的起源产品和部署。	XenDesktop.Studio
prodVer	指示 Citrix DaaS/Citrix Virtual Apps and Desktops 产品版本	7.42.0.0

有效负载

字段	说明	示例
AdminLoginList	指示唯一管理员 SamAccountName 的列表。此值已加密。	{AdminLoginList: [UFMJ+JvXOTHO9mQDsOweiw= =]}（始终加密）
TotalApiRequests	指示 Orchestration 服务的 API 请求。	{TotalApiRequests: 1000}
BackupCount	指示 Studio 管理员操作的备份次数。	{BackupCount: 200}
RestoreCount	指示 Studio 管理员操作的还原的次数。	{RestoreCount: 20}

Director

使用情况报告

标头

字段	说明	示例
ver	指示许可证使用事件的版本。	1
id	指示使用事件的唯一标识符。	8c2e20a5-ca3f-4401-ad69-d037933c40a0
类型	指示 Citrix Analytic Service 用于识别云使用事件的事件类型。	遥测
st	指示在 Studio 中生成事件时的时间戳。	2024-03-22T01:32:23.4056195Z
prod	识别使用事件的起源产品和部署。	XenApp.Monitor
prodVer	指示 Director 产品版本。	7.42.0.0

有效负载

字段	说明	示例
AdminLoginCount	这是有效负载的一部分，提供管理员登录次数。	type: AdminLogin stats 0: 1 1: 7



FeatureUsageCount	有效负载的这一部分内容包含在 Director 中使用的重要功能的数量。	type: FeatureUsage stats 0: 15 1: 20 5: 10




OdataUsageCount	有效载荷的这一部分内容包含 Odata API 使用次数	type: OData_v3 stats 0: 1 2: 7 5: 9 type: OData_v4 stats 0: 1 2: 8 6: 7









AppUsage	指示已发布的应用程序的每周使用情况指标。	type: AppUsage headers: applicationName,processName,totalDurationInMinutes period: 01/05/24-07/05/24 values: [ Calc_AWTSVDA-1907R,calc.exe,0.13, Notepad_AWTSVDA-1907R,notepad.exe,4]





UniqueAppUsers	指示已发布的应用程序的唯一用户数以及一个月内的总启动次数。	type: UniqueAppUsers headers: applicationName,totalLaunches,totalUniqueUsers period: 04/24 values: [ Calc_AWTSVDA-1907R,100,10, Notepad_AWTSVDA-1907R,200,20]





DesktopUsage	指示已发布的桌面的每周使用情况指标。	type: DesktopUsage headers: desktopGroupName,sessionSupport,totalDurationInMinutes period: 01/05/24-07/05/24 values: [ RdsDesktopAndAppGroup,1,10]




UniqueDesktopUsers	指示已发布的桌面的唯一用户数以及一个月内的总启动次数。	type: UniqueDesktopUsers headers: desktopGroupName,totalLaunches,totalUniqueUsers period: 04/24 values: [ RdsDesktopAndAppGroup,10,5]




AvgLogonDuration	指示平均登录持续时间。	type: AvgLogonDuration headers: totalUserLogons, avgLogonDurationInSeconds period: 01/05/24-07/05/24 values: [ 200,4]




CostSaved	指示客户一个月内节省的成本。	type: CostSaved headers: hypervisor,costSaved,currency period: 04/24 values: [ 1,221.02,1 2,301.02,2]

委派管理员

使用情况

标头

键	说明	示例
ver	指示许可证使用事件的版本。	1
id	指示使用事件的唯一标识符。	8c2e20a5-ca3f-4401-ad69-d037933c40a0
类型	指示 Citrix Analytic Service 用于识别云使用事件的事件类型。	DelegatedAdmin.Usage
st	指示在委派管理中生成事件时的时间戳。	2024-03-22T01:32:23.4056195Z
prod	识别使用事件的起源产品和部署。	XenDesktop.DelegatedAdmin（云端）
prod	识别使用事件的起源产品和部署。	OnPrem.DelegatedAdmin（本地）
prodVer	指示 Citrix DaaS 或 Citrix Virtual Apps and Desktops 产品版本。	7.42.0.0

有效负载

键	说明	示例
TotalCustomScopes	指示自定义作用域总数。	2
TotalCustomRoles	指示自定义角色总数。	4

加密许可遥测数据

考虑到许可证遥测中发送的信息的敏感性，Citrix 为您提供了用于加密数据的选项。

下表列出了可加密的数据：

字段	说明	示例
user	识别用户 ID 以唯一地标识发起会话启动的用户。	fullName: `C648FE671A44B3F7` samName: `C758LH671A44B3F7` upn: `C7948FE671A44B3F7` userLicenseId: `C265FE671A44B3F7` userSid: `C097FE671A44B3F7`




dvc -> dvcName	指示设备的友好名称。	`C758LH671A44B3F7`
workerSid	指示用于会话的 VDA 的唯一标识符。	`1E5LH671A44B3F7`
AdminLoginList	指示唯一管理员 SamAccountName 的列表	`{AdminLoginList: [UFMJ+JvXOTHO9mQDsOweiw= =]}`

要启用或禁用加密，请在 Delivery Controller 上运行以下 PowerShell 命令。

从 Delivery Controller 主机打开 PowerShell 窗口。
运行命令 asnp citrix 以加载 Citrix 特定的 PowerShell 模块。
运行以下命令以启用或禁用加密：

默认情况下，此值为 1 或 true，用于对许可证遥测数据进行加密。

禁用方法：
```
  Set-BrokerServiceConfigurationData Core.ScrambleLicensingData -SettingValue $false
 
```
注意：

对于 Citrix Service Provider (CSP) 客户，默认启用加密。

禁用加密后，可以使用以下命令将其启用：
```
  Set-BrokerServiceConfigurationData Core.ScrambleLicensingData -SettingValue $true
 
```

本内容的正式版本为英文版。部分 Cloud Software Group 文档内容采用了机器翻译，仅供您参考。Cloud Software Group 无法控制机器翻译的内容，这些内容可能包含错误、不准确或不合适的语言。对于从英文原文翻译成任何其他语言的内容的准确性、可靠性、适用性或正确性，或者您的 Cloud Software Group 产品或服务沿用了任何机器翻译的内容，我们均不作任何明示或暗示的保证，并且适用的最终用户许可协议或服务条款或者与 Cloud Software Group 签订的任何其他协议（产品或服务与已进行机器翻译的任何文档保持一致）下的任何保证均不适用。对于因使用机器翻译的内容而引起的任何损害或问题，Cloud Software Group 不承担任何责任。

这是否有帮助？

Citrix Virtual Apps and Desktops 遥测数据元素

February 17, 2025

投稿者:

在本文中

这是否有帮助？