Citrix Virtual Apps and Desktops

Citrix Virtual Apps and Desktops™ 遥测数据元素

November 25, 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（云端） OnPrem.Broker (OnPrem)
prod	识别使用事件的起源产品和部署。	XenDesktop.Broker（云端） OnPrem.Broker (OnPrem)
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	指示许可事件类型。此字段指示许可事件类型是用于分配还是发布操作。	连接
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	指示客户的许可证权利类型。	生产
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、User Personalization Layer、用户配置文件管理、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]

StoreFront 配置

使用情况

标头

字段	说明	示例
ver	指示许可证使用事件的版本	1.0
id	指示使用事件的唯一标识符	d4ce7919-5d80-44de-a8fa-102923fe0ead
类型	指示 CAS 用于识别云使用事件的事件类型	配置
st	指示在 StoreFront 中生成事件时的时间戳	2011-08-12T20:17:46.384Z
prod	识别使用事件的起源产品和部署	OnPrem.StoreFront
prodVer	指示 StoreFront 版本（内部）	3.30.0.0

有效负载

字段	说明	示例
serverName	指示正在运行 StoreFront 服务的主机名	storefront-01.storefront.local
deploymentId	指示 StoreFront 部署的唯一标识符	f47ac10b-58cc-4372-a567-0e02b2c3d479
installedWithCVAD	指示 StoreFront 是否与 CVAD 一起安装	false
cpuCores	指示 CPU 核心总数	4
cpuModel	指示运行 StoreFront 的 CPU	第 12 代 Intel(R) Core(TM) i7-1255U 1.70 GHz
ramGb	指示 RAM 总量 (GB)	16
numServersInGroup	指示服务器组中的服务器数量	3
应用商店	指示 StoreFront 应用商店配置 JSON blob。 Store 对象的数组。部分值已加密	示例
rfWebSites	指示 StoreFront RFWeb 配置 JSON blob。 RFWeb 配置对象的数组	示例
网关	指示网关配置对象为 JSON blob。网关对象的数组	示例
authServices	指示身份验证服务配置对象为 JSON blob。身份验证服务对象的数组	示例
IsPiiScrambled		true

stores 字段的示例

  [{
            "BaseUrl": "baseUrl",
            "StorePath": "/",
            "EnabledFeatures": 21 bit bitmap,
            "ResourceTypeFilteringEnabled": "disabled|Citrix.MPS.Application;Citrix.MPS.Desktop",
            "DefaultRfWebSite": "/Citrix/StoreWeb",
            "GatewaysUsed": [
                "gatewayId"
            ],
            "VdaLogonDataProvider": "",
            "ResourceFeeds": [
                {
                    "FeedName": "<resourceFeedName>|scrambled",
                    "Type": "CVAD",
                    "LoadBalancingEnabled": true,
                }
            ],
            "AdvancedAggregation": {
                 "Enabled": true,
                 "GroupingCount": 1,
                 "ControllersPushIdenticalResources": true,
                 "LoadBalanced": true,
                 "AnyPrimaryFarms": true,
                 "AnyBackupFarms": true,
            }
}]
<!--NeedCopy-->

如果未找到 Stores，它将是一个空数组 []。

rfWebSites 字段的示例

  [{
    "SiteId": "siteId",
    "BaseUrl": "baseUrl",
    "StorePath": "storePath",
    "UiExperienced": 0,
    "EnabledFeatures": 9 bit,
    "AuthMethodsEnabled": [
        "ad"
    ],
    "CanUsersDownloadApps": {
        "Enabled": true,
        "Windows": "exe",
        "MacOS": "dmg"
    },
    "WorkspaceControl": {
        "Enabled": true,
        "LogoffAction": 0,
        "AutoReconnectAtLogon": true,
        "ShowReconnectButton": true,
        "ShowDisconnectButton": true
    },
    "MultiClickTimeout": 1,
    "UiViews": [
        "apps",
        "desktops"
    ],
    "DefaultTab": 0,
}]
<!--NeedCopy-->

如果未找到 rfWebSites，它将是一个空数组 []。

gateways 字段的示例

  [{
            "GatewayId": "gatewayId",
            "IsCloudGateway": true,
            "LoadBalancingSTAEnabled": true,
            "SessionReliabilityEnabled": true,
            "RequestTicketsFromTwoSTA": true,
            "Version": "1234",
            "LogonType": "domain",
            "SmartCardFallbackEnabled": true
}]
<!--NeedCopy-->

如果未找到 gateways，它将是一个空数组 []。

authServices 字段的示例

  [{
    "SiteId": "SiteId",
    "Store": "StoreAuth",
    "AuthMethodsEnabled": [
        "ad"
    ],
    "PasswordChangeWhenExpired": 0,
    "PasswordRemindersForm": 1,
    "DelegateCredentialValidationToCitrix": true,
    "ValidatePasswordsOnDeliveryControllers": true
}]
<!--NeedCopy-->

如果未找到 authservices，它将是一个空数组 []。

StoreFront 登录

使用情况

标头

字段	说明	示例
ver	指示许可证使用事件的版本	1.0
id	指示使用事件的唯一标识符	d4ce7919-5d80-44de-a8fa-102923fe0ead
类型	指示 CAS 用于识别云使用事件的事件类型	登录
st	指示在 Broker 中生成事件时的时间戳	2011-08-12T20:17:46.384Z
prod	识别使用事件的起源产品和部署	OnPrem.StoreFront
prodVer	StoreFront 版本（内部）	3.30.0.0

有效负载

字段	说明	示例
user	发起启动的用户。此值已加密	fullName: C648FE671A44B3F7 （始终加密） samName:C758LH671A44B3F7 （始终加密） upn: C7948FE671A44B3F7 （始终加密） userLicenseId:C265FE671A44B3F7 （始终加密） userSid: C097FE671A44B3F7 （始终加密）




serverName	指示正在运行 StoreFront 服务的主机名	storefront-01.storefront.local
loginMethodRfWeb	指示用户从 RFWeb 登录 StoreFront 所使用的方法	0
loginMethodAuth	指示用户从身份验证服务登录 StoreFront 所使用的方法	0
gatewayURL	指示登录时使用的 Netscaler Gateway	netscaler-gateway.com
enabledFeatures	指示已启用功能的位掩码	12
userAgent	指示用于登录的客户端的 UserAgent	CitrixReceiver/22.11.0.19 Linux/5.17.15 X1Class CWACapable CWA/22.11.0.19
baseUrl	指示用户登录的应用商店	storefront-dev.storefront.dev
storePath	指示用户登录的应用商店	/Citirx/StoreWeb
apiUsed	指示客户端是否正在使用 Store 或 PNAgent API	0
deviceId	指示用于登录 StoreFront 的设备。这些值已加密	john-doe
transactionId	指示单个事务过程中发送/生成的事务 ID	773aba9e-5b91-4ef9-8782-c4afb75698e7

委派管理员

使用情况

标头

键	说明	示例
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= =]}`
应用商店	指示 StoreFront 应用商店配置 JSON blob。 Store 对象的数组。部分值已加密	示例
deviceId	指示用于登录 StoreFront 的设备。	john-doe

要启用或禁用加密功能，请在 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™ 遥测数据元素

November 25, 2025

投稿者:

November 25, 2025

投稿者:

这是否有帮助？