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

Téléchargement des journaux AOT à partir des composants principaux de CVAD

April 8, 2026
Contributeur: 
C C

À partir de CVAD 2507 CU1 et CVAD 2511, les journaux AOT sont collectés auprès de tous les composants applicables. Les composants pris en charge incluent DDC, StoreFront, Citrix Director, VDA Windows, VDA Linux, VDA Mac, License Server, FAS, Cloud Connector, PVS, WEM, Session Recording, l’interface utilisateur de Citrix Workspace et Citrix Gateway.

Configuration centralisée de la transmission des journaux via Citrix Web Studio

  • Citrix Web Studio offre un emplacement centralisé pour configurer la transmission des journaux de traçage permanent (AOT) sur l’ensemble du site. Ce paramètre définit l’endroit où les journaux AOT sont envoyés et propage automatiquement la configuration aux composants pertinents de l’environnement.

  • Lorsque vous configurez le serveur de journaux dans Web Studio :

  • La configuration est écrite dans la base de données du site.
  • Les Delivery Controllers récupèrent les paramètres mis à jour et les distribuent aux VDA dans les groupes de mise à disposition sélectionnés.
  • Les VDA utilisent la configuration reçue pour transmettre leurs journaux AOT au serveur de journaux spécifié.
  • StoreFront, qui participe à la journalisation AOT, reçoit les détails nécessaires via le même mécanisme centralisé.

  • Director utilise la clé d’authentification (AuthKey) et les détails du serveur de journaux fournis pour interroger et afficher les journaux AOT à des fins de surveillance et de dépannage.

  • Cette approche centralisée élimine la nécessité de configurer chaque composant individuellement. Vous configurez les détails du serveur de journaux une seule fois dans Web Studio, et Citrix propage automatiquement la configuration sur l’ensemble du site.

  • Voici la liste des composants qui recevront les détails du serveur de journaux une fois qu’il sera configuré dans Web Studio :

  • Citrix Director/Monitor
  • Citrix Delivery Controller
  • VDA Windows
  • VDA Linux
    • VDA Mac
    • StoreFront
  • Agent d’enregistrement de session
  • CWA

Pour configurer les paramètres du serveur de journaux pour un environnement sur site

Paramètres du serveur de journaux AOT

  1. Connectez-vous à Web Studio et sélectionnez Paramètres dans le volet gauche.
      1. Dans la tuile Serveur de journaux, sélectionnez Ajouter si aucun serveur de journaux n’est configuré.
      1. Sur la page Serveur de journaux, activez Activer la transmission des journaux au serveur de journaux.

  2. Saisissez l’adresse du serveur de journaux et le port. Les VDA et les Delivery Controllers utilisent ces informations pour transmettre les journaux AOT.

    Remarque :

    1. Si vous utilisez l’appliance Citrix Connector pour déployer le serveur de journaux, assurez-vous que seul le port 443 est configuré.

    2. La mise à jour de l’adresse et du port du serveur de journaux dans Citrix Studio fonctionne initialement, mais si vous revisitez les paramètres et modifiez les détails du serveur de journaux sans ressaisir la clé d’authentification, l’espace réservé de la clé d’authentification devient vide après l’enregistrement, même si l’opération semble réussie. Cela entraîne une configuration manquante ou non valide dans Director et Monitor. Pour contourner ce problème, ressaisissez et validez toujours la clé d’authentification chaque fois que vous modifiez les paramètres du serveur de journaux, jusqu’à ce que ce problème soit résolu.

  3. Choisissez les composants qui transmettent les journaux :

    1. Inclure les Delivery Controllers : Envoie les journaux AOT de tous les Delivery Controllers.

    2. Sélectionner les groupes de mise à disposition : Envoie les journaux des VDA dans les groupes de mise à disposition sélectionnés.

      • Tous les groupes de mise à disposition : Envoie les journaux de tous les VDA.
      • Sélectionner des groupes de mise à disposition spécifiques : Choisissez les groupes de mise à disposition individuels à inclure.
  4. Saisissez la clé d’authentification (AuthKey) générée sur le serveur de journaux. Director utilise cette clé pour s’authentifier et récupérer les journaux.
  5. Sélectionnez Enregistrer pour appliquer la configuration.

Pour modifier une configuration existante

Pour mettre à jour le serveur de journaux ou modifier l’étendue de la journalisation, accédez à Paramètres > Serveur de journaux et sélectionnez Modifier.

Pour configurer les paramètres du serveur de journaux pour l’environnement Citrix DaaS/Cloud

Paramètres du serveur de journaux AOT 1

Citrix Web Studio pour DaaS offre un emplacement centralisé pour configurer la transmission des journaux de traçage permanent (AOT) pour les sites gérés dans le cloud. Cette configuration détermine l’endroit où les journaux AOT sont envoyés et contrôle quels VDA participent à la transmission des journaux. Monitor utilise ces paramètres pour récupérer et afficher les journaux à des fins de dépannage.

  1. Connectez-vous à Web Studio et sélectionnez Paramètres dans le volet gauche.
  2. Dans la tuile Serveur de journaux, sélectionnez Ajouter si aucun serveur de journaux n’est actuellement configuré.
  3. Sur la page Serveur de journaux, saisissez l’adresse du serveur de journaux et le port. Les VDA utilisent ces informations pour transmettre les journaux AOT au serveur.

  4. Définissez quels VDA transmettent les journaux :

    1. Sélectionnez Sélectionner les groupes de mise à disposition pour contrôler l’étendue.
    2. Tous les groupes de mise à disposition (par défaut) transmet les journaux de tous les VDA du site.
    3. Pour cibler des VDA spécifiques, sélectionnez Sélectionner des groupes de mise à disposition spécifiques, et choisissez les groupes de mise à disposition que vous souhaitez inclure.

    Remarque :

    Si vous utilisez l’appliance Citrix Connector pour déployer le serveur de journaux, assurez-vous que seul le port 443 est configuré.

  5. Sélectionnez la zone (emplacement de ressource) où le serveur de journaux est déployé.
  6. Saisissez la clé d’authentification (Authkey) générée par le serveur de journaux. Monitor utilise cette clé pour s’authentifier et récupérer les journaux pour l’affichage.
  7. Sélectionnez Enregistrer pour appliquer la configuration.

Configuration de la transmission des journaux pour d’autres composants

Configurer le téléchargement des journaux AOT pour le serveur d’enregistrement de session

Vous pouvez configurer le serveur d’enregistrement de session pour télécharger les journaux AOT vers un serveur de journaux central en exécutant la commande PowerShell suivante sur la machine du serveur d’enregistrement de session :

#Enable - run following command in Session Recording Server PowerShell
-  Enable-CitrixAOTUpload -AotDataStoreEndpoint <server address>:<server port> -Role SessionRecording

#Disable - run following command in Session Recording Server PowerShell
Disable-CitrixAOTUpload
<!--NeedCopy-->

  • Configurer le téléchargement des journaux AOT pour FAS

Vous pouvez configurer FAS pour télécharger les journaux AOT vers un serveur de journaux central en exécutant la commande PowerShell suivante sur le serveur FAS :

#Enable - run following command in FAS PowerShell
Enable-CitrixAOTUpload -AotDataStoreEndpoint <server address>:<server port> -Role FAS

#Disable - run following command in FAS PowerShell
Disable-CitrixAOTUpload
<!--NeedCopy-->

Configurer le téléchargement des journaux AOT pour PVS

Vous pouvez configurer PVS pour télécharger les journaux AOT vers un serveur de journaux central en exécutant la commande PowerShell suivante sur le serveur PVS :

#Enable - run following command in PVS PowerShell
Enable-CitrixAOTUpload -AotDataStoreEndpoint <server address>:<server port> -Role PVS

#Disable - run following command in PVS PowerShell
Disable-CitrixAOTUpload
<!--NeedCopy-->

Remarque :

Si vous avez plusieurs serveurs PVS, exécutez la commande pour activer ou désactiver le téléchargement des journaux AOT sur chacun d’eux.

Téléchargement des journaux AOT pour le serveur de licences

  • L’URL du serveur de journaux doit être mise à jour dans le fichier de configuration SLS, qui se trouve à l’emplacement “C:\Program Files (x86)\Citrix\Licensing\WebServicesForLicensing\SimpleLicenseServiceConfig.xml” avec la balise XML “AotServerURL”.

Exemple :

<AotServerURL>https://10.110.249.168:8443/ctxlogserver/UploadCitrixLogStream</AotServerURL>
<!--NeedCopy-->
  • Le serveur de licences télécharge périodiquement les journaux vers le serveur AOT automatiquement.

Configurer le téléchargement des journaux AOT pour Citrix Connector pour Windows

L’URL du serveur de journaux est automatiquement synchronisée depuis Citrix Cloud. Aucune action n’est requise.

Configurer le téléchargement des journaux AOT pour les applications Citrix Workspace

Citrix permet aux clients de l’application Citrix Workspace de télécharger automatiquement les journaux de diagnostic vers le serveur de journaux centralisé. Cette capacité améliore l’efficacité du dépannage en offrant aux administrateurs un accès immédiat aux informations de diagnostic côté client sans nécessiter de collecte manuelle des journaux. Les AOT côté client seront automatiquement téléchargés, et cela se déclenche lorsque la fonctionnalité AOT est activée dans l’ensemble de l’environnement CVAD, et lorsqu’un utilisateur lance une ressource.

Configuration requise

  • Citrix Virtual Apps and Desktops 2511 ou CVAD 2507 CU1 et versions ultérieures
  • Application Citrix Workspace 2511 ou CWA 2507.1 CU1 et versions ultérieures
Plateforme client Version minimale Matrice prise en charge
CWA pour Windows CWA 2507.1 CU1, 2511 Accès direct via StoreFront (sur site)
CWA pour HTML5 CWA 2511 Accès direct via StoreFront (sur site)
CWA pour Chrome OS CWA 2511 Accès direct via StoreFront (sur site)

Pour activer la fonctionnalité AOT pour CWA pour Windows, veuillez ajouter la clé de registre suivante :

HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\Dazzle Name: AotLogCollectionEnabled Type: REG_SZ Value: True

Configurer le téléchargement des journaux AOT pour NetScaler

  • Connectez-vous en SSH à l’interface de ligne de commande (CLI) de NetScaler, puis accédez au shell NetScaler en exécutant la commande “shell”.

  • Accédez au répertoire /var/analytics_conf

    cd /var/analytics_conf
<!--NeedCopy-->
  • Générez le fichier de schéma en exécutant un script Python interactif python {Add script name}. Le fichier de schéma définit les en-têtes HTTP (jeton d’authentification, User-Agent, etc.) et les attributs de charge utile (Rôle, IP de la machine, etc.).

Extrait de la sortie générée par ce script 

root@Raju-adc2# python schema_generator_for_syslog_final.py 
-  Schema Builder: Follow the prompts to define your schema. 
-  Include 'Auth-Token'? (Y/n):  
Enter the display name (alias) for 'Auth-Token' (press Enter to keep as is): Authkey 
'Auth-Token' can only go in 'header'. Automatically selected. 
Include 'HostName'? (Y/n): n 
Include 'Content-type'? (Y/n): y 
Enter the display name (alias) for 'Content-type' (press Enter to keep as is): 
'Content-type' can only go in 'header'. Automatically selected. 
Default value for 'Content-type' is 'application/json'.  
-  Do you want to change it? (y/N):  
Include 'User-agent'? (Y/n):  
Enter the display name (alias) for 'User-agent' (press Enter to keep as is): 
'User-agent' can only go in 'header'. Automatically selected. 
Default value for 'User-agent' is 'AUDITLOGS/1.0'.  
Do you want to change it? (y/N):  
Include 'Role'? (Y/n): y  
Enter the display name (alias) for 'Role' (press Enter to keep as is):  
Where should 'Role' be included? (HEADER/payload): HEADER  
Default value for 'Role' is 'GW'.  
Do you want to change it? (y/N): y  
Enter new default value for 'Role': Gateway  
<!--NeedCopy-->

Exemple de fichier de schéma généré 

{ 
     "Header": { 
         "Auth-Token": { 
             "name": "AuthKey" 
         }, 
         "Content-type": { 
             "name": "Content-type", 
             "value": "application/json" 
         }, 
         "User-agent": { 
             "name": "User-agent", 
             "value": "AUDITLOGS/1.0" 
         }, 
         "Role": { 
             "name": "Role", 
             "value": "Gateway" 
         }, 
         "MachineIP": { 
             "name": "MachineIP" 
         }, 
         "MachineName": { 
             "name": "MachineName" 
         } 
     }, 
     "Payload": { 
         "LogLevel": "Level", 
         "MessageContent": "Message", 
         "ModuleName": "Module", 
         "Time": "TimeStamp" 
     }, 
     "Format": { 
         "delimiter": "" 
     } 
 }
<!--NeedCopy-->
  • Quittez le shell et revenez à l’interface de ligne de commande (CLI) de NetScaler.
  • Créez une action syslog qui définit le serveur Syslog, les ports et le fichier de schéma (créé à l’étape précédente), etc.
add audit syslogAction {Action Name} {AOT Server IP/FQDN} -serverPort {Destination Port} -logLevel {Log Level} -transport HTTP -httpAuthToken {Authentication Token generated on the AOT sever} -httpEndpointUrl {AOT Server URL where logs will be sent} -httpSchemaFile {Schema File created in Previous Step}
<!--NeedCopy-->

Exemple :

add audit syslogAction act1 10.102.154.196 -serverPort 8088 -logLevel ALL -transport HTTP -httpAuthToken fbb94d5b234d86a6cb155e3f808dd33c9698a0d1a866e814573b1909e4c9e56896f433da1071e3276bd133269fd69203d8f29166816f4d427e709773ceb9d41d531043331f7f76 -httpEndpointUrl "/services/collector/event" -httpSchemaFile sample.json
<!--NeedCopy-->
  • Lie l’action syslog à la stratégie d’audit Syslog.
add audit syslogPolicy {PolicyName} True {Name of the Syslog Action}
<!--NeedCopy-->

Exemple :

add audit syslogPolicy pol1 true act1
<!--NeedCopy-->
Téléchargement des journaux AOT à partir des composants principaux de CVAD
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.