Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Membuat EventBridge pipa Amazon
EventBridge Pipes memungkinkan Anda membuat point-to-point integrasi antara sumber dan target, termasuk transformasi dan pengayaan acara lanjutan. Untuk membuat EventBridge pipa, Anda melakukan langkah-langkah berikut:
Untuk informasi tentang cara membuat pipa menggunakan AWS CLI, lihat create-pipe
Menentukan sumber
Untuk memulai, tentukan sumber dari mana Anda ingin pipa menerima acara.
Untuk menentukan sumber pipa dengan menggunakan konsol
Buka EventBridge konsol Amazon di https://console.aws.amazon.com/events/
. -
Pada panel navigasi, pilih Pipa.
-
Pilih Buat pipa.
-
Masukkan nama untuk pipa.
-
(Opsional) Tambahkan deskripsi untuk pipa.
-
Pada tab Build pipe, untuk Source, pilih jenis sumber yang ingin Anda tentukan untuk pipa ini, dan konfigurasikan sumbernya.
Properti konfigurasi berbeda berdasarkan jenis sumber yang Anda pilih:
Mengkonfigurasi penyaringan acara (opsional)
Anda dapat menambahkan pemfilteran ke pipa Anda sehingga Anda hanya mengirim sebagian peristiwa dari sumber Anda ke target.
Untuk mengkonfigurasi pemfilteran dengan menggunakan konsol
-
Pilih Penyaringan.
-
Di bawah Contoh acara - opsional, Anda akan melihat contoh peristiwa yang dapat Anda gunakan untuk membangun pola acara Anda, atau Anda dapat memasukkan acara Anda sendiri dengan memilih Enter your own.
-
Di bawah Pola acara, masukkan pola acara yang ingin Anda gunakan untuk memfilter peristiwa. Untuk informasi selengkapnya tentang membuat filter, lihatPemfilteran acara di Amazon Pipes EventBridge .
Berikut ini adalah contoh pola peristiwa yang hanya mengirimkan peristiwa dengan nilai Seattle di bidang City.
{ "data": { "City": ["Seattle"] } }
Sekarang peristiwa sedang difilter, Anda dapat menambahkan pengayaan opsional dan target untuk pipa.
Mendefinisikan pengayaan acara (opsional)
Anda dapat mengirim data peristiwa untuk pengayaan ke fungsi Lambda, AWS Step Functions mesin status, Amazon API Gateway, atau tujuan. API
Untuk memilih pengayaan
-
Pilih Pengayaan.
-
Di bawah Detail, untuk Layanan, pilih layanan dan pengaturan terkait yang ingin Anda gunakan untuk pengayaan.
Anda juga dapat mengubah data sebelum mengirimnya untuk ditingkatkan.
(Opsional) Untuk menentukan transformator input
-
Pilih Enrichment Input Transformer - opsional.
-
Untuk Acara Sampel/Payload Acara, pilih jenis acara sampel.
-
Untuk Transformer, masukkan sintaks transformator, seperti
"Event happened at <$.detail.field>."
di mana<$.detail.field>
adalah referensi ke bidang dari peristiwa sampel. Anda juga dapat mengklik dua kali bidang dari peristiwa sampel untuk menambahkannya ke transformator. -
Untuk Output, verifikasi bahwa output terlihat seperti yang Anda inginkan.
Sekarang data telah disaring dan ditingkatkan, Anda harus menentukan target untuk mengirim data acara ke.
Mengkonfigurasi target
Untuk mengkonfigurasi target
-
Pilih Target.
-
Di bawah Detail, untuk layanan Target, pilih target. Bidang yang ditampilkan bervariasi tergantung pada target yang Anda pilih. Masukkan informasi khusus untuk jenis target ini, sesuai kebutuhan.
Anda juga dapat mengubah data sebelum mengirimnya ke target.
(Opsional) Untuk menentukan transformator input
-
Pilih Target Input Transformer - opsional.
-
Untuk Acara Sampel/Payload Acara, pilih jenis acara sampel.
-
Untuk Transformer, masukkan sintaks transformator, seperti
"Event happened at <$.detail.field>."
di mana<$.detail.field>
adalah referensi ke bidang dari peristiwa sampel. Anda juga dapat mengklik dua kali bidang dari peristiwa sampel untuk menambahkannya ke transformator. -
Untuk Output, verifikasi bahwa output terlihat seperti yang Anda inginkan.
Sekarang pipa dikonfigurasi, pastikan pengaturannya dikonfigurasi dengan benar.
Mengkonfigurasi pengaturan pipa
Pipa aktif secara default, tetapi Anda dapat menonaktifkannya. Anda juga dapat menentukan izin pipa, mengatur logging pipa, dan menambahkan tag.
Untuk mengkonfigurasi pengaturan pipa
-
Pilih tab Pengaturan pipa.
-
Secara default, pipa yang baru dibuat aktif segera setelah dibuat. Jika Anda ingin membuat pipa tidak aktif, di bawah Aktivasi, untuk Aktifkan pipa, matikan Aktif.
-
Di bawah Izin, untuk peran Eksekusi, lakukan salah satu hal berikut:
-
Untuk EventBridge membuat peran eksekusi baru untuk pipa ini, pilih Buat peran baru untuk sumber daya khusus ini. Di bawah Nama peran, Anda dapat mengedit nama peran secara opsional.
-
Untuk menggunakan peran eksekusi yang ada, pilih Gunakan peran yang ada. Di bawah Nama peran, pilih peran.
-
-
(Opsional) Jika Anda telah menentukan DynamoDB aliran Kinesis atau sebagai sumber pipa, Anda dapat mengonfigurasi kebijakan coba lagi dan antrian huruf mati (). DLQ
Untuk kebijakan Coba lagi dan antrian Dead-letter - opsional, lakukan hal berikut:
Di bawah kebijakan Coba Ulang, lakukan hal berikut:
-
Jika Anda ingin mengaktifkan kebijakan coba lagi, aktifkan Coba lagi. Secara default, pipa yang baru dibuat tidak mengaktifkan kebijakan coba lagi.
-
Untuk Masa peristiwa maksimal, masukkan nilai antara satu menit (00:01) dan 24 jam (24:00).
-
Untuk Upaya coba lagi, masukkan angka antara 0 dan 185.
-
Jika Anda ingin menggunakan antrean huruf mati (DLQ), aktifkan antrian Dead-letter, pilih metode pilihan Anda, dan pilih antrian atau topik yang ingin Anda gunakan. Secara default, pipa yang baru dibuat tidak menggunakan fileDLQ.
-
-
Pilih KMS key EventBridge untuk digunakan saat mengenkripsi data pipa.
Untuk informasi selengkapnya tentang cara EventBridge penggunaan KMS keys, lihatEnkripsi diam.
-
Pilih Gunakan Kunci milik AWS EventBridge untuk mengenkripsi data menggunakan file Kunci milik AWS.
Ini Kunci milik AWS adalah KMS key 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 yang dikelola pelanggan EventBridge untuk mengenkripsi data menggunakan kunci yang dikelola pelanggan yang Anda tentukan atau buat.
Kunci yang dikelola pelanggan ada KMS keys di AWS akun Anda yang Anda buat, miliki, dan kelola. Anda memiliki kendali penuh atas ini KMS keys.
-
Tentukan yang sudah ada kunci yang dikelola pelanggan, atau pilih Buat yang baru KMS key.
EventBridge menampilkan status kunci dan alias kunci apa pun yang telah dikaitkan dengan yang ditentukan kunci yang dikelola pelanggan.
-
-
-
(Opsional) Di bawah Log - opsional, Anda dapat mengatur cara EventBridge Pipes mengirimkan informasi pencatatan ke layanan yang didukung, termasuk cara mengonfigurasi log tersebut.
Untuk informasi selengkapnya tentang pencatatan pipa logging, lihatPencatatan kinerja Amazon EventBridge Pipes.
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 berisiERROR
tingkat detail.Agar EventBridge Pipes mengirim catatan log ke salah satu tujuan log yang didukung, lakukan hal berikut:
-
Di bawah Log - opsional, pilih tujuan yang ingin Anda kirimkan catatan log.
-
Untuk tingkat Log, pilih tingkat informasi EventBridge untuk disertakan dalam catatan log. Tingkat
ERROR
log dipilih secara default.Untuk informasi selengkapnya, lihat Menentukan tingkat log EventBridge Pipa.
-
Pilih Sertakan data eksekusi jika Anda EventBridge ingin menyertakan informasi muatan peristiwa dan permintaan layanan dan informasi respons dalam catatan log.
Untuk informasi selengkapnya, lihat Termasuk data eksekusi di log EventBridge Pipes.
-
Konfigurasikan setiap tujuan log yang Anda pilih:
Untuk CloudWatch Logs log, di bawah CloudWatch log lakukan hal berikut:
-
Untuk grup CloudWatch log, pilih apakah akan EventBridge membuat grup log baru, atau Anda dapat memilih grup log yang ada atau menentukan grup log yang ada. ARN
-
Untuk grup log baru, edit nama grup log sesuai keinginan.
CloudWatch log dipilih secara default.
Untuk log Firehose aliran, di bawah log Firehose aliran, pilih Firehose aliran.
Untuk Amazon S3 log, di bawah log S3 lakukan hal berikut:
-
Masukkan nama bucket untuk digunakan sebagai tujuan log.
-
Masukkan ID AWS akun pemilik bucket.
-
Masukkan teks awalan yang ingin Anda gunakan saat EventBridge membuat objek S3.
Untuk informasi selengkapnya, lihat Mengatur objek menggunakan awalan di Amazon Simple Storage Service Panduan Pengguna.
-
Pilih bagaimana Anda ingin EventBridge memformat catatan log S3:
-
json
: JSON -
plain
: Teks biasa -
w3c
: Format file logging diperpanjang W3C
-
-
-
-
(Opsional) Di bawah Tag - opsional, pilih Tambahkan tag baru dan masukkan satu atau beberapa tag untuk aturan. Untuk informasi selengkapnya, lihat Menandai sumber daya di Amazon EventBridge.
-
Pilih Buat pipa.
Memvalidasi parameter konfigurasi
Setelah pipa dibuat, EventBridge memvalidasi parameter konfigurasi berikut:
-
IAMperan — Karena sumber pipa tidak dapat diubah setelah pipa dibuat, EventBridge memverifikasi bahwa IAM peran yang disediakan dapat mengakses sumber.
catatan
EventBridge tidak melakukan validasi yang sama untuk pengayaan atau target karena dapat diperbarui setelah pipa dibuat.
-
Batching — EventBridge memvalidasi bahwa ukuran batch sumber tidak melebihi ukuran batch maksimum target. Jika ya, EventBridge membutuhkan ukuran batch yang lebih rendah. Selain itu, jika target tidak mendukung batching, Anda tidak dapat mengonfigurasi batching EventBridge untuk sumbernya.
-
Pengayaan — EventBridge memvalidasi bahwa ukuran batch untuk API Gateway dan pengayaan API tujuan adalah 1 karena hanya ukuran batch 1 yang didukung.