Migrera från lagringskvarhållning för diagnostikinställningar till livscykelhantering i Azure Storage

Funktionen för lagringskvarhållning för diagnostik Inställningar är inaktuell. Om du vill konfigurera kvarhållning för loggar och mått som skickas till ett Azure Storage-konto använder du Azure Storage Lifecycle Management.

Den här guiden vägleder dig genom att migrera från att använda lagringskvarhållning för Azure-diagnostikinställningar till att använda Livscykelhantering för Azure Storage för kvarhållning. För loggar som skickas till en Log Analytics-arbetsyta anges kvarhållning för varje tabell på sidan Tabeller på arbetsytan.

Viktigt!

Tidslinje för utfasning.

• 31 mars 2023 – Funktionen för kvarhållning av diagnostik Inställningar lagring är inte längre tillgänglig för att konfigurera nya kvarhållningsregler för loggdata. Detta omfattar användning av portalen, CLI PowerShell och ARM- och Bicep-mallar. Om du har konfigurerat kvarhållningsinställningar kan du fortfarande se och ändra dem i portalen.
• 31 mars 2024 – Du kommer inte längre att kunna använda API:et (CLI, Powershell eller mallar) eller Azure-portalen för att konfigurera kvarhållningsinställningen om du inte ändrar dem till 0. Befintliga kvarhållningsregler kommer fortfarande att respekteras.
• 30 september 2025 – Alla kvarhållningsfunktioner för funktionen Diagnostik Inställningar Lagringskvarhållning inaktiveras i alla miljöer.

Förutsättningar

En befintlig diagnostikinställning som loggar till ett lagringskonto.

Migreringsprocedurer

Azure-portalen

Om du vill migrera kvarhållningsregler för diagnostikinställningar följer du stegen nedan:

1. Gå till sidan Diagnostik Inställningar för loggningsresursen och leta upp den diagnostikinställning som du vill migrera

2. Ange kvarhållningen för dina loggade kategorier till 0

3. Välj Spara

4. Gå till det lagringskonto som du loggar in på

5. Under Datahantering väljer du Livscykelhantering för att visa eller ändra livscykelhanteringsprinciper

6. Välj Listvy och välj Lägg till en regel

7. Ange ett regelnamn

8. Under Regelomfång väljer du Begränsa blobar med filter

9. Under Blobtyp väljer du Lägg till blobar och basblobar under Blob-undertyp.

10. Välj Nästa

11. Ange kvarhållningstiden och välj sedan Nästa

12. På fliken Filter, under Blob-prefixets sökväg eller prefix för containern eller loggarna som du vill att kvarhållningsregeln ska gälla för. Sökvägen eller prefixet kan finnas på valfri nivå i containern och tillämpas på alla blobar under den sökvägen eller prefixet. För alla insiktsaktivitetsloggar använder du till exempel container insights-activity-logs för att ange kvarhållning för alla loggar i containerloggarna.
    Om du vill ange regeln för en specifik webbappapp använder du insights-activity-logs/ResourceId=/SUBSCRIPTIONS/<ditt prenumerations-ID>/RESOURCEGROUPS/<din resursgrupp>/PROVIDERS/MICROSOFT. WEB/SITES/<your webapp name>.

    Använd storage-webbläsaren för att hitta sökvägen eller prefixet.
    Exemplet nedan visar prefixet för en specifik webbapp: *insights-activity-logs/ResourceId=/SUBSCRIPTIONS/d05145d-4a5d-4a5d-4a5d-5267eae1bbc7/RESOURCEGROUPS/rg-001/PROVIDERS/MICROSOFT. WEB/SITES/appfromdocker1.
    Om du vill ange regeln för alla resurser i resursgruppen använder du insights-activity-logs/ResourceId=/SUBSCRIPTIONS/d05145d-4a5d-4a5d-4a5d-5267eae1bbc7/RESOURCEGROUPS/rg-001.

13. Välj Lägg till för att spara regeln.

CLI

Använd kommandot az storage account management-policy create för att skapa en livscykelhanteringsprincip. Du måste fortfarande ange kvarhållningen i diagnostikinställningarna till 0. Mer information finns i avsnittet om Azure-portalen ovan.

az storage account management-policy create   --account-name <storage account name> --resource-group <resource group name> --policy @<policy definition file>

Exempelprincipdefinitionsfilen nedan anger kvarhållning för alla blobar i container insights-activity-logs för det angivna prenumerations-ID:t. Mer information finns i Definition av livscykelhanteringsprincip.

{
  "rules": [
    {
      "enabled": true,
      "name": "Susbcription level lifecycle rule",
      "type": "Lifecycle",
      "definition": {
        "actions": {
          "baseBlob": {
              "delete": {
              "daysAfterModificationGreaterThan": 120
            }
          }
        },
        "filters": {
          "blobTypes": [
            "appendBlob"
          ],
          "prefixMatch": [
            "insights-activity-logs/ResourceId=/SUBSCRIPTIONS/ABCD1234-5849-ABCD-1234-9876543210AB"
          ]
        }
      }
    }
  ]
}

Mallar

Använd följande mall för att skapa en livscykelhanteringsprincip. Du måste fortfarande ange kvarhållningen i diagnostikinställningarna till 0. Mer information finns i avsnittet om Azure-portalen ovan.

az deployment group create  --resource-group <resource group name> --template-file <template file>

Följande mall anger kvarhållning för lagringskontot azmonstorageaccount001 för alla blobar i container insights-activity-logs för alla resurser för prenumerations-ID:t ABCD1234-5849-ABCD-1234-9876543210AB.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "type": "Microsoft.Storage/storageAccounts/managementPolicies",
            "apiVersion": "2021-02-01",
            "name": "azmonstorageaccount001/default",
            "properties": {
                "policy": {
                    "rules": [
                        {
                            "enabled": true,
                            "name": "Susbcription level lifecycle rule",
                            "type": "Lifecycle",
                            "definition": {
                                "actions": {
                                    "baseBlob": {
                                        "delete": {
                                            "daysAfterModificationGreaterThan": 120
                                        }
                                    }
                                },
                                "filters": {
                                    "blobTypes": [
                                        "appendBlob"
                                    ],
                                    "prefixMatch": [
                                        "insights-activity-logs/ResourceId=/SUBSCRIPTIONS/ABCD1234-5849-ABCD-1234-9876543210AB"
                                    ]
                                }
                            }
                        }
                    ]
                }
            }
        }
    ]
}

Nästa steg

Konfigurera en livscykelhanteringsprincip.