Logic Apps を使用してアラート通知をカスタマイズする

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

この記事では、ロジックアプリを作成し、Azure Monitor アラートと統合する方法について説明します。

Azure Logic Apps を使用すると、統合のためにワークフローをビルドおよびカスタマイズできます。 Logic Apps を使用してアラート通知をカスタマイズします。次のようにすることができます。

独自のメールの件名と本文の形式を使用して、アラートメールをカスタマイズします。
影響を受けるリソースのタグを検索するか、ログクエリ検索結果をフェッチして、アラートメタデータをカスタマイズします。アラートデータを含む検索結果行にアクセスする方法については、以下を参照してください。
- Azure Monitor Log Analytics API の応答形式
- クエリ/管理の HTTP 応答
Outlook、Microsoft Teams、Slack、PagerDuty などの既存のコネクタを使用して、外部サービスと統合します。独自のサービス用にロジックアプリを構成することもできます。

この例では、一般的なアラートスキーマを使用してアラートから詳細を送信するロジックアプリを作成します。

ロジックアプリを作成します

Azure portal で、新しいロジックアプリを作成します。ページの上部にある検索バーに、「ロジックアプリ」と入力します。
[ロジックアプリ] ページで、[追加] を選択します。
ロジックアプリ用のサブスクリプションとリソースグループを選択します。
[ロジックアプリ名] を設定します。 [プランの種類] で [従量課金] を選択します。
[確認と作成]>[作成] の順に選択します。
デプロイが完了したら、[リソースに移動] を選びます。
[Logic Apps デザイナー] ページで、[HTTP 要求の受信時] を選択します。

次の JSON から共通アラートスキーマを [要求本文の JSON スキーマ] フィールドに貼り付けます。

 {
    "type": "object",
    "properties": {
        "schemaId": {
            "type": "string"
        },
        "data": {
            "type": "object",
            "properties": {
                "essentials": {
                    "type": "object",
                    "properties": {
                        "alertId": {
                            "type": "string"
                        },
                        "alertRule": {
                            "type": "string"
                        },
                        "severity": {
                            "type": "string"
                        },
                        "signalType": {
                            "type": "string"
                        },
                        "monitorCondition": {
                            "type": "string"
                        },
                        "monitoringService": {
                            "type": "string"
                        },
                        "alertTargetIDs": {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        },
                        "originAlertId": {
                            "type": "string"
                        },
                        "firedDateTime": {
                            "type": "string"
                        },
                        "resolvedDateTime": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "essentialsVersion": {
                            "type": "string"
                        },
                        "alertContextVersion": {
                            "type": "string"
                        }
                    }
                },
                "alertContext": {
                    "type": "object",
                    "properties": {}
                }
            }
        }
    }
}

[HTTP 要求の受信時] ペインの [パラメーター] タブを示すスクリーンショット。

(省略可能)。アラート通知をカスタマイズするには、アラートが発生した、影響を受けているリソース (リソースのタグなど) に関する情報を抽出します。その後、これらのリソースタグをアラートペイロードに含め、通知を送信するための論理式で情報を使用できます。この手順を実行するには、次のことを行います。

影響を受けるリソース ID の変数を作成します。
さまざまな要素 (サブスクリプション、リソースグループなど) を使用できるように、リソース ID を配列に分割します。
Azure Resource Manager コネクタを使用して、リソースのメタデータを読み取ります。
リソースのタグをフェッチします。このタグは、ロジックアプリの後続の手順で使用できます。

[+]>[アクションの追加] の順に選んで、新しいステップを挿入します。
[検索] フィールドで検索し、[変数の初期化] を選択します。
[名前] フィールドに、変数の名前 (AffectedResources など) を入力します。
[種類] フィールドで、[配列] を選択します。
[値] フィールドで、[動的コンテンツの追加] を選択します。 [式] タブを選択し、文字列 split(triggerBody()?['data']?['essentials']?['alertTargetIDs'][0], '/') を入力します。
[+]>[アクションの追加] の順に選んで、別のステップを挿入します。
[検索] フィールドで、Azure Resource Manager を検索して選択し、[リソースの読み取り] を選択します。

[リソースの読み取り] アクションのフィールドに、AffectedResource 変数の配列値を設定します。各フィールドで、フィールド内を選択し、下にスクロールしてカスタム値を入力します。 [動的コンテンツの追加] を選択し、次に [式] タブを選択します。次の表の文字列を入力します。

フィールド	文字列値
サブスクリプション	`variables('AffectedResource')[2]`
リソースグループ	`variables('AffectedResource')[4]`
リソースプロバイダー	`variables('AffectedResource')[6]`
短いリソース ID	`concat(variables('AffectedResource')[7], '/', variables('AffectedResource')[8]`)
クライアント API バージョン	リソースの種類の API バージョン

リソースの種類の API バージョンを見つけるには、リソースの概要ページの右上にある [JSON ビュー] リンクを選びます。 [リソース JSON] ページが開き、ページの上部に [ResourceID] と [API バージョン] が表示されます。

動的コンテンツには、影響を受けたリソースのタグが含まれるようになりました。これらのタグは、次の手順で説明するように通知を構成するときに使用できます。

メールを送信するか、Teams メッセージを投稿します。
[+]>[アクションの追加] の順に選んで、新しいステップを挿入します。

電子メールを送信する
Teams のメッセージを投稿する

検索フィールドで Outlook を検索します。
[Office 365 Outlook] を選択します。
[アクション] の一覧で、[メールの送信 (V2)] を選択します。
接続の作成を求めるメッセージが表示されたら、Office 365 にサインインします。
静的テキストを入力し、[動的コンテンツ] 一覧からフィールドを選択してアラートペイロードから取得したコンテンツを含めることで、メールの本文を作成します。次に例を示します。
- アラートに監視条件あり:[動的コンテンツ] 一覧から [monitorCondition] を選択します。
- 発生日:[動的コンテンツ] 一覧から [firedDateTime] を選択します。
- 影響を受けるリソース:[動的コンテンツ] 一覧から [alterTargetIDs] を選択します。
静的テキストを入力し、[動的コンテンツ] 一覧からフィールドを選択してアラートペイロードから取得したコンテンツを含めることで、[件名] フィールドに件名のテキストを作成します。次に例を示します。
- アラート:[動的コンテンツ] 一覧から [alertRule] を選択します。
- 重大度:[動的コンテンツ] 一覧から [severity] を選択します。
- 条件あり:[動的コンテンツ] 一覧から [monitorCondition] を選択します。
[宛先] フィールドにアラートの送信先のメールアドレスを入力します。
[保存] を選択します。

指定したアドレスにメールを送信するロジックアプリを作成し、それをトリガーしたアラートの詳細を指定しました。

次の手順では、ロジックアプリをトリガーするアクショングループを作成します。

アクショングループを作成する

ロジックアプリをトリガーするには、アクショングループを作成します。次に、そのアクショングループを使用するアラートを作成します。

[Azure Monitor] ページに移動し、左側のペインから [アラート] を選択します。
[アクショングループ]>[作成] を選択します。
[サブスクリプション]、[リソースグループ]、[リージョン] の値を選択します。
[アクショングループ名] と [表示名] に名前を入力します。
[Actions](アクション) タブを選択します。
[アクションの種類] の [アクション] タブで、[ロジックアプリ] を選択します。
[ロジックアプリ] セクションで、ドロップダウンからロジックアプリを選択します。
[共通アラートスキーマを有効にする] に [はい] を設定します。 [いいえ] を選択すると、使用するアラートスキーマがアラートの種類によって決まります。アラートスキーマの詳細については、コンテキスト固有のアラートスキーマに関する記事を参照してください。
[OK] を選択します。
[名前] フィールドに名前を入力します。
[確認と作成]>[作成] の順に選択します。