Resource Manager テンプレートを使用して Resource Health アラートを構成する

[アーティクル]
10/31/2024

この記事では、Azure Resource Manager テンプレートと Azure PowerShell を使用して、Resource Health アクティビティログアラートをプログラムで作成する方法を示します。

Azure Resource Health では、Azure リソースの現在および過去の正常性状態に関する情報が持続的に通知されます。 Azure Resource Health アラートでは、これらのリソースの正常性状態が変化すると、ほぼリアルタイムで通知できます。 Resource Health アラートをプログラムで作成すると、ユーザーは通知を一括で作成およびカスタマイズできます。

注意

Azure を操作するには、Azure Az PowerShell モジュールを使用することをお勧めします。作業を始めるには、「Azure PowerShell をインストールする」を参照してください。 Az PowerShell モジュールに移行する方法については、「AzureRM から Az への Azure PowerShell の移行」を参照してください。

前提条件

このページの指示に従うには、事前にいくつかの項目を設定する必要があります。

Azure PowerShell モジュールをインストールします。
通知を行うよう構成されたアクショングループを作成または再利用します。

手順

PowerShell を使用し、アカウントを使用して Azure にログインし、操作するサブスクリプションを選択します。
```
Login-AzAccount
Select-AzSubscription -Subscription <subscriptionId>
```
Note

Get-AzSubscription を使用すると、アクセスできるサブスクリプションを一覧表示できます。
アクショングループの完全な Azure Resource Manager ID を検索して保存します。
```
(Get-AzActionGroup -ResourceGroupName <resourceGroup> -Name <actionGroup>).Id
```
Resource Health アラート用の Resource Manager テンプレートを作成し、resourcehealthalert.json として保存します。Resource Health アラートの Resource Manager テンプレートオプションを参照してください。

このテンプレートを使用して、新しい Azure Resource Manager デプロイを作成します。

New-AzResourceGroupDeployment -Name ExampleDeployment -ResourceGroupName <resourceGroup> -TemplateFile <path\to\resourcehealthalert.json>

アラート名と、先ほどコピーしたアクショングループのリソース ID の入力を求めるメッセージが表示されます。

Supply values for the following parameters:
(Type !? for Help.)
activityLogAlertName: <Alert Name>
actionGroupResourceId: /subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/microsoft.insights/actionGroups/<actionGroup>

すべてが正常に動作すると、PowerShell に確認メッセージが表示されます。

DeploymentName          : ExampleDeployment
ResourceGroupName       : <resourceGroup>
ProvisioningState       : Succeeded
Timestamp               : 11/8/2017 2:32:00 AM
Mode                    : Incremental
TemplateLink            :
Parameters              :
                        Name                     Type       Value
                        ===============          =========  ==========
                        activityLogAlertName     String     <Alert Name>
                        activityLogAlertEnabled  Bool       True
                        actionGroupResourceId    String     /...

Outputs                 :
DeploymentDebugLogLevel :

このプロセスを完全に自動化する場合は、手順 5 で値を求めるメッセージが表示されないように、Resource Manager テンプレートを編集します。

Resource Health アラートの Resource Manager テンプレートオプション

Resource Health アラートを作成するための開始点として、この基本テンプレートを使用できます。このテンプレートは記述どおりに動作し、ユーザーはサインアップして、サブスクリプション内のすべてのリソースにわたり、新しくアクティブになったすべてのリソース正常性イベントに関するアラートを受信できます。

Note

また、この記事の最後に、このテンプレートと比較して Resource Health アラートの信号雑音比率が大きくなる、より複雑な警告テンプレートも示されています。

{
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "activityLogAlertName": {
      "type": "string",
      "metadata": {
        "description": "Unique name (within the Resource Group) for the Activity log alert."
      }
    },
    "actionGroupResourceId": {
      "type": "string",
      "metadata": {
        "description": "Resource Id for the Action group."
      }
    }
  },
  "resources": [   
    {
      "type": "Microsoft.Insights/activityLogAlerts",
      "apiVersion": "2017-04-01",
      "name": "[parameters('activityLogAlertName')]",      
      "location": "Global",
      "properties": {
        "enabled": true,
        "scopes": [
            "[subscription().id]"
        ],        
        "condition": {
          "allOf": [
            {
              "field": "category",
              "equals": "ResourceHealth"
            },
            {
              "field": "status",
              "equals": "Active"
            }
          ]
        },
        "actions": {
          "actionGroups":
          [
            {
              "actionGroupId": "[parameters('actionGroupResourceId')]"
            }
          ]
        }
      }
    }
  ]
}

ただし、このような広範なアラートは一般的に推奨されません。次のセクションでは、このアラートの範囲を設定して、関心があるイベントに焦点を当てる方法について説明します。

アラートスコープの調整

Resource Health アラートは、次の 3 つの異なるスコープでイベントを監視するよう構成できます。

サブスクリプションレベル
リソースグループレベル
リソースレベル

アラートテンプレートはサブスクリプションレベルで構成されますが、特定のリソース、または特定のリソースグループ内のリソースに関してのみ通知を行うようアラートを構成する場合は、このテンプレートの scopes セクションを変更するだけです。

リソースグループレベルのスコープの場合、scopes セクションは次のようになります。

"scopes": [
    "/subscriptions/<subscription id>/resourcegroups/<resource group>"
],

一方、リソースレベルのスコープの場合、scopes セクションは次のようになります。

"scopes": [
    "/subscriptions/<subscription id>/resourcegroups/<resource group>/providers/<resource>"
],

例: "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/myRG/providers/microsoft.compute/virtualmachines/myVm"

Note

Azure portal に移動し、Azure リソースを表示しているときに URL を確認して、この文字列を取得できます。

アラートを生成するリソースの種類の調整

サブスクリプションまたはリソースグループレベルのアラートには、異なる種類のリソースが含まれる場合があります。リソースの種類の特定のサブセットからのみ生成されるようアラートを制限する場合は、次のように、テンプレートの condition セクションで定義できます。

"condition": {
    "allOf": [
        ...,
        {
            "anyOf": [
                {
                    "field": "resourceType",
                    "equals": "MICROSOFT.COMPUTE/VIRTUALMACHINES",
                    "containsAny": null
                },
                {
                    "field": "resourceType",
                    "equals": "MICROSOFT.STORAGE/STORAGEACCOUNTS",
                    "containsAny": null
                },
                ...
            ]
        }
    ]
},

ここでは、anyOf ラッパーを使用して、指定したいずれかの条件と一致する Resource Health アラートを定義し、アラートが特定のリソースの種類をターゲットにできるようにします。

アラートを生成する Resource Health イベントの調整

リソースで正常性イベントが発生すると、正常性イベントの状態を表す一連の段階: Active、In Progress、Updated、および Resolved を経由する可能性があります。

リソースが異常になった場合にのみ通知を受け取るには、status が Active の際にのみ通知するようアラートを構成する必要があります。一方、その他の段階でも通知を受け取るには、次のような詳細情報を追加します。

"condition": {
    "allOf": [
        ...,
        {
            "anyOf": [
                {
                    "field": "status",
                    "equals": "Active"
                },
                {
                    "field": "status",
                    "equals": "In Progress"
                },
                {
                    "field": "status",
                    "equals": "Resolved"
                },
                {
                    "field": "status",
                    "equals": "Updated"
                }
            ]
        }
    ]
}

正常性イベントの 4 つすべての段階で通知を受け取るには、この条件をすべて削除して、status プロパティとは関係なくアラートが生成されるようにします。

Note

各 "anyOf" セクションには、フィールド型の値を 1 つだけ含める必要があります。

"Unknown" イベントを回避するための Resource Health アラートの調整

Azure Resource Health では、テストランナーを使用してリソースを持続的に監視することで、リソースの最新の正常性をレポートできます。レポートされる関連する正常性状態は Available、Unavailable、Degraded です。ただし、ランナーと Azure リソースが通信できない場合、リソースに関して Unknown 状態がレポートされ、"Active" 正常性イベントと見なされます。

しかし、リソースで Unknown がレポートされた場合、その正常性状態は前回の正確なレポートから変化していない可能性があります。 Unknown イベントに関するアラートを生成しない場合は、テンプレートで次のロジックを指定します。

"condition": {
    "allOf": [
        ...,
        {
            "anyOf": [
                {
                    "field": "properties.currentHealthStatus",
                    "equals": "Available",
                    "containsAny": null
                },
                {
                    "field": "properties.currentHealthStatus",
                    "equals": "Unavailable",
                    "containsAny": null
                },
                {
                    "field": "properties.currentHealthStatus",
                    "equals": "Degraded",
                    "containsAny": null
                }
            ]
        },
        {
            "anyOf": [
                {
                    "field": "properties.previousHealthStatus",
                    "equals": "Available",
                    "containsAny": null
                },
                {
                    "field": "properties.previousHealthStatus",
                    "equals": "Unavailable",
                    "containsAny": null
                },
                {
                    "field": "properties.previousHealthStatus",
                    "equals": "Degraded",
                    "containsAny": null
                }
            ]
        },
    ]
},

この例では、現在および以前の正常性状態が Unknown でないイベントのみを通知します。この変更は、アラートが携帯電話または電子メールに直接送信される場合に役立つ可能性があります。

一部のイベントでは、currentHealthStatus プロパティと previousHealthStatus プロパティが null になる可能性があります。たとえば Updated イベントが発生する場合、リソースの正常性の状態は最後のレポートから変化しておらず、イベント情報がさらに利用できるようになった (cause など) だけの可能性があります。したがって、この例の句を使用すると、properties.currentHealthStatus と properties.previousHealthStatus の値が null に設定されているため、一部のアラートがトリガーされない可能性があります。

ユーザーが開始したイベントを回避するためのアラートの調整

Resource Health イベントは、プラットフォームまたはユーザーによって開始されたイベントによってトリガーできます。正常性イベントが Azure プラットフォームに由来する場合にのみ通知を送信することは、理に適っています。

このような種類のイベントのみをフィルター処理するようアラートを構成することは簡単です。

"condition": {
    "allOf": [
        ...,
        {
            "field": "properties.cause",
            "equals": "PlatformInitiated",
            "containsAny": null
        }
    ]
}

イベントによっては、cause フィールドが null 値になっていることがあります。つまり、正常性の遷移 (available から unavailable など) が起こり、通知の遅延を避けるためにイベントがすぐにログに記録されます。そのため、この例の句を使用すると、properties.cause プロパティ値が null に設定されるため、アラートはトリガーされないことがあります。

完全な Resource Health アラートテンプレート

前のセクションで説明した調整を使用した、信号雑音比率が最大になるよう構成されたサンプルテンプレートを次に示します。イベントによっては、currentHealthStatus、previousHealthStatus、cause プロパティ値が null の場合があるという前述の注意を念頭に置いてください。

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "activityLogAlertName": {
            "type": "string",
            "metadata": {
                "description": "Unique name (within the Resource Group) for the Activity log alert."
            }
        },
        "actionGroupResourceId": {
            "type": "string",
            "metadata": {
                "description": "Resource Id for the Action group."
            }
        }
    },
    "resources": [
        {
            "type": "Microsoft.Insights/activityLogAlerts",
            "apiVersion": "2017-04-01",
            "name": "[parameters('activityLogAlertName')]",
            "location": "Global",
            "properties": {
                "enabled": true,
                "scopes": [
                    "[subscription().id]"
                ],
                "condition": {
                    "allOf": [
                        {
                            "field": "category",
                            "equals": "ResourceHealth",
                            "containsAny": null
                        },
                        {
                            "anyOf": [
                                {
                                    "field": "properties.currentHealthStatus",
                                    "equals": "Available",
                                    "containsAny": null
                                },
                                {
                                    "field": "properties.currentHealthStatus",
                                    "equals": "Unavailable",
                                    "containsAny": null
                                },
                                {
                                    "field": "properties.currentHealthStatus",
                                    "equals": "Degraded",
                                    "containsAny": null
                                }
                            ]
                        },
                        {
                            "anyOf": [
                                {
                                    "field": "properties.previousHealthStatus",
                                    "equals": "Available",
                                    "containsAny": null
                                },
                                {
                                    "field": "properties.previousHealthStatus",
                                    "equals": "Unavailable",
                                    "containsAny": null
                                },
                                {
                                    "field": "properties.previousHealthStatus",
                                    "equals": "Degraded",
                                    "containsAny": null
                                }
                            ]
                        },
                        {
                            "anyOf": [
                                {
                                    "field": "properties.cause",
                                    "equals": "PlatformInitiated",
                                    "containsAny": null
                                }
                            ]
                        },
                        {
                            "anyOf": [
                                {
                                    "field": "status",
                                    "equals": "Active",
                                    "containsAny": null
                                },
                                {
                                    "field": "status",
                                    "equals": "Resolved",
                                    "containsAny": null
                                },
                                {
                                    "field": "status",
                                    "equals": "In Progress",
                                    "containsAny": null
                                },
                                {
                                    "field": "status",
                                    "equals": "Updated",
                                    "containsAny": null
                                }
                            ]
                        }
                    ]
                },
                "actions": {
                    "actionGroups": [
                        {
                            "actionGroupId": "[parameters('actionGroupResourceId')]"
                        }
                    ]
                }
            }
        }
    ]
}

しかし、自分にとってどの構成が効果的かに基づいて、ドキュメントで学習したツールを使用して独自のカスタマイズを行ってください。

次のステップ

Resource Health に関する詳細情報を参照してください。

Service Health アラートを作成します。

次の方法で共有

Resource Manager テンプレートを使用して Resource Health アラートを構成する

前提条件

手順

Resource Health アラートの Resource Manager テンプレートオプション

アラートスコープの調整

アラートを生成するリソースの種類の調整

アラートを生成する Resource Health イベントの調整

"Unknown" イベントを回避するための Resource Health アラートの調整

ユーザーが開始したイベントを回避するためのアラートの調整

完全な Resource Health アラートテンプレート

次のステップ

フィードバック

その他のリソース

次の方法で共有

Resource Manager テンプレートを使用して Resource Health アラートを構成する

前提条件

手順

Resource Health アラートの Resource Manager テンプレート オプション

アラート スコープの調整

アラートを生成するリソースの種類の調整

アラートを生成する Resource Health イベントの調整

"Unknown" イベントを回避するための Resource Health アラートの調整

ユーザーが開始したイベントを回避するためのアラートの調整

完全な Resource Health アラート テンプレート

次のステップ

フィードバック

その他のリソース

Resource Health アラートの Resource Manager テンプレートオプション

アラートスコープの調整

完全な Resource Health アラートテンプレート