Resource Health アラートを作成して構成する

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 つの異なるスコープでイベントを監視するよう構成できます。

• Subscription Level
• リソース グループ レベル
• Resource Level

アラート テンプレートはサブスクリプション レベルで構成されますが、特定のリソースまたは特定のリソース グループ内のリソースについてのみ通知するようにアラートを構成する場合は、表示されるテンプレートの 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"

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

サブスクリプションまたはリソース グループ レベルのアラートには、さまざまな種類のリソースを含めることができます。 アラートをリソースの種類の特定のサブセットからのみ取得するように制限する場合は、テンプレートの 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 プロパティとは関係なくアラートが生成されるようにします。

"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 イベントが発生した場合、リソースの正常性状態は前回のレポート以降と同じである可能性があります。 その他のイベント情報のみが使用できます (原因など)。 したがって、この句を使用すると、 properties.currentHealthStatus と properties.previousHealthStatus の値が null に設定されているため、一部のアラートがトリガーされない可能性があります。

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

Resource Health イベントは、プラットフォームによって開始されたイベントとユーザーが開始したイベントによってトリガーされます。 ノイズを減らすには、多くの場合、Azure プラットフォームによって発生するイベントに対してのみ通知を送信することをお勧めします。

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

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

一部のイベントでは、原因フィールドが null になる可能性があります。 たとえば、正常性が「使用可能」から「使用不可」に遷移した場合、通知の遅延を防ぐためにそのイベントが即座にログに記録されます。 したがって、この句を使用すると、 properties.cause プロパティの値が null に設定されているため、アラートがトリガーされない可能性があります。

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

前のセクションで説明したさまざまな調整を使用する場合は、信号対ノイズ比を最大化するように構成されたサンプル テンプレートを次に示します。 一部のイベントでは、 currentHealthStatus、 previousHealthStatus、および原因プロパティの値が 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')]"
                        }
                    ]
                }
            }
        }
    ]
}

ARM テンプレートの JSON ファイル パラメーターのサンプル

"parameters":
{
  "activityLogAlertName": { "value": "my-resource-health-alert" },
  "actionGroupResourceId": { "value": "/subscriptions/.../actionGroups/..." }
}

"Command":

New-AzResourceGroupDeployment -ResourceGroupName name

• TemplateFile resourcehealthalert.json
• TemplateParameterFile parameters.json

どの構成が効果的かを把握しているため、このドキュメントに示されているツールを使用して独自のカスタマイズを行います。