Tutorial: Mengirim Pemberitahuan Amazon Simple Notification Service untuk Peristiwa Tugas Gagal

Dalam tutorial ini, Anda mengonfigurasi aturan EventBridge acara yang hanya menangkap peristiwa pekerjaan di mana pekerjaan telah pindah ke FAILED status. Pada akhir tutorial ini, Anda juga dapat secara opsional mengirim tugas ke antrean tugas ini. Ini untuk menguji bahwa Anda telah mengonfigurasi pemberitahuan Amazon SNS Anda dengan benar.

Prasyarat

Tutorial ini mengasumsikan bahwa Anda memiliki lingkungan komputasi yang berfungsi dan antrean tugas yang siap untuk menerima tugas. Jika Anda tidak memiliki lingkungan komputasi yang berjalan dan antrean tugas untuk menangkap peristiwa, ikuti langkah-langkah di Memulai dengan AWS Batch untuk membuatnya.

Langkah 1: Buat dan Berlangganan Topik Amazon SNS

Untuk tutorial ini, Anda mengonfigurasi topik Amazon SNS yang berfungsi sebagai target peristiwa untuk aturan peristiwa baru Anda.

Untuk membuat topik Amazon SNS

1. Buka konsol Amazon SNS di https://console.aws.amazon.com/sns/v3/home.

2. Pilih Topics (Topik), Create topic (Buat topik).

3. Untuk Tipe, pilih Standar.

4. Untuk Nama, masukkan JobFailedAlert dan pilih Buat topik.

5. Di JobFailedAlertlayar, pilih Buat langganan.

6. Untuk Protokol, pilih Email.

7. UntukTitik akhir, masukkan alamat email yang Anda dapat mengaksesnya dan pilih Buat langganan.

8. Periksa akun email Anda dan tunggu sampai Anda menerima pesan email konfirmasi langganan. Saat Anda menerimanya, pilih Konfirmasi langganan.

Langkah 2: Daftarkan Aturan Peristiwa

Selanjutnya, daftarkan aturan peristiwa yang hanya menangkap peristiwa tugas gagal.

Untuk mendaftarkan EventBridge aturan Anda

1. Buka EventBridge konsol Amazon di https://console.aws.amazon.com/events/.

2. Di panel navigasi, pilih Aturan.

3. Pilih Buat aturan.

4. Masukkan nama dan deskripsi untuk aturan.

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

5. Untuk bus acara, pilih bus acara yang ingin Anda kaitkan dengan aturan ini. Jika Anda ingin aturan ini cocok dengan acara yang berasal dari akun Anda, pilih bus acara AWS default. Ketika AWS layanan di akun Anda memancarkan suatu acara, itu selalu masuk ke bus acara default akun Anda.

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

7. Pilih Selanjutnya.

8. Untuk sumber acara, pilih Lainnya.

9. Untuk pola Acara, pilih Pola kustom (editor JSON).

10. Tempel pola peristiwa berikut ke area teks.

    {
      "detail-type": [
        "Batch Job State Change"
      ],
      "source": [
        "aws.batch"
      ],
      "detail": {
        "status": [
          "FAILED"
        ]
      }
    }

    Kode ini mendefinisikan EventBridge aturan yang cocok dengan peristiwa apa pun di mana status pekerjaan beradaFAILED. Untuk informasi selengkapnya tentang pola peristiwa, lihat Peristiwa dan Pola Peristiwa di Panduan EventBridge Pengguna Amazon.

11. Pilih Berikutnya.

12. Untuk Jenis target, pilih Layanan AWS .

13. Untuk Pilih target, pilih topik SNS, dan untuk Topik, pilih JobFailedAlert.

14. (Opsional) Untuk pengaturan tambahan, lakukan hal berikut:

    1. Untuk Masa peristiwa maksimal, masukkan nilai antara satu menit (00:01) dan 24 jam (24:00).

    2. Untuk Upaya coba lagi, masukkan angka antara 0 dan 185.

    3. Untuk antrian Dead-letter, pilih apakah akan menggunakan antrean Amazon SQS standar sebagai antrian huruf mati. EventBridge mengirimkan peristiwa yang cocok dengan aturan ini ke antrian huruf mati jika tidak berhasil dikirim ke target. Lakukan salah satu hal berikut:

       • Pilih Tidak ada untuk tidak menggunakan antrean surat mati.

       • Pilih Pilih antrean Amazon SQS di AWS akun saat ini untuk digunakan sebagai antrian huruf mati dan kemudian pilih antrian yang akan digunakan dari tarik-turun.

       • Pilih Pilih antrean Amazon SQS di AWS akun lain sebagai antrian huruf mati dan kemudian masukkan ARN antrian yang akan digunakan. Anda harus melampirkan kebijakan berbasis sumber daya ke antrian yang memberikan EventBridge izin untuk mengirim pesan ke antrean tersebut. Untuk informasi selengkapnya, lihat Memberikan izin untuk antrean huruf mati di Panduan Pengguna Amazon. EventBridge

15. Pilih Berikutnya.

16. (Opsional) Masukkan satu atau lebih tanda untuk aturan. Untuk informasi selengkapnya, lihat EventBridge tag Amazon di Panduan EventBridge Pengguna Amazon.

17. Pilih Berikutnya.

18. Tinjau detail aturan dan pilih Buat aturan.

Langkah 3: Uji Aturan Anda

Untuk menguji aturan Anda, kirim tugas yang keluar segera setelah dimulai dengan kode keluar bukan nol. Jika aturan acara Anda dikonfigurasi dengan benar, Anda akan menerima pesan email dalam beberapa menit dengan teks peristiwa.

Untuk menguji aturan

1. Buka AWS Batch konsol di https://console.aws.amazon.com/batch/.

2. Kirim AWS Batch pekerjaan baru. Untuk informasi selengkapnya, lihat Mengirimkan pekerjaan. Untuk perintah tugas, ganti perintah ini untuk keluar dari kontainer dengan kode keluar 1.

   /bin/sh, -c, 'exit 1'

3. Periksa email Anda untuk mengonfirmasi bahwa Anda menerima pemberitahuan email untuk notifikasi tugas yang gagal.

Aturan alternatif: Antrian Pekerjaan Batch Diblokir

Untuk membuat aturan acara yang memantau Antrian Pekerjaan Batch Diblokir, ulangi langkah-langkah dalam tutorial ini dengan perubahan berikut:

1. Pada Langkah 1, gunakan BlockedJobQueuesebagai nama topik.

2. Pada Langkah 2, gunakan pola berikut di editor JSON:

   {
      "detail-type": [
        "Batch Job Queue Blocked"
      ],
      "source": [
        "aws.batch"
      ]
   }