View a markdown version of this page

Mengkonfigurasi log untuk bus EventBridge acara Amazon - Amazon EventBridge
Cara kerja loggingMenentukan tingkat logTermasuk detail dalam logMemotong logPelaporan kesalahan di log

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

Mengkonfigurasi 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 tertentu:

  • 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 Bek erja dengan grup log dan aliran log di Panduan CloudWatch Pengguna Amazon Log.

  • 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 Meng unggah, 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:

  • Setiap peristiwa AWS layanan yang cocok dengan aturan di bus acara

  • Setiap peristiwa yang disampaikan dengan metode berikut, terlepas dari apakah acara berhasil dicerna atau cocok dengan aturan apa pun:

EventBridge tidak mencatat peristiwa yang hanya cocok dengan aturan ter kelola.

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 mengirimkan log ke tujuan yang dipilih. Untuk informasi selengkapnya, lihat Menentukan tingkat log bus acara.

  • Anda dapat menentukan apakah menyer EventBridge takan 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 logging untuk bus acara:

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

  • Dalam beberapa keadaan, pengiriman 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 ketika catatan log dienkripsi menggunakan kunci yang dikelola pelanggan dikirim ke tujuan log.

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

  • Untuk tujuan log S3, menentukan bucket tujuan dengan notifikasi 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, lampirkan kebijakan berbasis identitas berikut ke identitas AWS Identity and Access Management (IAM) Anda (pengguna atau peran). Kebijakan ini memberikan events:AllowVendedLogDeliveryForResource tindakan untuk bus acara.

JSON
{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "ServiceLevelAccessForLogDelivery",
            "Effect": "Allow",
            "Action": [
                "events:AllowVendedLogDeliveryForResource"
            ],
            "Resource": "arn:aws:events:us-east-1:123456789012:event-bus/my-event-bus*"
        }
    ]
}

Untuk informasi selengkapnya, lihat Service-specific izin di Panduan Pengguna CloudWatch Log.

Menentukan tingkat log bus acara

Anda dapat menentukan jenis langkah pemrosesan peristiwa yang mencatat EventBridge 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 tingkat log mencakup langkah-langkah dari level log sebelumnya.

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

  • ER ROR — 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

Penyerapan Acara Gagal

 x x x

Acara Diterima

 x

Upaya Pemanggilan Dimulai

 x

Upaya Panggilan Kegagalan Permanen

 x x x

Kegagalan Upaya Pang Retry-able gilan

 x x x

Upaya Panggilan Berhasil

 x

Upaya Panggilan Dibatasi

 x x x

Pemanggilan DLQ

 x x x

Pemanggilan Gagal

 x x x

Pemanggilan Dimulai

 x x

Pemanggilan Berhasil

 x x

Throttle Pemanggilan Dimulai

 x x x

Tidak Ada Aturan yang Cocokan

 x x

Aturan Cocokkan

x x

Pencocokan Aturan Dimulai

x

Termasuk data detail dalam log bus acara

Anda dapat menentukan EventBridge untuk menyertakan 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 meliputi bidang-bidang berikut:

  • event_detail: Detail acara itu sendiri.

  • target_input: Permintaan EventBridge dikirim ke target.

  • target_properties:

Memotong data dalam log bus acara

Karena kendala tujuan log, EventBridge membatasi catatan log menjadi 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, hapus EventBridge seluruh bidang.

Jika EventBridge memotongkan 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