Pencatatan kinerja Amazon EventBridge Pipes

EventBridge Pencatatan pipa memungkinkan Anda meminta EventBridge Pipa mengirim catatan yang merinci kinerja pipa ke AWS layanan yang didukung. Gunakan log untuk mendapatkan wawasan tentang kinerja eksekusi pipa Anda, dan untuk membantu pemecahan masalah dan debugging.

Anda dapat memilih AWS layanan berikut sebagai tujuan log tempat EventBridge Pipes mengirimkan catatan:

• CloudWatch Log

  EventBridge mengirimkan catatan 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.

• Log aliran Firehose

  EventBridge mengirimkan catatan 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 atau HTTP titik akhir khusus yang dimiliki oleh penyedia layanan pihak ketiga yang HTTP didukung. Untuk informasi selengkapnya, lihat Membuat aliran pengiriman Amazon Data Firehose di Panduan Pengguna Amazon Data Firehose.

• Log Amazon S3

  EventBridge mengirimkan catatan 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 pencatatan Amazon EventBridge Pipes

Eksekusi pipa adalah peristiwa atau kumpulan peristiwa yang diterima oleh pipa yang melakukan perjalanan ke pengayaan dan/atau target. Jika diaktifkan, EventBridge buat catatan log untuk setiap langkah eksekusi yang dilakukannya saat batch acara diproses. Informasi yang terkandung dalam catatan berlaku untuk batch acara, baik itu acara tunggal atau hingga 10.000 acara.

Anda dapat mengonfigurasi ukuran batch acara pada sumber pipa dan target. Untuk informasi selengkapnya, lihat Pengelompokan dan konkurensi EventBridge Pipa Amazon.

Data rekaman yang dikirim ke setiap tujuan log adalah sama.

Jika tujuan Amazon CloudWatch Logs dikonfigurasi, catatan log yang dikirimkan ke semua tujuan memiliki batas 256kb. Bidang akan dipotong seperlunya.

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

• Anda dapat menentukan tingkat log, yang menentukan langkah-langkah eksekusi yang EventBridge mengirimkan catatan ke tujuan log yang dipilih. Untuk informasi selengkapnya, lihat Menentukan tingkat log EventBridge Pipa.

• Anda dapat menentukan apakah EventBridge Pipes menyertakan data eksekusi dalam catatan untuk langkah-langkah eksekusi yang relevan. Data ini meliputi:

  • Muatan batch acara

  • Permintaan dikirim ke AWS pengayaan atau layanan target

  • Respons yang dikembalikan oleh AWS pengayaan atau layanan target

  Untuk informasi selengkapnya, lihat Termasuk data eksekusi di log EventBridge Pipes.

Menentukan tingkat log EventBridge Pipa

Anda dapat menentukan jenis langkah eksekusi yang EventBridge mengirimkan catatan ke tujuan log yang dipilih.

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

• OFF— EventBridge tidak mengirim catatan apa pun ke tujuan log tertentu. Ini adalah pengaturan default.

• ERROR— EventBridge mengirimkan catatan apa pun yang terkait dengan kesalahan yang dihasilkan selama eksekusi pipa ke tujuan log yang ditentukan.

• INFO— EventBridge mengirim catatan apa pun yang terkait dengan kesalahan, serta memilih langkah-langkah lain yang dilakukan selama eksekusi pipa ke tujuan log yang ditentukan.

• TRACE— EventBridge mengirimkan catatan apa pun yang dihasilkan selama setiap langkah dalam eksekusi pipa ke tujuan log yang ditentukan.

Di EventBridge konsol, CloudWatch log dipilih sebagai tujuan log secara default, seperti tingkat ERROR log. Jadi, secara default, EventBridge Pipes membuat grup CloudWatch log baru yang mengirimkan catatan log yang berisi ERROR tingkat detail. Tidak ada default yang dipilih saat Anda mengonfigurasi log secara terprogram.

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

Langkah	TRACE	INFO	ERROR	OFF
Eksekusi Gagal	x	x	x
Eksekusi Sebagian Gagal	x	x	x
Eksekusi Dimulai	x	x
Eksekusi Berhasil	x	x
Eksekusi Dibatasi	x	x	x
Batas Waktu Eksekusi	x	x	x
Doa Pengayaan Gagal	x	x	x
Doa Pengayaan Dilewati	x	x
Doa Pengayaan Dimulai	x
Doa Pengayaan Berhasil	x
Tahap Pengayaan Dimasukkan	x	x
Tahap Pengayaan Gagal	x	x	x
Tahap Pengayaan Berhasil	x	x
Transformasi Pengayaan Gagal	x	x	x
Transformasi Pengayaan Dimulai	x
Transformasi Pengayaan Berhasil	x
Doa Target Gagal	x	x	x
Doa Target Sebagian Gagal	x	x	x
Doa Target Dilewati	x
Doa Target Dimulai	x
Doa Target Berhasil	x
Tahap Target Dimasukkan	x	x
Tahap Target Gagal	x	x	x
Tahap Target Sebagian Gagal	x	x	x
Tahap Target Dilewati	x
Tahap Target Berhasil	x	x
Transformasi Target Gagal	x	x	x
Transformasi Target Dimulai	x
Transformasi Target Berhasil	x

Termasuk data eksekusi di log EventBridge Pipes

Anda dapat menentukan EventBridge untuk menyertakan data eksekusi dalam catatan yang dihasilkannya. Data eksekusi mencakup bidang yang mewakili muatan batch peristiwa, serta permintaan yang dikirim ke dan respons dari pengayaan dan target.

Data eksekusi berguna untuk pemecahan masalah dan debugging. payloadBidang berisi konten aktual dari setiap peristiwa yang disertakan dalam batch, memungkinkan Anda untuk menghubungkan peristiwa individual dengan eksekusi pipa tertentu.

Jika Anda memilih untuk menyertakan data eksekusi, itu termasuk untuk semua tujuan log yang ditentukan untuk pipa.

penting

Bidang ini mungkin berisi informasi sensitif. EventBridge tidak berusaha untuk menyunting konten bidang ini selama pencatatan.

Saat menyertakan data eksekusi, EventBridge tambahkan bidang berikut ke catatan yang relevan:

• payload

  Merupakan isi dari batch acara yang sedang diproses oleh pipa.

  EventBridge termasuk payload bidang dalam catatan yang dihasilkan pada langkah-langkah di mana konten batch acara mungkin telah diperbarui. Ini termasuk langkah-langkah berikut:

  • EXECUTION_STARTED

  • ENRICHMENT_TRANSFORMATION_SUCCEEDED

  • ENRICHMENT_STAGE_SUCCEEDED

  • TARGET_TRANSFORMATION_SUCCEEDED

  • TARGET_STAGE_SUCCEEDED

• awsRequest

  Merupakan permintaan yang dikirim ke pengayaan atau target sebagai JSON string. Untuk permintaan yang dikirim ke API tujuan, ini mewakili HTTP permintaan yang dikirim ke titik akhir tersebut.

  EventBridge mencakup awsRequest bidang dalam catatan yang dihasilkan pada langkah akhir pengayaan dan penargetan; yaitu, setelah EventBridge mengeksekusi atau mencoba untuk mengeksekusi permintaan terhadap pengayaan atau layanan target yang ditentukan. Ini termasuk langkah-langkah berikut:

  • ENRICHMENT_INVOCATION_FAILED

  • ENRICHMENT_INVOCATION_SUCCEEDED

  • TARGET_INVOCATION_FAILED

  • TARGET_INVOCATION_PARTIALLY_FAILED

  • TARGET_INVOCATION_SUCCEEDED

• awsResponse

  Merupakan respons yang dikembalikan oleh pengayaan atau target, dalam JSON format. Untuk permintaan yang dikirim ke API tujuan, ini mewakili HTTP respons yang dikembalikan dari titik akhir tersebut.

  Seperti halnyaawsRequest, EventBridge termasuk awsResponse bidang dalam catatan yang dihasilkan pada langkah akhir pengayaan dan penargetan; yaitu, setelah EventBridge mengeksekusi atau mencoba untuk mengeksekusi permintaan terhadap pengayaan atau layanan target yang ditentukan dan menerima tanggapan. Ini termasuk langkah-langkah berikut:

  • ENRICHMENT_INVOCATION_FAILED

  • ENRICHMENT_INVOCATION_SUCCEEDED

  • TARGET_INVOCATION_FAILED

  • TARGET_INVOCATION_PARTIALLY_FAILED

  • TARGET_INVOCATION_SUCCEEDED

Untuk diskusi tentang langkah-langkah eksekusi pipa, lihatEventBridge Langkah eksekusi pipa.

Mempotong data eksekusi dalam catatan log EventBridge Pipes

Jika Anda memilih untuk EventBridge menyertakan data eksekusi dalam catatan log pipa, ada kemungkinan bahwa catatan dapat melebihi batas ukuran 256 KB. Untuk mencegah hal ini, EventBridge secara otomatis memotong bidang data eksekusi, dalam urutan berikut. EventBridge memotong setiap bidang seluruhnya sebelum melanjutkan untuk memotong bidang berikutnya. EventBridge memotong data bidang hanya dengan menghapus karakter dari akhir string data; tidak ada upaya yang dilakukan untuk memotong berdasarkan kepentingan data, dan pemotongan akan membatalkan pemformatan. JSON

• payload

• awsRequest

• awsResponse

Jika EventBridge tidak memotong bidang dalam acara tersebut, truncatedFields bidang tersebut menyertakan daftar bidang data terpotong.

Pelaporan kesalahan dalam catatan log EventBridge Pipes

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

• ExecutionThrottled

• ExecutionTimeout

• ExecutionFailed

• ExecutionPartiallyFailed

• EnrichmentTransformationFailed

• EnrichmentInvocationFailed

• EnrichmentStageFailed

• TargetTransformationFailed

• TargetInvocationFailed

• TargetInvocationPartiallyFailed

• TargetStageFailed

• TargetStagePartiallyFailed