Citrix Insight Services
Citrix Insight Services (CIS) est une plateforme Citrix pour l’instrumentation, la télémétrie et la génération d’informations commerciales. Ses capacités d’instrumentation et de télémétrie permettent aux utilisateurs techniques (clients, partenaires et ingénieurs) d’auto-diagnostiquer et de résoudre les problèmes, et d’optimiser leurs environnements. Pour plus de détails et les dernières informations sur CIS et son fonctionnement, consultez https://cis.citrix.com (identifiants de compte Citrix requis).
Les fonctionnalités offertes par Citrix Insight Services continuent de croître et d’évoluer, et font désormais partie intégrante de Citrix Smart Tools. Citrix Smart Tools vous permet d’automatiser les tâches de déploiement, les vérifications d’intégrité et la gestion de l’alimentation. Pour plus d’informations sur ces technologies, consultez la documentation de Citrix Smart Tools.
Toutes les informations téléchargées vers Citrix sont utilisées à des fins de dépannage et de diagnostic, ainsi que pour améliorer la qualité, la fiabilité et les performances des produits, sous réserve des éléments suivants :
- Politique de Citrix Insight Services à l’adresse https://cis.citrix.com/legal
- Politique de confidentialité de Citrix à l’adresse https://www.citrix.com/about/legal/privacy.html
Cette version de XenApp et XenDesktop® prend en charge les outils et technologies suivants.
- Analyse de l’installation et de la mise à niveau de XenApp® et XenDesktop
- Programme d’amélioration de l’expérience client Citrix
- Citrix Smart Tools
- Citrix Call Home (faisant partie de Citrix Smart Tools)
- Citrix Scout
Analyse de l’installation et de la mise à niveau
Lorsque vous utilisez le programme d’installation complet du produit pour déployer ou mettre à niveau des composants XenApp ou XenDesktop, des informations anonymes sur le processus d’installation sont collectées et stockées sur la machine où vous installez/mettez à niveau le composant. Ces données sont utilisées pour aider Citrix à améliorer l’expérience d’installation de ses clients.
Les informations sont stockées localement sous %ProgramData%\Citrix\CTQs.
Le téléchargement automatique de ces données est activé par défaut dans les interfaces graphique et de ligne de commande de l’installateur complet du produit.
- Vous pouvez modifier la valeur par défaut dans un paramètre de registre. Si vous modifiez le paramètre de registre avant l’installation/la mise à niveau, cette valeur sera utilisée lorsque vous utiliserez l’installateur complet du produit.
- Vous pouvez remplacer le paramètre par défaut si vous installez/mettez à niveau avec l’interface de ligne de commande en spécifiant une option avec la commande.
Paramètre de registre qui contrôle le téléchargement automatique des analyses d’installation/mise à niveau (par défaut = 1) :
Emplacement : HKLM:\Software\Citrix\MetaInstall Nom : SendExperienceMetrics Valeur : 0 = désactivé, 1 = activé
À l’aide de PowerShell, l’applet de commande suivante désactive le téléchargement automatique des analyses d’installation/mise à niveau :
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\MetaInstall -Name SendExperienceMetrics -PropertyType DWORD -Value 0
Pour désactiver les téléchargements automatiques avec la commande XenDesktopServerSetup.exe ou XenDesktopVDASetup.exe, incluez l’option /disableexperiencemetrics.
Pour activer les téléchargements automatiques avec la commande XenDesktopServerSetup.exe ou XenDesktopVDASetup.exe, incluez l’option /sendexperiencemetrics.
Programme d’amélioration de l’expérience client Citrix (CEIP)
Lorsque vous participez au Programme d’amélioration de l’expérience client Citrix (CEIP), des statistiques anonymes et des informations d’utilisation sont envoyées à Citrix pour aider Citrix à améliorer la qualité et les performances des produits Citrix. Pour plus d’informations, consultez https://more.citrix.com/XD-CEIP.
Inscription lors de la création ou de la mise à niveau d’un site
Vous êtes automatiquement inscrit au CEIP lorsque vous créez un site XenApp ou XenDesktop (après avoir installé le premier Delivery Controller™). Le premier téléchargement de données a lieu environ sept jours après la création du site. Vous pouvez arrêter votre participation à tout moment après la création du site ; sélectionnez le nœud Configuration dans le volet de navigation de Studio (onglet Support produit) et suivez les instructions.
Lorsque vous mettez à niveau un déploiement XenApp ou XenDesktop :
- Si vous effectuez une mise à niveau à partir d’une version qui ne prenait pas en charge le CEIP, il vous est demandé si vous souhaitez participer.
- Si vous effectuez une mise à niveau à partir d’une version qui prenait en charge le CEIP et que la participation était activée, le CEIP sera activé dans le Site mis à niveau.
- Si vous effectuez une mise à niveau à partir d’une version qui prenait en charge le CEIP et que la participation était désactivée, le CEIP sera désactivé dans le Site mis à niveau.
- Si vous effectuez une mise à niveau à partir d’une version qui prenait en charge le CEIP et que la participation est inconnue, il vous est demandé si vous souhaitez participer.
Les informations collectées sont anonymes, elles ne peuvent donc pas être consultées après leur téléchargement vers Citrix Insight Services.
Inscription lors de l’installation d’un VDA
Par défaut, vous êtes automatiquement inscrit au CEIP lorsque vous installez un VDA Windows. Vous pouvez modifier ce paramètre par défaut dans un paramètre de registre. Si vous modifiez le paramètre de registre avant d’installer le VDA, cette valeur sera utilisée.
Paramètre de registre qui contrôle l’inscription automatique au CEIP (par défaut = 1) :
Emplacement : HKLM:\Software\Citrix\Telemetry\CEIP Nom : Enabled Valeur : 0 = désactivé, 1 = activé
Par défaut, la propriété « Enabled » est masquée dans le registre. Lorsqu’elle n’est pas spécifiée, la fonction de téléchargement automatique est activée.
À l’aide de PowerShell, la cmdlet suivante désactive l’inscription au CEIP :
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\Telemetry\CEIP -Name Enabled -PropertyType DWORD -Value 0
Les points de données d’exécution collectés sont périodiquement écrits sous forme de fichiers dans un dossier de sortie (par défaut %programdata%/Citrix/VdaCeip).
Le premier téléchargement de données a lieu environ sept jours après l’installation du VDA.
Inscription lors de l’installation d’autres produits et composants
Vous pouvez également participer au CEIP lorsque vous installez des produits, composants et technologies Citrix associés, tels que Provisioning Services, AppDNA, Citrix License Server, Citrix Receiver™ pour Windows, Universal Print Server et Session Recording. Consultez leur documentation pour plus de détails sur l’installation et les valeurs par défaut de participation.
Citrix Smart Tools
Vous pouvez activer l’accès à Smart Tools lors de l’installation d’un Delivery Controller.
L’option permettant d’activer l’accès à Smart Tools (et de participer à Call Home, si ce n’est pas déjà activé) est sélectionnée par défaut. Cliquez sur Connecter. Une fenêtre de navigateur s’ouvre et accède automatiquement à une page web Smart Services, où vous saisissez vos informations d’identification de compte Citrix Cloud™. (Si vous n’avez pas de compte Citrix Cloud, saisissez simplement vos informations d’identification de compte Citrix, et un nouveau compte Citrix Cloud est automatiquement créé pour vous.) Une fois authentifié, un certificat est installé silencieusement dans le répertoire de l’agent Smart Tools.
Pour utiliser les technologies Smart Tools, consultez la documentation Smart Tools.
Citrix Call Home
Lorsque vous installez certains composants et fonctionnalités dans XenApp ou XenDesktop, la possibilité de participer à Citrix Call Home vous est offerte. Call Home collecte des données de diagnostic, puis télécharge périodiquement des paquets de télémétrie contenant ces données directement vers Citrix Insight Services (via HTTPS sur le port par défaut 443) pour analyse et dépannage.
Dans XenApp et XenDesktop, Call Home s’exécute en tant que service d’arrière-plan sous le nom de Citrix Telemetry Service. Pour plus d’informations, consultez https://more.citrix.com/XD-CALLHOME.
La fonctionnalité de planification de Call Home est également disponible dans Citrix Scout. Pour plus de détails, consultez Citrix Scout.
Ce qui est collecté
Le traçage Citrix Diagnostic Facility (CDF) enregistre des informations qui peuvent être utiles pour le dépannage. Call Home collecte un sous-ensemble de traces CDF qui peuvent être utiles lors du dépannage des défaillances courantes, par exemple, les enregistrements VDA et les lancements d’applications/bureaux. Cette technologie est connue sous le nom de traçage permanent (AOT). Call Home ne collecte aucune autre information de traçage d’événements pour Windows (ETW), et ne peut pas être configuré pour le faire.
Call Home collecte également d’autres informations, telles que :
- Registres créés par XenApp et XenDesktop sous HKEY_LOCAL_MACHINE\SOFTWARE\Citrix
- Informations Windows Management Instrumentation (WMI) sous l’espace de noms Citrix
- Liste des processus en cours d’exécution
- Vidages sur incident des processus Citrix qui sont stockés dans %PROGRAM DATA%\Citrix\CDF
Les informations de trace sont compressées au fur et à mesure de leur collecte. Le service Citrix Telemetry conserve un maximum de 10 Mo d’informations de trace récentes compressées, avec une durée maximale de huit jours.
- La compression des données permet à Call Home de maintenir une faible empreinte sur le VDA.
- Les traces sont conservées en mémoire pour éviter les IOP sur les machines provisionnées.
- Le tampon de trace utilise un mécanisme circulaire pour conserver les traces en mémoire.
Call Home collecte ces points de données clés : Points de données clés de Call Home
Résumé de la configuration et de la gestion
Vous pouvez vous inscrire à Call Home lors de l’utilisation de l’assistant d’installation complet du produit ou ultérieurement, à l’aide des cmdlets PowerShell. Lorsque vous vous inscrivez, par défaut, les diagnostics sont collectés et téléchargés vers Citrix tous les dimanches vers 3h00 du matin, heure locale. Le téléchargement est aléatoire avec un intervalle de deux heures à partir de l’heure spécifiée. Cela signifie qu’un téléchargement utilisant la planification par défaut a lieu entre 3h00 et 5h00 du matin.
Si vous ne souhaitez pas télécharger d’informations de diagnostic de manière planifiée (ou si vous souhaitez modifier une planification), vous pouvez utiliser les cmdlets PowerShell pour collecter et télécharger manuellement les diagnostics ou les stocker localement.
Lorsque vous vous inscrivez aux téléchargements planifiés de Call Home et lorsque vous téléchargez manuellement des informations de diagnostic vers Citrix, vous fournissez les informations d’identification de votre compte Citrix ou de Citrix Cloud. Citrix échange les informations d’identification contre un jeton de téléchargement qui est utilisé pour identifier le client et télécharger les données. Les informations d’identification ne sont pas enregistrées.
Lorsqu’un téléchargement a lieu, une notification est envoyée par e-mail à l’adresse associée au compte Citrix.
Prérequis
- La machine doit exécuter PowerShell 3.0 ou une version ultérieure.
- Le service Citrix Telemetry doit être en cours d’exécution sur la machine.
- La variable système PSModulePath doit être définie sur le chemin d’installation de Telemetry, par exemple, C:\Program Files\Citrix\Telemetry Service\.
Activer Call Home lors de l’installation du composant
Lors de l’installation ou de la mise à niveau d’un VDA : Lorsque vous installez ou mettez à niveau un Virtual Delivery Agent à l’aide de l’interface graphique dans le programme d’installation complet du produit, il vous est demandé si vous souhaitez participer à Call Home. Deux options s’offrent à vous :
- Participer à Call Home.
- Ne pas participer à Call Home.
Si vous mettez à niveau un VDA et que vous étiez précédemment inscrit à Call Home, cette page de l’assistant n’apparaîtra pas.
Lors de l’installation ou de la mise à niveau d’un Controller : Lorsque vous installez ou mettez à niveau un Delivery Controller à l’aide de l’interface graphique, il vous est demandé si vous souhaitez participer à Call Home et vous connecter à Citrix Smart Tools. Trois options s’offrent à vous :
- Se connecter à Citrix Smart Tools, qui inclut la fonctionnalité Call Home via l’agent Smart Tools. C’est l’option par défaut et recommandée. Si vous choisissez cette option, l’agent Smart Tools est configuré. (L’agent Smart Tools est installé, que cette option soit sélectionnée ou non.)
- Participer uniquement à Call Home, mais ne pas se connecter à Smart Tools. Si vous choisissez cette option, l’agent Smart Tools est installé, mais non configuré. La fonctionnalité Call Home est fournie via le service de télémétrie Citrix et les services Citrix Insight.
- Ne pas se connecter à Smart Tools ni participer à Call Home.
Lorsque vous installez un Controller, vous ne pourrez pas configurer les informations sur la page Call Home de l’assistant d’installation si ce serveur a une GPO Active Directory avec le paramètre de stratégie « Ouvrir une session en tant que service » appliqué. Pour plus de détails, consultez CTX218094.
Si vous mettez à niveau un Controller et que vous étiez précédemment inscrit à Call Home, la page ne posera des questions que sur Smart Tools. Si vous êtes déjà inscrit à Call Home et que l’agent Smart est déjà installé, la page de l’assistant n’apparaîtra pas.
Pour plus d’informations sur Smart Tools, consultez la documentation Smart Tools.
Cmdlets PowerShell
L’aide PowerShell fournit une syntaxe complète, y compris des descriptions de cmdlets et de paramètres qui ne sont pas utilisés dans ces cas d’utilisation courants.
Pour utiliser un serveur proxy pour les téléchargements, consultez Configurer un serveur proxy.
Activer les téléchargements planifiés
Les collectes de diagnostics sont automatiquement téléchargées vers Citrix. Si vous n’entrez pas de cmdlets supplémentaires pour un calendrier personnalisé, le calendrier par défaut est utilisé.
$cred = Get-Credential Enable-CitrixCallHome -Credential $cred
Pour confirmer que les téléchargements planifiés sont activés, entrez Get-CitrixCallHome. Il devrait renvoyer IsEnabled=True et IsMasterImage=False.
Activer les téléchargements planifiés pour les machines créées à partir d’une image principale
L’activation des téléchargements planifiés dans une image principale élimine la nécessité de configurer chaque machine qui est créée dans le catalogue de machines.
Enable-CitrixCallHome -Credential $cred -MasterImage
Pour confirmer que les téléchargements planifiés sont activés, entrez Get-CitrixCallHome. Il devrait renvoyer IsEnabled=True et IsMasterImage=True.
Créer un calendrier personnalisé
Créez un calendrier quotidien ou hebdomadaire pour les collectes de diagnostics et les téléchargements.
$timespan = New-TimeSpan –Heures <heures> -Minutes <minutes> Set-CitrixCallHomeSchedule –HeureDuJour $timespan –JourDeLaSemaine <jour> -FréquenceDeTéléchargement {Quotidien|Hebdomadaire}
Annuler les téléchargements planifiés
Après avoir annulé les téléchargements planifiés, vous pouvez toujours télécharger des données de diagnostic à l’aide de cmdlets PowerShell.
Disable-CitrixCallHome
Pour confirmer que les téléchargements planifiés sont désactivés, entrez Get-CitrixCallHome. Il devrait renvoyer IsEnabled=False et IsMasterImage=False.
Exemples
La cmdlet suivante crée une planification pour regrouper et télécharger des données à 23h20 chaque soir. Notez que le paramètre Hours utilise une horloge de 24 heures. Lorsque la valeur du paramètre UploadFrequency est Daily, le paramètre DayOfWeek est ignoré, s’il est spécifié.
$timespan – New-TimeSpan –Heures 22 –Minutes 20 Set-CitrixCallHomeSchedule –HeureDuJour $timespan -FréquenceDeTéléchargement Quotidien
Pour confirmer la planification, entrez Get-CitrixCallHomeSchedule. Dans l’exemple ci-dessus, il devrait renvoyer StartTime=22:20:00, DayOfWeek=Sunday (ignoré), Upload Frequency=Daily.
La cmdlet suivante crée une planification pour regrouper et télécharger des données à 23h20 chaque mercredi soir.
$timespan – New-TimeSpan –Hours 22 –Minutes 20 Set-CitrixCallHomeSchedule –TimeOfDay $timespan –DayOfWeek Wed -UploadFrequency Weekly
Pour confirmer la planification, entrez Get-CitrixCallHomeSchedule. Dans l’exemple ci-dessus, il devrait renvoyer StartTime=22:20:00, DayOfWeek=Wednesday, Upload Frequency=Weekly.
Configurer un serveur proxy pour les téléchargements Call Home
Effectuez les tâches suivantes sur la machine où Call Home est activé. Les diagrammes d’exemple de la procédure suivante contiennent l’adresse du serveur et le port 10.158.139.37:3128. Vos informations seront différentes.
Étape 1. Ajoutez les informations du serveur proxy dans votre navigateur. Dans Internet Explorer, sélectionnez Options Internet > Connexions > Paramètres réseau local. Sélectionnez Utiliser un serveur proxy pour votre réseau local” et entrez l’adresse du serveur proxy et le numéro de port.
Étape 2. Dans PowerShell, exécutez netsh winhttp import proxy source=ie.
Étape 3. À l’aide d’un éditeur de texte, modifiez le fichier de configuration TelemetryService.exe, qui se trouve dans C:\Program Files\Citrix\Telemetry Service. Ajoutez les informations affichées dans le cadre rouge ci-dessous.
Étape 4. Redémarrez le service de télémétrie.
Exécutez les cmdlets Call Home dans PowerShell.
Collecter et charger manuellement les informations de diagnostic
Vous pouvez utiliser le site web CIS pour charger un paquet d’informations de diagnostic vers CIS. Vous pouvez également utiliser des cmdlets PowerShell pour collecter et charger des informations de diagnostic vers CIS.
Pour charger un paquet via le site web CIS :
- Connectez-vous à Citrix Insight Services à l’aide de vos identifiants de compte Citrix.
- Sélectionnez Mon espace de travail.
- Sélectionnez Healthcheck, puis accédez à l’emplacement de vos données.
CIS prend en charge plusieurs cmdlets PowerShell qui gèrent les téléchargements de données. Cette documentation couvre les cmdlets pour deux cas courants :
- Utilisez la cmdlet Start-CitrixCallHomeUpload pour collecter et charger manuellement un paquet d’informations de diagnostic vers CIS. (Le paquet n’est pas enregistré localement.)
- Utilisez la cmdlet Start-CitrixCallHomeUpload pour collecter manuellement des données et enregistrer un paquet d’informations de diagnostic localement. Cela vous permet de prévisualiser les données. Ensuite, ultérieurement, utilisez la cmdlet Send-CitrixCallHomeBundle pour charger manuellement une copie de ce paquet vers CIS. (Les données que vous avez initialement enregistrées restent localement.)
L’aide PowerShell fournit une syntaxe complète, y compris des descriptions de cmdlets et de paramètres qui ne sont pas utilisés dans ces cas d’utilisation courants.
Lorsque vous entrez une cmdlet pour charger des données vers CIS, il vous est demandé de confirmer le chargement. Si la cmdlet expire avant la fin du chargement, vérifiez l’état du chargement dans le journal des événements système. La demande de chargement peut être rejetée si le service effectue déjà un chargement.
Collecter des données et charger le paquet vers CIS
Start-CitrixCallHomeUpload [-Credential] <PSCredential> [-InputPath <String>] [-Description <String>] [-IncidentTime <String>] [-SRNumber <String>] [-Name <String>] [-UploadHeader <String>] [-AppendHeaders <String>] [-Collect <String>] [<CommonParameters>]
Collecter des données et les enregistrer localement
Start-CitrixCallHomeUpload -OutputPath <String> [-InputPath <String>] [-Description <String>] [-IncidentTime <String>] [-SRNumber <String>] [-Name <String>] [-UploaderHeader <String>] [-AppendHeaders <String>] [-Collect <String>] [<CommonParameters>]
| Paramètre | Description |
|---|---|
| Identifiant | Dirige le téléchargement vers CIS. |
| InputPath | Emplacement du fichier zip à inclure dans le bundle. Il peut s’agir d’un fichier supplémentaire demandé par le support Citrix. Assurez-vous d’inclure l’extension .zip. |
| OutputPath | Emplacement où les informations de diagnostic seront enregistrées. Ce paramètre est requis lors de l’enregistrement local des données Call Home. |
| Description et heure de l’incident | Informations libres concernant le téléchargement. |
| SRNumber | Numéro d’incident du support technique Citrix. |
| Nom | Nom qui identifie le bundle. |
| UploadHeader | Chaîne au format JSON spécifiant les en-têtes de téléversement chargés vers CIS. |
| AppendHeaders | Chaîne au format JSON spécifiant les en-têtes ajoutés téléversés vers CIS. |
| Collect | Chaîne au format JSON spécifiant les données à collecter ou à omettre, sous la forme {‘collector’:{‘enabled’:Boolean}}”, où Boolean est true ou false. Les valeurs de collecteur valides sont : ‘wmi’ ; ‘process’ ; ‘registry’ ; ‘crashreport’ ; ‘trace’ ; ‘localdata’ ; ‘sitedata’ ; ‘sfb’. Par défaut, tous les collecteurs, à l’exception de ‘sfb’, sont activés. Le collecteur ‘sfb’ est conçu pour être utilisé à la demande afin de diagnostiquer les problèmes de Skype for Business. En plus du paramètre ‘enabled’, le collecteur ‘sfb’ prend en charge les paramètres ‘account’ et ‘accounts’ pour spécifier les utilisateurs cibles. Utilisez l’une des formes : “-Collect “{‘sfb’:{‘account’:’domain\user1’}}”; -Collect “{‘sfb’:{‘accounts’:[‘domain\user1’, ‘domain\user2’]}}” |
| Paramètres communs | Consultez l’aide de PowerShell. |
Téléverser les données précédemment enregistrées localement
Send-CitrixCallHomeBundle -Credential <PSCredential> -Path <String> [<CommonParameters>]
Le paramètre Path spécifie l’emplacement du bundle précédemment enregistré.
Exemples
Le cmdlet suivant demande le téléversement des données Call Home (à l’exclusion des données du collecteur WMI) vers CIS. Ces données concernent les échecs d’enregistrement des VDA PVS, qui ont été notés à 14h30 pour le cas de support Citrix 123456. En plus des données Call Home, le fichier “c:\Diagnostics\ExtraData.zip” sera incorporé dans le bundle téléversé.
C:\PS>Start-CitrixCallHomeUpload -InputPath “c:\Diagnostics\ExtraData.zip” -Description “Échecs d’enregistrement avec les VDA PVS” -IncidentTime “14:30” -SRNumber 123456 -Name “RegistrationFailure-021812016” -Collect “{‘wmi’:{‘enabled’:false}}” -UploadHeader “{‘key1’:’value1’}” -AppendHeaders “{‘key2’:’value2’}”
Le cmdlet suivant enregistre les données Call Home relatives au cas de support Citrix 223344, noté à 8h15. Les données seront enregistrées dans le fichier mydata.zip sur un partage réseau. En plus des données Call Home, le fichier “c:\Diagnostics\ExtraData.zip” sera incorporé dans le bundle enregistré.
C:\PS>Start-CitrixCallHomeUpload -OutputPath \\mynetwork\myshare\mydata.zip -InputPath “c:\Diagnostics\ExtraData.zip” -Description “Diagnostics pour l’incident numéro 223344” -IncidentTime “8:15” -SRNumber 223344
L’applet de commande suivante télécharge le bundle de données que vous avez enregistré précédemment.
$cred=Get-Credential C:\PS>Send-CitrixCallHomeBundle –Credential $cred -Path \mynetwork\myshare\mydata.zip
Citrix Scout
Pour plus de détails, consultez Citrix Scout.
Dans cet article
- Analyse de l’installation et de la mise à niveau
- Programme d’amélioration de l’expérience client Citrix (CEIP)
- Citrix Smart Tools
- Citrix Call Home
- Résumé de la configuration et de la gestion
- Prérequis
- Activer Call Home lors de l’installation du composant
- Cmdlets PowerShell
- Configurer un serveur proxy pour les téléchargements Call Home
- Collecter et charger manuellement les informations de diagnostic
- Citrix Scout