Pantau peristiwa AMI menggunakan Amazon EventBridge - Amazon Elastic Compute Cloud

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Pantau peristiwa AMI menggunakan Amazon EventBridge

Ketika status Amazon Machine Image (AMI) berubah, Amazon EC2 menghasilkan peristiwa yang dikirim ke Amazon EventBridge (sebelumnya dikenal sebagai Amazon Events). CloudWatch Anda dapat menggunakan Amazon EventBridge untuk mendeteksi dan bereaksi terhadap peristiwa ini. Anda melakukan ini dengan membuat aturan EventBridge yang memicu tindakan sebagai respons terhadap suatu peristiwa. Misalnya, Anda dapat membuat EventBridge aturan yang mendeteksi kapan proses pembuatan AMI telah selesai dan kemudian memanggil topik Amazon SNS untuk mengirim pemberitahuan email kepada Anda.

Amazon EC2 menghasilkan peristiwa saat AMI memasuki salah satu status berikut:

  • available

  • failed

  • deregistered

  • disabled

Tabel berikut ini mencantumkan operasi dan status AMI yang dapat dimasuki oleh AMI. Dalam tabel, Ya menunjukkan status yang dapat dimasuki AMI ketika operasi yang sesuai berjalan.

Operasi AMI available failed deregistered disabled

CopyImage

Ya

Ya

CreateImage

Ya

Ya

CreateRestoreImageTask

Ya

Ya

DeregisterImage

Ya

DisableImage

Ya

EnableImage

Ya

RegisterImage

Ya

Ya

Peristiwa dihasilkan atas dasar upaya terbaik.

Peristiwa AMI

Ada empat peristiwa EC2 AMI State Change:

Acara dikirim ke bus EventBridge acara default dalam format JSON.

Bidang berikut dalam peristiwa dapat digunakan untuk membuat aturan yang memicu tindakan:

"source": "aws.ec2"

Mengidentifikasi bahwa peristiwa tersebut dari Amazon EC2.

"detail-type": "EC2 AMI State Change"

Mengidentifikasi nama peristiwa.

"detail": { "ImageId": "ami-0123456789example", "State": "available", }

Memberikan informasi berikut ini:

  • ID AMI – Jika Anda ingin melacak AMI tertentu.

  • Status AMI (available, failed, deregistered, atau disabled).

available

Berikut ini adalah contoh peristiwa yang dihasilkan Amazon EC2 saat AMI memasuki status available setelah keberhasilan operasi CreateImage, CopyImage, RegisterImage, CreateRestoreImageTask, atau EnableImage.

"State": "available" menunjukkan bahwa operasi berhasil.

{ "version": "0", "id": "example-9f07-51db-246b-d8b8441bcdf0", "detail-type": "EC2 AMI State Change", "source": "aws.ec2", "account": "012345678901", "time": "yyyy-mm-ddThh:mm:ssZ", "region": "us-east-1", "resources": ["arn:aws:ec2:us-east-1::image/ami-0123456789example"], "detail": { "RequestId": "example-9dcc-40a6-aa77-7ce457d5442b", "ImageId": "ami-0123456789example", "State": "available", "ErrorMessage": "" } }

failed

Berikut ini adalah contoh peristiwa yang dihasilkan Amazon EC2 saat AMI memasuki status failed setelah kegagalan operasi CreateImage, CopyImage, RegisterImage, atau CreateRestoreImageTask.

Bidang berikut memberikan informasi terkait:

  • "State": "failed" – Menunjukkan bahwa operasi gagal.

  • "ErrorMessage": "" – Memberikan alasan kegagalan operasi.

{ "version": "0", "id": "example-9f07-51db-246b-d8b8441bcdf0", "detail-type": "EC2 AMI State Change", "source": "aws.ec2", "account": "012345678901", "time": "yyyy-mm-ddThh:mm:ssZ", "region": "us-east-1", "resources": ["arn:aws:ec2:us-east-1::image/ami-0123456789example"], "detail": { "RequestId": "example-9dcc-40a6-aa77-7ce457d5442b", "ImageId": "ami-0123456789example", "State": "failed", "ErrorMessage": "Description of failure" } }

deregistered

Berikut ini adalah contoh peristiwa yang dihasilkan Amazon EC2 saat AMI memasuki status deregistered setelah keberhasilan operasi DeregisterImage. Jika operasi gagal, tidak ada peristiwa yang dihasilkan. Kegagalan diketahui segera karena DeregisterImage merupakan operasi tersinkron.

"State": "deregistered" menunjukkan bahwa operasi DeregisterImage berhasil.

{ "version": "0", "id": "example-9f07-51db-246b-d8b8441bcdf0", "detail-type": "EC2 AMI State Change", "source": "aws.ec2", "account": "012345678901", "time": "yyyy-mm-ddThh:mm:ssZ", "region": "us-east-1", "resources": ["arn:aws:ec2:us-east-1::image/ami-0123456789example"], "detail": { "RequestId": "example-9dcc-40a6-aa77-7ce457d5442b", "ImageId": "ami-0123456789example", "State": "deregistered", "ErrorMessage": "" } }

disabled

Berikut ini adalah contoh peristiwa yang dihasilkan Amazon EC2 saat AMI memasuki status disabled setelah keberhasilan operasi DisableImage. Jika operasi gagal, tidak ada peristiwa yang dihasilkan. Kegagalan diketahui segera karena DisableImage merupakan operasi tersinkron.

"State": "disabled" menunjukkan bahwa operasi DisableImage berhasil.

{ "version": "0", "id": "example-9f07-51db-246b-d8b8441bcdf0", "detail-type": "EC2 AMI State Change", "source": "aws.ec2", "account": "012345678901", "time": "yyyy-mm-ddThh:mm:ssZ", "region": "us-east-1", "resources": ["arn:aws:ec2:us-east-1::image/ami-0123456789example"], "detail": { "RequestId": "example-9dcc-40a6-aa77-7ce457d5442b", "ImageId": "ami-0123456789example", "State": "disabled", "ErrorMessage": "" } }

Buat EventBridge aturan Amazon

Anda dapat membuat EventBridge aturan Amazon yang menentukan tindakan yang akan diambil saat EventBridge menerima peristiwa yang cocok dengan pola acara dalam aturan. Saat acara cocok, EventBridge kirimkan acara ke target yang ditentukan dan memicu tindakan yang ditentukan dalam aturan.

Pola peristiwa memiliki struktur yang sama dengan peristiwa yang dicocokkan. Pola peristiwa bisa cocok atau tidak dengan peristiwa.

Saat membuat aturan untuk peristiwa perubahan status AMI, Anda dapat menyertakan bidang berikut dalam pola peristiwa:

"source": "aws.ec2“

Mengidentifikasi bahwa peristiwa tersebut dari Amazon EC2.

"detail-type": "EC2 AMI State Change"

Mengidentifikasi nama peristiwa.

"detail": { "ImageId": "ami-0123456789example", "State": "available", }

Memberikan informasi berikut ini:

  • ID AMI – Jika Anda ingin melacak AMI tertentu.

  • Status AMI (available, failed, deregistered, atau disabled).

Contoh: Buat EventBridge aturan untuk mengirim pemberitahuan

Contoh berikut membuat EventBridge aturan untuk mengirim email, pesan teks, atau pemberitahuan push seluler ketika AMI apa pun berada dalam available status setelah CreateImage operasi berhasil diselesaikan.

Sebelum membuat EventBridge aturan, Anda harus membuat topik Amazon SNS untuk email, pesan teks, atau notifikasi push seluler.

Untuk membuat EventBridge aturan untuk mengirim pemberitahuan ketika AMI dibuat dan di available negara bagian
  1. Buka EventBridge konsol Amazon di https://console.aws.amazon.com/events/.

  2. Pilih Buat aturan.

  3. Untuk Tentukan detail aturan, lakukan hal berikut:

    1. Masukkan Nama untuk aturan tersebut dan, secara opsional, deskripsi.

      Aturan tidak boleh memiliki nama yang sama dengan aturan lain di Wilayah yang sama dan di bus peristiwa yang sama.

    2. Untuk Bus peristiwa, pilih default. Saat layanan AWS di akun Anda membuat peristiwa, layanan tersebut akan selalu masuk ke bus peristiwa default akun.

    3. Untuk Tipe aturan, pilih Aturan dengan pola peristiwa.

    4. Pilih Selanjutnya.

  4. Untuk Pola peristiwa build, lakukan hal berikut ini:

    1. Untuk sumber Acara, pilih AWSacara atau acara EventBridge mitra.

    2. Untuk Pola peristiwa, untuk contoh ini, Anda akan menentukan pola peristiwa berikut agar sesuai dengan peristiwa EC2 AMI State Change apa pun yang dihasilkan saat AMI memasuki status available:

      { "source": ["aws.ec2"], "detail-type": ["EC2 AMI State Change"], "detail": {"State": ["available"]} }

      Untuk menambahkan pola peristiwa, Anda dapat menggunakan templat dengan memilih Bentuk pola peristiwa, atau menentukan pola Anda sendiri dengan memilih Pola kustom (editor JSON), sebagai berikut:

      1. Untuk menggunakan templat untuk membuat pola peristiwa, lakukan hal berikut:

        1. Pilih Formulir pola peristiwa.

        2. Untuk Sumber peristiwa, pilih Layanan AWS.

        3. Untuk Layanan AWS, pilih EC2.

        4. Untuk Tipe peristiwa, pilih Perubahan Status AMI EC2.

        5. Untuk menyesuaikan templat, pilih Edit pola dan buat perubahan Anda agar sesuai dengan contoh pola peristiwa.

      2. Untuk menentukan pola peristiwa kustom, lakukan hal berikut:

        1. Pilih Pola kustom (editor JSON).

        2. Dalam kotak Pola peristiwa, tambahkan pola peristiwa untuk contoh ini.

    3. Pilih Selanjutnya.

  5. Untuk Pilih target, lakukan hal berikut:

    1. Untuk Tipe Target, pilih Layanan AWS.

    2. Untuk Memilih target, pilih topik SNS untuk mengirim email, pesan teks, atau notifikasi push seluler saat peristiwa tersebut terjadi.

    3. Untuk Topik, pilih topik yang ada. Anda harus terlebih dahulu membuat topik Amazon SNS menggunakan konsol Amazon SNS. Untuk informasi selengkapnya, lihat Menggunakan Amazon SNS untuk pesan application-to-person (A2P) di Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon.

    4. (Opsional) Pada Pengaturan tambahan, Anda dapat mengonfigurasi pengaturan tambahan secara opsional. Untuk informasi selengkapnya, lihat Membuat EventBridge aturan Amazon yang bereaksi terhadap peristiwa (langkah 16) di Panduan EventBridge Pengguna Amazon.

    5. Pilih Selanjutnya.

  6. (Opsional) Untuk Tanda, Anda dapat secara opsional menetapkan satu atau beberapa tanda ke aturan, lalu pilih Berikutnya.

  7. Untuk Tinjau dan buat, lakukan hal berikut:

    1. Tinjau detail aturan dan modifikasi seperlunya.

    2. Pilih Buat aturan.

Untuk informasi selengkapnya, lihat topik berikut di Panduan EventBridge Pengguna Amazon:

Untuk tutorial tentang cara membuat fungsi Lambda dan EventBridge aturan yang menjalankan fungsi Lambda, lihat Tutorial: Mencatat status instans Amazon EC2 menggunakan dalam Panduan Pengembang. EventBridge AWS Lambda