Documentazione dei prodotti
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Visualizza PDF

Caricamento dei log AOT dai componenti principali di CVAD

January 23, 2026
Grazie al contributo di: 
C

A partire da CVAD 2507 CU1 e CVAD 2511, i log AOT vengono raccolti da tutti i componenti applicabili. I componenti supportati includono DDC, StoreFront, Citrix Director, Windows VDA, Linux VDA, Mac VDA, License Server, FAS, Cloud Connector, PVS, WEM, Session Recording, Citrix Workspace UI e Citrix Gateway.

Nota:

Tutti i log client di CWA saranno disponibili in una versione specifica. Fare riferimento alla sezione per gli aggiornamenti in tempo reale.

Configurazione centralizzata dell’inoltro dei log tramite Citrix Web Studio

Citrix Web Studio offre una posizione centralizzata per la configurazione dell’inoltro dei log Always-on Tracing (AOT) in tutto il sito. Questa impostazione definisce dove vengono inviati i log AOT e propaga automaticamente la configurazione ai componenti pertinenti nell’ambiente.

Quando si configura il server di log in Web Studio:

  • La configurazione viene scritta nel database del sito.
  • I Delivery Controller recuperano le impostazioni aggiornate e le distribuiscono ai VDA nei gruppi di consegna selezionati.
  • I VDA utilizzano la configurazione ricevuta per inoltrare i propri log AOT al server di log specificato.
  • StoreFront, che partecipa alla registrazione AOT, riceve i dettagli necessari tramite lo stesso meccanismo centralizzato.
  • Director utilizza la AuthKey fornita e i dettagli del server di log per interrogare e visualizzare i log AOT per il monitoraggio e la risoluzione dei problemi.

Questo approccio centralizzato elimina la necessità di configurare ogni componente individualmente. Si impostano i dettagli del server di log una sola volta in Web Studio e Citrix propaga automaticamente la configurazione in tutto il sito.

Di seguito è riportato l’elenco dei componenti che riceveranno i dettagli del server di log una volta impostati in Web Studio:

  • Citrix Director/Monitor
  • Citrix Delivery Controller
  • Windows VDA
  • Linux VDA
  • Mac VDA
  • StoreFront
  • Session Recording Agent
  • CWA

Per configurare le impostazioni del server di log per l’ambiente on-premise

Impostazioni del server di log AOT

  1. Accedere a Web Studio e selezionare Settings (Impostazioni) nel riquadro sinistro.
  2. Nel riquadro Log server (Server di log), selezionare Add (Aggiungi) se non è configurato alcun server di log.
  3. Nella pagina Log server (Server di log), attivare Enable log forwarding to log server (Abilita inoltro log al server di log).
  4. Immettere l’indirizzo del server di log e la porta. I VDA e i Delivery Controller utilizzano queste informazioni per inoltrare i log AOT.

  5. Scegliere quali componenti inoltrano i log:

    1. Include Delivery Controllers (Includi Delivery Controller): Invia i log AOT da tutti i Delivery Controller.

    2. Select delivery groups (Seleziona gruppi di consegna): Invia i log dai VDA nei gruppi di consegna selezionati.

      • All delivery groups (Tutti i gruppi di consegna): Invia i log da tutti i VDA.
      • Select specific delivery groups (Seleziona gruppi di consegna specifici): Scegliere i singoli gruppi di consegna da includere.
  6. Immettere la AuthKey generata sul server di log. Il Director utilizza questa chiave per autenticare e recuperare i log.
  7. Selezionare Save (Salva) per applicare la configurazione.

Per modificare una configurazione esistente

Per aggiornare il server di log o modificare l’ambito di registrazione, andare su Settings (Impostazioni) > Log server (Server di log) e selezionare Edit (Modifica).

Per configurare le impostazioni del server di log per l’ambiente Citrix DaaS/Cloud

Impostazioni del server di log AOT 1

Citrix Web Studio per DaaS offre una posizione centralizzata per configurare l’inoltro dei log Always-on Tracing (AOT) per i siti gestiti dal cloud. Questa configurazione determina dove vengono inviati i log AOT e controlla quali VDA partecipano all’inoltro dei log. Monitor utilizza queste impostazioni per recuperare e visualizzare i log per la risoluzione dei problemi.

  1. Accedere a Web Studio e selezionare Settings (Impostazioni) nel riquadro sinistro.
  2. Nel riquadro Log server (Server di log), selezionare Add (Aggiungi) se non è attualmente configurato alcun server di log.
  3. Nella pagina Log server (Server di log), immettere l’indirizzo del server di log e la porta. I VDA utilizzano queste informazioni per inoltrare i log AOT al server.

  4. Definire quali VDA inoltrano i log:

    1. Selezionare Select delivery groups (Seleziona gruppi di consegna) per controllare l’ambito.
    2. All delivery groups (Tutti i gruppi di consegna) (impostazione predefinita) inoltra i log da tutti i VDA nel sito.
    3. Per indirizzare VDA specifici, selezionare Select specific delivery groups (Seleziona gruppi di consegna specifici) e scegliere i gruppi di consegna che si desidera includere.
  5. Selezionare la Zona (posizione della risorsa) in cui è distribuito il server di log.
  6. Immettere la Authkey generata dal server di log. Monitor utilizza questa chiave per autenticare e recuperare i log per la visualizzazione.
  7. Selezionare Save (Salva) per applicare la configurazione.

Configurazione dell’inoltro dei log per altri componenti

Configurare il caricamento dei log AOT per Session Recording Server

È possibile configurare Session Recording Server per caricare i log AOT su un server di log centrale eseguendo il seguente comando PowerShell sulla macchina Session Recording Server:

#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-->

Configurare il caricamento dei log AOT per FAS

È possibile configurare FAS per caricare i log AOT su un server di log centrale eseguendo il seguente comando PowerShell sul server 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-->

Configurare il caricamento dei log AOT per PVS

È possibile configurare PVS per caricare i log AOT su un server di log centrale eseguendo il seguente comando PowerShell sul server 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-->

Nota:

Se si dispone di più server PVS, eseguire il comando per abilitare o disabilitare il caricamento dei log AOT su ciascuno di essi.

Caricamento dei log AOT per License Server

  • L’URL del server di log deve essere aggiornato all’interno del file di configurazione SLS, che si trova nella posizione “C:\Program Files (x86)\Citrix\Licensing\WebServicesForLicensing\SimpleLicenseServiceConfig.xml” con il tag XML “AotServerURL”

Esempio:

<AotServerURL>https://10.110.249.168:8443/ctxlogserver/UploadCitrixLogStream</AotServerURL>
<!--NeedCopy-->
  • Il License Server carica periodicamente i log sul server AOT automaticamente.

Configurare il caricamento dei log AOT per Citrix Connector per Windows

L’URL del server di log viene sincronizzato automaticamente da Citrix Cloud. Non è richiesta alcuna azione.

Configurare il caricamento dei log AOT per le app Citrix Workspace

Citrix consente ai client dell’app Citrix Workspace di caricare automaticamente i log diagnostici sul server di log centralizzato. Questa funzionalità migliora l’efficienza della risoluzione dei problemi fornendo agli amministratori un accesso immediato alle informazioni diagnostiche lato client senza richiedere la raccolta manuale dei log. Gli AOT lato client verranno caricati automaticamente e l’operazione si attiva quando la funzionalità AOT è abilitata nell’intero ambiente CVAD e quando l’utente avvia una risorsa.

Requisiti di sistema

  • Citrix Virtual Apps and Desktops 2511 o CVAD 2507 CU1 e versioni successive
  • Citrix Workspace app 2511 o CWA 2507.1 CU1 e versioni successive
Piattaforma client Versione minima Matrice supportata
CWA per Windows CWA 2507.1 CU1, 2511 Accesso diretto tramite Storefront (on-premise)
CWA per HTML5 CWA 2511 Accesso diretto tramite Storefront (on-premise)
CWA per Chrome OS CWA 2511 Accesso diretto tramite Storefront (on-premise)

Configurare il caricamento dei log AOT per NetScaler

  • Eseguire l’SSH nella CLI di NetScaler e quindi accedere alla shell di NetScaler eseguendo il comando “shell”.
  • Accedere alla directory /var/analytics_conf
cd /var/analytics_conf
<!--NeedCopy-->
  • Generare il file di schema eseguendo uno script Python interattivo “python {Add script name}”. Il file di schema definisce le intestazioni HTTP (Auth-token, User-Agent ecc.) e gli attributi del payload (Role, Machine IP ecc.).

Estratto dell’output generato da questo 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-->

File di schema di esempio generato 

{ 
     "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-->
  • Uscire dalla shell e tornare alla CLI di NetScaler
  • Creare un’azione syslog che definisca il server syslog, le porte e il file di schema (creato nel passaggio precedente) ecc.
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-->

Esempio:

add audit syslogAction act1 10.102.154.196 -serverPort 8088 -logLevel ALL -transport HTTP -httpAuthToken fbb94d5b234d86a6cb155e3f808dd33c9698a0d1a866e814573b1909e4c9e56896f433da1071e3276bd133269fd69203d8f29166816f4d427e709773ceb9d41d531043331f7f76 -httpEndpointUrl "/services/collector/event" -httpSchemaFile sample.json
<!--NeedCopy-->
  • Associare la syslogAction alla Audit Syslog Policy
add audit syslogPolicy {PolicyName} True {Name of the Syslog Action}
<!--NeedCopy-->

Esempio:

add audit syslogPolicy pol1 true act1
<!--NeedCopy-->
Caricamento dei log AOT dai componenti principali di CVAD
January 23, 2026
Grazie al contributo di: 
C
January 23, 2026
Grazie al contributo di: 
C

In questo articolo

Feedback sito | Your privacy choices footer linkScelte di privacy | Privacy e condizioni legali | Preferenze cookie | Impostazioni di consenso | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.