Menyiapkan tujuan CloudWatch acara untuk penerbitan acara - Layanan Email Sederhana Amazon

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

Menyiapkan tujuan CloudWatch acara untuk penerbitan acara

Dengan CloudWatch metrik Amazon, Anda dapat menggunakan tujuan acara untuk mempublikasikan acara pengiriman email Amazon SES. CloudWatch Karena tujuan CloudWatch acara hanya dapat diatur dalam set konfigurasi, Anda harus terlebih dahulu membuat set konfigurasi dan kemudian menambahkan tujuan acara ke set konfigurasi.

Saat menambahkan tujuan CloudWatch acara ke set konfigurasi, Anda harus memilih satu atau beberapa CloudWatch dimensi yang sesuai dengan tag pesan yang Anda gunakan saat mengirim email. Seperti tag pesan, 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. Ketika Anda mempublikasikan acara pengiriman email ke CloudWatch, memilih tag dan dimensi pesan Anda penting karena pilihan ini memengaruhi CloudWatch penagihan Anda dan menentukan bagaimana Anda dapat memfilter data peristiwa pengiriman email Anda. CloudWatch

Bagian ini memberikan informasi untuk membantu Anda memilih dimensi, dan kemudian menunjukkan cara menambahkan tujuan CloudWatch acara ke set konfigurasi.

Menambahkan Destinasi CloudWatch Acara

Prosedur di bagian ini menunjukkan cara menambahkan detail tujuan CloudWatch acara ke set konfigurasi dan mengasumsikan Anda telah menyelesaikan langkah 1 hingga 6 inci. Membuat tujuan acara

Anda juga dapat menggunakan operasi UpdateConfigurationSetEventTujuan di Amazon SES API V2 untuk membuat dan memodifikasi tujuan acara.

Untuk menambahkan detail tujuan CloudWatch acara ke set konfigurasi menggunakan konsol
  1. Ini adalah petunjuk terperinci untuk memilih CloudWatch sebagai jenis tujuan acara Anda di Langkah 7 dan mengasumsikan Anda telah menyelesaikan semua langkah sebelumnya. Membuat tujuan acara Setelah memilih jenis CloudWatch Tujuan, memasukkan Nama tujuan, dan mengaktifkan penerbitan Acara, panel CloudWatch dimensi Amazon akan ditampilkan—bidangnya akan dibahas dalam langkah-langkah berikut. (Biaya tambahan berlaku, lihat Harga per metrik untuk CloudWatch.)

  2. Untuk Sumber Nilai, tentukan bagaimana Amazon SES akan mendapatkan data yang diteruskan 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 EmailTags. Untuk informasi selengkapnya tentang penggunaan tanda pesan, lihat Langkah 3: Tentukan set konfigurasi saat 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 acara dengan set konfigurasi dan tag pesan.

    • 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 lewati CloudWatch.

    catatan

    Nama dimensi hanya dapat 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 dapat berisi huruf ASCII (a-z, A-Z), angka (0-9), garis bawah (_), tanda hubung (-), pada tanda (@), 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 untuk digunakan sebagai CloudWatch dimensi, pertimbangkan faktor-faktor berikut:

  • Harga per metrik — Anda dapat melihat metrik dasar Amazon SES secara CloudWatch gratis. Namun, ketika Anda mengumpulkan metrik menggunakan penerbitan acara, Anda dikenakan biaya Pemantauan CloudWatch Terperinci. Setiap kombinasi unik dari jenis peristiwa, nama dimensi, dan nilai dimensi menciptakan metrik yang berbeda CloudWatch. Saat Anda menggunakan CloudWatch, Pemantauan Terperinci, Anda dikenakan biaya untuk setiap metrik. 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 selengkapnya, silakan lihat Harga CloudWatch.

  • Pemfilteran metrik — Jika metrik memiliki beberapa dimensi, Anda tidak dapat mengakses metrik CloudWatch berdasarkan setiap dimensi secara terpisah. Untuk alasan itu, pikirkan baik-baik sebelum Anda menambahkan lebih dari satu dimensi ke satu tujuan CloudWatch acara. 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, panggilan pengiriman email akan tetap berhasil, tetapi metrik acara tidak akan dikirim ke Amazon CloudWatch.

Untuk informasi selengkapnya tentang CloudWatch konsep, lihat CloudWatch Konsep Amazon di Panduan CloudWatch Pengguna Amazon.