Tutorial: Bagian 2 - Lihat pesan yang dirutekan

Perutean pesan mengaktifkan pengiriman data telemetri dari perangkat IoT Anda ke titik akhir yang kompatibel dengan Hub Kejadian bawaan atau titik akhir kustom seperti penyimpanan blob, Antrean Bus Layanan, Topik Bus Layanan, dan Hub Acara. Untuk mengonfigurasi perutean pesan kustom, Anda membuat kueri perutean untuk mengustomisasi rute yang cocok dengan kondisi tertentu. Setelah disiapkan, data masuk secara otomatis dirutekan ke titik akhir oleh Hub IoT. Jika pesan tidak cocok dengan kueri perutean yang ditentukan, pesan dirutekan ke titik akhir default.

Dalam tutorial 2 bagian ini, Anda belajar cara mengatur dan menggunakan kueri perutean kustom ini dengan IoT Hub. Anda merutekan pesan dari perangkat IoT ke salah satu dari beberapa titik akhir, termasuk penyimpanan blob dan antrean Bus Layanan. Pesan ke antrean Bus Layanan diambil oleh Log App dan dikirim melalui email. Pesan yang tidak memiliki perutean pesan kustom yang ditentukan dikirim ke titik akhir default, lalu diambil oleh Azure Stream Analytics dan ditampilkan dalam visualisasi Power BI.

Untuk menyelesaikan Bagian 1 dan 2 tutorial ini, Anda melakukan tugas-tugas berikut:

Bagian I: Membuat sumber daya, menyiapkan perutean pesan

  • Buat sumber daya - hub IoT, akun penyimpanan, antrian Bus Layanan, dan perangkat simulasi. Ini dapat dilakukan menggunakan portal Microsoft Azure, template Azure Resource Manager, Azure CLI, atau Azure PowerShell.
  • Konfigurasikan titik akhir dan rute pesan di Azure IoT Hub untuk akun penyimpanan dan antrean Bus Layanan.

Bagian II: Mengirim pesan ke hub, melihat hasil yang dirutekan

  • Buat Aplikasi Logika yang dipicu dan mengirim email saat sebuah pesan ditambahkan ke antrean Bus Layanan.
  • Unduh dan jalankan aplikasi yang menyimulasikan Perangkat IoT yang mengirim pesan ke hub untuk berbagai opsi perutean.
  • Buat visualisasi Power BI untuk data yang dikirim ke titik akhir default.
  • Lihat hasilnya ...
  • ... di antrean Bus Layanan dan email.
  • ... di Akun penyimpanan.
  • ... di visualisasi Power BI.

Prasyarat

  • Untuk Bagian 1 tutorial ini:

    • Anda harus memiliki langganan Azure yang aktif. Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum Anda memulai.
  • Untuk Bagian 2 tutorial ini:

    • Anda harus menyelesaikan Bagian 1 tutorial ini, dan memiliki sumber daya yang masih tersedia.
    • Instal Visual Studio.
    • Memiliki akses ke akun Power BI untuk menganalisis analitik aliran titik akhir default. (Coba Power BI secara gratis.)
    • Memiliki akun kerja atau sekolah untuk mengirim email pemberitahuan.
    • 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. Untuk mengetahui informasi selengkapnya dan cara mengatasi masalah ini, lihat Menghubungkan ke IoT Hub (MQTT).

Menggunakan Azure Cloud Shell

Azure meng-hosting Azure Cloud Shell, lingkungan shell interaktif yang dapat Anda gunakan melalui browser. Anda dapat menggunakan Bash atau PowerShell dengan Cloud Shell untuk bekerja dengan layanan Azure. Anda dapat menggunakan perintah Cloud Shell yang telah diinstal sebelumnya untuk menjalankan kode dalam artikel ini tanpa harus menginstal apa pun di lingkungan lokal Anda.

Untuk memulai Azure Cloud Shell:

Opsi Contoh/Tautan
Pilih Coba di sudut kanan atas blok kode. Memilih Coba tidak secara otomatis menyalin kode ke Cloud Shell. Contoh Coba untuk Azure Cloud Shell
Buka https://shell.azure.com, atau pilih tombol Luncurkan Cloud Shell untuk membuka Cloud Shell di browser Anda. Luncurkan Cloud Shell di jendela baru
Pilih tombol Cloud Shell pada bilah menu di kanan atas di portal Microsoft Azure. Tombol Cloud Shell di portal Microsoft Azure

Untuk menjalankan kode dalam artikel ini di Azure Cloud Shell:

  1. Mulai Cloud Shell.

  2. Pilih tombol Salin pada blok kode untuk menyalin kode.

  3. Tempelkan kode ke sesi Cloud Shell dengan memilih Ctrl+Shift+V di Windows dan Linux atau dengan memilih Cmd+Shift+V di macOS.

  4. Pilih Enter untuk menjalankan kode.

Catatan

Artikel ini telah diperbarui dan menggunakan modul Azure Az PowerShell. Modul Az PowerShell adalah modul PowerShell yang disarankan untuk berinteraksi dengan Azure. Untuk mulai menggunakan modul Az PowerShell, lihat Menginstal Azure PowerShell. Untuk mempelajari cara bermigrasi ke modul Az PowerShell, lihat Memigrasikan Azure PowerShell dari AzureRM ke Az.

Aturan untuk perutean pesan

Ini adalah aturan untuk perutean pesan; ini disiapkan di Bagian 1 dari tutorial ini, dan Anda melihat mereka bekerja di bagian kedua ini.

Nilai Hasil
level="storage" Tulis ke Azure Storage.
level="critical" Tulis antrean Bus Layanan. Aplikasi Logika mengambil pesan dari antrean dan menggunakan Office 365 untuk mengirim pesan melalui email.
default Tampilkan data ini menggunakan Power BI.

Sekarang Anda membuat sumber daya tempat pesan akan dirutekan, menjalankan aplikasi untuk mengirim pesan ke hub, dan melihat perutean bekerja.

Buat Aplikasi Logika

Antrean Bus Layanan akan digunakan untuk menerima pesan yang ditetapkan sebagai penting. Siapkan aplikasi Logika untuk memantau antrean Bus Layanan, dan kirim email saat pesan ditambahkan ke antrean.

  1. Di portal Microsoft Azure, pilih Buat sumber daya. Letakkan aplikasi logika di kotak pencarian dan klik Enter. Dari hasil pencarian yang ditampilkan, pilih Aplikasi Logika, lalu pilih Buat untuk lanjut ke panel Aplikasi logika. Isi bidang.

    Nama: Bidang ini adalah nama aplikasi logika. Tutorial ini menggunakan ContosoLogicApp.

    Langganan: Pilih langganan Azure Anda.

    Grup Sumber Daya: Pilih Gunakan yang sudah ada dan pilih grup sumber daya Anda. Tutorial ini menggunakan ContosoResources.

    Lokasi: Gunakan lokasi Anda. Tutorial ini menggunakan US Barat.

    Aktifkan Analitik Log: Pengalih ini harus dinonaktifkan.

    Layar Buat Aplikasi Logika

    Pilih Buat. Mungkin perlu beberapa menit untuk menyebarkan komputer virtual.

  2. Sekarang buka Aplikasi Logika. Cara termudah untuk mengakses Aplikasi Logika adalah memilih Grup sumber daya, pilih grup sumber daya Anda (tutorial ini menggunakan ContosoResources), lalu pilih Aplikasi Logika dari daftar sumber daya.

    Halaman Perancang Aplikasi Logika muncul (Anda mungkin harus menggulir ke kanan untuk melihat halaman lengkap). Pada halaman Perancang Aplikasi Logika, gulir ke bawah hingga Anda melihat petak yang bertuliskan Aplikasi Logika Kosong + dan pilih itu. Tab default adalah "Untuk Anda". Jika panel ini kosong, pilih Semua untuk melihat semua konektor dan pemicu yang tersedia.

  3. Pilih Bus Layanan dari daftar konektor.

    Daftar konektor

  4. Daftar pemicu ditampilkan. Pilih Ketika pesan diterima di antrean (selesai otomatis) / Bus Layanan.

    Daftar pemicu Untuk Bus Layanan

  5. Pada layar berikutnya, isi Nama Koneksi. Tutorial ini menggunakan ContosoConnection.

    Menyetel sambungan untuk antrean Bus Layanan

    Pilih namespace Bus Layanan. Tutorial ini menggunakan ContosoSBNamespace. Saat Anda memilih namespace, portal akan meminta namespace Bus Layanan untuk mengambil kunci. Pilih RootManageSharedAccessKey, lalu pilih Buat.

    Menyelesaikan penyiapan koneksi

  6. Pada layar berikutnya, pilih nama antrian (tutorial ini menggunakan contososbqueue) dari daftar menurun. Anda bisa menggunakan default untuk bidang lainnya.

    Opsi antrean

  7. Sekarang siapkan tindakan untuk mengirim email ketika pesan diterima dalam antrean. Di Perancang Aplikasi Logika, pilih + Langkah baru untuk menambahkan langkah, lalu pilih Semua untuk melihat semua opsi yang tersedia. Di panel Pilih tindakan, temukan dan pilih Office 365 Outlook. Pada layar Tindakan, pilih Kirim email / Office 365 Outlook.

    Opsi Office365

  8. Masuk ke akun kantor atau sekolah Anda untuk menyiapkan koneksi. Jika waktu habis, coba lagi. Tentukan alamat email untuk penerima email. Serta tentukan subjek, dan ketik pesan apa yang Anda inginkan untuk dilihat penerima. Untuk pengujian, isi alamat email Anda sendiri sebagai penerima.

    Pilih Tambahkan konten dinamis untuk memperlihatkan konten dari pesan yang bisa Anda sertakan. Pilih Konten -- itu akan menyertakan pesan dalam email.

    Opsi email untuk aplikasi logika

  9. Pilih Simpan. Kemudian tutup Perancang Logic App.

Menyiapkan Azure Stream Analytics

Untuk melihat data dalam visualisasi Power BI, pertama siapkan tugas Analisis Aliran untuk mengambil data. Ingat bahwa hanya pesan di mana level berupa normal dikirim ke titik akhir default, dan akan diambil oleh tugas Analisis Aliran untuk visualisasi Power BI.

Membuat tugas Analisis Aliran

  1. Di portal Microsoft Azure, pilih Buat Sumber Daya > Internet of Things > tugas Analisis Aliran.

  2. Masukkan informasi berikut untuk pekerjaan tersebut.

    Nama pekerjaan: Nama pekerjaan. Nama harus unik secara global. Tutorial ini menggunakan contosoJob.

    Langganan: Langganan Azure yang Anda gunakan untuk tutorial.

    Grup sumber daya: Gunakan grup sumber daya yang sama dengan yang digunakan oleh hub IoT Anda. Tutorial ini menggunakan ContosoResources.

    Lokasi: Gunakan lokasi sama dengan yang digunakan dalam skrip. Tutorial ini menggunakan US Barat.

    Membuat tugas Analisis Aliran

  3. Pilih Buat untuk membuat pekerjaan. Ini akan memakan beberapa menit untuk penyebaran.

    Untuk kembali ke pekerjaan, pilih Grup sumber daya. Tutorial ini menggunakan ContosoResources. Pilih grup sumber daya, lalu pilih pekerjaan Analisis Aliran di daftar sumber daya.

Menambahkan input ke pekerjaan Analisis Aliran

  1. Di bawah Topologi Pekerjaan, pilih Input.

  2. Di panel Input, pilih Tambahkan input streaming dan pilih IoT Hub. Pada layar yang muncul, isi bidang berikut:

    Alias input: Tutorial ini menggunakan contosoinputs.

    Pilih IoT Hub dari langganan Anda: Pilih opsi tombol radio ini.

    Langganan: Pilih langganan Azure yang Anda gunakan untuk tutorial ini.

    IoT Hub: Pilih hub IoT. Tutorial ini menggunakan ContosoTestHub.

    Titik akhir: Pilih Pesan. (Jika Anda memilih Pemantauan Operasi, Anda mendapatkan data telemetri tentang hub IoT ketimbang data yang Anda kirim.)

    Nama kebijakan akses bersama: Pilih layanan. Portal mengisi Kunci Kebijakan Akses Bersama untuk Anda.

    Grup konsumen: Pilih grup konsumen yang disiapkan di Bagian 1 tutorial ini. Tutorial ini menggunakan contosoconsumers.

    Untuk sisa bidang, biarkan default.

    Menyiapkan input untuk pekerjaan analitik aliran

  3. Pilih Simpan.

Menambahkan output ke pekerjaan Azure Stream Analytics

  1. Di bawah Topologi Pekerjaan, pilih Output.

  2. Di panel Output, pilih Tambahkan, lalu pilih Power BI. Pada layar yang muncul, isi bidang berikut:

    Alias Output: Bidang ini adalah alias unik untuk output. Tutorial ini menggunakan contosooutputs.

    Nama himpunan data: Nama himpunan data yang akan digunakan di Power BI. Tutorial ini menggunakan contosodataset.

    Nama tabel: Nama tabel yang digunakan dalam Power BI. Tutorial ini menggunakan contosotable.

Mode autentikasi: Pilih mode yang akan digunakan.

Menerima default untuk bidang lainnya.

  1. Pilih Otorisasi, dan masuk ke akun Power BI Anda. (Ini mungkin membutuhkan lebih dari satu percobaan).

    Menyiapkan output untuk pekerjaan analitik aliran

  2. Pilih Simpan.

Mengonfigurasi kueri tugas Analisis Aliran

  1. Di bawah Topologi Pekerjaan, pilih Kueri.

  2. Ganti [YourInputAlias] dengan alias input pekerjaan. Tutorial ini menggunakan contosoinputs.

  3. Ganti [YourOutputAlias] dengan alias output pekerjaan. Tutorial ini menggunakan contosooutputs.

    Menyiapkan kueri untuk pekerjaan analitik aliran

  4. Pilih Simpan.

  5. Tutup panel Kueri. Anda kembali ke tampilan sumber daya dalam Grup Sumber Daya. Pilih pekerjaan Analisis Aliran. Tutorial ini menyebutnya contosoJob.

Menjalankan pekerjaan Analisis Aliran

Di pekerjaan Analisis Aliran, pilih Mulai > Sekarang > Mulai. Setelah pekerjaan berhasil dimulai, status pekerjaan berubah dari Berhenti ke Berjalan.

Untuk menyiapkan laporan Power BI, Anda memerlukan data, sehingga Anda akan menyiapkan Power BI setelah membuat perangkat dan menjalankan aplikasi simulasi perangkat.

Jalankan aplikasi perangkat simulasi

Di Bagian 1 tutorial ini, Anda menyiapkan perangkat untuk menyimulasikan menggunakan perangkat IoT. Di bagian ini, Anda mengunduh aplikasi konsol .NET yang menyimulasikan perangkat yang mengirim pesan perangkat ke cloud ke hub IoT (dengan asumsi Anda belum mengunduh aplikasi dan sumber daya di Bagian 1).

Aplikasi ini mengirim pesan untuk setiap ragam metode perutean pesan. Juga terdapat folder dalam unduhan yang berisi file templat dan parameter lengkap Azure Resource Manager, serta skrip Azure CLI dan PowerShell.

Jika Anda tidak mengunduh file dari repositori di Bagian 1 tutorial ini, unduh sekarang dari Simulasi Perangkat IoT. Memilih tautan ini mengunduh repositori dengan beberapa aplikasi di dalamnya; solusi yang Anda cari adalah iot-hub /Tutorials/Routing/IoT_SimulatedDevice.sln.

Klik dua kali file solusi (IoT_SimulatedDevice.sln) untuk membuka kode di Visual Studio, lalu buka Program.cs. Ganti {your hub name} dengan nama host hub IoT. Format nama host hub IoT adalah {nama hub Anda}.azure-devices.net. Untuk tutorial ini, nama host hub adalah ContosoTestHub.azure-devices.net. Selanjutnya, ganti {your device key} dengan kunci perangkat yang Anda simpan sebelumnya saat mengatur perangkat simulasi.

     static string s_myDeviceId = "Contoso-Test-Device";
     static string s_iotHubUri = "ContosoTestHub.azure-devices.net";
     // This is the primary key for the device. This is in the portal. 
     // Find your IoT hub in the portal > IoT devices > select your device > copy the key. 
     static string s_deviceKey = "{your device key}";

Jalankan dan uji

Jalankan aplikasi konsol. Tunggu beberapa menit. Anda dapat melihat pesan yang dikirim di layar konsol aplikasi.

Aplikasi ini mengirim pesan perangkat-ke-cloud baru ke hub IoT setiap detik. Pesan berisi objek berseri JSON dengan ID, suhu, kelembaban, dan tingkat pesan perangkat, yang default ke normal. Hal ini menetapkan tingkat critical atau storage secara acak, menyebabkan pesan dirutekan ke akun penyimpanan atau ke antrian Bus Layanan (yang memicu Aplikasi Logika Anda untuk mengirim email). Pembacaan default (normal) akan ditampilkan dalam laporan BI yang Anda siapkan berikutnya.

Jika semuanya disiapkan dengan benar, Anda akan melihat hasil berikut:

  1. Anda mulai mendapatkan email tentang pesan kritis.

    Email yang dihasilkan

    Hasil ini berarti pernyataan berikut adalah benar.

    • Perutean ke antrean Bus Layanan bekerja dengan benar.
    • Aplikasi Logika mengambil pesan dari antrean Bus Layanan berfungsi dengan benar.
    • Konektor Aplikasi Logika ke Outlook berfungsi dengan benar.
  2. Di portal Microsoft Azure, pilih Grup sumber daya dan pilih Grup Sumber Daya Anda. Tutorial ini menggunakan ContosoResources.

    Pilih akun penyimpanan, pilih Kontainer lalu pilih Kontainer. Tutorial ini menggunakan contosoresults. Anda akan melihat folder, dan Anda bisa menelusuri direktori dengan detail hingga Anda melihat satu atau beberapa file. Buka salah satu file tersebut; mereka berisi entri yang dirutekan ke akun penyimpanan.

    File hasil dalam penyimpanan

Hasil ini berarti pernyataan berikut adalah benar.

  • Perutean ke akun penyimpanan berfungsi dengan benar.

Sekarang, dengan aplikasi masih berjalan, siapkan visualisasi Power BI untuk melihat pesan yang masuk melalui perutean default.

Menyiapkan visualisasi Power BI

  1. Masuk ke akun Power BI Anda.

  2. Buka Ruang kerja dan pilih ruang kerja yang Anda tetapkan saat Anda membuat output untuk pekerjaan Analisis Aliran. Tutorial ini menggunakan Ruang Kerja Saya.

  3. Pilih Himpunan data. Jika Anda tidak memiliki himpunan data, tunggu beberapa menit dan periksa lagi.

    Anda akan melihat himpunan data yang Anda tentukan saat membuat output untuk pekerjaan Analisis Aliran. Tutorial ini menggunakan contosodataset. (Mungkin perlu waktu 5-10 menit agar himpunan data muncul untuk pertama kalinya.)

  4. Di bawah TINDAKAN, pilih ikon pertama untuk membuat laporan.

    Ruang kerja Power BI dengan ikon Tindakan dan laporan disorot

  5. Buat diagram garis untuk memperlihatkan suhu real-time seiring waktu.

    • Pada halaman pembuatan laporan, tambahkan diagram garis dengan memilih ikon diagram garis.

      Visualisasi dan bidang

    • Pada panel Bidang, perluas tabel yang Anda tentukan saat membuat output untuk tugas Analisis Aliran. Tutorial ini menggunakan contosotable.

    • Seret EventEnqueuedUtcTime ke Sumbu pada panel Visualisasi.

    • Seret suhu ke Nilai.

    Diagram garis jadi. Sumbu-x menampilkan tanggal dan waktu di zona waktu UTC. Sumbu-y menampilkan suhu dari sensor.

  6. Buat diagram garis lain untuk memperlihatkan kelembaban real-time seiring waktu. Untuk menyiapkan bagan kedua, ikuti proses yang sama untuk bagan pertama, tempatkan EventEnqueuedUtcTime pada sumbu-x (Sumbu) dan kelembaban pada sumbu-y (Nilai).

    Laporan Akhir Power BI dengan dua bagan

  7. Pilih Simpan untuk menyimpan laporan, memasukkan nama untuk laporan jika diminta.

Anda akan dapat melihat data di kedua bagan. Hasil ini berarti pernyataan berikut adalah benar:

  • Perutean ke titik akhir default berfungsi dengan benar.
  • Pekerjaan Azure Stream Analytics sedang streaming dengan benar.
  • Visualisasi Power BI disiapkan dengan benar.

Anda bisa menyegarkan bagan untuk melihat data terbaru dengan memilih tombol Refresh di bagian atas jendela Power BI.

Membersihkan sumber daya

Jika Anda ingin menghapus semua sumber daya Azure yang telah Anda buat melalui kedua bagian tutorial ini, hapus grup sumber daya. Tindakan ini juga menghapus semua sumber daya yang terkandung dalam grup. Dalam hal ini, tindakan ini menghapus hub IoT, namespace dan antrian Bus Layanan, Aplikasi Logika, akun penyimpanan, serta grup sumber daya itu sendiri. Anda juga bisa menghapus sumber daya Power BI dan menghapus email yang dikirim selama tutorial.

Membersihkan sumber daya dalam visualisasi Power BI

Masuk ke akun Power BI Anda. Buka ruang kerja Anda. Tutorial ini menggunakan Ruang Kerja Saya. Untuk menghapus visualisasi Power BI, masuk ke DataSets dan pilih ikon tempat sampah untuk menghapus himpunan data. Tutorial ini menggunakan contosodataset. Saat Anda menghapus himpunan data, laporan juga dihapus.

Menggunakan Azure CLI untuk membersihkan sumber daya

Untuk menghapus grup sumber daya, gunakan perintah az group delete. $resourceGroup diatur ke ContosoResources pada awal tutorial ini.

az group delete --name $resourceGroup

Gunakan PowerShell untuk membersihkan sumber daya

Untuk menghapus grup sumber daya, gunakan perintah Remove-AzResourceGroup. $resourceGroup diatur ke ContosoResources pada awal tutorial ini.

Remove-AzResourceGroup -Name $resourceGroup

Membersihkan email pengujian

Anda mungkin juga ingin menghapus jumlah email di kotak masuk Anda yang dihasilkan melalui Aplikasi Logika saat aplikasi perangkat sedang berjalan.

Langkah berikutnya

Dalam tutorial 2 bagian ini, Anda belajar cara menggunakan perutean pesan untuk merutekan pesan Azure IoT Hub ke tujuan yang berbeda dengan melakukan tugas-tugas berikut.

Bagian I: Membuat sumber daya, menyiapkan perutean pesan

  • Buat sumber daya - hub IoT, akun penyimpanan, antrian Bus Layanan, dan perangkat simulasi.
  • Konfigurasikan titik akhir dan rute pesan di Azure IoT Hub untuk akun penyimpanan dan antrean Bus Layanan.

Bagian II: Mengirim pesan ke hub, melihat hasil yang dirutekan

  • Buat Aplikasi Logika yang dipicu dan mengirim email saat sebuah pesan ditambahkan ke antrean Bus Layanan.
  • Unduh dan jalankan aplikasi yang menyimulasikan Perangkat IoT yang mengirim pesan ke hub untuk berbagai opsi perutean.
  • Buat visualisasi Power BI untuk data yang dikirim ke titik akhir default.
  • Lihat hasilnya ...
  • ... di antrean Bus Layanan dan email.
  • ... di Akun penyimpanan.
  • ... di visualisasi Power BI.

Lanjut ke tutorial berikutnya untuk mempelajari cara mengelola status perangkat IoT.