Citrix Virtual Apps and Desktops Service

Analyse de l’état de santé du cloud

L’application Analyse de l’état de santé du cloud vous permet d’exécuter des vérifications qui évaluent l’état de santé et la disponibilité du site et de ses composants. Vous pouvez exécuter des analyses pour Virtual Delivery Agents (VDA), les serveurs StoreFront et Profile Management. Les analyses de l’état de santé du VDA identifient les causes possibles des problèmes courants d’enregistrement de VDA, de lancement de session et de redirection de fuseau horaire.

Si des problèmes sont détectés pendant les analyses, l’analyse de l’état de santé du cloud fournit un rapport détaillé et les actions pouvant résoudre les problèmes. Chaque fois que l’analyse de l’état de santé du cloud démarre, il recherche la dernière version des scripts sur le CDN (Content Delivery Network) et télécharge automatiquement les scripts s’ils n’existent pas sur l’ordinateur local. L’analyse de l’état de santé du cloud choisit toujours la dernière version locale des scripts pour exécuter des contrôles d’intégrité.

Remarque :

L’analyse de l’état de santé du cloud ne se met pas à jour chaque fois qu’elle s’exécute.

Dans un environnement Citrix Cloud, exécutez Analyse de l’état de santé du cloud à partir d’une machine jointe au domaine pour exécuter des analyses sur un ou plusieurs VDA ou serveurs StoreFront.

Remarque :

Vous ne pouvez pas installer ou exécuter Analyse de l’état de santé du cloud sur Cloud Connector.

Le journal de l’application Analyse de l’état de santé du cloud est stocké dans C:\ProgramData\Citrix\TelemetryService\CloudHealthCheck.log. Vous pouvez utiliser ce fichier pour le dépannage.

Installation

Pour préparer votre environnement pour l’installation de l’application Analyse de l’état de santé du cloud, vous devez disposer d’une machine Windows rattachée au domaine.

Remarque :

Vous ne pouvez pas installer ou exécuter Analyse de l’état de santé du cloud sur Cloud Connector.

  1. Sur l’ordinateur joint au domaine, téléchargez le programme d’analyse de l’état de santé du cloud.
  2. Double-cliquez sur le fichier CloudHealthCheckInstaller_x64.msi.
  3. Cliquez sur la case pour accepter les conditions.
  4. Cliquez sur Installer.

    analyse de l'état de santé du cloud 1

  5. Une fois l’installation terminée, cliquez sur Terminer.

    analyse de l'état de santé du cloud 2

Autorisations et conditions requises

Autorisations :

  • Pour exécuter des analyses de l’état de santé :

    • Vous devez être membre du groupe d’utilisateurs du domaine.
    • Vous devez être administrateur complet ou avoir un rôle personnalisé avec les autorisations Lecture seule et Exécuter les tests d’environnement pour le site.
    • Définissez la stratégie d’exécution de script sur RemoteSigned au minimum pour permettre l’exécution des scripts. Par exemple : Set-ExecutionPolicy RemoteSigned. Remarque : d’autres privilèges d’exécution de script peuvent également fonctionner.
  • Utilisez Exécuter en tant qu’administrateur lorsque vous lancez l’analyse de l’état de santé du cloud.

Pour chaque machine VDA ou StoreFront sur laquelle vous exécutez des analyses :

  • Le système d’exploitation doit être de 64 bits.
  • L’analyse de l’état de santé du cloud doit être en mesure de communiquer avec la machine.
  • Le partage de fichiers et d’imprimantes doit être activé.
  • PSRemoting et WinRM doivent être activés. La machine doit également exécuter PowerShell 3.0 ou version ultérieure.
  • L’accès WMI (Windows Management Infrastructure) doit être activé sur la machine.

A propos des analyses de l’état de santé

Les données d’analyse de l’état de santé sont stockées dans des dossiers sous C:\ProgramData\Citrix\TelemetryService\.

Analyses d’état de santé du VDA

Pour l’enregistrement sur le VDA, l’analyse de l’état de santé du cloud vérifie :

  • Installation du logiciel VDA
  • Appartenance au domaine de la machine VDA
  • Disponibilité du port de communication VDA
  • État du service VDA
  • Configuration du pare-feu Windows
  • Communication avec le Controller
  • Synchronisation de l’heure avec le Controller
  • État de l’enregistrement de VDA

Pour les lancements de session sur les VDA, l’analyse de l’état de santé du cloud vérifie :

  • Disponibilité du port de communication de lancement de session
  • État des services de lancement de session
  • Configuration du pare-feu Windows de lancement de session
  • Licences d’accès au client Remote Desktop Services du VDA
  • Chemin de lancement de l’application VDA

Pour la redirection de fuseau horaire sur les VDA, l’analyse de l’état de santé du cloud vérifie :

  • Installation de correctifs Windows
  • Installation de correctifs Citrix
  • Paramètres de stratégie de groupe Microsoft
  • Paramètres de stratégie de groupe Citrix

Pour Profile Management sur les VDA, l’analyse de l’état de santé du cloud vérifie :

  • Détection de l’hyperviseur
  • Détection du provisionnement
  • Citrix Virtual Apps and Desktops
  • Configuration Personal vDisk
  • Magasin de l’utilisateur
  • Détection d’état du service Profile Management
  • Test de hooking Winlogon.exe

Pour exécuter des contrôles sur Profile Management, vous devez installer et activer Profile Management sur le VDA. Pour plus d’informations sur les contrôles de configuration de Profile Management, consultez l’article du Centre de connaissances CTX132805.

Analyses de l’état de santé StoreFront

Les contrôles StoreFront vérifient si :

  • Le service de domaine par défaut Citrix est en cours d’exécution
  • Le service Citrix Credential Wallet est en cours d’exécution
  • la connexion du serveur StoreFront à Active Directory s’effectue via le port 88 ;
  • la connexion du serveur StoreFront à Active Directory s’effectue via le port 389 ;
  • la connexion du serveur StoreFront à Active Directory s’effectue via le port 464 ;
  • l’URL de base possède un nom de domaine complet valide ;
  • l’adresse IP correcte de l’URL de base peut être récupérée ;
  • le pool d’applications IIS utilise .NET 4.0 ;
  • le certificat est lié au port SSL pour l’URL de l’hôte ;
  • la chaîne de certificats est complète ;
  • les certificats ont expiré ;
  • un certificat expire dans les 30 jours.

Exécution d’Analyse de l’état de santé du cloud

Pour exécuter l’analyse de l’état de santé du cloud :

  1. Sélectionnez Citrix > Analyse de l’état de santé du cloud dans le menu Démarrer de la machine, ou exécutez CloudHealthCheck.exe dans C:\Program Files\Citrix\CloudHealthCheck.

    analyse de l'état de santé du cloud 3

  2. Dans l’écran principal d’Analyse de l’état de santé du cloud, cliquez sur Ajouter une machine.

    analyse de l'état de santé du cloud 4

  3. Tapez le nom de domaine complet de la machine à ajouter. Remarque : bien que la saisie d’un alias DNS au lieu d’un nom de domaine complet puisse paraître valide, les analyses peuvent échouer.
  4. Cliquez sur Continuer.
  5. Répétez cette opération pour ajouter d’autres machines, si nécessaire.

    analyse de l'état de santé du cloud 5

  6. Pour supprimer une machine ajoutée manuellement, cliquez sur le X à droite de la ligne et confirmez la suppression. Répétez cette opération pour supprimer d’autres machines ajoutées manuellement.

L’application Analyse de l’état de santé du cloud se souvient des machines ajoutées manuellement jusqu’à ce que vous les supprimez. Lorsque vous fermez puis rouvrez Analyse de l’état de santé du cloud, les machines ajoutées manuellement sont toujours répertoriées en haut de la liste.

Importer des machines VDA

Vous pouvez importer des machines VDA dans le déploiement lors de l’exécution des analyses.

  1. Sur le Connector, générez le fichier de liste de machines à l’aide de la commande PowerShell suivante. Sur le Connector, vous devez entrer des informations d’identification Citrix et sélectionner le client dans la boîte de dialogue contextuelle.

Get-BrokerMachine| foreach { $_.DnsName } | out-file C:\machineList.txt

  1. Copiez le fichier machineList.txt sur la machine jointe au domaine sur laquelle vous souhaitez exécuter Analyse de l’état de santé du cloud.
  2. Sur la page Analyse de l’état de santé du cloud, cliquez sur Ajouter une machine.
  3. Sélectionnez le type de machine VDA Windows.
  4. Cliquez sur Importer des machines VDA.
  5. Sélectionnez le fichier machineList.txt.
  6. Cliquez sur Ouvrir.

    analyse de l'état de santé du cloud 6

    Les machines VDA importées sont répertoriées sur la page Analyse de l’état de santé du cloud.

  7. Activez la case à cocher en regard de chaque machine sur laquelle vous souhaitez exécuter des analyses.

    L’analyse de l’état de santé du cloud démarre automatiquement des tests de vérification sur chaque machine que vous avez sélectionnée, s’assurant ainsi que celle-ci remplit les critères répertoriés dans les tests de vérification. En cas d’échec de la vérification, un message est affiché dans la colonne État et la case à cocher de cette machine n’est plus sélectionnée. Vous pouvez alors :

    • Corriger le problème, puis sélectionner de nouveau la case à cocher de la machine. Cela déclenche une nouvelle tentative de tests de vérification.
    • Ignorer cette machine (en laissant la case à cocher non sélectionnée). Les analyses ne seront pas exécutées pour cette machine.
  8. Une fois les tests de vérification terminés, cliquez sur Continuer.

    analyse de l'état de santé du cloud 7

  9. Exécuter les analyses de l’état de santé sur les machines sélectionnées. Le résumé répertorie les machines sur lesquelles les tests sont exécutés (les machines que vous avez sélectionnées et qui ont réussi les tests de vérification).

  10. Cliquez sur Démarrer la vérification.

    analyse de l'état de santé du cloud 8

    Pendant et après l’analyse, la colonne État indique l’état de vérification actuel d’une machine.

  11. Pour arrêter toutes les vérifications en cours, cliquez sur Arrêter la vérification dans le coin inférieur droit de la page. Vous ne pouvez pas annuler l’analyse de l’état d’une seule machine, vous ne pouvez annuler l’analyse que pour toutes les machines sélectionnées.

    analyse de l'état de santé du cloud 9

  12. Lorsque les vérifications sont terminées pour toutes les machines sélectionnées, le bouton Arrêter la vérification dans le coin inférieur droit devient Terminé.

    analyse de l'état de santé du cloud 10

    • Si une vérification échoue, vous pouvez cliquer sur Réessayer dans la colonne Action.
    • Si une vérification se termine sans détection de problème, la colonne Action est vide.
    • Si une analyse détecte des problèmes, cliquez sur Afficher les détails pour afficher les résultats.

    analyse de l'état de santé du cloud 11

Si vous utilisez Internet Explorer pour afficher le rapport, vous devez cliquer sur Autoriser le contenu bloqué pour afficher le lien hypertexte.

analyse de l'état de santé du cloud 12

Une fois l’analyse terminée pour toutes les machines sélectionnées, le fait de cliquer sur Précédent entraîne la perte des résultats de l’analyse.

Lorsque les analyses sont terminées, cliquez sur Terminé pour revenir à l’écran principal d’Analyse de l’état de santé du cloud.

Résultats de l’analyse

Les analyses de l’état qui génèrent des rapports contiennent les éléments suivants :

  • Heure et date à laquelle le rapport de résultats a été généré
  • Noms de domaines complets des machines analysées
  • Conditions vérifiées sur les machines cibles

Exécution de Vérification de l’intégrité Cloud sur la ligne de commande

Vérification de l’intégrité Citrix Cloud peut être exécuté sur la ligne de commande pour aider les clients à effectuer des contrôles d’intégrité. Pour utiliser Vérification de l’intégrité Cloud sur la ligne de commande, vous devez être un administrateur sur la machine sur laquelle la vérification est exécutée.

Remarque :

Lorsque vous utilisez Vérification de l’intégrité Cloud sur la ligne de commande, une seule machine peut être vérifiée à la fois. Une seule instance de CloudHealthCheck.exe peut être exécutée simultanément sur la machine cible. Si vous souhaitez vérifier plusieurs machines, les machines doivent être vérifiées une par une, en enveloppant les applets de commande dans une boucle dans les scripts Cmdlet/PowerShell. Toute instance d’interface utilisateur ouverte de Vérification de l’intégrité Cloud doit également être fermée.

Applets de commande

Les applets de commande de ligne de commande prises en charge sont les suivantes :

  • MachineFQDN - Cette applet de commande est obligatoire. Il s’agit du nom de domaine complet de la machine cible.
  • MachineType - Cette applet de commande est facultative. La valeur de l’applet de commande peut être le VDA Windows (valeur par défaut) ou StoreFront.
  • ReportName - Cette applet de commande est facultative. La valeur de l’applet de commande doit être un nom de fichier valide sous Windows. La valeur par défaut est HealthCheckReport.

Exemples :

CloudHealthCheck.exe -MachineFQDN machine.domain.local

CloudHealthCheck.exe -MachineFQDN machine.domain.local -ReportName checkreport

Remarque :

Les noms de paramètres ne sont pas sensibles à la casse.

Par défaut, la sortie de la console n’est pas affichée dans la fenêtre de la console de ligne de commande. Vous pouvez afficher manuellement la sortie en ajoutant |more à l’applet de commande.

Exemple : CloudHealthCheck.exe -MachineFQDN machine.domain.local|more

Vérifications de machines multiples

Pour exécuter Vérification de l’intégrité Cloud sur la ligne de commande pour plusieurs machines, utilisez l’exemple suivant :

@echo off
for %%n in (machine1.domain.local,machine2.domain.local,machine3.domain.local) do (
start /wait CloudHealthCheck.exe -FQDN %%n
echo %errorlevel%)

Codes de sortie

Les codes de sortie expliquent le résultat des vérifications de l’intégrité Cloud dans la ligne de commande. Pour obtenir le code de sortie, vous devez ajouter start /wait avant l’applet de commande.

Exemple : start /wait CloudHealthCheck.exe -MachineFQDN machine.domain.local

Les codes de sortie sont les suivants :

  • 0 - Normal, vérification terminée et réussie.
  • 1 - Échec, vérification terminée avec des problèmes.
  • 2 - Erreur, vérification non terminée avec des erreurs.

Vous pouvez également utiliser l’applet de commande echo %errorlevel% pour obtenir le code de sortie de la dernière commande exécutée.

Rapports

Vérification de l’intégrité Cloud crée des dossiers en utilisant le nom de la machine dans HealthCheckDataFolder pour la machine cible. Un fichier .html et un fichier .json sont créés sur l’ordinateur sur lequel la fonction Vérification de l’intégrité Cloud est installée. Les rapports de vérification de l’intégrité se trouvent dans le dossier HealthCheckDataFolder dans %ProgramData%\Citrix\TelemetryService\HealthCheck\Data.

Les rapports ne sont créés que lorsque des problèmes existent sur la machine cible.

Remarque :

Les fichiers de rapport sont remplacés si le nom de rapport spécifié existe.

Les alertes et les informations de base sont stockées dans le rapport .json.

Capture d'écran du rapport JSON

Les codes de rapport sont les suivants :

  • issueKey : description en texte brut du problème.
  • issueUuiD : chaîne d’identification unique pour le problème.
  • fixRecommendation : correction recommandée pour le problème.
  • severity : indique si le problème doit être résolu. Une erreur peut indiquer que le composant (VDA ou StoreFront) a mal fonctionné, et un avertissement indique que le composant peut fonctionner mais qu’il peut rencontrer des problèmes potentiels.
  • issueName : titre du problème.
  • issueDescription : description détaillée du problème.

Mise à jour de Vérification de l’intégrité cloud

Si une nouvelle version de Vérification de l’état du cloud est disponible, un lien Mise à jour disponible s’affiche en haut à droite de la fenêtre de Vérification de l’état du Cloud. Cliquez sur le lien pour accéder aux téléchargements Citrix pour obtenir la nouvelle version.

mise à jour de vérification de l'intégrité cloud

Tests de vérification

Avant le démarrage d’une analyse d’état, des tests de vérification sont exécutés automatiquement pour chaque machine sélectionnée. Ces tests permettent de s’assurer que les conditions requises sont remplies pour l’exécution d’une analyse de l’état. Si un test échoue pour une machine, Analyse de l’état de santé du cloud affiche un message contenant des actions correctives suggérées.

  • Analyse de l’état de santé du cloud ne peut accéder à cette machine : assurez-vous que :
    • La machine est allumée.
    • La connexion réseau fonctionne correctement. (il peut vérifier que votre pare-feu est correctement configuré.)
    • Le partage de fichiers et d’imprimantes est activé. Consultez la documentation Microsoft pour obtenir des instructions.
  • Activer PSRemoting et WinRM - Vous pouvez activer l’accès à distance PowerShell et WinRM en exécutant PowerShell en tant qu’administrateur, puis en exécutant l’applet de commande Enable-PSRemoting. Pour de plus amples informations, consultez l’aide de Microsoft pour l’applet de commande.
  • Analyse de l’état de santé du cloud requiert PowerShell 3.0 ou version ultérieure : installez PowerShell 3.0 (ou version ultérieure) sur la machine et activez la communication à distance PowerShell.
  • WMI n’est pas exécuté sur la machine : vérifiez que l’accès WMI (Windows Management Instrumentation) est activé.
  • Connexions WMI bloquées : activez WMI dans le service Pare-feu Windows.

Collecte de données d’utilisation

Lorsque vous utilisez Analyse de l’état de santé du cloud, Citrix utilise Google Analytics pour collecter des données d’utilisation anonymes qui seront utilisées pour les futures fonctionnalités et améliorations du produit. La collecte de données est activée par défaut.

Pour modifier la collecte et le chargement des données d’utilisation, cliquez sur l’icône d’engrenages Paramètres de l’interface utilisateur Analyse de l’état de santé du cloud. Vous pouvez ensuite choisir d’envoyer les informations en sélectionnant Oui ou Non, puis en cliquant sur Enregistrer.

analyse de l'état de santé du cloud 13

Résolution des problèmes

Lorsqu’Analyse de l’état de santé du cloud ne parvient pas à s’exécuter ou qu’une exception se produit, vérifiez la connexion à Analyse de l’état de santé du cloud dans C:\ProgramData\Citrix\TelemetryService\CloudHealthCheck.log.

Le journal d’Analyse de l’état de santé du cloud pour chaque machine cible se trouve dans C:\ProgramData\Citrix\TelemetryService\HealthCheck\Data\$TargetMachineFQDN\log.txt.

Pour activer le journal de débogage :

Modifiez C:\Program Files\Citrix\CloudHealthCheck\CloudHealthCheck.exe.config, mettez à jour <add name="TraceLevelSwitch" value="3" /> to <add name="TraceLevelSwitch" value="4" />, enregistrez le fichier et rouvrez Analyse de l’état de santé du cloud.

Commentaires

Pour laisser des commentaires sur l’analyse de l’état de santé du cloud, répondez à l’enquête Citrix.