Tutorial: Memantau perangkat IoT dan mengirim pemberitahuan dengan Azure Logic Apps

Gunakan Azure Logic Apps untuk memantau telemetri perangkat masuk dari IoT Hub dan mengirim pemberitahuan saat pemberitahuan dipicu.

Azure Logic Apps dapat membantu Anda mengatur alur kerja di seluruh layanan lokal dan cloud, beberapa perusahaan, dan berbagai protokol. Aplikasi logika dimulai dengan pemicu, yang kemudian diikuti oleh satu atau beberapa tindakan yang dapat diurutkan menggunakan kontrol bawaan, seperti kondisi dan iterator. Fleksibilitas ini menjadikan Logic Apps solusi IoT yang ideal untuk skenario pemantauan IoT. Misalnya, kedatangan data dari perangkat di titik akhir IoT Hub dapat memulai alur kerja aplikasi logika untuk gudang data dalam blob Azure Storage, mengirim pemberitahuan email untuk memperingatkan anomali data, menjadwalkan kunjungan teknisi jika perangkat melaporkan kegagalan, dan sebagainya.

Dalam tutorial ini, Anda melakukan tugas-tugas berikut:

Buat antrean Azure Service Bus. Buat rute di hub IoT Anda yang mengirim pesan ke antrean Azure Service Bus jika pesan berisi pembacaan suhu anomali. Buat aplikasi logika yang mengawasi pesan yang tiba dalam antrean dan mengirim pemberitahuan email.

Kode klien yang berjalan di perangkat Anda mengatur properti aplikasi, temperatureAlert, pada setiap pesan telemetri yang dikirimnya ke hub IoT Anda. Ketika kode klien mendeteksi suhu di atas ambang batas tertentu, ia mengatur properti ini ke true; jika tidak, ia mengatur properti ke false.

Pesan yang tiba di hub IoT Anda terlihat mirip dengan yang berikut ini, dengan data telemetri yang terdapat dalam isi pesan dan properti temperatureAlert yang terdapat dalam properti aplikasi (properti sistem tidak ditampilkan).

{
  "body": {
    "messageId": 18,
    "deviceId": "Raspberry Pi Web Client",
    "temperature": 27.796111770668457,
    "humidity": 66.77637926438427
  },
  "applicationProperties": {
    "temperatureAlert": "false"
  }
}

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

Prasyarat

Siapkan prasyarat berikut sebelum memulai tutorial ini.

• Langganan Azure aktif.

• Hub IoT di langganan Anda.

• Aplikasi klien yang mengirim data suhu ke hub Azure IoT Anda. Tutorial ini memfilter pesan perangkat ke cloud berdasarkan properti pesan yang disebut temperatureAlert. Beberapa sampel yang menghasilkan pesan dengan properti ini meliputi:

  • .NET SDK: SimulatedDevice
  • Java SDK: send-event
  • Node.js SDK: simple_sample_device
  • C SDK: iothub_II_client_shared_sample
  • Tanpa kode: Simulator online Raspberry Pi

Membuat namespace dan antrean Service Bus

Buat namespace Bus Layanan dan antrean. Kemudian dalam artikel ini, Anda membuat aturan perutean di hub IoT Anda untuk mengarahkan pesan yang berisi pemberitahuan suhu ke antrean Service Bus. Aplikasi logika memantau antrean untuk pesan masuk dan mengirim pemberitahuan untuk setiap pemberitahuan.

Membuat Namespace Service Bus

1. Di portal Microsoft Azure, gunakan bilah pencarian untuk mencari dan memilih Bus Layanan.

2. Pilih Buat untuk membuat namespace bus layanan.

3. Di panel Buat namespace, berikan informasi berikut ini:

   Pengaturan	Nilai
   Subscription	Pilih langganan yang sama yang berisi hub IoT Anda.
   grup Sumber Daya	Pilih grup sumber daya yang sama yang berisi hub IoT Anda.
   Nama namespace layanan	Berikan nama untuk namespace bus layanan Anda. Namespace harus unik di seluruh Azure.
   Tempat	Pilih lokasi yang sama dengan yang digunakan hub IoT Anda.
   Tingkat harga	Pilih Dasar dari daftar drop-down. Tingkat Dasar cukup untuk tutorial ini.

4. Pilih Tinjau + kreasikan.

5. Pilih Buat.

6. Tunggu hingga penyebaran selesai, lalu pilih Buka sumber daya.

Menambahkan antrean Service Bus ke namespace

1. Pada halaman Gambaran Umum namespace Service Bus Anda, pilih Antrean.

   

2. Di bidang Nama , berikan nama untuk antrean. Terima nilai default untuk bidang lain dan pilih Buat.

3. Di namespace Service Bus Anda, pilih Kebijakan akses bersama dari bagian Pengaturan di menu sumber daya.

4. Pilih kebijakan RootManageSharedAccessKey untuk membuka detailnya.

5. Salin nilai String koneksi utama dan simpan untuk digunakan nanti dalam tutorial ini saat Anda mengonfigurasi aplikasi logika.

Tambahkan titik akhir kustom dan aturan perutean ke hub IoT Anda

Tambahkan titik akhir kustom untuk antrean Azure Service Bus ke hub IoT Anda. Kemudian, buat aturan perutean pesan untuk mengarahkan pesan yang berisi peringatan suhu ke titik akhir tersebut, di mana pesan tersebut ditangani oleh aplikasi logika Anda. Aturan perutean menggunakan kueri routing, temperatureAlert = "true", untuk meneruskan pesan berdasarkan nilai properti aplikasi temperatureAlert yang ditetapkan oleh kode klien yang berjalan di perangkat. Untuk mempelajari selengkapnya, lihat Kueri perutean pesan berdasarkan properti pesan.

Menambahkan titik akhir dan rute kustom

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

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

   

3. Pada tab Titik Akhir , buat titik akhir untuk antrean Bus Layanan Anda dengan memberikan informasi berikut:

   Pengaturan	Nilai
   Jenis titik akhir	Pilih Antrean Service Bus.
   Nama titik akhir	Berikan nama untuk titik akhir baru yang memetakan ke antrean Bus Layanan Anda.
   Namespace layanan Service Bus	Gunakan menu drop-down untuk memilih namespace Service Bus yang Anda buat di bagian sebelumnya.
   antrean Bus Layanan	Gunakan menu drop-down untuk memilih antrean Service Bus yang Anda buat di namespace Anda.

   

4. Pilih Buat + selanjutnya.

5. Pada tab Rute , masukkan informasi berikut untuk membuat rute yang menunjuk ke titik akhir antrean Azure Service Bus Anda:

   Pengaturan	Nilai
   Nama	Berikan nama unik untuk rute tersebut.
   Sumber data	Pertahankan sumber data Pesan Telemetri Perangkat default.
   Kueri perutean	Masukkan temperatureAlert = "true" sebagai string kueri.

   

6. Pilih Buat + lewati pengayaan.

Mengonfigurasi Logic Apps untuk pemberitahuan

Di bagian sebelumnya, Anda menyiapkan hub IoT untuk merutekan pesan yang berisi pemberitahuan suhu ke antrean Bus Layanan Anda. Sekarang, Anda menyiapkan aplikasi logika untuk memantau antrean Bus Layanan dan mengirim pemberitahuan email setiap kali pesan ditambahkan ke antrean.

Membuat aplikasi logika

1. Di portal Microsoft Azure, cari dan pilih Logic Apps.

2. Pilih Tambahkan untuk membuat aplikasi logika baru.

3. Masukkan informasi berikut pada tab Dasar dari Buat Aplikasi Logika:

   Pengaturan	Nilai
   grup Sumber Daya	Pilih grup sumber daya yang sama yang berisi hub IoT Anda.
   Nama	Berikan nama untuk aplikasi logika Anda.
   Wilayah	Pilih lokasi yang dekat dengan Anda.
   Jenis rencana	Pilih Konsumsi, yang cukup untuk tutorial ini.

   

4. Pilih Tinjau + kreasikan.

5. Pilih Buat.

6. Setelah penyebaran selesai, pilih Buka sumber daya untuk membuka aplikasi logika Anda.

Mengonfigurasikan pemicu aplikasi logika

1. Pada halaman sumber daya aplikasi logika Anda di portal Microsoft Azure, buka perancang aplikasi Logika dari bagian Alat Pengembangan di menu sumber daya.

2. Di perancang, gulir ke bawah ke Templat dan pilih Aplikasi Logika Tanpa Isi.

   

3. Pilih tab Semua untuk menampilkan semua konektor dan pemicu, lalu pilih Bus Layanan.

   

4. Di bawah Pemicu, pilih Saat satu atau beberapa pesan tiba dalam antrean (selesai otomatis).

   

5. Membuat koneksi bus layanan.

   1. Berikan Nama koneksi lalu tempelkan string Koneksi yang Anda salin dari namespace Bus Layanan Anda.

   2. Pilih Buat.

   3. Pada layar berikutnya, gunakan menu drop-down untuk memilih antrean yang Anda buat di namespace Service Bus Anda. Kemudian, masukkan 175 untuk Jumlah pesan maksimum.

      

6. Pilih Simpan pada menu perancang aplikasi logika untuk menyimpan perubahan Anda.

Mengonfigurasi tindakan aplikasi logika

1. Pilih Langkah baru di perancang aplikasi logika.

2. Buat koneksi layanan SMTP.

   1. Cari dan pilih SMTP.

      

   2. Pilih Kirim Email (V3) sebagai tindakan untuk langkah ini.

   3. Berikan Nama koneksi, lalu isi bidang lainnya dengan informasi SMTP untuk akun email yang ingin Anda gunakan untuk mengirim pesan pemberitahuan.

      Gunakan tautan berikut untuk menemukan informasi SMTP Anda, bergantung pada penyedia email Anda:

      • Hotmail/Outlook.com
      • Gmail
      • Yahoo Mail.

      Nota

      Anda mungkin perlu menonaktifkan TLS/SSL untuk membuat koneksi. Jika ini masalahnya dan Anda ingin mengaktifkan kembali TLS setelah koneksi dibuat, lihat langkah opsional di akhir bagian ini.

      

   4. Pilih Buat.

3. Konfigurasikan tindakan Kirim Email .

   1. Dari menu drop-down Tambahkan parameter baru pada langkah Kirim Email , pilih parameter berikut:

      • Dari
      • Ke
      • Judul
      • Badan

      Klik atau ketuk di mana saja di layar untuk menutup kotak pilihan.

      

   2. Masukkan informasi berikut untuk parameter email yang Anda pilih di langkah sebelumnya:

      Pengaturan	Nilai
      Dari	Alamat email yang Anda konfigurasi untuk koneksi SMTP.
      Ke	Alamat email atau alamat tempat Anda ingin mengirim email pemberitahuan.
      Judul	High temperature detected.
      Badan	High temperature detected.

      Jika dialog Tambahkan konten dinamis terbuka, pilih Sembunyikan untuk menutupnya. Anda tidak menggunakan konten dinamis dalam tutorial ini.

      

4. Pilih Simpan untuk menyimpan koneksi SMTP.

5. (Opsional) Jika Anda harus menonaktifkan TLS untuk membuat koneksi dengan penyedia email Anda dan ingin mengaktifkannya kembali, ikuti langkah-langkah berikut:

   1. Pada panel Aplikasi logika , di bawah Alat Pengembangan, pilih Koneksi API.

   2. Dari daftar koneksi API, pilih koneksi SMTP.

   3. Pada panel Koneksi API smtp , di bawah Umum, pilih Edit koneksi API.

   4. Pada panel Edit Koneksi API , pilih Aktifkan SSL?, masukkan kembali kata sandi untuk akun email Anda, dan pilih Simpan.

      

Aplikasi logika Anda sekarang siap untuk memproses pemberitahuan suhu dari antrean Azure Service Bus dan mengirim pemberitahuan ke akun email Anda.

Menguji aplikasi logika

Mulai kirim pesan suhu dari perangkat IoT Anda untuk menguji alur pemantauan dan pemberitahuan.

1. Mulai aplikasi klien di perangkat Anda. Kode klien secara acak menghasilkan pesan telemetri, dan mengatur temperatureAlert properti ke true ketika suhu melebihi 30 C.

2. Anda harus mulai menerima pemberitahuan email yang dikirim oleh aplikasi logika.

   Nota

   Penyedia layanan email Anda mungkin perlu memverifikasi identitas pengirim untuk memastikan Andalah yang mengirim email.

Membersihkan sumber daya

Jika Anda tidak memerlukan sumber daya yang Anda buat dalam tutorial ini lagi, hapus dan grup sumber daya di portal. Untuk melakukannya, pilih grup sumber daya yang berisi hub IoT Anda dan pilih Hapus.

Atau, gunakan CLI:

# Delete your resource group and its contents
az group delete --name <RESOURCE_GROUP_NAME>

Langkah selanjutnya

Dalam tutorial ini, Anda membuat aplikasi logika yang menghubungkan hub IoT dan kotak surat Anda untuk pemantauan suhu dan pemberitahuan.

Untuk terus mulai menggunakan Azure IoT Hub dan menjelajahi semua skenario IoT yang diperluas, lihat yang berikut ini:

• Mengelola pesan perangkat cloud dengan ekstensi Azure IoT Hub untuk Visual Studio Code

• Mengelola perangkat dengan ekstensi Azure IoT Hub untuk Visual Studio Code

• Menyiapkan perutean pesan

• Menggunakan Power BI untuk memvisualisasikan data sensor real-time dari hub IoT Anda

• Menggunakan aplikasi web untuk memvisualisasikan data sensor real-time dari hub IoT Anda

• Menggunakan Logic Apps untuk pemantauan dan pemberitahuan jarak jauh