Menyiapkan CloudWatch Tujuan peristiwa untuk penerbitan peristiwa

DenganAmazon CloudWatch metrik, Anda dapat menggunakan tujuan peristiwa untuk memublikasikan peristiwa pengiriman email Amazon SES ke CloudWatch. Karena CloudWatch tujuan peristiwa ada dalam set konfigurasi saja, Anda harus terlebih dahulubuat satu set konfigurasilalu tambahkan tujuan peristiwa ke set konfigurasi.

Ketika Anda menambahkan CloudWatch tujuan peristiwa ke set konfigurasi, Anda harus memilih satu atau lebih CloudWatch dimensiyang sesuai dengan tag pesan yang Anda gunakan saat Anda mengirim email Anda. Seperti tag pesan, a CloudWatch Dimensi adalah pasangan nama/nilai yang membantu Anda mengidentifikasi metrik secara unik.

Misalnya, Anda mungkin memiliki tanda pesan dan dimensi yang disebut campaign yang Anda gunakan untuk mengidentifikasi kampanye email Anda. Saat Anda memublikasikan peristiwa pengiriman email ke CloudWatch, memilih tanda dan dimensi pesan adalah hal yang penting karena pilihan ini memengaruhi Anda CloudWatch penagihan dan menentukan bagaimana Anda dapat memfilter data acara pengiriman email Anda di CloudWatch.

Bagian ini memberikan informasi untuk membantu Anda memilih dimensi, lalu menunjukkan cara menambahkan CloudWatch tujuan peristiwa ke set konfigurasi.

Menambahkan Tujuan Peristiwa CloudWatch

Prosedur di bagian ini menunjukkan cara menambahkan CloudWatch Rincian tujuan peristiwa ke set konfigurasi dan mengasumsikan Anda telah menyelesaikan langkah 1 sampai 6 diMembuat tujuan peristiwa.

Anda juga dapat menggunakan operasi UpdateConfigurationSetEventDestination di API Amazon SES V2 untuk membuat dan mengubah tujuan peristiwa.

Untuk menambahkan CloudWatch Detail tujuan peristiwa ke set konfigurasi menggunakan konsol

1. Ini adalah petunjuk rinci untuk memilih CloudWatch sebagai jenis tujuan acara AndaLangkah 7dan mengasumsikan Anda telah menyelesaikan semua langkah sebelumnya diMembuat tujuan peristiwa. Setelah memilih CloudWatch Jenis tujuandan memungkinkanPenerbitan peristiwa, yangAmazon CloudWatchpanel akan muncul - bidangnya dibahas dalam langkah-langkah berikut.

2. Untuk Nilai Sumber, tentukan cara Amazon SES memperoleh data yang diteruskannya ke CloudWatch. Sumber nilai berikut tersedia:

   • Tanda Pesan – Amazon SES mengambil nama dan nilai dimensi dari tanda yang Anda tentukan dengan menggunakan header X-SES-MESSAGE-TAGS atau parameter API Tags. Untuk informasi selengkapnya tentang penggunaan tanda pesan, lihat Langkah 3: Tentukan set konfigurasi Anda ketika Anda mengirim email.

     catatan

     Tanda pesan dapat mencakup angka 0–9, huruf A–Z (huruf besar dan kecil), tanda hubung (-), dan garis bawah (_).

     Anda juga dapat menggunakan sumber nilai Tanda Pesan untuk membuat dimensi berdasarkan tanda otomatis Amazon SES. Untuk menggunakan tanda otomatis, ketik nama lengkap dari tanda otomatis tersebut sebagai Nama Dimensi. Misalnya, untuk membuat dimensi berdasarkan tanda otomatis set konfigurasi, gunakan ses:configuration-set untuk Nama Dimensi, dan nama set konfigurasi untuk Nilai Default. Untuk daftar lengkap tanda otomatis, lihat Cara kerja penerbitan peristiwa.

   • Header Email – Amazon SES mengambil nama dan nilai dimensi dari header di dalam email.

     catatan

     Anda tidak dapat menggunakan header email berikut sebagai Nama Dimensi: Received, To, From, DKIM-Signature, CC, message-id, atau Return-Path.

   • Tanda Tautan – Amazon SES mengambil nama dan nilai dimensi dari tanda yang Anda tentukan di tautan. Untuk informasi selengkapnya tentang menambahkan tanda ke tautan, lihat Dapatkah saya menandai tautan dengan pengenal unik?.

3. Untuk Nama Dimensi, ketik nama dimensi yang ingin Anda teruskan ke CloudWatch.

   catatan

   Nama dimensi hanya berisi huruf ASCII (a-z, A-Z), angka (0-9), garis bawah (_), dan tanda hubung (-). Spasi, karakter beraksen, karakter non-Latin, dan karakter khusus lainnya tidak diperbolehkan.

4. Untuk Nilai default, ketik nilai dimensi.

   catatan

   Nilai dimensi hanya berisi huruf ASCII (a-z, A-Z), angka (0-9), garis bawah (_), tanda hubung (-), tanda hubung (@), dan titik (.). Spasi, karakter beraksen, karakter non-Latin, dan karakter khusus lainnya tidak diperbolehkan.

5. Jika Anda ingin menambahkan dimensi lagi, pilih Tambahkan Dimensi. Jika tidak, pilih Selanjutnya.

6. Di layar tinjauan, jika Anda puas dengan cara Anda menentukan tujuan peristiwa, pilih Tambahkan tujuan.

Memilih CloudWatch Dimensi

Saat Anda memilih nama dan nilai yang akan digunakan sebagai CloudWatch dimensi, pertimbangkan faktor-faktor berikut:

• Harga per metrik— Anda dapat melihat metrik Amazon SES dasar di CloudWatch gratis. Namun, saat Anda mengumpulkan metrik menggunakan penerbitan peristiwa, buat metrik kustom di CloudWatch. Setiap kombinasi unik tipe peristiwa, nama dimensi, dan nilai dimensi membuat metrik kustom yang berbeda di CloudWatch. Saat Anda menggunakan CloudWatch, Anda akan dikenakan biaya untuk setiap metrik kustom yang Anda buat. Karena alasan ini, Anda mungkin ingin menghindari memilih dimensi yang dapat menghasilkan banyak nilai berbeda. Misalnya, kecuali Anda sangat tertarik untuk melacak peristiwa pengiriman email dengan domain "Dari", Anda mungkin tidak ingin menentukan dimensi untuk tanda otomatis Amazon SES ses:from-domain karena dapat menghasilkan banyak nilai berbeda. Untuk informasi lebih lanjut, lihat Harga CloudWatch.

• Pemfilteran metrik— Jika metrik memiliki beberapa dimensi, Anda tidak dapat mengakses metrik di CloudWatch berdasarkan setiap dimensi secara terpisah. Oleh karena itu, pikirkan baik-baik sebelum Anda menambahkan lebih dari satu dimensi ke satu CloudWatch tujuan peristiwa. Misalnya, jika Anda menginginkan metrik menurut campaign dan menurut kombinasi campaign dan genre, maka Anda perlu menambahkan dua tujuan peristiwa: satu hanya dengan campaign sebagai dimensi, dan satu dengan campaign dan genre sebagai dimensi.

• Sumber nilai dimensi – Sebagai alternatif untuk menentukan nilai dimensi Anda menggunakan header khusus Amazon SES atau parameter ke API, Anda juga dapat memilih Amazon SES untuk mengambil nilai dimensi dari header pesan MIME Anda sendiri. Anda dapat menggunakan opsi ini jika Anda sudah menggunakan header kustom dan tidak ingin mengubah email atau panggilan Anda ke API pengiriman email untuk mengumpulkan metrik berdasarkan nilai header Anda. Jika Anda menggunakan header pesan MIME milik Anda sendiri untuk penerbitan peristiwa Amazon SES, maka nama dan nilai header yang Anda gunakan untuk penerbitan peristiwa Amazon SES hanya dapat menyertakan huruf A sampai Z, angka 0 sampai 9, garis bawah (_), tanda at (@), tanda hubung (-), dan titik (.). Jika Anda menentukan nama atau nilai yang berisi karakter lain, maka panggilan pengiriman email akan tetap berhasil, tetapi metrik peristiwa tidak akan dikirim ke Amazon CloudWatch.

Untuk informasi lebih lanjut tentang CloudWatch konsep, lihatAmazon CloudWatch KonsepdiAmazon CloudWatch Panduan Pengguna.