Share via

クイック スタート: Bicep ファイルを使用してサービス通知のアクティビティ ログ アラートを作成する

  • [アーティクル]

この記事では、Bicep ファイルを使用してサービスの正常性通知を行うアクティビティ ログ アラートを設定する方法について説明します。

Bicep は、宣言型の構文を使用して Azure リソースをデプロイするドメイン固有言語 (DSL) です。 簡潔な構文、信頼性の高いタイプ セーフ、およびコードの再利用のサポートが提供されます。 Bicep により、Azure のコード ソリューションとしてのインフラストラクチャに最適な作成エクスペリエンスが実現します。

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

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

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

注意

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

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

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

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

前提条件

Bicep ファイルを確認する

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

param actionGroups_name string = 'SubHealth'
param activityLogAlerts_name string = 'ServiceHealthActivityLogAlert'
param emailAddress string

var alertScope = '/subscriptions/${subscription().subscriptionId}'

resource actionGroups_name_resource 'microsoft.insights/actionGroups@2019-06-01' = {
  name: actionGroups_name
  location: 'Global'
  properties: {
    groupShortName: actionGroups_name
    enabled: true
    emailReceivers: [
      {
        name: actionGroups_name
        emailAddress: emailAddress
      }
    ]
    smsReceivers: []
    webhookReceivers: []
  }
}

resource activityLogAlerts_name_resource 'microsoft.insights/activityLogAlerts@2017-04-01' = {
  name: activityLogAlerts_name
  location: 'Global'
  properties: {
    scopes: [
      alertScope
    ]
    condition: {
      allOf: [
        {
          field: 'category'
          equals: 'ServiceHealth'
        }
        {
          field: 'properties.incidentType'
          equals: 'Incident'
        }
      ]
    }
    actions: {
      actionGroups: [
        {
          actionGroupId: actionGroups_name_resource.id
          webhookProperties: {}
        }
      ]
    }
    enabled: true
  }
}

Bicep ファイルを使用して、次の 2 つのリソースを定義します。

Bicep ファイルをデプロイする

Azure CLI や Azure PowerShell を使用して Bicep ファイルをデプロイします。 リソース グループと emailAddress のサンプルの値を、ご利用の環境に適した値に置き換えます。

az login
az deployment group create --name CreateServiceHealthAlert --resource-group my-resource-group --template-file CreateServiceHealthAlert.bicep --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

次のステップ