Migración de la retención de almacenamiento de configuración de diagnóstico a la administración del ciclo de vida de Azure Storage

La característica Retención de almacenamiento de configuración de diagnóstico está en desuso. Para configurar la retención de registros y métricas enviadas a una cuenta de Azure Storage, use Administración del ciclo de vida de Azure Storage.

Esta guía le guía durante la migración del uso de la retención de almacenamiento de configuración de diagnóstico de Azure al uso de la administración del ciclo de vida de Azure Storage para la retención. Para los registros enviados a un área de trabajo de Log Analytics, la retención se establece para cada tabla de la página Tablas del área de trabajo.

Importante

Escala de tiempo de desuso.

• 31 de marzo de 2023: la característica Retención de almacenamiento de configuración de diagnóstico dejará de estar disponible para configurar nuevas reglas de retención para los datos de registro. Esto incluye el uso del portal, del PowerShell de la CLI y las plantillas de ARM y Bicep. Aunque haya configurado los valores de retención, podrá verlos y cambiarlos en el portal.
• 31 de septiembre de 2024: no podrá volver a usar la API (CLI, PowerShell o plantillas) ni Azure Portal para configurar la retención, salvo que cambie el valor a 0. Se seguirán respetando las reglas de retención existentes.
• 30 de septiembre de 2025: todas las funciones de retención de la característica Retención de almacenamiento de configuración de diagnóstico se deshabilitarán en todos los entornos.

Requisitos previos

Un registro de configuración de diagnóstico existente en una cuenta de almacenamiento.

Procedimientos de migración

Azure Portal

Para migrar las reglas de retención de la configuración de diagnóstico, siga estos pasos:

1. Vaya a la página Configuración de diagnóstico del recurso de registro y busque la configuración de diagnóstico que desea migrar.

2. Establezca la retención de las categorías registradas en 0.

3. Seleccione Guardar.

4. Vaya a la cuenta de almacenamiento en la que está registrado.

5. En Administración de datos, seleccione Administración del ciclo de vida para ver o cambiar las directivas de administración del ciclo de vida.

6. Seleccione Vista de lista y, después, Agregar una regla.

7. Escriba el Nombre de la regla.

8. En Ámbito de regla, seleccione Limitar blobs con filtros.

9. En Tipo de blob, seleccione Blobs de anexión y Blobs base en Subtipo de blob.

10. Seleccione Siguiente.

11. Establezca el período de retención y, a continuación, seleccione Siguiente.

12. En la pestaña Filtros, en Prefijo de blobs, establezca la ruta o el prefijo del contenedor o los registros a los que desea que se aplique la regla de retención. La ruta de acceso o el prefijo pueden estar en cualquier nivel del contenedor y se aplicarán a todos los blobs de esa ruta de acceso o prefijo. Por ejemplo, para todos los registros de actividad de información, use el contenedor insights-activity-logs para establecer la retención de todos los registros de contenedor.
    Para establecer la regla para una aplicación web específica, use insights-activity-logs/ResourceId=/SUBSCRIPTIONS/<su id. de suscripción>/RESOURCEGROUPS/<su grupo de recursos>/PROVIDERS/MICROSOFT.WEB/SITES/<su nombre de aplicación web>.

    Use el explorador de almacenamiento para encontrar la ruta de acceso o el prefijo.
    En el ejemplo siguiente se muestra el prefijo de una aplicación web específica: *insights-activity-logs/ResourceId=/SUBSCRIPTIONS/d05145d-4a5d-4a5d-4a5d-5267eae1bbc7/RESOURCEGROUPS/rg-001/PROVIDERS/MICROSOFT.WEB/SITES/appfromdocker1.
    Para establecer la regla para todos los recursos del grupo de recursos, use insights-activity-logs/ResourceId=/SUBSCRIPTIONS/d05145d-4a5d-4a5d-4a5d-5267eae1bbc7/RESOURCEGROUPS/rg-001.

13. Seleccione Agregar para guardar la regla.

CLI

Use el comando az storage account management-policy create para crear una directiva de administración del ciclo de vida. Todavía debe establecer la retención en la configuración de diagnóstico en 0. Consulte la sección Azure Portal anterior para obtener más información.

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

El archivo de definición de directiva de ejemplo siguiente establece la retención de todos los blobs del contenedor insights-activity-logs para el identificador de suscripción especificado. Para más información, consulte Definición de directiva de administración del 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"
          ]
        }
      }
    }
  ]
}

Plantillas

Aplique la plantilla siguiente para crear una directiva de administración del ciclo de vida. Todavía debe establecer la retención en la configuración de diagnóstico en 0. Consulte la sección Azure Portal anterior para obtener más información.

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

La plantilla siguiente establece la retención de la cuenta de almacenamiento azmonstorageaccount001 para todos los blobs del contenedor insights-activity-logs para todos los recursos del ide. de suscripción 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"
                                    ]
                                }
                            }
                        }
                    ]
                }
            }
        }
    ]
}

Pasos siguientes

Configure una directiva de administración del ciclo de vida.