Mulai cepat: Kirim telemetri dari perangkat ke IoT hub dan pantau dengan Azure CLI

Artikel
06/01/2023

Azure IoT Hub adalah layanan Azure yang memungkinkan Anda menyerap telemetri dalam volume tinggi dari perangkat IoT Anda ke cloud untuk penyimpanan atau pemrosesan. Dalam mulai cepat tanpa kode ini, Anda menggunakan Azure CLI untuk membuat hub IoT dan perangkat yang disimulasikan. Anda akan mengirim telemetri perangkat ke hub, dan mengirim pesan, memanggil metode, dan memperbarui properti di perangkat. Anda juga menggunakan portal Microsoft Azure untuk memvisualisasikan metrik perangkat. Artikel ini menunjukkan alur kerja dasar bagi pengembang yang menggunakan CLI untuk berinteraksi dengan aplikasi IoT Hub.

Prasyarat

Jika Anda belum berlangganan Azure, buat akun gratis sebelum memulai.
Azure CLI. Anda dapat menjalankan semua perintah dalam panduan mulai cepat ini menggunakan Azure Cloud Shell, yaitu shell CLI interaktif yang berjalan di browser Anda atau di aplikasi seperti Windows Terminal. Jika menggunakan Cloud Shell, Anda tidak perlu memasang apa pun. Jika Anda lebih suka menggunakan CLI secara lokal, panduan mulai cepat ini memerlukan Azure CLI versi 2.36 atau yang lebih baru. Jalankan az --version untuk menemukan versinya. Untuk memasang atau meningkatkan, lihat Pasang Azure CLI.

Masuk ke portal Azure.

Terlepas dari apakah Anda menjalankan CLI secara lokal atau di Cloud Shell, tetap buka portal di browser Anda. Anda menggunakannya nanti di mulai cepat.

Luncurkan Cloud Shell

Di bagian ini, Anda meluncurkan instans Azure Cloud Shell. Jika Anda menggunakan CLI secara lokal, lewati ke bagian Siapkan dua sesi CLI.

Untuk meluncurkan Cloud Shell:

Pilih tombol Cloud Shell pada bilah menu di kanan atas di portal Microsoft Azure.

Catatan

Jika ini pertama kalinya Anda menggunakan Cloud Shell, Cloud Shell akan meminta Anda untuk membuat penyimpanan, yang diperlukan untuk menggunakan Cloud Shell. Pilih langganan untuk membuat akun penyimpanan dan berbagi Microsoft Azure Files.
Pilih lingkungan CLI pilihan Anda di menu geser turun Pilih lingkungan. Mulai cepat ini menggunakan lingkungan Bash. Anda juga dapat menggunakan lingkungan PowerShell .

Catatan

Beberapa perintah memerlukan sintaks atau pemformatan yang berbeda di lingkungan Bash dan PowerShell . Untuk informasi selengkapnya, lihat Tips untuk menggunakan Azure CLI dengan sukses.

Siapkan dua sesi CLI

Di bagian ini, Anda menyiapkan dua sesi Azure CLI. Jika Anda menggunakan Cloud Shell, Anda akan menjalankan sesi ini di tab Cloud Shell terpisah. Jika menggunakan klien CLI lokal, Anda akan menjalankan dua instans CLI terpisah. Gunakan sesi CLI terpisah untuk tugas-tugas berikut:

Sesi pertama mensimulasikan perangkat IoT yang berkomunikasi dengan hub IoT Anda.
Sesi kedua memantau perangkat di sesi pertama, atau mengirim pesan, perintah, dan pembaruan properti.

Untuk menjalankan perintah, pilih Salin untuk menyalin blok kode dalam mulai cepat ini, tempelkan ke sesi shell Anda, dan jalankan.

Azure CLI mengharuskan Anda untuk masuk ke akun Azure Anda. Semua komunikasi antara sesi shell Azure CLI Anda dengan hub IoT Anda diautentikasi dan dienkripsi. Akibatnya, panduan mulai cepat ini tidak memerlukan autentikasi tambahan yang akan Anda gunakan dengan perangkat nyata, seperti string koneksi.

Pada sesi CLI pertama, jalankan perintah tambahkan ekstensi az. Jalankan perintah tambahkan ekstensi az untuk menambahkan Microsoft Azure IoT Extension untuk Azure CLI ke shell CLI Anda. IoT Extension menambahkan perintah spesifik IoT Hub, IoT Edge, dan IoT Device Provisioning Service (DPS) ke Azure CLI.
```
az extension add --name azure-iot
```
Setelah Anda memasang ekstensi Azure IOT, Anda tidak perlu memasangnya lagi di sesi Cloud Shell apa pun.

Catatan

Artikel ini menggunakan versi terbaru ekstensi Azure IoT, yang disebut azure-iot. Versi warisan disebut azure-cli-iot-ext. Anda seharusnya hanya memiliki satu versi yang terinstal pada satu waktu. Anda bisa menggunakan perintah az extension list untuk memvalidasi ekstensi yang saat ini terinstal.

Gunakan az extension remove --name azure-cli-iot-ext untuk menghapus versi lama ekstensi.

Gunakan az extension add --name azure-iot untuk menambahkan versi baru ekstensi.

Untuk melihat ekstensi apa yang telah Anda instal, gunakan az extension list.
Buka sesi CLI kedua. Jika Anda menggunakan Cloud Shell di browser, gunakan tombol Buka sesi baru. Jika Anda menggunakan CLI secara lokal, buka instans kedua.

Membuat Azure IoT Hub

Di bagian ini, Anda menggunakan Azure CLI untuk membuat grup sumber daya dan IoT hub. Grup sumber daya Azure adalah kontainer logis yang disebarkan dan dikelola sumber daya Azure. Hub IoT bertindak sebagai hub pesan pusat untuk komunikasi dua arah antara aplikasi IoT Anda dan perangkat.

Tip

Secara opsional, Anda dapat membuat grup sumber daya Azure, IoT Hub, dan sumber daya lainnya dengan menggunakan portal Microsoft Azure, Visual Studio Code, atau metode terprogram lainnya.

Pada sesi CLI pertama, jalankan perintah buat az group untuk membuat grup sumber daya. Perintah berikut membuat grup sumber daya bernama MyResourceGroup di lokasi eastus.
```
az group create --name MyResourceGroup --location eastus
```
Pada sesi CLI pertama, jalankan perintah buat hub iot modul Az PowerShell untuk membuat hub IoT. Mungkin perlu waktu beberapa menit untuk membuat hub IoT.

YourIotHubName. Ganti tempat penampung ini dan kurung kurawal di sekitarnya dalam perintah berikut, menggunakan nama yang Anda pilih untuk hub IoT Anda. Nama hub IoT harus unik secara global di Azure. Gunakan nama hub IoT Anda di sisa mulai cepat ini di mana pun Anda melihat tempat penampung.
```
az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}
```

Membuat dan memantau perangkat

Di bagian ini, Anda membuat perangkat yang disimulasikan di sesi CLI pertama. Perangkat yang disimulasikan mengirimkan telemetri perangkat ke IoT hub Anda. Di sesi CLI kedua, Anda memantau peristiwa dan telemetri.

Untuk membuat dan memulai perangkat yang disimulasikan:

Jalankan perintah buat az iot hub device-identity di sesi CLI pertama. Perintah ini akan membuat identitas perangkat simulasi.

YourIotHubName. Ganti tempat penampung di bawah ini dengan nama yang Anda pilih untuk IoT hub Anda.

simDevice. Anda dapat menggunakan nama ini secara langsung untuk ID perangkat simulasi di sisa artikel ini. Anda juga dapat menggunakan nama yang berbeda.
```
az iot hub device-identity create -d simDevice -n {YourIoTHubName} 
```
Jalankan perintah simulasikan az iot device di sesi CLI pertama. Perintah ini memulai perangkat simulasi. Perangkat mengirim telemetri ke IoT hub Anda dan menerima pesan darinya.

YourIotHubName. Ganti tempat penampung di bawah ini dengan nama yang Anda pilih untuk IoT hub Anda.
```
az iot device simulate -d simDevice -n {YourIoTHubName}
```

Untuk memantau perangkat:

Pada sesi CLI kedua, jalankan perintah az iot hub monitor-events. Perintah ini terus memantau perangkat yang disimulasikan. Output menunjukkan telemetri seperti peristiwa dan perubahan status properti yang dikirim perangkat yang disimulasikan ke hub IoT.

YourIotHubName. Ganti tempat penampung di bawah ini dengan nama yang Anda pilih untuk hub IoT Anda.
```
az iot hub monitor-events --output table -p all -n {YourIoTHubName}
```
Setelah Anda memantau perangkat yang disimulasikan di sesi CLI kedua, tekan Ctrl+C untuk menghentikan pemantauan. Biarkan sesi CLI kedua terbuka untuk digunakan di langkah-langkah selanjutnya.

Menggunakan CLI untuk mengirim pesan

Di bagian ini, Anda mengirim pesan ke perangkat yang disimulasikan.

Pada sesi CLI pertama, konfirmasikan bahwa perangkat yang disimulasikan sedang berjalan. Jika perangkat telah berhenti, jalankan perintah berikut untuk memulainya:

YourIotHubName. Ganti tempat penampung di bawah ini dengan nama yang Anda pilih untuk IoT hub Anda.
```
az iot device simulate -d simDevice -n {YourIoTHubName}
```
Pada sesi CLI kedua, jalankan perintah az iot device c2d-message send. Ini mengirimkan pesan cloud-ke-perangkat dari IoT hub Anda ke perangkat yang disimulasikan. Pesan menyertakan string dan dua pasangan nilai kunci.

YourIotHubName. Ganti tempat penampung di bawah ini dengan nama yang Anda pilih untuk IoT hub Anda.
```
az iot device c2d-message send -d simDevice --data "Hello World" --props "key0=value0;key1=value1" -n {YourIoTHubName}
```
Secara opsional, Anda dapat mengirim pesan cloud-ke-perangkat dengan menggunakan portal Microsoft Azure. Untuk melakukan ini, telusuri ke halaman ringkasan IoT Hub Anda, pilih Perangkat IoT, pilih perangkat yang disimulasikan, dan pilih Pesan ke Perangkat.
Pada sesi CLI pertama, konfirmasikan bahwa perangkat yang disimulasikan sedang berjalan.

Menggunakan CLI untuk memanggil metode perangkat

Di bagian ini, Anda memanggil metode langsung pada perangkat yang disimulasikan.

Seperti yang Anda lakukan sebelumnya, konfirmasikan bahwa perangkat yang disimulasikan di sesi CLI pertama sedang berjalan. Jika tidak, mulai ulang.
Pada sesi CLI kedua, jalankan perintah az iot hub invoke-device-method. Dalam contoh ini, tidak ada metode yang sudah ada sebelumnya untuk perangkat. Perintah memanggil contoh nama metode pada perangkat yang disimulasikan dan mengembalikan payload.

YourIotHubName. Ganti tempat penampung di bawah ini dengan nama yang Anda pilih untuk hub IoT Anda.
```
az iot hub invoke-device-method --mn MySampleMethod -d simDevice -n {YourIoTHubName}
```
Pada sesi CLI pertama, konfirmasikan output yang menunjukkan panggilan metode.

Menggunakan CLI untuk memperbarui properti perangkat

Di bagian ini, Anda memperbarui status perangkat yang disimulasikan dengan mengatur nilai properti.

Seperti yang Anda lakukan sebelumnya, konfirmasikan bahwa perangkat yang disimulasikan di sesi CLI pertama sedang berjalan. Jika tidak, mulai ulang.
Pada sesi CLI kedua, jalankan perintah pembaruan az iot hub device-twin. Perintah ini memperbarui properti ke status yang diinginkan pada perangkat kembar hub IoT yang sesuai dengan perangkat simulasi Anda. Dalam hal ini, perintah menetapkan contoh properti kondisi suhu.

Penting

Jika Anda menggunakan PowerShell di shell CLI, gunakan versi PowerShell dari perintah di bawah ini. PowerShell mengharuskan Anda untuk keluar dari karakter dalam payload JSON.

YourIotHubName. Ganti tempat penampung di bawah ini dengan nama yang Anda pilih untuk hub IoT Anda.
```
az iot hub device-twin update -d simDevice --desired '{"conditions":{"temperature":{"warning":98, "critical":107}}}' -n {YourIoTHubName}
```
```
az iot hub device-twin update -d simDevice --desired '{\"conditions\":{\"temperature\":{\"warning\":98, \"critical\":107}}}' -n {YourIoTHubName}
```
Di sesi CLI pertama, konfirmasikan bahwa perangkat yang disimulasikan mengeluarkan pembaruan properti.
Pada sesi CLI kedua, jalankan perintah tampilkan az iot hub device-twin. Perintah ini melaporkan perubahan pada properti perangkat.

YourIotHubName. Ganti tempat penampung di bawah ini dengan nama yang Anda pilih untuk hub IoT Anda.
```
az iot hub device-twin show -d simDevice --query properties.reported -n {YourIoTHubName}
```

Menampilkan metrik pesan di portal

Portal Microsoft Azure membuat Anda bisa mengelola semua aspek IoT Hub dan perangkat Anda. Dalam aplikasi IoT Hub khas yang menyerap telemetri dari perangkat, Anda mungkin ingin memantau perangkat atau melihat metrik pada telemetri perangkat.

Untuk memvisualisasikan metrik pesan di portal Microsoft Azure:

Di menu navigasi kiri di portal, pilih Semua Sumber Daya. Ini mencantumkan semua sumber daya dalam langganan Anda, termasuk IoT hub yang Anda buat.
Pilih tautan di IoT hub yang Anda buat. Portal menampilkan halaman ringkasan untuk hub.
Pilih Metrik di panel kiri IoT Hub Anda.
Di bidang Cakupan, masukkan nama hub IoT Anda.
Pada bidang Ruang Nama Metrik, pilih Metrik Standar IoT Hub.
Di bidang Metrik, pilih Jumlah total pesan yang digunakan.
Arahkan penunjuk mouse Anda ke area garis waktu tempat perangkat Anda mengirim pesan. Jumlah total pesan pada titik waktu muncul di sudut kiri bawah garis waktu.
Secara opsional, gunakan menu geser turun Metrik untuk menampilkan metrik lain di perangkat Anda yang disimulasikan. Misalnya, pengiriman pesan C2d selesai atau Total perangkat (pratinjau) .

Membersihkan sumber daya

Jika Anda tidak lagi membutuhkan sumber daya Azure yang dibuat di mulai cepat ini, Anda bisa menggunakan Azure CLI untuk menghapusnya.

Jika Anda berencana untuk melanjutkan ke artikel yang direkomendasikan berikutnya, Anda dapat menyimpan dan menggunakan kembali sumber daya yang telah Anda buat.

Penting

Penghapusan grup sumber daya tidak dapat dipulihkan. Grup sumber daya dan semua sumber daya yang tercakup di dalamnya akan dihapus secara permanen. Pastikan Anda tidak menghapus grup sumber daya atau sumber daya yang salah secara tidak sengaja.

Untuk menghapus grup sumber daya berdasarkan nama:

Jalankan perintah hapus grup az. Perintah ini menghapus grup sumber daya, hub IoT, dan pendaftaran perangkat yang Anda buat.
```
az group delete --name MyResourceGroup
```
Jalankan perintah daftar grup az untuk mengonfirmasi bahwa grup sumber daya sudah dihapus.
```
az group list
```

Langkah berikutnya

Dalam panduan memulai ini, Anda menggunakan Azure CLI untuk membuat hub IoT, membuat perangkat simulasi, mengirim dan memantau telemetri, memanggil metode, mengatur properti yang diinginkan, dan membersihkan sumber daya. Anda menggunakan portal Microsoft Azure untuk memvisualisasikan metrik olahpesan di perangkat Anda.

Jika Anda adalah pengembang perangkat, langkah berikutnya yang disarankan adalah melihat mulai cepat telemetri yang menggunakan Azure IoT Device SDK untuk C. Secara opsional, lihat salah satu artikel mulai cepat telemetri Azure IoT Hub yang tersedia dalam bahasa pilihan Anda atau SDK.

Untuk mempelajari cara mengontrol perangkat yang disimulasikan dari aplikasi back-end, lanjutkan ke mulai cepat berikutnya.

Mulai Cepat: Mengontrol perangkat yang tersambung ke Azure IoT Hub