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 ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) 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 ](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) 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 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/uploading-downloading-objects.html) 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:
+ Acara dari sumber acara [ mitra ](eb-saas.md)
+ Acara [ diputar ulang dari arsip ](eb-archive.md)
+ Acara dikirim ke bus melalui [`PutEvents`](eb-putevents.md)
EventBridge tidak mencatat peristiwa yang hanya cocok dengan aturan ter [ kelola](eb-rules.md#eb-rules-managed).
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](#eb-event-bus-logs-level).
+ 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](#eb-event-logs-data).
### 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 `[Decrypt](https://docs.aws.amazon.com/kms/latest/APIReference/API_Decrypt.html)`dan `[GenerateDataKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_GenerateDataKey.html)` peristiwa yang dihasilkan ketika catatan log dienkripsi menggunakan kunci yang dikelola pelanggan dikirim ke tujuan log.
+ `[PutRecordBatch](https://docs.aws.amazon.com/firehose/latest/APIReference/API_PutRecordBatch.html)`peristiwa di Firehose yang dihasilkan oleh pengiriman log bus acara.
+ Untuk tujuan log S3, menentukan bucket tujuan dengan notifikasi [ peristiwa untuk EventBridge ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-event-notifications-eventbridge.html) 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](encryption-bus-logs.md).
### 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 ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-vended-logs-permissions) 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`