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

Azure IoT Hub dirancang untuk mengumpulkan data telemetri dalam volume besar dari perangkat IoT untuk penyimpanan atau pemrosesan di cloud. Dalam panduan cepat tanpa kode ini, Anda menggunakan Azure CLI untuk membuat hub IoT dan perangkat simulasi. Anda mengirim telemetri perangkat ke hub dan juga mengirim pesan, metode panggilan, dan memperbarui properti di perangkat. Anda menggunakan portal Azure untuk memvisualisasikan metrik perangkat.

Artikel ini menyediakan alur kerja dasar bagi pengembang dengan menggunakan Azure CLI untuk berinteraksi dengan aplikasi IoT Hub.

Prasyarat

  • Sebuah langganan Azure. Jika Anda tidak memilikinya, Anda dapat membuatnya secara gratis sebelum memulai.
  • Azure CLI. Anda dapat menjalankan semua perintah dalam mulai cepat ini dengan menggunakan Azure Cloud Shell, shell CLI interaktif yang berjalan di browser Anda atau di aplikasi seperti Terminal Windows. Jika Anda menggunakan Cloud Shell, Anda tidak perlu menginstal 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 menginstal atau meningkatkan, lihat Install Azure CLI.

Masuk ke portal Microsoft Azure.

Masuk ke portal Azure.

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

Buka Cloud Shell.

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

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

    Cuplikan layar yang memperlihatkan tombol Cloud Shell di portal Azure.

    Jika ini pertama kalinya Anda menggunakan Cloud Shell, Anda diminta untuk membuat penyimpanan, yang diperlukan untuk menggunakan Cloud Shell. Pilih langganan untuk membuat akun penyimpanan dan berbagi Azure Files.

  2. Pilih lingkungan CLI pilihan Anda di daftar dropdown Pilih lingkungan . Panduan memulai cepat ini menggunakan lingkungan Bash. Anda juga dapat menggunakan lingkungan PowerShell.

    Cuplikan layar yang memperlihatkan memilih lingkungan CLI.

    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, jalankan sesi ini di tab Cloud Shell terpisah. Jika Anda menggunakan klien CLI lokal, jalankan 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.

Untuk menggunakan Azure CLI, Anda harus 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 digunakan dengan perangkat nyata, seperti string koneksi.

  • Pada sesi CLI pertama, jalankan perintah tambahkan ekstensi az. Perintah menambahkan ekstensi Microsoft Azure IoT untuk Azure CLI ke shell CLI Anda. Ekstensi IoT menambahkan perintah IoT Hub, Azure IoT Edge, dan IoT Device Provisioning Service khusus untuk Azure CLI.

    az extension add --name azure-iot

    Setelah menginstal ekstensi Azure IoT, Anda tidak perlu menginstalnya 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 menginstal satu versi 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 saat ini diinstal, gunakan az extension list.

  • Buka sesi CLI kedua. Jika Anda menggunakan Cloud Shell di browser, gunakan Buka sesi baru. Jika Anda menggunakan CLI secara lokal, buka instans CLI kedua.

    Screenshot yang menunjukkan pembukaan sesi Cloud Shell baru.

Membuat IoT Hub

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

  1. Pada sesi CLI pertama, jalankan perintah buat az group untuk membuat grup sumber daya. Perintah berikut membuat grup sumber daya bernama MyResourceGroup di eastus lokasi.

    az group create --name MyResourceGroup --location eastus

  2. 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.

    Ganti placeholder YourIotHubName dan tanda kurung kurawal di sekitarnya dalam perintah berikut dengan nama yang Anda pilih untuk IoT Hub 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:

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

    • YourIotHubName. Ganti placeholder ini dalam kode berikut dengan nama yang Anda pilih untuk IoT hub Anda.
    • simDevice. Anda dapat menggunakan nama ini secara langsung untuk perangkat simulasi di sisa panduan cepat ini. Anda juga dapat menggunakan nama yang berbeda.
    az iot hub device-identity create -d simDevice -n {YourIoTHubName}

  2. Jalankan perintah az iot device simulate di sesi CLI pertama. Perintah ini memulai perangkat simulasi. Perangkat mengirim telemetri ke IoT hub Anda dan menerima pesan darinya.

    Ganti placeholder YourIotHubName dalam kode berikut dengan nama yang Anda pilih untuk hub IoT Anda.

    az iot device simulate -d simDevice -n {YourIoTHubName}

Untuk memantau perangkat:

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

    Ganti placeholder YourIotHubName dalam kode berikut dengan nama yang Anda pilih untuk hub IoT Anda.

    az iot hub monitor-events --output table -p all -n {YourIoTHubName}

    Cuplikan layar memantau peristiwa pada perangkat yang disimulasikan.

  2. Setelah Anda memantau perangkat yang disimulasikan di sesi CLI kedua, pilih 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.

  1. Pada sesi CLI pertama, konfirmasikan bahwa perangkat yang disimulasikan sedang berjalan. Jika perangkat berhenti, jalankan perintah berikut untuk memulai ulang.

    Ganti placeholder YourIotHubName dalam kode berikut dengan nama yang Anda pilih untuk hub IoT Anda.

    az iot device simulate -d simDevice -n {YourIoTHubName}

  2. Pada sesi CLI kedua, jalankan perintah az iot device c2d-message send. Perintah ini mengirimkan pesan cloud-ke-perangkat dari IoT hub Anda ke perangkat yang disimulasikan. Pesan menyertakan string dan dua pasangan kunci/nilai.

    Ganti placeholder YourIotHubName dalam kode berikut dengan nama yang Anda pilih untuk hub IoT 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 mengirim pesan melalui portal Azure, telusuri ke halaman Overview untuk hub IoT Anda, pilih PerangkatIoT, pilih perangkat yang disimulasikan, dan pilih Message ke Perangkat.

  3. Pada sesi CLI pertama, konfirmasikan bahwa perangkat yang disimulasikan telah menerima pesan tersebut.

    Cuplikan layar yang memperlihatkan perangkat yang disimulasikan menerima pesan.

Menggunakan CLI untuk memanggil metode perangkat

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

  1. Seperti yang Anda lakukan sebelumnya, konfirmasikan bahwa perangkat yang disimulasikan di sesi CLI pertama sedang berjalan. Jika tidak, mulai ulang.

  2. 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.

    Ganti placeholder YourIotHubName dalam kode berikut dengan nama yang Anda pilih untuk hub IoT Anda.

    az iot hub invoke-device-method --mn MySampleMethod -d simDevice -n {YourIoTHubName}

  3. Pada sesi CLI pertama, konfirmasikan bahwa output menunjukkan panggilan metode.

    Cuplikan layar yang memperlihatkan perangkat simulasi yang menampilkan output setelah metode dipanggil.

Menggunakan CLI untuk memperbarui properti perangkat

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

  1. Seperti yang Anda lakukan sebelumnya, konfirmasikan bahwa perangkat yang disimulasikan di sesi CLI pertama sedang berjalan. Jika tidak, mulai ulang.

  2. Pada sesi CLI kedua, jalankan perintah az iot hub device-twin update. 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 Perintah PowerShell dalam kode berikut. PowerShell mengharuskan Anda untuk menghindari karakter dalam payload JSON.

    Ganti placeholder YourIotHubName dalam kode berikut 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}

  3. Di sesi CLI pertama, konfirmasikan bahwa perangkat yang disimulasikan mengeluarkan pembaruan properti.

    Cuplikan layar yang memperlihatkan cara memperbarui properti pada perangkat.

  4. Pada sesi CLI kedua, jalankan perintah az iot hub device-twin show. Perintah ini melaporkan perubahan pada properti perangkat.

    Ganti placeholder YourIotHubName dalam kode berikut dengan nama yang Anda pilih untuk hub IoT Anda.

    az iot hub device-twin show -d simDevice --query properties.reported -n {YourIoTHubName}

    Cuplikan layar yang memperlihatkan properti yang diperbarui pada perangkat kembar.

Menampilkan metrik pesan di portal

Anda dapat mengelola semua aspek hub dan perangkat IoT Anda di portal Azure. 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:

  1. Pada menu layanan di portal, pilih Semua Sumber Daya. Tab ini mencantumkan semua sumber daya dalam langganan Anda, termasuk hub IoT yang Anda buat.

  2. Pilih tautan di hub IoT yang Anda buat. Portal menampilkan halaman Gambaran Umum untuk hub.

  3. Pilih Metrik di panel kiri hub IoT Anda.

    Cuplikan layar yang memperlihatkan metrik perpesanan IoT Hub.

  4. Di bidang Cakupan, masukkan nama hub IoT Anda.

  5. Di bidang Metric Namespace, pilih metrik standar IoT Hub.

  6. Di bidang Metrik, pilih Jumlah total pesan yang digunakan.

  7. 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.

    Screenshot yang memperlihatkan tampilan metrik IoT Hub.

  8. Secara opsional, gunakan daftar dropdown Metrik untuk menampilkan metrik lain di perangkat simulasi Anda. Misalnya, lihat pengiriman pesan C2d yang selesai atau Total perangkat (pratinjau).

Membersihkan sumber daya

Jika Anda tidak lagi memerlukan sumber daya Azure yang Anda buat dalam mulai cepat ini, Anda dapat menggunakan Azure CLI untuk menghapusnya.

Jika Melanjutkan ke artikel yang direkomendasikan berikutnya, Anda dapat menyimpan sumber daya yang sudah Anda buat dan menggunakannya kembali.

Penting

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

Untuk menghapus grup sumber daya berdasarkan nama:

  1. Jalankan perintah az group delete. Perintah ini menghapus grup sumber daya, hub IoT, dan pendaftaran perangkat yang Anda buat.

    az group delete --name MyResourceGroup

  2. Jalankan perintah az group list untuk mengonfirmasi bahwa grup sumber daya dihapus.

    az group list

RINGKASAN

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 panduan memulai cepat telemetri yang menggunakan Azure IoT Device SDK untuk C. Jika diinginkan, lihat salah satu artikel panduan memulai cepat telemetri IoT Hub yang tersedia dalam bahasa atau SDK yang Anda pilih.

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

Langkah selanjutnya

Mulai Cepat: Mengontrol perangkat yang tersambung ke IoT hub

  • Last updated on