Dépannage

Comment collecter les journaux

L’application Citrix Workspace pour ChromeOS fournit des horodatages pour les journaux générés par l’appareil de l’utilisateur. L’application Citrix Workspace prend en charge la collecte de journaux pour les sessions d’applications et de bureaux virtuels en cours.

En tant qu’utilisateur final, vous pouvez collecter des journaux pour faciliter le dépannage. Les journaux peuvent être générés à la fois sur l’appareil de l’utilisateur et sur les machines. Les journaux peuvent concerner les bureaux et les applications.

Auparavant, vous ne pouviez collecter des journaux que pour les sessions lancées après avoir sélectionné Démarrer la journalisation pendant une session en cours. Désormais, les journaux sont collectés pour les sessions en cours et ultérieures jusqu’à ce que vous sélectionniez Arrêter la journalisation.

Journalisation sur les appareils utilisateur

Pour activer la journalisation :

1. Sur l’appareil de l’utilisateur, démarrez l’application Citrix Workspace et accédez à la page de connexion.

2. Cliquez sur l’icône des paramètres (engrenage) dans le coin inférieur droit.

3. Dans la boîte de dialogue Paramètres, sélectionnez Journalisation > Démarrer la journalisation.

   Les détails des fichiers journaux collectés sont répertoriés dans la boîte de dialogue Paramètres.

4. Sélectionnez Arrêter la journalisation pour mettre fin à la collecte des journaux sur l’appareil de l’utilisateur.

Journaux client

Pour collecter les journaux client :

1. Cliquez sur l’icône Paramètres (engrenage) en bas à droite de l’écran de Connexion de l’application Citrix Workspace.

   

2. Cliquez sur Journalisation > Démarrer la journalisation pour activer la collecte des journaux.

   

3. Le champ Démarrer la journalisation passe à Arrêter la journalisation. Ce changement indique que la collecte des journaux est activée.

   Fermez la boîte de dialogue Compte.

• 1. Connectez-vous au bureau virtuel de l’application Citrix Workspace, lancez votre session d’application virtuelle et reproduisez le problème pour collecter les journaux.

  

  Continuez à travailler sur la session pour reproduire le problème.

1. Une fois le problème reproduit, fermez la session.

2. Cliquez à nouveau sur Paramètres pour ouvrir la boîte de dialogue Compte.

3. Sélectionnez l’onglet Journalisation.

4. La boîte de dialogue Journalisation affiche la liste des Fichiers journaux capturés.

   

5. Déplacez la souris sur l’un des fichiers journaux. Une petite flèche apparaît à droite.

   

6. Cliquez sur la flèche pour télécharger et enregistrer quelques fichiers journaux.

7. Cliquez sur Télécharger tous les journaux et partagez-les avec l’administrateur ou l’ingénieur du support Citrix®.

8. Cliquez sur Arrêter la journalisation.

Remarque :

En mode Kiosque, les fichiers peuvent être enregistrés sur un périphérique USB amovible.

Collecte de journaux améliorée

À partir de la version 2411, les utilisateurs peuvent télécharger les journaux de l’application Citrix Workspace™ dans un fichier zip, ce qui simplifie la récupération et l’analyse des journaux pour un meilleur dépannage et une expérience utilisateur améliorée.

Voici les avantages de cette fonctionnalité :

• Les utilisateurs n’ont plus besoin de collecter manuellement les fichiers journaux individuels.
• Le processus simplifié rend l’accès aux journaux plus efficace.
• Un accès facile à des journaux complets facilite un débogage plus rapide et plus efficace.

Expérience utilisateur finale

Sur l’écran Journalisation, cliquez sur Télécharger tous les journaux. L’application rassemble tous les fichiers journaux pertinents et les compresse dans une archive zip. Le fichier téléchargé utilise une convention de nommage standardisée, telle que CWA_CHROME_LOGS_[timestamp].zip, garantissant clarté et identification facile.

Journaux de la console

Pour collecter les journaux de la console :

• 1. Ouvrez la page chrome://inspect/#apps dans le navigateur Google Chrome de votre application Citrix Workspace.

1. Dans l’onglet Applications, cliquez sur inspecter pour toutes les fenêtres liées à Citrix Workspace : SessionWindow.html, Main.html (et ses nœuds enfants).

   

   

2. Pour chaque fenêtre d’outil de développement ouverte, cliquez sur Console. Ensuite, enregistrez l’intégralité du journal en cliquant avec le bouton droit de la souris et en sélectionnant l’option Enregistrer sous.

• 

• Journaux de redirection USB

• Pour collecter les journaux de redirection USB :

1. Suivez les étapes de la section Utilisation de Web.config pour ChromeOS et activez moreLogs pour l’USB en procédant comme suit :

• Ajoutez la valeur de configuration moreLogs à chromeAppPreferences dans le fichier web.config sur le StoreFront :
• chromeAppPreferences ='{"moreLogs":{"usb":true}}'

1. Ensuite, ouvrez un nouvel onglet dans le navigateur Google Chrome, saisissez chrome://device-log et partagez les journaux.

   

Journaux de transfert de fichiers

Les journaux de transfert de fichiers peuvent être récupérés à partir du client et du serveur.

Pour récupérer les journaux de transfert de fichiers à partir du client :

1. Lancez un navigateur.
2. Accédez à l’URL suivante pour démarrer la journalisation : <storefronturl>/clients/html5client/src/viewlog.html où <storefronturl> est le nom de domaine complet (FQDN) ou l’adresse IP du serveur StoreFront sur lequel le magasin est configuré.

Pour plus d’informations sur le transfert de fichiers, consultez HTML5 and Chrome File Transfer Explained.

Journaux d’optimisation Microsoft Teams

L’optimisation de Microsoft Teams prend en charge la dernière version de la bibliothèque shim 1.8.0.12.

Pour connaître la version shim actuelle que vous utilisez :

1. Démarrez l’application Microsoft Teams et lancez un appel avec l’un des utilisateurs.

2. Agrandissez la fenêtre Microsoft Teams une fois l’appel établi.

3. Ouvrez le clavier visuel dans la session et cliquez sur les touches Ctrl + Alt + Maj + 1. Vous pouvez maintenant afficher les fichiers journaux dans le dossier des téléchargements.

4. Ouvrez le fichier MSTeams Diagnostics Log <date><time>_vdi partner.txt et recherchez la version shim sous type_script. Comparez la version shim avec 1.8.0.12.

5. (Facultatif) Si la version shim n’est pas 1.8.0.12, contactez votre administrateur pour effectuer la mise à niveau vers la dernière version.

• Journaux client en mode kiosque

Pour collecter les journaux en mode kiosque :

1. Connectez un périphérique USB amovible à votre Chromebook.

2. Téléchargez le fichier journal.

3. Enregistrez le fichier journal sur le périphérique USB connecté.

   Le fichier journal est transféré vers le périphérique USB.

Raccourcis

• Le raccourci clavier Ctrl+ Alt + Maj +1 peut ne pas fonctionner dans Microsoft Teams optimisé au sein d’un bureau virtuel. Pour contourner ce problème, ouvrez le clavier visuel et utilisez le raccourci. [RFHTMCRM-5441]

Afficher la télémétrie des points de terminaison dans Citrix Director

Cette fonctionnalité améliore la capacité des administrateurs à afficher les données de télémétrie des points de terminaison directement dans Citrix Director.

Conditions préalables

• Citrix Workspace app pour ChromeOS 2411 et versions ultérieures
• VDA version 2411 et versions ultérieures
• Citrix Director

Diagnostics de lancement de session

À partir de la version 2502, nous avons mis en œuvre un processus de support amélioré pour les échecs de session. Les administrateurs du support technique disposent désormais d’informations complètes sur les chemins d’échec, ce qui leur permet de trier efficacement et de réduire considérablement le nombre de cas de support liés aux échecs de session.

Pour plus d’informations, consultez Diagnostics de lancement de session dans la documentation de Citrix Monitor.

Always On Tracing (AOT)

L’application Citrix Workspace pour ChromeOS prend désormais en charge Always On Tracing (AOT), un cadre de diagnostic moderne de Citrix qui capture en continu les données de journal pertinentes dans l’environnement Citrix Virtual Apps and Desktops. Cette fonctionnalité simplifie le dépannage pour les administrateurs informatiques et les équipes de support Citrix en capturant automatiquement les données de journal pour les sessions utilisateur et les événements système, éliminant ainsi la nécessité de reproduire les problèmes.

• AOT rend les journaux facilement accessibles et lisibles sans nécessiter une expertise de niveau ingénieur, permettant des diagnostics en libre-service pour réduire la dépendance vis-à-vis du support Citrix et améliorer le temps moyen de résolution.

Avantages

AOT apporte une valeur significative aux clients en :

• Capturant automatiquement les données de journal pour les sessions utilisateur et les événements système sans intervention manuelle
• Éliminant la nécessité de reproduire les problèmes puisque les journaux sont collectés en continu pendant les opérations normales
• Rendant les journaux facilement accessibles et lisibles sans nécessiter une expertise de niveau ingénieur
• Permettant des diagnostics en libre-service pour réduire la dépendance vis-à-vis du support Citrix
• Améliorant le temps moyen de résolution pour les scénarios de dépannage

Cas d’utilisation

AOT s’intègre à votre expérience globale dans les scénarios suivants :

• Surveillance proactive : Surveillez en continu les sessions utilisateur et les événements système pour identifier les problèmes potentiels avant qu’ils n’affectent les utilisateurs
• Dépannage rapide : Accédez immédiatement à des données de journal complètes lorsque des problèmes surviennent, sans attendre la reproduction des journaux
• Support en libre-service : Permettez aux administrateurs informatiques de diagnostiquer et de résoudre les problèmes courants de manière indépendante à l’aide de données de journal accessibles

Télécharger les journaux AOT vers le serveur de journaux AOT centralisé

Le serveur de journaux AOT sert de destination centralisée pour la collecte et le stockage des journaux Always On Tracing (AOT) provenant de divers composants Citrix®. Il est conteneurisé à l’aide de la technologie Docker et est de préférence déployé sur Linux, bien qu’il prenne également en charge les environnements Windows via Docker Desktop.

Remarques :

• Dans cette version 2511 de l’application Citrix Workspace pour ChromeOS, les journaux AOT ne sont capturés que pour les configurations sur site sans passerelle dans le chemin.
• Dans l’application Citrix Workspace pour ChromeOS 2603, les téléchargements de journaux AOT vers des serveurs de journaux centralisés prennent en charge les configurations sur site sans passerelle et les configurations sur site avec une passerelle dans le chemin.

Configuration

À partir de l’application Citrix Workspace pour ChromeOS 2603, vous pouvez désactiver la fonctionnalité AOT en ajoutant la configuration suivante. Pour les appareils et les utilisateurs gérés, les administrateurs peuvent désactiver AOT à l’aide de la stratégie Google Admin comme suit :

1. Connectez-vous à la Politique d’administration Google.

2. Accédez à Gestion des appareils > Gestion de Chrome > Paramètres utilisateur.

   Remarque :

   Vous pouvez également appliquer cette configuration aux éléments suivants :

   • Appareil > Chrome > Applications et extensions > Utilisateurs et navigateurs > Rechercher l’extension > Stratégie pour les extensions.
   • Appareil > Chrome > Applications et extensions > Kiosques > Rechercher l’extension > Stratégie pour les extensions.
   • Appareil > Chrome > Applications et extensions > Sessions d’invités gérées > Rechercher l’extension > Stratégie pour les extensions.

3. Ajoutez les chaînes suivantes au fichier policy.txt sous la clé engine_settings.

   Assurez-vous de définir "enabled": false sous l’objet aot. Voici un exemple de données JSON :

   {
   "settings": {
   "Value": {
   "settings_version": "1.0",
   "engine_settings": {
       "aot": {
           "enabled": false
               }
           }
       }
       }
   }
   <!--NeedCopy-->
   

Conditions préalables

Cette fonctionnalité est disponible uniquement lorsque vous ouvrez une session à l’aide de :

• Citrix Virtual Apps and Desktops™ version 2507 CU1 ou ultérieure

• Citrix Virtual Apps and Desktops™ version 2511 ou ultérieure

Comment configurer

Pour configurer, vous devez d’abord installer et configurer le serveur de journaux. Pour obtenir des étapes détaillées d’installation et de configuration, consultez Installer et configurer le serveur de journaux.

Après l’installation du serveur de journaux, le système génère un script StartLogServer au même emplacement. Le nom du fichier est StartLogServer.bat sous Windows ou StartLogServer.sh sous Linux.

Pour activer la communication entre l’application Citrix Workspace pour ChromeOS et le serveur de journaux, vous devez configurer le serveur de journaux pour qu’il accepte l’URL FQDN de StoreFront en activant le partage de ressources inter-origines (CORS) sur le serveur de journaux.

Pour activer CORS :

1. Si le serveur de journaux est en cours d’exécution, arrêtez-le à l’aide de la commande suivante :

   docker stop logserver
   <!--NeedCopy-->

1. Ajoutez les arguments d’environnement suivants à StartLogServer.bat (ou StartLogServer.sh sous Linux) en modifiant le paramètre CORS_ORIGINS :

   -e CORS_ORIGINS=""
   <!--NeedCopy-->

Exemple pour une URL unique :

   -e CORS_ORIGINS="https://xyz.bvt.local;"
   <!--NeedCopy-->

Exemple pour plusieurs URL :

   -e CORS_ORIGINS="url1;url2;url3"
   <!--NeedCopy-->

Utilisez des points-virgules (;) pour séparer plusieurs URL.

1. Redémarrez le serveur de journaux à l’aide de la commande StartLogServer.bat (ou StartLogServer.sh sous Linux).

Journaux pour le dépannage de la prise en charge de l’authentification unique Entra ID pour VDA avec la configuration des informations d’identification Azure AD

Cet article décrit les journaux que vous pouvez collecter lorsque l’authentification unique (SSO) échoue et que les utilisateurs reçoivent des invites d’informations d’identification inattendues après le lancement de la session.

Pour collecter les journaux :

1. Collectez les journaux de base de l’application Citrix Workspace. Pour plus d’informations, consultez Comment collecter les journaux.

2. Collectez les traces réseau pour l’état de récupération du jeton MSAL :

   i. Ouvrez le navigateur Chrome et accédez à chrome://net-export/. ii. Sélectionnez Démarrer la journalisation sur le disque et choisissez l’option Inclure les octets bruts (inclura les cookies et les informations d’identification), comme illustré dans la capture d’écran suivante. Sélectionnez l’emplacement du fichier.

   

   iii. Démarrez une session de l’application Citrix Workspace pour ChromeOS pour reproduire le problème et collecter les traces. Sélectionnez Arrêter la journalisation dans chrome://net-export/.

3. Collectez les traces Citrix Diagnostic Facility (CDF) du VDA pour tous les modules et le traçage au démarrage. Suivez les étapes pour collecter une trace CDF au démarrage du système, car l’authentification unique peut échouer même avec une négociation de capacité réussie de l’application Citrix Workspace.

Limitations connues

• L’application Citrix Workspace pour ChromeOS ne prend pas en charge l’authentification unique (SSO) pour le lancement hybride, car elle ne dispose pas de la prise en charge ICA en mémoire.

• Si le lancement de la session prend plus de 30 secondes, la connexion SSO AAD peut échouer et inviter les utilisateurs à saisir leurs informations d’identification.

FAQ

Où puis-je trouver les dernières informations sur les nouvelles fonctionnalités ou améliorations ?

Vous trouverez les dernières informations sur l’application Citrix Workspace pour ChromeOS dans la documentation du produit.

Comment accéder aux fonctionnalités en préversion technique ?

Pour connaître les fonctionnalités en préversion technique, consultez Fonctionnalités en préversion technique.

Comment fournir des commentaires sur l’EAR ?

Pour fournir des commentaires sur la version EAR, cliquez sur https://forms.gle/ef3eFFKBk7gvTi1b6.

Comment installer l’application Citrix Workspace pour ChromeOS depuis le Chrome Web Store ?

L’utilisateur final peut installer l’application Citrix Workspace pour ChromeOS depuis le Chrome Web Store. Pour plus d’informations, consultez Installer depuis le Chrome Web Store dans la documentation du produit.

Comment personnaliser la barre d’outils dans une session de l’application Citrix Workspace ?

Les administrateurs peuvent personnaliser la barre d’outils en choisissant les options visibles par les utilisateurs finaux. Les administrateurs peuvent la personnaliser à l’aide du service Global App Configuration. Pour plus d’informations, consultez Personnalisation de la barre d’outils dans la documentation du produit.

Comment configurer la redirection USB ?

L’application Citrix Workspace pour ChromeOS prend en charge une large gamme de périphériques USB. Grâce à cette fonctionnalité supplémentaire, vous pouvez créer une stratégie Google pour identifier le PID/VID de l’appareil afin de permettre son utilisation dans l’application Citrix Workspace. Cette prise en charge s’étend également aux nouveaux périphériques USB. Pour configurer cette fonctionnalité, consultez Configuration USB dans la documentation du produit.