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

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

  1. Caricamento dei log AOT da Storefront™

    #Abilita il 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 entro un'ora. Per applicare le modifiche immediatamente, riavviare il servizio Citrix Telemetry.
<!--NeedCopy-->

  2. Caricamento dei log AOT da DDC:

    #Abilita il 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 è stato installato DDC, eseguire i comandi seguenti e, successivamente, riavviare il servizio Citrix Desktop per applicare le modifiche immediatamente.

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


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


# Usando il vero DeliverygroupName del proprio VDA.
$dg = Get-BrokerDesktopGroup -Name "DeliverygroupName"  
Add-BrokerMachineConfiguration -InputObject $mc -DesktopGroup $dg


#Riavviare il servizio Citrix Desktop nel proprio 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 del DDC
#Se si usa HTTPS, il parametro di -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"

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

Come disabilitare:

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


#Se si usa HTTPS, il parametro di -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"

# Usando il vero DeliverygroupName del proprio VDA.
$dg = Get-BrokerDesktopGroup -Name "DeliverygroupName" 
Add-BrokerMachineConfiguration -InputObject $mc -DesktopGroup $dg

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

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

Eseguire il comando direttamente sulla macchina (Windows VDA) in cui si desidera caricare AOT. Questo avrà effetto solo sulla macchina in cui viene applicato il comando.

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

Enable-CitrixAOTUpload -AotDataStoreEndpoint LogServerFQDN:8443 -Role WVDA

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

Visualizzazione e utilizzo dei log AOT

Accesso ai log tramite il server di log

Per mantenere i log sicuri, sarà necessaria una AuthKey prima di scaricarli. Ecco cosa fare:

  1. Ottenere la propria AuthKey – Usare il proprio nome/ruolo per generarla.
  2. Eseguire localmente – Gli script possono essere eseguiti solo sulla macchina in cui è installato il container Docker.
  3. Utenti Windows – Usare gli script GetAuthKey.bat invece degli script shell.

  4. Scaricare i log – Una volta autenticati, è possibile recuperare i log in sicurezza.

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

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

#Salvare la chiave: ebac9b7726cb4be597c92c6769134d25. È l'unico modo per ottenerla.
<!--NeedCopy-->

Elencare i nomi delle macchine che hanno già inviato i loro log AOT al server di log:

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

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

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

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

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

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

Scaricare 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 usato anche come parola chiave.
```bash
#Utilizzo: ./DownloadLogsByWords.sh [AuthKey] [StartTime] [EndTime] [SearchWords] [OutputFile]

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

Per 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 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.