Citrix Virtual Apps and Desktops

Elementi dei dati di telemetria di Citrix Virtual Apps and Desktops™

Broker

Utilizzo

Intestazioni

Chiave Descrizione Esempio
ver Indica la versione dell’evento di telemetria. 1
id Indica un identificatore univoco dell’evento di utilizzo. d4ce7919-5d80-44de-a8fa-102923fe0ead
type Indica il tipo di evento utilizzato da Citrix Analytic Service per identificare gli eventi di utilizzo del cloud. SendBrokerTelemetryData
st Indica il timestamp di generazione dell’evento nel Broker. 2011-08-12T20:17:46.384Z
prod
Identifica il prodotto di origine e la distribuzione dell’evento di utilizzo.
XenDesktop.Broker (Cloud)
OnPrem.Broker (OnPrem)
prodVer Indica la versione del prodotto Citrix DaaS/Citrix Virtual Apps and Desktops. 7.25.0.0

Payload

Campo Descrizione Esempio
TotalPublishedApps Indica il numero totale di app pubblicate. 10
TotalPublishedDesktops Indica il numero totale di desktop pubblicati. 10
VDAs.Total Indica il numero totale di VDA. 10
VDAs.OSTypes Indica il numero totale di VDA per tipo di sistema operativo, come Windows, Linux e Mac. 10
VDAs.OSVersions Indica il numero totale per versione del sistema operativo, come Windows 10, 11, 2022, 2019.     10
VDAs.HostingLocations.Azure Indica il numero di VDA per ciascuna posizione di hosting supportata, come Azure, AWS, GCP, Nutanix, VMWare, XenServer e HyperV.




10




VDAs.HostingLocations.AWS
VDAs.HostingLocations.Nutanix
VDAs.HostingLocations.VMWare
VDAs.HostingLocations.XenServer
VDAs.HostingLocations.HyperV
VDAs.ProvisionedMethod.MCS Indica il numero di macchine di cui è stato eseguito il provisioning tramite Machine Creation Service (MCS). 10
VDAs.ProvisionedMethod.ManualOr3P Indica il numero di macchine di cui è stato eseguito il provisioning manuale o tramite terze parti (3P). 10
VDAs.SessionSupport.StaticSingle Indica il numero di macchine assegnate staticamente a sessione singola. 10
VDAs.SessionSupport.DynamicSingle Indica il numero di macchine assegnate dinamicamente a sessione singola. 10
VDAs.SessionSupport.Multi Indica il numero totale di macchine multi-sessione. 10
VDAs.RemotePCAccess.Windows Indica il numero di macchine Remote PC Access per tipo di sistema operativo (Win, Mac, Linux).

10

VDAs.RemotePCAccess.Linux
VDAs.RemotePCAccess.MacOS
VDAs.ActiveSessionRecordingAgents Indica il numero di VDA con agenti di registrazione sessione attivi. 5
VDAs.Subscriptions Indica il numero di sottoscrizioni cloud pubbliche di VDA. 2
VDAs.LocationTypes Indica il numero di tipi di posizione dei VDA. 2
AutoScale.DGWithAutoscaleEnabled Indica il numero di gruppi di consegna con Autoscale abilitato. 2
AutoScale.TotalMachinesCtrlByAutoscale Indica il numero di macchine controllate da autoscale. 5
AutoScale.VerticalAutoscaleEnabledByDGandSite Indica il numero di macchine con Autoscale verticale abilitato per DG e Sito. 2
AutoScale.TaggedBasedAutoscaledDG Indica il numero di gruppi di consegna con autoscale basato su tag. 2
DeliveryGroup.TotalRebootSchedulesEnabled Indica il numero di gruppi di consegna con Pianificazioni di riavvio abilitate. 2
DeliveryGroup.Total Indica il numero totale di gruppi di consegna. 10
Policy.TotalPolicySets Indica il numero di set di criteri. 3
Policy.TotalPolicies Indica il numero di criteri di gruppo. 2
Policy.TotalPolicySettings Indica il numero di impostazioni di gruppo. 2
PublishedPackageApps.AppVSingleAdmin Indica il numero totale di app pacchettizzate pubblicate in modalità AppV Single Admin. 2
PublishedPackageApps.AppVDualAdmin Indica il numero totale di app pacchettizzate pubblicate in modalità AppV Dual Admin. 2
PublishedPackageApps.Msix Indica il numero totale di app pacchettizzate pubblicate in modalità MSIX. 2
PublishedPackageApps.AppAttach Indica il numero totale di app pacchettizzate pubblicate in modalità AppAttach. 2
PublishedPackageApps.FlexApp Indica il numero totale di app pacchettizzate pubblicate in modalità FlexApp. 2

Sessione

Intestazioni

Campo Descrizione Esempio
ver Indica la versione dell’evento di utilizzo della licenza. 1
id Indica un identificatore univoco dell’evento di utilizzo. d4ce7919-5d80-44de-a8fa-102923fe0ead
type Indica il tipo di evento utilizzato da Citrix Analytic Service per identificare gli eventi di utilizzo del cloud. Cloud.Licensing
st Indica il timestamp di generazione dell’evento nel Broker. 2011-08-12T20:17:46.384Z
prod
Identifica il prodotto di origine e la distribuzione dell’evento di utilizzo.
XenDesktop.Broker (Cloud)
OnPrem.Broker (OnPrem)
prodVer Indica la versione del prodotto Citrix DaaS o Citrix Virtual Apps and Desktops. 7.25.0.0
user



Identifica l’ID utente per identificare in modo univoco un utente che avvia la sessione. Il valore è offuscato.



fullName: C648FE671A44B3F7 (sempre offuscato)
samName:C758LH671A44B3F7 (sempre offuscato)
upn: C7948FE671A44B3F7 (sempre offuscato)
userLicenseId:C265FE671A44B3F7 (sempre offuscato)
userSid: C097FE671A44B3F7 (sempre offuscato)
tenant -> id Indica l’ID cliente dell’account Citrix Cloud™. Per la distribuzione on-premise, questo campo non è applicabile e non ha valore. joj1mh0598tj
dvc -> dvcId Indica l’ID del dispositivo per identificare in modo univoco un dispositivo da cui viene avviata la sessione. AE18C4D5
dvc -> dvcName Indica il nome descrittivo del dispositivo. Il valore è offuscato. C758LH671A44B3F7 (sempre offuscato)

Payload

Campo Descrizione Esempio
appProtectionKeyLoggingRequired Indica se la sessione è avviata con la protezione dalla registrazione della digitazione (Key Logging Protection) abilitata. False
appProtectionScreenCaptureRequired Indica se la sessione è avviata con la protezione dall’acquisizione dello schermo (Screen Capture Protection) abilitata. False
cspTenantCustomerId Indica l’ID cliente di un account Citrix Cloud di un tenant CSP. Per la distribuzione on-premise, questo campo non è applicabile e non ha valore. 6c2vtxgxyftt
isAnonymousUser Indica se è stata avviata una sessione non autenticata. False
licenseActivityTimeStamp Indica il timestamp di generazione del payload. 2011-08-12T20:17:46.384Z
licenseActivityType Indica il tipo di evento di licenza. Questo campo indica se il tipo di evento di licenza è per un’azione di assegnazione o di rilascio. Connect
licenseModel Indica il modello di licenza della distribuzione. UserDevice
productEdition Indica l’edizione del prodotto della distribuzione. Premium
productId Indica l’ID del prodotto nella distribuzione. CAVDS
protocol Indica il protocollo utilizzato per avviare la sessione. HDX™
sessionKey Indica un identificatore univoco per la sessione. uq390c5fc3-86eb-4df3-bd9a-f4a8fed2c9e2
sessionSupport Indica il tipo di supporto della sessione. SingleSession
sessionType Indica il tipo di sessione. Application
ver Indica la versione del payload. 1.3
workerSid Indica un identificatore univoco per il VDA utilizzato per la sessione. Il valore è offuscato. 1E5LH671A44B3F7 (sempre offuscato)
isWindows365 Indica se la sessione è avviata per Windows 365. True
entitlementType Indica il tipo di diritto di licenza del cliente. Production
siteId Indica un identificatore univoco per il sito. a35647d0-901c-4477-87e0-dcd781d455f4
desktopGroupId Indica un identificatore univoco per il gruppo di desktop o di consegna. e9d859dc-1bfc-4b3e-bad3-41806bb4e694
clientType Indica il tipo di app Citrix Workspace™. Windows
clientVersion Indica la versione dell’app Citrix Workspace. 23.5.1.83
workerCloudType Indica il tipo di cloud pubblico utilizzato per il provisioning VDA. Azure
enabledFeatures Indica le funzionalità abilitate per la sessione. Ad esempio, in una sessione in cui AppProtectionScreenCaptureRequired e SessionRecording sono abilitati, il valore di questo campo è 66. 66
launchRequestSource
Registra il prodotto utilizzato per richiedere l’avvio. Può essere StoreFront™ on-premise o StoreFront cloud.
0 (StoreFront or 3P)
1 (Workspace)
isEvents Indica gli errori critici in . Unable to create ST Database.
heartBeatTime Indica il tempo di heartbeat del server licenze a CIS o Citrix Analytic Service. 1689058813
vdaTelemetry









Indica il payload acquisito per le funzionalità App Layering, User Personalization Layer, User Profile Management, Workspace Environment Management™ e 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

Utilizzo

Intestazioni

Campo Descrizione Esempio
ver Indica la versione dell’evento di utilizzo della licenza. 1
id Indica un identificatore univoco dell’evento di utilizzo. 8c2e20a5-ca3f-4401-ad69-d037933c40a0
type Indica il tipo di evento utilizzato da Citrix Analytic Service per identificare gli eventi di utilizzo del cloud. Studio.Usage
st Indica il timestamp di generazione dell’evento in Studio. 2024-03-22T01:32:23.4056195Z
prod Identifica il prodotto di origine e la distribuzione dell’evento di utilizzo. XenDesktop.Studio
prodVer Indica la versione del prodotto Citrix DaaS/Citrix Virtual Apps and Desktops. 7.42.0.0

Payload

Campo Descrizione Esempio
AdminLoginList Indica l’elenco degli SamAccountName degli amministratori univoci. Il valore è offuscato. {AdminLoginList: [UFMJ+JvXOTHO9mQDsOweiw= =]}(sempre offuscato)
TotalApiRequests Indica le richieste API del servizio di orchestrazione. {TotalApiRequests: 1000}
BackupCount Indica il numero di backup operati dall’amministratore di Studio. {BackupCount: 200}
RestoreCount Indica il numero di ripristini operati dall’amministratore di Studio. {RestoreCount: 20}

Director

Report sull’utilizzo

Intestazioni

Campo Descrizione Esempio
ver Indica la versione dell’evento di utilizzo della licenza. 1
id Indica un identificatore univoco dell’evento di utilizzo. 8c2e20a5-ca3f-4401-ad69-d037933c40a0
type Indica il tipo di evento utilizzato da Citrix Analytic Service per identificare gli eventi di utilizzo del cloud. Telemetry
st Indica il timestamp di generazione dell’evento in Studio. 2024-03-22T01:32:23.4056195Z
prod Identifica il prodotto di origine e la distribuzione dell’evento di utilizzo. XenApp.Monitor
prodVer Indica la versione del prodotto Director. 7.42.0.0
dvcName Nome del server C758LH671A44B3F7

Payload

Campo Descrizione Esempio
AdminLoginCount


Questa è una sezione del payload che fornisce il conteggio degli accessi degli amministratori.


type: AdminLogin
stats
          0: 1
                1: 7
FeatureUsageCount



Questa sezione del payload contiene il conteggio delle funzionalità principali utilizzate in Director.



  type: FeatureUsage
         stats
                 0: 15
                 1: 20
                 5: 10
OdataUsageCount








Questa sezione del payload contiene il conteggio dell’utilizzo dell’API OData.








type: OData_v3
         stats
                 0: 1
                 2: 7
                 5: 9
 type: OData_v4
        stats
                0: 1
                2: 8
                6: 7
AppUsage




Indica le metriche di utilizzo settimanale delle applicazioni pubblicate.




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




Indica il conteggio degli utenti univoci e il numero totale di avvii di app in un mese per le applicazioni pubblicate.




type: UniqueAppUsers
    headers: applicationName,totalLaunches,totalUniqueUsers
    period: 04/24
    values: [
        Calc_AWTSVDA-1907R,100,10,
        Notepad_AWTSVDA-1907R,200,20]
DesktopUsage



Indica le metriche di utilizzo settimanale dei desktop pubblicati.



type: DesktopUsage
    headers: desktopGroupName,sessionSupport,totalDurationInMinutes
    period: 01/05/24-07/05/24
    values: [
        RdsDesktopAndAppGroup,1,10]
UniqueDesktopUsers



Indica il conteggio degli utenti univoci e il numero totale di avvii in un mese per i desktop pubblicati.



type: UniqueDesktopUsers
    headers: desktopGroupName,totalLaunches,totalUniqueUsers
    period: 04/24
    values: [
        RdsDesktopAndAppGroup,10,5]
AvgLogonDuration



Indica la durata media del logon.



type: AvgLogonDuration
    headers: totalUserLogons, avgLogonDurationInSeconds
    period: 01/05/24-07/05/24
    values: [
        200,4]
CostSaved




Indica il costo risparmiato dal cliente in un mese.




type: CostSaved
    headers: hypervisor,costSaved,currency
    period: 04/24
    values: [
        1,221.02,1
        2,301.02,2]

Configurazione di StoreFront

Utilizzo

Intestazioni

Campo Descrizione Esempio
ver Indica la versione dell’evento di utilizzo della licenza 1.0
id Indica l’identificatore univoco dell’evento di utilizzo d4ce7919-5d80-44de-a8fa-102923fe0ead
type Indica il tipo di evento utilizzato da CAS per identificare gli eventi di utilizzo del cloud Configuration
st Indica il timestamp di generazione dell’evento in StoreFront 2011-08-12T20:17:46.384Z
prod Identifica il prodotto di origine e la distribuzione dell’evento di utilizzo OnPrem.StoreFront
prodVer Indica la versione di StoreFront (interna) 3.30.0.0

Payload

Campo Descrizione Esempio
serverName Indica il nome host del servizio su cui è in esecuzione StoreFront storefront-01.storefront.local
deploymentId Indica l’identificatore univoco della distribuzione di StoreFront f47ac10b-58cc-4372-a567-0e02b2c3d479
installedWithCVAD Indica se StoreFront è stato installato insieme a CVAD false
cpuCores Indica il numero totale di core CPU 4
cpuModel Indica la CPU su cui è in esecuzione StoreFront 12th Gen Intel(R) Core(TM) i7-1255U 1.70 GHz
ramGb Indica la quantità totale di RAM in GB 16
numServersInGroup Indica il numero di server nel gruppo di server 3
stores Indica il blob JSON di configurazione dello Store di StoreFront. Un array di oggetti Store. Alcuni valori sono offuscati. Example
rfWebSites Indica il blob JSON di configurazione RFWeb di StoreFront. Un array di oggetti di configurazione RFWeb. Example
gateways Indica gli oggetti di configurazione del gateway come blob JSON. Un array di oggetti gateway. Example
authServices Indica gli oggetti di configurazione del servizio di autenticazione come blob JSON. Un array di oggetti del servizio di autenticazione. Example
IsPiiScrambled true

Esempio del campo 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-->

Se non vengono trovati Store, sarà un array vuoto [].

Esempio del campo 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-->

Se non vengono trovati rfWebSites, sarà un array vuoto [].

Esempio del campo gateways

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

Se non vengono trovati gateway, sarà un array vuoto [].

Esempio del campo authServices

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

Se non vengono trovati servizi di autenticazione, sarà un array vuoto [].

Accesso a StoreFront

Utilizzo

Intestazioni

Campo Descrizione Esempio
ver Indica la versione dell’evento di utilizzo della licenza 1.0
id Indica l’identificatore univoco dell’evento di utilizzo d4ce7919-5d80-44de-a8fa-102923fe0ead
type Indica il tipo di evento utilizzato da CAS per identificare gli eventi di utilizzo del cloud Login
st Indica il timestamp di generazione dell’evento nel Broker 2011-08-12T20:17:46.384Z
prod Identifica il prodotto di origine e la distribuzione dell’evento di utilizzo OnPrem.StoreFront
prodVer Versione di StoreFront (interna) 3.30.0.0

Payload

Campo Descrizione Esempio
user



L’utente che ha avviato l’operazione. Il valore è offuscato.



fullName: C648FE671A44B3F7 (sempre offuscato)
samName:C758LH671A44B3F7 (sempre offuscato)
upn: C7948FE671A44B3F7 (sempre offuscato)
userLicenseId:C265FE671A44B3F7 (sempre offuscato)
userSid: C097FE671A44B3F7 (sempre offuscato)
serverName Indica il nome host del servizio su cui è in esecuzione StoreFront storefront-01.storefront.local
loginMethodRfWeb Indica il metodo utilizzato dall’utente per accedere a StoreFront da RFWeb 0
loginMethodAuth Indica il metodo utilizzato dall’utente per accedere a StoreFront dal servizio di autenticazione 0
gatewayURL Indica il Netscaler Gateway utilizzato durante l’accesso netscaler-gateway.com
enabledFeatures Indica una maschera di bit delle funzionalità abilitate 12
userAgent Indica lo UserAgent del client utilizzato per l’accesso CitrixReceiver/22.11.0.19 Linux/5.17.15 X1Class CWACapable CWA/22.11.0.19
baseUrl Indica lo store a cui l’utente accede storefront-dev.storefront.dev
storePath Indica lo store a cui l’utente accede /Citirx/StoreWeb
apiUsed Indica se il client sta utilizzando l’API Store o PNAgent 0
deviceId Indica il dispositivo utilizzato per accedere a StoreFront. Il valore è offuscato. john-doe
transactionId Indica l’ID della transazione che viene inviato/generato durante una singola transazione 773aba9e-5b91-4ef9-8782-c4afb75698e7

Amministrazione delegata

Utilizzo

Intestazioni

Chiave Descrizione Esempio
ver Indica la versione dell’evento di utilizzo della licenza. 1
id Indica un identificatore univoco dell’evento di utilizzo. 8c2e20a5-ca3f-4401-ad69-d037933c40a0
type Indica il tipo di evento utilizzato da Citrix Analytic Service per identificare gli eventi di utilizzo del cloud. DelegatedAdmin.Usage
st Indica il timestamp di generazione dell’evento in Delegated Admin. 2024-03-22T01:32:23.4056195Z
prod
Identifica il prodotto di origine e la distribuzione dell’evento di utilizzo.
XenDesktop.DelegatedAdmin (Cloud)
OnPrem.DelegatedAdmin (OnPrem)
prodVer Indica la versione del prodotto Citrix DaaS o Citrix Virtual Apps and Desktops. 7.42.0.0

Payload

Chiave Descrizione Esempio
TotalCustomScopes Indica il numero totale di ambiti personalizzati. 2
TotalCustomRoles Indica il numero totale di ruoli personalizzati. 4

Offuscare i dati di telemetria delle licenze

Considerando la sensibilità delle informazioni inviate nella telemetria delle licenze, Citrix offre un’opzione per offuscare i dati.

La tabella seguente elenca i dati che possono essere offuscati:

Campo Descrizione Esempio
user



Identifica l’ID utente per identificare in modo univoco un utente che avvia la sessione.



  • fullName: C648FE671A44B3F7
  • samName: C758LH671A44B3F7
  • upn: C7948FE671A44B3F7
  • userLicenseId: C265FE671A44B3F7
  • userSid: C097FE671A44B3F7
dvc -> dvcName Indica il nome descrittivo del dispositivo. C758LH671A44B3F7
workerSid Indica un identificatore univoco per il VDA utilizzato per la sessione. 1E5LH671A44B3F7
AdminLoginList Indica l’elenco degli SamAccountName degli amministratori univoci. {AdminLoginList: [UFMJ+JvXOTHO9mQDsOweiw= =]}
stores Indica il blob JSON di configurazione dello Store di StoreFront. Un array di oggetti Store. Alcuni valori sono offuscati. Example
deviceId Indica il dispositivo utilizzato per accedere a StoreFront. john-doe

Per abilitare o disabilitare l’offuscamento, eseguire i seguenti comandi PowerShell sul Delivery Controller.

  1. Aprire una finestra PowerShell dall’host del Delivery Controller.
  2. Eseguire il comando asnp citrix per caricare i moduli PowerShell specifici di Citrix.
  3. Eseguire il comando seguente per abilitare o disabilitare l’offuscamento:

Per impostazione predefinita, il valore è 1, o true, che abilita l’offuscamento dei dati di telemetria delle licenze.

Per disabilitare:

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

Nota:

Per un cliente Citrix Service Provider™ (CSP), l’offuscamento è disabilitato per impostazione predefinita.

Dopo aver disabilitato l’offuscamento, è possibile abilitarlo utilizzando il comando seguente:

Set-BrokerServiceConfigurationData Core.ScrambleLicensingData -SettingValue $true
<!--NeedCopy-->
Elementi dei dati di telemetria di Citrix Virtual Apps and Desktops™