Menggunakan antrian surat mati untuk memproses peristiwa yang tidak terkirim di EventBridge

Untuk menghindari kehilangan peristiwa setelah gagal dikirim ke target, Anda dapat mengkonfigurasi antrean surat mati (DLQ) dan mengirim semua peristiwa gagal untuk diproses kemudian.

EventBridge DLQ adalah antrian Amazon SQS standar yang digunakan EventBridge untuk menyimpan peristiwa yang tidak berhasil dikirim ke target. Ketika Anda membuat aturan dan menambahkan target, Anda dapat memilih menggunakan DLQ atau tidak. Bila Anda mengonfigurasi DLQ, Anda dapat mempertahankan setiap peristiwa yang tidak berhasil dikirim. Kemudian Anda dapat menyelesaikan masalah yang mengakibatkan pengiriman peristiwa gagal dan memproses peristiwa di lain waktu.

Saat Anda mengonfigurasi DLQ untuk target aturan, EventBridge mengirimkan peristiwa dengan pemanggilan gagal ke antrian Amazon SQS yang dipilih.

Kesalahan peristiwa ditangani dengan cara yang berbeda. Beberapa peristiwa dibatalkan atau dikirim ke DLQ tanpa upaya mencoba lagi. Misalnya, untuk kesalahan akibat hilangnya izin ke target, sumber daya target yang tidak ada lagi, atau target yang tidak dapat ditemukan karena alamat yang tidak valid atau kegagalan pencarian DNS, upaya percobaan ulang tidak akan terjadi sampai tindakan diambil untuk menyelesaikan masalah yang mendasarinya. EventBridge mengirimkan peristiwa ini langsung ke DLQ target, jika Anda telah menentukannya.

Ketika pengiriman acara gagal, EventBridge menerbitkan peristiwa ke CloudWatch metrik Amazon yang menunjukkan bahwa target invocation gagal. Jika Anda menggunakan DLQ, metrik tambahan dikirim ke CloudWatch termasuk InvocationsSentToDLQ danInvocationsFailedToBeSentToDLQ.

Anda juga dapat menentukan DLQ untuk bus acara, jika Anda menggunakannya AWS KMS kunci yang dikelola pelanggan untuk mengenkripsi acara saat istirahat. Untuk informasi selengkapnya, lihat Menggunakan antrian huruf mati untuk menangkap kesalahan peristiwa terenkripsi di EventBridge.

Setiap pesan di DLQ Anda akan menyertakan atribut khusus berikut:

Video berikut membahas pengaturan DLQ:

Pertimbangan untuk menggunakan antrean surat mati

Pertimbangkan hal berikut saat mengonfigurasi DLQ untuk EventBridge.

Memberikan izin untuk antrean surat mati

Agar berhasil mengirimkan acara ke antrian, EventBridge harus memiliki izin untuk melakukannya. Saat Anda menentukan DLQ menggunakan EventBridge konsol, izin ditambahkan secara otomatis. Hal ini mencakup:

Jika Anda menentukan DLQ menggunakan API, atau menggunakan antrian yang ada di AWS akun lain, Anda harus membuat kebijakan berbasis sumber daya secara manual yang memberikan izin yang diperlukan dan kemudian melampirkannya ke antrian.

Contoh izin antrian huruf mati target

Kebijakan berbasis sumber daya berikut menunjukkan cara memberikan izin yang diperlukan untuk mengirim pesan acara EventBridge ke antrian Amazon SQS. Contoh kebijakan memberikan izin EventBridge layanan untuk menggunakan SendMessage operasi untuk mengirim pesan ke antrian bernama "MyEventDLQ”. Antrian harus berada di Wilayah us-west-2 di AWS akun 123456789012. Per Condition nyataan ini hanya mengizinkan permintaan yang berasal dari aturan bernama "MyTestRule" yang dibuat di Wilayah us-west-2 di AWS akun 123456789012.

{
  "Sid": "Dead-letter queue permissions",
  "Effect": "Allow",
  "Principal": {
     "Service": "events.amazonaws.com"
  },
  "Action": "sqs:SendMessage",
  "Resource": "arn:aws:sqs:us-west-2:123456789012:MyEventDLQ",
  "Condition": {
    "ArnEquals": {
      "aws:SourceArn": "arn:aws:events:us-west-2:123456789012:rule/MyTestRule"
    }
  }
}

Contoh izin antrian huruf mati bus acara

Kebijakan berbasis sumber daya berikut menunjukkan cara memberikan izin yang diperlukan saat menentukan DLQ untuk bus acara. Dalam hal ini, aws:SourceArn menentukan ARN bus acara yang mengirim peristiwa ke DLQ. Di sini sekali lagi dalam contoh ini, antrian harus berada di Wilayah yang sama dengan bus acara.

{
  "Sid": "Dead-letter queue permissions",
  "Effect": "Allow",
  "Principal": {
     "Service": "events.amazonaws.com"
  },
  "Action": "sqs:SendMessage",
  "Resource": "arn:aws:sqs:region:account-id:queue-name",
  "Condition": {
    "ArnEquals": {
      "aws:SourceArn": "arn:aws:events:region:account-id:event-bus/event-bus-arn"
    }
  }
}

Untuk melampirkan kebijakan ke antrean, gunakan konsol Amazon SQS, buka antrean, lalu pilih Kebijakan akses dan edit kebijakan. Anda juga dapat menggunakan AWS CLI. Untuk mempelajari selengkapnya, lihat Izin Amazon SQS.

Bagaimana cara mengirim ulang peristiwa antrean surat mati

Anda dapat memindahkan pesan dari DLQ dengan dua cara: