Elastic Compute Service:Berlangganan event Cloud Assistant menggunakan EventBridge dan Cloud Monitor

Deskripsi event

Perintah dan skrip memerlukan waktu untuk dijalankan. Event status tugas Cloud Assistant membantu Anda melacak penyelesaian tugas. Anda dapat menggunakan event ini untuk tujuan berikut:

• Menerima notifikasi saat tugas Cloud Assistant gagal atau selesai. Anda dapat menggunakan notifikasi tersebut untuk peringatan atau operasi lanjutan.

• Polling menghabiskan kuota panggilan API Anda. Untuk menghindarinya, gunakan langganan event sebagai gantinya.

• Cegah gangguan akibat rilis aplikasi, yang dapat terjadi selama proses polling panjang. Penggunaan event menyederhanakan alur kerja Anda.

Kondisi pemicu dan batasan

Kondisi pemicu: Saat Anda memanggil operasi RunCommand atau InvokeCommand untuk menjalankan tugas, Cloud Assistant memantau status tugas tersebut. Event status tugas dikirim saat tugas selesai.

Batasan:

• Event status tugas Cloud Assistant hanya dikirim saat tugas pada instans ECS memasuki salah satu status akhir berikut (InvocationStatus):

  • Aborted: Tugas gagal dikirim.

  • Success: Tugas berhasil.

  • Failed: Tugas gagal.

  • Invalid: Konten tugas tidak valid.

  • Timeout: Waktu eksekusi tugas habis.

  • Cancelled: Tugas dibatalkan.

  • Terminated: Tugas dihentikan.

• Operasi DescribeInvocations dan DescribeInvocationResults mengembalikan data dalam format array<object>. Namun, event status tugas hanya melaporkan status satu tugas pada satu instans, bukan beberapa tugas sekaligus.

Field event

Deskripsi event

Heartbeat Cloud Assistant merupakan salah satu cara untuk menentukan status sistem operasi instans. Heartbeat pertama menunjukkan kapan sistem operasi telah dimulai. Anda dapat menggunakan informasi ini untuk memeriksa kesehatan instans atau menentukan kapan harus mengirim perintah Cloud Assistant.

Menggunakan event heartbeat pertama alih-alih melakukan polling operasi DescribeCloudAssistantStatus menyelesaikan permasalahan berikut:

• Mem-polling DescribeCloudAssistantStatus untuk memeriksa apakah status telah berubah menjadi `true` bersifat kompleks. Interval polling yang tidak tepat dapat menghasilkan terlalu banyak permintaan, sehingga memicu pembatasan kecepatan atau memberi beban pada sistem.

• Waktu startup sistem operasi instans dapat sangat bervariasi. Beberapa instans Windows dapat membutuhkan waktu hingga 5 menit untuk memulai, sehingga sulit mengontrol durasi total polling.

• Status yang dikembalikan oleh DescribeCloudAssistantStatus dapat mengalami keterlambatan. Terdapat jeda 2 menit antara saat heartbeat berhenti dan saat status berubah. Hal ini menyulitkan DescribeCloudAssistantStatus dalam mendeteksi restart instans.

Kondisi pemicu dan batasan

Kondisi pemicu: Saat Cloud Assistant melaporkan heartbeat, event heartbeat pertama dikirim jika terdeteksi bahwa ini adalah heartbeat pertama setelah client Cloud Assistant dimulai.

Batasan versi Cloud Assistant:

• Instans Windows: Versi Cloud Assistant Agent harus lebih baru dari 1.0.0.149.

• Instans Linux: Versi Cloud Assistant Agent harus lebih baru dari 1.0.2.569.

Versi Cloud Assistant yang lebih lama tidak melaporkan heartbeat setiap menit atau tidak melaporkan field indeks. Akibatnya, versi tersebut tidak dapat mengidentifikasi secara akurat heartbeat pertama setelah startup. Versi lama ini tidak didukung.

Field event

Deskripsi event

• Saat Anda menjalankan perintah, maksimal 24 KB output perintah disimpan. Output yang melebihi batas ini akan dipotong.

• Jika Anda ingin mendapatkan output lengkap atau menyimpan output secara persisten, Anda dapat mengonfigurasi agar output dikirimkan ke path Object Storage Service (OSS) saat eksekusi perintah mencapai status akhir.

• Anda dapat menggunakan event ini untuk tujuan berikut:

  • Menerima notifikasi dan detail tentang pengiriman output. Saat menerima notifikasi sukses, Anda dapat mengunduh file output dari Bucket OSS yang sesuai. Hal ini menghindari polling operasi DescribeInvocations untuk mendapatkan hasil dan meningkatkan efisiensi.

  • Saat pengiriman gagal, Anda dapat memperoleh alasan kegagalan secara detail dari event tersebut.

Kondisi pemicu dan batasan

Kondisi pemicu: Saat Anda menggunakan RunCommand atau InvokeCommand untuk menjalankan tugas dan menentukan parameter OssOutputDelivery yang valid, event ini dikirim saat tugas mencapai status akhir.

Batasan:

• Event hanya dikirim saat tugas pada instans memasuki salah satu status akhir berikut (InvocationStatus):

  • Aborted: Tugas gagal dikirim.

  • Success: Tugas berhasil.

  • Failed: Tugas gagal.

  • Invalid: Konten tugas tidak valid.

  • Timeout: Waktu eksekusi tugas habis.

  • Cancelled: Tugas dibatalkan.

  • Terminated: Tugas dihentikan.

Batasan versi Cloud Assistant:

• Instans Windows: Versi Cloud Assistant Agent harus lebih baru dari 2.1.4.1007.

• Instans Linux: Versi Cloud Assistant Agent harus lebih baru dari 2.2.4.1007.

Field event

Deskripsi event

• Cloud Assistant Agent secara otomatis memeriksa pembaruan versi setiap 30 menit secara default.

• Berlangganan event notifikasi kegagalan peningkatan untuk segera mengetahui alasan dan solusi kegagalan, yang menyederhanakan troubleshooting.

Deskripsi field event

Deskripsi kode kesalahan

Kode kesalahan memiliki awalan AgentUpdateFailure:. Tabel berikut menjelaskan kode kesalahan tersebut.

Contoh JSON event

{
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234****",
    "source": "acs.ecs",
    "specversion": "1.0",
    "subject": "acs.ecs:cn-hangzhou:123456789098****:215672",
    "time": "2026-02-28T03:30:00+08:00",
    "type": "ecs:CloudAssistant:UpdateFailed",
    "aliyunaccountid": "123456789098****",
    "aliyunpublishtime": "2026-02-28T03:30:01Z",
    "aliyuneventbusname": "default",
    "aliyunregionid": "cn-hangzhou",
    "aliyunpublishaddr": "172.25.XX.XX",
    "data": {
        "instanceId": "i-bp114***************",
        "currentVersion": "2.2.3.529",
        "expectedVersion": "2.2.4.1007",
        "errorCode": "AgentUpdateFailure:DownloadPackageFailed:NetworkTimeout",
        "errorInfo": "The aliyun service network is blocked.",
        "occurrenceTime": "2026-02-28T03:30:00Z"
    }
}

Deskripsi event

• Cloud Assistant Agent secara otomatis memeriksa pembaruan versi setiap 30 menit secara default.

• Berlangganan event notifikasi keberhasilan peningkatan untuk tetap mengetahui status peningkatan, yang menyederhanakan troubleshooting.

Deskripsi field event

Contoh JSON event

{
    "id": "f1e2d3c4-b5a6-7890-abcd-123456****",
    "source": "acs.ecs",
    "specversion": "1.0",
    "subject": "acs.ecs:cn-hangzhou:123456789098****:215672",
    "time": "2026-02-28T03:30:00+08:00",
    "type": "ecs:CloudAssistant:UpdateCompleted",
    "aliyunaccountid": "123456789098****",
    "aliyunpublishtime": "2026-02-28T03:30:01Z",
    "aliyuneventbusname": "default",
    "aliyunregionid": "cn-hangzhou",
    "aliyunpublishaddr": "172.25.XX.XX",
    "data": {
        "instanceId": "i-bp114***************",
        "currentVersion": "2.2.4.1007",
        "occurrenceTime": "2026-02-28T03:30:00Z"
    }
}