Dépannage

Journaux HTML5

L’application Citrix Workspace pour HTML5 fournit des horodatages pour les journaux générés par l’appareil de l’utilisateur.

Remarque :

• Pour faciliter le dépannage des problèmes, vous pouvez consulter les journaux de session de l’application Citrix Workspace pour HTML5.

La page des journaux permet aux utilisateurs de :

• Activer la journalisation : Activez la journalisation pour afficher les journaux HTML5.
• Désactiver la journalisation : Désactivez la journalisation pour arrêter l’enregistrement dans une session.
• Afficher les journaux : Affichez les journaux générés pour une session.
• Effacer les journaux : Supprimez le fichier journal généré lors d’une session.
• Télécharger le fichier journal : Téléchargez le fichier journal vers l’emplacement souhaité.

L’application Citrix Workspace prend en charge la collecte de journaux pour les sessions d’applications et de bureaux virtuels en cours. Auparavant, vous ne collectiez les 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 la session en cours et les sessions suivantes jusqu’à ce que vous sélectionniez Arrêter la journalisation.

Amélioration du dépannage pour les appareils mobiles

Vous pouvez accéder rapidement au fichier journal de session en appuyant sur l’option Obtenir les journaux. L’option de journalisation est renommée de Journalisation en Obtenir les journaux. Lorsque vous sélectionnez Obtenir les journaux dans le menu secondaire, le fichier journal est téléchargé sur votre appareil, et non dans un nouvel onglet de navigateur.

Remarque :

Vous pouvez collecter les journaux de la session en cours et d’un maximum des cinq sessions précédentes.

Comment collecter les journaux

Pour collecter les journaux client de l’application Citrix Workspace pour HTML5, procédez comme suit :

1. Connectez-vous à l’application Citrix Workspace pour HTML5.

2. Accédez à la page Fichiers journaux comme suit :
   • Pour les versions 1908 et ultérieures de l’application Citrix Workspace, ouvrez un nouvel onglet et accédez à siteurl/Clients/HTML5Client/src/SessionWindow.html#engineType=log, où siteurl est l’URL du site Workspace pour le Web, par exemple, https://server.domain/Citrix/StoreWeb.
   • Pour les versions 1907 et antérieures de l’application Citrix Workspace, ouvrez un nouvel onglet et accédez à siteurl/Clients/HTML5Client/src/ViewLog.html, où siteurl est l’URL du site Citrix Workspace pour le Web, par exemple, https://server.domain/Citrix/StoreWeb.

3. Sur la page Fichiers journaux, cliquez sur Démarrer la journalisation.

   

   La journalisation est activée pour le prochain lancement de session, et non pour la session active en cours (le cas échéant).

4. Connectez-vous à l’application Citrix Workspace, démarrez votre session d’application virtuelle et reproduisez le problème pour collecter les journaux. Continuez à travailler sur la session pour reproduire le problème.

5. Fermez la session une fois le problème reproduit.

6. Les fichiers journaux générés pour la session de l’application Citrix Workspace pour HTML5 sont affichés sur la page de journalisation.

   

7. Cliquez sur le bouton flèche pour télécharger et enregistrer le fichier journal.

   

Remarque :

• Pour activer et afficher les journaux de l’application Citrix Workspace pour HTML5, vous pouvez utiliser l’option Journalisation du menu de la barre d’outils de session.

Comment collecter les journaux de la console

Pour collecter les journaux de la console de l’application Citrix Workspace pour HTML5, procédez comme suit :

1. Ouvrez les Outils de développement sur l’onglet du navigateur où la session est en cours d’exécution. Par exemple, dans le navigateur Google Chrome, les Outils de développement se trouvent sous l’option Plus d’outils.

   

2. Cliquez sur Console dans l’outil de développement ouvert.

3. Cliquez avec le bouton droit de la souris et sélectionnez l’option Enregistrer sous pour enregistrer tous les journaux.

   

Comment collecter les journaux de redirection USB

Pour activer la journalisation et collecter les journaux pour les problèmes liés à la redirection USB, procédez comme suit :

Activer les journaux

1. Modifiez le fichier configuration.js et accédez à la section HTML5_CONFIG.

2. Ajoutez la valeur moreLogs{‘usb’: true}. Ce paramètre est pertinent pour StoreFront. Le fichier configuration.js se trouve à C:\program Files\Citrix <actual path>\HTML5Client.

Collecte des journaux

Pour collecter les journaux, consultez Comment collecter les journaux.

Journaux de périphérique

Pour collecter les journaux de périphérique, ouvrez un nouvel onglet dans le navigateur Google Chrome, saisissez chrome://device-log, puis partagez les journaux.

Comment collecter les journaux d’optimisation de Microsoft Teams

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

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

1. Ouvrez l’application Microsoft Teams et démarrez 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 + Shift + 1.

   Vous pouvez maintenant afficher les fichiers journaux dans le dossier de téléchargements du VDA.

4. Ouvrez le fichier MSTeams_Diagnostics Log <date><time>.txt et recherchez la version shim sous type_script. Par exemple, “version”:{“type_script”:”1.10.0.0”}.

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.

Traçage permanent (AOT)

L’application Citrix Workspace pour HTML5 prend désormais en charge le traçage permanent (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 le besoin de reproduire les problèmes.

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

Avantages

L’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 le besoin 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 d’expertise de niveau ingénieur
• Permettant des diagnostics en libre-service pour réduire la dépendance au support Citrix
• Améliorant le temps moyen de résolution pour les scénarios de dépannage

Cas d’utilisation

L’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 autonome à l’aide de données de journal accessibles

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.

Remarque :

L’application Citrix Workspace pour HTML5 2603 prend désormais en charge le téléchargement des journaux AOT vers des serveurs de journaux centralisés pour les configurations sur site qui incluent une passerelle dans le chemin.

À partir de l’application Citrix Workspace pour HTML5 2603, vous pouvez désactiver la fonctionnalité AOT en ajoutant la configuration suivante :

{
  "aot": {
    "enabled": false
  }
}
<!--NeedCopy-->

Prérequis

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

Limitations

Les journaux AOT ne peuvent pas être téléchargés si le serveur de journaux utilise HTTP avec les navigateurs Mozilla Firefox et Apple Safari.

Comment configurer

Pour configurer, vous devez d’abord installer et configurer le serveur de journaux. Pour les é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 sur Windows ou StartLogServer.sh sur Linux.

Pour permettre la communication entre l’application Citrix Workspace pour HTML5 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) dans 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 sur Linux) en modifiant le paramètre CORS_ORIGINS :

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

Exemple pour une seule URL :

   -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 StartLogServer.bat (ou StartLogServer.sh sur Linux).

Expérience de l’utilisateur final

Sur l’écran Fichiers journaux, cliquez sur Télécharger tous les journaux. L’application collecte 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_HTML5_LOGS_[timestamp].zip, garantissant clarté et identification facile.

Pour plus d’informations, consultez Comment collecter les journaux.

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

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

Prérequis

• Application Citrix Workspace pour HTML5 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.

Désactiver le téléchargement des journaux de l’application Citrix Workspace dans les boîtes de dialogue d’erreur

À partir de la version 2505, les administrateurs peuvent masquer le bouton Télécharger le journal dans toutes les boîtes de dialogue d’erreur pour les sessions d’application et de bureau dans l’application Citrix Workspace pour HTML5 (cloud et sur site).

Remarque :

Cette fonctionnalité est désactivée par défaut. En d’autres termes, l’utilisateur a la possibilité de télécharger les journaux à partir de la boîte de dialogue d’erreur.

Pour plus d’informations, consultez Désactiver le téléchargement des journaux de l’application Citrix Workspace dans les boîtes de dialogue d’erreur.

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 de la bibliothèque d’authentification Microsoft (MSAL) :

   i. Installez Charles ou Fiddler sur le point de terminaison. ii. Connectez-vous au Microsoft Entra ID Store dans le navigateur où le problème se produit. iii. Démarrez l’application Charles ou Fiddler. iv. Démarrez une session de l’application Citrix Workspace pour HTML5. Après avoir reproduit le problème, exportez les traces Fiddler en cliquant sur Fichier > Enregistrer > Toutes les sessions. Cela télécharge les traces que vous partagerez avec Citrix. Pour plus d’informations, consultez la capture d’écran suivante :

   

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 (SSO) peut échouer même avec une négociation de capacités réussie depuis l’application Citrix Workspace.

FAQ

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

Vous pouvez trouver les dernières informations sur l’application Citrix Workspace pour HTML5 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 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 pour les utilisateurs finaux. Les administrateurs peuvent la personnaliser à l’aide du service de configuration globale des applications. Pour plus d’informations, consultez Personnalisation de la barre d’outils dans la documentation du produit.

Comment configurer les suites de chiffrement pour le VDA compatible SSL avec l’application Citrix Workspace pour HTML5 ?

Pour configurer les suites de chiffrement, consultez l’article suite de chiffrement dans la documentation de l’application Citrix Workspace pour HTML5.