Tutorial: Mengirim data perangkat ke Azure Storage menggunakan perutean pesan IoT Hub

Gunakan perutean pesan di Azure IoT Hub untuk mengirim data telemetri dari perangkat IoT Anda ke layanan Azure seperti penyimpanan blob, Antrean Bus Layanan, Topik Bus Layanan, dan Pusat Aktivitas. Setiap IoT hub memiliki titik akhir bawaan default yang kompatibel dengan Azure Event Hubs. Anda juga dapat membuat titik akhir kustom dan merutekan pesan ke layanan Azure lainnya dengan menentukan kueri perutean. Setiap pesan yang tiba di IoT hub dirutekan ke semua titik akhir yang kueri peruteannya cocok. Jika pesan tidak cocok dengan kueri perutean yang ditentukan, pesan dirutekan ke titik akhir default.

Dalam tutorial ini, Anda melakukan tugas berikut:

• Buat IoT hub dan kirim pesan perangkat ke dalamnya.
• Membuat akun penyimpanan.
• Buat titik akhir kustom untuk akun penyimpanan dan rutekan pesan ke dalamnya dari IoT hub.
• Lihat pesan perangkat di blob akun penyimpanan.

Prasyarat

• Langganan Azure. Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum Anda memulai.

• IoT Hub di langganan Azure Anda. Jika belum memiliki hub, Anda dapat mengikuti langkah-langkah di Membuat IoT hub.

• Tutorial ini menggunakan kode sampel dari Azure IoT SDK untuk C#.

  • Unduh atau kloning repositori SDK ke komputer pengembangan Anda.
  • Memiliki .NET Core SDK 3.0.0 atau yang lebih baru di mesin pengembangan Anda. Periksa versi Anda dengan menjalankan dotnet --version dan Unduh .NET jika perlu.

• Pastikan port 8883 terbuka di firewall Anda. Sampel dalam tutorial ini menggunakan protokol MQTT, yang berkomunikasi melalui port 8883. Port ini dapat diblokir di beberapa lingkungan jaringan perusahaan dan pendidikan. Untuk informasi selengkapnya dan cara mengatasi masalah ini, lihat Menyambungkan ke Azure IoT Hub (MQTT).

• Secara opsional, instal Azure IoT Explorer. Alat ini membantu Anda mengamati pesan saat tiba di IoT hub Anda. Artikel ini menggunakan Azure IoT Explorer.

Portal Azure

Tidak ada prasyarat lain untuk portal Azure.

Azure CLI

• Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai Cepat untuk Bash di Azure Cloud Shell.

  

• Jika Anda lebih suka menjalankan perintah referensi CLI secara lokal, instal Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.

  • Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah login az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Masuk dengan Azure CLI.

  • Saat Anda diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan ekstensi dengan Azure CLI.

  • Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk meningkatkan ke versi terbaru, jalankan peningkatan az.

Mendaftarkan perangkat dan mengirim pesan ke IoT Hub

Daftarkan perangkat baru di IoT hub Anda.

Portal Azure

1. Masuk ke portal Azure dan navigasikan ke IoT hub Anda.

2. Pilih Perangkat dari bagian Manajemen perangkat pada menu.

3. Pilih Tambahkan perangkat.

   

4. Berikan ID perangkat dan pilih Simpan.

5. Perangkat baru seharusnya ada dalam daftar perangkat sekarang. Jika tidak, refresh halaman. Pilih ID perangkat untuk membuka halaman detail perangkat.

6. Salin salah satu kunci perangkat dan simpan. Anda akan menggunakan nilai ini untuk mengonfigurasi kode sampel yang menghasilkan pesan telemetri perangkat yang disimulasikan.

   

Azure CLI

Tip

Banyak perintah CLI yang digunakan di seluruh tutorial ini menggunakan parameter yang sama. Untuk kenyamanan Anda, kami telah menentukan variabel lokal yang dapat dipanggil sesuai kebutuhan. Pastikan untuk menjalankan semua perintah dalam sesi yang sama, atau Anda harus menentukan ulang variabel.

1. Tentukan variabel untuk hub dan perangkat IoT Anda.

   IOTHUB_NAME: Ganti tempat penampung ini dengan nama IoT hub Anda.

   DEVICE_NAME: Ganti tempat penampung ini dengan nama apa pun yang ingin Anda gunakan untuk perangkat dalam tutorial ini.

   hubName=IOTHUB_NAME
   deviceName=DEVICE_NAME
   

2. Jalankan perintah az iot hub device-identity create di shell CLI Anda. Perintah ini akan membuat identitas perangkat.

   az iot hub device-identity create --device-id $deviceName --hub-name $hubName
   

3. Dari output identitas perangkat, salin nilai primaryKey tanpa tanda kutip di sekitarnya dan simpan. Anda akan menggunakan nilai ini untuk mengonfigurasi kode sampel yang menghasilkan pesan telemetri perangkat yang disimulasikan.

Sekarang setelah Anda memiliki ID dan kunci perangkat, gunakan kode sampel untuk mulai mengirim pesan telemetri perangkat ke IoT Hub.

Tip

Jika Anda mengikuti langkah-langkah Azure CLI untuk tutorial ini, jalankan kode sampel dalam sesi terpisah. Dengan demikian, Anda dapat mengizinkan kode sampel untuk terus berjalan saat Anda mengikuti langkah-langkah CLI lainnya.

1. Jika Anda tidak sebagai bagian dari prasyarat, unduh atau kloning azure IoT SDK untuk repo C# dari GitHub sekarang.

2. Dari folder tempat Anda mengunduh atau mengkloning SDK, navigasikan ke azure-iot-sdk-csharp\iothub\device\samples\how to guides\HubRoutingSample folder .

3. Instal Azure IoT C# SDK dan dependensi yang diperlukan seperti yang ditentukan dalam file HubRoutingSample.csproj:

   dotnet restore
   

4. Di editor pilihan Anda, buka file Parameters.cs. File ini menampilkan parameter yang didukung oleh sampel. Hanya parameter yang PrimaryConnectionString akan digunakan dalam artikel ini saat menjalankan sampel. Tinjau kode dalam file ini. Tidak diperlukan perubahan.

5. Buat dan jalankan kode sampel menggunakan perintah berikut:

   Ganti <myDevicePrimaryConnectionString> dengan string koneksi utama dari perangkat Anda di hub IoT Anda.

   dotnet run --PrimaryConnectionString <myDevicePrimaryConnectionString>
   

6. Anda akan mulai melihat pesan yang dicetak ke output saat dikirim ke IoT Hub. Biarkan program ini berjalan selama tutorial.

Mengonfigurasi IoT Explorer untuk melihat pesan

Konfigurasikan IoT Explorer untuk menyambungkan ke IoT hub Anda dan membaca pesan saat tiba di titik akhir bawaan.

Pertama, ambil string koneksi untuk IoT hub Anda.

Portal Azure

1. Di portal Azure, navigasi ke hub IoT Anda.

2. Pilih Kebijakan akses bersama dari bagian Pengaturan keamanan pada menu.

3. Pilih kebijakan iothubowner.

   

4. Salin String koneksi utama.

   

Azure CLI

1. Jalankan perintah az iot hub connection-string show:

   az iot hub connection-string show --hub-name $hubName
   

2. Salin string koneksi tanpa tanda petik di sekitarnya.

Sekarang, gunakan string koneksi tersebut untuk mengonfigurasi IoT Explorer untuk IoT hub Anda.

1. Buka IoT Explorer di mesin pengembangan Anda.

2. Pilih Tambahkan koneksi.

   

3. Tempelkan string koneksi hub Anda ke dalam kotak teks.

4. Pilih Simpan.

5. Setelah tersambung ke IoT hub, Anda akan melihat daftar perangkat. Pilih ID perangkat yang Anda buat untuk tutorial ini.

6. Pilih Telemetri.

7. Dengan perangkat Anda masih berjalan, pilih Mulai. Jika perangkat Anda tidak berjalan, Anda tidak akan melihat telemetri.

   

8. Anda akan melihat pesan yang tiba dari perangkat Anda, dengan yang terbaru ditampilkan di bagian atas.

   

   Tonton pesan masuk selama beberapa saat untuk memverifikasi bahwa Anda melihat tiga jenis pesan yang berbeda: normal, penyimpanan, dan penting. Setelah melihat ini, Anda dapat menghentikan perangkat Anda.

Semua pesan ini tiba di titik akhir bawaan default untuk IoT hub Anda. Di bagian berikutnya, kita akan membuat titik akhir kustom dan merutekan beberapa pesan ini ke penyimpanan berdasarkan properti pesan. Pesan tersebut akan berhenti muncul di IoT Explorer karena pesan hanya masuk ke titik akhir bawaan saat tidak cocok dengan rute lain di IoT hub.

Menyiapkan perutean pesan

Anda akan merutekan pesan ke sumber daya yang berbeda berdasarkan properti yang dilampirkan ke pesan oleh simulasi perangkat. Pesan yang tidak dirutekan secara kustom dikirim ke titik akhir default (pesan/kejadian).

Aplikasi sampel untuk tutorial ini menetapkan properti tingkat untuk setiap pesan yang dikirimnya ke IoT hub. Setiap pesan secara acak ditetapkan ke tingkat normal, penyimpanan, atau penting.

Langkah pertama adalah menyiapkan titik akhir tempat data akan dirutekan. Langkah kedua adalah menyiapkan rute pesan yang menggunakan titik akhir tersebut. Setelah menyiapkan perutean, Anda dapat melihat titik akhir dan rute pesan di portal.

Buat akun penyimpanan

Buat akun Azure Storage dan kontainer dalam akun tersebut, yang akan menyimpan pesan perangkat yang dirutekan ke akun tersebut.

Portal Azure

1. Buka portal Azure, dan cari Akun penyimpanan.

2. Pilih Buat.

3. Berikan nilai berikut untuk akun penyimpanan Anda:

   Parameter	Nilai
   Langganan	Pilih langganan yang sama yang berisi IoT hub Anda.
   Grup sumber daya	Pilih grup sumber daya yang sama yang berisi IoT hub Anda.
   Nama akun penyimpanan	Masukkan nama yang unik secara global untuk akun penyimpanan Anda.
   Performa	Terima nilai Standar default.

   

4. Anda dapat menerima semua nilai default lainnya dengan memilih Tinjau + buat.

5. Setelah validasi selesai, pilih Buat.

6. Setelah penyebaran selesai, pilih Buka sumber daya.

7. Di menu akun penyimpanan, pilih Kontainer dari bagian Penyimpanan data.

8. Pilih + Kontainer untuk membuat kontainer baru.

   

9. Beri nama untuk kontainer Anda dan pilih Buat.

Azure CLI

1. Tentukan variabel untuk akun penyimpanan dan kontainer Anda.

   GROUP_NAME: Ganti tempat penampung ini dengan nama grup sumber daya yang berisi IoT hub Anda.

   STORAGE_NAME: Ganti tempat penampung ini dengan nama untuk akun penyimpanan Anda. Nama akun penyimpanan harus huruf kecil dan unik secara global.

   CONTAINER_NAME: Ganti tempat penampung ini dengan nama kontainer Anda.

   resourceGroup=GROUP_NAME
   storageName=STORAGE_NAME
   containerName=CONTAINER_NAME
   

2. Gunakan perintah az storage account create untuk membuat akun penyimpanan v2 tujuan umum standar.

   az storage account create --name $storageName --resource-group $resourceGroup
   

3. Gunakan az storage container create untuk menambahkan kontainer ke akun penyimpanan Anda.

   az storage container create --auth-mode login --account-name $storageName --name $containerName
   

Merutekan ke akun penyimpanan

Sekarang siapkan perutean untuk akun penyimpanan. Di bagian ini Anda menentukan titik akhir baru yang menunjuk ke akun penyimpanan yang Anda buat. Kemudian, buat rute yang memfilter pesan di mana properti tingkat diatur ke penyimpanan, dan rutekan ke titik akhir penyimpanan.

Catatan

Data dapat ditulis ke penyimpanan blob dalam format Apache Avro, yang merupakan default, atau JSON.

Format pengodean hanya dapat diatur pada saat titik akhir penyimpanan blob dikonfigurasi. Format tidak dapat diubah untuk titik akhir yang telah disiapkan. Saat menggunakan pengodean JSON, Anda harus mengatur contentType ke JSON dan contentEncoding ke UTF-8 di properti sistem pesan.

Untuk informasi selengkapnya tentang menggunakan titik akhir penyimpanan blob, lihat panduan tentang perutean ke penyimpanan.

Portal Azure

1. Di portal Microsoft Azure, buka IoT hub Anda.

2. Di menu sumber daya di bawah Pengaturan hub, pilih Perutean pesan lalu pilih Tambahkan.

   

3. Pada tab Titik Akhir, buat titik akhir Penyimpanan dengan memberikan informasi berikut:

   Parameter	Nilai
   Jenis titik akhir	Pilih Penyimpanan.
   Nama titik akhir	Berikan nama unik untuk titik akhir ini.
   Kontainer Azure Storage	Pilih Pilih kontainer. Ikuti perintah untuk memilih akun penyimpanan dan kontainer yang Anda buat di bagian sebelumnya.
   Pengodean	Pilih JSON. Jika bidang ini berwarna abu-abu, wilayah akun penyimpanan Anda tidak mendukung JSON. Dalam hal ini, lanjutkan dengan AVRO default.

   

4. Terima nilai default untuk parameter lainnya dan pilih Buat + berikutnya.

5. Pada tab Rute , berikan informasi berikut untuk membuat rute yang menunjuk ke titik akhir Penyimpanan yang Anda buat:

   Parameter	Nilai
   Nama	Buat nama untuk rute Anda.
   Sumber data	Verifikasi bahwa Pesan Telemetri Perangkat dipilih dari daftar menurun.
   Aktifkan rute	Verifikasi bahwa bidang ini dicentang.
   Kueri perutean	Masukkan level="storage" sebagai string kueri.

   

6. Pilih Buat + lewati pengayaan.

Azure CLI

1. Konfigurasikan variabel yang Anda butuhkan untuk perintah titik akhir dan rute.

   ENDPOINT_NAME: Berikan nama untuk titik akhir yang mewakili kontainer penyimpanan Anda.

   ROUTE_NAME: Berikan nama untuk rute yang memfilter pesan untuk titik akhir penyimpanan

   endpointName=ENDPOINT_NAME
   routeName=ROUTE_NAME
   

2. Gunakan perintah az iot hub routing-endpoint create untuk membuat titik akhir kustom yang menunjuk ke kontainer penyimpanan yang Anda buat di bagian sebelumnya.

   az iot hub routing-endpoint create \
     --connection-string $(az storage account show-connection-string --name $storageName --query connectionString -o tsv) \
     --endpoint-name $endpointName \
     --endpoint-resource-group $resourceGroup \
     --endpoint-subscription-id $(az account show --query id -o tsv) \
     --endpoint-type azurestoragecontainer
     --hub-name $hubName \
     --container $containerName \
     --resource-group $resourceGroup \
     --encoding json
   

3. Gunakan perintah az iot hub route create untuk membuat rute yang meneruskan pesan apa pun level=storage ke titik akhir kontainer penyimpanan.

   az iot hub route create \
     --name $routeName \
     --hub-name $hubName \
     --resource-group $resourceGroup \
     --source devicemessages \
     --endpoint-name $endpointName \
     --enabled true \
     --condition 'level="storage"'
   

Menampilkan pesan yang dirutekan

Setelah dibuat di IoT Hub dan diaktifkan, rute akan segera mulai merutekan pesan yang memenuhi kondisi kuerinya ke titik akhir penyimpanan.

Memantau titik akhir bawaan dengan IoT Explorer

Kembali ke sesi IoT Explorer di komputer pengembangan Anda. Ingat bahwa IoT Explorer memantau titik akhir bawaan untuk IoT hub Anda. Itu berarti bahwa sekarang Anda seharusnya hanya melihat pesan yang tidak dirutekan oleh rute kustom yang kita buat.

Mulai sampel lagi dengan menjalankan kode. Awasi pesan masuk selama beberapa saat dan Anda hanya akan melihat pesan di mana level diatur ke normal atau critical.

Menampilkan pesan dalam kontainer penyimpanan

Verifikasi bahwa pesan tiba di kontainer penyimpanan.

1. Di portal Microsoft Azure, navigasikan ke akun penyimpanan Anda.

2. Pilih Kontainer dari bagian Penyimpanan data pada menu.

3. Pilih kontainer yang Anda buat untuk tutorial ini.

4. Harus ada folder dengan nama IoT hub Anda. Telusuri paling detail struktur file hingga Anda masuk ke file .json.

   

5. Pilih file JSON, lalu pilih Unduh untuk mengunduh file JSON. Konfirmasikan bahwa file berisi pesan dari perangkat Anda yang memiliki properti yang level diatur ke storage.

6. Berhenti menjalankan sampel.

Membersihkan sumber daya

Jika Anda ingin menghapus semua sumber daya Azure yang digunakan untuk tutorial ini, hapus grup sumber daya. Tindakan ini juga menghapus semua sumber daya yang terkandung dalam grup. Jika Anda tidak ingin menghapus seluruh grup sumber daya, gunakan portal Azure untuk menemukan dan menghapus sumber daya individual.

Jika Anda ingin melanjutkan ke tutorial berikutnya, simpan sumber daya yang Anda buat di sini.

Portal Azure

1. Di portal Azure, navigasikan ke grup sumber daya yang berisi IoT hub dan akun penyimpanan untuk tutorial ini.
2. Tinjau semua sumber daya yang ada di grup sumber daya untuk menentukan sumber daya mana yang ingin Anda bersihkan.
   • Jika ingin menghapus semua sumber daya, pilih Hapus grup sumber daya.
   • Jika Anda hanya ingin menghapus sumber daya tertentu, gunakan kotak centang di samping setiap nama sumber daya untuk memilih sumber daya yang ingin Anda hapus. Kemudian pilih Hapus.

Azure CLI

1. Gunakan perintah az resource list untuk melihat semua sumber daya dalam grup sumber daya Anda.

   az resource list --resource-group $resourceGroup --output table
   

2. Tinjau semua sumber daya yang ada di grup sumber daya untuk menentukan sumber daya mana yang ingin Anda bersihkan.

   • Jika Anda ingin menghapus semua sumber daya, gunakan perintah az group delete.

     az group delete --name $resourceGroup
     

   • Jika Anda hanya ingin menghapus sumber daya tertentu, gunakan perintah az resource delete. Misalnya:

     az resource delete --resource-group $resourceGroup --name $storageName
     

Langkah berikutnya

Dalam tutorial ini Anda mempelajari cara membuat titik akhir kustom untuk sumber daya Azure lalu membuat rute untuk mengirim pesan perangkat ke titik akhir tersebut. Lanjutkan ke tutorial berikutnya untuk mempelajari cara memperkaya pesan dengan data tambahan yang dapat digunakan untuk menyederhanakan pemrosesan hilir

Gunakan pengayaan pesan Azure IoT Hub