你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

从诊断设置存储保留迁移到 Azure 存储生命周期管理

诊断设置存储保留功能即将弃用。 要配置发送到 Azure 存储帐户的日志和指标的保留期，请使用 Azure 存储生命周期管理。

本指南指导你从使用 Azure 诊断设置存储保留迁移到使用 Azure 存储生命周期管理进行保留。 对于发送到 Log Analytics 工作区的日志，会在工作区的“表”页上为每个表设置保留期。 有关 Log Analytics 工作区保留的详细信息，请参阅 Azure Monitor 日志功能中的数据保留和存档。

重要

弃用时间线。

• 2023 年 3 月 31 日 - 诊断设置存储保留功能将不再可用于为日志数据配置新的保留规则。 这包括使用门户、CLI PowerShell 以及 ARM 和 Bicep 模板。 即使已配置保留设置，也仍然可以在门户中查看和更改它们。
• 2024 年 3 月 31 日 - 无法再使用 API（CLI、Powershell 或模板）或 Azure 门户来配置保留设置，除非将其更改为 0。 仍需遵守现有的保留规则。
• 2025 年 9 月 30 日 - 将在所有环境中禁用诊断设置存储保留功能的所有保留功能。

先决条件

记录到存储帐户的现有诊断设置。

迁移过程

Azure 门户

若要迁移诊断设置保留规则，请执行以下步骤：

1. 转到日志记录资源的“诊断设置”页，找到要迁移的诊断设置

2. 将记录类别的保留期设置为“0”

3. 选择“保存”

4. 导航到要登录到的存储帐户

5. 在“数据管理”下，选择“生命周期管理”以查看或更改生命周期管理策略

6. 选择“列表视图”，然后选择“添加规则”

7. 输入“规则名称”

8. 在“规则范围”下，选择“使用筛选器限制 blob”

9. 在“Blob 类型”下，选择“追加 Blob”。在“Blob 子类型”下，选择“基本 Blob”。

10. 选择“下一步”

11. 设置保留时间，然后选择“下一步”

12. 在“筛选器”选项卡的“Blob 前缀”下，设置你希望应用保留规则的容器或日志的路径或前缀。 路径或前缀可以是容器中的任何级别，并将应用于该路径或前缀下的所有 blob。 例如，对于所有见解活动日志，请使用容器insights-activity-logs来设置该容器日志中所有日志的保留期。
    若要为特定 Web 应用设置规则，请使用 insights-activity-logs/ResourceId=/SUBSCRIPTIONS/<your subscription Id>/RESOURCEGROUPS/<your resource group>/PROVIDERS/MICROSOFT.WEB/SITES/</PROVIDERS/MICROSOFT.WEB/SITES/>。

    可使用存储浏览器帮助查找路径或前缀。
    以下示例显示了特定 Web 应用的前缀：*insights-activity-logs/ResourceId=/SUBSCRIPTIONS/d05145d-4a5d-4a5d-4a5d-5267eae1bbc7/RESOURCEGROUPS/rg-001/PROVIDERS/MICROSOFT.WEB/SITES/appfromdocker1。
    若要为资源组中的所有资源设置规则，请使用 insights-activity-logs/ResourceId=/SUBSCRIPTIONS/d05145d-4a5d-4a5d-4a5d-5267eae1bbc7/RESOURCEGROUPS/rg-001。

13. 选择“添加”以保存规则。

CLI

使用 az storage account management-policy create 命令创建生命周期管理策略。 你仍必须将诊断设置中的保留期设置为 0。 有关详细信息，请参阅上面的 Azure 门户部分。

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

下面的示例策略定义文件为给定订阅 ID 设置容器 insights-activity-logs 中所有 blob 的保留期。 有关详细信息，请参阅生命周期管理策略定义。

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

模板

应用以下模板来创建生命周期管理策略。 你仍必须将诊断设置中的保留期设置为 0。 有关详细信息，请参阅上面的 Azure 门户部分。

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

以下模板为订阅 ID ABCD1234-5849-ABCD-1234-9876543210AB 的所有资源设置容器 insights-activity-logs 中所有 blob 的存储帐户 azmonstorageaccount001 的保留期。

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

后续步骤

配置生命周期管理策略。