产品文档
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR

Citrix Virtual Apps and Desktops 遥测数据元素

February 17, 2025
投稿者: 
C

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 命令。

  1. 从 Delivery Controller 主机打开 PowerShell 窗口。
  2. 运行命令 asnp citrix 以加载 Citrix 特定的 PowerShell 模块。

  3. 运行以下命令以启用或禁用加密：

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

    启用方法：

      Set-BrokerServiceConfigurationData Core.ScrambleLicensingData -SettingValue $true
<!--NeedCopy-->

    注意：

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

    启用加密后，可以使用以下命令将其禁用：

      Set-BrokerServiceConfigurationData Core.ScrambleLicensingData -SettingValue $false
<!--NeedCopy-->

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（本地）
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（本地）
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 或第三方）
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（云端）
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 命令。

  1. 从 Delivery Controller 主机打开 PowerShell 窗口。
  2. 运行命令 asnp citrix 以加载 Citrix 特定的 PowerShell 模块。

  3. 运行以下命令以启用或禁用加密：

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

    禁用方法：

      Set-BrokerServiceConfigurationData Core.ScrambleLicensingData -SettingValue $false
<!--NeedCopy-->

    注意：

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

    禁用加密后，可以使用以下命令将其启用：

      Set-BrokerServiceConfigurationData Core.ScrambleLicensingData -SettingValue $true
<!--NeedCopy-->
Citrix Virtual Apps and Desktops 遥测数据元素
February 17, 2025
投稿者: 
C
February 17, 2025
投稿者: 
C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.