Servizi di Citrix Insight
Citrix Insight Services (CIS) è una piattaforma Citrix per la strumentazione, la telemetria e la generazione di informazioni aziendali. Le sue capacità di strumentazione e telemetria consentono agli utenti tecnici (clienti, partner e ingegneri) di autodiagnosticare e risolvere i problemi e ottimizzare i propri ambienti. Per maggiori dettagli e informazioni aggiornate su CIS e sul suo funzionamento, consultare https://cis.citrix.com (sono necessarie le credenziali dell’account Citrix).
Tutte le informazioni caricate su Citrix vengono utilizzate per scopi diagnostici e di risoluzione dei problemi e per migliorare la qualità, l’affidabilità e le prestazioni dei prodotti, a condizione che:
- Politica dei servizi Citrix Insight su https://cis.citrix.com/legal
- Informativa sulla privacy di Citrix su https://www.cloud.com/privacy-policy
Questa versione di Citrix Virtual Apps and Desktops supporta le seguenti tecnologie.
- Analisi di installazione e aggiornamento di Citrix Virtual Apps and Desktops
- Programma di miglioramento dell’esperienza del cliente Citrix (CEIP)
- Citrix Chiama Casa
- Esploratore Citrix
Oltre a (e separatamente da) CIS e Citrix Analytics: i dati di Google Analytics vengono raccolti (e successivamente caricati) automaticamente quando installi (o aggiorni) Studio. Dopo aver installato Studio, è possibile modificare questa impostazione tramite la chiave di registro HKLM\Software\Citrix\DesktopStudio\GAEnabled. Il valore 1 abilita la raccolta e il caricamento, il valore 0 disabilita la raccolta e il caricamento.
Installa e aggiorna l’analisi
Quando si utilizza il programma di installazione completo del prodotto per distribuire o aggiornare i componenti di Citrix Virtual Apps and Desktops, le informazioni anonime sul processo di installazione vengono raccolte e archiviate sul computer in cui si sta installando/aggiornando il componente. Questi dati vengono utilizzati per aiutare Citrix a migliorare l’esperienza di installazione dei propri clienti.
Le informazioni vengono memorizzate localmente in %ProgramData%\Citrix\CTQs.
Il caricamento automatico di questi dati è abilitato per impostazione predefinita sia nell’interfaccia grafica che in quella della riga di comando del programma di installazione completo del prodotto.
- È possibile modificare il valore predefinito in un’impostazione del registro. Se si modifica l’impostazione del registro prima dell’installazione/aggiornamento, tale valore verrà utilizzato quando si utilizza il programma di installazione completo del prodotto.
- È possibile ignorare l’impostazione predefinita se si esegue l’installazione/l’aggiornamento tramite l’interfaccia della riga di comando specificando un’opzione con il comando.
Controlla i caricamenti automatici:
-
Impostazione del registro che controlla il caricamento automatico delle analisi di installazione/aggiornamento (predefinito = 1):
- Posizione: HKLM:\Software\Citrix\MetaInstall
- Nome: SendExperienceMetrics
- Valore: 0 = disabilitato, 1 = abilitato
-
Utilizzando PowerShell, il seguente cmdlet disabilita il caricamento automatico delle analisi di installazione/aggiornamento:
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\MetaInstall -Name SendExperienceMetrics -PropertyType DWORD -Value 0
-
Per disabilitare i caricamenti automatici con il comando XenDesktopServerSetup.exe o XenDesktopVDASetup.exe, includere l’opzione
/disableexperiencemetrics
.Per abilitare i caricamenti automatici con il comando XenDesktopServerSetup.exe o XenDesktopVDASetup.exe, includere l’opzione
/sendexperiencemetrics
.
Programma di miglioramento dell’esperienza del cliente Citrix
Quando si partecipa al Citrix Customer Experience Improvement Program (CEIP), statistiche anonime e informazioni sull’utilizzo vengono inviate a Citrix per aiutarla a migliorare la qualità e le prestazioni dei suoi prodotti. Per ulteriori informazioni, vedere https://more.citrix.com/XD-CEIP.
Iscrizione durante la creazione o l’aggiornamento del sito
L’iscrizione al CEIP avviene automaticamente quando si crea un sito (dopo aver installato il primo Delivery Controller). Il primo caricamento dei dati avviene circa sette giorni dopo la creazione del Sito. Puoi interrompere la tua partecipazione in qualsiasi momento dopo aver creato il Sito. Selezionare il nodo Configurazione nel riquadro di navigazione dello Studio (schedaSupporto prodotto ) e seguire le istruzioni.
Quando si aggiorna una distribuzione di Citrix Virtual Apps and Desktops:
- Se esegui l’aggiornamento da una versione che non supporta CEIP, ti verrà chiesto se desideri partecipare.
- Se esegui l’aggiornamento da una versione che supportava CEIP e la partecipazione era abilitata, CEIP sarà abilitato nel sito aggiornato.
- Se esegui l’aggiornamento da una versione che supportava CEIP e la partecipazione è stata disabilitata, CEIP sarà disabilitato nel sito aggiornato.
- Se esegui l’aggiornamento da una versione che supportava CEIP e la partecipazione non è nota, ti verrà chiesto se desideri partecipare.
Le informazioni raccolte sono anonime, quindi non possono essere visualizzate dopo essere state caricate su Citrix Insight Services.
Registrazione durante l’installazione di un VDA
Per impostazione predefinita, quando si installa un Windows VDA si viene automaticamente registrati al CEIP. È possibile modificare questa impostazione predefinita tramite un’impostazione del registro. Se si modifica l’impostazione del registro prima di installare VDA, verrà utilizzato tale valore.
Impostazione del registro che controlla l’iscrizione automatica al CEIP (predefinito = 1):
Posizione: HKLM: \Software\Citrix\Telemetry\CEIP Nome: Abilitato Valore: 0 = disabilitato, 1 = abilitato
Per impostazione predefinita, la proprietà Enabled
è nascosta nel registro. Se non è specificato, la funzione di caricamento automatico è abilitata.
Utilizzando PowerShell, il seguente cmdlet disabilita l’iscrizione al CEIP:
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\Telemetry\CEIP -Name Enabled -PropertyType DWORD -Value 0
I punti dati di runtime raccolti vengono scritti periodicamente come file in una cartella di output (predefinita %programdata%/Citrix/VdaCeip).
Il primo caricamento dei dati avviene circa sette giorni dopo l’installazione del VDA.
Registrazione durante l’installazione di altri prodotti e componenti
È possibile partecipare al CEIP anche installando prodotti, componenti e tecnologie Citrix correlati, come Citrix Provisioning, AppDNA, Citrix License Server, Citrix Workspace app per Windows, Universal Print Server e Session Recording. Per maggiori dettagli sui valori predefiniti di installazione e partecipazione, consultare la documentazione.
Citrix Chiama Casa
Quando installi determinati componenti e funzionalità in Citrix Virtual Apps and Desktops, ti viene offerta l’opportunità di partecipare a Citrix Call Home. Call Home raccoglie dati diagnostici e poi carica periodicamente pacchetti di telemetria contenenti tali dati direttamente su Citrix Insight Services (tramite HTTPS sulla porta predefinita 443) per l’analisi e la risoluzione dei problemi.
In Citrix Virtual Apps and Desktops, Call Home viene eseguito come servizio in background con il nome Citrix Telemetry Service. Per ulteriori informazioni, vedere https://more.citrix.com/XD-CALLHOME.
La funzionalità di pianificazione Call Home è disponibile anche in Citrix Scout. Per maggiori dettagli, vedere Citrix Scout.
Cosa viene raccolto
I registri di tracciamento Citrix Diagnostic Facility (CDF) contengono informazioni che possono essere utili per la risoluzione dei problemi. Call Home raccoglie un sottoinsieme di tracce CDF che possono essere utili per la risoluzione di errori comuni, ad esempio registrazioni VDA e avvii di applicazioni/desktop. Questa tecnologia è nota come tracciamento sempre attivo (AOT). I registri AOT vengono salvati sul disco in C:\Users\CitrixTelemetryService\Appdata\Local\CitrixAOT.
Call Home non raccoglie altre informazioni di Event Tracing for Windows (ETW), né può essere configurato per farlo.
Call Home raccoglie anche altre informazioni, come:
- Registri creati da Citrix Virtual Apps and Desktops in
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix
. - Informazioni su Windows Management Instrumentation (WMI) nello spazio dei nomi Citrix.
- Elenco dei processi in esecuzione.
- Dump di crash dei processi Citrix archiviati in %PROGRAM DATA%\Citrix\CDF.
- Informazioni sull’installazione e l’aggiornamento. Ciò può includere il registro completo del metainstaller del prodotto, i registri MSI non riusciti, l’output dell’analizzatore di registri MSI, i registri StoreFront, i registri di controllo della compatibilità delle licenze e i risultati dei test preliminari di aggiornamento del sito.
Le informazioni di traccia vengono compresse durante la raccolta. Citrix Telemetry Service conserva un massimo di 10 MB di informazioni di traccia recenti compresse, con un limite di tempo massimo di otto giorni.
- La compressione dei dati consente a Call Home di occupare un minimo spazio sul VDA.
- Le tracce vengono conservate nella memoria per evitare operazioni IOPS sulle macchine fornite.
- Il buffer di traccia utilizza un meccanismo circolare per conservare le tracce nella memoria.
Call Home raccoglie i punti dati chiave elencati in Punti dati chiave di Call Home.
Configurare e gestire il riepilogo
È possibile registrarsi a Call Home utilizzando la procedura guidata di installazione completa del prodotto o in un secondo momento, utilizzando i cmdlet di PowerShell. Per impostazione predefinita, al momento della registrazione i dati diagnostici vengono raccolti e caricati su Citrix ogni domenica alle 3:00 circa, ora locale. Il caricamento è casuale con un intervallo di due ore a partire dall’orario specificato. Ciò significa che il caricamento con la pianificazione predefinita avviene tra le 3:00 e le 5:00 del mattino.
Se non si desidera caricare informazioni diagnostiche secondo una pianificazione (o se si desidera modificare una pianificazione), è possibile utilizzare i cmdlet di PowerShell per raccogliere e caricare manualmente le informazioni diagnostiche o archiviarle localmente.
Quando ti iscrivi ai caricamenti programmati di Call Home e quando carichi manualmente le informazioni diagnostiche su Citrix, fornisci le credenziali dell’account Citrix o di Citrix Cloud. Citrix scambia le credenziali con un token di caricamento che viene utilizzato per identificare il cliente e caricare i dati. Le credenziali non vengono salvate.
Quando avviene un caricamento, viene inviata una notifica via e-mail all’indirizzo associato all’account Citrix.
Se abiliti Chiama casa quando installi un componente, puoi disabilitarlo in seguito.
Prerequisiti
- Il computer deve eseguire PowerShell 3.0 o versione successiva.
- Il servizio Citrix Telemetry deve essere in esecuzione sulla macchina.
- La variabile di sistema
PSModulePath
deve essere impostata sul percorso di installazione di Telemetry, ad esempio C:\Programmi\Citrix\Telemetry Service\.
Abilita Call Home durante l’installazione dei componenti
Durante l’installazione o l’aggiornamento di VDA: Quando installi o aggiorni un Virtual Delivery Agent utilizzando l’interfaccia grafica nel programma di installazione completo del prodotto, ti viene chiesto se desideri partecipare a Call Home. Ci sono due opzioni:
- Partecipa a Call Home.
- Non partecipare a Call Home.
Se stai aggiornando un VDA e in precedenza eri iscritto a Call Home, la pagina della procedura guidata non verrà visualizzata.
Durante l’installazione o l’aggiornamento del Controller: Quando installi o aggiorni un Delivery Controller utilizzando l’interfaccia grafica, ti viene chiesto se desideri partecipare a Call Home. Ci sono tre opzioni:
Quando si installa un Controller, non è possibile configurare le informazioni nella pagina Chiama Home nella procedura guidata di installazione se il server dispone di un GPO di Active Directory con l’impostazione del criterio “Accedi come servizio” applicata. Per i dettagli, vedere CTX218094.
Se stai aggiornando un Controller e in precedenza eri iscritto a Call Home, non ti verrà chiesto di partecipare.
Cmdlet di PowerShell
La guida di PowerShell fornisce una sintassi completa, comprese le descrizioni dei cmdlet e dei parametri che non vengono utilizzati in questi casi d’uso comuni.
Per utilizzare un server proxy per i caricamenti, vedere Configurare un server proxy.
-
Abilita caricamenti pianificati: Le raccolte diagnostiche vengono caricate automaticamente su Citrix. Se non si immettono cmdlet aggiuntivi per una pianificazione personalizzata, verrà utilizzata la pianificazione predefinita.
$cred = Get-Credential Enable-CitrixCallHome -Credential $cred
Per confermare che i caricamenti pianificati sono abilitati, immettere
Get-CitrixCallHome
. Se abilitato, il ritorno èIsEnabled=True
eIsMasterImage=False
. -
Abilita caricamenti pianificati per le macchine create da un’immagine master: L’abilitazione dei caricamenti pianificati in un’immagine master elimina la necessità di configurare ogni macchina creata nel catalogo macchine.
Enable-CitrixCallHome -Credential $cred -MasterImage
Per confermare che i caricamenti pianificati sono abilitati, immettere Get-CitrixCallHome. Se abilitato, il ritorno è
IsEnabled=True
eIsMasterImage=True
. -
Crea una pianificazione personalizzata: Crea una pianificazione giornaliera o settimanale per le raccolte e i caricamenti diagnostici.
$timespan = New-TimeSpan –Hours hours -Minutes minutes Set-CitrixCallHomeSchedule –TimeOfDay $timespan –DayOfWeek day -UploadFrequency {Daily|Weekly}
Esempi:
Il seguente cmdlet crea una pianificazione per raggruppare e caricare i dati alle 10:20 ogni sera. Il parametro Ore utilizza un orologio a 24 ore. Quando il valore del parametro UploadFrequency
è Daily, il parametro DayOfWeek
viene ignorato, se specificato.
$timespan – New-TimeSpan –Hours 22 –Minutes 20
Set-CitrixCallHomeSchedule –TimeOfDay $timespan -UploadFrequency Daily
Per confermare la pianificazione, immettere Get-CitrixCallHomeSchedule
. Nell’esempio precedente, restituisce StartTime=22:20:00, DayOfWeek=Domenica (ignorato), Upload Frequency=Giornaliero
.
Il seguente cmdlet crea una pianificazione per raggruppare e caricare i dati alle 10:20 di ogni mercoledì sera.
$timespan – New-TimeSpan –Hours 22 –Minutes 20
Set-CitrixCallHomeSchedule –TimeOfDay $timespan –DayOfWeek Wed -UploadFrequency Weekly
Per confermare la pianificazione, immettere Get-CitrixCallHomeSchedule
. Nell’esempio precedente, restituisce StartTime=22:20:00, DayOfWeek=Mercoledì, Frequenza di caricamento=Settimanale
.
Disattiva Chiama Casa
È possibile disattivare Call Home utilizzando un cmdlet di PowerShell o tramite Citrix Scout.
I registri AOT vengono raccolti e salvati su disco, anche quando i caricamenti programmati di Call Home sono disattivati. (Quando i caricamenti pianificati sono disabilitati, i registri AOT non vengono caricati automaticamente su Citrix.) È possibile disabilitare la raccolta e l’archiviazione locale dei registri AOT.
Disabilitare la chiamata a casa con PowerShell
Dopo aver eseguito il seguente cmdlet, i dati diagnostici non verranno caricati automaticamente su Citrix. (È comunque possibile caricare dati diagnostici utilizzando Citrix Scout o i cmdlet di telemetria di PowerShell.)
Disable-CitrixCallHome
Per confermare che Call Home è disabilitato, immettere Get-CitrixCallHome
. Se disabilitato, il ritorno è IsEnabled=False
e IsMasterImage=False
.
Disabilitare una pianificazione di raccolta tramite Citrix Scout
Per disattivare una pianificazione di raccolta diagnostica utilizzando Citrix Scout, seguire le istruzioni in Pianificazione raccolte. Nel passaggio 3, fare clic su Off per annullare la pianificazione per le macchine selezionate.
Disabilita la raccolta dei log AOT
Dopo aver eseguito il seguente cmdlet (con il campo Enabled
impostato su false
), i registri AOT non verranno raccolti.
Enable-CitrixTrace -Listen‘{“trace”:{“enabled”:false,“persistDirectory”:“C:\Users\Public”,”maxSizeBytes”:1000000, “sliceDurationSeconds”:300}}’
Il parametro Listen
contiene argomenti in formato JSON.
Configurare un server proxy per i caricamenti di Call Home
Completare le seguenti attività sul computer su cui è abilitata la funzione Chiama casa. I diagrammi di esempio nella seguente procedura contengono l’indirizzo del server e la porta 10.158.139.37:3128. Le tue informazioni saranno diverse.
-
Aggiungi le informazioni sul server proxy nel tuo browser. In Internet Explorer, seleziona Opzioni Internet > Connessioni > Impostazioni LAN. Seleziona Usa un server proxy per la tua LAN” e inserisci l’indirizzo del server proxy e il numero di porta.
-
In PowerShell, eseguire
netsh winhttp import proxy source=ie
. -
Utilizzando un editor di testo, modificare il file di configurazione TelemetryService.exe, che si trova in C:\Programmi\Citrix\Telemetry Service. Aggiungi le informazioni mostrate nella casella rossa.
-
Riavviare il servizio di telemetria.
Eseguire i cmdlet Call Home in PowerShell.
Raccogliere e caricare manualmente le informazioni diagnostiche
È possibile utilizzare il sito web del CIS per caricare un pacchetto di informazioni diagnostiche sul CIS. È anche possibile utilizzare i cmdlet di PowerShell per raccogliere e caricare informazioni diagnostiche su CIS.
Per caricare un bundle utilizzando il sito web CIS:
- Accedi a Citrix Insight Services utilizzando le credenziali del tuo account Citrix.
- Seleziona Il mio spazio di lavoro.
- Seleziona Healthcheck e poi vai alla posizione dei tuoi dati.
CIS supporta diversi cmdlet di PowerShell che gestiscono i caricamenti dei dati. Questa documentazione copre i cmdlet per due casi comuni:
- Utilizzare il cmdlet
Start-CitrixCallHomeUpload
per raccogliere manualmente e caricare un bundle di informazioni diagnostiche su CIS. (Il pacchetto non viene salvato localmente.) - Utilizzare il cmdlet
Start-CitrixCallHomeUpload
per raccogliere manualmente i dati e archiviare localmente un bundle di informazioni diagnostiche. Ciò consente di visualizzare in anteprima i dati. Successivamente, utilizzare il cmdletSend-CitrixCallHomeBundle
per caricare manualmente una copia di tale bundle su CIS. (I dati salvati originariamente rimangono localmente.)
La guida di PowerShell fornisce una sintassi completa, comprese le descrizioni dei cmdlet e dei parametri che non vengono utilizzati in questi casi d’uso comuni.
Quando si immette un cmdlet per caricare dati su CIS, viene richiesto di confermare il caricamento. Se il cmdlet scade prima del completamento del caricamento, controllare lo stato del caricamento nel registro eventi di sistema. La richiesta di caricamento potrebbe essere rifiutata se il servizio sta già eseguendo un caricamento.
Raccogli i dati e carica il bundle su CIS:
Start-CitrixCallHomeUpload [-Credential] PSCredential [-InputPath string] [-Description string] [-IncidentTime string] [-SRNumber string] [-Name string] [-UploadHeader string] [-AppendHeaders string] [-Collect string] [<CommonParameters>]
Raccogli i dati e salvali localmente:
Start-CitrixCallHomeUpload -OutputPath <String> [-InputPath string] [-Description string] [-IncidentTime string] [-SRNumber string] [-Name string] [-UploaderHeader string] [-AppendHeaders string] [-Collect strings] [<CommonParameters>]
Sono validi i seguenti parametri:
- Credenziale: Indirizza il caricamento al CIS.
- InputPath: Posizione del file zip da includere nel bundle. Potrebbe trattarsi di un file aggiuntivo richiesto dal supporto Citrix. Assicuratevi di includere l’estensione .zip.
- OutputPath: Posizione in cui vengono salvate le informazioni diagnostiche. Questo parametro è obbligatorio quando si salvano i dati di Call Home in locale.
- Descrizione e ora dell’incidente: Informazioni in formato libero sul caricamento.
- SRNumber: Numero incidente del supporto tecnico Citrix.
- Nome: Nome che identifica il bundle.
- UploadHeader: Stringa in formato JSON che specifica le intestazioni di caricamento caricate su CIS.
- AppendHeaders: Stringa in formato JSON che specifica le intestazioni aggiunte caricate su CIS.
-
Raccogli: Stringa in formato JSON che specifica quali dati raccogliere o omettere, nel formato {‘collector’:{‘enabled’:Boolean}}, dove Boolean è true o false. I valori validi del collettore sono:
- ‘wmi’
- ‘processo’
- ‘registro
- ‘rapporto di crash’
- ‘traccia’
- ‘file’
- ‘msi’
- ‘dati locali’
- ‘dati del sito’
- ‘sfb’
Per impostazione predefinita, tutti i collettori, tranne ‘sfb’, sono abilitati.
Il raccoglitore ‘sfb’ è progettato per essere utilizzato su richiesta per diagnosticare i problemi di Skype for Business. Oltre al parametro ‘enabled’, il raccoglitore ‘sfb’ supporta i parametri ‘account’ e ‘accounts’ per specificare gli utenti di destinazione. Utilizzare uno dei moduli:
- “-Raccogli “{‘sfb’:{‘account’:’dominio\\utente1’}}”
- “-Raccogli “{‘sfb’:{‘accounts’:[‘dominio\\utente1’, ‘dominio\\utente2’]}}”
- Parametri comuni: Vedere la guida di PowerShell.
Carica i dati precedentemente salvati localmente:
Send-CitrixCallHomeBundle -Credential <PSCredentia\> -Path string [<CommonParameters>]
Il parametro Path
specifica la posizione del bundle salvato in precedenza.
Esempi:
Il seguente cmdlet richiede il caricamento dei dati di Call Home (esclusi i dati del raccoglitore WMI) su CIS. Questi dati si riferiscono ai fallimenti di registrazione dei Citrix Provisioning VDA, rilevati alle ore 14:30 per il caso di supporto Citrix 123456. Oltre ai dati Call Home, nel pacchetto caricato è incorporato il file “c:\Diagnostics\ExtraData.zip”.
C:\PS\>Start-CitrixCallHomeUpload -InputPath "c:\Diagnostics\ExtraData.zip" -Description "Registration failures with Citrix Provisioning VDAs" -IncidentTime "14:30" -SRNumber 123456 -Name "RegistrationFailure-021812016" -Collect "{'wmi':{'enabled':false}}" -UploadHeader "{'key1':'value1'}" -AppendHeaders "{'key2':'value2'}"
Il seguente cmdlet salva i dati di Call Home relativi al caso di supporto Citrix 223344, annotato alle 8:15. I dati sono salvati nel file mydata.zip su una condivisione di rete. Oltre ai dati di Call Home, nel pacchetto salvato verrà incorporato il file “c:\Diagnostics\ExtraData.zip”.
C:\PS\>Start-CitrixCallHomeUpload -OutputPath \\mynetwork\myshare\mydata.zip -InputPath "c:\Diagnostics\ExtraData.zip" -Description "Diagnostics for incident number 223344" -IncidentTime "8:15" -SRNumber 223344
Il seguente cmdlet carica il bundle di dati salvato in precedenza.
$cred=Get-Credential
C:\PS>Send-CitrixCallHomeBundle –Credential $cred -Path \\mynetwork\myshare\mydata.zip