`. Anda dapat mereferensikan variabel tersebut saat Anda membuat *Templat Masukan*.
**catatan**
CloudWatch Log Amazon dan target SSM tidak mendukung penggunaan `Input` dan `InputPath` dalam transformator inputnya.
### Template masukan
*Templat Masukan* adalah templat untuk informasi yang ingin Anda lewatkan ke target Anda. Anda dapat membuat templat yang melewati baik string maupun JSON ke target. Dengan menggunakan peristiwa sebelumnya dan *Jalur Masukan*, contoh *Templat Masukan* berikut ini akan mengubah peristiwa untuk keluaran contoh sebelum merutekan ke target.
| Deskripsi | Templat | Output |
| --- | --- | --- |
| String sederhana | "instance is in "
| "instance i-0123456789 is in RUNNING"
|
| **String dengan tanda kutip lolos** | "instance \"\" is in "
| "instance \"i-0123456789\" is in RUNNING"
Perhatikan bahwa ini adalah perilaku di EventBridge konsol. AWS CLI keluar dari karakter garis miring dan hasilnya adalah `"instance "i-0123456789" is in RUNNING"`. |
| **JSON sederhana** | {
"instance" : ,
"state":
} | {
"instance" : "i-0123456789",
"state": "RUNNING"
} |
| **JSON dengan string dan variabel** | {
"instance" : ,
"state": "",
"instanceStatus": "instance \"\" is in "
} | {
"instance" : "i-0123456789",
"state": "RUNNING",
"instanceStatus": "instance \"i-0123456789\" is in RUNNING"
} |
| **JSON dengan campuran variabel dan informasi statis** | {
"instance" : ,
"state": [ 9, , true ],
"Transformed" : "Yes"
}
| {
"instance" : "i-0123456789",
"state": [
9,
"RUNNING",
true
],
"Transformed" : "Yes"
} |
| **Termasuk variabel cadangan di JSON** | {
"instance" : ,
"state": ,
"ruleArn" : ,
"ruleName" : ,
"originalEvent" :
} | {
"instance" : "i-0123456789",
"state": "RUNNING",
"ruleArn" : "arn:aws:events:us-east-2:123456789012:rule/example",
"ruleName" : "example",
"originalEvent" : {
... // commented for brevity
}
} |
| **Termasuk variabel cadangan dalam string** | " triggered"
| "example triggered"
|
| **Grup CloudWatch log Amazon** | {
"timestamp" : ,
"message": "instance \"\" is in "
} | {
"timestamp" : 2015-11-11T21:29:54Z,
"message": "instance "i-0123456789" is in RUNNING
} |
## Mengubah input dengan menggunakan API EventBridge
Untuk informasi tentang penggunaan EventBridge API untuk mengubah input, lihat [Menggunakan Input Transformer untuk mengekstrak data dari suatu peristiwa dan memasukkan data tersebut ke target](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutTargets.html#API_PutTargets_Example_2).
## Mengubah masukan dengan menggunakan AWS CloudFormation
Untuk informasi tentang menggunakan AWS CloudFormation untuk mengubah input, lihat [AWS::Events::Rule InputTransformer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-rule-inputtransformer.html).
## Masalah Umum dengan mengubah input
Ini adalah beberapa masalah umum saat mengubah input di EventBridge:
+ Untuk String, tanda kutip diperlukan.
+ Tidak ada validasi saat membuat jalur JSON untuk templat Anda.
+ Jika Anda menentukan variabel untuk mencocokkan jalur JSON yang tidak ada dalam peristiwa, variabel tersebut tidak dibuat dan tidak akan muncul dalam keluaran.
+ Properti JSON seperti hanya `aws.events.event.json` dapat digunakan sebagai nilai bidang JSON, tidak sebaris di string lain.
+ EventBridge tidak lolos dari nilai yang diekstraksi oleh *Jalur Input*, saat mengisi *Template Input* untuk target.
+ Jika jalur JSON mereferensikan objek atau array JSON, tetapi variabel direferensikan dalam string, EventBridge menghapus tanda kutip internal untuk memastikan string yang valid. Misalnya, untuk variabel yang `` ditunjuk`$.detail`, “Detail is” akan mengakibatkan EventBridge penghapusan tanda kutip dari objek.
Oleh karena itu, jika Anda ingin menampilkan objek JSON berdasarkan variabel jalur JSON tunggal, Anda harus menempatkannya sebagai kunci. Dalam contoh ini,`{"detail": }`.
+ Kutipan tidak diperlukan untuk variabel yang mewakili string. Mereka diizinkan, tetapi EventBridge secara otomatis menambahkan tanda kutip ke nilai variabel string selama transformasi, untuk memastikan output transformasi adalah JSON yang valid. EventBridge tidak menambahkan tanda kutip ke variabel yang mewakili objek atau array JSON. Jangan menambahkan tanda kutip untuk variabel yang mewakili objek JSON atau array.
Misalnya, template input berikut mencakup variabel yang mewakili string dan objek JSON:
```
{
"ruleArn" : ,
"ruleName" : ,
"originalEvent" :
}
```
Menghasilkan JSON yang valid dengan kutipan yang tepat:
```
{
"ruleArn" : "arn:aws:events:us-east-2:123456789012:rule/example",
"ruleName" : "example",
"originalEvent" : {
... // commented for brevity
}
}
```
+ Untuk output teks (non-JSON) sebagai string multi-baris, bungkus setiap baris terpisah di template input Anda dalam tanda kutip ganda.
Misalnya, jika Anda mencocokkan [Amazon Inspector Finding](https://docs.aws.amazon.com/inspector/latest/user/eventbridge-integration.html#event-finding) event dengan pola event berikut:
```
{
"detail": {
"severity": ["HIGH"],
"status": ["ACTIVE"]
},
"detail-type": ["Inspector2 Finding"],
"source": ["inspector2"]
}
```
Dan menggunakan jalur input berikut:
```
{
"account": "$.detail.awsAccountId",
"ami": "$.detail.resources[0].details.awsEc2Instance.imageId",
"arn": "$.detail.findingArn",
"description": "$.detail.description",
"instance": "$.detail.resources[0].id",
"platform": "$.detail.resources[0].details.awsEc2Instance.platform",
"region": "$.detail.resources[0].region",
"severity": "$.detail.severity",
"time": "$.time",
"title": "$.detail.title",
"type": "$.detail.type"
}
```
Anda dapat menggunakan template input di bawah ini untuk menghasilkan output string multi-baris:
```
" severity finding "
"Description: <description>"
"ARN: \"<arn>\""
"Type: <type>"
"AWS Account: <account>"
"Region: <region>"
"EC2 Instance: <instance>"
"Platform: <platform>"
"AMI: <ami>"
```
# Mengkonfigurasi transformator input saat membuat aturan di EventBridge
<a name="eb-transform-input-rule"></a>
Sebagai bagian dari pembuatan aturan, Anda dapat menentukan transformator input EventBridge untuk digunakan untuk memproses peristiwa pencocokan sebelum mengirim peristiwa tersebut ke target yang ditentukan. Anda dapat mengonfigurasi transformator input untuk target yang merupakan AWS layanan atau tujuan API.
**Untuk membuat transformator input target sebagai bagian dari aturan**
1. Ikuti langkah-langkah untuk membuat aturan seperti yang dijelaskan dalam[Membuat aturan di Amazon EventBridge](eb-create-rule-visual.md).
1. Di **Langkah 3 - Pilih target**, perluas **Pengaturan tambahan**.
1. Untuk **Konfigurasi input target**, pilih **Input transformator** di dropdown.
Klik **Konfigurasi transformator input**.
EventBridge menampilkan kotak dialog **Configure input transformator**.
1. Di bagian **Contoh peristiwa**, pilih **jenis acara Contoh** yang ingin Anda uji pola acara Anda. Anda dapat memilih AWS acara, acara mitra, atau memasukkan acara khusus Anda sendiri.
------
#### [ AWS events ]
Pilih dari peristiwa yang dipancarkan dari yang didukung. Layanan AWS
1. Pilih **AWS acara**.
1. Di bawah **Contoh peristiwa**, pilih AWS acara yang diinginkan. Acara diselenggarakan oleh AWS layanan.
Saat Anda memilih acara, EventBridge mengisi contoh acara.
Misalnya, jika Anda memilih **S3 Object Created**, EventBridge menampilkan contoh acara S3 Object Created.
1. (Opsional) Anda juga dapat memilih **Salin** untuk menyalin contoh peristiwa ke clipboard perangkat Anda.
------
#### [ Partner events ]
Pilih dari peristiwa yang dipancarkan dari layanan pihak ketiga yang mendukung EventBridge, seperti Salesforce.
1. Pilih **acara EventBridge mitra**.
1. Di bawah **Contoh acara**, pilih acara mitra yang diinginkan. Acara diselenggarakan oleh mitra.
Saat Anda memilih acara, EventBridge mengisi contoh acara.
1. (Opsional) Anda juga dapat memilih **Salin** untuk menyalin contoh peristiwa ke clipboard perangkat Anda.
------
#### [ Enter your own ]
Masukkan acara Anda sendiri dalam teks JSON.
1. Pilih **Masukkan milik Anda sendiri**.
1. EventBridge mengisi acara sampel dengan template atribut acara yang diperlukan.
1. Edit dan tambahkan ke acara sampel sesuai keinginan. Contoh acara harus JSON yang valid.
1. (Opsional) Anda juga dapat memilih salah satu opsi berikut:
+ **Salin** - Salin contoh acara ke clipboard perangkat Anda.
+ **Prettify** - Membuat teks JSON lebih mudah dibaca dengan menambahkan jeda baris, tab, dan spasi.
------
1. (Opsional) Perluas **jalur masukan Contoh, Template dan Output** bagian untuk melihat contoh:
+ Bagaimana jalur JSON digunakan untuk mendefinisikan variabel yang mewakili data peristiwa
+ Bagaimana variabel-variabel tersebut dapat digunakan dalam template transformator input
+ Output yang dihasilkan yang EventBridge mengirim ke target
Untuk contoh transformasi input yang lebih rinci, lihat[Contoh transformasi masukan](eb-transform-target-input.md#eb-transform-input-examples).
1. Di bagian **Transformator input target**, tentukan variabel apa pun yang ingin Anda gunakan dalam template input.
Variabel menggunakan jalur JSON untuk mereferensikan nilai di sumber acara asli. Anda kemudian dapat mereferensikan variabel-variabel tersebut dalam template input untuk memasukkan data dari peristiwa sumber asli dalam peristiwa yang diubah yang EventBridge lolos ke target. Anda dapat menentukan hingga 100 variabel. Trafo input harus JSON yang valid.
Misalnya, Anda telah memilih AWS acara **S3 Object Created** sebagai contoh acara Anda untuk transformator input ini. Anda kemudian dapat menentukan variabel berikut untuk digunakan dalam template Anda:
```
{
"requester": "$.detail.requester",
"key": "$.detail.object.key",
"bucket": "$.detail.bucket.name"
}
```
(Opsional) Anda juga dapat memilih **Salin** untuk menyalin transformator input ke clipboard perangkat Anda.
1. Di bagian **Template**, tulis template yang ingin Anda gunakan untuk menentukan apa yang EventBridge lolos ke target.
Anda dapat menggunakan JSON, string, informasi statis, variabel yang telah Anda definisikan serta variabel cadangan. Untuk contoh transformasi input yang lebih rinci, lihat[Contoh transformasi masukan](eb-transform-target-input.md#eb-transform-input-examples).
Misalnya, Anda telah mendefinisikan variabel dalam contoh sebelumnya. Anda kemudian dapat membuat template berikut, yang mereferensikan variabel-variabel tersebut, serta variabel cadangan, dan informasi statis.
```
{
"message": "<requester> has created the object \"<key>\" in the bucket \"<bucket>\"",
"RuleName": <aws.events.rule-name>,
"ruleArn" : <aws.events.rule-arn>,
"Transformed": "Yes"
}
```
(Opsional) Anda juga dapat memilih **Salin** untuk menyalin template ke clipboard perangkat Anda.
1. Untuk menguji template Anda, pilih **Hasilkan output**.
EventBridge memproses peristiwa sampel berdasarkan template input, dan menampilkan output yang diubah yang dihasilkan di bawah **Output**. Ini adalah informasi yang EventBridge akan diteruskan ke target di tempat acara sumber asli.
Output yang dihasilkan untuk contoh template input yang dijelaskan di atas adalah sebagai berikut:
```
{
"message": "123456789012 has created the object "example-key" in the bucket "amzn-s3-demo-bucket"",
"RuleName": rule-name,
"ruleArn" : arn:aws:events:us-east-1:123456789012:rule/rule-name,
"Transformed": "Yes"
}
```
(Opsional) Anda juga dapat memilih **Salin** untuk menyalin output yang dihasilkan ke clipboard perangkat Anda.
1. Pilih **Konfirmasi**
1. Ikuti langkah-langkah lainnya untuk membuat aturan seperti yang dijelaskan dalam[Membuat aturan di Amazon EventBridge](eb-create-rule-visual.md).
# Menguji transformator input target menggunakan EventBridge Sandbox
<a name="eb-sandbox-input-trans"></a>
[Anda dapat menggunakan transformator input untuk menyesuaikan teks dari suatu [peristiwa](eb-events.md) sebelum EventBridge meneruskan informasi ke [target](eb-targets.md) aturan.](eb-rules.md)
Mengkonfigurasi transformator input biasanya merupakan bagian dari proses yang lebih besar dalam menentukan target sambil [membuat aturan baru](eb-create-rule-visual.md) atau mengedit yang sudah ada. Namun EventBridge, dengan menggunakan Sandbox, Anda dapat dengan cepat mengonfigurasi transformator input dan menggunakan contoh peristiwa untuk mengonfirmasi bahwa Anda mendapatkan output yang diinginkan, tanpa harus membuat atau mengedit aturan.
Untuk informasi lebih lanjut tentang transformasi input, lihat[Transformasi EventBridge masukan Amazon](eb-transform-target-input.md).
**Untuk menguji transformator input target**
1. Buka EventBridge konsol Amazon di [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Di bawah **Sumber daya Pengembang**, pilih **Sandbox**, dan pada halaman **Sandbox** pilih tab **Transformator input target**.
1. Di bagian **Contoh peristiwa**, pilih **jenis acara Contoh** yang ingin Anda uji pola acara Anda. Anda dapat memilih AWS acara, acara mitra, atau memasukkan acara khusus Anda sendiri.
------
#### [ AWS events ]
Pilih dari peristiwa yang dipancarkan dari yang didukung. Layanan AWS
1. Pilih **AWS acara**.
1. Di bawah **Contoh peristiwa**, pilih AWS acara yang diinginkan. Acara diselenggarakan oleh AWS layanan.
Saat Anda memilih acara, EventBridge mengisi contoh acara.
Misalnya, jika Anda memilih **S3 Object Created**, EventBridge menampilkan contoh acara S3 Object Created.
1. (Opsional) Anda juga dapat memilih **Salin** untuk menyalin contoh peristiwa ke clipboard perangkat Anda.
------
#### [ Partner events ]
Pilih dari peristiwa yang dipancarkan dari layanan pihak ketiga yang mendukung EventBridge, seperti Salesforce.
1. Pilih **acara EventBridge mitra**.
1. Di bawah **Contoh acara**, pilih acara mitra yang diinginkan. Acara diselenggarakan oleh mitra.
Saat Anda memilih acara, EventBridge mengisi contoh acara.
1. (Opsional) Anda juga dapat memilih **Salin** untuk menyalin contoh peristiwa ke clipboard perangkat Anda.
------
#### [ Enter your own ]
Masukkan acara Anda sendiri dalam teks JSON.
1. Pilih **Masukkan milik Anda sendiri**.
1. EventBridge mengisi acara sampel dengan template atribut acara yang diperlukan.
1. Edit dan tambahkan ke acara sampel sesuai keinginan. Contoh acara harus JSON yang valid.
1. (Opsional) Anda juga dapat memilih salah satu opsi berikut:
+ **Salin** - Salin contoh acara ke clipboard perangkat Anda.
+ **Prettify** - Membuat teks JSON lebih mudah dibaca dengan menambahkan jeda baris, tab, dan spasi.
------
1. (Opsional) Perluas **jalur masukan Contoh, Template dan Output** bagian untuk melihat contoh:
+ Bagaimana jalur JSON digunakan untuk mendefinisikan variabel yang mewakili data peristiwa
+ Bagaimana variabel-variabel tersebut dapat digunakan dalam template transformator input
+ Output yang dihasilkan yang EventBridge mengirim ke target
Untuk contoh transformasi input yang lebih rinci, lihat[Contoh transformasi masukan](eb-transform-target-input.md#eb-transform-input-examples).
1. Di bagian **Transformator input target**, tentukan variabel apa pun yang ingin Anda gunakan dalam template input.
Variabel menggunakan jalur JSON untuk mereferensikan nilai di sumber acara asli. Anda kemudian dapat mereferensikan variabel-variabel tersebut dalam template input untuk memasukkan data dari peristiwa sumber asli dalam peristiwa yang diubah yang EventBridge lolos ke target. Anda dapat menentukan hingga 100 variabel. Trafo input harus JSON yang valid.
Misalnya, Anda telah memilih AWS acara **S3 Object Created** sebagai contoh acara Anda untuk transformator input ini. Anda kemudian dapat menentukan variabel berikut untuk digunakan dalam template Anda:
```
{
"requester": "$.detail.requester",
"key": "$.detail.object.key",
"bucket": "$.detail.bucket.name"
}
```
(Opsional) Anda juga dapat memilih **Salin** untuk menyalin transformator input ke clipboard perangkat Anda.
1. Di bagian **Template**, tulis template yang ingin Anda gunakan untuk menentukan apa yang EventBridge lolos ke target.
Anda dapat menggunakan JSON, string, informasi statis, variabel yang telah Anda definisikan serta variabel cadangan. Untuk contoh transformasi input yang lebih rinci, lihat[Contoh transformasi masukan](eb-transform-target-input.md#eb-transform-input-examples).
Misalnya, Anda telah mendefinisikan variabel dalam contoh sebelumnya. Anda kemudian dapat membuat template berikut, yang mereferensikan variabel-variabel tersebut, serta variabel cadangan, dan informasi statis.
```
{
"message": "<requester> has created the object \"<key>\" in the bucket \"<bucket>\"",
"RuleName": <aws.events.rule-name>,
"ruleArn" : <aws.events.rule-arn>,
"Transformed": "Yes"
}
```
(Opsional) Anda juga dapat memilih **Salin** untuk menyalin template ke clipboard perangkat Anda.
1. Untuk menguji template Anda, pilih **Hasilkan output**.
EventBridge memproses peristiwa sampel berdasarkan template input, dan menampilkan output yang diubah yang dihasilkan di bawah **Output**. Ini adalah informasi yang EventBridge akan diteruskan ke target di tempat acara sumber asli.
Output yang dihasilkan untuk contoh template input yang dijelaskan di atas adalah sebagai berikut:
```
{
"message": "123456789012 has created the object "example-key" in the bucket "amzn-s3-demo-bucket"",
"RuleName": rule-name,
"ruleArn" : arn:aws:events:us-east-1:123456789012:rule/rule-name,
"Transformed": "Yes"
}
```
(Opsional) Anda juga dapat memilih **Salin** untuk menyalin output yang dihasilkan ke clipboard perangkat Anda.
# Mengarsipkan dan memutar ulang acara di Amazon EventBridge
<a name="eb-archive"></a>
Di EventBridge, Anda dapat membuat arsip acara sehingga Anda dapat dengan mudah *memutar ulang*, atau mengirim ulang ke bus acara yang awalnya menerimanya, di lain waktu. Misalnya, Anda mungkin ingin memutar ulang peristiwa untuk memulihkan dari kesalahan, atau memvalidasi fungsionalitas baru dalam aplikasi Anda.
## Mengarsipkan peristiwa
<a name="eb-archive-archive"></a>
Saat Anda membuat arsip, Anda dapat menentukan:
+ Acara mana yang akan dikirim ke arsip.
Anda dapat menentukan pola acara EventBridge untuk digunakan saat memfilter peristiwa yang dikirimkan ke arsip.
+ Berapa lama untuk mempertahankan acara di arsip.
Anda dapat menentukan jumlah hari untuk mempertahankan acara dalam arsip. Secara default, EventBridge menyimpan acara dalam arsip tanpa batas waktu.
Setiap arsip menerima acara dari bus acara *sumber* tunggal. Anda tidak dapat mengubah bus acara sumber setelah arsip dibuat. Anda dapat membuat beberapa arsip untuk bus acara tertentu.
![\[Acara difilter oleh pola acara dan dikirim ke arsip, dari mana mereka dapat diputar ulang.\]](http://docs.aws.amazon.com/id_id/eventbridge/latest/userguide/images/archive_eventbridge_conceptual.svg)
EventBridge biaya berlaku untuk arsip. Silakan lihat [ EventBridge Harga Amazon](https://aws.amazon.com/eventbridge/pricing/) untuk detailnya.
### Mengenkripsi acara arsip
<a name="eb-archive-encryption"></a>
Secara default, EventBridge mengenkripsi data peristiwa dalam arsip menggunakan 256-bit Advanced Encryption Standard (AES-256) di bawah [CMK yang AWS dimiliki](https://docs.aws.amazon.com//kms/latest/developerguide/concepts.html#aws-owned-cmk), yang membantu mengamankan data Anda dari akses yang tidak sah.
### Pengiriman acara
<a name="eb-archive-timing"></a>
Ingatlah pertimbangan berikut tentang bagaimana EventBridge mengirimkan acara ke arsip:
+ Mungkin ada penundaan antara acara yang diterima di bus acara dan acara yang tiba di arsip. Kami menyarankan Anda menunda memutar ulang acara yang diarsipkan selama 10 menit untuk memastikan semua acara diputar ulang.
+ `SizeBytes`Nilai `EventCount` dan [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html)operasi memiliki periode rekonsiliasi 24 jam. Oleh karena itu, setiap peristiwa yang baru kedaluwarsa atau yang baru diarsipkan mungkin tidak langsung tercermin dalam nilai-nilai ini.
### Mencegah acara yang diputar ulang agar tidak dikirim ke arsip
<a name="eb-archive-managed-rule"></a>
Saat Anda membuat arsip, EventBridge buat [aturan terkelola](eb-rules.md#eb-rules-managed) pada bus acara sumber yang mencegah peristiwa yang diputar ulang dikirim ke arsip. Aturan terkelola menambahkan pola peristiwa berikut, yang memfilter peristiwa berdasarkan apakah itu berisi `replay-name` bidang. (EventBridgemenambahkan bidang ini ke acara saat memutar ulang.)
```
{
"replay-name": [{
"exists": false
}]
}
```
## Memutar ulang acara dari arsip
<a name="eb-archive-replay"></a>
Setelah membuat arsip, Anda dapat memutar ulang peristiwa dari arsip. Contohnya, jika Anda memperbarui aplikasi dengan fungsionalitas tambahan, Anda dapat memutar ulang peristiwa sejarah untuk memastikan bahwa peristiwa diproses ulang untuk menjaga aplikasi tetap konsisten. Anda juga dapat menggunakan arsip untuk memutar ulang peristiwa untuk fungsionalitas baru.
Saat memutar ulang acara dari arsip, Anda menentukan:
+ Kerangka waktu untuk memilih acara untuk diputar ulang.
+ Secara opsional, aturan khusus pada bus acara yang EventBridge harus memutar ulang acara yang dipilih.
Acara arsip hanya dapat diputar ulang ke bus acara sumber.
Anda dapat memiliki maksimal sepuluh pemutaran ulang bersamaan aktif per akun per AWS Wilayah.
Memutar ulang acara tidak menghapusnya dari arsip. Anda dapat memutar ulang acara dalam beberapa tayangan ulang. EventBridge hanya menghapus peristiwa ketika mereka melebihi periode penyimpanan arsip, atau Anda menghapus arsip itu sendiri.
EventBridge menghapus tayangan ulang setelah 90 hari.
Anda dapat membatalkan tayangan ulang saat statusnya adalah `Starting` atau`Running`. Untuk informasi selengkapnya, lihat [Membatalkan tayangan ulang acara](eb-replay-cancel.md).
### Mengidentifikasi peristiwa yang telah diputar ulang
<a name="eb-archive-replay-event-transform"></a>
Saat EventBridge mengirim acara dari arsip ke bus acara sumber selama pemutaran ulang, ia menambahkan bidang metadata ke acara`replay-name`, yang berisi nama pemutaran ulang. Anda dapat menggunakan bidang ini untuk mengidentifikasi peristiwa yang diputar ulang saat dikirim ke target.
EventBridge juga menggunakan bidang ini untuk memastikan bahwa acara yang diputar ulang tidak dikirim ke arsip.
### Pertimbangan saat memutar ulang acara dari arsip
<a name="eb-archive-replay-considerations"></a>
Ingatlah pertimbangan berikut saat memutar ulang acara dari arsip:
+ Mungkin ada penundaan antara acara yang diterima di bus acara dan acara yang tiba di arsip. Kami menyarankan Anda menunda memutar ulang acara yang diarsipkan selama 10 menit untuk memastikan semua acara diputar ulang.
+ Peristiwa tidak harus diputar ulang dengan urutan yang sama seperti yang ditambahkan ke arsip. Pemutaran ulang memproses peristiwa untuk diputar ulang berdasarkan waktu peristiwa, dan memutar ulangnya dalam jeda satu menit. Jika Anda menentukan waktu mulai dan waktu selesai peristiwa yang memiliki rentang waktu 20 menit, peristiwa diputar ulang dari menit pertama dari rentang 20 menit pertama. Kemudian peristiwa dari menit kedua diputar ulang.
+ Anda dapat menggunakan `DescribeReplay` pengoperasian EventBridge API untuk menentukan kemajuan pemutaran ulang. `EventLastReplayedTime`mengembalikan stempel waktu dari acara terakhir yang diputar ulang.
+ Acara diputar ulang berdasarkan, tetapi terpisah dari, batas `PutEvents` transaksi per detik untuk AWS akun. Anda dapat meminta kenaikan hingga batas untuk PutEvents. Untuk informasi selengkapnya, lihat [ EventBridge Kuota Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/cloudwatch-limits-eventbridge.html).
Video berikut menunjukkan penggunaan arsip dan replay:
# Membuat arsip acara di Amazon EventBridge
<a name="eb-archive-event"></a>
Saat Anda membuat arsip EventBridge, Anda dapat menentukan peristiwa mana yang dikirim ke arsip dengan menentukan [pola peristiwa](eb-event-patterns.md). EventBridge mengirimkan peristiwa yang cocok dengan pola acara ke arsip. Anda juga mengatur periode penyimpanan untuk menyimpan peristiwa di arsip sebelum dihapus.
Anda juga dapat membuat arsip sebagai bagian dari [pembuatan bus acara](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-event-bus.html). Arsip ini memiliki kebijakan retensi yang tidak terbatas dan tidak ada filter peristiwa, meskipun ini dapat [diperbarui](https://docs.aws.amazon.com/eventbridge/latest/userguide/event-bus-update-archive.html) setelah arsip dibuat.
**Topics**
+ [Tentukan arsip](#eb-create-archive-define)
+ [Bangun pola acara (opsional)](#eb-create-archive-event-pattern)
## Tentukan arsip
<a name="eb-create-archive-define"></a>
Pertama, masukkan nama dan deskripsi untuk arsip, dan tentukan bus acara dari mana ia menerima acara. Secara opsional, Anda juga dapat mengatur berapa lama untuk menyimpan acara dalam arsip.
**Untuk menentukan arsip**
1. Buka EventBridge konsol Amazon di [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Arahkan ke bus acara sumber, atau buat arsip secara langsung:
+ Di panel navigasi, pilih **Bus peristiwa**.
Pada halaman detail bus acara, pilih tab **Arsip**.
+ Di panel navigasi, pilih **Arsip**.
1. Pilih **Buat arsip**.
1. Di bawah **Detail arsip**, masukkan nama dan opsional, deskripsi untuk arsip.
Nama harus unik untuk akun Anda di Wilayah yang dipilih. Anda tidak dapat mengubah nama setelah Anda membuat arsip.
1. Untuk **Sumber**, pilih bus acara yang ingin Anda kirim acara ke arsip
Jika Anda menavigasi dari halaman detail bus acara yang ada, nama bus acara tersebut muncul secara default.
Anda tidak dapat mengubah bus acara sumber setelah Anda membuat arsip.
1. Untuk **periode Retensi**, tentukan berapa lama untuk menyimpan peristiwa dalam arsip:
+ Pilih **Tak terbatas** untuk mempertahankan peristiwa dalam arsip dan tidak pernah menghapusnya.
+ Untuk periode retensi yang ditetapkan, masukkan jumlah hari setelah itu EventBridge harus menghapus acara dari arsip.
1. Untuk **Enkripsi**, pilih kunci KMS EventBridge untuk digunakan saat mengenkripsi peristiwa yang disimpan dalam arsip.
**penting**
Jika Anda telah menentukan bahwa EventBridge menggunakan kunci yang dikelola pelanggan untuk mengenkripsi bus acara sumber, kami sangat menyarankan Anda juga menentukan kunci yang dikelola pelanggan untuk arsip apa pun untuk bus acara juga.
+ Pilih **Gunakan Kunci milik AWS** EventBridge untuk mengenkripsi data menggunakan file Kunci milik AWS.
Ini Kunci milik AWS adalah kunci KMS yang EventBridge memiliki dan mengelola untuk digunakan di beberapa AWS akun. Secara umum, kecuali Anda diminta untuk mengaudit atau mengontrol kunci enkripsi yang melindungi sumber daya Anda, a Kunci milik AWS adalah pilihan yang baik.
Ini adalah opsi default.
+ Pilih **Gunakan kunci terkelola pelanggan** EventBridge untuk mengenkripsi data menggunakan kunci terkelola pelanggan yang Anda tentukan atau buat.
Kunci yang dikelola pelanggan adalah kunci KMS di AWS akun Anda yang Anda buat, miliki, dan kelola. Anda memiliki kontrol penuh atas kunci KMS ini.
1. Tentukan kunci terkelola pelanggan yang sudah ada, atau pilih **Buat kunci KMS baru />**.
EventBridge menampilkan status kunci dan alias kunci apa pun yang telah dikaitkan dengan kunci terkelola pelanggan yang ditentukan.
1. Pilih **Berikutnya**.
## Bangun pola acara (opsional)
<a name="eb-create-archive-event-pattern"></a>
Selanjutnya, sebagai langkah opsional, Anda dapat membangun pola acara untuk memfilter peristiwa mana yang EventBridge dikirim ke arsip. Untuk melakukan ini, tentukan sumber acara, pilih dasar untuk pola acara, dan tentukan atribut dan nilai yang cocok. Anda juga dapat menghasilkan pola acara di JSON dan mengujinya terhadap peristiwa sampel.
Untuk informasi lebih lanjut tentang pola acara, lihat[](eb-event-patterns.md).
**Untuk membangun pola acara**
1. Untuk **sumber Acara**, pilih **AWS acara atau acara EventBridge mitra**.
1. (Opsional) Di bagian **Contoh peristiwa**, pilih **Contoh jenis acara** yang ingin Anda uji pola acara Anda.
Jenis acara sampel berikut tersedia:
+ **AWS event** - Pilih dari peristiwa yang dipancarkan dari didukung. Layanan AWS
+ **EventBridge acara mitra** - Pilih dari acara yang dipancarkan dari layanan pihak ketiga yang mendukung EventBridge, seperti Salesforce.
+ **Masukkan sendiri** - Masukkan acara Anda sendiri dalam teks JSON.
Anda juga dapat menggunakan acara AWS atau mitra sebagai titik awal untuk membuat acara kustom Anda sendiri.
1. Pilih **AWS acara** atau **acara EventBridge mitra**.
1. Gunakan dropdown **Contoh peristiwa** untuk memilih acara yang ingin Anda gunakan sebagai titik awal untuk acara kustom Anda.
EventBridge menampilkan acara sampel.
1. Pilih **Salin**.
1. Pilih **Masukkan milik saya** untuk **jenis Acara.**
1. Hapus struktur peristiwa sampel di panel pengeditan JSON, dan tempel acara AWS atau mitra di tempatnya.
1. Edit acara JSON untuk membuat acara sampel Anda sendiri.
1. Pilih **metode Creation**. Anda dapat membuat pola acara dari EventBridge skema atau template, atau Anda dapat membuat pola acara khusus.
------
#### [ Existing schema ]
Untuk menggunakan EventBridge skema yang ada untuk membuat pola acara, lakukan hal berikut:
1. Di bagian **Metode pembuatan**, untuk **Metode**, pilih **Gunakan skema**.
1. Di bagian **Pola acara**, untuk **jenis Skema**, pilih **Pilih skema dari registri Skema**.
1. Untuk **registri Schema**, pilih kotak dropdown dan masukkan nama registri skema, seperti. `aws.events` Anda juga dapat memilih opsi dari daftar dropdown yang muncul.
1. Untuk **Schema**, pilih kotak dropdown dan masukkan nama skema yang akan digunakan. Misalnya, `aws.s3@ObjectDeleted`. Anda juga dapat memilih opsi dari daftar dropdown yang muncul.
1. Di bagian **Model**, pilih tombol **Edit** di sebelah atribut apa pun untuk membuka propertinya. Atur bidang **Relationship** dan **Value** sesuai kebutuhan, lalu pilih **Set** untuk menyimpan atribut.
**catatan**
Untuk informasi tentang definisi atribut, pilih ikon **Info** di sebelah nama atribut. Untuk referensi tentang cara mengatur properti atribut dalam acara Anda, buka bagian **Catatan** pada kotak dialog properti atribut.
Untuk menghapus properti atribut, pilih tombol **Edit** untuk atribut tersebut, lalu pilih **Hapus**.
1. Pilih **Hasilkan pola acara di JSON** untuk menghasilkan dan memvalidasi pola acara Anda sebagai teks JSON.
1. (Opsional) Untuk menguji peristiwa sampel terhadap pola pengujian Anda, pilih **Pola uji**.
EventBridge menampilkan kotak pesan yang menyatakan apakah acara sampel Anda cocok dengan pola acara.
Anda juga dapat memilih salah satu opsi berikut:
+ **Salin** — Salin pola acara ke clipboard perangkat Anda.
+ **Prettify** - Membuat teks JSON lebih mudah dibaca dengan menambahkan jeda baris, tab, dan spasi.
------
#### [ Custom schema ]
Untuk menulis skema khusus dan mengubahnya menjadi pola acara, lakukan hal berikut:
1. Di bagian **Metode pembuatan**, untuk **Metode**, pilih **Gunakan skema**.
1. Di bagian **Pola acara**, untuk **jenis Skema**, pilih **Masukkan skema**.
1. Masukkan skema Anda ke dalam kotak teks. Anda harus memformat skema sebagai teks JSON yang valid.
1. Di bagian **Model**, pilih tombol **Edit** di sebelah atribut apa pun untuk membuka propertinya. Atur bidang **Relationship** dan **Value** sesuai kebutuhan, lalu pilih **Set** untuk menyimpan atribut.
**catatan**
Untuk informasi tentang definisi atribut, pilih ikon **Info** di sebelah nama atribut. Untuk referensi tentang cara mengatur properti atribut dalam acara Anda, buka bagian **Catatan** pada kotak dialog properti atribut.
Untuk menghapus properti atribut, pilih tombol **Edit** untuk atribut tersebut, lalu pilih **Hapus**.
1. Pilih **Hasilkan pola acara di JSON** untuk menghasilkan dan memvalidasi pola acara Anda sebagai teks JSON.
1. (Opsional) Untuk menguji peristiwa sampel terhadap pola pengujian Anda, pilih **Pola uji**.
EventBridge menampilkan kotak pesan yang menyatakan apakah acara sampel Anda cocok dengan pola acara.
Anda juga dapat memilih salah satu opsi berikut:
+ **Salin** — Salin pola acara ke clipboard perangkat Anda.
+ **Prettify** - Membuat teks JSON lebih mudah dibaca dengan menambahkan jeda baris, tab, dan spasi.
------
#### [ Event pattern ]
Untuk menulis pola acara khusus dalam format JSON, lakukan hal berikut:
1. Di bagian **Metode pembuatan**, untuk **Metode**, pilih **Pola kustom (editor JSON)**.
1. Untuk **pola Acara**, masukkan pola acara kustom Anda dalam teks berformat JSON.
1. (Opsional) Untuk menguji peristiwa sampel terhadap pola pengujian Anda, pilih **Pola uji**.
EventBridge menampilkan kotak pesan yang menyatakan apakah acara sampel Anda cocok dengan pola acara.
Anda juga dapat memilih salah satu opsi berikut:
+ **Salin** — Salin pola acara ke clipboard perangkat Anda.
+ **Prettify** - Membuat teks JSON lebih mudah dibaca dengan menambahkan jeda baris, tab, dan spasi.
+ **Bentuk pola acara** - Membuka pola acara di Pattern Builder. Jika pola tidak dapat dirender di Pattern Builder apa adanya, EventBridge memperingatkan Anda sebelum membuka Pattern Builder.
------
1. Pilih **Buat arsip**.
Untuk mengonfirmasi bahwa peristiwa berhasil dikirim ke arsip, Anda dapat menggunakan [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html)pengoperasian EventBridge API untuk melihat apakah peristiwa tersebut `EventCount` mencerminkan jumlah peristiwa dalam arsip. Jika 0, tidak ada peristiwa dalam arsip.
# Memperbarui arsip di bus EventBridge acara Amazon
<a name="event-bus-update-archive"></a>
Anda dapat memperbarui yang berikut ini:
+ Deskripsi arsip
+ Pola acara yang digunakan untuk memfilter peristiwa mana yang dikirim ke arsip.
+ Periode retensi untuk acara.
+ Yang AWS KMS key digunakan untuk enkripsi acara.
Untuk informasi selengkapnya, lihat [Mengenkripsi arsip](encryption-archives.md).
Anda tidak dapat mengubah nama atau bus acara sumber untuk arsip setelah dibuat.
**catatan**
Penemuan skema tidak didukung untuk bus acara yang dienkripsi menggunakan kunci yang dikelola pelanggan. Untuk mengaktifkan penemuan skema pada bus acara, pilih untuk menggunakan file Kunci milik AWS. Untuk informasi selengkapnya, lihat [Opsi kunci KMS](eb-encryption-at-rest-key-options.md).
**Untuk memperbarui arsip (konsol)**
1. Buka EventBridge konsol Amazon di [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Arahkan ke arsip secara langsung, atau dari bus acara sumber:
+ Di panel navigasi, pilih **Bus peristiwa**.
Pada halaman detail bus acara, pilih tab **Arsip**.
+ Di panel navigasi, pilih **Arsip**.
1. Pilih arsip, lalu pilih **Edit**.
1. Perbarui arsip.
**Untuk memperbarui arsip untuk bus acara (AWS CLI)**
+ Gunakan [update-archive](https://docs.aws.amazon.com/cli/latest/reference/events/update-archive.html).
# Menghapus arsip acara di Amazon EventBridge
<a name="eb-archive-delete"></a>
Saat Anda menghapus arsip, EventBridge menghapus sumber daya berikut:
+ Arsip dan acara apa pun yang dikandungnya.
+ Pola acara, jika ada, ditentukan untuk arsip.
+ Aturan terkelola EventBridge yang dihasilkan untuk arsip.
**Untuk menghapus arsip dari bus acara (konsol)**
1. Buka EventBridge konsol Amazon di [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Arahkan ke arsip secara langsung, atau dari bus acara sumber:
+ Di panel navigasi, pilih **Bus peristiwa**.
Pada halaman detail bus acara, pilih tab **Arsip**.
+ Di panel navigasi, pilih **Arsip**.
1. Pilih bus acara yang berisi arsip yang ingin Anda hapus.
1. Pada halaman detail bus acara, pilih tab **Arsip**.
1. Pilih arsip, lalu pilih **Hapus**.
**Untuk menghapus arsip (AWS CLI)**
+ Gunakan [hapus-arsip](https://docs.aws.amazon.com/cli/latest/reference/events/delete-archive.html).
# Membuat tayangan ulang acara yang diarsipkan di Amazon EventBridge
<a name="eb-replay-archived-event"></a>
Saat Anda memulai pemutaran ulang baru, Anda menentukan periode waktu untuk acara yang ingin Anda kirim ulang EventBridge ke bus acara sumber. Anda juga dapat menentukan EventBridge untuk mengirim acara ke aturan tertentu.
**Untuk memulai pemutaran ulang acara (konsol)**
1. Buka EventBridge konsol Amazon di [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Arahkan ke tayangan ulang secara langsung, atau dari arsip yang ingin Anda putar ulang:
+ Di panel navigasi, pilih **Arsip**.
Pada halaman **Arsip**, pilih arsip dan kemudian pilih **Putar Ulang**.
+ Di panel navigasi, pilih **Replays**.
Pilih **Mulai replay baru**.
1. Masukkan **Nama** untuk pemutaran ulang, dan secara opsional, **Deskripsi**
1. Untuk **Sumber**, pilih arsip untuk memutar ulang peristiwa.
1. Untuk tujuan, Anda dapat memutar ulang peristiwa hanya untuk bus peristiwa yang mengeluarkan peristiwa.
1. Untuk **Tentukan aturan**, lakukan salah satu dari hal berikut:
+ Pilih **Semua aturan** untuk memutar ulang peristiwa semua aturan.
+ Pilih **Tentukan aturan**, lalu pilih aturan atau aturan-aturan untuk memutar ulang peristiwa.
1. Dalam **Rangka waktu putar ulang**, tentukan **Tanggal**, **Waktu**, dan **Zona waktu** untuk **Waktu mulai** dan **Waktu selesai**.
Hanya peristiwa yang terjadi antara **waktu Mulai dan Waktu** **Akhir** yang diputar ulang.
1. Pilih **Mulai putar ulang**.
**Untuk memulai replay ()AWS CLI**
+ Gunakan [start-replay](https://docs.aws.amazon.com/cli/latest/reference/events/start-replay.html).
# Membatalkan tayangan ulang acara yang diarsipkan di Amazon EventBridge
<a name="eb-replay-cancel"></a>
Jika Anda memulai pemutaran ulang dan kemudian ingin menghentikannya, Anda dapat membatalkannya saat statusnya `Starting` atau`Running`.
**Untuk membatalkan pemutaran ulang (konsol)**
1. Buka EventBridge konsol Amazon di [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Pada panel navigasi kiri, pilih **Pemutaran Ulang**.
1. Pilih putar ulang untuk membatalkan.
1. Pilih **Batalkan**.
**Untuk membatalkan replay ()AWS CLI**
+ Gunakan [cancel-replay](https://docs.aws.amazon.com/cli/latest/reference/events/cancel-replay.html).
# Membuat aplikasi toleran terhadap kesalahan regional dengan titik akhir global di EventBridge
<a name="eb-global-endpoints"></a>
Anda dapat meningkatkan ketersediaan aplikasi Anda dengan titik akhir EventBridge global Amazon. Titik akhir global membantu membuat aplikasi Anda toleran terhadap kesalahan regional tanpa biaya tambahan. Untuk memulai, Anda menetapkan pemeriksaan kesehatan Amazon Route 53 ke titik akhir. Ketika failover dimulai, pemeriksaan kesehatan melaporkan keadaan “tidak sehat”. Dalam beberapa menit setelah inisiasi failover, semua [acara](eb-events.md) khusus diarahkan ke [bus acara](eb-event-bus.md) di Wilayah sekunder dan diproses oleh bus acara tersebut. Setelah pemeriksaan kesehatan melaporkan keadaan “sehat”, acara diproses oleh bus acara di Wilayah utama.
Saat Anda menggunakan titik akhir global, Anda dapat mengaktifkan [replikasi peristiwa](#eb-ge-event-replication). Replikasi acara mengirimkan semua peristiwa khusus ke bus acara di Wilayah primer dan sekunder menggunakan aturan terkelola.
**catatan**
Jika Anda menggunakan bus khusus, Anda memerlukan bus khusus di setiap Wilayah dengan nama yang sama dan di akun yang sama agar failover berfungsi dengan baik.
## Waktu Pemulihan & Tujuan Titik Pemulihan
<a name="eb-ge-rpo-rto"></a>
Tujuan Waktu Pemulihan (RTO) adalah waktu yang diperlukan untuk Wilayah sekunder untuk mulai menerima peristiwa setelah kegagalan. Untuk RTO, waktunya mencakup periode waktu untuk memicu CloudWatch alarm dan memperbarui status untuk pemeriksaan kesehatan Route 53. Recovery Point Objective (RPO) adalah ukuran data yang akan dibiarkan tidak diproses selama kegagalan. Untuk RPO, waktunya mencakup peristiwa yang tidak direplikasi ke Wilayah sekunder dan macet di Wilayah primer sampai layanan atau Wilayah pulih. Dengan titik akhir global, jika Anda mengikuti panduan preskriptif kami untuk konfigurasi alarm, Anda dapat mengharapkan RTO dan RPO menjadi 360 detik dengan maksimum 420 detik.
## Replikasi peristiwa
<a name="eb-ge-event-replication"></a>
Peristiwa diproses di Wilayah sekunder secara asinkron. Ini berarti bahwa acara tidak dijamin akan diproses pada saat yang sama di kedua Wilayah. Ketika failover dipicu, peristiwa diproses oleh Region sekunder dan akan diproses oleh Region utama saat tersedia. Mengaktifkan replikasi acara akan meningkatkan biaya bulanan Anda. Untuk informasi selengkapnya, lihat [ EventBridgeharga Amazon](https://aws.amazon.com/eventbridge/pricing)
Sebaiknya aktifkan replikasi peristiwa saat menyiapkan titik akhir global karena alasan berikut:
+ Replikasi acara membantu Anda memverifikasi bahwa titik akhir global Anda dikonfigurasi dengan benar. Ini membantu memastikan bahwa Anda akan tercakup jika terjadi failover.
+ Replikasi peristiwa diperlukan untuk memulihkan secara otomatis dari peristiwa failover. Jika Anda tidak mengaktifkan replikasi acara, Anda harus mengatur ulang pemeriksaan kesehatan Route 53 secara manual ke “sehat” sebelum acara akan kembali ke Wilayah utama.
### Muatan acara yang direplikasi
<a name="eb-ge-event-replication-ep"></a>
Berikut ini adalah contoh payload peristiwa yang direplikasi:
**catatan**
Sebab`region`, Wilayah tempat acara direplikasi terdaftar.
```
{
"version": "0",
"id": "a908baa3-65e5-ab77-367e-527c0e71bbc2",
"detail-type": "Test",
"source": "test.service.com",
"account": "0123456789",
"time": "1900-01-01T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:events:us-east-1:0123456789:endpoint/MyEndpoint"
],
"detail": {
"a": "b"
}
}
```
## Bekerja dengan endpoint global dengan menggunakan SDK AWS
<a name="eb-ge-sdk-update"></a>
**catatan**
Support untuk C\$1\$1 akan segera hadir.
Saat menggunakan AWS SDK untuk bekerja dengan titik akhir global, ingatlah hal berikut:
+ Anda harus menginstal pustaka AWS Common Runtime (CRT) untuk SDK spesifik Anda. Jika Anda tidak menginstal CRT, Anda akan mendapatkan pesan pengecualian yang menunjukkan apa yang perlu diinstal. Untuk informasi selengkapnya, lihat berikut ini:
+ [AWS Pustaka Runtime Umum (CRT)](https://docs.aws.amazon.com/sdkref/latest/guide/common-runtime.html)
+ [awslabs/ aws-crt-java](https://github.com/awslabs/aws-crt-java)
+ [awslabs/ aws-crt-nodejs](https://github.com/awslabs/aws-crt-nodejs)
+ [awslabs/ aws-crt-python](https://github.com/awslabs/aws-crt-python)
+ Setelah Anda membuat titik akhir global, Anda harus menambahkan `endpointId` dan `EventBusName` ke `PutEvents` panggilan apa pun yang Anda gunakan.
+ Titik akhir global mendukung Signature Versi 4A. Versi SigV4 ini memungkinkan permintaan ditandatangani untuk beberapa Wilayah AWS. Ini berguna dalam operasi API yang mungkin menghasilkan akses data dari salah satu dari beberapa Wilayah. Saat menggunakan AWS SDK, Anda memberikan kredensyal dan permintaan ke titik akhir global akan menggunakan Signature Version 4A tanpa konfigurasi tambahan. *Untuk informasi selengkapnya tentang Sigv4a, lihat [Menandatangani permintaan AWS API](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html ) di Referensi Umum.AWS *
Jika Anda meminta kredensyal sementara dari AWS STS titik akhir global (sts.amazonaws.com), AWS STS vendor kredensyal yang, secara default, tidak mendukung Sigv4a. Lihat [Mengelola AWS STS di AWS Wilayah](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html) di *Panduan AWS Identity and Access Management Pengguna* untuk informasi lebih lanjut.
## Wilayah yang Tersedia
<a name="eb-ge-avail-regions"></a>
Wilayah berikut mendukung titik akhir global:
+ Timur AS (N. Virginia)
+ AS Timur (Ohio)
+ AS Barat (California Utara)
+ AS Barat (Oregon)
+ Canada (Central)
+ Eropa (Frankfurt)
+ Eropa (Irlandia)
+ Eropa (London)
+ Eropa (Milan)
+ Eropa (Paris)
+ Eropa (Stockholm)
+ Asia Pasifik (Mumbai)
+ Asia Pasifik (Osaka)
+ Asia Pasifik (Seoul)
+ Asia Pasifik (Singapura)
+ Asia Pasifik (Sydney)
+ Asia Pasifik (Tokyo)
+ Amerika Selatan (Sao Paulo)
# Membuat titik akhir global di Amazon EventBridge
<a name="eb-ge-create-endpoint"></a>
Selesaikan langkah-langkah berikut untuk menyiapkan titik akhir global:
1. Pastikan Anda memiliki bus dan aturan acara yang cocok di Wilayah primer dan sekunder.
1. Buat [pemeriksaan kesehatan Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/health-checks-creating.html) untuk memantau bus acara Anda. Untuk bantuan dalam membuat pemeriksaan kesehatan Anda, pilih **Pemeriksaan Kesehatan Baru** saat membuat titik akhir global Anda.
1. Buat titik akhir global Anda.
Setelah Anda mengatur pemeriksaan kesehatan Route 53, Anda dapat membuat titik akhir global.
## Untuk membuat endpoint global dengan menggunakan konsol
<a name="eb-ge-create-endpoint-console"></a>
1. Buka EventBridge konsol Amazon di [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Di panel navigasi, pilih Titik **akhir Global**.
1. Pilih **Buat Titik Akhir**.
1. Masukkan nama dan deskripsi untuk titik akhir.
1. Untuk **bus Acara di Wilayah utama**, pilih bus acara yang Anda inginkan titik akhir yang terkait dengannya.
1. Untuk **Wilayah Sekunder**, pilih Wilayah yang ingin Anda arahkan ke acara jika terjadi failover.
**catatan**
**Bus Acara di Wilayah sekunder** diisi secara otomatis dan tidak dapat diedit.
1. Untuk **pemeriksaan kesehatan Route 53 untuk memicu failover dan pemulihan**, pilih pemeriksaan kesehatan yang akan dipantau titik akhir. Jika Anda belum memiliki pemeriksaan kesehatan, pilih **Pemeriksaan Kesehatan Baru** untuk membuka CloudFormation konsol dan membuat pemeriksaan kesehatan menggunakan CloudFormation templat.
**catatan**
Data yang hilang akan menyebabkan pemeriksaan kesehatan gagal. Jika Anda hanya perlu mengirim acara sebentar-sebentar, pertimbangkan untuk menggunakan data yang lebih lama **MinimumEvaluationPeriod**, atau perlakukan data yang hilang sebagai 'hilang' alih-alih 'breaching'.
1. (Opsional) Untuk **replikasi Acara** lakukan hal berikut:
1. Pilih **Replikasi acara diaktifkan**.
1. Untuk **peran Eksekusi**, pilih apakah akan membuat AWS Identity and Access Management peran baru atau menggunakan yang sudah ada. Lakukan hal-hal berikut:
+ Pilih **Membuat peran baru untuk sumber daya khusus ini**. Secara opsional, Anda dapat memperbarui **nama Peran** untuk membuat peran baru.
+ Pilih **Gunakan peran yang ada**. Kemudian, untuk **peran Eksekusi**, pilih peran yang diinginkan untuk digunakan.
1. Pilih **Buat**.
## Untuk membuat endpoint global dengan menggunakan API
<a name="eb-ge-create-endpoint-api"></a>
Untuk membuat titik akhir global menggunakan EventBridge API, lihat [CreateEndpoint](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_CreateEndpoint.html)di Referensi Amazon EventBridge API.
## Untuk membuat endpoint global dengan menggunakan CloudFormation
<a name="eb-ge-create-endpoint-cfn"></a>
Untuk membuat titik akhir global menggunakan AWS CloudFormation API, lihat [AWS::Events::Endpoints](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-endpoint.html)di Panduan AWS CloudFormation Pengguna.
# Praktik terbaik untuk titik akhir EventBridge global Amazon
<a name="eb-ge-best-practices"></a>
Praktik terbaik berikut disarankan saat Anda menyiapkan titik akhir global.
## Mengaktifkan replikasi acara
<a name="eb-ge-bp-enable-replication"></a>
Kami sangat menyarankan agar Anda mengaktifkan replikasi dan memproses acara Anda di Wilayah sekunder yang Anda tetapkan ke titik akhir global Anda. Ini memastikan bahwa aplikasi Anda di Wilayah sekunder dikonfigurasi dengan benar. Anda juga harus mengaktifkan replikasi untuk memastikan pemulihan otomatis ke Wilayah utama setelah masalah dikurangi.
Peristiwa IDs dapat berubah di seluruh panggilan API sehingga menghubungkan peristiwa di seluruh Wilayah mengharuskan Anda memiliki pengenal unik yang tidak dapat diubah. Konsumen juga harus dirancang dengan mempertimbangkan idempotensi. Dengan begitu, jika Anda mereplikasi acara, atau memutar ulang dari arsip, tidak ada efek samping dari peristiwa yang sedang diproses di kedua Wilayah.
## Mencegah pelambatan peristiwa
<a name="eb-ge-bp-throttling"></a>
Untuk mencegah peristiwa terhambat, sebaiknya perbarui batas Anda `PutEvents` dan target agar konsisten di seluruh Wilayah.
## Menggunakan metrik pelanggan di Amazon Route 53 pemeriksaan kesehatan
<a name="eb-ge-bp-sub-metrics"></a>
Hindari menyertakan metrik pelanggan dalam pemeriksaan kesehatan Amazon Route 53 Anda. Menyertakan metrik ini dapat menyebabkan penerbit Anda melakukan failover ke Wilayah sekunder jika pelanggan mengalami masalah meskipun semua pelanggan lain tetap sehat di Wilayah utama. Jika salah satu subcriber Anda gagal memproses peristiwa di Wilayah utama, Anda harus mengaktifkan replikasi untuk memastikan bahwa pelanggan Anda di Wilayah sekunder dapat memproses peristiwa dengan sukses.
# Menyiapkan pemeriksaan kesehatan Route 53 untuk titik akhir EventBridge global
<a name="eb-ge-cfn"></a>
Saat menggunakan titik akhir global, Anda harus memiliki pemeriksaan kesehatan Route 53 untuk memantau status Wilayah Anda. Template berikut mendefinisikan [ CloudWatch alarm Amazon](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cw-alarm.html) dan menggunakannya untuk menentukan [pemeriksaan kesehatan Route 53](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-route53-healthcheck.html).
**Topics**
+ [CloudFormation template untuk mendefinisikan pemeriksaan kesehatan Route 53](#eb-ge-cfn-template)
+ [CloudWatch properti template alarm](#eb-ge-cfn-cw-alarm-definitions)
+ [Properti templat pemeriksaan kesehatan Route 53](#eb-ge-cfn-health-check-definitions)
## CloudFormation template untuk mendefinisikan pemeriksaan kesehatan Route 53
<a name="eb-ge-cfn-template"></a>
Gunakan templat berikut untuk menentukan pemeriksaan kesehatan Route 53 Anda.
```
Description: |-
Global endpoints health check that will fail when the average Amazon EventBridge
latency is above 30 seconds for a duration of 5 minutes. Note, missing data will
cause the health check to fail, so if you only send events intermittently, consider
changing the heath check to use a longer evaluation period or instead treat missing
data as 'missing' instead of 'breaching'.
Metadata:
AWS::CloudFormation::Interface:
ParameterGroups:
- Label:
default: "Global endpoint health check alarm configuration"
Parameters:
- HealthCheckName
- HighLatencyAlarmPeriod
- MinimumEvaluationPeriod
- MinimumThreshold
- TreatMissingDataAs
ParameterLabels:
HealthCheckName:
default: Health check name
HighLatencyAlarmPeriod:
default: High latency alarm period
MinimumEvaluationPeriod:
default: Minimum evaluation period
MinimumThreshold:
default: Minimum threshold
TreatMissingDataAs:
default: Treat missing data as
Parameters:
HealthCheckName:
Description: Name of the health check
Type: String
Default: LatencyFailuresHealthCheck
HighLatencyAlarmPeriod:
Description: The period, in seconds, over which the statistic is applied. Valid values are 10, 30, 60, and any multiple of 60.
MinValue: 10
Type: Number
Default: 60
MinimumEvaluationPeriod:
Description: The number of periods over which data is compared to the specified threshold. You must have at least one evaluation period.
MinValue: 1
Type: Number
Default: 5
MinimumThreshold:
Description: The value to compare with the specified statistic.
Type: Number
Default: 30000
TreatMissingDataAs:
Description: Sets how this alarm is to handle missing data points.
Type: String
AllowedValues:
- breaching
- notBreaching
- ignore
- missing
Default: breaching
Mappings:
"InsufficientDataMap":
"missing":
"HCConfig": "LastKnownStatus"
"breaching":
"HCConfig": "Unhealthy"
Resources:
HighLatencyAlarm:
Type: AWS::CloudWatch::Alarm
Properties:
AlarmDescription: High Latency in Amazon EventBridge
MetricName: IngestionToInvocationStartLatency
Namespace: AWS/Events
Statistic: Average
Period: !Ref HighLatencyAlarmPeriod
EvaluationPeriods: !Ref MinimumEvaluationPeriod
Threshold: !Ref MinimumThreshold
ComparisonOperator: GreaterThanThreshold
TreatMissingData: !Ref TreatMissingDataAs
LatencyHealthCheck:
Type: AWS::Route53::HealthCheck
Properties:
HealthCheckTags:
- Key: Name
Value: !Ref HealthCheckName
HealthCheckConfig:
Type: CLOUDWATCH_METRIC
AlarmIdentifier:
Name:
Ref: HighLatencyAlarm
Region: !Ref AWS::Region
InsufficientDataHealthStatus: !FindInMap [InsufficientDataMap, !Ref TreatMissingDataAs, HCConfig]
Outputs:
HealthCheckId:
Description: The identifier that Amazon Route 53 assigned to the health check when you created it.
Value: !GetAtt LatencyHealthCheck.HealthCheckId
```
Peristiwa IDs dapat berubah di seluruh panggilan API sehingga menghubungkan peristiwa di seluruh Wilayah mengharuskan Anda memiliki pengenal unik yang tidak dapat diubah. Konsumen juga harus dirancang dengan mempertimbangkan idempotensi. Dengan begitu, jika Anda mereplikasi acara, atau memutar ulang dari arsip, tidak ada efek samping dari peristiwa yang sedang diproses di kedua Wilayah.
## CloudWatch properti template alarm
<a name="eb-ge-cfn-cw-alarm-definitions"></a>
**catatan**
Untuk semua **editable** bidang, pertimbangkan throughput Anda per detik. Jika Anda hanya mengirim acara sebentar-sebentar, pertimbangkan untuk mengubah pemeriksaan kesehatan untuk menggunakan periode evaluasi yang lebih lama atau sebagai gantinya memperlakukan data yang hilang sebagai gantinya. `missing` `breaching`
Properti berikut digunakan di bagian CloudWatch alarm template:
| Metrik | Deskripsi |
| --- | --- |
| `AlarmDescription` | Deskripsi alarm. Default: **High Latency in Amazon EventBridge** |
| `MetricName` | Nama metrik yang terkait dengan alarm. Ini diperlukan untuk alarm yang didasarkan pada metrik. Untuk alarm yang didasarkan pada ekspresi matematika, Anda menggunakan `Metrics` sebagai gantinya dan tidak dapat menentukan `MetricName`. Default: IngestionToInvocationStartLatency |
| `Namespace` | Namespace metrik yang terkait dengan alarm. Ini diperlukan untuk alarm yang didasarkan pada metrik. Untuk alarm yang didasarkan pada ekspresi matematika, Anda tidak dapat menentukan `Namespace` dan menggunakan `Metrics` sebagai gantinya. Default: `AWS/Events` |
| `Statistic` | Statistik metrik yang terkait dengan alarm, selain persentil. Default: Rata-rata |
| `Period` | Periode, dalam detik, ketika statistik diterapkan. Ini diperlukan untuk alarm yang didasarkan pada metrik. Nilai yang valid adalah 10, 30, 60, dan kelipatan 60. Default: **60** |
| `EvaluationPeriods` | Jumlah periode yang mana data dibandingkan dengan ambang batas yang ditentukan. Jika Anda mengatur alarm yang mengharuskan sejumlah titik data berturut-turut melanggar untuk memicu alarm, nilai ini menentukan jumlah tersebut. Jika Anda menetapkan alarm "M dari N", nilai ini adalah N, dan `DatapointsToAlarm` adalah M. Default: **5** |
| `Threshold` | Nilai untuk membandingkan dengan statistik yang ditentukan. Default: **30,000** |
| `ComparisonOperator` | Operasi aritmatika yang akan digunakan saat membandingkan ambang batas dan statistik yang ditentukan. Nilai statistik yang ditentukan digunakan sebagai operan pertama. Default: `GreaterThanThreshold` |
| `TreatMissingData` | Mengatur bagaimana alarm ini menangani titik data yang hilang. Nilai yang valid:`breaching`,`notBreaching`,`ignore`, dan `missing` Default: `breaching` |
## Properti templat pemeriksaan kesehatan Route 53
<a name="eb-ge-cfn-health-check-definitions"></a>
**catatan**
Untuk semua **editable** bidang, pertimbangkan throughput Anda per detik. Jika Anda hanya mengirim acara sebentar-sebentar, pertimbangkan untuk mengubah pemeriksaan kesehatan untuk menggunakan periode evaluasi yang lebih lama atau sebagai gantinya memperlakukan data yang hilang sebagai gantinya. `missing` `breaching`
Properti berikut digunakan di bagian pemeriksaan kesehatan Route 53 pada templat:
| Metrik | Deskripsi |
| --- | --- |
| `HealthCheckName` | Nama pemeriksaan kesehatan. Default: **LatencyFailuresHealthCheck** |
| `InsufficientDataHealthStatus` | Ketika CloudWatch data metrik tidak mencukupi untuk menentukan status alarm, status yang Anda inginkan Amazon Route 53 tetapkan ke pemeriksaan kesehatan Nilai valid: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/eventbridge/latest/userguide/eb-ge-cfn.html) Default: Tidak sehat Bidang ini diperbarui berdasarkan masukan ke `TreatMissingData` bidang. Jika `TreatingMissingData` diatur ke`Missing`, itu akan diperbarui ke `LastKnownStatus` .If `TreatingMissingData` diatur ke`Breaching`, itu akan diperbarui ke`Unhealthy`. |
# Mengonfigurasi log untuk bus EventBridge acara Amazon
<a name="eb-event-bus-logs"></a>
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) 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](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 [Mengunggah, mengunduh, dan bekerja dengan objek di Amazon](https://docs.aws.amazon.com/AmazonS3/latest/userguide/uploading-downloading-objects.html) S3 di Panduan Pengguna *Layanan Penyimpanan Sederhana Amazon*.
## Cara kerja logging untuk bus acara
<a name="eb-event-logs-overview"></a>
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:
+ 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 terkelola](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 mengirim log ke tujuan yang dipilih. Untuk informasi selengkapnya, lihat [Menentukan tingkat log bus acara](#eb-event-bus-logs-level).
+ 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](#eb-event-logs-data).
### Pertimbangan pengiriman log
<a name="eb-event-logs-delivery"></a>
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 `[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 saat catatan log yang dienkripsi menggunakan kunci terkelola 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 [pemberitahuan 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
<a name="eb-event-logs-encryption"></a>
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
<a name="eb-event-logs-permission"></a>
Untuk mengaktifkan logging dari bus acara, Anda harus memberikan izin EventBridge untuk mengirim log dari bus itu. Tambahkan kebijakan yang diberikan **AllowVendedLogDeliveryForResource**ke 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 [Izin khusus layanan di Panduan](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-vended-logs-permissions) Pengguna *CloudWatch Log*.
## Menentukan tingkat log bus acara
<a name="eb-event-bus-logs-level"></a>
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
<a name="eb-event-logs-data"></a>
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
<a name="eb-event-logs-data-truncation"></a>
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
<a name="eb-event-logs-errors"></a>
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`
# Apa yang EventBridge dicatat Amazon untuk bus acara
<a name="eb-event-logs-execution-steps"></a>
Memahami bagaimana EventBridge proses peristiwa dapat membantu Anda dalam menggunakan log untuk memecahkan masalah atau men-debug masalah bus peristiwa.
Jika logging diaktifkan, EventBridge menghasilkan beberapa catatan log saat peristiwa diproses.
Berikut adalah langkah-langkah utama yang EventBridge dilakukan saat memproses suatu acara:
+ Sebuah acara dikirim ke bus acara
EventBridge menghasilkan log untuk acara yang dikirim dari sumber mitra, diputar ulang dari arsip, atau dikirim menggunakan`PutEvents`, apakah mereka cocok dengan aturan apa pun atau tidak.
+ EventBridge menentukan apakah acara tersebut cocok dengan aturan apa pun di bus.
Jika acara cocok dengan satu atau beberapa aturan, EventBridge lanjutkan ke langkah berikutnya.
Jika suatu AWS peristiwa tidak cocok dengan aturan apa pun, EventBridge buang acara tersebut dan tidak menghasilkan log apa pun.
+ EventBridge memanggil target.
EventBridge mencoba lagi memanggil target seperlunya sampai:
+ Acara telah berhasil disampaikan.
+ Pengiriman acara gagal, seperti jika kebijakan coba lagi berakhir atau kegagalan permanen terjadi.
Jika pengiriman gagal, EventBridge kirim acara ke antrian huruf mati (DLQ) jika ada yang ditentukan, atau jatuhkan acara jika tidak ada DLQ yang ditentukan.
Diagram di bawah ini menyajikan tampilan rinci dari alur pemrosesan peristiwa, dengan semua langkah yang mungkin diwakili, bersama dengan tingkat log dari setiap langkah.
Untuk daftar langkah lengkap, lihat[Menentukan tingkat log](eb-event-bus-logs.md#eb-event-bus-logs-level).
![\[EventBridge dilanjutkan melalui langkah-langkah untuk memproses setiap acara yang dikirim ke bus.\]](http://docs.aws.amazon.com/id_id/eventbridge/latest/userguide/images/bus_logging_eventbridge_conceptual.svg)
# Skema log bus EventBridge acara Amazon
<a name="eb-event-logs-schema"></a>
Referensi berikut merinci skema untuk catatan log bus EventBridge acara. Setiap catatan mewakili langkah EventBridge melakukan pemrosesan peristiwa tertentu.
Untuk informasi selengkapnya, lihat [Bus acara penebangan ](eb-event-bus-logs.md).
```
{
"resource\$1arn": "arn:aws:events:region:account:event-bus/bus-name",
"request\$1id": "guid",
"event\$1id": "guid",
"invocation\$1id": "guid",
"message\$1timestamp\$1ms": "date_time",
"message\$1type": "step",
"log\$1level": "TRACE | INFO | ERROR",
"details": {
},
"error": {
"http\$1status\$1code": code,
"error\$1message": "error_message",
"aws\$1service": "service_name",
"request\$1id": "service_request_id"
}
}
```
**resource\$1arn** <a name="event-log-schema-resource-arn"></a>
Nama Sumber Daya Amazon (ARN) untuk bus acara.
**request\$1id** <a name="event-log-schema-request-id"></a>
ID permintaan.
**event\$1id** <a name="event-log-schema-event-id"></a>
ID acara yang sedang diproses.
**invocation\$1id** <a name="event-log-schema-invocation-id"></a>
ID pemanggilan untuk acara tersebut.
**message\$1timestamp\$1ms** <a name="event-log-schema-timestamp"></a>
Tanggal dan waktu peristiwa log dipancarkan.
Satuan: milidetik
**message\$1type** <a name="event-log-schema-message-type"></a>
Langkah pemrosesan peristiwa di mana catatan log dihasilkan.
Untuk informasi selengkapnya tentang langkah-langkah yang EventBridge dilakukan saat memproses suatu peristiwa, lihat[Apa yang EventBridge dicatat Amazon untuk bus acara](eb-event-logs-execution-steps.md).
*Nilai yang valid:*
+ `EVENT_INGEST_FAILURE`
+ `EVENT_INGEST_SUCCESS`
+ `EVENT_RECEIPT`
+ `INVOCATION_ATTEMPT_PERMANENT_FAILURE`
+ `INVOCATION_ATTEMPT_RETRYABLE_FAILURE`
+ `INVOCATION_ATTEMPT_START`
+ `INVOCATION_ATTEMPT_SUCCESS`
+ `INVOCATION_ATTEMPT_THROTTLE`
+ `INVOCATION_DLQ`
+ `INVOCATION_FAILURE`
+ `INVOCATION_START`
+ `INVOCATION_SUCCESS`
+ `INVOCATION_THROTTLE_START`
+ `NO_STANDARD_RULES_MATCHED`
+ `RULE_MATCH`
+ `RULE_MATCH_START`
**tingkat log** <a name="event-log-schema-loglevel"></a>
Tingkat detail yang ditentukan untuk log bus acara.
*Nilai yang valid*: `ERROR` \$1 `INFO` \$1 `TRACE`
Untuk informasi selengkapnya, lihat [Menentukan tingkat log bus acara](eb-event-bus-logs.md#eb-event-bus-logs-level).
**detail** <a name="event-log-schema-details"></a>
Berisi detail langkah, berdasarkan jenis detail langkah.
Kolom yang tercantum di bawah ini dikembalikan untuk jenis pesan berikut:
+ `EVENT_INGEST_SUCCESS`
+ `EVENT_INGEST_FAILURE`
+ `EVENT_RECEIPT`
+ `RULE_MATCH_START`
```
{
"caller_account_id": "account_id",
"source_time_ms": date_time,
"source": "source",
"detail_type": " type",
"resources": [],
"event_detail": "{}"
}
```
Kolom yang tercantum di bawah ini dikembalikan untuk jenis pesan berikut:
+ `RULE_MATCH`
```
{
"rule_arn": "ARN",
"target_arns": [
"ARN"
],
"invocation_ids": [
"guid"
]
}
```
Kolom yang tercantum di bawah ini dikembalikan untuk jenis pesan berikut:
+ `INVOCATION_ATTEMPT_START`
+ `INVOCATION_START`
+ `INVOCATION_THROTTLE_START`
```
{
"rule_arn": "ARN",
"role_arn": "ARN",
"target_arn": "ARN",
"attempt_count": Integer,
"target_input": "string",
"target_properties": "string"
}
```
Kolom yang tercantum di bawah ini dikembalikan untuk jenis pesan berikut:
+ `INVOCATION_DLQ`
+ `INVOCATION_FAILURE`
+ `INVOCATION_SUCCESS`
```
{
"rule_arn": "ARN",
"role_arn": "ARN",
"target_arn": "ARN",
"target_input": "string",
"target_properties": "string",
"total_attempts": Integer,
"final_invocation_status": "status",
"ingestion_to_start_latency_ms": Integer,
"ingestion_to_complete_latency_ms": Integer,
"ingestion_to_success_latency_ms": Integer,
"target_duration_ms": Integer,
"target_response_body": "string"
}
```
Itu `ingestion_to_start_latency_ms` dan `ingestion_to_complete_latency_ms` hanya termasuk dalam upaya pemanggilan pertama. `ingestion_to_success_latency_ms`Bidang ini hanya disertakan untuk pemanggilan yang berhasil.
Kolom yang tercantum di bawah ini dikembalikan untuk jenis pesan berikut:
+ `INVOCATION_ATTEMPT_PERMANENT_FAILURE`
+ `INVOCATION_ATTEMPT_RETRYABLE_FAILURE`
+ `INVOCATION_ATTEMPT_SUCCESS`
+ `INVOCATION_ATTEMPT_THROTTLE`
```
{
"rule_arn": "ARN",
"role_arn": "ARN",
"target_arn": "ARN",
"attempt_type": "FIRST | THROTTLE | RETRY",
"attempt_count": Integer,
"invocation_status": "status",
"target_duration_ms": Integer,
"target_response_body": "string"
}
```
**dropped\$1fields** <a name="event-log-schema-dropped_fields"></a>
Daftar bidang data apa pun EventBridge telah dipotong untuk menyimpan catatan di bawah batasan ukuran 1 MB.
EventBridge tidak menyertakan bidang ini jika telah memotong bidang detail apa pun.
Untuk informasi selengkapnya, lihat [Memangkas data dalam log bus acara](eb-event-bus-logs.md#eb-event-logs-data-truncation).
**kesalahan** <a name="event-log-schema-error"></a>
Berisi informasi untuk setiap kesalahan yang dihasilkan selama langkah ini. Untuk kesalahan, EV selalu menyertakan bidang berikut:
+ `error_message`
+ `aws_service`
Dan bidang berikut jika tersedia:
+ `request_id`
+ `http_status_code`
Jika tidak ada kesalahan yang dihasilkan selama langkah ini, EventBridge tidak menyertakan bidang ini dalam catatan log.
**http\$1status\$1code** <a name="event-log-schema-http-status-code"></a>
Kode status HTTP dikembalikan oleh layanan yang disebut.
**error\$1message** <a name="event-log-schema-message"></a>
Pesan kesalahan dikembalikan oleh layanan yang disebut.
**aws\$1service** <a name="event-log-schema-aws-service"></a>
Nama layanan yang disebut.
**request\$1id** <a name="event-log-schema-error-request-id"></a>
ID permintaan untuk permintaan ini dari layanan yang disebut.