Bagikan melalui

Tutorial: Menyebarkan Azure Stream Analytics sebagai modul IoT Edge

Berlaku untuk:Tanda centang IoT Edge 1.5 IoT Edge 1.5

Penting

IoT Edge 1.5 LTS adalah rilis yang didukung. IoT Edge 1.4 LTS adalah akhir masa pakai per 12 November 2024. Jika Anda menggunakan rilis sebelumnya, lihat Memperbarui IoT Edge.

Dalam tutorial ini, Anda membuat pekerjaan Azure Stream Analytics di portal Microsoft Azure dan menyebarkannya sebagai modul IoT Edge tanpa kode tambahan.

Dalam tutorial ini, Anda akan belajar cara:

  • Buat tugas Azure Stream Analytics untuk memproses data di edge.
  • Hubungkan tugas Azure Stream Analytics baru dengan modul IoT Edge lainnya.
  • Sebarkan tugas Azure Stream Analytics ke perangkat IoT Edge dari Azure portal.

Diagram yang memperlihatkan arsitektur streaming, termasuk penahapan dan penyebaran pekerjaan Azure Stream Analytics.

Modul Stream Analytics dalam tutorial ini menghitung suhu rata-rata selama jendela 30 detik yang bergulir. Ketika rata-rata mencapai 70, modul mengirimkan pemberitahuan agar perangkat mengambil tindakan. Dalam hal ini, tindakannya adalah mengatur ulang sensor suhu yang disimulasikan. Di lingkungan produksi, Anda dapat menggunakan fungsionalitas ini untuk mematikan mesin atau mengambil tindakan pencegahan ketika suhu mencapai tingkat berbahaya.

Mengapa menggunakan Azure Stream Analytics di IoT Edge?

Banyak solusi IoT menggunakan layanan analitik untuk mendapatkan wawasan tentang data saat tiba di cloud dari perangkat IoT. Dengan Azure IoT Edge, Anda memindahkan logika Azure Stream Analytics ke perangkat itu sendiri. Memproses aliran telemetri di tepi mengurangi jumlah data yang diunggah dan waktu yang diperlukan untuk bereaksi terhadap wawasan yang dapat ditindaklanjuti. Azure IoT Edge dan Azure Stream Analytics terintegrasi untuk menyederhanakan pengembangan beban kerja Anda.

Azure Stream Analytics menggunakan sintaks kueri terstruktur untuk analisis data di cloud dan di perangkat IoT Edge. Untuk informasi selengkapnya, lihat Dokumentasi Azure Stream Analytics.

Prasyarat

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

  • Perangkat Azure IoT Edge.

    Gunakan mesin virtual Azure sebagai perangkat IoT Edge dengan mengikuti langkah-langkah dalam panduan mulai cepat untuk perangkat Linux atau Windows.

  • Tingkat standar atau gratis Azure IoT Hub di Azure.

Membuat pekerjaan Azure Stream Analytics

Di bagian ini, Anda membuat tugas Azure Stream Analytics yang:

  • Menerima data dari perangkat IoT Edge Anda.
  • Mengkueri data telemetri untuk nilai di luar rentang yang ditetapkan.
  • Mengambil tindakan pada perangkat IoT Edge berdasarkan hasil kueri.

Buat akun penyimpanan

Saat Anda membuat pekerjaan Azure Stream Analytics untuk dijalankan di perangkat IoT Edge, Anda perlu menyimpannya sehingga perangkat dapat mengaksesnya. Anda dapat menggunakan akun Azure Storage yang sudah ada atau membuat akun baru.

  1. Di Azure portal, masuk ke Buat sumber daya>Penyimpanan>Akun penyimpanan.

  2. Berikan nilai berikut untuk membuat akun penyimpanan Anda:

    Bidang Nilai
    Langganan Pilih langganan yang sama dengan hub IoT Anda.
    Grup sumber daya Gunakan grup sumber daya yang sama untuk semua sumber daya pengujian Anda untuk pengenalan cepat dan tutorial IoT Edge. Misalnya, IoTEdgeResources.
    Nama Masukkan nama yang unik untuk akun penyimpanan Anda.
    Lokasi Pilih lokasi yang dekat dengan Anda.

  3. Pertahankan nilai default untuk bidang lain, dan pilih Tinjau + Buat.

  4. Tinjau pengaturan Anda, lalu pilih Buat.

Membuat tugas baru

  1. Di portal Azure, pilih:

    1. Buat sumber daya
    2. Internet of Things dari menu di sebelah kiri
    3. Ketik Stream Analytics di bilah pencarian untuk menemukannya di Azure Marketplace
    4. Pilih Buat, lalu pekerjaan Azure Stream Analytics dari menu dropdown

  2. Berikan nilai berikut untuk membuat pekerjaan Azure Stream Analytics baru Anda:

    Bidang Nilai
    Nama Berikan nama untuk pekerjaa Anda. Misalnya, IoTEdgeJob
    Langganan Pilih langganan yang sama dengan hub IoT Anda.
    Grup sumber daya Gunakan grup sumber daya yang sama untuk semua sumber daya pengujian yang Anda buat selama panduan mulai cepat dan tutorial IoT Edge. Misalnya, sumber daya bernama IoTEdgeResources.
    Wilayah Pilih lokasi yang dekat dengan Anda.
    Lingkungan hosting Pilih Edge. Opsi ini memungkinkan Anda menyebarkan ke perangkat IoT Edge alih-alih cloud.

  3. Pilih Tinjau + buat.

  4. Konfirmasi opsi Anda, lalu pilih Buat.

Mengonfigurasi pekerjaan Anda

Setelah Anda membuat pekerjaan Azure Stream Analytics di portal Microsoft Azure, konfigurasikan dengan input, output, dan kueri untuk dijalankan pada data yang diteruskan.

Bagian ini memperlihatkan cara membuat pekerjaan yang menerima data suhu dari perangkat IoT Edge. Ini menganalisis data dalam jendela bergulir 30 detik. Jika suhu rata-rata di jendela tersebut melebihi 70 derajat, pekerjaan mengirimkan pemberitahuan ke perangkat IoT Edge.

Catatan

Anda menentukan sumber dan tujuan data di bagian berikutnya, Mengonfigurasi pengaturan IoT Edge, saat Anda melakukan penyebaran pekerjaan.

Atur input dan output Anda

  1. Buka tugas Stream Analytics Anda di portal Microsoft Azure.

  2. Di bawah Topologi pekerjaan, pilih Input, lalu pilih Tambahkan input.

  3. Pilih Edge Hub dari daftar dropdown.

    Jika Anda tidak melihat opsi Edge Hub dalam daftar, Anda mungkin telah membuat tugas Azure Stream Analytics sebagai tugas yang dihosting di cloud. Coba buat pekerjaan baru, dan pastikan Anda memilih Edge sebagai lingkungan hosting.

  4. Di panel Input baru, masukkan suhu sebagai alias Input.

  5. Pertahankan nilai default untuk bidang lain dan pilih Simpan.

  6. Di bawah Topologi pekerjaan, pilih Output, lalu pilih Tambahkan.

  7. Pilih Edge Hub dari daftar menurun.

  8. Di panel Output baru, masukkan peringatan sebagai alias output.

  9. Pertahankan nilai default untuk bidang lain dan pilih Simpan.

Membuat kueri

  1. Pada Topologi Pekerjaan, pilih Kueri.

  2. Ganti teks default dengan kueri berikut:

    SELECT  
    'reset' AS command
INTO
   alert
FROM
   temperature TIMESTAMP BY timeCreated
GROUP BY TumblingWindow(second,30)
HAVING Avg(machine.temperature) > 70

    Dalam kueri ini, kode SQL mengirimkan perintah reset ke output pemberitahuan jika suhu komputer rata-rata dalam jendela 30 detik mencapai 70 derajat. Perintah reset telah diprogram sebelumnya ke dalam sensor sebagai tindakan.

  3. Pilih Simpan kueri.

Konfigurasikan pengaturan IoT Edge

Untuk menyebarkan pekerjaan Azure Stream Analytics Anda di perangkat IoT Edge, kaitkan pekerjaan Azure Stream Analytics Anda dengan akun penyimpanan. Saat Anda menyebarkan pekerjaan Anda, definisi pekerjaan diekspor ke akun penyimpanan sebagai kontainer.

  1. Di layanan Azure Stream Analytics Anda, di bawah menu Pengaturan , pilih Pengaturan akun penyimpanan.

  2. Pilih opsi Pilih Penyimpanan Blob/ADLS Gen 2 dari langganan Anda.

  3. Akun penyimpanan Azure Anda secara otomatis ditampilkan di halaman. Jika Anda tidak melihatnya, pastikan Anda membuat penyimpanan. Jika Anda perlu memilih penyimpanan yang berbeda dari penyimpanan yang tercantum di bidang Akun penyimpanan , pilih penyimpanan dari menu dropdown.

  4. Pilih Simpan jika Anda membuat perubahan apa pun.

Menyebarkan tugas

Anda sekarang siap untuk menyebarkan pekerjaan Azure Stream Analytics di perangkat IoT Edge Anda.

Di bagian ini, Anda menggunakan panduan Atur Modul di Azure portal untuk membuat manifes penyebaran. Manifes penyebaran adalah file JSON yang menjelaskan semua modul yang disebarkan ke perangkat. Manifes juga menunjukkan registri kontainer yang menyimpan gambar modul, bagaimana modul harus dikelola, dan bagaimana modul dapat berkomunikasi satu sama lain. Perangkat IoT Edge Anda mengambil manifes penyebarannya dari IoT Hub, lalu menggunakan informasi di dalamnya untuk menyebarkan dan mengonfigurasi semua modul yang ditetapkan.

Untuk tutorial ini, Anda menyebarkan dua modul. Yang pertama adalah SimulatedTemperatureSensor, yang merupakan modul yang mensimulasikan sensor suhu dan kelembapan. Yang kedua adalah tugas Stream Analytics Anda. Modul sensor menyediakan aliran data yang dianalisis kueri pekerjaan Anda.

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

  2. Pilih Perangkat di bawah menu Manajemen perangkat , lalu pilih perangkat IoT Edge Anda untuk membukanya.

  3. Pilih Set modul.

  4. Jika sebelumnya Anda menggunakan modul SimulatedTemperatureSensor pada perangkat ini, mungkin terjadi autopopulasi pada modul. Jika tidak, tambahkan modul dengan langkah-langkah berikut:

    1. Pilih + Tambahkan dan pilih Modul IoT Edge.
    2. Untuk nama, ketik SimulatedTemperatureSensor.
    3. Untuk URI gambar, masukkan mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.5.
    4. Biarkan pengaturan default lainnya, lalu pilih Tambahkan.

  5. Tambahkan tugas Azure Stream Analytics Edge Anda dengan langkah-langkah berikut:

    1. Pilih + Tambahkan dan pilih Modul Azure Stream Analytics.
    2. Pilih langganan Anda dan tugas Azure Stream Analytics Edge yang Anda buat.
    3. Pilih Simpan.

    Setelah menyimpan perubahan, detail tugas Stream Analytics akan dipublikasikan ke kontainer penyimpanan yang Anda buat.

  6. Setelah penambahan Azure Stream Analytics Anda selesai penyebaran, konfirmasikan bahwa dua modul baru muncul di halaman Atur modul Anda.

    Cuplikan layar yang mengonfirmasi bahwa dua modul baru ada di perangkat Anda. Cuplikan layar juga menunjukkan di mana tombol Tinjau + buat berada.

  7. Pilih Tinjau + buat. Manifes penyebaran muncul.

  8. Pilih Buat.

  9. Pada halaman Atur modul perangkat Anda, setelah beberapa menit, Anda akan melihat modul tercantum dan berjalan. Refresh halaman jika Anda tidak melihat modul, atau tunggu beberapa menit lagi lalu refresh lagi.

Memahami dua modul baru

  1. Dari tab Atur modul perangkat Anda, pilih nama modul Azure Stream Analytics untuk membawa Anda ke halaman Perbarui Modul IoT Edge. Di sini Anda dapat memperbarui pengaturan.

    Tab Pengaturan memiliki URI Gambar yang menunjuk ke gambar Azure Stream Analytics standar. Gambar tunggal ini digunakan untuk setiap modul Azure Stream Analytics yang disebarkan ke perangkat IoT Edge.

    Tab Pengaturan Modul Kembar memperlihatkan JSON yang mendefinisikan properti Azure Stream Analytics (ASA) yang disebut ASAJobInfo. Nilai properti tersebut menunjuk ke definisi tugas dalam kontainer penyimpanan Anda. Properti ini adalah cara gambar Stream Analytics dikonfigurasi dengan detail tugas spesifik Anda.

    Secara default, modul Stream Analytics mengambil nama yang sama dengan tugas yang didasarkan padanya. Anda dapat mengubah nama modul di halaman ini jika Anda mau, tetapi tidak diwajibkan.

  2. Pilih Terapkan jika Anda membuat perubahan atau Membatalkan jika Anda tidak membuat perubahan apa pun.

Menetapkan rute ke modul Anda

  1. < > perangkat Anda, pilih Berikutnya: Rute.

  2. Pada tab Rute, Anda menentukan bagaimana pesan disampaikan antara modul dan IoT Hub. Pesan dibangun menggunakan pasangan nama dan nilai.

    Tambahkan nama rute dan nilai dengan pasangan yang diperlihatkan dalam tabel berikut. Ganti instans {moduleName} dengan nama modul Azure Stream Analytics Anda. Modul ini harus berupa nama yang sama dengan yang Anda lihat di daftar modul perangkat Anda di halaman Atur modul, seperti yang ditunjukkan pada portal Azure.

    Cuplikan layar memperlihatkan nama modul Azure Stream Analytics Anda di perangkat IoT Edge Anda di portal Azure.

    Nama Nilai
    telemetriToCloud FROM /messages/modules/SimulatedTemperatureSensor/* INTO $upstream
    peringatanKeAwan FROM /messages/modules/{moduleName}/* INTO $upstream
    peringatanUntukMengaturUlang FROM /messages/modules/{moduleName}/* INTO BrokeredEndpoint("/modules/SimulatedTemperatureSensor/inputs/control")
    telemetriToAsa FROM /messages/modules/SimulatedTemperatureSensor/* INTO BrokeredEndpoint("/modules/{moduleName}/inputs/temperature")

    Rute yang Anda nyatakan di sini menentukan aliran data melalui perangkat IoT Edge. Data telemetri dari SimulatedTemperatureSensor dikirim ke IoT Hub dan ke input suhu yang dikonfigurasi dalam tugas Stream Analytics. Pesan peringatan output dikirim ke IoT Hub dan ke modul SimulatedTemperatureSensor untuk memicu perintah reset.

  3. Pilih Berikutnya: Tinjau + Buat.

  4. Di tab Tinjau + Buat, Anda bisa melihat bagaimana informasi yang Anda berikan dalam panduan dikonversi menjadi manifes penyebaran JSON.

  5. Setelah selesai meninjau manifes, pilih Buat untuk menyelesaikan pengaturan modul Anda.

Menampilkan data

Buka perangkat IoT Edge Anda untuk melihat interaksi antara modul Azure Stream Analytics dan modul SimulatedTemperatureSensor.

Catatan

Jika Anda menggunakan komputer virtual untuk perangkat, gunakan Azure Cloud Shell untuk mengakses semua layanan terautentikasi Azure secara langsung.

  1. Periksa apakah semua modul berjalan di Docker:

    iotedge list

  2. Lihat semua data log dan metrik sistem. Ganti {moduleName} dengan nama modul Azure Stream Analytics Anda:

    iotedge logs -f {moduleName}

  3. Lihat bagaimana perintah reset memengaruhi SimulatedTemperatureSensor dengan melihat log sensor:

    iotedge logs SimulatedTemperatureSensor

    Anda dapat melihat suhu mesin berangsur-angsur naik hingga mencapai 70 derajat selama 30 detik. Kemudian modul Stream Analytics memicu reset, dan suhu komputer turun kembali ke 21.

    Cuplikan layar perintah reset dalam output log modul.

Membersihkan sumber daya

Jika Anda ingin melanjutkan ke artikel yang direkomendasikan berikutnya, pertahankan sumber daya dan konfigurasi yang Anda buat dan gunakan kembali. Anda juga dapat tetap menggunakan perangkat IoT Edge yang sama sebagai perangkat uji.

Jika tidak, hapus konfigurasi lokal dan sumber daya Azure yang Anda gunakan dalam artikel ini untuk menghindari biaya.

Menghapus sumber daya Azure

Menghapus sumber daya Azure dan grup sumber daya tidak dapat diubah. Pastikan Anda tidak menghapus grup atau sumber daya yang salah secara tidak sengaja. Jika Anda membuat IoT Hub di dalam grup sumber daya yang ada yang memiliki sumber daya yang ingin Anda simpan, hapus hanya sumber daya IoT Hub itu sendiri, bukan grup sumber daya.

Untuk menghapus sumber daya:

  1. Masuk ke portal Azure, lalu pilih Grup sumber daya.
  2. Pilih nama grup sumber daya yang berisi sumber daya pengujian IoT Edge Anda.
  3. Tinjau daftar sumber daya yang dimuat grup sumber daya Anda. Jika ingin menghapus semuanya, Anda dapat memilih Hapus grup sumber daya. Jika Anda hanya ingin menghapus beberapa dari mereka, Anda dapat memilih setiap sumber daya untuk menghapusnya satu per satu.

Langkah berikutnya

Dalam tutorial ini, Anda menyiapkan pekerjaan Azure Stream Analytics untuk menganalisis data dari perangkat IoT Edge Anda. Anda memuat modul Azure Stream Analytics di perangkat IoT Edge Anda untuk memproses dan bereaksi terhadap peningkatan suhu secara lokal, dan mengirim aliran data agregat ke cloud. Untuk mempelajari bagaimana Azure IoT Edge dapat membantu Anda membangun lebih banyak solusi, coba tutorial berikutnya.

Menyebarkan model Azure Machine Learning sebagai modul

  • Last updated on