Memantau penyebaran IoT Edge

  • Artikel

Berlaku untuk:Tanda centang IoT Edge 1.5 IoT Edge 1.5 Tanda centang IoT Edge 1.4 IoT Edge 1.4

Penting

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

Azure IoT Edge menyediakan pelaporan yang memungkinkan Anda memantau informasi real-time pada modul yang disebarkan ke perangkat IoT Edge Anda. Layanan Azure IoT Hub mengambil status dari perangkat dan membuatnya tersedia untuk operator. Pemantauan juga penting untuk penyebaran yang dilakukan dalam skala yang mencakup penyebaran otomatis dan penyebaran berlapis.

Baik perangkat maupun modul memiliki data serupa, seperti konektivitas, sehingga nilai diperoleh sesuai dengan ID perangkat atau ID modul.

Layanan IoT Hub mengumpulkan data yang dilaporkan oleh perangkat dan modul kembar dan memberikan hitungan dari berbagai negara bagian yang mungkin dimiliki perangkat. Layanan Azure IoT Hub mengatur data ini ke dalam empat grup metrik:

Tipe Deskripsi
Ditargetkan Menampilkan perangkat IoT Edge yang cocok dengan kondisi penargetan penyebaran.
Diterapkan Menampilkan perangkat IoT Edge yang ditargetkan yang tidak ditargetkan oleh penyebaran lain dengan prioritas yang lebih tinggi.
Melaporkan Keberhasilan Menampilkan perangkat IoT Edge yang telah melaporkan bahwa modul telah berhasil disebarkan.
Kegagalan Pelaporan Menampilkan perangkat IoT Edge yang telah melaporkan bahwa satu atau beberapa modul belum berhasil disebarkan. Untuk menyelidiki kesalahan lebih lanjut, sambungkan ke perangkat tersebut dari jarak jauh dan lihat file log.

Layanan Hub IoT membuat data ini tersedia bagi Anda untuk dipantau di portal Microsoft Azure dan di Azure CLI.

Memantau penyebaran di portal Microsoft Azure

Untuk melihat detail penyebaran dan memantau perangkat yang menjalankannya, gunakan langkah-langkah berikut:

  1. Masuk ke portal Microsoft Azure dan navigasikan ke IoT Hub Anda.

  2. Pilih Konfigurasi + Penyebaran di bawah menu Manajemen perangkat .

  3. Periksa daftar penyebaran. Untuk setiap penyebaran, Anda dapat melihat detail berikut:

    Kolom Deskripsi
    ID Nama penyebaran.
    Jenis Jenis penyebaran, baik Penyebaran atau Penyebaran Berlapis.
    Persyaratan target Tag yang digunakan untuk menentukan perangkat yang ditargetkan.
    Prioritas Nomor prioritas yang ditetapkan untuk penyebaran.
    Metrik sistem Jumlah perangkat kembar di IoT Hub yang sesuai dengan kondisi penargetan. Disebarkan menentukan jumlah perangkat yang telah menerapkan konten penyebaran ke kembar modul mereka di IoT Hub.
    Metrik Perangkat Jumlah perangkat IoT Edge yang melaporkan keberhasilan atau kesalahan dari runtime klien IoT Edge.
    Metrik Kustom Jumlah data pelaporan perangkat IoT Edge untuk setiap metrik yang Anda tentukan untuk penyebaran.
    Dibuat Cap waktu dari kapan penyebaran dibuat. Cap waktu ini digunakan untuk memutuskan ikatan ketika dua penyebaran memiliki prioritas yang sama.

  4. Pilih penyebaran yang ingin Anda pantau.

  5. Pada halaman Detail Penyebaran, gulir ke bawah ke bagian bawah dan pilih tab Kondisi Target. Pilih Tampilan untuk mencantumkan perangkat yang cocok dengan kondisi target. Anda dapat mengubah kondisi dan juga Prioritas. Pilih Simpan jika Anda membuat perubahan.

    Cuplikan layar memperlihatkan perangkat yang ditargetkan untuk penyebaran.

  6. Pilih tab Metrik. Jika Anda memilih metrik dari menu drop-down Pilih Metrik, tombol Tampilan akan muncul bagi Anda untuk menampilkan hasilnya. Anda juga dapat memilih Edit Metrik untuk menyesuaikan kriteria untuk setiap metrik kustom yang telah Anda tentukan. Pilih Simpan jika Anda membuat perubahan.

    Cuplikan layar memperlihatkan metrik untuk penyebaran.

Untuk membuat perubahan pada penyebaran Anda, lihat Mengubah penyebaran.

Memantau penyebaran dengan Azure CLI

Gunakan perintah peragaan penyebaran az iot edge untuk menampilkan detail penyebaran tunggal:

az iot edge deployment show --deployment-id [deployment id] --hub-name [hub name]

Perintah peragaan penyebaran mengambil parameter berikut:

  • --deployment-id - Nama penyebaran yang ada di IoT hub. Parameter wajib.
  • --hub-name - Nama IoT hub tempat penyebaran berada. Hub harus berada dalam langganan saat ini. Beralih ke langganan yang diinginkan dengan perintah az account set -s [subscription name]

Periksa penyebaran di jendela perintah. Properti metrik mencantumkan jumlah untuk setiap metrik yang dievaluasi oleh setiap hub:

  • targetedCount - Metrik sistem yang menentukan jumlah perangkat kembar di IoT Hub yang cocok dengan kondisi penargetan.
  • appliedCount - Metrik sistem menentukan jumlah perangkat yang telah menerapkan konten penyebaran ke modul kembar mereka di IoT Hub.
  • reportedSuccessfulCount - Metrik perangkat yang menentukan jumlah perangkat IoT Edge dalam penyebaran yang melaporkan keberhasilan dari runtime klien IoT Edge.
  • reportedFailedCount - Metrik perangkat yang menentukan jumlah perangkat IoT Edge dalam penyebaran yang melaporkan kegagalan dari runtime klien IoT Edge.

Anda dapat menampilkan daftar ID atau objek perangkat untuk setiap metrik dengan perintah metrik peragaan penyebaran edge az iot:

az iot edge deployment show-metric --deployment-id [deployment id] --metric-id [metric id] --hub-name [hub name]

Perintah metrik peragaan penyebaran mengambil parameter berikut:

  • --deployment-id - Nama penyebaran yang ada di IoT hub.
  • --metric-id - Nama metrik yang ingin Anda lihat daftar ID perangkatnya, misalnya reportedFailedCount.
  • --hub-name - Nama IoT hub tempat penyebaran berada. Hub harus berada dalam langganan saat ini. Beralih ke langganan yang diinginkan dengan perintah az account set -s [subscription name].

Untuk membuat perubahan pada penyebaran Anda, lihat Mengubah penyebaran.

Langkah berikutnya

Pelajari cara memantau modul kembar, terutama IoT Edge Agent dan modul runtime IoT Edge Hub, untuk konektivitas dan kesehatan penyebaran IoT Edge Anda.