Citrix Virtual Apps and Desktops

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

Broker

用量

标头

描述 示例
ver 指示遥测事件的版本。 1
id 指示用量事件的唯一标识符。 d4ce7919-5d80-44de-a8fa-102923fe0ead
type 指示 Citrix Analytic Service 用于识别云用量事件的事件类型。 SendBrokerTelemetryData
st 指示在 Broker 中生成事件的时间戳。 2011-08-12T20:17:46.384Z
prod
标识用量事件的源产品和部署。
XenDesktop.Broker (Cloud)
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 指示按操作系统类型(Windows、Mac、Linux)划分的远程 PC 访问计算机数量。

10

VDAs.RemotePCAccess.Linux
VDAs.RemotePCAccess.MacOS
VDAs.ActiveSessionRecordingAgents 指示具有活动会话录制代理的 VDA 数量。 5
VDAs.Subscriptions 指示 VDA 的公共云订阅数量。 2
VDAs.LocationTypes 指示 VDA 的位置类型数量。 2
AutoScale.DGWithAutoscaleEnabled 指示启用了 Autoscale 的交付组数量。 2
AutoScale.TotalMachinesCtrlByAutoscale 指示由自动缩放控制的计算机数量。 5
AutoScale.VerticalAutoscaleEnabledByDGandSite 指示按交付组和站点启用了 Vertical Autoscale 的计算机数量。 2
AutoScale.TaggedBasedAutoscaledDG 指示基于标签的自动缩放交付组数量。 2
DeliveryGroup.TotalRebootSchedulesEnabled 指示启用了 Reboot Schedules 的交付组数量。 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
type 指示 Citrix Analytic Service 用于识别云用量事件的事件类型。 Cloud.Licensing
st 指示在 Broker 中生成事件的时间戳。 2011-08-12T20:17:46.384Z
prod
标识用量事件的源产品和部署。
XenDesktop.Broker (Cloud)
OnPrem.Broker (OnPrem)
prodVer 指示 Citrix DaaS 或 Citrix Virtual Apps and Desktops 产品版本。 7.25.0.0
user



标识用于唯一识别启动会话的用户的用户 ID。该值已混淆。



fullName: C648FE671A44B3F7 (always scrambled)
samName:C758LH671A44B3F7 (always scrambled)
upn: C7948FE671A44B3F7 (always scrambled)
userLicenseId:C265FE671A44B3F7 (always scrambled)
userSid: C097FE671A44B3F7 (always scrambled)
tenant -> id 指示 Citrix Cloud™ 帐户的客户 ID。对于本地部署,此字段不适用且没有值。 joj1mh0598tj
dvc -> dvcId 指示用于唯一识别启动会话的设备的设备 ID。 AE18C4D5
dvc -> dvcName 指示设备的友好名称。该值已混淆。 C758LH671A44B3F7 (always scrambled)

有效负载

字段 描述 示例
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 指示会话类型。 Application
ver 指示有效负载版本。 1.3
workerSid 指示用于会话的 VDA 的唯一标识符。该值已混淆。 1E5LH671A44B3F7 (always scrambled)
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 指示为会话启用的功能。例如,在启用了 AppProtectionScreenCaptureRequiredSessionRecording 的会话中,此字段的值为 66。 66
launchRequestSource
记录用于请求启动的产品。它可以是本地 StoreFront™ 或云 StoreFront。
0 (StoreFront 或 3P)
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

用法

标头

Field Description Example
ver 指示许可证使用事件的版本。 1
id 指示使用事件的唯一标识符。 8c2e20a5-ca3f-4401-ad69-d037933c40a0
type 指示 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
type 指示 Citrix Analytic Service 用于识别云使用情况事件的事件类型。 Telemetry
st 指示在 Studio 中生成事件时的时间戳。 2024-03-22T01:32:23.4056195Z
prod 标识使用情况事件的源产品和部署。 XenApp.Monitor
prodVer 指示 Director 产品版本。 7.42.0.0
dvcName 服务器名称 C758LH671A44B3F7

有效负载

字段 描述 示例
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
type 指示 CAS 用于识别云使用情况事件的事件类型。 Configuration
st 指示在 StoreFront 中生成事件时的时间戳。 2011-08-12T20:17:46.384Z
prod 标识使用情况事件的源产品和部署。 OnPrem.StoreFront
prodVer 指示 StoreFront 版本(内部)。 3.30.0.0

有效负载

字段 描述 示例
serverName 指示 StoreFront 运行所在服务的 hostname。 storefront-01.storefront.local
deploymentId 指示 StoreFront 部署的唯一标识符。 f47ac10b-58cc-4372-a567-0e02b2c3d479
installedWithCVAD 指示 StoreFront 是否与 CVAD 一起安装。 false
cpuCores 指示 CPU 核心总数。 4
cpuModel 指示运行 StoreFront 的 CPU。 12th Gen Intel(R) Core(TM) i7-1255U 1.70 GHz
ramGb 指示 RAM 总量(以 GB 为单位)。 16
numServersInGroup 指示服务器组中的服务器数量。 3
stores 指示 StoreFront 存储配置 JSON blob。一个存储对象数组。某些值已混淆。 Example
rfWebSites 指示 StoreFront RFWeb 配置 JSON blob。一个 RFWeb 配置对象数组。 Example
gateways 指示网关配置对象(JSON blob 格式)。一个网关对象数组。 Example
authServices 指示身份验证服务配置对象(JSON blob 格式)。一个身份验证服务对象数组。 Example
IsPiiScrambled PII 是否已混淆 true

字段存储的示例

[{
            "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-->

如果未找到任何存储,则它将是一个空数组 []。

字段 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-->

如果未找到网关,它将是一个空数组 []

字段 authServices 示例

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

如果未找到身份验证服务,它将是一个空数组 []

Storefront 登录

用法

标头

字段 描述 示例
ver 指示许可证使用事件的版本 1.0
id 指示使用事件的唯一标识符 d4ce7919-5d80-44de-a8fa-102923fe0ead
type 指示 CAS 用于识别云使用事件的事件类型 Login
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 运行所在服务的 hostname storefront-01.storefront.local
loginMethodRfWeb 指示用户从 RFWeb 登录到 StoreFront 所使用的方法 0
loginMethodAuth 指示用户从 Auth 服务登录到 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
type 指示 Citrix Analytic Service 用于识别云使用事件的事件类型。 DelegatedAdmin.Usage
st 指示在委派管理员中生成事件的时间戳。 2024-03-22T01:32:23.4056195Z
prod
标识使用事件的原始产品和部署。
XenDesktop.DelegatedAdmin (Cloud)
OnPrem.DelegatedAdmin (OnPrem)
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= =]}
stores 指示 StoreFront 存储配置 JSON blob。一个 Store 对象数组。某些值已混淆 Example
deviceId 指示用于登录 StoreFront 的设备。 john-doe

要启用或禁用混淆,请在 Delivery Controller 上运行以下 PowerShell 命令。

注意:

对于 Citrix Service Provider™ (CSP) 客户,混淆始终处于禁用状态。CSP 客户无法使用 PowerShell 命令启用混淆。

  1. 从 Delivery Controller 主机打开 PowerShell 窗口。
  2. 运行命令 asnp citrix 以加载 Citrix 特定的 PowerShell 模块。
  3. 运行以下命令以启用或禁用混淆:

    默认情况下,值为 1true,这会启用许可遥测数据的混淆。

    要禁用:

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

    禁用混淆后,您可以使用以下命令启用它:

    Set-BrokerServiceConfigurationData Core.ScrambleLicensingData -SettingValue $true
    <!--NeedCopy-->
    
Citrix Virtual Apps and Desktops™ 遥测数据元素