Mengonfigurasi log untuk bus EventBridge acara Amazon - Amazon EventBridge
Cara kerja loggingMenentukan tingkat logTermasuk detail dalam logMemangkas logPelaporan kesalahan dalam log

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

Mengonfigurasi log untuk bus EventBridge acara Amazon

Anda dapat mengonfigurasi EventBridge untuk mengirim log yang merinci bagaimana bus acara memproses peristiwa, untuk membantu pemecahan masalah dan debugging.

Anda dapat memilih AWS layanan berikut sebagai tujuan log yang EventBridge mengirimkan log untuk bus acara yang ditentukan:

  • CloudWatch Log Amazon

    EventBridge mengirimkan log ke grup log CloudWatch Log yang ditentukan.

    Gunakan CloudWatch Log untuk memusatkan log dari semua sistem, aplikasi, dan AWS layanan yang Anda gunakan, dalam satu layanan yang sangat skalabel. Untuk informasi selengkapnya, lihat Bekerja dengan grup log dan aliran log di Panduan Pengguna CloudWatch Log Amazon.

  • Amazon Data Firehose

    EventBridge mengirimkan log ke aliran pengiriman Firehose.

    Amazon Data Firehose adalah layanan yang dikelola sepenuhnya untuk mengirimkan data streaming real-time ke tujuan seperti AWS layanan tertentu, serta titik akhir HTTP kustom atau titik akhir HTTP yang dimiliki oleh penyedia layanan pihak ketiga yang didukung. Untuk informasi selengkapnya, lihat Membuat aliran pengiriman Amazon Data Firehose di Panduan Pengguna Amazon Data Firehose.

  • Amazon S3

    EventBridge mengirimkan log sebagai objek Amazon S3 ke bucket yang ditentukan.

    Amazon S3 adalah layanan penyimpanan objek yang menawarkan skalabilitas, ketersediaan data, keamanan, dan kinerja terdepan di industri. Untuk informasi selengkapnya, lihat Mengunggah, mengunduh, dan bekerja dengan objek di Amazon S3 di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

Cara kerja logging untuk bus acara

EventBridge menghasilkan log untuk:

  • Acara AWS layanan apa pun yang cocok dengan aturan di bus acara

  • Setiap peristiwa yang disampaikan dengan metode berikut, apakah acara tersebut berhasil tertelan atau tidak sesuai dengan aturan apa pun:

EventBridge tidak mencatat peristiwa yang hanya cocok dengan aturan terkelola.

Data log yang dikirim ke setiap tujuan log yang dipilih adalah sama.

Anda dapat menyesuaikan log yang EventBridge dikirim ke tujuan yang dipilih dengan cara berikut:

  • Anda dapat menentukan tingkat log, yang menentukan langkah-langkah yang EventBridge mengirim log ke tujuan yang dipilih. Untuk informasi selengkapnya, lihat Menentukan tingkat log bus acara.

  • Anda dapat menentukan apakah EventBridge menyertakan informasi yang lebih terperinci bila relevan, termasuk:

    • Detail peristiwa

    • Informasi masukan target

    • Informasi permintaan target

    Untuk informasi selengkapnya, lihat Termasuk data detail dalam log bus acara.

Pertimbangan pengiriman log

Ingatlah pertimbangan berikut saat Anda mengonfigurasi pencatatan untuk bus acara:

  • Catatan log bus acara disampaikan atas dasar upaya terbaik. Sebagian besar permintaan untuk bus peristiwa yang dikonfigurasi dengan benar untuk pencatatan menghasilkan catatan log yang dikirimkan. Kelengkapan dan ketepatan waktu pencatatan bus acara tidak dijamin.

  • Dalam beberapa keadaan, mengirimkan catatan log bus peristiwa itu sendiri menghasilkan peristiwa yang kemudian dikirim ke EventBridge, yang dapat menyebabkan gangguan dalam pengiriman catatan log. Untuk alasan ini, EventBridge tidak mencatat peristiwa berikut:

    • AWS KMS Decryptdan GenerateDataKey peristiwa yang dihasilkan saat catatan log yang dienkripsi menggunakan kunci terkelola pelanggan dikirim ke tujuan log.

    • PutRecordBatchperistiwa di Firehose yang dihasilkan oleh pengiriman log bus acara.

  • Untuk tujuan log S3, menentukan bucket tujuan dengan pemberitahuan peristiwa untuk EventBridge diaktifkan tidak disarankan, karena hal ini dapat mengakibatkan gangguan dalam pengiriman log Anda.

Enkripsi pencatatan

Saat mengirim log, EventBridge mengenkripsi detail dan error bagian dari setiap catatan log dengan kunci KMS yang ditentukan untuk bus acara. Setelah dikirim, catatan didekripsi dan kemudian dienkripsi ulang dengan kunci KMS yang ditentukan untuk tujuan log.

Untuk informasi selengkapnya, lihat Mengenkripsi log bus acara.

Menentukan izin pencatatan bus acara

Untuk mengaktifkan logging dari bus acara, Anda harus memberikan izin EventBridge untuk mengirim log dari bus itu. Tambahkan kebijakan yang diberikan AllowVendedLogDeliveryForResourceke bus acara.

Untuk informasi selengkapnya, lihat Izin khusus layanan di Panduan Pengguna CloudWatch Log.

Menentukan tingkat log bus acara

Anda dapat menentukan jenis langkah pemrosesan peristiwa yang EventBridge log ke tujuan log yang dipilih.

Pilih dari tingkat detail berikut untuk disertakan dalam log. Tingkat log berlaku untuk semua tujuan log yang ditentukan untuk bus acara. Setiap level log mencakup langkah-langkah level log sebelumnya.

  • OFF - EventBridge tidak mengirim log apa pun. Ini adalah opsi default.

  • ERROR — EventBridge mengirimkan log apa pun yang terkait dengan kesalahan yang dihasilkan selama pemrosesan acara dan pengiriman target.

  • INFO — EventBridge mengirimkan log apa pun yang terkait dengan kesalahan, serta langkah-langkah utama yang dilakukan selama pemrosesan acara.

  • TRACE — EventBridge mengirimkan log apa pun yang dihasilkan selama semua langkah dalam pemrosesan acara.

Tabel berikut mencantumkan langkah-langkah pemrosesan peristiwa yang disertakan dalam setiap tingkat log.

Langkah JEJAK INFO ERROR MATI

Acara Tertelan

 x x

Pencerapan Acara Gagal

 x x x

Acara Diterima

 x

Upaya Doa Dimulai

 x

Upaya Doa Kegagalan Permanen

 x x x

Upaya Doa Kegagalan yang Dapat Dicoba Ulang

 x x x

Upaya Doa Berhasil

 x

Upaya Doa Terhambat

 x x x

Doa DLQ

 x x x

Doa Gagal

 x x x

Doa Dimulai

 x x

Doa Berhasil

 x x

Doa Throttle Dimulai

 x x x

Tidak Ada Aturan yang Cocokkan

 x x

Aturan Cocokkan

x x

Pencocokan Aturan Dimulai

x

Termasuk data detail dalam log bus acara

Anda dapat menentukan EventBridge untuk memasukkan informasi yang lebih terperinci dalam log yang dihasilkannya. Data ini dapat berguna untuk pemecahan masalah dan debugging. Jika Anda memilih opsi ini, EventBridge sertakan data ini dalam catatan yang relevan untuk semua tujuan log yang ditentukan.

Informasi detail mencakup bidang-bidang berikut:

  • event_detail: Detail acara itu sendiri.

  • target_input: Permintaan EventBridge dikirim ke target.

  • target_properties:

Memangkas data dalam log bus acara

Karena kendala tujuan log, EventBridge membatasi catatan log hingga 1 MB. Jika catatan log melebihi batas ini, EventBridge potong catatan dengan menghapus bidang berikut dalam urutan berikut:

  • target_input

  • target_properties

  • target_response_body

EventBridge menghapus event_detail bidang dari jenis catatan log berikut jika perlu:

  • EVENT_RECEIVED

  • EVENT_INGESTED

  • EVENT_INGESTED_FAILED

  • RULE_MATCH_STARTED

Jika pemotongan diperlukan, EventBridge hapus seluruh bidang.

Jika EventBridge tidak memotong bidang dalam acara tersebut, dropped_fields bidang tersebut menyertakan daftar bidang data yang dipotong.

Pelaporan kesalahan dalam log bus acara

EventBridge juga mencakup data kesalahan, jika tersedia, dalam langkah-langkah yang mewakili status kegagalan. Langkah-langkah ini meliputi:

  • EVENT_INGEST_FAILURE

  • INVOCATION_THROTTLE_START

  • INVOCATION_ATTEMPT_THROTTLE

  • INVOCATION_ATTEMPT_RETRYABLE_FAILURE

  • INVOCATION_ATTEMPT_PERMANENT_FAILURE

  • INVOCATION_FAILURE

  • INVOCATION_DLQ