ARMS Alert Management から EventBridge イベントバスへのアラートイベントのルーティング方法 - Application Real-Time Monitoring Service

ARMS Alert Management を使用すると、アラート作成、アラートの担当者割り当て（claim）、アラートクローズなど、アラートライフサイクルにおけるステータス変更に関するイベントを、ご利用の EventBridge イベントバスにルーティングできます。これらのイベントを消費することで、サードパーティシステムとの連携による自動修復やチケットシステムとの統合が可能になります。本トピックでは、ARMS Alert Management から EventBridge イベントバスへのアラートイベントのルーティング方法について説明します。

背景情報

EventBridge は Alibaba Cloud が提供するサーバーレスのイベントバスサービスであり、Alibaba Cloud サービス、カスタムアプリケーション、SaaS アプリケーションを標準化された一元的な方法で接続できます。CloudEvents 1.0 プロトコルに基づき、これらのアプリケーション間でイベントをルーティングでき、疎結合で分散型のイベント駆動型アーキテクチャを構築するのに役立ちます。詳細については、「EventBridge とは」をご参照ください。

ステップ 1：EventBridge リソースの作成

EventBridge イベントバスを作成します。詳細については、「カスタムイベントバスの管理」をご参照ください。
イベントバスを作成後、イベントバス概要ページからパブリックエンドポイントを取得します。
カスタムアプリケーションタイプのイベントソースを追加します。詳細については、「カスタムイベントソースの管理」をご参照ください。
ダイアログボックスで名前（例：arms）と任意の説明を設定します。

ステップ 2：ARMS での EventBridge 統合の設定

ARMS コンソールにログインします。左側のナビゲーションウィンドウで、[アラート管理] > [統合] を選択します。
統合ページで、統合の通知タブをクリックし、次にEventBridgeをクリックします。

統合の追加ダイアログボックスで、以下のパラメーターを設定し、保存をクリックします。

パラメーター	説明
Name	統合のカスタム名（例：`EventBridge-integration`）。
Description	統合の任意の説明。
Endpoint	ステップ 1で取得したパブリックエンドポイント。
AccessKey	ご利用の Alibaba Cloud アカウントの AccessKey ID。詳細については、「AccessKey ペアの取得」をご参照ください。
AccessKey Secret	ご利用の Alibaba Cloud アカウントの AccessKey Secret。詳細については、「AccessKey ペアの取得」をご参照ください。
Message Bus Name	ステップ 1で作成したイベントバスの名前（例：`armstest`）。
regionId	ステップ 1で作成したイベントバスが配置されているリージョンの ID（例：`cn-hangzhou`）。
Event Source Name	ステップ 1で作成したイベントソースの名前（例：`arms`）。

ステップ 3：通知ポリシーの設定

通知ポリシーで、Ticket Systemを前ステップで作成した EventBridge 統合に設定します。詳細については、「通知ポリシー」をご参照ください。

ステップ 4：EventBridge コンソールでのアラートイベントの確認

EventBridge コンソールにログインしてアラートイベントを確認します。詳細については、「イベントの照会」をご参照ください。対象のイベントバスのイベントトレースページで、時間範囲で照会タブを選択し、ARMS から送信されたアラートイベントを確認します。イベントタイプには、aliyun:arms:alarm:create（アラート作成イベント）、aliyun:arms:alarm:claim（アラート担当者割り当てイベント）、aliyun:arms:alarm:comment（アラートコメントイベント）、およびaliyun:arms:alarm:close（アラートクローズイベント）が含まれます。イベントトレースまたはイベント詳細をクリックすると、詳細情報を確認できます。

イベントタイプコード	タイプ
aliyun:arms:alarm:create	アラート作成イベント
aliyun:arms:alarm:claim	アラートクレームイベント
aliyun:arms:alarm:comment	アラートコメントイベント
aliyun:arms:alarm:close	アラートクローズイベント

イベントの操作列で、イベント詳細をクリックしてパラメーターを確認します。以下のセクションに、各イベントタイプのペイロードフォーマットを示します。

アラート作成イベント

{
    "datacontenttype": "application/json",
    "aliyunaccountid": "11xxxxxxxxxxx",
    "data": {
        "owner": "xx",  // アラートのオーナー（通知ポリシーで設定された連絡先）
        "data": {        // アラートの内容。オープンソースの AlertManager イベントと互換性があります。詳細については、Prometheus 公式ドキュメント https://prometheus.io/docs/alerting/latest/configuration/#webhook_config をご参照ください。
            "alerts": [
                {
                    "fingerprint": "9b115ab3762a47b51a8efcb516d4aa50",
                    "annotations": {
                        "message": "手動でトリガーされたテストアラート"
                    },
                    "startsAt": "2022-06-07T09:22:01.645000000Z",
                    "endsAt": "2022-06-07T09:27:39.099000000Z",
                    "labels": {
                        "severity": "error",
                        "regionId": "cn-hangzhou",
                        "_aliyun_arms_denoise_code": "0",
                        "_aliyun_arms_integration_name": "Custom integration",
                        "alertname": "Manually triggered alert",
                        "_aliyun_arms_product_type": "CUSTOM",
                        "_aliyun_arms_userid": "11xxxxxxxxxxx",
                        "_aliyun_arms_integration_id": "616",
                        "_aliyun_arms_is_denoise_filtered": "false"
                    },
                    "status": "firing"
                }
            ],
            "commonLabels": {
                "severity": "error",
                "regionId": "cn-hangzhou",
                "_aliyun_arms_denoise_code": "0",
                "_aliyun_arms_integration_name": "Custom integration",
                "alertname": "Manually triggered alert",
                "_aliyun_arms_product_type": "CUSTOM",
                "_aliyun_arms_userid": "11xxxxxxxxxxx",
                "_aliyun_arms_integration_id": "616",
                "_aliyun_arms_is_denoise_filtered": "false"
            },
            "externalURL": "https://arms.console.aliyun.com/#/alarm/alert/detail/12345",
            "groupLabels": {
                "alertname": "Manually triggered alert"
            },
            "receiver": "",
            "level": "P2",
            "dispatchRuleName": "O&M team",
            "startTime": "2022-06-07 17:22:01",
            "commonAnnotations": {
                "message": "手動でトリガーされたテストアラート"
            },
            "status": "firing"
        },
        "timestamp": 1654593783951
    },
    "subject": "https://arms.console.aliyun.com/#/alarm/alert/detail/12345",   // アラートを特定するためのグローバルに一意な URL
    "aliyunoriginalaccountid": "11xxxxxxxxxxx",
    "source": "arms",
    "type": "aliyun:arms:alarm:create",
    "aliyunpublishtime": "2022-06-07T09:23:04.003Z",
    "specversion": "1.0",
    "aliyuneventbusname": "armstest",
    "id": "d997f8c775d4d15b05f3346d5863fdc6******_create",
    "aliyunregionid": "cn-hangzhou",
    "aliyunpublishaddr": "xx.xx.xx.xx"
}

アラートクレームイベント

{
    "datacontenttype": "application/json",
    "aliyunaccountid": "11xxxxxxxxxxx",
    "data": {
        "owner": "xx", // アラートのオーナー
        "handler": "xx", // アラートのハンドラ
        "data": { // アラートの内容。オープンソースの AlertManager イベントと互換性があります。詳細については、Prometheus 公式ドキュメント https://prometheus.io/docs/alerting/latest/configuration/#webhook_config をご参照ください。
            "alerts": [
                {
                    "fingerprint": "9b115ab3762a47b51a8efcb516d4aa50",
                    "annotations": {
                        "message": "手動でトリガーされたテストアラート"
                    },
                    "startsAt": "2022-06-07T09:20:43.780000000Z",
                    "endsAt": "2022-06-07T09:25:43.780000000Z",
                    "labels": {
                        "severity": "error",
                        "regionId": "cn-hangzhou",
                        "_aliyun_arms_denoise_code": "0",
                        "_aliyun_arms_integration_name": "Custom integration",
                        "alertname": "Manually triggered alert",
                        "_aliyun_arms_product_type": "CUSTOM",
                        "_aliyun_arms_userid": "11xxxxxxxxxxx",
                        "_aliyun_arms_integration_id": "616",
                        "_aliyun_arms_is_denoise_filtered": "false"
                    },
                    "status": "firing"
                }
            ],
            "commonLabels": {
                "severity": "error",
                "regionId": "cn-hangzhou",
                "_aliyun_arms_denoise_code": "0",
                "_aliyun_arms_integration_name": "Custom integration",
                "alertname": "Manually triggered alert",
                "_aliyun_arms_product_type": "CUSTOM",
                "_aliyun_arms_userid": "11xxxxxxxxxxx",
                "_aliyun_arms_integration_id": "616",
                "_aliyun_arms_is_denoise_filtered": "false"
            },
            "externalURL": "https://arms.console.aliyun.com/#/alarm/alert/detail/12345",
            "groupLabels": {
                "alertname": "Manually triggered alert"
            },
            "receiver": "",
            "level": "P2",
            "dispatchRuleName": "O&M team",
            "startTime": "2022-06-07 17:20:43",
            "commonAnnotations": {
                "message": "手動でトリガーされたテストアラート"
            },
            "status": "firing"
        },
        "operator": "xx", // オペレーター
        "timestamp": 1654593717195
    },
    "subject": "https://arms.console.aliyun.com/#/alarm/alert/detail/12345",
    "aliyunoriginalaccountid": "11xxxxxxxxxxx",
    "source": "arms",
    "type": "aliyun:arms:alarm:claim",
    "aliyunpublishtime": "2022-06-07T09:21:57.362Z",
    "specversion": "1.0",
    "aliyuneventbusname": "armstest",
    "id": "59e174db-f843-473a-9d3e-df3421******",
    "aliyunregionid": "cn-hangzhou",
    "aliyunpublishaddr": "118.31.XX.XX"
}

アラートコメントイベント

{
    "datacontenttype": "application/json",
    "aliyunaccountid": "11xxxxxxxxxxx",
    "data": {
        "owner": "xx", // アラートのオーナー
        "handler": "xx", // アラートのハンドラ
        "data": {  // アラートの内容。オープンソースの AlertManager イベントと互換性があります。詳細については、Prometheus 公式ドキュメント https://prometheus.io/docs/alerting/latest/configuration/#webhook_config をご参照ください。
            "alerts": [
                {
                    "fingerprint": "9b115ab3762a47b51a8efcb516d4aa50",
                    "annotations": {
                        "message": "手動でトリガーされたテストアラート"
                    },
                    "startsAt": "2022-06-07T09:20:44.000000000Z",
                    "endsAt": "2022-06-07T09:22:00.000000000Z",
                    "labels": {
                        "severity": "error",
                        "regionId": "cn-hangzhou",
                        "_aliyun_arms_denoise_code": "0",
                        "_aliyun_arms_integration_name": "Custom integration",
                        "alertname": "Manually triggered alert",
                        "_aliyun_arms_product_type": "CUSTOM",
                        "_aliyun_arms_userid": "11xxxxxxxxxxx",
                        "_aliyun_arms_integration_id": "616",
                        "_aliyun_arms_is_denoise_filtered": "false"
                    },
                    "status": "resolved"
                }
            ],
            "commonLabels": {
                "severity": "error",
                "regionId": "cn-hangzhou",
                "_aliyun_arms_denoise_code": "0",
                "_aliyun_arms_integration_name": "Custom integration",
                "alertname": "Manually triggered alert",
                "_aliyun_arms_product_type": "CUSTOM",
                "_aliyun_arms_userid": "11xxxxxxxxxxx",
                "_aliyun_arms_integration_id": "616",
                "_aliyun_arms_is_denoise_filtered": "false"
            },
            "externalURL": "https://arms.console.aliyun.com/#/alarm/alert/detail/12345",
            "groupLabels": {
                "alertname": "Manually triggered alert"
            },
            "receiver": "",
            "level": "P2",
            "dispatchRuleName": "O&M team",
            "startTime": "2022-06-07 17:20:44",
            "endTime": "2022-06-07 17:22:00",
            "commonAnnotations": {
                "message": "手動でトリガーされたテストアラート"
            },
            "status": "resolved"
        },
        "comment": "解決策：誤検知", // コメントの内容
        "operator": "xx", // オペレーター
        "timestamp": 1654593720385
    },
    "subject": "https://arms.console.aliyun.com/#/alarm/alert/detail/12345",
    "aliyunoriginalaccountid": "11xxxxxxxxxxx",
    "source": "arms",
    "type": "aliyun:arms:alarm:comment",
    "aliyunpublishtime": "2022-06-07T09:22:00.435Z",
    "specversion": "1.0",
    "aliyuneventbusname": "armstest",
    "id": "ef38ca1b-89cb-4c7c-9052-b73e15******",
    "aliyunregionid": "cn-hangzhou",
    "aliyunpublishaddr": "118.31.XX.XX"
}

アラートクローズイベント

{
    "datacontenttype": "application/json",
    "aliyunaccountid": "11xxxxxxxxxxx",
    "data": {
        "owner": "xx", // アラートのオーナー
        "handler": "xx",  // アラートのハンドラ
        "data": { // アラートの内容。オープンソースの AlertManager イベントと互換性があります。詳細については、Prometheus 公式ドキュメント https://prometheus.io/docs/alerting/latest/configuration/#webhook_config をご参照ください。
            "alerts": [
                {
                    "fingerprint": "9b115ab3762a47b51a8efcb516d4aa50",
                    "annotations": {
                        "message": "手動でトリガーされたテストアラート"
                    },
                    "startsAt": "2022-06-07T09:20:44.000000000Z",
                    "endsAt": "2022-06-07T09:22:00.000000000Z",
                    "labels": {
                        "severity": "error",
                        "regionId": "cn-hangzhou",
                        "_aliyun_arms_denoise_code": "0",
                        "_aliyun_arms_integration_name": "Custom integration",
                        "alertname": "Manually triggered alert",
                        "_aliyun_arms_product_type": "CUSTOM",
                        "_aliyun_arms_userid": "11xxxxxxxxxxx",
                        "_aliyun_arms_integration_id": "616",
                        "_aliyun_arms_is_denoise_filtered": "false"
                    },
                    "status": "resolved"
                }
            ],
            "commonLabels": {
                "severity": "error",
                "regionId": "cn-hangzhou",
                "_aliyun_arms_denoise_code": "0",
                "_aliyun_arms_integration_name": "Custom integration",
                "alertname": "Manually triggered alert",
                "_aliyun_arms_product_type": "CUSTOM",
                "_aliyun_arms_userid": "11xxxxxxxxxxx",
                "_aliyun_arms_integration_id": "616",
                "_aliyun_arms_is_denoise_filtered": "false"
            },
            "externalURL": "https://arms.console.aliyun.com/#/alarm/alert/detail/12345",
            "groupLabels": {
                "alertname": "Manually triggered alert"
            },
            "receiver": "",
            "level": "P2",
            "dispatchRuleName": "O&M team",
            "startTime": "2022-06-07 17:20:44",
            "endTime": "2022-06-07 17:22:00",
            "commonAnnotations": {
                "message": "手動でトリガーされたテストアラート"
            },
            "status": "resolved"
        },
        "solution": "",  // アラートの解決策
        "operator": "xx", // オペレーター
        "timestamp": 1654593720279
    },
    "subject": "https://arms.console.aliyun.com/#/alarm/alert/detail/12345",
    "aliyunoriginalaccountid": "11xxxxxxxxxxx",
    "source": "arms",
    "type": "aliyun:arms:alarm:close",
    "aliyunpublishtime": "2022-06-07T09:22:00.352Z",
    "specversion": "1.0",
    "aliyuneventbusname": "armstest",
    "id": "d997f8c775d4d15b05f3346d5863fdc6******_close",
    "aliyunregionid": "cn-hangzhou",
    "aliyunpublishaddr": "xx.xx.xx.xx"
}