Migreren van opslagretentie van diagnostische instellingen naar levenscyclusbeheer van Azure Storage

De functie Diagnostische Instellingen Opslagretentie wordt afgeschaft. Gebruik Azure Storage Lifecycle Management om retentie te configureren voor logboeken en metrische gegevens die naar een Azure Storage-account worden verzonden.

Deze handleiding begeleidt u bij het migreren van het gebruik van opslagretentie van diagnostische Azure-instellingen tot het gebruik van levenscyclusbeheer van Azure Storage voor retentie. Voor logboeken die naar een Log Analytics-werkruimte worden verzonden, wordt retentie ingesteld voor elke tabel op de pagina Tabellen van uw werkruimte. Zie Gegevensretentie en -archivering in Azure Monitor-logboeken voor meer informatie over het bewaren van Log Analytics-werkruimten.

Belangrijk

Tijdlijn voor afschaffing.

• 31 maart 2023 : de functie Diagnostische Instellingen Opslagretentie is niet meer beschikbaar om nieuwe bewaarregels voor logboekgegevens te configureren. Dit omvat het gebruik van de portal-, CLI PowerShell- en ARM- en Bicep-sjablonen. Als u bewaarinstellingen hebt geconfigureerd, kunt u deze nog steeds zien en wijzigen in de portal.
• 31 maart 2024: u kunt de API (CLI, Powershell of sjablonen) of Azure Portal niet meer gebruiken om de bewaarinstelling te configureren, tenzij u deze wijzigt in 0. Bestaande bewaarregels worden nog steeds nageleefd.
• 30 september 2025 : alle bewaarfunctionaliteit voor de functie Diagnostische Instellingen Opslagretentie wordt uitgeschakeld in alle omgevingen.

Vereisten

Een bestaande logboekregistratie van diagnostische instellingen voor een opslagaccount.

Migratieprocedures

Azure-portal

Volg de onderstaande stappen om de bewaarregels voor diagnostische instellingen te migreren:

1. Ga naar de pagina Diagnostische Instellingen voor uw logboekregistratieresource en zoek de diagnostische instelling die u wilt migreren

2. De retentie voor uw geregistreerde categorieën instellen op 0

3. Selecteer Opslaan

4. Navigeer naar het opslagaccount waarnaar u zich aanmeldt

5. Selecteer onder Gegevensbeheer levenscyclusbeheer om beleid voor levenscyclusbeheer weer te geven of te wijzigen

6. Selecteer Lijstweergave en selecteer Een regel toevoegen

7. Voer een regelnaam in

8. Selecteer onder Regelbereik de optie Blobs beperken met filters

9. Selecteer onder Blobtype toevoeg-blobs en basis-blobs onder blobsubtype.

10. Selecteer Volgende

11. Stel de bewaartijd in en selecteer vervolgens Volgende

12. Stel op het tabblad Filters onder Het pad of voorvoegsel voor het blobvoorvoegsel het pad of voorvoegsel in op de container of logboeken waarop u de bewaarregel wilt toepassen. Het pad of voorvoegsel kan zich op elk niveau in de container bevinden en wordt toegepast op alle blobs onder dat pad of voorvoegsel. Voor alle inzichtactiviteitslogboeken gebruikt u bijvoorbeeld de logboeken container insights-activity-logs om de retentie in te stellen voor alle logboeken in die containerlogboeken.
    Als u de regel voor een specifieke web-app wilt instellen, gebruikt u insights-activity-logs/ResourceId=/SUBSCRIPTIONS/<uw abonnements-id>/RESOURCEGROUPS/<uw resourcegroep>/PROVIDERS/MICROSOFT. WEB/SITES/<de naam> van uw web-app.

    Gebruik de opslagbrowser om het pad of voorvoegsel te vinden.
    In het onderstaande voorbeeld ziet u het voorvoegsel voor een specifieke web-app: *insights-activity-logs/ResourceId=/SUBSCRIPTIONS/d05145d-4a5d-4a5d-4a5d-5267eae1bbc7/RESOURCEGROUPS/rg-001/PROVIDERS/MICROSOFT. WEB/SITES/appfromdocker1.
    Als u de regel voor alle resources in de resourcegroep wilt instellen, gebruikt u insights-activity-logs/ResourceId=/SUBSCRIPTIONS/d05145d-4a5d-4a5d-4a5d-5267eae1bbc7/RESOURCEGROUPS/rg-001.

13. Selecteer Toevoegen om de regel op te slaan.

CLI

Gebruik de opdracht az storage account management-policy create om een levenscyclusbeheerbeleid te maken. U moet de retentie in uw diagnostische instellingen nog steeds instellen op 0. Zie de sectie Azure Portal hierboven voor meer informatie.

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

In het onderstaande voorbeeldbestand voor beleidsdefinities wordt de retentie ingesteld voor alle blobs in de container insights-activity-logs voor de opgegeven abonnements-id. Zie de definitie van het levenscyclusbeheerbeleid voor meer informatie.

{
  "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"
          ]
        }
      }
    }
  ]
}

Sjablonen

Pas de volgende sjabloon toe om een levenscyclusbeheerbeleid te maken. U moet de retentie in uw diagnostische instellingen nog steeds instellen op 0. Zie de sectie Azure Portal hierboven voor meer informatie.

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

Met de volgende sjabloon wordt de retentie voor opslagaccount azmonstorageaccount001 ingesteld voor alle blobs in de container insights-activity-logs voor alle resources voor de abonnements-id 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"
                                    ]
                                }
                            }
                        }
                    ]
                }
            }
        }
    ]
}

Volgende stappen

Configureer een levenscyclusbeheerbeleid.