Migrer de la rétention du stockage des paramètres de diagnostic vers la gestion du cycle de vie du stockage Azure

La fonctionnalité Conservation du stockage des paramètres de diagnostic est dépréciée. Pour configurer la conservation des journaux et des métriques envoyés à un compte de stockage Azure, utilisez Gestion du cycle de vie de Stockage Azure.

Ce guide vous guide tout au long de la migration de l’utilisation de la rétention du stockage des paramètres de diagnostic Azure vers la gestion du cycle de vie du stockage Azure pour la rétention. Pour les journaux envoyés à un espace de travail Log Analytics, la conservation est définie pour chaque table de la page Tables de votre espace de travail. Pour plus d’informations sur la rétention de l’espace de travail Log Analytics, consultez Rétention et archivage des données dans les journaux Azure Monitor.

Important

Chronologie de la dépréciation.

• 31 mars 2023 : La fonctionnalité Conservation du stockage des paramètres de diagnostic ne sera plus disponible pour configurer de nouvelles règles de conservation pour les données de journal. Cela inclut l’utilisation du portail, de PowerShell CLI et des modèles ARM et Bicep. Si vous avez configuré des paramètres de conservation, vous pourrez toujours les voir et les modifier dans le portail.
• 31 mars 2024 : vous ne pourrez plus utiliser l’API (CLI, Powershell ou les modèles) ni le Portail Azure pour configurer les paramètres de conservation, sauf si vous les remplacez par 0. Les règles de conservation existantes seront toujours respectées.
• 30 septembre 2025 : Toutes les fonctions de conservation de la fonctionnalité de conservation du stockage des paramètres de diagnostic seront désactivées dans tous les environnements.

Prérequis

Journalisation d’un paramètre de diagnostic existant sur un compte de stockage.

Procédures de migration

Azure portal

Pour migrer vos règles de rétention des paramètres de diagnostic, procédez comme suit :

1. Accédez à la page Paramètres de diagnostic de votre ressource de journalisation et recherchez le paramètre de diagnostic que vous souhaitez migrer

2. Définir la rétention de vos catégories journalisées sur 0

3. Sélectionnez Sauvegarder

4. Accédez au compte de stockage auquel vous vous connectez

5. Sous Gestion des données, sélectionnez Gestion de cycle de vie pour afficher ou modifier les stratégies de gestion de cycle de vie.

6. Sélectionnez Afficher la liste, puis sélectionnez Ajouter une règle

7. Entrez un Nom de règle

8. Sous Étendue de la règle, sélectionnez Limiter les objets blob avec des filtres

9. Sous Type d’objet blob, sélectionnez Ajouter des objets blob et des objets blob de base sous le sous-type Blob.

10. Sélectionnez Suivant

11. Définissez votre période de rétention, puis sélectionnez Suivant

12. Sous l’onglet Filtres, sous Préfixe d’objet blob, définissez le chemin d’accès ou le préfixe du conteneur ou des journaux auquel vous souhaitez appliquer la règle de rétention. Le chemin ou le préfixe peut se trouver à n’importe quel niveau dans le conteneur et s’appliquera à tous les objets blob sous ce chemin ou préfixe. Par exemple, pour tous les journaux d’activité d’insights, utilisez le conteneur insights-activity-logs pour définir la rétention de tous les journaux d’activité de ce conteneur.
    Pour définir la règle pour une application web spécifique, utilisez insights-logs-functionapplogs/resourceId=/SUBSCRIPTIONS/<votre ID d’abonnement>/RESOURCEGROUPS/<votre groupe de ressources>/PROVIDERS/MICROSOFT. WEB/SITES/<nom de votre application web>.

    Utilisez le navigateur de Stockage pour vous aider à trouver le chemin d’accès ou le préfixe.
    L’exemple ci-dessous montre le préfixe d’une application web spécifique : *insights-activity-logs/ResourceId=/SUBSCRIPTIONS/d05145d-4a5d-4a5d-4a5d-5267eae1bbc7/RESOURCEGROUPS/rg-001/PROVIDERS/MICROSOFT. WEB/SITES/appfromdocker1.
    Pour définir la règle pour toutes les ressources du groupe de ressources, utilisez insights-activity-logs/ResourceId=/SUBSCRIPTIONS/d05145d-4a5d-4a5d-4a5d-5267eae1bbc7/RESOURCEGROUPS/rg-001.

13. Sélectionnez Ajouter pour enregistrer la règle.

INTERFACE DE LIGNE DE COMMANDE

Utilisez la commande az storage account management-policy create pour créer une stratégie de gestion du cycle de vie. Vous devez néanmoins toujours définir la conservation dans vos paramètres de diagnostic sur 0. Pour plus d’informations, consultez la section Portail Azure ci-dessus.

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

L’exemple de fichier de définition de stratégie ci-dessous définit la conservation de tous les objets blob dans le conteneur insights-activity-logs pour l’ID d’abonnement donné. Pour plus d’informations, consultez Définition d’une stratégie de gestion du cycle de vie.

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

Modèles

Appliquez le modèle suivant pour créer une stratégie de gestion du cycle de vie. Vous devez néanmoins toujours définir la conservation dans vos paramètres de diagnostic sur 0. Pour plus d’informations, consultez la section Portail Azure ci-dessus.

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

Le modèle suivant définit la conservation pour le compte de stockage azmonstorageaccount001 pour tous les objets blob du conteneur insights-activity-logs pour toutes les ressources, pour l’ID d’abonnement 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"
                                    ]
                                }
                            }
                        }
                    ]
                }
            }
        }
    ]
}

Étapes suivantes

Configurer une stratégie de gestion de cycle de vie