クイック スタート:ARM テンプレートを使用してサービス通知のアクティビティ ログ アラートを作成する

  • [アーティクル]

この記事では、Azure Resource Manager テンプレート (ARM テンプレート) を使用して、サービスの正常性通知のアクティビティ ログ アラートを設定する方法を示します。

Azure Resource Manager テンプレートは JavaScript Object Notation (JSON) ファイルであり、プロジェクトのインフラストラクチャと構成が定義されています。 このテンプレートでは、宣言型の構文が使用されています。 デプロイしようとしているものを、デプロイを作成する一連のプログラミング コマンドを記述しなくても記述できます。

サービス正常性通知は、Azure アクティビティ ログに格納されます。 アクティビティ ログに大量の情報が格納されている可能性を考慮し、サービス正常性通知に関するアラートを表示および設定しやすくするための個別のユーザー インターフェイスがあります。

Azure でサービス正常性通知を Azure サブスクリプションに送信するときに、アラートを受け取ることができます。 次の情報に基づくアラートを構成できます。

  • サービス正常性通知のクラス (サービスに関する問題、計画済みメンテナンス、正常性の勧告)。
  • 影響を受けたサブスクリプション。
  • 影響を受けたサービス。
  • 影響を受けたリージョン。

注意

サービス正常性通知では、リソース正常性イベントに関するアラートは送信されません。

次の方法でアラートを送信するユーザーを構成することもできます。

  • 既存のアクション グループを選択します。
  • 新しいアクション グループを作成します (将来のアラートで使用できます)。

アクション グループの詳細については、アクション グループの作成および管理に関するページを参照してください。

前提条件

テンプレートを確認する

次のテンプレートでは、電子メール ターゲットを使用してアクション グループを作成し、ターゲット サブスクリプションのすべてのサービス正常性通知を有効にします。 このテンプレートを CreateServiceHealthAlert.json として保存します。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "actionGroups_name": {
      "type": "string",
      "defaultValue": "SubHealth"
    },
    "activityLogAlerts_name": {
      "type": "string",
      "defaultValue": "ServiceHealthActivityLogAlert"
    },
    "emailAddress": {
      "type": "string"
    }
  },
  "variables": {
    "alertScope": "[format('/subscriptions/{0}', subscription().subscriptionId)]"
  },
  "resources": [
    {
      "type": "microsoft.insights/actionGroups",
      "apiVersion": "2019-06-01",
      "name": "[parameters('actionGroups_name')]",
      "location": "Global",
      "properties": {
        "groupShortName": "[parameters('actionGroups_name')]",
        "enabled": true,
        "emailReceivers": [
          {
            "name": "[parameters('actionGroups_name')]",
            "emailAddress": "[parameters('emailAddress')]"
          }
        ],
        "smsReceivers": [],
        "webhookReceivers": []
      }
    },
    {
      "type": "microsoft.insights/activityLogAlerts",
      "apiVersion": "2017-04-01",
      "name": "[parameters('activityLogAlerts_name')]",
      "location": "Global",
      "properties": {
        "scopes": [
          "[variables('alertScope')]"
        ],
        "condition": {
          "allOf": [
            {
              "field": "category",
              "equals": "ServiceHealth"
            },
            {
              "field": "properties.incidentType",
              "equals": "Incident"
            }
          ]
        },
        "actions": {
          "actionGroups": [
            {
              "actionGroupId": "[resourceId('microsoft.insights/actionGroups', parameters('actionGroups_name'))]",
              "webhookProperties": {}
            }
          ]
        },
        "enabled": true
      },
      "dependsOn": [
        "[resourceId('microsoft.insights/actionGroups', parameters('actionGroups_name'))]"
      ]
    }
  ]
}

このテンプレートでは、次の 2 つのリソースが定義されます。

テンプレートのデプロイ

CLI と PowerShell を使用する次の例のような、ARM テンプレートをデプロイするための標準的な方法を使ってテンプレートをデプロイします。 リソース グループと emailAddress のサンプルの値を、ご利用の環境に適した値に置き換えます。

az login
az deployment group create --name CreateServiceHealthAlert --resource-group my-resource-group --template-file CreateServiceHealthAlert.json --parameters emailAddress='user@contoso.com'

デプロイの検証

次のコマンドのいずれかを使用して、ワークスペースが作成されたことを確認します。 リソース グループのサンプルの値を、先ほど使用した値に置き換えます。

az monitor activity-log alert show --resource-group my-resource-group --name ServiceHealthActivityLogAlert

リソースをクリーンアップする

後続のクイック スタートおよびチュートリアルを引き続き実行する場合は、これらのリソースをそのまま残しておくことができます。 不要になったら、リソース グループを削除します。これにより、アラート ルールと関連リソースが削除されます。 Azure CLI または Azure PowerShell を使用してリソース グループを削除するには、次を実行します。

az group delete --name my-resource-group

次のステップ