Documentation produit
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Voir PDF

Affichage et utilisation des journaux AOT

April 8, 2026
Contributeur: 
C C

Accès aux journaux via l’interface utilisateur de Director

Étape 1

  • Modifiez le fichier StartLogServer.bat

Le fichier StartLogServer.bat contient tous les paramètres de configuration utilisés pour démarrer le conteneur du serveur de journaux AOT, y compris plusieurs variables d’environnement qui contrôlent l’accès et le comportement des journaux. L’un des paramètres clés est LOCAL_DOWN_ONLY.

  • Lorsque LOCAL_DOWN_ONLY=false, le serveur de journaux accepte les requêtes de consultation de journaux à distance. Cela permet à Citrix Director/Monitor de se connecter au serveur de journaux et d’afficher les journaux AOT directement dans l’interface utilisateur de Monitor.

  • Lorsque LOCAL_DOWN_ONLY=true, le serveur de journaux restreint l’accès aux journaux aux connexions locales uniquement. Dans ce mode, vous devez vous connecter directement à la machine du serveur de journaux pour consulter les journaux, et Citrix Director Monitor ne pourra pas récupérer ou afficher les journaux.

Fichier bat AOT

Étape 2

Web Studio fournit un paramètre dédié qui permet à Citrix Director de se connecter au serveur de journaux AOT et d’afficher les journaux dans la console Monitor. Une fois les paramètres de Web Studio enregistrés, les Delivery Controllers mettent à jour la configuration du site, et Director reçoit les détails du serveur de journaux, y compris l’adresse, le port et la clé d’authentification du serveur de journaux. Director utilise ces paramètres pour établir une connexion sécurisée au serveur de journaux.

  • Étape 3

  • Après la configuration :
  1. Ouvrez Citrix Director.
  2. Une nouvelle option Journaux apparaît dans le panneau de navigation de gauche.
  3. Sélectionnez Journaux et vous verrez la page de démarrage. Cliquez sur Fermer pour la passer, car nous avons déjà effectué ces réglages.
    1. Vous verrez maintenant Director récupérer et afficher les journaux AOT directement depuis le serveur de journaux.
  • Citrix Director

La page Journaux de Director offre une vue unifiée des événements AOT provenant des Delivery Controllers, des VDA, des serveurs StoreFront et d’autres composants Citrix. Vous pouvez rechercher, filtrer et inspecter les journaux en temps réel pour résoudre rapidement les problèmes.

Recherche en texte libre : En haut de la page Journaux, vous trouverez une barre de recherche en texte libre. Vous pouvez taper n’importe quel mot-clé pour commencer à affiner les résultats. La recherche met à jour les résultats instantanément une fois que vous appliquez des filtres. Exemples :

  • Noms d’utilisateur
  • Noms de machine
  • Mots-clés d’événement (par exemple, enregistrement, authentification, STA)
  • ID de transaction
  • Messages d’erreur ou chaînes partielles

Filtre temporel : Utilisez le sélecteur de temps (par exemple, Dernières 5 minutes, Dernière 1 heure, Dernières 24 heures) pour afficher les journaux générés pendant une durée spécifique. Cela vous aide à isoler rapidement les événements autour du moment exact où un problème est survenu.

Filtre de catégorie : Le champ Catégorie vous permet de filtrer les journaux en fonction du type d’événement ou de sous-système. Cela vous aide à vous concentrer sur les journaux liés au lancement d’applications, à l’enregistrement, à la configuration VDA, aux graphiques, à HDX Direct, à la connexion ICA, etc.

Filtre de classe de journal : Le filtre de classe de journal regroupe les journaux par gravité ou par type d’événement. Cela vous permet de vous concentrer uniquement sur les erreurs ou les événements importants lors du dépannage. Les classes courantes incluent :

  • Information
  • Avertissement
  • Erreur
  • Échec

Filtre de nom d’hôte : Le filtre de nom d’hôte vous permet de sélectionner une machine spécifique, telle qu’un VDA, un Delivery Controller, un CWA ou un serveur StoreFront. Ceci est utile lorsque vous souhaitez explorer les journaux d’un seul point de terminaison ou d’une seule VM au lieu de rechercher dans l’ensemble du déploiement.

Cet accès centralisé simplifie le dépannage en permettant une récupération et une analyse rapides des journaux à partir d’une seule console. Apprenez-en davantage sur les prérequis et la prise en main dans Director - Journaux.

Accès aux journaux via le serveur de journaux

Le contenu suivant concerne la génération de la clé d’authentification. Pour activer l’accès aux journaux, l’utilisateur doit :

  1. Modifier le script StartLogServer.bat LOCAL_DOWN_ONLY=false
  2. Générer la clé d’authentification

Pour sécuriser vos journaux, vous aurez besoin d’une clé d’authentification avant de les télécharger. Voici la marche à suivre :

  1. Obtenez votre clé d’authentification – Utilisez votre propre nom de rôle/nom pour la générer.
  2. Exécutez localement – Les scripts ne peuvent s’exécuter que sur la machine où le conteneur Docker est installé.
  3. Utilisateurs Windows – Utilisez les scripts GetAuthKey.bat au lieu des scripts shell.
  4. Téléchargez les journaux – Une fois authentifié, vous pouvez récupérer vos journaux en toute sécurité.

Générer la clé d’authentification

Pour Linux 

./GetAuthKey.sh role-name
{"key":"ebac9b7726cb4be597c92c6769134d25","role":"role-name","status":"DONE"}
<!--NeedCopy-->

Pour Windows 

GetAuthKey.bat role-name
{"key":"ebac9b7726cb4be597c92c6769134d25","role":"role-name","status":"DONE"}
<!--NeedCopy-->

Enregistrez la clé : ebac9b7726cb4be597c92c6769134d25 par vous-même. C’est le seul moyen d’obtenir la clé.

Lister les noms de machines qui ont déjà envoyé leurs journaux AOT au serveur de journaux

Le paramètre est la clé obtenue à partir de GetAuthKey.sh

Pour Linux 

./ListMachines.sh ebac9b7726cb4be597c92c6769134d25
{"machines":["MachineName"]}
<!--NeedCopy-->

Les machines vides signifient qu’il n’y a pas de journal.

Pour Windows 

ListMachines.bat ebac9b7726cb4be597c92c6769134d25
{"machines":["MachineName"]}
<!--NeedCopy-->

Pour PowerShell sous Windows lorsque LogServer démarre avec “-e LOCAL_DOWN_ONLY=false” :

Invoke-WebRequest -Uri "https://logserver_fqdn:8443/ctxlogserver/Download/ListMachine" -Headers @{ AuthKey = "ebac9b7726cb4be597c92c6769134d25" }
<!--NeedCopy-->

Remplacez logserver_fqdn par le FQDN réel du serveur de journaux, et 8443 par le port réel du serveur de journaux. Remplacez https par http si l’installation est en mode http.

Les machines vides signifient qu’il n’y a pas de journal.

Télécharger les journaux par nom de machine et plage horaire.

Le temps est au format UTC : AAAA-mm-jjTHH:MM:SSZ.

#Usage: ./DownloadLogsByTime.sh [AuthKey] [MachineName] [StartTime|YYYY-mm-ddTHH:MM:SSZ] [EndTime|YYYY-mm-ddTHH:MM:SSZ] [OutputFile]
#Example:
<!--NeedCopy-->

Pour Linux 

./DownloadLogsByTime.sh ebac9b7726cb4be597c92c6769134d25 MachineName 2025-01-01T00:00:00Z 2025-01-02T00:00:00Z logs.csv
<!--NeedCopy-->

Pour Windows 

DownloadLogsByTime.bat ebac9b7726cb4be597c92c6769134d25 MachineName 2025-01-01T00:00:00Z 2025-01-02T00:00:00Z logs.csv
<!--NeedCopy-->

Pour PowerShell sous Windows lorsque LogServer démarre avec “-e LOCAL_DOWN_ONLY=false” :

Invoke-WebRequest -Uri "https://logserver_fqdn:8443/ctxlogserver/Download/TimeRange?start=2025-01-01T00:00:00Z&end=2025-01-02T00:00:00Z" -Headers @{ AuthKey = "ebac9b7726cb4be597c92c6769134d25" } -OutFile logs.csv
<!--NeedCopy-->

Télécharger les journaux par filtre de mot(s)-clé(s). Le temps est au format UTC

Remarque :

  • Un mot-clé peut être un seul mot ou une combinaison de mots.
  • Les mots-clés peuvent correspondre n’importe où dans le message du journal.
  • Un ID de transaction peut également être utilisé comme mot-clé.
#Usage: ./DownloadLogsByWords.sh [AuthKey] [StartTime|YYYY-mm-ddTHH:MM:SSZ] [EndTime|YYYY-mm-ddTHH:MM:SSZ] [SearchWords] [OutputFile]
#Example:
<!--NeedCopy-->

Pour Linux 

./DownloadLogsByWords.sh authkey 2025-01-01T00:00:00.000Z 2025-12-31T23:59:59.999Z "session launch" logs.csv
<!--NeedCopy-->

Pour Windows 

DownloadLogsByWords.bat authkey 2025-01-01T00:00:00.000Z 2025-12-31T23:59:59.999Z "failed vda" logs.csv
<!--NeedCopy-->

Pour PowerShell sous Windows lorsque LogServer démarre avec “-e LOCAL_DOWN_ONLY=false” :

Invoke-WebRequest -Uri "https://logserver_fqdn:8443/ctxlogserver/Download/SearchLog?start=2025-01-01T00:00:00Z&end=2025-01-02T00:00:00Z&words=failed vda" -Headers @{ AuthKey = "ebac9b7726cb4be597c92c6769134d25" } -OutFile logs.csv
<!--NeedCopy-->

Les mots sont séparés par un espace.

Affichage et utilisation des journaux AOT
April 8, 2026
Contributeur: 
C C
April 8, 2026
Contributeur: 
C C

Dans cet article

Commentaires sur le site | Your privacy choices footer linkVos préférences de confidentialité | Confidentialité et conditions légales | Préférences de cookies | Paramètres de consentement | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.