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 Coordinated Universal Time (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 logging 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 delle operazioni.
- 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 tramite 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 su 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. Raccomandiamo 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™, oltre agli amministratori cloud di Citrix DaaS e agli 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 logging, 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 log per le operazioni interne della piattaforma Citrix Cloud, come la configurazione e la gestione del database.
Esempi di modifiche alla configurazione registrate includono l’utilizzo (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 host e connessioni
- Criteri Citrix® tramite Studio
Esempi di modifiche amministrative registrate includono:
- Gestione dell’alimentazione di una macchina virtuale o di un desktop utente
- Funzioni di gestione o monitoraggio 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 dei criteri 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à secondo necessità:
- Ordinare la visualizzazione. Ordinare la visualizzazione facendo clic su un’intestazione di colonna.
- Filtrare i log. Affinare la visualizzazione impostando condizioni di filtro come intervalli di giorni o periodi personalizzati o inserendo nomi di attività principali completi o parziali nella casella di ricerca. Per tornare alla visualizzazione standard dopo aver utilizzato la ricerca, cancellare il testo nella casella di ricerca.
- Esportare i log. Esportare i log selezionati o tutti i log in un file CSV per l’archiviazione o ulteriori analisi.
- Personalizzare le colonne. Adattare la visualizzazione alle proprie esigenze aggiungendo colonne non predefinite come Indirizzo IP client ed Etichette.
- Gestire le etichette. Aggiungere, modificare e rimuovere etichette per i log degli eventi per migliorare l’organizzazione e il tracciamento dei log.
Caratteristiche della visualizzazione:
- Le operazioni di alto livello create durante la gestione e il monitoraggio sono elencate nel riquadro centrale superiore. Un’operazione di alto livello si traduce in 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 log potrebbe non essere completata nel database. Ad esempio, un record di inizio non ha un record di fine corrispondente. In questi casi, il log indica che mancano informazioni. Quando si visualizzano i log in base agli intervalli di tempo, vengono mostrati i log incompleti se i dati nei log corrispondono ai criteri. Ad esempio, se si richiedono i log degli ultimi cinque giorni e un log con un’ora di inizio negli ultimi cinque giorni non ha un’ora di fine, viene incluso.
- Ricorda: non è possibile visualizzare le voci di log 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). In particolare, vengono visualizzate le attività associate alle seguenti operazioni del catalogo macchine:
- Creare cataloghi
- Clonare cataloghi
- Aggiungere macchine
- Rimuovere macchine
- Aggiornare un catalogo (aggiornare immagini o macchine)
- Eseguire il rollback degli aggiornamenti delle macchine
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 immagine completato per un determinato catalogo
- Errore durante l’aggiornamento dell’immagine per un determinato catalogo
- Aggiornamento immagine annullato per un determinato catalogo
- Provisioning di VM a 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 cronologicamente (le voci più recenti per prime), separate per data. È possibile ordinare la visualizzazione per intestazione di colonna. Per cancellare le attività completate, fare clic su Cancella attività completate sotto la 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 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 API REST vengono cancellati dopo la disconnessione dalla console. (Vengono cancellati anche se si aggiorna la finestra del browser.)
- Qualsiasi operazione nella console che si traduce in chiamate API avrà le richieste API corrispondenti visualizzate nella scheda API.
- La visualizzazione elenca le richieste API cronologicamente (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, accedere alla scheda Registrazione > PowerShell.
Associare metadati ai log di configurazione
È possibile allegare metadati ai log di configurazione associando una coppia nome-valore
denominata MetadataMap
ai record di log.
Nota:
- È possibile allegare metadati solo a oggetti operazione di alto livello.
- I metadati sono 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
Id
in 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
-Name
e-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:
-
Ricerca per chiave e valore:
Get-LogHighLevelOperation -Metadata "Key:Value"
-
Ricerca per valore e qualsiasi chiave:
Get-LogHighLevelOperation -Metadata "*:Value"
-
Ricerca 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
in cui un oggetto operazione di alto livello o un elenco di oggetti viene passato al comando PowerShell. - Name: nome della proprietà dei metadati da rimuovere. Impostare su $null per rimuovere tutti i metadati per l’oggetto specificato.
- Map: dizionario di coppie (nome, valore) per le proprietà. Può essere una hashtable (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 del log di configurazione, utilizzare i cmdlet PowerShell per il servizio ConfigLogging nell’SDK Remote PowerShell di Citrix Virtual Apps™ and Desktops. Per i dettagli, vedere:
Pianificare l’eliminazione periodica dei dati
Utilizzare l’SDK Remote PowerShell 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-premises
Se si ha familiarità con la registrazione della configurazione nel prodotto Virtual Apps and Desktops on-premises, 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-premises