Bagikan melalui

Tutorial: Menggunakan topik namespace layanan untuk merutekan pesan MQTT ke Azure Event Hubs (portal Azure)

  • Artikel

Dalam tutorial ini, Anda mempelajari cara menggunakan topik namespace layanan untuk merutekan data dari klien MQTT ke Azure Event Hubs. Berikut adalah langkah-langkah tingkat tinggi:

Prasyarat

  • Jika Anda tidak memiliki langganan Azure, buat akun gratis Azure sebelum memulai.
  • Jika Anda baru menggunakan Event Grid, baca gambaran umum Event Grid sebelum memulai tutorial ini.
  • Daftarkan penyedia sumber daya Event Grid sesuai dengan langkah-langkah di Mendaftarkan penyedia sumber daya Event Grid.
  • Pastikan port 8883 terbuka di firewall Anda. Sampel dalam tutorial ini menggunakan protokol MQTT, yang berkomunikasi melalui port 8883. Port ini mungkin diblokir di beberapa lingkungan jaringan perusahaan dan pendidikan.

Membuat namespace layanan di portal Microsoft Azure

Namespace layanan di Azure Event Grid adalah kontainer logis untuk satu atau beberapa topik, klien, grup klien, ruang topik, dan pengikatan izin. Ini menyediakan namespace layanan yang unik, memungkinkan Anda memiliki beberapa sumber daya di wilayah Azure yang sama. Dengan namespace Azure Event Grid, Anda dapat mengelompokkan sekarang bersama sumber daya terkait dan mengelolanya sebagai satu unit di langganan Azure Anda.

Silakan ikuti bagian berikutnya untuk membuat, melihat, dan mengelola namespace Azure Event Grid.

Untuk membuat namespace layanan:

  1. Masuk ke portal Microsoft Azure.

  2. Dalam kotak pencarian, masukkan Namespace Layanan Event Grid dan pilih Namespace Layanan Event Grid dari hasil.

    Cuplikan layar memperlihatkan Namespace Layanan Event Grid di hasil pencarian.

  3. Pada halaman Namespace Layanan Event Grid, pilih + Buat pada toolbar.

    Cuplikan layar memperlihatkan halaman Namespace Layanan Event Grid dengan tombol Buat pada toolbar dipilih.

  4. Pada halaman Dasar , ikuti langkah-langkah ini.

    1. Pilih langganan Azure tempat Anda ingin membuat namespace layanan.

    2. Pilih grup sumber daya yang ada atau buat grup sumber daya.

    3. Masukkan nama untuk kumpulan nama.

    4. Pilih wilayah atau lokasi tempat Anda ingin membuat namespace layanan.

    5. Pilih Tinjau + buat di bagian bawah halaman.

      Cuplikan layar memperlihatkan tab Dasar dari halaman Buat namespace layanan.

  5. Pada tab Tinjau + buat , tinjau pengaturan Anda dan pilih Buat.

  6. Pada halaman Penyebaran berhasil , pilih Buka sumber daya untuk menavigasi ke namespace Anda.

Membuat topik namespace layanan

  1. Jika Anda tidak berada di halaman Namespace Layanan Event Grid, ikuti langkah-langkah membuat, melihat, dan mengelola namespace layanan untuk melihat namespace yang ingin Anda gunakan untuk membuat topik.

  2. Pada halaman Namespace Layanan Event Grid, pilih opsi Topik di bagian Acara di menu sebelah kiri.

  3. Pada halaman Topik , pilih tombol + Topik pada bilah perintah.

    Cuplikan layar memperlihatkan pembuatan topik namespace Layanan Event Grid.

  4. Pada halaman Buat Topik , ketik nama topik yang ingin Anda buat dan pilih Buat.

    Cuplikan layar memperlihatkan dasar-dasar pembuatan topik namespace Layanan Event Grid.

Mengaktifkan identitas terkelola untuk namespace Layanan Event Grid

  1. Pada halaman Namespace Layanan Event Grid, pilih Identitas di bawah Pengaturan di menu sebelah kiri.

  2. Aktifkan sakelar untuk mengaktifkan identitas terkelola yang ditetapkan sistem.

  3. Pilih Simpan pada toolbar untuk menyimpan pengaturan.

    Cuplikan layar halaman identitas yang ditetapkan sistem untuk namespace Layanan Event Grid.

  4. Pilih Ya pada pesan informasi.

  5. Konfirmasi bahwa Anda melihat ID objek dari identitas terkelola yang ditetapkan sistem dan melihat tautan untuk menetapkan peran.

    Cuplikan layar yang memperlihatkan penetapan identitas ke namespace selesai.

    Periksa pemberitahuan di portal untuk mengonfirmasi bahwa identitas terkelola diaktifkan untuk namespace layanan.

Mengaktifkan broker MQTT untuk namespace Layanan Event Grid

  1. Pada halaman Namespace Layanan Event Grid, pilih Konfigurasi di bawah Pengaturan di menu sebelah kiri.

  2. Pilih kotak centang di samping Aktifkan broker MQTT.

  3. Pilih Terapkan di bagian bawah halaman.

    Cuplikan layar memperlihatkan halaman konfigurasi namespace Layanan Event Grid untuk mengaktifkan MQTT.

    Periksa pemberitahuan di portal untuk mengonfirmasi bahwa broker MQTT diaktifkan untuk namespace layanan.

Di tab terpisah dari browser Web atau di jendela terpisah, gunakan portal Azure untuk membuat namespace Layanan Pusat Aktivitas dengan hub peristiwa.

Membuat namespace layanan Pusat Aktivitas

Kumpulan nama Event Hubs menyediakan kontainer pencakupan yang unik, tempat Anda membuat satu pusat aktivitas atau lebih. Untuk membuat kumpulan nama di grup sumber daya Anda menggunakan portal, lakukan tindakan berikut:

  1. Di portal Azure, pilih Semua layanan di menu sebelah kiri, dan pilih bintang (*) di samping Azure Event Hubs di kategori Analitik. Konfirmasikan bahwa Event Hubs ditambahkan ke FAVORIT di menu navigasi kiri.

    Cuplikan layar memperlihatkan pemilihan Azure Event Hubs di halaman Semua layanan.

  2. Pilih Pusat Aktivitas di bawah FAVORIT di menu navigasi kiri, dan pilih Buat pada toolbar.

    Cuplikan layar memperlihatkan pilihan tombol Buat di halaman Event hubs.

  3. Pada halaman Buat kumpulan nama, ikuti langkah-langkah berikut:

    1. Pilih langganan tempat Anda ingin membuat kumpulan nama.

    2. Pilih grup sumber daya yang Anda buat pada langkah sebelumnya.

    3. Masukkan nama untuk kumpulan nama. Sistem akan segera memeriksa untuk melihat apakah nama tersebut tersedia.

    4. Pilih lokasi untuk kumpulan nama tersebut.

    5. Pilih Dasar untuk tingkat harga. Jika Anda berencana menggunakan namespace layanan dari aplikasi Apache Kafka , gunakan tingkat Standar . Tingkat dasar tidak mendukung beban kerja Apache Kafka. Untuk mempelajari tentang perbedaan antar tingkatan, lihat Kuota dan batas, Azure Event Hubs Premium, dan artikel Azure Event Hubs Dedicated.

    6. Biarkan unit throughput (untuk tingkat standar) atau unit pemrosesan (untuk tingkat premium) pengaturan seperti apa adanya. Untuk mempelajari tentang unit throughput atau unit pemrosesan: Skalabilitas Azure Event Hubs.

    7. Pilih Tinjau + Buat di bagian bawah halaman.

      Cuplikan layar halaman Buat Namespace di portal Azure.

    8. Pada halaman Tinjau + Buat, tinjau pengaturan, dan pilih Buat. Tunggu hingga penerapan selesai.

  4. Pada halaman Penerapan, pilih Buka sumber daya untuk mengarahkan ke halaman untuk kumpulan nama Anda.

    Cuplikan layar halaman Penyebaran lengkap dengan tautan ke sumber daya.

  5. Konfirmasikan bahwa Anda melihat halaman Kumpulan Nama Event Hubs yang mirip dengan contoh berikut:

    Cuplikan layar beranda untuk namespace Layanan Pusat Aktivitas Anda di portal Azure.

Membuat pusat aktivitas

Untuk membuat pusat aktivitas di dalam kumpulan nama, lakukan tindakan berikut:

  1. Pada halaman Gambaran Umum , pilih + Event hub pada bilah perintah.

    Cuplikan layar pemilihan tombol Tambahkan hub peristiwa pada bilah perintah.

  2. Ketik nama untuk pusat aktivitas Anda, lalu pilih Tinjau + buat.

    Cuplikan layar halaman Buat hub peristiwa.

  3. Pada halaman Tinjau + buat, pilih Buat.

  4. Anda dapat memeriksa status pembuatan pusat aktivitas di pemberitahuan. Setelah pusat aktivitas dibuat, Anda akan melihatnya di daftar pusat aktivitas.

    Cuplikan layar memperlihatkan daftar hub peristiwa.

Memberi namespace Layanan Event Grid akses untuk mengirim peristiwa ke pusat aktivitas

  1. Pada halaman Namespace Layanan Pusat Aktivitas, pilih Kontrol akses (IAM) di menu sebelah kiri.

  2. Pada halaman Kontrol akses, pilih + Tambahkan pada bilah perintah, lalu pilih Tambahkan penetapan peran.

    Cuplikan layar yang memperlihatkan halaman Kontrol akses untuk namespace Layanan Pusat Aktivitas.

  3. Pada halaman Tambahkan penetapan peran, pilih Pengirim Data Azure Event Hubs dari daftar peran, lalu pilih Berikutnya di bagian bawah halaman.

    Cuplikan layar yang memperlihatkan halaman Tambahkan penetapan peran dengan Pengirim Data Azure Event Hubs dipilih.

  4. Pada halaman Anggota , ikuti langkah-langkah berikut:

    1. Untuk bidang Tetapkan akses ke, pilih Identitas terkelola.

    2. Pilih + Pilih anggota.

      Cuplikan layar yang memperlihatkan halaman Tambahkan penetapan peran dengan Identitas terkelola dipilih.

  5. Pada halaman Pilih identitas terkelola , ikuti langkah-langkah berikut:

    1. Pilih langganan Azure Anda.

    2. Untuk Identitas terkelola, pilih Namespace Layanan Event Grid.

    3. Pilih identitas terkelola yang memiliki nama yang sama dengan namespace Layanan Event Grid.

    4. Pilih Pilih di bagian bawah halaman.

      Cuplikan layar yang memperlihatkan halaman Pilih identitas terkelola dengan identitas terkelola namespace layanan Event Grid dipilih.

  6. Pada halaman Tambahkan penetapan peran, pilih Tinjau + tetapkan di bagian bawah halaman.

  7. Pada halaman Tinjau + tetapkan , pilih Tinjau + tetapkan.

Membuat langganan peristiwa dengan Azure Event Hubs sebagai titik akhir

  1. Beralih ke tab jendela browser Web Anda yang membuka namespace Layanan Event Grid.

  2. Pada halaman Namespace Layanan Event Grid, pilih Topik di menu sebelah kiri.

  3. Pada halaman Topik , pilih topik namespace yang Anda buat sebelumnya.

    Cuplikan layar yang memperlihatkan halaman Topik dengan topik namespace dipilih.

  4. Pada halaman Topik Namespace Event Grid, pilih + Langganan pada bilah perintah di bagian atas.

    Cuplikan layar yang memperlihatkan halaman Langganan.

  5. Pada halaman Buat Langganan , ikuti langkah-langkah berikut:

    1. Masukkan nama untuk langganan acara.

    2. Untuk Mode pengiriman, pilih Dorong.

    3. Konfirmasikan bahwa Jenis titik akhir diatur ke Hub peristiwa.

    4. Pilih Konfigurasikan titik akhir.

      Cuplikan layar yang memperlihatkan halaman Buat Langganan.

    5. Pada Pilih Pusat Aktivitas, ikuti langkah-langkah berikut:

      1. Pilih langganan Azure yang memiliki hub peristiwa.

      2. Pilih grup sumber daya yang memiliki hub peristiwa.

      3. Pilih namespace layanan Azure Event Hubs.

      4. Pilih hub peristiwa di namespace layanan Azure Event Hubs.

      5. Lalu, pilih Konfirmasi pilihan.

        Cuplikan layar yang memperlihatkan halaman Pilih hub peristiwa.

    6. Kembali ke halaman Buat Langganan, pilih Sistem Ditetapkan untuk Jenis identitas terkelola.

    7. Pilih Buat di bagian bawah halaman.

      Cuplikan layar yang memperlihatkan halaman Buat Langganan dengan tombol Buat dipilih.

Mengonfigurasi perutean di namespace Layanan Event Grid

  1. Navigasi kembali ke halaman Namespace Layanan Event Grid dengan memilih namespace layanan di bagian Penting dari halaman Topik Namespace Layanan Event Grid atau dengan memilih nama namespace layanan di menu remah roti di bagian atas.

  2. Pada halaman Namespace Layanan Event Grid, pilih Perutean di menu sebelah kiri di bagian broker MQTT.

  3. Pada halaman Perutean , pilih Aktifkan perutean.

  4. Untuk Jenis topik, pilih topik Namespace.

  5. Untuk Topik, pilih topik namespace Layanan Event Grid yang Anda buat di mana semua pesan MQTT akan dirutekan.

  6. Pilih Terapkan.

    Cuplikan layar yang memperlihatkan halaman Perutean dengan topik namespace dipilih.

    Periksa pemberitahuan untuk mengonfirmasi bahwa namespace diaktifkan dengan informasi perutean.

Membuat klien, ruang topik, dan pengikatan izin

Ikuti langkah-langkah dalam mulai cepat: Menerbitkan dan berlangganan topik MQTT untuk:

  1. Buat klien. Anda dapat membuat klien kedua jika mau, tetapi bersifat opsional.

  2. Membuat ruang topik.

  3. Membuat pengikatan izin penerbit dan pelanggan.

  4. Gunakan MQTTX untuk mengirim beberapa pesan.

  5. Verifikasi bahwa pusat aktivitas menerima pesan tersebut di halaman Gambaran Umum untuk namespace Layanan Pusat Aktivitas Anda.

    Cuplikan layar yang memperlihatkan halaman Gambaran Umum hub peristiwa dengan jumlah pesan masuk.

Menampilkan pesan MQTT yang dirutekan di Azure Event Hubs dengan menggunakan kueri Azure Stream Analytics

Navigasikan ke instans Azure Event Hubs (pusat aktivitas) dalam langganan peristiwa Anda di portal Azure. Memproses data dari hub peristiwa Anda dengan menggunakan Azure Stream Analytics. Untuk informasi selengkapnya, lihat Memproses data dari Azure Event Hubs menggunakan Azure Stream Analytics - Azure Event Hubs | Microsoft Learn. Anda dapat melihat pesan MQTT dalam kueri.

Cuplikan layar yang memperlihatkan data pesan MQTT di Azure Event Hubs dengan menggunakan alat kueri Azure Stream Analytics.

Langkah berikutnya

Untuk sampel kode, buka repositori GitHub ini.