Abilitare e gestire i log di Analisi archiviazione di Azure (versione classica)

Archiviazione di Azure Analytics fornisce log per BLOB, code e tabelle. È possibile usare il portale di Azure per configurare i log registrati per l'account. Questo articolo illustra come abilitare e gestire i log. Per informazioni su come abilitare le metriche, vedere Transizione alle metriche in Monitoraggio di Azure. Sono previsti costi associati all'analisi e all'archiviazione dei dati di monitoraggio nella portale di Azure. Per altre informazioni, vedere Analisi archiviazione.

Nota

È consigliabile usare i log di Archiviazione di Azure in Monitoraggio di Azure anziché Analisi archiviazione log. Vedere uno degli articoli seguenti:

• Monitoraggio di Archivio BLOB di Azure
• Monitoraggio di File di Azure
• Monitoraggio di Archiviazione code di Azure
• Monitoraggio di Archiviazione tabelle di Azure

Abilitare i log

È possibile impostare Archiviazione di Azure in modo da salvare i log di diagnostica per le richieste di lettura, scrittura ed eliminazione per i servizi BLOB, tabelle e di accodamento. I criteri di conservazione dati impostati si applicano anche a questi log.

Nota

File di Azure supporta attualmente metriche Analisi archiviazione, ma non supporta la registrazione Analisi archiviazione.

Portale

1. Nel portale di Azure selezionare Account di archiviazione e quindi il nome dell'account di archiviazione per aprire il relativo pannello.

2. Selezionare Impostazioni di diagnostica (versione classica) nella sezione Monitoraggio (versione classica) del pannello del menu.

   

3. Verificare che l'opzione Stato sia impostata su Attivato e selezionare i servizi per cui si vuole abilitare la registrazione.

   

4. Per conservare i log, verificare che la casella di controllo Elimina dati sia selezionata. Impostare quindi il numero di giorni in cui si desidera conservare i dati di log spostando il controllo dispositivo di scorrimento sotto la casella di controllo oppure modificando direttamente il valore visualizzato nella casella di testo accanto al controllo dispositivo di scorrimento. L'impostazione predefinita per i nuovi account di archiviazione è sette giorni. Se non si desidera impostare un criterio di conservazione, lasciare deselezionata la casella di controllo Elimina dati . Se non sono presenti criteri di conservazione, è necessario eliminare i dati di log.

   Avviso

   I log vengono archiviati come dati nell'account. I dati di log possono accumularsi nell'account nel tempo, aumentando così il costo dell'archiviazione. Se sono necessari dati di log solo per un breve periodo di tempo, è possibile ridurre i costi modificando i criteri di conservazione dei dati. I dati di log non aggiornati (dati precedenti ai criteri di conservazione) vengono eliminati dal sistema. È consigliabile impostare criteri di conservazione in base al tempo necessario per conservare i dati di log per l'account. Per altre informazioni, vedere Fatturazione delle metriche di archiviazione.

5. Fare clic su Salva.

   I log di diagnostica sono salvati in un contenitore blob denominato $logs nell'account di archiviazione. È possibile visualizzare i dati di log usando uno strumento di esplorazione dell'archiviazione, ad esempio esplora risorse di Archiviazione di Microsoft Azure o a livello di codice, usando la libreria client di archiviazione o PowerShell.

   Per informazioni sull'accesso al contenitore $logs, vedere Registrazione di Analisi archiviazione.

   Nota

   Per gli account di archiviazione classici, il contenitore $logs viene visualizzato solo in Archiviazione di Azure Explorer. Il contenitore $logs non è visibile dal browser di archiviazione o dalla visualizzazione contenitore disponibile nella portale di Azure.

PowerShell

1. Aprire una finestra dei comandi di Windows PowerShell.

2. Accedere alla sottoscrizione di Azure con il comando Connect-AzAccount e seguire le istruzioni visualizzate.

   Connect-AzAccount
   

3. Se l'identità è associata a più di una sottoscrizione, impostare la sottoscrizione attiva.

   $context = Get-AzSubscription -SubscriptionId <subscription-id>
   Set-AzContext $context
   

   Sostituire il valore segnaposto <subscription-id> con l'ID della sottoscrizione.

4. Ottenere il contesto dell’account di archiviazione che definisce l'account di archiviazione che si intende usare.

   $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
   $ctx = $storageAccount.Context
   

   • Sostituire il valore segnaposto <resource-group-name> con il nome del proprio gruppo di risorse.

   • Sostituire il valore segnaposto <storage-account-name> con il nome del proprio account di archiviazione.

5. Usare Set-AzStorageServiceLoggingProperty per modificare le impostazioni di log correnti. I cmdlet che controllano Registrazione archiviazione usano il parametro LoggingOperations, costituito da una stringa contenente un elenco separato da virgole dei tipi di richiesta da registrare. I tre tipi possibili di richiesta sono read, write e delete. Per disattivare la registrazione, usare il valore none per il parametro LoggingOperations.

   Il seguente comando attiva la registrazione per le richieste di lettura, scrittura ed eliminazione per il Servizio di accodamento nell'account di archiviazione predefinito, con periodo di conservazione di cinque giorni:

   Set-AzStorageServiceLoggingProperty -ServiceType Queue -LoggingOperations read,write,delete -RetentionDays 5 -Context $ctx
   

   Avviso

   I log vengono archiviati come dati nell'account. i dati di log possono accumularsi nell'account nel tempo, aumentando così il costo dell'archiviazione. Se sono necessari dati di log solo per un breve periodo di tempo, è possibile ridurre i costi modificando i criteri di conservazione dei dati. I dati di log non aggiornati (dati precedenti ai criteri di conservazione) vengono eliminati dal sistema. È consigliabile impostare criteri di conservazione in base al tempo necessario per conservare i dati di log per l'account. Per altre informazioni, vedere Fatturazione delle metriche di archiviazione.

   Il seguente comando disattiva la registrazione per il servizio tabelle nell'account di archiviazione predefinito:

   Set-AzStorageServiceLoggingProperty -ServiceType Table -LoggingOperations none -Context $ctx 
   

   Per informazioni su come configurare i cmdlet di Azure PowerShell per usare la sottoscrizione di Azure e su come selezionare l'account di archiviazione predefinito da utilizzare, vedere: Come installare e configurare Azure PowerShell.

.NET

QueueServiceClient queueServiceClient = new QueueServiceClient(connectionString);

QueueServiceProperties serviceProperties = queueServiceClient.GetProperties().Value;

serviceProperties.Logging.Delete = true;

QueueRetentionPolicy retentionPolicy = new QueueRetentionPolicy();
retentionPolicy.Enabled = true;
retentionPolicy.Days = 2;
serviceProperties.Logging.RetentionPolicy = retentionPolicy;

serviceProperties.HourMetrics = null;
serviceProperties.MinuteMetrics = null;
serviceProperties.Cors = null;

queueServiceClient.SetProperties(serviceProperties);

Modificare il periodo di conservazione dei dati dei log

I dati di log possono accumularsi nell'account nel tempo, aumentando così il costo dell'archiviazione. Se sono necessari dati di log solo per un breve periodo di tempo, è possibile ridurre i costi modificando il periodo di conservazione dei dati di log. Ad esempio, se sono necessari log solo per tre giorni, impostare il periodo di conservazione dei dati di log su un valore pari 3a . In questo modo i log verranno eliminati automaticamente dall'account dopo 3 giorni. Questa sezione illustra come visualizzare il periodo di conservazione dei dati di log corrente e quindi aggiornare il periodo se si vuole eseguire questa operazione.

Portale

1. Nel portale di Azure selezionare Account di archiviazione e quindi il nome dell'account di archiviazione per aprire il relativo pannello.

2. Selezionare Impostazioni di diagnostica (versione classica) nella sezione Monitoraggio (versione classica) del pannello del menu.

   

3. Assicurarsi che la casella di controllo Elimina dati sia selezionata. Impostare quindi il numero di giorni in cui si desidera conservare i dati di log spostando il controllo dispositivo di scorrimento sotto la casella di controllo oppure modificando direttamente il valore visualizzato nella casella di testo accanto al controllo dispositivo di scorrimento.

   

   Il numero predefinito di giorni per i nuovi account di archiviazione è di sette giorni. Se non si desidera impostare un criterio di conservazione, lasciare deselezionata la casella di controllo Elimina dati . Se non vengono impostati criteri di conservazione, i dati di monitoraggio dovranno essere eliminati manualmente.

4. Fare clic su Salva.

   I log di diagnostica sono salvati in un contenitore blob denominato $logs nell'account di archiviazione. È possibile visualizzare i dati di log usando uno strumento di esplorazione dell'archiviazione, ad esempio esplora risorse di Archiviazione di Microsoft Azure o a livello di codice, usando la libreria client di archiviazione o PowerShell.

   Per informazioni sull'accesso al contenitore $logs, vedere Registrazione di Analisi archiviazione.

PowerShell

1. Aprire una finestra dei comandi di Windows PowerShell.

2. Accedere alla sottoscrizione di Azure con il comando Connect-AzAccount e seguire le istruzioni visualizzate.

   Connect-AzAccount
   

3. Se l'identità è associata a più di una sottoscrizione, impostare la sottoscrizione attiva.

   $context = Get-AzSubscription -SubscriptionId <subscription-id>
   Set-AzContext $context
   

   Sostituire il valore segnaposto <subscription-id> con l'ID della sottoscrizione.

4. Ottenere il contesto dell'account di archiviazione che definisce l'account di archiviazione.

   $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
   $ctx = $storageAccount.Context
   

   • Sostituire il valore segnaposto <resource-group-name> con il nome del proprio gruppo di risorse.

   • Sostituire il valore segnaposto <storage-account-name> con il nome del proprio account di archiviazione.

5. Usare Get-AzStorageServiceLoggingProperty per visualizzare i criteri di conservazione dei log correnti. Nell'esempio seguente viene stampato nella console il periodo di conservazione per i servizi di archiviazione BLOB e di coda.

   Get-AzStorageServiceLoggingProperty -ServiceType Blob, Queue -Context $ctx
   

   Nell'output della console il periodo di conservazione viene visualizzato sotto l'intestazione di RetentionDays colonna.

   

6. Usare Set-AzStorageServiceLoggingProperty per modificare il periodo di conservazione. Nell'esempio seguente il periodo di conservazione viene modificato in 4 giorni.

   Set-AzStorageServiceLoggingProperty -ServiceType Blob, Queue -RetentionDays 4 -Context $ctx
   

   Per informazioni su come configurare i cmdlet di Azure PowerShell per usare la sottoscrizione di Azure e su come selezionare l'account di archiviazione predefinito da utilizzare, vedere: Come installare e configurare Azure PowerShell.

.NET

Nell'esempio seguente viene stampato nella console il periodo di conservazione per i servizi di archiviazione BLOB e di coda.

BlobServiceClient blobServiceClient = new BlobServiceClient(connectionString);
QueueServiceClient queueServiceClient = new QueueServiceClient(connectionString);

BlobServiceProperties blobServiceProperties = blobServiceClient.GetProperties().Value;
QueueServiceProperties queueServiceProperties = queueServiceClient.GetProperties().Value;

Console.WriteLine("Retention period for logs from the blob service is: " +
    blobServiceProperties.Logging.RetentionPolicy.Days.ToString());

Console.WriteLine("Retention period for logs from the queue service is: " +
    queueServiceProperties.Logging.RetentionPolicy.Days.ToString());

Nell'esempio seguente il periodo di conservazione viene modificato in 4 giorni.

BlobRetentionPolicy blobRetentionPolicy = new BlobRetentionPolicy();

blobRetentionPolicy.Enabled = true;
blobRetentionPolicy.Days = 4;

QueueRetentionPolicy queueRetentionPolicy = new QueueRetentionPolicy();

queueRetentionPolicy.Enabled = true;
queueRetentionPolicy.Days = 4;

blobServiceProperties.Logging.RetentionPolicy = blobRetentionPolicy;
blobServiceProperties.Cors = null;

queueServiceProperties.Logging.RetentionPolicy = queueRetentionPolicy;
queueServiceProperties.Cors = null;

blobServiceClient.SetProperties(blobServiceProperties);
queueServiceClient.SetProperties(queueServiceProperties);

Console.WriteLine("Retention policy for blobs and queues is updated");

Verificare che i dati di log vengano eliminati

È possibile verificare che i log vengano eliminati visualizzando il contenuto del contenitore dell'account $logs di archiviazione. L'immagine seguente mostra il contenuto di una cartella nel $logs contenitore. La cartella corrisponde a gennaio 2021 e ogni cartella contiene i log per un giorno. Se il giorno odierno era il 29 gennaio 2021 e i criteri di conservazione sono impostati su un solo giorno, questa cartella deve contenere i log per un solo giorno.

Visualizzare i dati dei log

Per visualizzare e analizzare i dati di log, è necessario scaricare su un computer locale i BLOB contenenti i dati di log a cui si è interessati. Molti strumenti di esplorazione delle informazioni archiviate consentono di scaricare i BLOB dall'account di archiviazione. Per scaricare i dati di log è possibile anche usare lo strumento di Azure per la copia AzCopy fornito dal team di Archiviazione di Azure.

Nota

Il contenitore $logs non è integrato con Griglia di eventi, quindi non si riceveranno notifiche quando vengono scritti i file di log.

Per scaricare soltanto i dati di log a cui si è interessati e per evitare di scaricare più volte gli stessi dati, procedere come segue:

• Usare la convenzione di denominazione di data e ora per i BLOB contenenti dati di log, in modo da tenere traccia di quelli già scaricati a scopo di analisi ed evitare di ripetere il download.

• Usare i metadati dei BLOB contenenti dati di log per identificare il periodo specifico di conservazione dei dati e individuare esattamente il BLOB che è necessario scaricare.

Per iniziare a usare AzCopy, vedere Introduzione ad AzCopy

Nell'esempio seguente viene illustrato come è possibile scaricare i dati di log per il servizio di accodamento per le ore a partire dalle 09, le 10.00 e le 11.00 del 20 maggio 2014.

azcopy copy 'https://mystorageaccount.blob.core.windows.net/$logs/queue' 'C:\Logs\Storage' --include-path '2014/05/20/09;2014/05/20/10;2014/05/20/11' --recursive

Per altre informazioni su come scaricare file specifici, vedere Scaricare BLOB dall'archivio BLOB di Azure usando AzCopy v10.

Una volta scaricati i dati di log, è possibile visualizzare le voci di log nei file. Questi file di log usano un formato di testo delimitato che molti strumenti di lettura log sono in grado di analizzare . Per altre informazioni, vedere la guida Monitoraggio, Diagnosi e Risoluzione dei problemi Archiviazione di Microsoft Azure. Altri strumenti dispongono di funzionalità differenti per la formattazione, il filtro, l'ordinamento e la ricerca nei contenuti dei file di log. Per altre informazioni sul formato dei file di log di Registrazione archiviazione, vedere Formato del log di Analisi archiviazione e Operazioni e messaggi di stato registrati di Analisi archiviazione.

Passaggi successivi

• Per altre informazioni sulle Analisi archiviazione, vedere Analisi archiviazione per Analisi archiviazione.
• Per altre informazioni sull'uso di un linguaggio .NET per configurare Registrazione archiviazione, vedere Riferimenti alla libreria del client di archiviazione.
• Per informazioni generali sulla configurazione di Registrazione archiviazione mediante l'API REST, vedere Abilitazione e configurazione di Analisi archiviazione.
• Altre informazioni sul formato dei log di Analisi archiviazione. Vedere Analisi archiviazione Formato log.