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

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

Cara kerja

ARMS memublikasikan 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 implementasi 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 Manage custom event buses. 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 tersebut. Untuk detailnya, lihat Manage custom event sources. Catat nama sumber event tersebut. Nilai ini juga diperlukan pada Langkah 2.

Langkah 2: Konfigurasikan integrasi EventBridge di ARMS

Masuk ke ARMS console.
Pada panel navigasi sebelah 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 mengenai 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 Obtain an AccessKey pair.	`LTAI5tXxx`
AccessKey Secret	Rahasia AccessKey akun Alibaba Cloud Anda. Untuk detailnya, lihat Obtain an AccessKey pair.	`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 ARMS console, 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 Create and manage a notification policy.

Verifikasi integrasi

Setelah menyelesaikan pengaturan, pastikan event telah sampai ke EventBridge:

Masuk ke EventBridge console.
Buka event bus kustom Anda dan periksa adanya event masuk. Untuk detailnya, lihat Query events.
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 telah dibersihkan

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 ARMS console.
`aliyuneventbusname`	string	Nama event bus tujuan.
`aliyunregionid`	string	ID wilayah event bus.
`aliyunaccountid`	string	ID akun Alibaba Cloud.
`aliyunpublishtime`	string	Waktu publikasi event (ISO 8601).
`aliyunoriginalaccountid`	string	ID akun Alibaba Cloud asal.
`aliyunpublishaddr`	string	Alamat IP penerbit event.
`data`	object	Muatan spesifik event. Lihat di bawah.

Bidang objek `data`

Bidang	Tipe	Muncul di	Deskripsi
`owner`	string	Semua event	Pemilik peringatan (kontak yang ditentukan dalam kebijakan notifikasi).
`handler`	string	claim, comment, close	Penanganan 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 akhir peringatan. Hanya ada jika peringatan telah diselesaikan.
`externalURL`	string	URL ke halaman detail peringatan di ARMS console.
`receiver`	string	Identifikasi 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 akhir 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 di 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": {        // Isi 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.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 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: Peringatan event yang diklaim

{
    "datacontenttype": "application/json",
    "aliyunaccountid": "11xxxxxxxxxxx",
    "data": {
        "owner": "xx", // Pemilik peringatan.
        "handler": "xx", // Penangan peringatan.
        "data": { // Isi 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.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 peringatan.
        "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"
}

Contoh: Komentar Ditambahkan pada Event Alert

{
    "datacontenttype": "application/json",
    "aliyunaccountid": "11xxxxxxxxxxx",
    "data": {
        "owner": "xx", // Pemilik peringatan.
        "handler": "xx", // Penangan peringatan.
        "data": {  // Isi 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.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 peringatan.
        "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"
}

Contoh: event peringatan diselesaikan

{
    "datacontenttype": "application/json",
    "aliyunaccountid": "11xxxxxxxxxxx",
    "data": {
        "owner": "xx", // Pemilik peringatan.
        "handler": "xx", // Penangan peringatan.
        "data": { // Isi 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.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 peringatan.
        "operator": "xx", // Operator peringatan.
        "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"
}

Langkah selanjutnya

What is EventBridge? — Pelajari konsep dan arsitektur EventBridge.