Registrazione della configurazione
Nota:
I record del registro di configurazione vengono visualizzati solo in inglese, indipendentemente dalla lingua selezionata per il proprio account Citrix Cloud. Le date e le ore associate a tali record sono in formato MM/GG/AA, espresso in Coordinated Universal Time (UTC).
La registrazione della configurazione è una funzionalità che acquisisce le modifiche alla configurazione di distribuzione e le attività amministrative di Citrix Virtual Apps and Desktops e Citrix DaaS (precedentemente chiamato 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 degli spostamenti.
- Facilitare 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.
Dall’interfaccia di gestione della configurazione completa, è possibile visualizzare il contenuto del registro 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 registro. È possibile utilizzare l’SDK Remote PowerShell per pianificare l’eliminazione periodica dei dati dal registro.
Autorizzazioni richieste (vedere Amministrazione delegata):
- Gli amministratori completi di Citrix Cloud, nonché gli amministratori Cloud di Citrix DaaS e gli amministratori di sola lettura possono visualizzare i log di configurazione nella console Manage (Gestione).
- Gli amministratori completi e gli amministratori cloud possono anche scaricare un rapporto CSV dell’attività di registrazione, utilizzando PowerShell.
Cosa viene registrato
Le seguenti operazioni vengono registrate:
- Modifiche alla configurazione e attività amministrative avviate dalle schede Manage e Monitor
- 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’utilizzo (creazione, modifica, eliminazione, assegnazione) di quanto segue:
- 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 la console Manage
Esempi di modifiche amministrative registrate includono:
- Gestire l’alimentazione di una macchina virtuale o di un desktop utente
- Gestire o monitorare le funzioni inviando un messaggio a un utente
Le seguenti operazioni non vengono registrate: (molte di queste non sono disponibili per gli amministratori dei clienti)
- Operazioni automatizzate come l’attivazione della gestione in pool delle macchine virtuali.
- Azioni derivanti da criteri implementate tramite la console di gestione dei criteri di gruppo (GPMC). Utilizzare gli strumenti Microsoft per visualizzare i registri di tali azioni.
- Modifiche apportate tramite il Registro di sistema o da fonti diverse dall’interfaccia di gestione della configurazione completa, Monitor o PowerShell.
Visualizzare il contenuto del registro di configurazione
Per visualizzare il contenuto del registro di configurazione, attenersi alla seguente procedura:
- Accedere a Citrix Cloud. Nel menu in alto a sinistra, selezionare My Services > DaaS (I miei servizi > DaaS).
- Da Manage > Full Configuration (Gestisci > Configurazione completa), selezionare Logging > Events (Registrazione > Eventi) nel riquadro a sinistra.
Per impostazione predefinita, nel riquadro centrale sono elencati cronologicamente i contenuti del registro (prima le voci più recenti), separati per data. È possibile effettuare le seguenti operazioni:
- Ordinare la visualizzazione per intestazione di colonna.
- Filtra la visualizzazione specificando un intervallo di giorni o un periodo di tempo personalizzato oppure inserendo del testo nella casella di ricerca. Per tornare alla visualizzazione standard dopo aver utilizzato la ricerca, eliminare il testo nella casella Search.
Caratteristiche del display:
- Le operazioni di alto livello create durante la gestione e il monitoraggio sono elencate nel riquadro centrale superiore. Un’operazione di alto livello comporta una o più chiamate ai servizi e all’SDK PowerShell, che sono operazioni di basso livello. Quando si seleziona un’operazione di alto livello nel riquadro centrale, il riquadro inferiore visualizza le operazioni di basso livello.
- Se si crea un’operazione di basso livello in PowerShell senza specificare un’operazione padre di alto livello, la registrazione della configurazione crea un’operazione surrogata di alto livello.
- Se un’operazione non riesce prima del completamento, l’operazione di log potrebbe non essere completata nel database. Ad esempio, un record di avvio non ha alcun record di arresto corrispondente. In questi casi, il log indica che mancano informazioni. Quando si visualizzano i log in base a intervalli di tempo, vengono visualizzati i registri incompleti se i dati nei log corrispondono ai criteri. Ad esempio, se si richiedono i registri degli ultimi cinque giorni e un log con un’ora di inizio negli ultimi cinque giorni non ha un’ora di fine, questo 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 operazioni relative alle operazioni del catalogo macchine, accedere a Manage > Full Configuration > Logging > Tasks (Gestione > Configurazione completa > Registrazione > Attività). La scheda Task 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:
- Create catalogs (Crea cataloghi)
- Clone catalogs (Clona cataloghi)
- Add machines (Aggiungi macchine)
- Remove machines (Rimuovi macchine)
- Update a catalog (update images or machines) [Aggiorna un catalogo (aggiorna immagini o macchine)]
- Roll back machine updates (Esegui rollback degli aggiornamenti macchine)
Suggerimento:
La scheda Tasks 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:
- Completed (Completata)
- Not started (Non avviata)
- Running (In esecuzione)
- Canceled (Annullata)
- Failed (Non riuscita)
- Unknown (Sconosciuto)
Per annullare un’operazione in esecuzione, selezionare l’attività e quindi fare clic su Cancel. La cancellazione richiede un po’ di tempo per essere completata.
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 macchine virtuali in un determinato catalogo
- Rimozione di macchine virtuali da un determinato catalogo
- Creazione di un determinato catalogo
Per impostazione predefinita, nel riquadro centrale sono elencate cronologicamente le attività inserite nel registro (prima le voci più recenti), separate per data. È possibile ordinare la visualizzazione per intestazione di colonna. Per cancellare le attività completate, fare clic su Clear Completed Tasks (Cancella attività completate) nella scheda Tasks.
Visualizzare i log delle API
Per visualizzare i log delle API REST, passare a Manage > Full Configuration > Logging > APIs (Gestisci > Configurazione completa > Registrazione > API). La scheda API visualizza le richieste API REST effettuate durante un determinato periodo di tempo.
Tenere presente le seguenti considerazioni:
- I registri dell’API REST vengono cancellati dopo che ci si scollega dalla console (vengono cancellati anche se si aggiorna la finestra del browser).
- Tutte le operazioni che si svolgono nella console e comportano chiamate API hanno le corrispondenti richieste API visualizzate nella scheda APIs.
- Il display elenca le richieste API in ordine cronologico (prima le voci più recenti), separate per data. Il numero massimo di richieste API sul display è 1.000.
Associare i metadati ai registri di configurazione
È possibile allegare metadati ai registri di configurazione associando una coppia di name-value denominata MetadataMap ai record di registro.
Nota:
- È possibile allegare metadati solo a oggetti operativi 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 registro a MetadataMap.
Set-LogHighLevelOperationMetadata accetta i seguenti parametri:
- Id: ID dell’operazionedi alto livello.
-
InputObject: leoperazioni di alto livello a cui si aggiungono i metadati. Si tratta di un’alternativa al parametro
Idin cui un oggetto operativo 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 della proprietà.
-
Map: dizionario delle coppie (nome, valore) per le proprietà. Si tratta di un’alternativa all’impostazione dei metadati utilizzando i parametri
-Namee-Value.
Ad esempio, per allegare i metadati a tutti i record di registro 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
Effettuare il recupero utilizzando i metadati
Per recuperare i record di registro utilizzando i metadati associati, eseguire i seguenti comandi PowerShell:
-
Cercare per chiave e valore:
Get-LogHighLevelOperation -Metadata "Key:Value" -
Cercare per valore e per qualsiasi chiave:
Get-LogHighLevelOperation -Metadata "*:Value" -
Cercare 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’operazionedi alto livello.
-
InputObject: leoperazioni di alto livello a cui si aggiungono i metadati. Si tratta di un’alternativa al parametro
Id` in cui un oggetto operativo 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 delle coppie (nome, valore) per le proprietà. Può essere una hashtable (creata con @{“name1” = “val1”; “name2” = “val2”}) o un dizionario di stringhe (creato con la stringa “System.Collections.Generic.Dictionary[String, String]”) del nuovo oggetto. Le proprietà con i nomi corrispondenti alle chiavi nella mappa vengono rimosse.
Generare report
Per generare un report CSV o HTML contenente i dati del registro di configurazione, utilizzare i cmdlet PowerShell per il servizio ConfigLogging nell’SDK Remote PowerShell di Citrix Virtual Apps and Desktops. Per ulteriori informazioni, vedere:
Pianificare l’eliminazione dati periodica
Utilizzare l’SDK Remote PowerShell per specificare per quanto tempo i dati vengono conservati nel database di registrazione della configurazione (questa funzionalità non è disponibile nell’interfaccia di gestione Full Configuration [Configurazione completa]). 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 indica 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 locale
Se si ha familiarità con la registrazione della configurazione nel prodotto Virtual Apps and Desktops locale, la versione per Citrix Cloud presenta svariate 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, poiché il database è gestito nella piattaforma Citrix Cloud.
- Le visualizzazioni del registro di configurazione non includono le operazioni e le attività eseguite all’interno della piattaforma Citrix Cloud.
- PowerShell è l’unica scelta disponibile per creare un report CSV o HTML delle operazioni registrate. Nel prodotto locale, i report possono essere generati da Citrix Studio o PowerShell.
- Non è possibile eliminare il contenuto del registro di configurazione
In questo articolo
- Cosa viene registrato
- Visualizzare il contenuto del registro di configurazione
- Visualizzare le attività relative alle operazioni del catalogo macchine
- Visualizzare i log delle API
- Associare i metadati ai registri di configurazione
- Generare report
- Pianificare l’eliminazione dati periodica
- Differenze rispetto a Citrix Virtual Apps and Desktops locale