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 core di CVAD

January 23, 2026
Grazie al contributo di: 
C

Se ha configurato il server di log in modalità HTTPS https://<LogServerFQDN>:port, si assicuri che il certificato necessario sia correttamente installato e attendibile sul suo sistema.

  1. Caricamento dei log AOT da Storefront™

    #Abilita caricamento in HTTP

Set-STFDiagnosticsLogServer -Server LogServerFQDN:8080

#Oppure per usare HTTPS

Set-STFDiagnosticsLogServer -Server https://LogServerFQDN:8443

#Disabilita

Clear-STFDiagnosticsLogServer

#La configurazione avrà effetto tra un'ora. Per applicare le modifiche immediatamente, riavvii il servizio Citrix Telemetry.
<!--NeedCopy-->

  2. Caricamento dei log AOT da DDC:

    #Abilita caricamento in HTTP
Set-ConfigSite -LogServerEnabled $true -LogServerName LogServerFQDN -LogServerPort 8080

#Oppure abilita HTTPS
Set-ConfigSite -LogServerEnabled $true -LogServerName https://LogServerFQDN -LogServerPort 8443
#Disabilita HTTP
Set-ConfigSite -LogServerEnabled $false -LogServerName LogServerFQDN -LogServerPort 8080
#Disabilita HTTPS
Set-ConfigSite -LogServerEnabled $false -LogServerName https://LogServerFQDN -LogServerPort 8443
<!--NeedCopy-->

  3. Abilitare AOT su Windows VDA:

Dalla macchina in cui ha installato DDC, esegua i comandi seguenti e, successivamente, dovrà riavviare il servizio Citrix Desktop per applicare le modifiche immediatamente.

```bash
#Avviare, eseguire i seguenti comandi nella powershell di DDC
$configSlot = New-BrokerConfigurationSlot -Name VdaAotTracing -Description VdaAotTracing -SettingsGroup G=Telemetry


#Se si utilizza HTTPS, il parametro -Endpoint dovrebbe essere "https://logserverFQDN:8443"
$policy = New-BrokerLogServerAddress -Enabled $true -Endpoint "logserverFQDN:8080"
$mc = New-BrokerMachineConfiguration -ConfigurationSlotUid $configSlot.Uid -LeafName VdaAotTracing -Policy $policy


# Utilizzando il nome reale del Deliverygroup del suo VDA.
$dg = Get-BrokerDesktopGroup -Name "DeliverygroupName"  
Add-BrokerMachineConfiguration -InputObject $mc -DesktopGroup $dg


#Riavviare il servizio Citrix Desktop nel suo VDA per applicare le modifiche immediatamente.
<!--NeedCopy--> ```

Aggiornare quando l’indirizzo o la porta del server di log sono cambiati:

```bash
#Aggiornare, eseguire i seguenti comandi nella powershell di DDC
#Se si utilizza HTTPS, il parametro -Endpoint dovrebbe essere "https://NewLogServerFQDN:8443"


$policy = New-BrokerLogServerAddress -Enabled $true -Endpoint "NewLogServerFQDN:8443"
Set-BrokerMachineConfiguration -Name "VdaAotTracing\VdaAotTracing" -Policy $policy
$mc=Get-BrokerMachineConfiguration -Name "VdaAotTracing\VdaAotTracing"

# Utilizzando il nome reale del Deliverygroup del suo VDA.
$dg = Get-BrokerDesktopGroup -Name "DeliverygroupName"
Add-BrokerMachineConfiguration -InputObject $mc -DesktopGroup $dg
#Riavviare il servizio Citrix Desktop nel suo VDA per applicare le modifiche immediatamente.
<!--NeedCopy--> ```

Come disabilitare:

```bash
#Disabilitare, eseguire i seguenti comandi nella powershell di DDC


#Se si utilizza HTTPS, il parametro -Endpoint dovrebbe essere "https://LogServerFQDn:8443"
$policy = New-BrokerLogServerAddress -Enabled $false -Endpoint "LogServerFQDN:8080"
Set-BrokerMachineConfiguration -Name "VdaAotTracing\VdaAotTracing" -Policy $policy
$mc=Get-BrokerMachineConfiguration -Name "VdaAotTracing\VdaAotTracing"

# Utilizzando il nome reale del Deliverygroup del suo VDA.
$dg = Get-BrokerDesktopGroup -Name "DeliverygroupName" 
Add-BrokerMachineConfiguration -InputObject $mc -DesktopGroup $dg

#Riavviare il servizio Citrix Desktop nel suo VDA per applicare le modifiche immediatamente.

<!--NeedCopy--> ```
  1. Abilitare AOT direttamente su Windows VDA:

Esegua il comando direttamente sulla macchina (WindowsVDA) dove desidera caricare AOT. Questo avrà effetto solo sulla macchina in cui viene applicato il comando.

```bash
# Abilitare il caricamento AOT per Windows VDA
#Se si utilizza HTTPS, il parametro -AotDataStoreEndpoint dovrebbe essere "https://LogServerFQDN:8443"

Enable-CitrixAOTUpload -AotDataStoreEndpoint LogServerFQDN:8443 -Role WVDA

# Disabilitare il caricamento AOT
Disable-CitrixAOTUpload
<!--NeedCopy--> ```

Visualizzazione e utilizzo dei log AOT

Accesso ai log tramite il server di log

Per mantenere i suoi log sicuri, avrà bisogno di una AuthKey prima di scaricarli. Ecco cosa fare:

  1. Ottenga la sua AuthKey – Utilizzi il suo nome/ruolo per generarla.
  2. Esegua localmente – Gli script possono essere eseguiti solo sulla macchina in cui è installato il container Docker.
  3. Utenti Windows – Utilizzi gli script GetAuthKey.bat invece degli script shell.

  4. Scarichi i log – Una volta autenticato, potrà recuperare i suoi log in sicurezza.

    For Linux
./GetAuthKey.sh role-name
{"key":"ebac9b7726cb4be597c92c6769134d25","role":"role-name","status":"DONE"}

For Windows
GetAuthKey.bat role-name
{"key":"ebac9b7726cb4be597c92c6769134d25","role":"role-name","status":"DONE"}

#Salvi la chiave: ebac9b7726cb4be597c92c6769134d25 da solo. È l'unico modo per ottenere la chiave.
<!--NeedCopy-->

Elenco dei nomi delle macchine che hanno già inviato i loro log AOT al logserver:

```bash
#Il parametro è la chiave ottenuta da GetAuthKey.sh
For linux:
./ListMachines.sh ebac9b7726cb4be597c92c6769134d25
{"machines":["MachineName"]}
#Macchine vuote significa che non ci sono log

For Windows:
ListMachines.bat ebac9b7726cb4be597c92c6769134d25
{"machines":["MachineName"]}
#Macchine vuote significa che non ci sono log
<!--NeedCopy--> ```

Scarichi i log per nome macchina e intervallo di tempo. L’ora è in formato UTC.

```bash
#Utilizzo: ./DownloadLogsByTime.sh [AuthKey] [MachineName] [StartTime] [EndTime] [OutputFile]
#Esempio: 

For Linux
./DownloadLogsByTime.sh ebac9b7726cb4be597c92c6769134d25 MachineName 2025-01-01T00:00:00Z 2025-01-02T00:00:00Z logs.csv

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

Scarichi i log tramite filtro per parola chiave/e. L’ora è in formato UTC:

Nota:

  • Una parola chiave può essere una singola parola o una combinazione di parole.
  • Le parole chiave possono corrispondere a qualsiasi punto all’interno del messaggio di log.
  • Un ID transazione può essere utilizzato anche come parola chiave.
```bash
#Utilizzo: ./DownloadLogsByWords.sh [AuthKey] [StartTime] [EndTime] [SearchWords] [OutputFile]

#Esempio:
For Linux:
./DownloadLogsByWords.sh authkey 2025-01-01T00:00:00.000Z 2025-12-31T23:59:59.999Z "session launch" logs.csv

For Windows:
DownloadLogsByWords.bat authkey 2025-01-01T00:00:00.000Z 2025-12-31T23:59:59.999Z "failed vda" logs.csv
<!--NeedCopy--> ```
Caricamento dei log AOT dai componenti core 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.