Conservazione e archiviazione dei dati nei log di Monitoraggio di Azure

I log di Monitoraggio di Azure mantengono dati in due stati:

• conservazione interattiva: consente di conservare i log di Analisi per query interattive fino a 2 anni.
• Archivio: consente di mantenere dati meno recenti e meno usati nell'area di lavoro a un costo ridotto. È possibile accedere ai dati nello stato archiviato usando i processi di ricerca e ripristino. È possibile conservare i dati nello stato archiviato per un massimo di 12 anni.

Il periodo di conservazione predefinito del livello gratuito è "conservazione interattiva" per 30 giorni.

Questo articolo descrive come configurare la conservazione e l'archiviazione dei dati.

Funzionamento della conservazione e dell'archiviazione

Ogni area di lavoro ha un'impostazione di conservazione predefinita applicata a tutte le tabelle. È possibile configurare un'impostazione di conservazione diversa in singole tabelle.

Durante il periodo di conservazione interattiva, i dati restano disponibili per il monitoraggio, la risoluzione dei problemi e l'analisi. Quando i log non vengono più usati, ma è comunque necessario mantenere i dati per motivi di conformità o indagini occasionali, è consigliabile archiviare i log per ridurre i costi.

I dati archiviati rimangono nella stessa tabella, insieme ai dati disponibili per le query interattive. Quando si imposta un periodo di conservazione totale più lungo del periodo di conservazione interattiva, Log Analytics archivia automaticamente i dati pertinenti immediatamente alla fine del periodo di conservazione.

È possibile accedere ai dati archiviati eseguendo un processo di ricerca o ripristinando log archiviati.

Nota

Il periodo di archiviazione può essere impostato solo a livello di tabella, non a livello di area di lavoro.

Modifiche alle impostazioni di conservazione e archiviazione

Quando si riduce un'impostazione di conservazione esistente, Monitoraggio di Azure attende 30 giorni prima di rimuovere i dati, in modo da poter ripristinare la modifica ed evitare la perdita di dati in caso di errore nella configurazione. Se necessario, è possibile rimuovere i dati immediatamente.

Quando si aumenta l'impostazione di conservazione, il nuovo periodo di conservazione si applica a tutti i dati già inseriti nella tabella che non siano stati ancora eliminati o rimosso.

Se si modificano le impostazioni di archiviazione in una tabella con dati esistenti, anche i dati pertinenti nella tabella sono immediatamente interessati. Potrebbe ad esempio essere disponibile una tabella con 180 giorni di conservazione interattiva e nessun periodo di archiviazione. Si decide di modificare l'impostazione di conservazione a 90 giorni di conservazione interattiva senza modificare il periodo di conservazione totale di 180 giorni. Log Analytics archivia immediatamente tutti i dati precedenti a 90 giorni e nessun dato viene eliminato.

Cosa accade ai dati quando si elimina una tabella in un'area di lavoro Log Analytics

Un'area di lavoro Log Analytics può contenere diversi tipi di tabelle. Ciò che accade quando si elimina la tabella è diverso per ciascun tipo:

Tipo di tabella	Conservazione dei dati	Consigli
Tabella di Azure	Una tabella di Azure contiene log da una risorsa di Azure o da dati richiesti da un servizio o una soluzione di Azure e non può essere eliminata. Quando si arresta lo streaming dei dati dalla risorsa, dal servizio o dalla soluzione, i dati rimangono nell'area di lavoro fino alla fine del periodo di conservazione definito per la tabella o per la conservazione predefinita dell'area di lavoro, se non si definisce la conservazione a livello di tabella.	Per ridurre al minimo gli addebiti, impostare la conservazione a livello di tabella su quattro giorni prima di interrompere lo streaming dei log nella tabella.
Tabella ripristinata(table_RST)	Elimina la cache ad accesso frequente di cui è stato effettuato il provisioning per il ripristino, ma i dati della tabella di origine non vengono eliminati.
Tabella dei risultati della ricerca (table_SRCH)	Elimina immediatamente e definitivamente la tabella e i dati.
Tabella log personalizzata (table_CL)	Elimina temporaneamente la tabella fino alla fine del periodo di conservazione a livello di tabella o del periodo di conservazione predefinito dell'area di lavoro. Durante il periodo di eliminazione temporanea, si continua a pagare per la conservazione dei dati ed è possibile ricreare la tabella e accedere ai dati configurando una tabella con lo stesso nome e schema. Quattordici giorni dopo l'eliminazione di una tabella personalizzata, Monitoraggio di Azure rimuove la configurazione di conservazione a livello di tabella e applica la conservazione predefinita dell'area di lavoro.	Per ridurre al minimo gli addebiti, impostare la conservazione a livello di tabella su quattro giorni prima di eliminare la tabella.

Autorizzazioni obbligatorie

Azione	Autorizzazioni obbligatorie
Configurare i criteri di conservazione e archiviazione dei dati per un'area di lavoro Log Analytics	Le autorizzazioni Microsoft.OperationalInsights/workspaces/write e microsoft.operationalinsights/workspaces/tables/write per l'area di lavoro Log Analytics fornite dal ruolo integrato di Collaboratore Log Analytics, ad esempio
Ottenere i criteri di conservazione e archiviazione per ciascuna tabella per un'area di lavoro Log Analytics	Autorizzazioni Microsoft.OperationalInsights/workspaces/tables/read per le aree di lavoro Log Analytics fornite dal ruolo predefinito di Lettore di Log Analytics, ad esempio
Rimuovere dati da un'area di lavoro Log Analytics	Le autorizzazioni Microsoft.OperationalInsights/workspaces/purge/action per l'area di lavoro Log Analytics fornite dal ruolo integrato di Collaboratore Log Analytics, ad esempio

Configurare la conservazione predefinita dell'area di lavoro

È possibile impostare la conservazione predefinita di un'area di lavoro Log Analytics nel portale di Azure su 30, 31, 60, 90, 120, 180, 270, 365, 550 e 730 giorni. È possibile applicare un'impostazione diversa a tabelle specifiche configurando la conservazione e l'archivio a livello di tabella. Se si usa il livello gratuito, è necessario eseguire l'upgrade al livello a pagamento per poter modificare il periodo di conservazione dei dati.

Importante

Le aree di lavoro con conservazione di 30 giorni potrebbero mantenere i dati per 31 giorni. Se si necessita di conservare i dati per solo 30 giorni per rispettare un'informativa sulla privacy, configurare la conservazione predefinita dell'area di lavoro su 30 giorni usando l'API e aggiornare la proprietà immediatePurgeDataOn30Days dell'area di lavoro a true. Questa operazione è attualmente supportata solo usando l'API Aggiorna - Aree di lavoro.

Portale

Per impostare la conservazione predefinita dell'area di lavoro:

1. Nel menu Aree di lavoro Log Analytics nel portale di Azure, selezionare la propria area di lavoro.

2. Selezionare Utilizzo e costi stimati nel riquadro sinistro.

3. Selezionare Conservazione dei dati nella parte superiore della pagina.

   

4. Spostare il dispositivo di scorrimento per aumentare o diminuire il numero di giorni e quindi selezionare OK.

API

Per impostare la durata di conservazione e archiviazione per una tabella, chiamare l'API Crea o aggiorna - Aree di lavoro:

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version=2023-09-01

Testo della richiesta

Il corpo della richiesta include i valori nella tabella seguente.

Nome	Tipo	Descrizione
properties.retentionInDays	integer	Conservazione dei dati dell'area di lavoro indicata in giorni. I valori consentiti dipendono dal piano tariffario. Per informazioni dettagliate, vedere la documentazione sui piani tariffari.
location	string	Posizione geografica della risorsa.
immediatePurgeDataOn30Days	boolean	Flag che indica se i dati vengono rimossi immediatamente dopo 30 giorni e non sono recuperabili. Applicabile solo quando la conservazione dell'area di lavoro è impostata su 30 giorni.

Esempio

Questo esempio imposta la conservazione dell'area di lavoro sul valore predefinito di 30 giorni e garantisce che i dati vengano rimossi immediatamente dopo 30 giorni e non siano ripristinabili.

Richiedi

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version=2023-09-01

{
  "properties": {
    "retentionInDays": 30,
    "features": {"immediatePurgeDataOn30Days": true}
    },
"location": "australiasoutheast"
}

**Response**

Status code: 200

```http
{
  "properties": {
    ...
    "retentionInDays": 30,
    "features": {
      "legacy": 0,
      "searchVersion": 1,
      "immediatePurgeDataOn30Days": true,
      ...
    },
    ...

CLI

Per impostare la durata di conservazione e archiviazione per una tabella, eseguire il comando az monitor log-analytics workspace update e passare il parametro --retention-time.

In questo esempio la conservazione interattiva della tabella viene impostata su 30 giorni e la conservazione totale viene impostata su due anni, il che significa che la durata dell'archivio è di 23 mesi:

az monitor log-analytics workspace update --resource-group myresourcegroup --retention-time 30 --workspace-name myworkspace

PowerShell

Usare il cmdlet Set-AzOperationalInsightsWorkspace per impostare la conservazione per un'area di lavoro. Questo esempio imposta la conservazione dell'area di lavoro su 30 giorni:

Set-AzOperationalInsightsWorkspace -ResourceGroupName "myResourceGroup" -Name "MyWorkspace" -RetentionInDays 30

Configurare la conservazione e l'archivio a livello di tabella

Per impostazione predefinita, tutte le tabelle nell'area di lavoro ereditano l'impostazione di conservazione interattiva dell'area di lavoro e non hanno alcun archivio. È possibile modificare le impostazioni di conservazione e archiviazione di singole tabelle, fatta eccezione per le aree di lavoro nel piano tariffario Versione di prova gratuita legacy.

Il piano dati dei log di Analytics include 31 giorni di conservazione interattiva per le aree di lavoro in piani tariffari di generazione corrente (con pagamento in base al consumo e livelli di impegno, oltre ai livelli legacy autonomi e per nodo). È possibile aumentare il periodo di conservazione interattivo fino a 730 giorni a un costo aggiuntivo. Se necessario, è possibile ridurre il periodo di conservazione interattivo a un massimo di quattro giorni usando l'API o l'interfaccia della riga di comando. Tuttavia, poiché 31 giorni di conservazione interattiva sono inclusi nel prezzo di inserimento, l'abbassamento del periodo di conservazione a meno di 31 giorni non ridurrà i costi. È possibile impostare il periodo di archiviazione su un tempo totale di conservazione di massimo 4.383 giorni (12 anni).

Nota

Attualmente, è possibile impostare la conservazione totale a un periodo di massimo 12 anni tramite il portale di Azure e l'API. L'interfaccia della riga di comando e PowerShell sono limitate a sette anni; il supporto per 12 anni sarà introdotto in futuro.

Portale

Per impostare la durata di conservazione e archiviazione per una tabella nel portale di Azure:

1. Dal menu Aree di lavoro Log Analytics, selezionare Tabelle.

   Nella schermata Tabelle sono elencate tutte le tabelle dell'area di lavoro.

2. Selezionare il menu di scelta rapida per la tabella da configurare e selezionare Gestisci tabella.

   

3. Configurare la durata di conservazione e archiviazione nella sezione Impostazioni di conservazione dei dati della schermata di configurazione della tabella.

   

API

Per impostare la durata di conservazione e archiviazione per una tabella, chiamare l'API Aggiorna - Tabelle:

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/tables/{tableName}?api-version=2022-10-01

Nota

Non specificare in modo esplicito la durata dell'archivio nella chiamata API. Impostare invece la conservazione totale, ovvero la somma della conservazione interattiva più la durata dell'archivio.

È possibile usare PUT o PATCH, con la differenza seguente:

• L'API PUT imposta retentionInDays e totalRetentionInDays sul valore predefinito se non si impostano valori non Null.
• L'API PATCH non modifica i valori retentionInDays o totalRetentionInDays se non si specificano valori.

Testo della richiesta

Il corpo della richiesta include i valori nella tabella seguente.

Nome	Tipo	Descrizione
properties.retentionInDays	integer	Conservazione dei dati della tabella indicata in giorni. Il valore deve essere compreso tra 4 e 730. L'impostazione di questa proprietà su Null applica il periodo di conservazione dell'area di lavoro. Per una tabella Log di base, il valore è sempre 8.
properties.totalRetentionInDays	integer	Conservazione totale dei dati della tabella, incluso il periodo di archiviazione. Questo valore può essere compreso tra 4 e 730; o 1095, 1460, 1826, 2191, 2556, 2922, 3288, 3653, 4018 o 4383. Impostare questa proprietà su Null se non si desidera archiviare i dati.

Esempio

In questo esempio, la conservazione interattiva della tabella viene impostata sul valore predefinito dell'area di lavoro di 30 giorni e la conservazione totale viene impostata su due anni, il che significa che la durata dell'archivio è di 23 mesi.

Richiedi

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/testRG/providers/Microsoft.OperationalInsights/workspaces/testWS/tables/CustomLog_CL?api-version=2022-10-01

Testo della richiesta

{
    "properties": {
        "retentionInDays": null,
        "totalRetentionInDays": 730
    }
}

Response

Codice di stato: 200

{
    "properties": {
        "retentionInDays": 30,
        "totalRetentionInDays": 730,
        "archiveRetentionInDays": 700,
        ...        
    },
   ...
}

CLI

Per impostare la durata di conservazione e archiviazione per una tabella, eseguire il comando az monitor log-analytics workspace table update e passare i parametri --retention-time e --total-retention-time .

In questo esempio la conservazione interattiva della tabella viene impostata su 30 giorni e la conservazione totale viene impostata su due anni, il che significa che la durata dell'archivio è di 23 mesi:

az monitor log-analytics workspace table update --subscription ContosoSID --resource-group ContosoRG --workspace-name ContosoWorkspace --name AzureMetrics --retention-time 30 --total-retention-time 730

Per riapplicare il valore di conservazione interattivo predefinito dell'area di lavoro alla tabella e reimpostarne la conservazione totale su 0, eseguire il comando az monitor log-analytics workspace table update con i parametri --retention-time e --total-retention-time impostati su -1.

Ad esempio:

az monitor log-analytics workspace table update --subscription ContosoSID --resource-group ContosoRG --workspace-name ContosoWorkspace --name Syslog --retention-time -1 --total-retention-time -1

PowerShell

Usare il cmdlet Update-AzOperationalInsightsTable per impostare la durata di conservazione e archiviazione per una tabella. In questo esempio la conservazione interattiva della tabella viene impostata su 30 giorni e la conservazione totale viene impostata su due anni, il che significa che la durata dell'archivio è di 23 mesi:

Update-AzOperationalInsightsTable -ResourceGroupName ContosoRG -WorkspaceName ContosoWorkspace -TableName AzureMetrics -RetentionInDays 30 -TotalRetentionInDays 730

Per riapplicare il valore di conservazione interattivo predefinito dell'area di lavoro alla tabella e reimpostarne la conservazione totale su 0, eseguire il cmdlet Update-AzOperationalInsightsTable con i parametri -RetentionInDays e -TotalRetentionInDays impostati su -1.

Ad esempio:

Update-AzOperationalInsightsTable -ResourceGroupName ContosoRG -WorkspaceName ContosoWorkspace -TableName Syslog -RetentionInDays -1 -TotalRetentionInDays -1

Ottenere le impostazioni di conservazione e archiviazione in base alla tabella

Portale

Per visualizzare la durata di conservazione e archiviazione per una tabella nel portale di Azure, dal menu Aree di lavoro Log Analytics, selezionare Tabelle.

La schermata Tabelle mostra il periodo di conservazione e archiviazione interattivo per tutte le tabelle nell'area di lavoro.

API

Per ottenere l'impostazione di conservazione di una tabella specifica (in questo esempio, SecurityEvent), chiamare l'API Tabelle - Ottieni:

GET /subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/MyResourceGroupName/providers/Microsoft.OperationalInsights/workspaces/MyWorkspaceName/Tables/SecurityEvent?api-version=2022-10-01

Per ottenere tutte le impostazioni di conservazione a livello di tabella nell'area di lavoro, non impostare un nome tabella.

Ad esempio:

GET /subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/MyResourceGroupName/providers/Microsoft.OperationalInsights/workspaces/MyWorkspaceName/Tables?api-version=2022-10-01

CLI

Per ottenere l'impostazione di conservazione di una determinata tabella, eseguire il comando az monitor log-analytics workspace table show.

Ad esempio:

az monitor log-analytics workspace table show --subscription ContosoSID --resource-group ContosoRG --workspace-name ContosoWorkspace --name SecurityEvent

PowerShell

Per ottenere l'impostazione di conservazione di una determinata tabella, eseguire il cmdlet Get-AzOperationalInsightsTable.

Ad esempio:

Get-AzOperationalInsightsTable -ResourceGroupName ContosoRG -WorkspaceName ContosoWorkspace -tableName SecurityEvent

Tabelle con periodi di conservazione univoci

Per impostazione predefinita, due tipi di dati (Usage e AzureActivity) mantengono dati per almeno 90 giorni senza costi. Quando si aumenta la conservazione dell'area di lavoro a più di 90 giorni, si aumenta anche la conservazione di questi tipi di dati. Per queste tabelle non sono inoltre previsti addebiti per l'inserimento di dati.

Anche le tabelle correlate alle risorse di Application Insights mantengono i dati per 90 giorni senza costi. È possibile modificare singolarmente la conservazione di ognuna di queste tabelle:

• AppAvailabilityResults
• AppBrowserTimings
• AppDependencies
• AppExceptions
• AppEvents
• AppMetrics
• AppPageViews
• AppPerformanceCounters
• AppRequests
• AppSystemEvents
• AppTraces

Modello di determinazione prezzi

L'addebito per la gestione di log archiviati viene calcolato in base al volume di dati archiviati in GB e al numero o ai giorni per cui si archiviano i dati. I dati di log con _IsBillable == false non sono soggetti a costi di conservazione o archiviazione.

Per altre informazioni, vedere Prezzi di Monitoraggio di Azure.

Passaggi successivi

Altre informazioni su:

• Gestione di dati personali nei log di Monitoraggio di Azure
• Creazione di un processo di ricerca per recuperare dati di archiviazione corrispondenti a criteri specifici
• Ripristinare dati di archivio entro un intervallo di tempo specifico