Tutorial: Menyiapkan dan menggunakan metrik dan log dengan hub IoT

Anda dapat menggunakan Azure Monitor untuk mengumpulkan metrik dan log untuk hub IoT Anda yang dapat membantu Anda memantau pengoperasian solusi Anda dan memecahkan masalah saat terjadi. Dalam artikel ini, Anda akan melihat cara membuat bagan berdasarkan metrik, cara membuat peringatan yang memicu metrik, cara mengirim operasi dan kesalahan IoT Hub ke Log Azure Monitor, dan cara memeriksa kesalahan di log.

Tutorial ini menggunakan contoh Azure dari .NET Kirim panduan memulai telemetri untuk mengirim pesan ke hub IoT. Anda selalu dapat menggunakan perangkat atau sampel lain untuk mengirim pesan, tetapi Anda mungkin harus mengubah beberapa langkah yang sesuai.

Beberapa keakraban dengan konsep Azure Monitor mungkin berguna sebelum Anda memulai tutorial ini. Untuk mempelajari selengkapnya, lihat Pantau IoT Hub. Untuk mempelajari lebih lanjut tentang metrik dan log sumber daya yang dikeluarkan oleh IoT Hub, lihat Memantau referensi data.

Dalam tutorial ini, Anda melakukan tugas berikut:

  • Gunakan Azure CLI untuk membuat hub IoT, mendaftarkan perangkat simulasi, dan membuat ruang kerja Analisis Log.
  • Kirim koneksi IoT Hub dan log sumber daya telemetri perangkat ke Log Azure Monitor di ruang kerja Log Analytics.
  • Gunakan penjelajah metrik untuk membuat bagan berdasarkan metrik yang dipilih dan menyematkannya ke dasbor Anda.
  • Buat pemberitahuan metrik sehingga Anda dapat diberi tahu melalui email saat kondisi penting terjadi.
  • Unduh dan jalankan aplikasi yang mensimulasikan perangkat IoT yang mengirim pesan ke hub IoT.
  • Lihat peringatan ketika kondisi Anda terjadi.
  • Lihat diagram metrik di dasbor Anda.
  • Lihat kesalahan dan operasi IoT Hub di Log Azure Monitor.

Prasyarat

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

  • Anda memerlukan .NET Core SDK 2.1 atau yang lebih baru di komputer pengembangan Anda. Anda dapat mengunduh .NET Core SDK untuk beberapa platform dari .NET.

    Anda dapat memverifikasi versi C# saat ini pada komputer pengembangan Anda menggunakan perintah berikut:

    dotnet --version
    
  • Akun email yang mampu menerima email.

  • Pastikan port 8883 terbuka di firewall Anda. Sampel perangkat dalam tutorial ini menggunakan protokol MQTT, yang berkomunikasi melalui port 8883. Port ini dapat diblokir di beberapa lingkungan jaringan perusahaan dan pendidikan. Untuk mengetahui informasi selengkapnya dan cara mengatasi masalah ini, lihat Menghubungkan ke IoT Hub (MQTT).

  • Gunakan lingkungan Bash di Azure Cloud Shell.

    Luncurkan Cloud Shell di jendela baru

  • Jika mau, instal Azure CLI untuk menjalankan perintah referensi CLI.

    • Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah login az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk tambahan, lihat Masuk dengan Azure CLI.

    • Saat diminta, instal ekstensi saat pertama kali menggunakan Azure CLI. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan ekstensi dengan Azure CLI.

    • Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk memutakhirkan ke versi terbaru, jalankan pemutakhiran az.

Menyiapkan sumber daya

Untuk tutorial ini, Anda memerlukan hub IoT, ruang kerja Log Analitik, dan perangkat IoT yang disimulasikan. Sumber daya ini dapat dibuat menggunakan Azure CLI atau Azure PowerShell. Gunakan grup sumber daya dan lokasi yang sama untuk semua sumber daya. Kemudian, setelah Anda menyelesaikan tutorial, Anda dapat menghapus semuanya dalam satu langkah dengan menghapus grup sumber daya.

Berikut adalah langkah-langkah yang diperlukan.

  1. Buat grup sumber daya.

  2. Membuat IoT Hub.

  3. Buat ruang kerja Analitik Log.

  4. Daftarkan identitas perangkat untuk perangkat simulasi yang mengirim pesan ke hub IoT Anda. Simpan string koneksi perangkat yang akan digunakan untuk mengonfigurasi perangkat yang disimulasikan.

Siapkan sumber daya menggunakan Azure CLI

Salin dan tempel skrip ini ke Cloud Shell. Dengan asumsi Anda sudah masuk, skrip berjalan tiap satu baris pada satu waktu. Beberapa perintah mungkin membutuhkan waktu untuk dieksekusi. Sumber daya baru dibuat di grup sumber daya ContosoResources.

Nama untuk beberapa sumber daya harus unik di seluruh Azure. Skrip menghasilkan nilai acak dengan fungsi $RANDOM dan menyimpannya dalam variabel. Untuk sumber daya ini, skrip menambahkan nilai acak ini ke nama dasar untuk sumber daya, membuat nama sumber daya menjadi unik.

Hanya satu hub IoT gratis yang diizinkan per langganan. Jika Anda sudah memiliki hub IoT gratis di langganan Anda, hapus sebelum menjalankan skrip atau ubah skrip untuk menggunakan hub IoT gratis Anda atau Azure IoT Hub yang menggunakan tingkat standar atau dasar.

Skrip mencetak nama hub IoT, nama ruang kerja Analisis Log, dan string koneksi untuk perangkat yang didaftarkannya. Pastikan untuk mencatatnya karena Anda akan membutuhkannya nanti di artikel ini.


# This is the IOT Extension for Azure CLI.
# You only need to install this the first time.
# You need it to create the device identity.
az extension add --name azure-iot

# Set the values for the resource names that don't have to be globally unique.
# The resources that have to have unique names are named in the script below
#   with a random number concatenated to the name so you can probably just
#   run this script, and it will work with no conflicts.
location=westus
resourceGroup=ContosoResources
iotDeviceName=Contoso-Test-Device
randomValue=$RANDOM

# Create the resource group to be used
#   for all the resources for this tutorial.
az group create --name $resourceGroup \
    --location $location

# The IoT hub name must be globally unique, so add a random number to the end.
iotHubName=ContosoTestHub$randomValue
echo "IoT hub name = " $iotHubName

# Create the IoT hub in the Free tier. Partition count must be 2.
az iot hub create --name $iotHubName \
    --resource-group $resourceGroup \
    --partition-count 2 \
    --sku F1 --location $location

# The Log Analytics workspace name must be globally unique, so add a random number to the end.
workspaceName=contoso-la-workspace$randomValue
echo "Log Analytics workspace name = " $workspaceName


# Create the Log Analytics workspace
az monitor log-analytics workspace create --resource-group $resourceGroup \
    --workspace-name $workspaceName --location $location

# Create the IoT device identity to be used for testing.
az iot hub device-identity create --device-id $iotDeviceName \
    --hub-name $iotHubName

# Retrieve the primary connection string for the device identity, then copy it to
#   Notepad. You need this to run the device simulation during the testing phase.
az iot hub device-identity show-connection-string --device-id $iotDeviceName \
    --hub-name $iotHubName

Catatan

Saat membuat identitas perangkat, Anda mungkin mendapatkan kesalahan berikut: Tidak ada kunci yang ditemukan untuk pemilik kebijakan iothub dari IoT Hub ContosoTestHub. Untuk memperbaiki kesalahan ini, perbarui Ekstensi Azure CLI IoT lalu jalankan dua perintah terakhir dalam skrip lagi.

Berikut adalah perintah untuk memperbarui ekstensi. Jalankan perintah ini di instans Cloud Shell Anda.

az extension update --name azure-iot

Kumpulkan log untuk koneksi dan telemetri perangkat

IoT Hub memancarkan log sumber daya untuk beberapa kategori operasi; namun, agar Anda dapat melihat log ini, Anda harus membuat pengaturan diagnostik untuk mengirimnya ke tujuan. Salah satu tujuan tersebut adalah Log Azure Monitor, yang dikumpulkan di ruang kerja Log Analitik. Log sumber daya IoT Hub dikelompokkan ke dalam kategori yang berbeda. Anda dapat memilih kategori mana yang ingin Anda kirim ke Log Azure Monitor di pengaturan diagnostik. Dalam artikel ini, kami akan mengumpulkan log untuk operasi dan kesalahan yang terjadi terkait koneksi dan telemetri perangkat. Untuk daftar lengkap kategori yang didukung untuk IoT Hub, lihat Log sumber daya Hub IoT.

Untuk membuat pengaturan diagnostik untuk mengirim log sumber daya IoT Hub ke Log Azure Monitor, ikuti langkah-langkah berikut:

  1. Pertama, jika Anda belum berada di hub di portal, pilih Grup sumber daya dan pilih grup sumber daya ContosoResources. Pilih hub IoT Anda dari daftar sumber daya yang ditampilkan.

  2. Cari bagian Pemantauan di bilah IoT Hub. Pilih Setelan diagnostik. Kemudian pilih Tambahkan setelan diagnostik.

    Cuplikan layar yang menyoroti setelan Diagnostik di bagian Pemantauan.

  3. Pada panel Setelan diagnostik, beri nama deskriptif pada setelan Anda, seperti "Kirim sambungan dan telemetri ke log".

  4. Di bagian Detail kategori, pilih Koneksi dan Telemetri Perangkat.

  5. Di bagian Detail tujuan, pilih Kirim ke Analisis Log, lalu gunakan alat pilih ruang kerja Analisis Log untuk memilih ruang kerja yang Anda catat sebelumnya. Setelah selesai, pengaturan diagnostik akan terlihat seperti cuplikan layar berikut:

    Cuplikan layar yang menampilkan setelan log diagnostik akhir.

  6. Pilih Simpan untuk menyimpan setelan. Tutup panel Setelan diagnostik. Anda dapat melihat pengaturan baru Anda dalam daftar pengaturan diagnostik.

Menyiapkan metrik

Sekarang kita akan menggunakan penjelajah metrik untuk membuat diagram yang menampilkan metrik yang ingin Anda lacak. Anda akan menyematkan bagan ini ke dasbor default Anda di portal Azure.

  1. Di panel kiri hub IoT Anda, pilih Metrik di bagian Pemantauan.

  2. Di bagian atas layar, pilih 24 jam terakhir (Otomatis) . Pada menu tarik-turun yang muncul, pilih 4 jam terakhir untuk Rentang waktu, setel Perincian waktu ke 1 menit, dan pilih Lokal untuk Tampilkan waktu sebagai. Pilih Terapkan untuk menyimpan setelan ini. Setelan sekarang seharusnya mengatakan Waktu Setempat: 4 jam terakhir (1 menit) .

    Cuplikan layar yang menunjukkan setelan waktu metrik.

  3. Pada diagram, ada pengaturan metrik parsial yang ditampilkan dalam cakupan ke hub IoT Anda. Biarkan nilai Cakupan dan Metric Namespace pada defaultnya. Pilih setelan Metrik dan ketik "Telemetri", lalu pilih Pesan telemetri terkirim dari menu tarik-turun. Agregasi akan secara otomatis disetel ke Jumlah. Perhatikan bahwa judul bagan Anda juga berubah.

    Cuplikan layar yang menunjukkan penambahan pesan Telemetri yang dikirim metrik ke bagan.

  4. Sekarang pilih Tambahkan metrik untuk menambahkan metrik lain ke bagan. Di bawah Metrik, pilih Jumlah total pesan yang digunakan. Agregasi akan secara otomatis disetel ke Rata-rata. Perhatikan lagi bahwa judul bagan telah berubah untuk menyertakan metrik ini.

    Sekarang layar Anda menampilkan metrik yang diperkecil untuk Pesan telemetri terkirim, ditambah metrik baru untuk Jumlah total pesan yang digunakan.

    Cuplikan layar yang menunjukkan penambahan jumlah total pesan yang digunakan metrik ke bagan.

  5. Di kanan atas bagan, pilih Sematkan ke dasbor.

    Cuplikan layar yang menyoroti tombol Sematkan ke dasbor.

  6. Pada panel Sematkan ke dasbor, pilih tab Yang ada. Pilih Pribadi lalu pilih Dasbor dari menu tarik-turun Dasbor. Terakhir, pilih Sematkan untuk menyematkan bagan ke dasbor default Anda di portal Azure. Jika Anda tidak menyematkan bagan ke dasbor, setelan Anda tidak akan dipertahankan saat Anda keluar dari penjelajah metrik.

    Cuplikan layar yang menunjukkan setelan untuk Sematkan ke dasbor.

Siapkan pemberitahuan metrik

Sekarang kami akan menyiapkan pemberitahuan untuk memicu dua metrik Pesan telemetri terkirim dan Jumlah total pesan yang digunakan.

Pesan telemetri terkirim adalah metrik yang baik untuk dipantau guna melacak throughput pesan dan menghindari pembatasan. Untuk IoT Hub di tingkat gratis, batas pembatasan adalah 100 pesan/dtk. Dengan satu perangkat, kami tidak akan dapat mencapai throughput semacam itu, jadi sebagai gantinya, kami akan menyiapkan peringatan untuk memicu jika jumlah pesan melebihi 1000 dalam periode 5 menit. Dalam produksi, Anda dapat mengatur sinyal ke nilai yang lebih signifikan berdasarkan tingkat, edisi, dan jumlah unit hub IoT Anda.

Jumlah total pesan yang digunakan melacak jumlah harian pesan yang digunakan. Metrik ini disetel ulang setiap hari pada pukul 00:00 UTC. Jika Anda melebihi kuota harian melewati ambang batas tertentu, IoT Hub Anda tidak akan lagi menerima pesan. Untuk IoT Hub di tingkat gratis, kuota pesan harian adalah 8000. Kami akan mengatur peringatan untuk memicu jika jumlah total pesan melebihi 4000, 50% dari kuota. Dalam praktiknya, Anda mungkin akan menetapkan persentase ini ke nilai yang lebih tinggi. Nilai kuota harian tergantung pada tingkat, edisi, dan jumlah unit hub IoT Anda.

Untuk informasi selengkapnya tentang kuota dan batas pembatasan dengan IoT Hub, lihat Kuota dan pembatasan.

Untuk menyiapkan lansiran metrik:

  1. Buka hub IoT Anda di portal Azure.

  2. Di bawah Pemantauan, pilih Peringatan. Kemudian pilih Aturan pemberitahuan baru. Buat aturan pemberitahuan panel terbuka.

    Cuplikan layar yang menampilkan panel Buat aturan pemberitahuan.

    Pada panel Buat aturan pemberitahuan, ada empat bagian:

    • Cakupan sudah disetel ke hub IoT Anda, jadi kami akan membiarkan bagian ini saja.
    • Kondisi menyetel sinyal dan kondisi yang akan memicu pemberitahuan.
    • Tindakan mengonfigurasi apa yang terjadi saat pemberitahuan dipicu.
    • Detail aturan pemberitahuan memungkinkan Anda menetapkan nama dan deskripsi pemberitahuan.
  3. Pertama-tama konfigurasikan kondisi yang akan dipicu oleh pemberitahuan.

    1. Di bawah Kondisi, pilih Tambahkan kondisi. Pada panel Konfigurasikan logika sinyal, ketik "telemetri" di kotak telusur dan pilih Pesan telemetri terkirim.

      Cuplikan layar yang menunjukkan pemilihan metrik.

    2. Pada panel Konfigurasikan logika sinyal, setel atau konfirmasikan bidang berikut di bawah Logika pemberitahuan (Anda dapat mengabaikan bagan):

      Ambang: Statis.

      Operator: Lebih besar dari.

      Jenis agregasi: Total.

      Nilai ambang: 1000.

      Perincian agregasi (Periode) : 5 menit.

      Frekuensi evaluasi: Setiap 1 Menit

      Cuplikan layar yang menampilkan setelan kondisi pemberitahuan.

      Pengaturan ini mengatur sinyal ke jumlah total pesan selama 5 menit. Jumlah ini akan dievaluasi setiap menit, dan jika total selama 5 menit sebelumnya melebihi 1000 pesan, pemberitahuan akan dipicu.

      Pilih Selesai untuk menyimpan logika sinyal.

  4. Sekarang konfigurasikan tindakan untuk pemberitahuan.

    1. Kembali ke panel Buat aturan pemberitahuan, di bagian Tindakan, pilih Tambahkan grup tindakan. Pada panel Pilih grup tindakan untuk dilampirkan ke aturan pemberitahuanini, pilih Buat grup tindakan.

    2. Di bawah tab Dasar-dasar pada panel Buat grup tindakan, beri nama dan nama tampilan untuk grup tindakan Anda.

      Cuplikan layar yang menampilkan tab Dasar-dasar dari panel Buat grup tindakan.

    3. Pilih tab Pemberitahuan. Untuk Jenis pemberitahuan, pilih Pesan email/SMS/Push/Suara dari menu tarik-turun. Panel Email/Pesan Teks/Pendorongan/Voice terbuka.

    4. Pada panel Email/Pesan Teks/Pendorongan/Voice, pilih email dan masukkan alamat email Anda, lalu pilih OK.

      Cuplikan layar yang menampilkan setelan alamat email.

    5. Kembali ke panel Pemberitahuan, masukkan nama untuk pemberitahuan tersebut.

      Cuplikan layar menampilkan panel notifikasi yang telah selesai.

    6. (Opsional) Jika Anda memilih tab Tindakan, lalu memilih menu tarik-turun Jenis tindakan, Anda dapat melihat jenis tindakan yang dapat dipicu dengan pemberitahuan. Untuk artikel ini, kami hanya akan menggunakan notifikasi, jadi Anda dapat mengabaikan pengaturan di bawah tab ini.

      Cuplikan layar yang menunjukkan jenis tindakan yang tersedia di panel Tindakan.

    7. Pilih tab Tinjau dan Buat, verifikasi setelan Anda, dan pilih Buat.

      Cuplikan layar menampilkan panel Tinjau dan Buat.

    8. Kembali ke panel Buat aturan pemberitahuan, perhatikan bahwa grup tindakan baru Anda telah ditambahkan ke tindakan untuk pemberitahuan.

  5. Terakhir, konfigurasikan detail aturan pemberitahuan dan simpan aturan pemberitahuan.

    1. Pada panel Buat aturan pemberitahuan, di bawah Detail aturan pemberitahuan, masukkan nama dan deskripsi pemberitahuan Anda; misalnya, "Pemberitahuan jika lebih dari 1000 pesan selama 5 menit". Pastikan Aktifkan aturan pemberitahuan saat pembuatan dicentang. Aturan pemberitahuan lengkap Anda akan terlihat mirip dengan cuplikan layar ini.

      Cuplikan layar menunjukkan selesai Buat panel aturan pemberitahuan.

    2. Pilih Buat aturan pemberitahuan untuk menyimpan aturan baru Anda.

  6. Sekarang siapkan pemberitahuan lain untuk Jumlah total pesan yang digunakan. Metrik ini berguna jika Anda ingin mengirim pemberitahuan ketika jumlah pesan yang digunakan mendekati kuota harian untuk hub IoT, di mana hub IoT akan mulai menolak pesan. Ikuti langkah-langkah yang Anda lakukan sebelumnya, dengan perbedaan berikut.

    • Untuk sinyal pada panel Konfigurasikan logika sinyal, pilih Jumlah total pesan yang digunakan.

    • Pada panel Konfigurasikan logika sinyal, setel atau konfirmasi bidang berikut (Anda dapat mengabaikan bagan):

      Ambang: Statis.

      Operator: Lebih besar dari.

      Jenis agregasi: Maksimum.

      Nilai ambang: 4000.

      Perincian agregasi (Periode) : 1 menit.

      Frekuensi evaluasi: Setiap 1 Menit

      Pengaturan ini mengatur sinyal untuk menyala ketika jumlah pesan mencapai 4000. Metrik dievaluasi setiap menit.

    • Saat Anda menentukan tindakan untuk aturan peringatan Anda, cukup pilih grup tindakan yang Anda buat sebelumnya.

    • Untuk detail pemberitahuan, pilih nama dan deskripsi yang berbeda dari yang Anda lakukan sebelumnya.

  7. Pilih Pemberitahuan, di bagian Pemantauan di panel sebelah kiri hub IoT Anda. Sekarang pilih Kelola aturan pemberitahuan pada menu di bagian atas panel Peringatan. Panel Aturan terbuka. Anda sekarang akan melihat dua pemberitahuan Anda:

    Cuplikan layar yang menampilkan panel Aturan dengan aturan pemberitahuan baru.

  8. Tutup panel Aturan.

Dengan pengaturan ini, peringatan akan dipicu dan Anda akan mendapatkan pemberitahuan email ketika lebih dari 1000 pesan dikirim dalam rentang waktu 5 menit dan juga ketika jumlah total pesan yang digunakan melebihi 4000 (50% dari kuota harian untuk satu IoT hub di tingkat gratis).

Jalankan aplikasi perangkat simulasi

Di bagian Siapkan sumber daya, Anda mendaftarkan identitas perangkat yang akan digunakan untuk melakukan simulasi menggunakan perangkat IoT. Di bagian ini, Anda mengunduh aplikasi konsol .NET yang mensimulasikan perangkat yang mengirim pesan perangkat ke cloud ke Azure IoT Hub, mengonfigurasinya untuk mengirim pesan ini ke hub IoT Anda, lalu menjalankannya.

Penting

Pemberitahuan dapat memakan waktu hingga 10 menit untuk dikonfigurasi dan diaktifkan sepenuhnya oleh IoT Hub. Tunggu setidaknya 10 menit antara waktu Anda mengonfigurasi pemberitahuan terakhir dan menjalankan aplikasi perangkat yang disimulasikan.

Unduh solusi untuk Simulasi Perangkat IoT. Tautan ini mengunduh repo dengan beberapa aplikasi di dalamnya; yang Anda cari ada di iot-hub/Quickstarts/simulated-device/.

  1. Di jendela terminal lokal, navigasikan ke folder akar solusi. Kemudian navigasikan ke folder iot-hub\Quickstarts\simulated-device.

  2. Buka file SimulatedDevice.cs dalam editor teks pilihan Anda.

    1. Ganti nilai variabel s_connectionString ​​dengan string koneksi perangkat yang Anda catat saat menjalankan skrip untuk menyiapkan sumber daya.

    2. Dalam metode SendDeviceToCloudMessagesAsync, ubah Task.Delay dari 1000 menjadi 1, yang mengurangi jumlah waktu antara pengiriman pesan dari 1 detik menjadi 0,001 detik. Memperpendek penundaan ini akan meningkatkan jumlah pesan yang dikirim. (Anda mungkin tidak akan mendapatkan tingkat pesan 100 pesan per detik.)

      await Task.Delay(1);
      
    3. Simpan perubahan Anda ke SimulatedDevice.cs.

  3. Di jendela terminal lokal, jalankan perintah berikut untuk menginstal paket yang diperlukan untuk aplikasi perangkat simulasi:

    dotnet restore
    
  4. Di jendela terminal lokal, jalankan perintah berikut untuk membangun dan menjalankan aplikasi perangkat simulasi:

    dotnet run
    

    Cuplikan layar berikut menunjukkan output saat aplikasi perangkat simulasi mengirim telemetri ke hub IoT Anda:

    Cuplikan layar yang menunjukkan keluaran perangkat yang disimulasikan.

Biarkan aplikasi berjalan setidaknya selama 10-15 menit. Idealnya, biarkan berjalan sampai berhenti mengirim pesan (sekitar 20-30 menit). Ini akan terjadi jika Anda telah melampaui kuota pesan harian untuk hub IoT Anda, dan hub IoT tersebut berhenti menerima pesan lagi.

Catatan

Jika Anda membiarkan aplikasi perangkat berjalan untuk waktu yang lama setelah berhenti mengirim pesan, Anda mungkin mendapatkan pengecualian. Anda dapat dengan aman mengabaikan pengecualian ini dan menutup jendela aplikasi.

Lihat bagan metrik di dasbor Anda

  1. Di pojok kiri atas portal Azure, buka menu portal, lalu pilih Dasbor.

    Cuplikan layar cara memilih dasbor Anda.

  2. Temukan bagan yang Anda sematkan sebelumnya dan klik di mana saja pada ubin di luar data bagan untuk memperluasnya. Hal iIni menunjukkan pesan telemetri yang dikirim dan jumlah total pesan yang digunakan pada grafik. Angka-angka terbaru muncul di bagian bawah grafik. Anda dapat memindahkan kursor pada diagram untuk melihat nilai metrik untuk waktu tertentu. Anda juga dapat mengubah nilai waktu dan perincian di bagian atas bagan untuk mempersempit atau memperluas data ke periode waktu yang diinginkan.

    Cuplikan layar yang menunjukkan bagan metrik.

    Dalam skenario ini, throughput pesan perangkat yang disimulasikan tidak cukup besar untuk menyebabkan IoT Hub membatasi pesannya. Dalam skenario yang benar-benar melibatkan pembatasan, Anda mungkin melihat pesan telemetri yang dikirim melebihi batas pembatasan untuk hub IoT Anda untuk waktu yang terbatas. Ini untuk mengakomodasi lalu lintas yang meledak. Untuk detailnya, lihat pembentukan lalu lintas.

Lihat pemberitahuan

Saat jumlah pesan yang dikirim melebihi batas yang Anda tetapkan dalam aturan pemberitahuan, Anda mulai mendapatkan pemberitahuan email.

Untuk melihat apakah ada pemberitahuan aktif, pilih Pemberitahuan di bawah Pemantauan di panel kiri hub IoT Anda. Panel Pemberitahuan menunjukkan jumlah pemberitahuan yang telah diaktifkan diurutkan menurut tingkat keparahan untuk rentang waktu yang ditentukan.

Cuplikan layar yang menampilkan ringkasan pemberitahuan.

Pilih baris untuk tingkat keparahan Sev 3. Panel Semua Pemberitahuan terbuka dan mencantumkan pemberitahuanSev 3 yang telah diaktifkan.

Cuplikan layar menampilkan panel Semua Pemberitahuan.

Pilih salah satu pemberitahuanuntuk melihat detail pemberitahuan.

Cuplikan layar yang menampilkan detail pemberitahuan.

Periksa kotak masuk Anda untuk email dari Microsoft Azure. Baris subjek akan menjelaskan peringatan yang dipicu. Misalnya, Azure: Activated Severity: 3 Pemberitahuan jika lebih dari 1000 pesan selama 5 menit. Tubuh akan terlihat seperti gambar berikut:

Cuplikan layar email yang menunjukkan pemberitahuan telah diaktifkan.

Lihat Log Azure Monitor

Di bagian Kumpulkan log untuk koneksi dan telemetri perangkat, Anda membuat setelan diagnostik untuk mengirim log sumber daya yang dipancarkan oleh hub IoT Anda untuk koneksi dan operasi telemetri perangkat ke Log Azure Monitor. Di bagian ini, Anda akan menjalankan kueri Kusto terhadap Log Azure Monitor untuk mengamati kesalahan yang terjadi.

  1. Di bawah Pemantauan di panel kiri hub IoT Anda di portal Azure, pilih Log. Tutup jendela Permintaan awal jika terbuka.

  2. Pada panel Kueri Baru, pilih tab Kueri lalu luaskan IoT Hub untuk melihat daftar kueri default.

    Cuplikan layar kueri default IoT Hub.

  3. Pilih kueri Ringkasan kesalahan. Kueri muncul di panel editor kueri. Pilih Jalankan di panel editor dan amati hasil kueri. Luaskan salah satu baris untuk melihat detail.

    Cuplikan layar log yang dikembalikan oleh kueri ringkasan Kesalahan.

    Catatan

    Jika Anda tidak melihat kesalahan apa pun, coba jalankan kueri Perangkat yang baru saja tersambung. Hal ini harus mengembalikan baris untuk perangkat simulasi.

Membersihkan sumber daya

Untuk menghapus semua sumber daya yang Anda buat dalam tutorial ini, hapus grup sumber daya. Tindakan ini menghapus semua sumber daya yang terdapat dalam grup. Dalam hal ini, menghapus hub IoT, ruang kerja Analisis Log, dan grup sumber daya itu sendiri. Jika Anda telah menyematkan bagan metrik ke dasbor, Anda harus menghapusnya secara manual dengan mengeklik tiga titik di sudut kanan atas setiap bagan dan memilih Hapus. Pastikan untuk menyimpan perubahan Anda setelah menghapus grafik.

Untuk menghapus grup sumber daya, gunakan perintah az group delete.

az group delete --name ContosoResources

Langkah berikutnya

Dalam tutorial ini, Anda mempelajari cara menggunakan metrik dan log IoT Hub dengan melakukan tugas-tugas berikut:

  • Gunakan Azure CLI untuk membuat hub IoT, mendaftarkan perangkat simulasi, dan membuat ruang kerja Analisis Log.
  • Kirim koneksi IoT Hub dan log sumber daya telemetri perangkat ke Log Azure Monitor di ruang kerja Log Analytics.
  • Gunakan penjelajah metrik untuk membuat bagan berdasarkan metrik yang dipilih dan menyematkannya ke dasbor Anda.
  • Buat pemberitahuan metrik sehingga Anda dapat diberi tahu melalui email saat kondisi penting terjadi.
  • Unduh dan jalankan aplikasi yang mensimulasikan perangkat IoT yang mengirim pesan ke hub IoT.
  • Lihat peringatan ketika kondisi Anda terjadi.
  • Lihat diagram metrik di dasbor Anda.
  • Lihat kesalahan dan operasi IoT Hub di Log Azure Monitor.

Lanjut ke tutorial berikutnya untuk mempelajari cara mengelola status perangkat IoT.