Citrix Virtual Apps and Desktops

Elementi di 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 ogni 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. 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 Vertical Autoscale 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 l’avvio della 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 viene avviata con la protezione dalla registrazione dei tasti abilitata. False
appProtectionScreenCaptureRequired Indica se la sessione viene avviata con la protezione dalla cattura dello schermo abilitata. False
cspTenantCustomerId Indica l’ID cliente di un account Citrix Cloud del tenant CSP. Per la distribuzione on-premise, questo campo non è applicabile e non ha valore. 6c2vtxgxyftt
isAnonymousUser Indica se viene 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 l’assegnazione o il 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-prem o Cloud StoreFront.
0 (StoreFront o 3P)
1 (Workspace)
isEvents Indica i guasti critici in . Impossibile creare il database ST.
heartBeatTime Indica il tempo di heartbeat del server licenze a CIS o Citrix Analytic Service. 1689058813
vdaTelemetry









Indica il payload acquisito per App Layering, User Personalization Layer, User Profile Management, Workspace Environment Management™ e le funzionalità 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 di 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 unici insieme al totale degli 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 unici insieme al totale degli 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 della 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 Esempio
rfWebSites Indica il blob JSON di configurazione RFWeb di StoreFront. Un array di oggetti di configurazione RFWeb Esempio
gateways Indica gli oggetti di configurazione del gateway come blob JSON. Un array di oggetti gateway Esempio
authServices Indica gli oggetti di configurazione del servizio di autenticazione come blob JSON. Un array di oggetti del servizio di autenticazione Esempio
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 in 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 il lancio. 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 Auth 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 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 Amministrazione Delegata. 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 seguente tabella elenca i dati che possono essere offuscati:

Campo Descrizione Esempio
user



Identifica l’ID utente per identificare in modo univoco un utente che avvia il lancio della 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 unici {AdminLoginList: [UFMJ+JvXOTHO9mQDsOweiw= =]}
stores Indica il blob JSON di configurazione dello Store di StoreFront. Un array di oggetti Store. Alcuni valori sono offuscati Esempio
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 seguente comando 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 seguente comando:

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