診断設定ストレージ保持から Azure Storage ライフサイクル管理に移行する

[アーティクル]
09/24/2024

診断設定ストレージの保持機能は非推奨となっています。 Azure Storage アカウントに送信されるログとメトリックの保持を構成するには、Azure Storage のライフサイクル管理を使用します。

このガイドでは、Azure 診断設定ストレージ保持の使用から、Azure Storage ライフサイクル管理を使用した保持に移行する手順について説明します。 Log Analytics ワークスペースに送信されるログの場合、ワークスペースの [テーブル] ページにあるテーブルごとに保持が設定されます。 Log Analytics ワークスペースのデータ保持の詳細については、Log Analytics ワークスペースでのデータ保持の管理に関するページを参照してください。

重要

非推奨のタイムライン。

2023 年 3 月 31 日 – 診断設定ストレージの保持機能は、ログデータの新しい保持規則を構成するために使用できなくなります。これには、ポータル、CLI PowerShell、および ARM と Bicep テンプレートの使用が含まれます。保持設定を構成した場合でも、ボータルでそれらを表示して変更することができます。
2025 年 9 月 30 日 – 診断設定ストレージの保持機能のすべての保持機能は、すべての環境で無効になります。

前提条件

ストレージアカウントに対する既存の診断設定ログ。

移行手順

次の CLI コマンドを使用して、リソースに診断設定があるかどうかを確認します。

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

この出力は、診断設定がストレージアカウントにデータを送信するかどうかを示します。この例を次に示します。

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

診断設定の保持規則を移行するには、次の手順のようにします。

ログリソースの [診断設定] ページに移動し、移行する診断設定を見つけます
ログされるカテゴリの保持期間を 0 に設定します
[保存] を選びます。
ログ先のストレージアカウントに移動します
[データ管理] で、[ライフサイクル管理] を選んでライフサイクル管理ポリシーを表示または変更します
リストビューを選び、[規則の追加] を選びます
[規則名] を入力します
[規則の範囲] で、[フィルターを使用して BLOB を制限する] を選びます
[BLOB の種類] で [Append Blobs] (追加 BLOB) を選び、[Blob subtype] (BLOB のサブタイプ) で [基本 BLOB] を選びます。
[次へ] を選びます
保持期間を設定して、[次へ] を選びます
[フィルター] タブの [BLOB プレフィックス] で、保持規則を適用するコンテナーまたはログへのパスまたはプレフィックスを設定します。パスまたはプレフィックスはコンテナー内の任意のレベルにすることができ、そのパスまたはプレフィックスの下にあるすべての BLOB に適用されます。たとえば、"すべての" 分析情報アクティビティログの場合は、コンテナー insights-activity-logs を使用して、保持をそのコンテナー内のすべてのログに対して設定します。
特定の webapp アプリのルールを設定するには、"insights-activity-logs/ResourceId=/SUBSCRIPTIONS/<サブスクリプション ID>/RESOURCEGROUPS/<リソースグループ>/PROVIDERS/MICROSOFT.WEB/SITES/<webapp 名>" を使用します。

パスまたはプレフィックスを見つけるためにストレージブラウザーを使用します。
次の例には、ある Web アプリ *insights-activity-logs/ResourceId=/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/rg-001/PROVIDERS/MICROSOFT.WEB/SITES/appfromdocker1 のプレフィックスが表示されています。
このリソースグループ内のすべてのリソースに対するルールを設定するには、insights-activity-logs/ResourceId=/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e7/RESOURCEGROUPS/rg-001 を使用します。
[追加] を選んで規則を保存します。

az storage account management-policy create コマンドを使用して、ライフサイクル管理ポリシーを作成します。診断設定のリテンション期間は、引き続き「0」に設定する必要があります。詳細については、Azure portal での移行の手順を参照してください。


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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
          ]
        }
      }
    }
  ]
}

ライフサイクル管理ポリシーを作成するには、次のテンプレートを適用します。診断設定のリテンション期間は、引き続き「0」に設定する必要があります。詳細については、Azure portal での移行の手順を参照してください。


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

次のテンプレートでは、ストレージアカウント azmonstorageaccount001 の保持を設定します。対象はコンテナー insights-activity-logs 内にある、サブスクリプション ID aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e のすべてのリソースのすべての BLOB です。

{
    "$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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
                                    ]
                                }
                            }
                        }
                    ]
                }
            }
        }
    ]
}

次のステップ

ライフサイクル管理ポリシーを構成する。

次の方法で共有

診断設定ストレージ保持から Azure Storage ライフサイクル管理に移行する

前提条件

移行手順

次のステップ

フィードバック

その他のリソース