Cara mengarahkan event peringatan dari ARMS Alert Management ke event bus EventBridge - Application Real-Time Monitoring Service

ARMS Alert Management memungkinkan Anda mengarahkan event tentang perubahan status dalam siklus hidup alert—seperti pembuatan, klaim, dan penutupan alert—ke event bus EventBridge Anda. Dengan mengonsumsi event-event tersebut, Anda dapat mengintegrasikannya dengan sistem pihak ketiga untuk remediasi otomatis atau integrasi sistem tiket. Topik ini menjelaskan cara mengarahkan event alert dari ARMS Alert Management ke event bus EventBridge.

Informasi latar belakang

EventBridge adalah layanan event bus serverless yang disediakan oleh Alibaba Cloud untuk menghubungkan layanan Alibaba Cloud, aplikasi kustom, dan aplikasi SaaS secara terstandarisasi dan terpusat. Anda dapat menggunakan EventBridge untuk mengarahkan event antar aplikasi tersebut berdasarkan protokol CloudEvents 1.0, sehingga membantu membangun arsitektur berbasis event yang terdistribusi dan longgar terikat (loosely coupled). Untuk informasi selengkapnya, lihat Apa itu EventBridge?

Langkah 1: Buat sumber daya EventBridge

Buat event bus EventBridge. Untuk informasi selengkapnya, lihat Kelola event bus kustom.
Setelah membuat event bus, peroleh titik akhir publik dari halaman Event Bus Overview.
Tambahkan sumber event bertipe custom application. Untuk informasi selengkapnya, lihat Kelola sumber event kustom.
Pada kotak dialog, tetapkan Name (misalnya, arms) dan Description opsional.

Langkah 2: Konfigurasikan integrasi EventBridge di ARMS

Masuk ke Konsol ARMS. Di panel navigasi sebelah kiri, pilih Alert Management > Integrations.
Pada halaman Integrations, klik tab Notification Integration, lalu klik EventBridge.

Pada kotak dialog Add Integration, konfigurasikan parameter berikut dan klik Save.

Parameter	Description
Name	Nama kustom untuk integrasi, misalnya, `EventBridge-integration`.
Description	Deskripsi opsional untuk integrasi.
Endpoint	Titik akhir publik yang Anda peroleh di Langkah 1.
AccessKey	ID AccessKey Akun Alibaba Cloud Anda. Untuk informasi selengkapnya, lihat Peroleh pasangan AccessKey.
AccessKey Secret	Rahasia AccessKey Akun Alibaba Cloud Anda. Untuk informasi selengkapnya, lihat Peroleh pasangan AccessKey.
Message Bus Name	Nama event bus yang Anda buat di Langkah 1. Misalnya, `armstest`.
regionId	ID wilayah tempat event bus yang Anda buat di Langkah 1 berada. Misalnya, `cn-hangzhou`.
Event Source Name	Nama sumber event yang Anda buat di Langkah 1. Misalnya, `arms`.

Langkah 3: Konfigurasikan kebijakan notifikasi

Pada kebijakan notifikasi, atur Ticket System ke integrasi EventBridge yang telah Anda buat pada langkah sebelumnya. Untuk informasi selengkapnya, lihat Kebijakan notifikasi.

Langkah 4: Lihat event alert di Konsol EventBridge

Masuk ke Konsol EventBridge untuk melihat event alert. Untuk informasi selengkapnya, lihat Kueri event. Pada halaman Event Trace event bus target Anda, pilih tab Query by time range untuk melihat event alert yang dikirim dari ARMS. Jenis event tersebut meliputi aliyun:arms:alarm:create (event pembuatan alert), aliyun:arms:alarm:claim (event klaim alert), aliyun:arms:alarm:comment (event komentar alert), dan aliyun:arms:alarm:close (event penutupan alert). Anda dapat mengklik Event Trace atau Event Detail untuk informasi lebih detail.

Kode Jenis Event	Jenis
aliyun:arms:alarm:create	Event pembuatan alert
aliyun:arms:alarm:claim	Event klaim alert
aliyun:arms:alarm:comment	Event komentar alert
aliyun:arms:alarm:close	Event penutupan alert

Pada kolom Actions untuk suatu event, klik Event Details untuk melihat parameternya. Bagian berikut menunjukkan format muatan (payload) untuk setiap jenis event.

Event pembuatan alert

{
    "datacontenttype": "application/json",
    "aliyunaccountid": "11xxxxxxxxxxx",
    "data": {
        "owner": "xx",  // Pemilik alert, yaitu kontak yang dikonfigurasi dalam kebijakan notifikasi.
        "data": {        // Konten alert. Formatnya kompatibel dengan event AlertManager open source. Untuk informasi selengkapnya, lihat dokumentasi resmi Prometheus di https://prometheus.io/docs/alerting/latest/configuration/#webhook_config
            "alerts": [
                {
                    "fingerprint": "9b115ab3762a47b51a8efcb516d4aa50",
                    "annotations": {
                        "message": "Manually triggered test alert"
                    },
                    "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": "Manually triggered test alert"
            },
            "status": "firing"
        },
        "timestamp": 1654593783951
    },
    "subject": "https://arms.console.aliyun.com/#/alarm/alert/detail/12345",   // URL unik global untuk menemukan alert.
    "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"
}

Event klaim alert

{
    "datacontenttype": "application/json",
    "aliyunaccountid": "11xxxxxxxxxxx",
    "data": {
        "owner": "xx", // Pemilik alert.
        "handler": "xx", // Penanganan alert.
        "data": { // Konten alert. Formatnya kompatibel dengan event AlertManager open source. Untuk informasi selengkapnya, lihat dokumentasi resmi Prometheus di https://prometheus.io/docs/alerting/latest/configuration/#webhook_config
            "alerts": [
                {
                    "fingerprint": "9b115ab3762a47b51a8efcb516d4aa50",
                    "annotations": {
                        "message": "Manually triggered test alert"
                    },
                    "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": "Manually triggered test alert"
            },
            "status": "firing"
        },
        "operator": "xx", // Operator.
        "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"
}

Event komentar alert

{
    "datacontenttype": "application/json",
    "aliyunaccountid": "11xxxxxxxxxxx",
    "data": {
        "owner": "xx", // Pemilik alert.
        "handler": "xx", // Penanganan alert.
        "data": {  // Konten alert. Formatnya kompatibel dengan event AlertManager open source. Untuk informasi selengkapnya, lihat dokumentasi resmi Prometheus di https://prometheus.io/docs/alerting/latest/configuration/#webhook_config
            "alerts": [
                {
                    "fingerprint": "9b115ab3762a47b51a8efcb516d4aa50",
                    "annotations": {
                        "message": "Manually triggered test alert"
                    },
                    "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": "Manually triggered test alert"
            },
            "status": "resolved"
        },
        "comment": "Solution: false positive", // Isi komentar.
        "operator": "xx", // Operator.
        "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"
}

Event penutupan alert

{
    "datacontenttype": "application/json",
    "aliyunaccountid": "11xxxxxxxxxxx",
    "data": {
        "owner": "xx", // Pemilik alert.
        "handler": "xx",  // Penanganan alert.
        "data": { // Konten alert. Formatnya kompatibel dengan event AlertManager open source. Untuk informasi selengkapnya, lihat dokumentasi resmi Prometheus di https://prometheus.io/docs/alerting/latest/configuration/#webhook_config
            "alerts": [
                {
                    "fingerprint": "9b115ab3762a47b51a8efcb516d4aa50",
                    "annotations": {
                        "message": "Manually triggered test alert"
                    },
                    "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": "Manually triggered test alert"
            },
            "status": "resolved"
        },
        "solution": "",  // Solusi untuk alert.
        "operator": "xx", // Operator.
        "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"
}