Registrazione della configurazione
Nota:
I record del log di configurazione vengono visualizzati solo in inglese, indipendentemente dalla lingua selezionata per l’account Citrix Cloud. Le date e gli orari associati a tali record sono nel formato MM/GG/AA, espressi in Tempo Coordinato Universale (UTC).
La registrazione della configurazione è una funzionalità che acquisisce le modifiche alla configurazione della distribuzione e le attività amministrative di Citrix Virtual Apps and Desktops™ e Citrix DaaS (precedentemente servizio Citrix Virtual Apps and Desktops) in un database di registrazione in Citrix Cloud. È possibile utilizzare il contenuto registrato per:
- Diagnosticare e risolvere i problemi dopo aver apportato modifiche alla configurazione. Il log fornisce una traccia di navigazione.
- Assistere la gestione delle modifiche e tenere traccia delle configurazioni.
- Segnalare le attività amministrative.
In questo Citrix DaaS™, la registrazione della configurazione è sempre abilitata. Non è possibile disabilitarla.
Da Studio, è possibile visualizzare il contenuto del log di configurazione, filtrato per intervalli di date o per ricerca full-text. È inoltre possibile generare un report CSV utilizzando PowerShell. Da questa console, non è possibile modificare o eliminare il contenuto del log. È possibile utilizzare l’SDK Remote PowerShell per pianificare l’eliminazione periodica dei dati dal log.
Aggiornare la conservazione dei log di configurazione DaaS
Per mantenere le prestazioni dei tenant DaaS, a partire dal 9 settembre 2024 la conservazione dei log di configurazione sarà impostata a 180 giorni.
I log più vecchi di 180 giorni al 9 settembre 2024 verranno eliminati. Poiché continuiamo ad aumentare i nostri Limiti DaaS per un singolo tenant DaaS, questa implementazione garantisce le migliori prestazioni e resilienza per i nostri clienti.
Come best practice, consigliamo ai clienti di disporre di un meccanismo di esportazione trimestrale. Questo può essere fatto tramite PowerShell, vedere Generare report. Consigliamo inoltre ai clienti di pianificare l’eliminazione periodica dei dati, vedere Pianificare l’eliminazione periodica dei dati.
Autorizzazioni richieste (vedere Amministrazione delegata):
- Gli Amministratori completi in Citrix Cloud™, più gli Amministratori cloud Citrix DaaS e gli Amministratori di sola lettura possono visualizzare i log di configurazione in Studio.
- Gli amministratori completi e gli amministratori cloud possono anche scaricare un report CSV dell’attività di registrazione, utilizzando PowerShell.
Cosa viene registrato
Vengono registrate le seguenti operazioni:
- Modifiche alla configurazione e attività amministrative avviate dalla sezione Gestisci e dal nodo Monitora
- Script PowerShell
- Richieste API REST
Nota:
Non è possibile visualizzare le voci di registro per le operazioni interne della piattaforma Citrix Cloud, come la configurazione e la gestione del database.
Esempi di modifiche alla configurazione registrate includono l’interazione con (creazione, modifica, eliminazione, assegnazione di):
- Cataloghi di macchine
- Gruppi di consegna (inclusa la modifica delle impostazioni di gestione dell’alimentazione)
- Ruoli e ambiti dell’amministratore
- Risorse e connessioni host
- Criteri Citrix® tramite Studio
Esempi di modifiche amministrative registrate includono:
- Gestione dell’alimentazione di una macchina virtuale o di un desktop utente
- Gestire o monitorare le funzioni che inviano un messaggio a un utente
Le seguenti operazioni non vengono registrate. (Molte di esse non sono disponibili per gli amministratori dei clienti.)
- Operazioni automatiche come l’accensione di macchine virtuali per la gestione del pool.
- Azioni di policy implementate tramite la Group Policy Management Console (GPMC). Utilizzare gli strumenti Microsoft per visualizzare i log di tali azioni.
- Modifiche apportate tramite il registro o da fonti diverse da Studio, Monitor o PowerShell.
Visualizzare il contenuto del log di configurazione
Per visualizzare il contenuto del log di configurazione, seguire questi passaggi:
- Accedere a Citrix Cloud.
- Nel riquadro DaaS, fare clic su Gestisci.
- Selezionare Registrazione nel riquadro sinistro e fare clic sulla scheda Eventi.
Per impostazione predefinita, i log degli eventi sono elencati per nome amministratore. È possibile eseguire le seguenti attività, se necessario:
- Ordina la visualizzazione. Ordina la visualizzazione facendo clic su un’intestazione di colonna.
-
Filtra i log. Affina la visualizzazione impostando filtri, ad esempio:
- Intervalli di giorni o periodi personalizzati.
- Nomi di attività principali completi o parziali.
-
Dettagli delle operazioni di basso livello, come il nome della macchina e il nome VDI. Per cercare tra i dettagli di basso livello, selezionare Estendi ambito di ricerca per includere i dettagli prima di inserire il termine di ricerca.
Nota:
- L’abilitazione di questa opzione può aumentare il tempo di ricerca perché il sistema cerca in un insieme più ampio di voci di registro.
- La selezione viene salvata solo per la sessione corrente di Web Studio. Quando si disconnette o si avvia una nuova sessione, selezionare nuovamente l’opzione se si desidera includere i dettagli delle operazioni di basso livello nella ricerca.
- Esporta registri. Esporta i registri selezionati o tutti i registri in un file CSV per l’archiviazione o ulteriori analisi.
- Personalizza colonne. Adatta la visualizzazione alle tue esigenze aggiungendo colonne non predefinite come IP client ed Etichette.
- Gestisci etichette. Aggiungi, modifica e rimuovi etichette per i registri eventi per migliorare l’organizzazione e il tracciamento dei registri.
Caratteristiche di visualizzazione:
- Le operazioni di alto livello create durante la gestione e il monitoraggio sono elencate nel riquadro centrale superiore. Un’operazione di alto livello comporta uno o più servizi e chiamate SDK PowerShell, che sono operazioni di basso livello. Quando si seleziona un’operazione di alto livello nel riquadro centrale superiore, il riquadro inferiore visualizza le operazioni di basso livello.
- Se si crea un’operazione di basso livello in PowerShell senza specificare un’operazione di alto livello padre, la registrazione della configurazione crea un’operazione di alto livello surrogata.
- Se un’operazione fallisce prima del completamento, l’operazione di registro potrebbe non essere completata nel database. Ad esempio, un record di avvio non ha un record di arresto corrispondente. In questi casi, il registro indica che mancano informazioni. Quando si visualizzano i registri in base agli intervalli di tempo, i registri incompleti vengono mostrati se i dati nei registri corrispondono ai criteri. Ad esempio, se si richiedono i registri degli ultimi cinque giorni e un registro con un’ora di inizio negli ultimi cinque giorni non ha un’ora di fine, viene incluso.
- Ricorda: non è possibile visualizzare le voci di registro per le operazioni interne della piattaforma Citrix Cloud, come la configurazione e la gestione del database.
Visualizzare le attività relative alle operazioni del catalogo macchine
Per visualizzare le attività relative alle operazioni del catalogo macchine, accedere a Registrazione > Attività. La scheda Attività visualizza solo le attività relative ai cataloghi creati tramite Machine Creation Services™ (MCS) o Provisioning Services (PVS). Nello specifico, vengono visualizzate le attività associate alle seguenti operazioni del catalogo macchine:
- Crea cataloghi
- Clona cataloghi
- Aggiungi macchine
- Rimuovi macchine
- Aggiorna un catalogo (aggiorna immagini o macchine)
- Ripristina aggiornamenti macchina
Suggerimento:
La scheda Attività visualizza solo le attività relative alle modifiche dello schema di provisioning (creazione o modifica di uno schema di provisioning).
Un’attività può trovarsi nel seguente stato:
- Completata
- Non avviata
- In esecuzione
- Annullata
- Non riuscita
- Sconosciuta
Per annullare un’attività in esecuzione, selezionare l’attività e quindi fare clic su Annulla. L’annullamento richiede del tempo per essere completato.
Esempi di attività registrate includono:
- Aggiornamento dell’immagine completato per un determinato catalogo
- Errore durante l’aggiornamento dell’immagine per un determinato catalogo
- Aggiornamento dell’immagine annullato per un determinato catalogo
- Provisioning di VM per un determinato catalogo
- Rimozione di VM da un determinato catalogo
- Creazione di un determinato catalogo
Per impostazione predefinita, la visualizzazione nel riquadro centrale elenca le attività registrate in ordine cronologico (le voci più recenti per prime), separate per data. È possibile ordinare la visualizzazione in base all’intestazione della colonna. Per cancellare le attività completate, fare clic su Cancella attività completate nella scheda Attività. Per scegliere quali colonne visualizzare, selezionare l’icona Colonne da visualizzare nell’angolo in alto a destra della tabella.
Visualizzare i log API
Per visualizzare i log delle API REST, accedere a Registrazione > API. La scheda API visualizza le richieste API REST effettuate durante un determinato periodo di tempo.
Tenere presente le seguenti considerazioni:
- I log delle API REST vengono cancellati dopo la disconnessione dalla console. (Vengono cancellati anche se si aggiorna la finestra del browser.)
- Qualsiasi operazione nella console che generi chiamate API ha le richieste API corrispondenti visualizzate nella scheda API.
- La visualizzazione elenca le richieste API in ordine cronologico (le voci più recenti per prime), separate per data. Il numero massimo di richieste API nella visualizzazione è 1.000.
Visualizzare i log di PowerShell
Per visualizzare i comandi PowerShell corrispondenti alle azioni dell’interfaccia utente eseguite durante il giorno, passare alla scheda Logging > PowerShell.
Associare metadati ai log di configurazione
È possibile allegare metadati ai log di configurazione associando una coppia name-value denominata MetadataMap ai record di log.
Nota:
- È possibile allegare metadati solo agli oggetti operazione di alto livello.
- I metadati vengono associati ai record esistenti al momento dell’esecuzione.
Impostare i metadati
Eseguire il comando PowerShell Set-LogHighLevelOperationMetadata per associare un record di log a MetadataMap.
Set-LogHighLevelOperationMetadata accetta i seguenti parametri:
- Id: ID dell’operazione di alto livello.
-
InputObject: Le operazioni di alto livello a cui si aggiungono i metadati. Questa è un’alternativa al parametro
Idin cui un oggetto operazione di alto livello o un elenco di oggetti viene passato al comando PowerShell. -
Name: Nome della proprietà dei metadati da aggiungere. La proprietà deve essere univoca per l’operazione di alto livello specificata. La proprietà non può contenere nessuno dei seguenti caratteri:
()\/;:#.*?=<>|[]"' - Value: Valore per la proprietà.
-
Map: Dizionario di coppie (nome, valore) per le proprietà. Questa è un’alternativa all’impostazione dei metadati utilizzando i parametri
-Namee-Value.
Ad esempio, per allegare i metadati a tutti i record di log di alto livello con ID 40, eseguire il seguente comando PowerShell:
Get-LogHighLevelOperation – Id 40 | Set-LogHighLevelOperationMetadata -Name A -Value B
Per allegare i metadati al record di alto livello con l’utente abc@example.com, eseguire il seguente comando PowerShell:
Get-LogHighLevelOperation – User `abc@example.com` | Set-LogHighLevelOperationMetadata -Name C -Value D
Recuperare utilizzando i metadati
Eseguire i seguenti comandi PowerShell per utilizzare i metadati associati per recuperare i record di log:
-
Cerca per chiave e valore:
Get-LogHighLevelOperation -Metadata "Key:Value" -
Cerca per valore e qualsiasi chiave:
Get-LogHighLevelOperation -Metadata "*:Value" -
Cerca per chiave e qualsiasi valore:
Get-LogHighLevelOperation -Metadata "Key:*"
Rimuovere i metadati
Eseguire il comando PowerShell Remove-LogHighLevelOperationMetadata per rimuovere i metadati associati.
Remove-LogHighLevelOperationMetadata accetta i seguenti parametri:
- Id:ID dell’operazione di alto livello.
-
InputObject:Le operazioni di alto livello a cui si aggiungono i metadati. Questa è un’alternativa al parametro
Id` dove un oggetto operazione di alto livello o un elenco di oggetti viene passato al comando PowerShell. - Nome: Nome della proprietà dei metadati da rimuovere. Impostare su $null per rimuovere tutti i metadati per l’oggetto specificato.
- Mappa: Dizionario di coppie (nome, valore) per le proprietà. Può essere una tabella hash (creata con @{“name1” = “val1”; “name2” = “val2”}) o un dizionario di stringhe (creato con new-object “System.Collections.Generic.Dictionary[String, String]”). Le proprietà i cui nomi corrispondono alle chiavi nella mappa vengono rimosse.
Generare report
Per generare un report CSV o HTML contenente i dati di registrazione della configurazione, utilizzare i cmdlet PowerShell per il servizio ConfigLogging nell’SDK PowerShell remoto di Citrix Virtual Apps and Desktops. Per i dettagli, vedere:
Pianificare l’eliminazione periodica dei dati
Utilizzare l’SDK PowerShell remoto per specificare per quanto tempo i dati vengono conservati nel database di registrazione della configurazione. (Questa funzionalità non è disponibile in Studio.) In Citrix DaaS, è necessario disporre dell’accesso completo.
Nel cmdlet Set-LogSite, il parametro -LoggingDBPurgeDurationDays specifica per quanti giorni i dati vengono conservati nel database di registrazione della configurazione prima di essere eliminati automaticamente.
- Per impostazione predefinita, il valore di questo parametro è 0. Un valore zero significa che i dati nel database di registrazione della configurazione non vengono mai eliminati automaticamente.
- Quando si imposta un valore diverso da zero, il database viene controllato una volta ogni 120 minuti. I dati più vecchi del periodo di conservazione vengono eliminati.
Utilizzare Get-LogSite per visualizzare il valore corrente del parametro.
Differenze rispetto a Citrix Virtual Apps and Desktops on-premise
Se si ha familiarità con la registrazione della configurazione nel prodotto Virtual Apps and Desktops on-premise, la versione di Citrix Cloud presenta diverse differenze. In Citrix Cloud:
- La registrazione della configurazione è sempre abilitata. Non è possibile disabilitarla. La registrazione obbligatoria non è disponibile.
- Non è possibile modificare la posizione del database di registrazione della configurazione, perché il database è gestito nella piattaforma Citrix Cloud.
- Le visualizzazioni del log di configurazione non includono operazioni e attività eseguite all’interno della piattaforma Citrix Cloud.
- PowerShell è l’unica scelta per creare un report CSV o HTML delle operazioni registrate. Nel prodotto on-premises, i report possono essere generati da Citrix Studio o PowerShell.
- Non è possibile eliminare il contenuto del log di configurazione.
In questo articolo
- Aggiornare la conservazione dei log di configurazione DaaS
- Cosa viene registrato
- Visualizzare il contenuto del log di configurazione
- Visualizzare le attività relative alle operazioni del catalogo macchine
- Visualizzare i log API
- Visualizzare i log di PowerShell
- Associare metadati ai log di configurazione
- Generare report
- Pianificare l’eliminazione periodica dei dati
- Differenze rispetto a Citrix Virtual Apps and Desktops on-premise