Migrar da retenção de armazenamento de configurações de diagnóstico para o gerenciamento de ciclo de vida do Armazenamento do Microsoft Azure

O recurso de Retenção de Armazenamento de Configurações de Diagnóstico está sendo preterido. Para configurar a retenção para logs e métricas enviados para uma conta de Armazenamento do Azure, use o Gerenciamento do Ciclo de Vida do Armazenamento do Azure.

Este guia orienta você na migração do uso da retenção de armazenamento de configurações de diagnóstico do Azure para o uso do Gerenciamento do ciclo de vida do Armazenamento do Azure para retenção. Para logs enviados a um workspace do Log Analytics, a retenção é definida para cada tabela na página Tabelas do workspace.

Importante

Linha do tempo da depreciação.

• 31 de março de 2023 – o recurso de Retenção de Armazenamento de Configurações de Diagnóstico não estará mais disponível para configurar novas regras de retenção para dados de log. Isso inclui o uso do portal, do PowerShell da CLI e dos modelos do ARM e Bicep. Se você tiver definido as configurações de retenção, ainda poderá vê-las e alterá-las no portal.
• 31 de setembro de 2024 – você não poderá mais usar a API (CLI, Powershell ou modelos) ou o portal do Azure para definir a configuração de retenção, a menos que esteja alterando-as para 0. As regras de retenção existentes ainda serão respeitadas.
• 30 de setembro de 2025 – todas as funcionalidades de retenção para o recurso de Retenção de Armazenamento de Configurações de Diagnóstico serão desabilitadas em todos os ambientes.

Pré-requisitos

Um log de configuração de diagnóstico existente em uma conta de armazenamento.

Procedimentos de migração

Portal do Azure

Para migrar suas regras de retenção de configurações de diagnóstico, siga as etapas abaixo:

1. Vá para a página Configurações de Diagnóstico para o recurso de log e localize a configuração de diagnóstico que você deseja migrar

2. Definir a retenção para suas categorias registradas como 0

3. Selecione Salvar

4. Navegue até a conta de armazenamento na qual você está fazendo o logon

5. Em Gerenciamento de dados, escolha Gerenciamento de ciclo de vida para ver ou mudar as políticas de gerenciamento do ciclo de vida

6. Selecione a Exibição de lista e selecione Adicionar uma regra

7. Insira um Nome de regra

8. Em Escopo de Regra, selecione Limitar blobs com filtros

9. Em Tipo de blob, selecione Blobs de acréscimo e Blobs base no Subtipo blob.

10. Selecione Avançar

11. Defina seu tempo de retenção e, em seguida, selecione Avançar

12. Na guia Filtros, no Prefixo de blob, defina o caminho ou o prefixo para o contêiner ou logs aos quais você deseja que a regra de retenção se aplique. O caminho ou prefixo pode estar em qualquer nível dentro do contêiner e será aplicado a todos os blobs nesse caminho ou prefixo. Por exemplo, para todos os logs de atividades de insight, use o contêiner insights-activity-logs para definir a retenção para todos os logs desse contêiner.
    Para definir a regra para um aplicativo de webapp específico, use insights-activity-logs/ResourceId=/SUBSCRIPTIONS/<sua ID de assinatura>/RESOURCEGROUPS/<seu grupo de recursos>/PROVIDERS/MICROSOFT.WEB/SITES/<nome do aplicativo Web>.

    Use o navegador de armazenamento para ajudá-lo a encontrar o caminho ou o prefixo.
    O exemplo a seguir mostra o prefixo de um aplicativo Web específico: *insights-activity-logs/ResourceId=/SUBSCRIPTIONS/d05145d-4a5d-4a5d-4a5d-5267eae1bbc7/RESOURCEGROUPS/rg-001/PROVIDERS/MICROSOFT. WEB/SITES/appfromdocker1.
    Para definir a regra para todos os recursos no grupo de recursos, use insights-activity-logs/ResourceId=/SUBSCRIPTIONS/d05145d-4a5d-4a5d-4a5d-5267eae1bbc7/RESOURCEGROUPS/rg-001.

13. Selecione Adicionar para salvar a regra.

CLI

Use o comando az storage account management-policy create para criar uma política de gerenciamento do ciclo de vida. Você ainda deve definir a retenção nas suas configurações de diagnóstico como 0. Confira a seção portal do Azure acima para obter mais informações.

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

O arquivo de definição de política de exemplo abaixo define a retenção de todos os blobs no contêiner insights-activity-logs para a ID de assinatura fornecida. Para obter mais informações, confira Definição de política de gerenciamento do ciclo de vida.

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

Modelos

Aplique o modelo a seguir para criar uma política de gerenciamento do ciclo de vida. Você ainda deve definir a retenção nas suas configurações de diagnóstico como 0. Confira a seção portal do Azure acima para obter mais informações.

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

O modelo a seguir define a retenção para a conta de armazenamento azmonstorageaccount001 para todos os blobs no contêiner insights-activity-logs para todos os recursos da ID da assinatura 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"
                                    ]
                                }
                            }
                        }
                    ]
                }
            }
        }
    ]
}

Próximas etapas

Configurar uma política de gerenciamento do ciclo de vida.