Documentazione dei prodotti
Citrix Virtual Apps and Desktops™ 7 2507 LTSR
Visualizza PDF

Visualizzazione e utilizzo dei log AOT

June 5, 2026
Grazie al contributo di: 
C C

Accesso ai log tramite l’interfaccia utente di Director

Fase 1

Modificare il file StartLogServer.bat

Il file StartLogServer.bat contiene tutti i parametri di configurazione utilizzati per avviare il container del server di log AOT, incluse diverse variabili di ambiente che controllano l’accesso e il comportamento dei log. Una delle impostazioni chiave è LOCAL_DOWN_ONLY.

  • Quando LOCAL_DOWN_ONLY=false, il server di log accetta richieste di visualizzazione dei log remote. Ciò consente a Citrix Director/Monitor di connettersi al server di log e visualizzare i log AOT direttamente nell’interfaccia utente di Monitor.

  • Quando LOCAL_DOWN_ONLY=true, il server di log limita l’accesso ai log alle sole connessioni locali. In questa modalità, è necessario connettersi direttamente alla macchina del server di log per visualizzare i log e Citrix Director Monitor non sarà in grado di recuperare o visualizzare i log.

File bat AOT

Fase 2

Web Studio fornisce un’impostazione dedicata che consente a Citrix Director di connettersi al server di log AOT e visualizzare i log nella console di Monitor. Una volta salvate le impostazioni di Web Studio, i Delivery Controller aggiornano la configurazione del sito e Director riceve i dettagli del server di log, inclusi l’indirizzo, la porta e la chiave di autenticazione del server di log. Director utilizza queste impostazioni per stabilire una connessione sicura al server di log.

Fase 3

Dopo la configurazione:

  1. Aprire Citrix Director.
  2. Una nuova opzione Logs (Log) appare nel pannello di navigazione a sinistra.
  3. Selezionare Logs (Log) e verrà visualizzata la pagina Get Started (Per iniziare), fare clic su Close (Chiudi) per saltarla, poiché abbiamo completato queste impostazioni in precedenza.
  4. Ora, vedrai il Director recuperare e visualizzare i log AOT direttamente dal Log Server.

Citrix Director

La pagina Log in Director fornisce una vista unificata degli eventi AOT da Delivery Controller, VDA, server StoreFront e altri componenti Citrix. È possibile cercare, filtrare e ispezionare i log in tempo reale per risolvere rapidamente i problemi.

Ricerca a testo libero: Nella parte superiore della pagina Log, troverai una barra di ricerca a testo libero. Puoi digitare qualsiasi parola chiave per iniziare a restringere i risultati. La ricerca aggiorna i risultati istantaneamente una volta applicati i filtri. Gli esempi includono:

  • Nomi utente
  • Nomi delle macchine
  • Parole chiave evento (ad esempio, registrazione, autenticazione, STA)
  • ID transazione
  • Messaggi di errore o stringhe parziali

Filtro temporale: Utilizza il selettore temporale (ad esempio, Ultimi 5 minuti, Ultima 1 ora, Ultime 24 ore) per visualizzare i log generati entro una durata specifica. Questo ti aiuta a isolare rapidamente gli eventi intorno al momento esatto in cui si è verificato un problema.

Filtro categoria: Il campo Categoria consente di filtrare i log in base al tipo di evento o sottosistema. Questo ti aiuta a concentrarti sui log relativi all’avvio dell’applicazione, alla registrazione, alla configurazione VDA, alla grafica, a HDX Direct, alla connessione ICA, ecc.

Filtro classe log: Il filtro Classe log raggruppa i log per gravità o tipo di evento. Questo ti consente di concentrarti solo sugli errori o sugli eventi importanti durante la risoluzione dei problemi. Le classi comuni includono:

  • Informazioni
  • Avviso
  • Errore
  • Errore

Filtro nome host: Il filtro nome host consente di selezionare una macchina specifica, come un VDA, un Delivery Controller, un CWA o un server StoreFront. Questo è utile quando si desidera analizzare i log per un singolo endpoint o VM invece di cercare nell’intera distribuzione.

Questo accesso centralizzato semplifica la risoluzione dei problemi consentendo un rapido recupero e analisi dei log da un’unica console. Ulteriori informazioni sui prerequisiti e su come iniziare sono disponibili in Director - Logs.

Accesso ai log tramite Log Server

Il contenuto seguente riguarda la generazione della AuthKey. Per abilitare l’accesso ai log, l’utente deve

  1. Modificare lo script StartLogServer.bat LOCAL_DOWN_ONLY=false

  2. Generare la AuthKey

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

  1. Ottieni la tua AuthKey – Usa il tuo nome/ruolo per generarla.
  2. Esegui localmente – Gli script possono essere eseguiti solo sulla macchina in cui è installato il container Docker.
  3. Utenti Windows – Utilizzare gli script GetAuthKey.bat invece degli script shell.
  4. Scarica i log – Una volta autenticato, puoi recuperare i tuoi log in sicurezza.

Generazione e gestione delle chiavi di autenticazione per AOT Log Server

È possibile utilizzare gli script .sh (Linux) o .bat (Windows) forniti per generare rapidamente una nuova chiave di autenticazione per un ruolo o un utente specifico. Questi script semplificano il processo restituendo la chiave generata insieme al ruolo associato.

Per Linux 

./GetAuthKey.sh role-name
<!--NeedCopy-->

Per Windows 

GetAuthKey.bat role-name
<!--NeedCopy-->

Il server di log AOT fornisce comandi per gestire le chiavi di autenticazione associate a ruoli o utenti diversi. Questi comandi consentono agli amministratori di aggiungere, elencare, convalidare ed eliminare le chiavi di autenticazione direttamente dal container. Utilizzare i comandi docker exec disponibili direttamente sul container del server di log.

  • Aggiungere una nuova chiave di autenticazione: Crea una nuova chiave di autenticazione per un ruolo o un utente specificato:

docker exec logserver /app/authkey add <RoleName>

  • Elencare tutte le chiavi di autenticazione: Visualizza tutti i ruoli/utenti esistenti per i quali sono state create chiavi di autenticazione:

docker exec logserver /app/authkey list

  • Convalidare una chiave di autenticazione: Verifica se una data chiave di autenticazione è valida e identifica il ruolo associato:

docker exec logserver /app/authkey validate <key>

  • Eliminare una chiave di autenticazione: Rimuove una chiave di autenticazione associata a un ruolo specifico:

docker exec logserver /app/authkey del <RoleName>

  • Visualizzare l’utilizzo del comando: Visualizza le opzioni disponibili per la gestione delle chiavi di autenticazione:

docker exec logserver /app/authkey ??

L’esempio seguente mostra come gestire le chiavi di autenticazione:

Chiave di autenticazione AOT

Elencare i nomi delle macchine che hanno già inviato i loro log AOT al logserver

Il parametro è la chiave ottenuta da GetAuthKey.sh

Per Linux 

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

Macchine vuote significa che non è presente alcun log

Per Windows 

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

Per PowerShell di Windows quando LogServer si avvia con “-e LOCAL_DOWN_ONLY=false”:

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

Sostituire logserver_fqdn con il FQDN reale del logserver e 8443 con la porta reale del logserver. Sostituire https con http quando installato in modalità http.

Macchine vuote significa che non è presente alcun log

Scarica i log per nome macchina e intervallo di tempo.

L’ora è nel formato UTC: YYYY-mm-ddTHH:MM:SSZ.

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

Per Linux 

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

Per Windows 

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

Per PowerShell di Windows quando LogServer si avvia con “-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-->

Scarica i log tramite filtro per parola chiave/e. L’ora è nel formato UTC

Nota:

  • Una parola chiave può essere una singola parola o una combinazione di parole.
  • Le parole chiave possono corrispondere ovunque all’interno del messaggio di log.
  • Un ID transazione può anche essere utilizzato come parola chiave.
#Usage: ./DownloadLogsByWords.sh [AuthKey] [StartTime|YYYY-mm-ddTHH:MM:SSZ] [EndTime|YYYY-mm-ddTHH:MM:SSZ] [SearchWords] [OutputFile]
#Example:
<!--NeedCopy-->

Per Linux 

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

Per Windows 

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

Per Windows PowerShell quando LogServer si avvia con “-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-->

Le parole sono separate da spazio

Visualizzazione e utilizzo dei log AOT
June 5, 2026
Grazie al contributo di: 
C C
June 5, 2026
Grazie al contributo di: 
C 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.