Partilhar via

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

  • Artigo

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 para um espaço de trabalho do Log Analytics, a retenção é definida para cada tabela na página Tabelas do seu espaço de trabalho. Para obter mais informações sobre a retenção do espaço de trabalho do Log Analytics, consulte Gerenciar a retenção de dados em um espaço de trabalho do Log Analytics.

Importante

Linha do tempo de descontinuaçã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, CLI PowerShell e modelos ARM e Bicep. Se você tiver configurado as configurações de retenção, ainda poderá vê-las e alterá-las no portal.
  • 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 registro de configuração de diagnóstico existente em uma conta de armazenamento.

Procedimentos de migração

Nota

  • Quando você altera as configurações de retenção, as novas configurações só se aplicam a novos logs ingeridos após a alteração. Os logs existentes estão sujeitos às configurações de retenção anteriores.
  • A exclusão de uma configuração de diagnóstico não exclui os logs na conta de armazenamento. As configurações de retenção continuarão a ser aplicadas aos logs criados antes que as configurações de diagnóstico fossem excluídas.

Use o seguinte comando da CLI para verificar se um recurso tem uma configuração de diagnóstico:

 az monitor diagnostic-settings list --resource <resource Id>

A saída mostra se a configuração de diagnóstico envia os dados para uma conta de armazenamento, por exemplo:

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

Para migrar as 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 do seu recurso de log e localize a configuração de diagnóstico que você deseja migrar

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

  3. Selecione GuardarUma captura de tela mostrando uma página de configuração de diagnóstico.

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

  5. Em Gerenciamento de dados, selecione Gerenciamento do ciclo de vida para exibir ou alterar as políticas de gerenciamento do ciclo de vida

  6. Selecione Vista de Lista e selecione Adicionar uma regraUma captura de tela mostrando a tela de gerenciamento do ciclo de vida de uma conta de armazenamento.

  7. Insira um nome de regra

  8. Em Escopo da regra, selecione Limitar blobs com filtros

  9. Em Tipo de Blob, selecione Acrescentar Blobs e Blobs Base em Subtipo de Blob.

  10. Selecione SeguinteUma captura de tela mostrando a guia de detalhes para adicionar uma regra de ciclo de vida.

  11. Defina o tempo de retenção e, em seguida, selecione SeguinteUma captura de tela mostrando a guia Blobs base para adicionar uma regra de ciclo de vida.

  12. Na guia Filtros, em Prefixo de Blob, defina caminho ou prefixo para o contêiner ou logs aos quais você deseja que a regra de retenção seja aplicada. O caminho ou prefixo pode estar em qualquer nível dentro do contêiner e será aplicado a todos os blobs sob esse 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 nesse contêiner.
    Para definir a regra para um aplicativo webapp específico, use insights-activity-logs/ResourceId=/SUBSCRIPTIONS/<your subscription Id>/RESOURCEGROUPS/<your resource group>/PROVIDERS/MICROSOFT. WEB/SITES/<seu nome> de webapp.

    Use o navegador de armazenamento para ajudá-lo a encontrar o caminho ou prefixo.
    O exemplo abaixo mostra o prefixo de um aplicativo Web específico: *insights-activity-logs/ResourceId=/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e4e/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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e7/RESOURCEGROUPS/rg-001. Uma captura de tela mostrando o navegador de armazenamento e o caminho do recurso.

  13. Selecione Adicionar para salvar a regra. Uma captura de tela mostrando a guia filtros para adicionar uma regra de ciclo de vida.

Próximos passos

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