Memantau SES peristiwa menggunakan Amazon EventBridge

EventBridge adalah layanan tanpa server yang menggunakan peristiwa untuk menghubungkan komponen aplikasi bersama-sama, sehingga memudahkan Anda untuk membangun aplikasi berbasis peristiwa yang dapat diskalakan. Arsitektur berbasis peristiwa adalah gaya membangun sistem perangkat lunak yang digabungkan secara longgar yang bekerja sama dengan memancarkan dan menanggapi peristiwa. Peristiwa adalah pesan JSON berformat yang biasanya mewakili perubahan dalam sumber daya atau lingkungan, atau acara manajemen lainnya.

SESFitur tertentu akan menghasilkan dan mengirim acara yang Anda tentukan saat membuat tujuan acara ke bus acara EventBridge default. Bus acara adalah router yang menerima acara dan mengirimkannya ke nol atau lebih tujuan, atau target. Aturan yang Anda kaitkan dengan bus acara mengevaluasi acara saat mereka tiba. Setiap aturan memeriksa apakah suatu peristiwa cocok dengan pola aturan. Jika acara tidak cocok, EventBridge kirimkan acara ke target yang ditentukan.

SESmengirimkan peristiwa ke EventBridge saat fitur memiliki perubahan status atau pembaruan status. Anda dapat menggunakan EventBridge aturan untuk merutekan peristiwa ke target yang ditentukan. Acara-acara ini akan disampaikan dengan upaya terbaik, dan mereka mungkin dikirim rusak.

SESacara

Peristiwa berikut dihasilkan oleh SES fitur dan dikirim ke bus acara default di EventBridge. Untuk informasi selengkapnya, termasuk data detail untuk setiap jenis acara, lihatSESreferensi skema acara.

SESreferensi skema acara

Semua peristiwa dari AWS layanan memiliki seperangkat bidang umum yang berisi metadata tentang acara tersebut, seperti AWS layanan yang merupakan sumber acara, waktu acara dibuat, akun dan wilayah tempat acara berlangsung, dan lainnya. Untuk definisi bidang umum ini, lihat Referensi struktur acara di Panduan EventBridge Pengguna.

Selain itu, setiap acara memiliki detail bidang yang berisi data khusus untuk peristiwa tertentu. Referensi di bawah ini mendefinisikan bidang detail untuk berbagai SES acara.

Saat menggunakan EventBridge untuk memilih dan mengelola SES acara, penting untuk mengingat hal berikut:

Skema status penasihat Manajer Pengiriman Virtual

Referensi skema berikut mendefinisikan bidang khusus untuk peristiwa status penasihat Virtual Deliverability Manager.

Definisi untuk bidang umum yang muncul di semua skema acara (sepertiversion,, idaccount, dan lainnya) dapat ditemukan dalam referensi struktur Acara di Panduan EventBridge Pengguna. detail-typeBidang source dan disertakan dalam referensi di bawah ini karena berisi nilai SES -spesifik untuk SES acara.

{
 "version": "0",
  "id": "abcd9999-ef33-0123-90ab-abcdef666666",
  "detail-type": "Advisor Recommendation Status Open",
  "source": "aws.ses",
  "account": "012345678901",
  "time": "2023-11-15T17:00:59Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:ses:us-east-1:012345678901:identity/vdm.events-publishing.cajun.syster-games.example.com"
  ],
  "detail": { "version": "1.0.0", "data": "SPF record was not found." }
}

SESskema status pengiriman email

Referensi skema berikut mendefinisikan bidang khusus untuk peristiwa status pengiriman SES email.

Definisi untuk bidang umum yang muncul di semua skema acara (sepertiversion,, idaccount, dan lainnya) dapat ditemukan dalam referensi struktur Acara di Panduan EventBridge Pengguna. detail-typeBidang source dan disertakan dalam referensi di bawah ini karena berisi nilai SES -spesifik untuk SES acara.

{
  "version": "0",
  "id": "12a18625-3328-fafd-2809-a5e16004f112",
  "detail-type": "Email Rendering Failed",
  "source": "aws.ses",
  "account": "123456789012",
  "time": "2023-07-17T16:48:05Z",
  "region": "us-east-1",
  "resources": ["arn:aws:ses:us-east-1:123456789012:identity/example.com"],
  "detail": {
    "eventType": "Rendering Failure",
    "mail": {
      "timestamp": "2018-01-22T18:43:06.197Z",
      "source": "sender@example.com",
      "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
      "sendingAccountId": "123456789012",
      "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
      "destination": ["recipient@example.com"],
      "headersTruncated": false,
      "tags": {
        "ses:configuration-set": ["ConfigSet"]
      }
    },
    "failure": {
      "errorMessage": "Attribute 'attributeName' is not present in the rendering data.",
      "templateName": "MyTemplate"
    }
  }
}

Menggunakan EventBridge dengan SES acara

Secara default, SES mengirimkan acara ke bus acara EventBridge default. Anda dapat membuat aturan pada bus acara default untuk mengidentifikasi peristiwa tertentu untuk dikirim EventBridge ke satu atau beberapa target yang ditentukan. Setiap aturan berisi pola acara yang EventBridge digunakan untuk mencocokkan acara saat mereka tiba di bus acara. Jika suatu peristiwa cocok dengan pola acara untuk aturan tertentu, EventBridge kirimkan acara ke target yang ditentukan dalam aturan.

Dalam EventBridge, mendefinisikan pola acara biasanya merupakan bagian dari proses yang lebih besar untuk membuat aturan baru atau mengedit yang sudah ada. Untuk mempelajari cara membuat EventBridge aturan, lihat Membuat EventBridge aturan Amazon yang bereaksi terhadap peristiwa di Panduan EventBridge Pengguna.

Dengan menggunakan fitur Sandbox di EventBridge, Anda dapat dengan cepat menentukan pola peristiwa dan menggunakan contoh peristiwa untuk mengonfirmasi pola cocok dengan peristiwa yang diinginkan, tanpa harus terlebih dahulu membuat atau mengedit aturan. Untuk petunjuk mendetail tentang penggunaan Kotak Pasir, lihat Menguji pola peristiwa menggunakan EventBridge Kotak Pasir di EventBridge Panduan Pengguna.

Tentukan SES contoh peristiwa di Kotak EventBridge Pasir

Anda dapat memilih contoh peristiwa untuk SES acara untuk menggunakannya dalam menguji pola acara yang Anda buat.

Membuat dan menguji pola acara untuk SES acara

Setelah Anda memilih contoh peristiwa, seperti yang dijelaskan di bagian sebelumnya, Anda dapat membuat pola acara dan menggunakan contoh peristiwa untuk memastikannya cocok dengan peristiwa yang diinginkan.

EventBridge Sumber daya tambahan

Lihat topik berikut di Panduan EventBridge Pengguna Amazon untuk informasi selengkapnya tentang cara menggunakan EventBridge untuk memproses dan mengelola acara.