Gunakan EventBridge dan CloudMonitor untuk berlangganan ke event Cloud Assistant - Elastic Compute Service

Event Cloud Assistant mencakup event status tugas dan event detak jantung pertama. Anda dapat berlangganan ke event tersebut untuk mempermudah pengelolaan dan pemantauan sumber daya cloud. Topik ini menjelaskan tentang event Cloud Assistant dan cara berlangganan ke event tersebut menggunakan EventBridge dan CloudMonitor.

Event Cloud Assistant

Event status tugas Cloud Assistant

Deskripsi

Tugas menjalankan perintah dan skrip membutuhkan waktu tertentu. Event status tugas Cloud Assistant dirancang untuk memberi Anda pembaruan mengenai kemajuan tugas Cloud Assistant. Event ini memberikan manfaat sebagai berikut:

Anda menerima notifikasi ketika tugas Cloud Assistant gagal atau selesai. Notifikasi tersebut dapat digunakan untuk peringatan atau operasi selanjutnya.
Dibandingkan dengan polling operasi API, menggunakan event Cloud Assistant dapat mengurangi konsumsi kuota API.
Proses polling rentan terhadap gangguan oleh rilis aplikasi. Menggunakan event Cloud Assistant dapat mencegah gangguan dan mengurangi kompleksitas.

Kondisi pemicu dan batasan

Kondisi pemicu: Ketika Anda memanggil operasi RunCommand atau InvokeCommand untuk mengeksekusi tugas Cloud Assistant, Cloud Assistant memonitor status tugas dan memicu event status tugas ketika tugas selesai.

Batasan:

Event status tugas Cloud Assistant hanya dipicu ketika tugas Cloud Assistant memasuki salah satu dari status berikut (InvocationStatus) pada instance Elastic Compute Service (ECS):
- Aborted: Tugas gagal diterbitkan.
- Success: Tugas selesai.
- Failed: Tugas gagal dieksekusi.
- Invalid: Konten tugas tidak valid.
- Timeout: Tugas melewati batas waktu.
- Cancelled: Tugas dibatalkan.
- Terminated: Tugas dihentikan sebelum selesai.
Operasi DescribeInvocations dan DescribeInvocationResults dapat digunakan untuk menanyakan status beberapa tugas Cloud Assistant. Namun, event status tugas Cloud Assistant melaporkan status hanya satu tugas Cloud Assistant pada satu instance ECS.

Parameter

Parameter	Deskripsi	Contoh
instanceId	ID instance.	i-bp114***************
invokeId	ID tugas Cloud Assistant.	t-hz045**********
commandId	ID perintah.	c-hz045**********
commandName	Nama perintah.	ACS-ECS-ResetPassword-for-linux.sh
ownerUid	Akun yang memiliki instance tempat perintah dijalankan.	158*************
playerUid	ID identitas yang mengambil peran Resource Access Management (RAM) untuk menjalankan perintah.	256***************
repeatMode	Mode eksekusi perintah. Jika parameter ini dan parameter InstanceId keduanya ditentukan, parameter ini tidak akan berlaku. Nilai yang valid: Once: langsung menjalankan perintah. Period: secara berkala menjalankan perintah berdasarkan jadwal. NextRebootOnly: menjalankan perintah saat instance mulai berikutnya. EveryReboot: menjalankan perintah setiap kali instance mulai.	Once
repeats	Jumlah kali perintah telah dijalankan pada instance. Jika parameter repeatMode disetel ke Once, nilainya adalah 0 atau 1. 0: Eksekusi perintah gagal dimulai. 1: Eksekusi perintah dimulai. Jika parameter repeatMode disetel ke Period, nilainya adalah jumlah kali perintah telah dijalankan.	0
invocationStatus	Status eksekusi perintah. Invalid: Jenis perintah atau nilai parameter tidak valid. Aborted: Perintah gagal dikirim ke instance. Hal ini karena instance tidak dalam keadaan Running atau proses pengiriman perintah tidak dapat diselesaikan dalam 1 menit. Success: Jika parameter repeatMode disetel ke Once, nilai tersebut menunjukkan bahwa tugas perintah selesai dan kode keluar adalah 0. Jika parameter repeatMode disetel ke Period, nilai tersebut menunjukkan bahwa eksekusi perintah terakhir selesai dengan kode keluar 0, dan siklus eksekusi yang ditentukan telah berakhir. Failed: Jika parameter repeatMode disetel ke Once, nilai tersebut menunjukkan bahwa tugas perintah selesai, tetapi kode keluar bukan 0. Jika parameter repeatMode disetel ke Period, nilai tersebut menunjukkan bahwa eksekusi perintah terakhir selesai dengan kode keluar bukan nol, dan siklus eksekusi yang ditentukan hampir berakhir. Timeout: Eksekusi perintah melewati batas waktu. Cancelled: Eksekusi perintah dibatalkan sebelum dimulai. Terminated: Eksekusi perintah dihentikan sebelum selesai.	Success
exitCode	Kode keluar tugas perintah.	0
startTime	Waktu mulai tugas perintah.	2023-12-20T06:15:55Z
finishTime	Waktu akhir tugas perintah.	2023-12-20T06:15:59Z
errorCode	Kode kesalahan untuk kegagalan mengirim atau menjalankan perintah.	0
errorDesc	Deskripsi kegagalan mengirim atau menjalankan perintah.	-

Event detak jantung pertama Cloud Assistant

Deskripsi

Cloud Assistant menggunakan detak jantung untuk menentukan status sistem operasi pada instance ECS. Detak jantung pertama Cloud Assistant dapat digunakan untuk menentukan titik waktu ketika sistem operasi instance ECS dimulai. Anda dapat menggunakan detak jantung pertama Cloud Assistant untuk memeriksa status kesehatan instance ECS Anda atau menentukan apakah Anda dapat mengeluarkan tugas Cloud Assistant.

Dibandingkan dengan polling operasi DescribeCloudAssistantStatus, menggunakan event detak jantung pertama Cloud Assistant menyelesaikan masalah berikut:

Polling operasi DescribeCloudAssistantStatus untuk menanyakan status Cloud Assistant pada instance adalah proses yang kompleks. Interval yang tidak sesuai dapat menyebabkan lonjakan permintaan, yang dapat memicu throttling atau membebani sistem.
Sistem operasi instance ECS mungkin memerlukan waktu yang lama untuk menyelesaikan proses boot. Misalnya, instance Windows mungkin memerlukan 5 menit untuk boot. Waktu yang diperlukan oleh proses polling untuk selesai bervariasi.
Hasil yang dikembalikan oleh operasi DescribeCloudAssistantStatus mungkin tertinggal 2 menit. Ini mengarah pada ketidakakuratan dalam skenario seperti restart instance.DescribeCloudAssistantStatus

Kondisi pemicu dan batasan

Kondisi pemicu: Ketika Cloud Assistant melaporkan detak jantung, ia memeriksa indeks-indeksnya di balik layar dan memicu event detak jantung pertama untuk detak jantung pertama. Kemudian, event tersebut dikirim ke Cloud Assistant Agent dari server Cloud Assistant.

Batasan: Versi Cloud Assistant harus memenuhi persyaratan berikut:

Windows: Versi Cloud Assistant harus lebih baru dari 1.0.0.149.
Linux: Versi Cloud Assistant harus lebih baru dari 1.0.2.569.

Catatan

Cloud Assistant versi sebelumnya tidak melaporkan detak jantung pada interval 1 menit atau melaporkan bidang dalam indeks. Akibatnya, Cloud Assistant versi sebelumnya tidak dapat mengidentifikasi detak jantung pertama setelah startup dan tidak mendukung event detak jantung pertama Cloud Assistant.

Parameter

Parameter	Deskripsi	Contoh
bizEventId	ID event.	ea33c3e2-aaf0-**-**-5d49b1ecce99
vmName	ID instance ECS yang terkait dengan event.	i-bp19****************
extensions	Informasi bisnis tambahan.	-
azone	Zona.	cn-shenzhen-e
region	Wilayah.	cn-shenzhen
agentVersion	Versi Cloud Assistant Agent.	2.2.3.529
uptime	Jumlah waktu yang telah berlalu sejak sistem operasi dimulai. Unit: milidetik.	19000

Berlangganan ke event Cloud Assistant

Kami merekomendasikan agar Anda membiasakan diri dengan dokumentasi operasi API dan layanan serta praktik terbaik.
Jika langganan gagal atau Anda tidak menerima event, periksa versi Cloud Assistant, konfigurasi EventBridge, atau konfigurasi CloudMonitor.
Pastikan Anda memiliki kebijakan ulang dan mekanisme penanganan pengecualian untuk memastikan sistem Anda dapat menangani masalah latensi dan event asinkron.

Gunakan EventBridge untuk berlangganan ke event Cloud Assistant

Pastikan Anda telah mengaktifkan EventBridge dan menyelesaikan otorisasi. Untuk informasi lebih lanjut, lihat Aktifkan EventBridge dan berikan izin kepada pengguna RAM.

Masuk ke Konsol EventBridge. Di panel navigasi kiri, klik Event Buses.
Di bilah navigasi atas, pilih wilayah.
Di halaman Event Buses, temukan bus event default dan klik nama bus event tersebut.
Di panel navigasi kiri halaman detail bus event default, klik Event Rules lalu klik Create Rule.
Di langkah Configure Basic Info wizard, masukkan nama untuk aturan di bidang Name, masukkan deskripsi untuk aturan di bidang Description, lalu klik Next Step.

Di langkah Configure Event Pattern wizard, konfigurasikan parameter dan klik Next Step.

Di daftar drop-down Event Source, pilih acs.ecs.
Di daftar drop-down Event Type, pilih jenis event Cloud Assistant yang ingin Anda langgani.
1. Event detak jantung pertama Cloud Assistant: ecs:CloudAssistant:FirstHeartbeat
2. Event status tugas Cloud Assistant: ecs:CloudAssistant:TaskCompleted

Di bagian Event Pattern Debugging, lihat contoh kode dari jenis event yang dilanggan.

Lihat contoh kode event Cloud Assistant

Event status tugas Cloud Assistant

{
    "id": "45ef4dewdwe1-7c35-447a-bd93-fab****",
    "source": "acs.ecs",
    "specversion": "1.0",
    "subject": "acs.ecs:cn-hangzhou:123456789098****:215672",
    "time": "2020-11-19T21:04:41+08:00",
    "type": "ecs:CloudAssistant:TaskCompleted",
    "aliyunaccountid": "123456789098****",
    "aliyunpublishtime": "2020-11-19T21:04:42Z",
    "aliyuneventbusname": "default",
    "aliyunregionid": "cn-hangzhou",
    "aliyunpublishaddr": "172.25.XX.XX",
    "data": {
        "commandId": "c-hz045**********",
        "commandName": "hello-linux.sh",
        "exitCode": "0",
        "finishTime": "2023-12-14T07:39:48Z",
        "instanceId": "i-bp114***************",
        "invocationStatus": "Success",
        "invokeId": "t-hz045**********",
        "ownerId": "158*************",
        "playerUid": "256***************",
        "repeatMode": "Once",
        "repeats": "1",
        "startTime": "2023-12-14T07:39:48Z",
        "errorCode": "0",
        "errorDesc": ""
    }
}

Event detak jantung pertama Cloud Assistant

{
    "id": "45ef4dewdwe1-7c35-447a-bd93-fab****",
    "source": "acs.ecs",
    "specversion": "1.0",
    "subject": "acs.ecs:cn-hangzhou:123456789098****:215672",
    "time": "2020-11-19T21:04:41+08:00",
    "type": "ecs:CloudAssistant:FirstHeartbeat",
    "aliyunaccountid": "123456789098****",
    "aliyunpublishtime": "2020-11-19T21:04:42Z",
    "aliyuneventbusname": "default",
    "aliyunregionid": "cn-hangzhou",
    "aliyunpublishaddr": "172.25.XX.XX",
    "data": {
        "bizEventId": "ea33c3e2-aaf0-****-****-5d49b1ecce99",
        "extensions": {
            "agentVersion": "2.2.3.529",
            "region": "cn-hangzhou",
            "azone": "cn-hangzhou-k",
            "uptime": "19000"
        },
        "impact": "Alert",
        "opsCode": "InstanceStatusChange",
        "vmName": "i-bp19****************"
    }
}

Klik Test di bawah blok kode untuk mensimulasikan pemicuan event. Jika Match succeeded. The event can be triggered as expected. ditampilkan, event dapat dipicu sesuai harapan.

Di langkah Configure Targets, pilih jenis layanan dan konfigurasikan skenario dorongan.
Untuk informasi tentang skenario dorongan, lihat Gunakan EventBridge untuk berlangganan cepat ke event ECS.

Gunakan CloudMonitor untuk berlangganan ke event Cloud Assistant

Masuk ke Konsol Cloud Monitor.
Di panel navigasi kiri, pilih Event Center > Event Subscription.
Catatan
Anda juga dapat melakukan langkah-langkah berikut untuk membuat kebijakan langganan menggunakan menu System Event:
1. Di panel navigasi kiri, pilih Event Center > System Event.
2. Di bagian Welcome to the New Event Center, klik Create Immediately guna membuat kebijakan langganan.
Di tab Subscription Policy, klik Create Subscription Policy.
Di halaman Create Subscription Policy, konfigurasikan parameter.
Bagian ini hanya menjelaskan parameter yang terkait dengan event Cloud Assistant. Untuk informasi tentang parameter lainnya, lihat bagian Parameter Kebijakan Langganan dari topik "Kelola kebijakan langganan insiden (disarankan)".
- Subscription Type: Pilih System Events.
- Subscription Scope:
  - Products: Pilih Elastic Compute Service (ECS) dari daftar drop-down.
  - Event Type: Pilih Notifications.
  - Event name: Pilih CloudAssistant:FirstHeartbeat atau CloudAssistant:TaskCompleted.
Klik Submit.
Anda akan diberi tahu ketika insiden relevan dipicu. Anda juga dapat memanggil operasi DescribeSystemEventAttribute untuk menanyakan detail insiden sistem.