Menggunakan fungsi sebagai penanganan aktivitas untuk peristiwa Event Grid

Artikel
08/31/2023

Penanganan aktivitas adalah tempat peristiwa dikirim. Penanganan mengambil tindakan untuk memproses peristiwa. Beberapa layanan Azure secara otomatis dikonfigurasi untuk menangani peristiwa dan Azure Functions adalah salah satunya.

Untuk menggunakan fungsi di Azure sebagai penanganan untuk acara, ikuti salah satu pendekatan berikut:

Menggunakan pemicu Event Grid. Tentukan Fungsi Azure sebagai jenis titik akhir. Kemudian, tentukan aplikasi fungsi dan fungsi yang akan menangani peristiwa.
Menggunakan Pemicu HTTP. Tentukan Web Hook sebagai jenis titik akhir. Kemudian, tentukan URL untuk fungsi yang akan menangani peristiwa.

Kami menyarankan Agar Anda menggunakan pendekatan pertama (pemicu Event Grid) karena memiliki keuntungan berikut dibandingkan pendekatan kedua:

Event Grid secara otomatis memvalidasi pemicu Event Grid. Dengan pemicu HTTP generik, Anda harus menerapkan respons validasi sendiri.
Event Grid secara otomatis menyesuaikan laju di mana peristiwa dikirimkan ke fungsi yang dipicu oleh peristiwa Event Grid berdasarkan tingkat yang dirasakan di mana fungsi dapat memproses peristiwa. Fitur pencocokan tingkat ini mencegah kesalahan pengiriman yang berasal dari ketidakmampuan suatu fungsi untuk memproses peristiwa karena tingkat pemrosesan peristiwa fungsi dapat bervariasi dari waktu ke waktu. Untuk meningkatkan efisiensi pada throughput tinggi, aktifkan batching pada langganan peristiwa. Untuk informasi selengkapnya, lihat Aktifkan batching.

Catatan

Saat Anda menjadi pemicu Event Grid untuk menambahkan langganan peristiwa menggunakan fungsi Azure, Event Grid mengambil kunci akses untuk fungsi target menggunakan kredensial perwakilan layanan Event Grid. Izin akses diberikan ke Event Grid saat Anda mendaftarkan penyedia sumber daya Event Grid di langganan Azure mereka.
Jika Anda melindungi fungsi Azure dengan aplikasi MICROSOFT Entra ID , Anda harus mengambil pendekatan webhook generik menggunakan pemicu HTTP. Gunakan titik akhir fungsi Azure sebagai URL webhook saat menambahkan langganan.

Tutorial

Judul	Deskripsi
Mulai cepat: Menangani peristiwa dengan fungsi	Mengirim peristiwa kustom ke fungsi untuk diproses.
Tutorial: mengotomatiskan pengubahan ukuran gambar yang diunggah menggunakan Event Grid	Pengguna mengunggah gambar melalui aplikasi web ke akun penyimpanan. Saat blob penyimpanan dibuat, Event Grid mengirimkan peristiwa ke aplikasi fungsi, yang mengubah ukuran gambar yang diunggah.
Tutorial: streaming big data ke dalam gudang data	Saat Pusat Aktivitas membuat file Capture, Event Grid mengirimkan peristiwa ke aplikasi fungsi. Aplikasi ini mengambil file Capture dan memigrasikan data ke gudang data.
Tutorial: Contoh integrasi Azure Service Bus ke Azure Event Grid	Azure Event Grid mengirimkan pesan dari topik Azure Service Bus ke aplikasi fungsi dan aplikasi logika.

Contoh REST (untuk PUT)

{
	"properties": 
	{
		"destination": 
		{
			"endpointType": "AzureFunction",
			"properties": 
			{
				"resourceId": "/subscriptions/<AZURE SUBSCRIPTION ID>/resourceGroups/<RESOURCE GROUP NAME>/providers/Microsoft.Web/sites/<FUNCTION APP NAME>/functions/<FUNCTION NAME>",
				"maxEventsPerBatch": 10,
				"preferredBatchSizeInKilobytes": 64
			}
		},
		"eventDeliverySchema": "EventGridSchema"
	}
}

Mengaktifkan batching

Untuk throughput yang lebih tinggi, aktifkan batching pada langganan. Jika Anda menggunakan portal Azure, Anda dapat mengatur peristiwa maksimum per batch dan ukuran batch pilihan dalam kilo byte pada saat membuat langganan atau setelah pembuatan.

Anda dapat membuat antrean menggunakan portal Microsoft Azure, PowerShell, CLI, atau templat Resource Manager.

Portal Azure

Saat membuat langganan di antarmuka pengguna, pada laman Buat Langganan Peristiwa, alihkan ke tab Fitur Tingkat Lanjut, dan tetapkan nilai untuk Peristiwa maks per batch dan Ukuran batch pilihan dalam kilobyte.

Enable batching at the time of creating a subscription

Anda bisa memperbarui nilai ini untuk langganan yang sudah ada pada tab Fitur di halaman Topik Event Grid.

Enable batching after creation

Templat Azure Resource Manager

Anda dapat mengatur maxEventsPerBatch dan preferredBatchSizeInKilobytes dalam templat Azure Resource Manager. Untuk informasi selengkapnya, lihat referensi templat Microsoft.EventGrid eventSubscriptions.

Azure CLI

Anda dapat menggunakan az eventgrid event-subscription create perintah untuk mengonfigurasi pengaturan terkait batch menggunakan parameter berikut: --max-events-per-batch atau --preferred-batch-size-in-kilobytes.

Azure PowerShell

Anda dapat menggunakan cmdlet New-AzEventGridSubscription atau Update-AzEventGridSubscription untuk mengonfigurasi pengaturan terkait batch menggunakan parameter berikut: -MaxEventsPerBatch atau -PreferredBatchSizeInKiloBytes.