Kirim event peringatan ke EventBridge - Application Real-Time Monitoring Service

Saat peringatan aktif di lingkungan produksi yang kompleks, Anda sering perlu memicu tindakan otomatis—seperti remediasi otomatis atau integrasi sistem tiket. Application Real-Time Monitoring Service (ARMS) Alert Management terintegrasi dengan EventBridge untuk meneruskan event siklus hidup peringatan (dipicu, diklaim, dikomentari, dan diselesaikan) ke event bus kustom. EventBridge kemudian mengarahkan event tersebut ke konsumen downstream berdasarkan aturan yang Anda tentukan.

Cara kerja

ARMS menerbitkan event peringatan ke event bus kustom EventBridge Anda melalui integrasi notifikasi.
Setiap event mengikuti spesifikasi CloudEvents 1.0 dan kompatibel dengan format webhook Alertmanager open-source.
Anda dapat mengonsumsi event EventBridge untuk terhubung ke platform pihak ketiga, sehingga memungkinkan penerapan remediasi otomatis atau integrasi sistem tiket.

Langkah 1: Buat sumber daya EventBridge

Sebelum mengonfigurasi integrasi ARMS, siapkan event bus dan sumber event di EventBridge.

Buat event bus kustom. Untuk detailnya, lihat Kelola event bus kustom. Setelah membuat event bus, salin public endpoint dari halaman Event Bus Overview. Nilai ini diperlukan pada Langkah 2.
Tambahkan sumber event kustom ke event bus. Untuk detailnya, lihat Kelola sumber event kustom. Catat nama sumber event tersebut. Nilai ini juga diperlukan pada Langkah 2.

Langkah 2: Konfigurasikan integrasi EventBridge di ARMS

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

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

Parameter	Deskripsi	Contoh
Name	Nama tampilan untuk integrasi ini.	`EventBridge integration`
Description	Opsional. Deskripsi singkat tentang integrasi.	--
Endpoint	Public endpoint dari event bus yang Anda buat di Langkah 1.	`https://xxxx.eventbridge.cn-hangzhou.aliyuncs.com`
AccessKey	ID AccessKey akun Alibaba Cloud Anda. Untuk detailnya, lihat Dapatkan Pasangan Kunci Akses.	`LTAI5tXxx`
AccessKey Secret	Rahasia AccessKey akun Alibaba Cloud Anda. Untuk detailnya, lihat Dapatkan Pasangan Kunci Akses.	`xXxXxXx`
Message Bus Name	Nama event bus yang Anda buat di Langkah 1.	`armstest`
regionId	ID wilayah tempat event bus berada.	`cn-hangzhou`
Event Source Name	Nama sumber event yang Anda buat di Langkah 1.	`arms`

Langkah 3: Konfigurasikan kebijakan notifikasi

Hubungkan integrasi EventBridge ke kebijakan notifikasi agar peringatan yang sesuai diteruskan ke EventBridge.

Di Konsol ARMS, buka konfigurasi kebijakan notifikasi Anda.
Buat atau edit kebijakan notifikasi. Pada bidang Ticket System, pilih integrasi EventBridge yang Anda buat di Langkah 2.

Untuk detailnya, lihat Buat dan kelola kebijakan notifikasi.

Verifikasi integrasi

Setelah menyelesaikan pengaturan, pastikan event mencapai EventBridge:

Masuk ke Konsol EventBridge.
Buka event bus kustom Anda dan periksa adanya event masuk. Untuk detailnya, lihat Kueri event.
Klik Event Detail pada kolom Actions untuk memeriksa muatan event.

Jenis event

ARMS mengirim satu event untuk setiap tindakan siklus hidup peringatan. Setiap event menggunakan nilai type yang berbeda.

Kode event	Tindakan peringatan
`aliyun:arms:alarm:create`	Peringatan dipicu
`aliyun:arms:alarm:claim`	Peringatan diklaim
`aliyun:arms:alarm:comment`	Komentar ditambahkan ke peringatan
`aliyun:arms:alarm:close`	Peringatan diselesaikan

Notifikasi ulang yang dikonfigurasi dalam kebijakan notifikasi hanya dikirim ke penerima notifikasi, seperti grup DingTalk atau webhook. Notifikasi ulang tidak memicu pengiriman event baru ke EventBridge. EventBridge hanya mengirimkan event saat status peringatan berubah, sedangkan notifikasi ulang mencerminkan status berkelanjutan dari peringatan yang sama, bukan perubahan status.

Referensi muatan event

Semua event mengikuti spesifikasi CloudEvents 1.0. Objek data.data kompatibel dengan format webhook Alertmanager open-source.

Bidang tingkat atas

Bidang	Tipe	Deskripsi
`id`	string	ID event unik.
`source`	string	Sumber event. Selalu `arms`.
`type`	string	Kode event dari tabel di atas.
`specversion`	string	Versi CloudEvents. Selalu `1.0`.
`datacontenttype`	string	Tipe konten. Selalu `application/json`.
`subject`	string	URL unik peringatan di Konsol ARMS.
`aliyuneventbusname`	string	Nama event bus tujuan.
`aliyunregionid`	string	ID wilayah event bus.
`aliyunaccountid`	string	ID akun Alibaba Cloud.
`aliyunpublishtime`	string	Timestamp saat event diterbitkan (ISO 8601).
`aliyunoriginalaccountid`	string	ID akun Alibaba Cloud asli.
`aliyunpublishaddr`	string	Alamat IP penerbit event.
`data`	object	Muatan spesifik event. Lihat di bawah.

Bidang objek `data`

Bidang	Tipe	Ada di	Deskripsi
`owner`	string	Semua event	Pemilik peringatan (kontak yang ditentukan dalam kebijakan notifikasi).
`handler`	string	claim, comment, close	Penangan peringatan.
`operator`	string	claim, comment, close	Pengguna yang melakukan tindakan.
`comment`	string	comment only	Isi komentar.
`solution`	string	close only	Solusi yang dicatat saat menyelesaikan peringatan.
`timestamp`	number	Semua event	Timestamp Unix dalam milidetik.
`data`	object	Semua event	Muatan peringatan kompatibel Alertmanager. Lihat di bawah.

Bidang objek `data.data` (kompatibel Alertmanager)

Bidang	Tipe	Deskripsi
`status`	string	`firing` atau `resolved`.
`level`	string	Tingkat keparahan peringatan (misalnya, `P2`).
`dispatchRuleName`	string	Nama aturan distribusi (misalnya, `O & M team`).
`startTime`	string	Waktu mulai peringatan.
`endTime`	string	Waktu selesai peringatan. Hanya ada jika peringatan telah diselesaikan.
`externalURL`	string	URL ke halaman detail peringatan di Konsol ARMS.
`receiver`	string	Identifier penerima.
`alerts`	array	Array objek peringatan individual.
`commonLabels`	object	Label yang dibagikan oleh semua peringatan dalam grup.
`commonAnnotations`	object	Anotasi yang dibagikan oleh semua peringatan dalam grup.
`groupLabels`	object	Label yang digunakan untuk pengelompokan peringatan.

Bidang objek `alerts[]`

Bidang	Tipe	Deskripsi
`fingerprint`	string	Hash unik yang mengidentifikasi peringatan.
`status`	string	`firing` atau `resolved`.
`startsAt`	string	Waktu mulai peringatan (ISO 8601).
`endsAt`	string	Waktu selesai peringatan (ISO 8601).
`labels`	object	Label pasangan kunci-nilai termasuk `severity`, `regionId`, `alertname`, dan metadata spesifik ARMS.
`annotations`	object	Anotasi pasangan kunci-nilai termasuk `message`.

Bidang spesifik untuk setiap jenis event

Struktur data.data kompatibel Alertmanager tetap sama untuk semua jenis event. Bidang berikut dalam objek data berbeda tergantung jenis event:

Jenis Peristiwa	Bidang tambahan dalam `data`
Peringatan dipicu (`create`)	`owner`
Peringatan diklaim (`claim`)	`owner`, `handler`, `operator`
Komentar ditambahkan (`comment`)	`owner`, `handler`, `operator`, `comment`
Peringatan diselesaikan (`close`)	`owner`, `handler`, `operator`, `solution`

Contoh: event peringatan dipicu

{
    "datacontenttype": "application/json",
    "aliyunaccountid": "11xxxxxxxxxxx",
    "data": {
        "owner": "xx",  // Pemilik peringatan. Tetapkan nilainya ke kontak yang ditentukan dalam kebijakan notifikasi.
        "data": {        // Konten peringatan. Konten peringatan kompatibel dengan format event Alertmanager open source. Untuk informasi lebih lanjut, lihat dokumentasi resmi Prometheus (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.alibabacloud.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.alibabacloud.com/#/alarm/alert/detail/12345", // URL global unik peringatan.
    "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"
}

Contoh: event peringatan diklaim

{
    "datacontenttype": "application/json",
    "aliyunaccountid": "11xxxxxxxxxxx",
    "data": {
        "owner": "xx", // Pemilik peringatan.
        "handler": "xx", // Penangan peringatan.
        "data": { // Konten peringatan. Konten peringatan kompatibel dengan format event Alertmanager open source. Untuk informasi lebih lanjut, lihat dokumentasi resmi Prometheus (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.alibabacloud.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 peringatan.
        "timestamp": 1654593717195
    },
    "subject": "https://arms.console.alibabacloud.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"
}

Contoh: Komentar yang Ditambahkan ke Event Peringatan

{
    "datacontenttype": "application/json",
    "aliyunaccountid": "11xxxxxxxxxxx",
    "data": {
        "owner": "xx", // Pemilik peringatan.
        "handler": "xx", // Penangan peringatan.
        "data": {  // Konten peringatan. Konten peringatan kompatibel dengan format event Alertmanager open source. Untuk informasi lebih lanjut, lihat dokumentasi resmi Prometheus (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.alibabacloud.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 peringatan.
        "timestamp": 1654593720385
    },
    "subject": "https://arms.console.alibabacloud.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"
}

Contoh: alert cleared event

{
    "datacontenttype": "application/json",
    "aliyunaccountid": "11xxxxxxxxxxx",
    "data": {
        "owner": "xx", // Pemilik peringatan.
        "handler": "xx", // Penangan peringatan.
        "data": { // Konten peringatan. Konten peringatan kompatibel dengan format event Alertmanager open source. Untuk informasi lebih lanjut, lihat dokumentasi resmi Prometheus (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.alibabacloud.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 peringatan.
        "operator": "xx", // Operator peringatan.
        "timestamp": 1654593720279
    },
    "subject": "https://arms.console.alibabacloud.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"
}

Langkah selanjutnya

Apa itu EventBridge? — Pelajari konsep dan arsitektur EventBridge.