Eseguire la migrazione dalla conservazione delle impostazioni di diagnostica alla gestione del ciclo di vita dell'archiviazione di Azure.

La funzionalità di conservazione dell'archiviazione delle impostazioni di diagnostica è deprecata. Tutte le funzionalità di conservazione per questa funzionalità sono state disabilitate in tutti gli ambienti il 30 settembre 2025.

Questo articolo illustra la migrazione dall'uso della conservazione delle impostazioni diagnostiche all'uso della gestione del ciclo di vita di Archiviazione di Azure per la conservazione.

Per i log inviati a un'area di lavoro Log Analytics, la conservazione viene impostata per ogni tabella nella pagina Tabelle dell'area di lavoro. Per altre informazioni, vedere Gestire la conservazione dei dati in un'area di lavoro Log Analytics.

Prerequisiti

Per completare questa migrazione, è necessario:

  • Impostazione di diagnostica esistente che invia i log a un account Archiviazione di Azure.
  • Il ruolo Collaboratore account di archiviazione o un ruolo equivalente che includa le autorizzazioni Microsoft.Storage/storageAccounts/managementPolicies/*, nell'account di archiviazione di destinazione.

Eseguire la migrazione a un criterio di gestione del ciclo di vita Archiviazione di Azure

La funzionalità di conservazione dell'archiviazione delle impostazioni di diagnostica ha interrotto l'applicazione della conservazione il 30 settembre 2025, quindi qualsiasi valore di conservazione che rimane in un'impostazione di diagnostica non ha più alcun effetto. Ricreare il comportamento di conservazione nell'account di archiviazione con un criterio di gestione del ciclo di vita Archiviazione di Azure completando i passaggi seguenti.

Quando si modificano le impostazioni di conservazione, tenere presente il comportamento seguente:

Annotazioni

  • Quando si modificano le impostazioni di conservazione, le nuove impostazioni si applicano solo ai nuovi log inseriti dopo la modifica. I log esistenti sono soggetti alle impostazioni di conservazione precedenti.
  • L'eliminazione di un'impostazione di diagnostica non comporta l'eliminazione dei log nell'account di archiviazione. Le impostazioni di conservazione continuano a essere applicate ai log creati prima dell'eliminazione delle impostazioni di diagnostica.

Verificare la presenza di un'impostazione di diagnostica che usa un account di archiviazione

Nell'esempio di interfaccia della riga di comando di Azure seguente viene usato il az monitor diagnostic-settings list comando . Elenca le impostazioni di diagnostica in una risorsa usando il --resource parametro .

# Set variables
resourceId="<ResourceId>"

# List the diagnostic settings on the resource
az monitor diagnostic-settings list --resource "$resourceId"

L'output indica se l'impostazione di diagnostica invia i dati a un account di archiviazione. Per esempio:

[
  {
    "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/rg-001/providers/microsoft.insights/datacollectionrules/dcr-east2/providers/microsoft.insights/diagnosticSettings/dsetting-1",
    "logs": [
      {
        "categoryGroup": "allLogs",
        "enabled": true,
        "retentionPolicy": {
          "days": 0,
          "enabled": false
        }
      }
    ],
    "metrics": [
      {
        "category": "AllMetrics",
        "enabled": false,
        "retentionPolicy": {
          "days": 0,
          "enabled": false
        }
      }
    ],
    "name": "dsetting-1",
    "resourceGroup": "rg-001",
    "storageAccountId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/rg-DCR/providers/Microsoft.Storage/storageAccounts/logs001",
    "type": "Microsoft.Insights/diagnosticSettings"
  }
]

Creare i criteri di gestione del ciclo di vita

Scegli interfaccia della riga di comando di Azure, Bicep o un modello ARM per creare il criterio. Poiché la conservazione dell'archiviazione delle impostazioni di diagnostica è stata disabilitata il 30 settembre 2025, qualsiasi valore di conservazione lasciato in un'impostazione di diagnostica non viene più applicato, quindi non è necessario reimpostarlo su 0.

Nell'esempio di interfaccia della riga di comando di Azure seguente viene usato il az storage account management-policy create comando . Crea i criteri di gestione del ciclo di vita usando il --policy parametro per fare riferimento a un file di definizione dei criteri locale.

# Set variables
storageAccountName="<StorageAccountName>"
resourceGroupName="<ResourceGroupName>"
policyFilePath="<PolicyDefinitionFilePath>"

# Create the lifecycle management policy
az storage account management-policy create \
  --account-name "$storageAccountName" \
  --resource-group "$resourceGroupName" \
  --policy "@$policyFilePath"

La definizione di criteri di esempio seguente imposta la conservazione per tutti i BLOB nel contenitore insights-activity-logs per la sottoscrizione. Per altre informazioni, vedere Definizione dei criteri di gestione del ciclo di vita.

{
  "rules": [
    {
      "enabled": true,
      "name": "Subscription level lifecycle rule",
      "type": "Lifecycle",
      "definition": {
        "actions": {
          "baseBlob": {
            "delete": {
              "daysAfterModificationGreaterThan": 120
            }
          }
        },
        "filters": {
          "blobTypes": [
            "appendBlob"
          ],
          "prefixMatch": [
            "insights-activity-logs/ResourceId=/SUBSCRIPTIONS/<SubscriptionId>"
          ]
        }
      }
    }
  ]
}

Verificare i criteri di gestione del ciclo di vita

Nell'esempio di interfaccia della riga di comando di Azure seguente viene usato il az storage account management-policy show comando . Conferma che il criterio esiste nell'account di archiviazione usando il parametro --account-name.

# Set variables
storageAccountName="<StorageAccountName>"
resourceGroupName="<ResourceGroupName>"

# Show the lifecycle management policy
az storage account management-policy show \
  --account-name "$storageAccountName" \
  --resource-group "$resourceGroupName"

L’output mostra le regole dei criteri, incluso il valore daysAfterModificationGreaterThan che imposta il periodo di conservazione in giorni.