Pengiriman push Azure Event Grid - konsep
Artikel ini menjelaskan konsep Event Grid utama yang terkait dengan pengiriman push.
Catatan
Untuk konsep Event Grid yang terkait dengan model sumber daya baru yang menggunakan namespace layanan, lihat artikel konsep ini.
Acara
Peristiwa adalah jumlah informasi terkecil yang sepenuhnya menjelaskan sesuatu yang terjadi dalam sistem. Setiap peristiwa memiliki informasi umum seperti source
peristiwa, time
acara berlangsung, dan pengidentifikasi unik. Setiap acara juga memiliki informasi spesifik yang hanya relevan dengan jenis acara tertentu. Misalnya, kejadian tentang file baru yang sedang dibuat di Azure Storage memiliki detail tentang file, seperti lastTimeModified
nilainya. Peristiwa Azure Event Hubs memiliki URL
file Capture. Peristiwa tentang urutan baru dalam layanan mikro Pesanan Anda mungkin memiliki orderId
atribut dan URL
atribut ke representasi status pesanan.
CloudEvents
Event Grid menggunakan spesifikasi CloudEvents 1.0 standar terbuka CNCF menggunakan pengikatan protokol HTTP dengan format JSON. CloudEvents adalah spesifikasi peristiwa yang dapat diperluas dengan ekstensi yang didokumenkan untuk persyaratan tertentu. Saat menggunakan Event Grid, CloudEvents adalah format peristiwa pilihan karena kasus penggunaannya yang didokumentasikan dengan baik (mode untuk mentransfer peristiwa, format peristiwa, dll.), ekstensibilitas, dan peningkatan interoperabilitas. CloudEvents meningkatkan interoperabilitas dengan menyediakan format peristiwa umum untuk menerbitkan dan menggunakan peristiwa. Ini memungkinkan alat seragam dan cara standar perutean & penanganan peristiwa.
Tabel berikut ini memperlihatkan dukungan saat ini untuk spesifikasi CloudEvents:
CloudEvents con mode tenda | Didukung? |
---|---|
JSON terstruktur | Ya |
Biner | No |
Ukuran maksimum yang diperbolehkan untuk suatu acara adalah 1 MB. Peristiwa di atas 64 KB dikenakan biaya dengan 64 KB tahapan. Untuk properti yang dikirim dalam suatu kejadian, lihat skema CloudEvents.
Format lain
Event Grid juga mendukung format skema Event Grid eksklusif untuk penerbit peristiwa sistem. Anda dapat mengonfigurasi Event Grid untuk mengirimkan peristiwa menggunakan format CloudEvents .
Penerbit
Penerbit adalah aplikasi yang mengirim peristiwa ke Event Grid. Ini bisa menjadi aplikasi yang sama tempat peristiwa berasal, sumber peristiwa. Layanan Azure menerbitkan peristiwa ke Event Grid untuk mengumumkan kemunculan dalam layanan mereka. Anda dapat menerbitkan kejadian dari aplikasi Anda sendiri. Organisasi yang menghosting layanan di luar Azure juga dapat menerbitkan peristiwa melalui Event Grid.
Sumber Kejadian
Sumber kejadian adalah tempat peristiwa terjadi. Setiap sumber kejadian terkait dengan satu atau beberapa jenis peristiwa. Misalnya, Azure Storage adalah sumber kejadian untuk kejadian yang dibuat blob. IoT Hub adalah sumber kejadian untuk kejadian yang dibuat perangkat. Aplikasi Anda adalah sumber kejadian untuk kejadian kustom yang Anda tentukan. Sumber kejadian bertanggung jawab untuk mengirim kejadian ke Event Grid.
Mitra
Mitra adalah semacam penerbit yang mengirimkan kejadian dari sistemnya agar tersedia bagi pelanggan Azure. Mitra biasanya adalah penyedia SaaS atau ERP yang terintegrasi dengan Azure Event Grid untuk membantu pelanggan mewujudkan kasus penggunaan berbasis kejadian di seluruh platform. Mitra tidak hanya dapat menerbitkan kejadian ke Azure Event Grid, tetapi juga dapat menerima kejadian dari sana. Kemampuan ini tersedia melalui fitur Acara Mitra.
Topik
Topik menyimpan peristiwa yang telah diterbitkan ke Event Grid. Anda biasanya menggunakan sumber daya topik untuk kumpulan peristiwa terkait. Untuk menanggapi jenis peristiwa tertentu, pelanggan (layanan Azure atau aplikasi lain) memutuskan topik mana yang akan dilanggani. Ada beberapa jenis topik: topik kustom, topik sistem, dan topik mitra.
Topik kustom
Topik kustom juga merupakan topik yang digunakan dengan aplikasi Anda. Mereka adalah jenis topik pertama yang dirancang untuk membangun integrasi berbasis peristiwa untuk aplikasi kustom. Sebagai sumber daya mandiri, mereka mengekspos titik akhir mereka sendiri ke peristiwa mana yang diterbitkan.
Topik kustom mendukung pengiriman push. Konsultasikan kapan menggunakan pengiriman penarikan atau pendorongan untuk membantu Anda memutuskan apakah pengiriman push adalah pendekatan yang tepat mengingat kebutuhan Anda. Anda mungkin juga ingin merujuk ke artikel Topik kustom.
Topik sistem
Topik sistem adalah topik bawaan yang disediakan oleh layanan Azure seperti Azure Storage, Azure Event Hubs, dan Azure Service Bus. Anda dapat membuat topik sistem di langganan Azure dan berlangganan topik tersebut. Untuk informasi selengkapnya, lihat Gambaran umum topik sistem.
Topik mitra
Topik mitra adalah semacam topik yang digunakan untuk berlangganan ke kejadian yang diterbitkan oleh mitra. Fitur yang mengaktifkan jenis integrasi ini disebut Kejadian Mitra. Melalui integrasi tersebut, Anda mendapatkan topik mitra tempat kejadian dari sistem mitra tersedia. Setelah Anda memiliki topik mitra, Anda membuat langganan kejadian seperti yang akan Anda lakukan untuk jenis topik lainnya.
Langganan acara
Catatan
Untuk informasi tentang langganan peristiwa di bawah topik namespace, lihat artkel konsep ini.
Langganan memberi tahu Event Grid peristiwa mana pada topik yang Anda minati untuk diterima. Saat membuat langganan, Anda menyediakan titik akhir untuk menangani peristiwa. Titik akhir dapat berupa webhook atau sumber daya layanan Azure. Anda dapat memfilter peristiwa yang dikirim ke titik akhir. Anda dapat memfilter menurut jenis kejadian atau subjek kejadian, misalnya. Untuk informasi selengkapnya, lihat Langganan peristiwa dan skema CloudEvents. Langganan peristiwa untuk topik kustom, sistem, dan mitra serta Domain memiliki properti sumber daya yang sama.
Untuk contoh pembuatan langganan untuk topik kustom, sistem, dan mitra serta Domain, lihat:
- Membuat topik kustom dan berlangganan peristiwa menggunakan Azure CLI
- Sampel Azure PowerShell untuk Event Grid
- Templat Azure Resource Manager untuk Event Grid
Untuk informasi mengenai cara mendapatkan langganan Event Grid Anda saat ini, lihat Meminta langganan Event Grid.
Waktu kedaluwarsa langganan acara
Anda dapat mengatur waktu kedaluwarsa untuk langganan peristiwa yang terkait dengan topik kustom, sistem, mitra, dan domain serta ke langganan Domain. Langganan acara akan kedaluwarsa secara otomatis setelah tanggal tersebut. Atur kedaluwarsa untuk langganan acara yang hanya diperlukan untuk waktu yang terbatas dan Anda tidak ingin khawatir tentang membersihkan langganan tersebut. Misalnya, saat membuat langganan acara untuk menguji skenario, Anda mungkin ingin menetapkan kedaluwarsa.
Untuk contoh pengaturan kedaluwarsa, lihat Berlangganan dengan filter tingkat lanjut.
Penangan kejadian
Dari perspektif Event Grid, penanganan aktivitas adalah tempat peristiwa dikirim saat menggunakan pengiriman push. Pengatur mengambil beberapa tindakan lebih lanjut untuk memproses acara tersebut. Saat menggunakan pengiriman push, Event Grid mendukung beberapa jenis handler. Anda dapat menggunakan layanan Azure yang didukung, atau webhook Anda sendiri sebagai handler. Tergantung pada jenis penangan, Event Grid mengikuti mekanisme yang berbeda untuk menjamin pengiriman acara. Untuk penanganan aktivitas webhook HTTP, acara dicoba kembali sampai penangan mengembalikan kode status 200 – OK
. Untuk Antrean Azure Storage, acara dicoba hingga layanan Antrean berhasil memproses dorongan pesan ke dalam antrean.
Untuk informasi mengenai pengiriman kejadian ke penghandel Event Grid apa pun yang didukung, lihat Penanganan aktivitas di Azure Event Grid.
Keamanan
Event Grid menyediakan keamanan untuk berlangganan topik dan saat menerbitkan peristiwa ke topik. Saat berlangganan, Anda harus memiliki izin yang memadai pada topik Event Grid. Jika menggunakan pengiriman push, penanganan aktivitas adalah layanan Azure, dan identitas terkelola digunakan untuk mengautentikasi Event Grid, identitas terkelola harus memiliki peran RBAC yang sesuai. Misalnya, jika mengirim peristiwa ke Azure Event Hubs, identitas terkelola yang digunakan dalam langganan peristiwa harus menjadi anggota peran Pengirim Data Azure Event Hubs. Saat menerbitkan, Anda harus memiliki token SAS atau autentikasi kunci untuk topik tersebut. Untuk mengetahui informasi selengkapnya, lihat Keamanan dan autentikasi Event Grid.
Pengiriman acara
Jika Event Grid tidak dapat mengonfirmasi bahwa peristiwa telah diterima oleh titik akhir pelanggan saat menggunakan pengiriman push, peristiwa akan dikirim ulang. Untuk informasi selengkapnya, lihat Pengiriman pesan Event Grid dan coba lagi.
Pembuatan batch
Saat Anda menggunakan topik kustom, kejadian harus selalu diterbitkan dalam array. Ini bisa menjadi batch dari satu untuk skenario throughput rendah.
Definisi jenis kejadian sebaris
Jika Anda adalah mitra, Anda dapat menentukan jenis peristiwa yang Anda sediakan untuk pelanggan saat membuat Saluran. Dengan definisi jenis peristiwa sebaris, pelanggan dapat dengan mudah memfilter peristiwa mengingat jenis peristiwanya saat mengonfigurasi langganan peristiwa.
Zona ketersediaan
Zona ketersediaan Azure adalah lokasi terpisah secara fisik dalam setiap wilayah Azure yang toleran terhadap kegagalan lokal. Mereka terhubung oleh jaringan berkinerja tinggi dengan latensi pulang pergi kurang dari 2 milidetik. Setiap zona ketersediaan terdiri dari satu atau beberapa pusat data yang dilengkapi dengan infrastruktur daya, pendinginan, dan jaringan independen. Jika satu zona terpengaruh, layanan regional, kapasitas, dan ketersediaan tinggi didukung oleh dua zona yang tersisa. Untuk informasi selengkapnya tentang zona ketersediaan, lihat Wilayah dan zona ketersediaan.
Langkah berikutnya
- Untuk pengantar Event Grid, lihat Tentang Event Grid.
- Untuk mulai menggunakan topik kustom, lihat Membuat dan merutekan peristiwa kustom dengan Azure Event Grid.