Memantau referensi data Azure IoT Hub

Lihat Memantau Azure IoT Hub untuk detail tentang mengumpulkan dan menganalisis data pemantauan untuk Azure IoT Hub.

Metrik

Bagian ini mencantumkan semua metrik platform yang dikumpulkan secara otomatis untuk Azure IoT Hub. Namespace penyedia sumber daya untuk metrik IoT Hub adalah Microsoft.Devices dan jenis Namespace adalah IoTHubs.

Subbagian berikut ini membagi metrik platform IoT Hub berdasarkan kategori umum dan mencantumkannya dengan nama tampilan yang muncul di portal Microsoft Azure. Informasi juga disediakan relevan dengan metrik yang muncul di setiap subbagian.

Anda juga dapat menemukan satu tabel yang mencantumkan semua metrik platform IoT Hub menurut nama metrik pada Microsoft.Devices/IotHubs dalam dokumentasi Azure Monitor. Perhatikan bahwa tabel ini tidak menyediakan beberapa informasi, seperti agregasi yang didukung untuk beberapa metrik, yang tersedia di artikel ini.

Untuk mempelajari tentang metrik yang didukung oleh layanan Azure lainnya, lihat Metrik yang didukung dengan Azure Monitor.

Topik di bagian ini

Agregasi yang didukung

Kolom Jenis Agregasi di setiap tabel terkait dengan agregasi default yang digunakan saat metrik dipilih untuk bagan atau peringatan.

Screenshot showing aggregation for metrics

Untuk sebagian besar metrik, semua jenis agregasi valid; namun, untuk metrik jumlah, metrik dengan nilai kolom UnitJumlah, hanya beberapa agregasi yang valid. Metrik jumlah bisa berupa salah satu dari dua jenis:

  • Untuk metrik jumlah Titik-tunggal, IoT Hub mendaftarkan satu titik data -- pada dasarnya 1 -- setiap kali operasi yang diukur terjadi. Azure Monitor kemudian menjumlahkan titik data ini melalui granularitas yang ditentukan. Contoh metrik Titik-tunggal adalah Pesan telemetri yang dikirim dan Pengiriman pesan C2D yang diselesaikan. Untuk metrik ini, satu-satunya jenis agregasi yang relevan adalah Total (Jumlah). Portal ini memungkinkan Anda memilih minimum, maksimum, dan rata-rata; namun, nilai-nilai ini akan selalu 1.

  • Untuk metrik jumlah Rekam jepret, IoT Hub mendaftarkan jumlah total saat operasi yang diukur terjadi. Saat ini, ada tiga metrik Rekam jepret yang dikirimkan oleh IoT Hub: Jumlah total pesan yang digunakan, Total perangkat (pratinjau) , dan Perangkat yang terhubung (pratinjau) . Karena metrik ini menyajikan jumlah "total" setiap kali dikirimkan, menjumlahkannya di atas granularitas yang ditentukan tidak masuk akal. Azure Monitor membatasi Anda untuk memilih rata-rata, minimum, dan maksimum untuk jenis agregasi untuk metrik ini.

Metrik perintah cloud ke perangkat

Nama Tampilan Metrik Metrik Unit Jenis agregasi Deskripsi Dimensi
Pesan C2D Kedaluwarsa (pratinjau) C2DMessagesExpired Jumlah Total Jumlah pesan cloud-ke-perangkat yang kedaluwarsa Tidak ada
Pengiriman pesan C2D yang diselesaikan c2d.commands.egress.complete.success Jumlah Total Jumlah pengiriman pesan cloud-ke-perangkat yang berhasil diselesaikan oleh perangkat Tidak ada
Pesan C2D yang ditinggalkan c2d.commands.egress.abandon.success Jumlah Total Jumlah pesan cloud-ke-perangkat yang ditinggalkan oleh perangkat Tidak ada
Pesan C2D yang ditolak c2d.commands.egress.reject.success Jumlah Total Jumlah pesan cloud-ke-perangkat yang ditolak oleh perangkat Tidak ada

Untuk metrik dengan nilai UnitJumlah, hanya agregasi total (jumlah) yang valid. Agregasi minimum, maksimum, dan rata-rata selalu mengembalikan 1. Untuk informasi selengkapnya, lihat Agregasi yang didukung.

Metrik metode langsung cloud ke perangkat

Nama Tampilan Metrik Metrik Unit Jenis agregasi Deskripsi Dimensi
Invokasi metode langsung yang gagal c2d.methods.failure Jumlah Total Jumlah semua panggilan metode langsung yang gagal. Tidak ada
Ukuran permintaan invokasi metode langsung c2d.methods.requestSize Byte Rata-rata Jumlah semua permintaan metode langsung yang berhasil. Tidak ada
Ukuran respons invokasi metode langsung c2d.methods.responseSize Byte Rata-rata Jumlah semua respons metode langsung yang berhasil. Tidak ada
Invokasi metode langsung yang berhasil c2d.methods.success Jumlah Total Jumlah semua panggilan metode langsung yang berhasil. Tidak ada

Untuk metrik dengan nilai UnitJumlah hanya agregasi total (jumlah) yang valid. Agregasi minimum, maksimum, dan rata-rata selalu mengembalikan 1. Untuk informasi selengkapnya, lihat Agregasi yang didukung.

Metrik operasi kembar cloud ke perangkat

Nama Tampilan Metrik Metrik Unit Jenis agregasi Deskripsi Dimensi
Pembacaan kembar yang gagal dari backend c2d.twin.read.failure Jumlah Total Jumlah semua pembacaan kembar yang gagal yang dimulai dari backend. Tidak ada
Pembaruan kembar yang gagal dari backend c2d.twin.update.failure Jumlah Total Jumlah semua pembaruan kembar gagal yang dimulai dari backend. Tidak ada
Ukuran respons pembacaan kembar dari backend c2d.twin.read.size Byte Rata-rata Jumlah semua pembacaan kembar yang berhasil yang dimulai dari backend. Tidak ada
Ukuran pembaruan kembar dari backend c2d.twin.update.size Byte Rata-rata Jumlah total semua pembaruan kembar yang berhasil yang dimulai dari backend. Tidak ada
Pembacaan kembar yang berhasil dari backend c2d.twin.read.success Jumlah Total Jumlah semua pembacaan kembar yang berhasil yang dimulai dari backend. Tidak ada
Pembaruan kembar yang berhasil dari backend c2d.twin.update.success Jumlah Total Jumlah semua pembaruan kembar yang berhasil yang dimulai dari backend. Tidak ada

Untuk metrik dengan nilai UnitJumlah, hanya agregasi total (jumlah) yang valid. Agregasi minimum, maksimum, dan rata-rata selalu mengembalikan 1. Untuk informasi selengkapnya, lihat Agregasi yang didukung.

Metrik konfigurasi

Nama Tampilan Metrik Metrik Unit Jenis agregasi Deskripsi Dimensi
Metrik Konfigurasi konfigurasi Jumlah Total Jumlah total operasi CRUD yang dilakukan untuk konfigurasi perangkat dan penyebaran IoT Edge, pada serangkaian perangkat target. Ini juga termasuk jumlah operasi yang memodifikasi perangkat kembar atau modul kembar karena konfigurasi ini. Tidak ada

Untuk metrik dengan nilai UnitJumlah, hanya agregasi total (jumlah) yang valid. Agregasi minimum, maksimum, dan rata-rata selalu mengembalikan 1. Untuk informasi selengkapnya, lihat Agregasi yang didukung.

Metrik kuota harian

Nama Tampilan Metrik Metrik Unit Jenis agregasi Deskripsi Dimensi
Total penggunaan data perangkat deviceDataUsage Byte Total Byte ditransfer ke dan dari perangkat apa pun yang terhubung ke IotHub Tidak ada
Total penggunaan data perangkat (pratinjau) deviceDataUsageV2 Byte Total Byte ditransfer ke dan dari perangkat apa pun yang terhubung ke IotHub Tidak ada
Total jumlah pesan yang digunakan dailyMessageQuotaUsed Jumlah Rata-rata Jumlah total pesan yang digunakan hari ini. Ini adalah nilai kumulatif yang diatur ulang ke nol pada 00.00 UTC setiap hari. Tidak ada

Untuk Jumlah total pesan yang digunakan, hanya agregasi minimum, maksimum, dan rata-rata yang didukung. Untuk informasi selengkapnya, lihat Agregasi yang didukung.

Metrik perangkat

Nama Tampilan Metrik Metrik Unit Jenis agregasi Deskripsi Dimensi
Total perangkat (tidak digunakan lagi) devices.totalDevices Jumlah Total Jumlah perangkat yang terdaftar di IoT hub Anda Tidak ada
Perangkat yang terhubung (tidak digunakan lagi) devices.connectedDevices.allProtocol Jumlah Total Jumlah perangkat yang tersambung ke IoT hub Anda Tidak ada
Total perangkat (pratinjau) totalDeviceCount Jumlah Rata-rata Jumlah perangkat yang terdaftar di IoT hub Anda Tidak ada
Perangkat yang terhubung (pratinjau) connectedDeviceCount Jumlah Rata-rata Jumlah perangkat yang tersambung ke IoT hub Anda Tidak ada

Untuk Total perangkat (tidak digunakan lagi) dan Perangkat yang terhubung (tidak digunakan lagi) , hanya agregasi total (jumlah) yang valid. Agregasi minimum, maksimum, dan rata-rata selalu mengembalikan 1. Untuk informasi selengkapnya, lihat Agregasi yang didukung.

Untuk total perangkat (pratinjau) dan perangkat Tersambung (pratinjau), hanya agregasi minimum, maksimum, dan rata-rata yang valid. Untuk informasi selengkapnya, lihat Agregasi yang didukung.

Perangkat yang terhubung (pratinjau) dan Total perangkat (pratinjau) tidak dapat diekspor melalui pengaturan diagnostik.

Metrik telemetri perangkat

Nama Tampilan Metrik Metrik Unit Jenis agregasi Deskripsi Dimensi
Jumlah kesalahan pembatasan d2c.telemetry.ingress.sendThrottle Jumlah Total Jumlah kesalahan pembatasan karena pembatasan throughput perangkat Tidak ada
Upaya pengiriman pesan telemetri d2c.telemetry.ingress.allProtocol Jumlah Total Jumlah pesan telemetri perangkat ke cloud yang mencoba dikirim ke hub IoT Anda Tidak ada
Pesan telemetri terkirim d2c.telemetry.ingress.success Jumlah Total Jumlah pesan telemetri perangkat ke cloud yang berhasil dikirim ke hub IoT Anda Tidak ada

Untuk metrik dengan nilai UnitJumlah, hanya agregasi total (jumlah) yang valid. Agregasi minimum, maksimum, dan rata-rata selalu mengembalikan 1. Untuk informasi selengkapnya, lihat Agregasi yang didukung.

Metrik operasi kembar perangkat ke cloud

Nama Tampilan Metrik Metrik Unit Jenis agregasi Deskripsi Dimensi
Pembacaan kembar yang gagal dari perangkat d2c.twin.read.failure Jumlah Total Jumlah semua pembacaan kembar yang dimulai perangkat yang gagal. Tidak ada
Pembaruan kembar yang gagal dari perangkat d2c.twin.update.failure Jumlah Total Jumlah semua pembaruan kembar yang dimulai perangkat yang gagal. Tidak ada
Ukuran respons pembacaan kembar dari perangkat d2c.twin.read.size Byte Rata-rata Jumlah semua pembacaan kembar yang berhasil yang dimulai perangkat. Tidak ada
Ukuran pembaruan kembar dari perangkat d2c.twin.update.size Byte Rata-rata Jumlah total semua pembaruan kembar yang dimulai perangkat yang berhasil. Tidak ada
Pembacaan kembar yang berhasil dari perangkat d2c.twin.read.success Jumlah Total Jumlah semua pembacaan kembar yang berhasil yang dimulai perangkat. Tidak ada
Pembaruan kembar yang berhasil dari perangkat d2c.twin.update.success Jumlah Total Jumlah semua pembaruan kembar yang dimulai perangkat yang berhasil. Tidak ada

Untuk metrik dengan nilai UnitJumlah, hanya agregasi total (jumlah) yang valid. Agregasi minimum, maksimum, dan rata-rata selalu mengembalikan 1. Untuk informasi selengkapnya, lihat Agregasi yang didukung.

Metrik kisi peristiwa

Nama Tampilan Metrik Metrik Unit Jenis agregasi Deskripsi Dimensi
Pengiriman Event Grid (pratinjau) EventGridDeliveries Jumlah Total Jumlah peristiwa IoT Hub yang dipublikasikan ke Event Grid. Gunakan dimensi Hasil untuk jumlah permintaan yang berhasil dan gagal. Dimensi EventType memperlihatkan jenis peristiwa (https://aka.ms/ioteventgrid). Hasil,
EventType
Untuk informasi selengkapnya, lihat Dimensi metrik .
Latensi Event Grid (pratinjau) EventGridLatency Milidetik Rata-rata Latensi rata-rata (milidetik) dari saat peristiwa Iot Hub dihasilkan hingga kapan peristiwa dipublikasikan ke Event Grid. Angka ini merupakan rata-rata di antara semua jenis peristiwa. Gunakan dimensi EventType untuk melihat latensi jenis peristiwa tertentu. EventType
Untuk informasi selengkapnya, lihat Dimensi metrik .

Untuk metrik dengan nilai UnitJumlah, hanya agregasi total (jumlah) yang valid. Agregasi minimum, maksimum, dan rata-rata selalu mengembalikan 1. Untuk informasi selengkapnya, lihat Agregasi yang didukung.

Metrik pekerjaan

Nama Tampilan Metrik Metrik Unit Jenis agregasi Deskripsi Dimensi
Pekerjaan yang diselesaikan jobs.completed Jumlah Total Jumlah semua pekerjaan yang diselesaikan. Tidak ada
Panggilan untuk mencantumkan pekerjaan yang gagal jobs.listJobs.failure Jumlah Total Jumlah semua panggilan yang gagal untuk mencantumkan pekerjaan. Tidak ada
Pembuatan pekerjaan invokasi metode yang gagal jobs.createDirectMethodJob.failure Jumlah Total Jumlah semua pekerjaan pemanggilan metode langsung yang gagal dibuat. Tidak ada
Pembuatan pekerjaan pembaruan kembar yang gagal jobs.createTwinUpdateJob.failure Jumlah Total Jumlah semua pembuatan pekerjaan pembaruan kembar yang gagal. Tidak ada
Pembatalan pekerjaan yang gagal jobs.cancelJob.failure Jumlah Total Jumlah semua panggilan gagal untuk membatalkan pekerjaan. Tidak ada
Kueri pekerjaan yang gagal jobs.queryJobs.failure Jumlah Total Jumlah semua panggilan gagal untuk mengkueri pekerjaan. Tidak ada
Pekerjaan gagal jobs.failed Jumlah Total Jumlah semua pekerjaan yang gagal. Tidak ada
Panggilan yang berhasil untuk mencantumkan tugas jobs.listJobs.success Jumlah Total Jumlah semua panggilan yang berhasil untuk mencantumkan pekerjaan. Tidak ada
Pembuatan pekerjaan invokasi metode yang berhasil jobs.createDirectMethodJob.success Jumlah Total Jumlah semua pekerjaan pemanggilan metode langsung yang berhasil dibuat. Tidak ada
Pembuatan pekerjaan pembaruan kembar yang berhasil jobs.createTwinUpdateJob.
success
Jumlah Total Jumlah semua pekerjaan pembaruan kembar yang berhasil dibuat. Tidak ada
Pembatalan pekerjaan yang berhasil jobs.cancelJob.success Jumlah Total Jumlah semua panggilan yang berhasil untuk membatalkan pekerjaan. Tidak ada
Kueri pekerjaan yang berhasil jobs.queryJobs.success Jumlah Total Jumlah semua panggilan yang berhasil untuk meminta pekerjaan. Tidak ada

Untuk metrik dengan nilai UnitJumlah, hanya agregasi total (jumlah) yang valid. Agregasi minimum, maksimum, dan rata-rata selalu mengembalikan 1. Untuk informasi selengkapnya, lihat Agregasi yang didukung.

Metrik perutean

Nama Tampilan Metrik Metrik Unit Jenis agregasi Deskripsi Dimensi
Upaya Pengiriman Perutean (pratinjau) RoutingDeliveries Jumlah Total Ini adalah metrik pengiriman perutean. Gunakan dimensi untuk mengidentifikasi status pengiriman untuk titik akhir tertentu atau untuk sumber perutean tertentu. Hasil,
RoutingSource,
EndpointType,
FailureReasonCategory,
EndpointName
Untuk informasi selengkapnya, lihat Dimensi metrik .
Ukuran Data Pengiriman Perutean dalam Byte (pratinjau) RoutingDataSizeInBytesDelivered Byte Total Jumlah total byte yang dirutekan oleh IoT Hub ke titik akhir kustom dan titik akhir bawaan. Gunakan dimensi untuk mengidentifikasi ukuran data yang dirutekan ke titik akhir tertentu atau untuk sumber perutean tertentu. RoutingSource,
EndpointType
EndpointName
Untuk informasi selengkapnya, lihat Dimensi metrik .
Latensi Perutean (pratinjau) RoutingDeliveryLatency Milidetik Rata-rata Ini adalah metrik latensi pengiriman perutean. Gunakan dimensi untuk mengidentifikasi latensi untuk titik akhir tertentu atau untuk sumber perutean tertentu. RoutingSource,
EndpointType,
EndpointName
Untuk informasi selengkapnya, lihat Dimensi metrik .
Perutean: blob yang dikirim ke penyimpanan d2c.endpoints.egress.storage.blobs Jumlah Total Frekuensi perutean IoT Hub mengirimkan blob ke titik akhir penyimpanan. Tidak ada
Perutean: data yang dikirim ke penyimpanan d2c.endpoints.egress.storage.bytes Byte Total Jumlah perutean Azure IoT Hub data (byte) yang dikirimkan ke titik akhir penyimpanan. Tidak ada
Perutean: latensi pesan untuk Hub Aktivitas d2c.endpoints.latency.eventHubs Milidetik Rata-rata Latensi rata-rata (milidetik) antara pesan masuk ke IoT Hub dan pesan masuk ke titik akhir Pusat Aktivitas. Ini tidak termasuk rute pesan ke titik akhir (peristiwa) bawaan. Tidak ada
Perutean: latensi pesan untuk Antrean Azure Service Bus d2c.endpoints.latency.serviceBusQueues Milidetik Rata-rata Latensi rata-rata (milidetik) antara pesan masuk ke IoT Hub dan pesan masuk ke titik akhir antrean Azure Service Bus. Tidak ada
Perutean: latensi pesan untuk Topik Azure Service Bus d2c.endpoints.latency.serviceBusTopics Milidetik Rata-rata Latensi rata-rata (milidetik) antara pesan masuk ke IoT Hub dan pesan masuk ke titik akhir topik Azure Service Bus. Tidak ada
Perutean: latensi pesan untuk pesan/peristiwa d2c.endpoints.latency.builtIn.events Milidetik Rata-rata Latensi rata-rata (milidetik) antara pesan masuk ke IoT Hub dan pesan masuk ke titik akhir bawaan (pesan/aktivitas) dan rute fallback. Tidak ada
Perutean: latensi pesan untuk penyimpanan d2c.endpoints.latency.storage Milidetik Rata-rata Latensi rata-rata (milidetik) antara pesan masuk ke IoT Hub dan pesan masuk ke titik akhir penyimpanan. Tidak ada
Perutean: pesan yang dikirim ke Pusat Aktivitas d2c.endpoints.egress.eventHubs Jumlah Total Frekuensi perutean IoT Hub berhasil mengirimkan pesan ke titik akhir Pusat Aktivitas. Ini tidak termasuk rute pesan ke titik akhir (peristiwa) bawaan. Tidak ada
Perutean: pesan yang dikirim ke Antrean Azure Service Bus d2c.endpoints.egress.serviceBusQueues Jumlah Total Frekuensi perutean IoT Hub berhasil mengirimkan pesan ke titik akhir antrean Azure Service Bus. Tidak ada
Perutean: pesan yang dikirim ke Topik Azure Service Bus d2c.endpoints.egress.serviceBusTopics Jumlah Total Frekuensii perutean IoT Hub berhasil mengirimkan pesan ke titik akhir topik Azure Service Bus. Tidak ada
Perutean: pesan yang dikirim ke fallback d2c.telemetry.egress.fallback Jumlah Total Frekuensi perutean IoT Hub mengirimkan pesan ke titik akhir yang terkait dengan rute fallback. Tidak ada
Perutean: pesan yang dikirim ke pesan/peristiwa d2c.endpoints.egress.builtIn.events Jumlah Total Frekuensi perutean IoT Hub berhasil mengirimkan pesan ke titik akhir bawaan (pesan/aktivitas) dan rute fallback. Tidak ada
Perutean: pesan yang dikirim ke penyimpanan d2c.endpoints.egress.storage Jumlah Total Frekuensi perutean IoT Hub berhasil mengirimkan pesan ke titik akhir penyimpanan. Tidak ada
Perutean: pesan telemetri terkirim d2c.telemetry.egress.success Jumlah Total Frekuensi pesan berhasil dikirim ke semua titik akhir menggunakan perutean IoT Hub. Jika pesan dirutekan ke beberapa titik akhir, nilai ini akan bertambah satu per satu untuk setiap pengiriman yang berhasil. Jika pesan dikirim ke titik akhir yang sama beberapa kali, nilai ini akan bertambah satu per satu untuk setiap pengiriman yang berhasil. Tidak ada
Perutean: pesan telemetri yang dibuang d2c.telemetry.egress.dropped Jumlah Total Frekuensi pesan dihilangkan oleh perutean IoT Hub karena titik akhir buntu. Nilai ini tidak menghitung pesan yang dikirim ke rute fallback karena pesan yang dihilangkan tidak dikirim ke rute tersebut. Tidak ada
Perutean: pesan telemetri yang tidak kompatibel d2c.telemetry.egress.invalid Jumlah Total Frekuensi perutean IoT Hub gagal mengirimkan pesan karena ketidakcocokan dengan titik akhir. Pesan tidak kompatibel dengan titik akhir saat Hub Iot mencoba mengirimkan pesan ke titik akhir dan gagal dengan kesalahan yang tidak sementara. Pesan yang tidak valid tidak dicoba ulang. Nilai ini tidak termasuk mencoba ulang. Tidak ada
Perutean: pesan telemetri tanpa induk d2c.telemetry.egress.orphaned Jumlah Total Frekuensi pesan berstatus tanpa induk oleh perutean IoT Hub karena tidak cocok dengan kueri perutean apa pun, jika rute fallback dinonaktifkan. Tidak ada

Untuk metrik dengan nilai UnitJumlah, hanya agregasi total (jumlah) yang valid. Agregasi minimum, maksimum, dan rata-rata selalu mengembalikan 1. Untuk informasi selengkapnya, lihat Agregasi yang didukung.

Metrik kueri kembar

Nama Tampilan Metrik Metrik Unit Jenis agregasi Deskripsi Dimensi
Permintaan kembar gagal twinQueries.failure Jumlah Total Jumlah semua permintaan kembar yang gagal. Tidak ada
Permintaan kembar yang berhasil twinQueries.success Jumlah Total Jumlah semua permintaan kembar yang berhasil. Tidak ada
Ukuran hasil permintaan kembar twinQueries.resultSize Byte Rata-rata Total ukuran hasil dari semua kueri kembar yang berhasil. Tidak ada

Untuk metrik dengan nilai UnitJumlah, hanya agregasi total (jumlah) yang valid. Agregasi minimum, maksimum, dan rata-rata selalu mengembalikan 1. Untuk informasi selengkapnya, lihat Agregasi yang didukung.

Dimensi metrik

Azure IoT Hub memiliki dimensi berikut yang terkait dengan beberapa metrik perutean dan kisi peristiwanya.

Nama Dimensi Deskripsi
EndpointName Nama titik akhir.
EndpointType Salah satu yang berikut: eventHubs, serviceBusQueues, cosmosDB, serviceBusTopics. builtin, atau blobStorage.
EventType Salah satu jenis peristiwa Kisi Peristiwa berikut: Microsoft.Devices.DeviceCreated. Microsoft.Devices.DeviceDeleted, Microsoft.Devices.DeviceConnected, Microsoft.Devices.DeviceDisconnected, atau Microsoft.Devices.DeviceTelemetry. Untuk informasi selengkapnya, lihat Jenis peristiwa.
FailureReasonCategory Salah satu hal berikut: tidak valid, dijatuhkan, tanpa induk, atau null.
Hasil Baik berhasil maupun gagal.
RoutingSource Pesan Perangkat
Peristiwa Perubahan Kembar
Peristiwa Siklus Hidup Perangkat

Untuk mempelajari selengkapnya tentang dimensi metrik, lihat Metrik multi-dimensi.

Log sumber daya

Bagian ini mencantumkan semua jenis dan kategori log sumber daya dan skema yang dikumpulkan untuk Azure IoT Hub. Penyedia sumber daya dan jenis untuk semua log Hub IoT adalah Microsoft.Devices/IotHubs. Pahami bahwa kejadian dipancarkan hanya untuk kesalahan dalam beberapa kategori.

Topik di bagian ini

Koneksi

Kategori koneksi melacak aktivitas sambungkan dan putuskan sambungan perangkat dari hub IoT serta kesalahan. Kategori ini berguna untuk mengidentifikasi upaya koneksi yang tidak sah dan atau memperingatkan ketika Anda kehilangan koneksi ke perangkat.

Catatan

Untuk status koneksi perangkat yang andal, periksa Heartbeat perangkat.

{
   "records":
   [
        {
            "time": " UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "deviceConnect",
            "category": "Connections",
            "level": "Information",
            "properties": "{\"deviceId\":\"<deviceId>\",\"sdkVersion\":\"<sdkVersion>\",\"protocol\":\"<protocol>\",\"authType\":\"{\\\"scope\\\":\\\"device\\\",\\\"type\\\":\\\"sas\\\",\\\"issuer\\\":\\\"iothub\\\",\\\"acceptingIpFilterRule\\\":null}\",\"maskedIpAddress\":\"<maskedIpAddress>\"}",
            "location": "Resource location"
        }
    ]
}

Untuk informasi terperinci tentang menggunakan log koneksi untuk memantau konektivitas perangkat, lihat Memantau, mendiagnosis, dan memecahkan masalah konektivitas perangkat ke Azure IoT Hub.

Telemetri perangkat

Kategori telemetri perangkat melacak kesalahan yang terjadi di IoT hub dan terkait dengan alur telemetri. Kategori ini mencakup kesalahan yang terjadi saat mengirim peristiwa telemetri (seperti pembatasan) dan menerima peristiwa telemetri (seperti pembaca yang tidak sah). Kategori ini tidak dapat menangkap kesalahan yang disebabkan oleh kode yang dijalankan pada perangkat itu sendiri.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "ingress",
            "category": "DeviceTelemetry",
            "level": "Error",
            "resultType": "Event status",
            "resultDescription": "MessageDescription",
            "properties": "{\"deviceId\":\"<deviceId>\",\"batching\":\"0\",\"messageSizeInBytes\":\"<messageSizeInBytes>\",\"EventProcessedUtcTime\":\"<UTC timestamp>\",\"EventEnqueuedUtcTime\":\"<UTC timestamp>\",\"partitionId\":\"1\"}", 
            "location": "Resource location"
        }
    ]
}

Perintah cloud-ke-perangkat

Kategori perintah cloud-ke-perangkat melacak kesalahan yang terjadi di IoT hub dan terkait dengan alur pesan cloud-ke-perangkat. Kategori ini mencakup kesalahan yang timbul dari:

  • Mengirim pesan cloud-ke-perangkat (seperti kesalahan pengirim yang tidak sah),
  • Menerima pesan cloud-ke-perangkat (seperti jumlah pengiriman melebihi kesalahan), dan
  • Menerima umpan balik pesan cloud-ke-perangkat (seperti umpan balik yang kedaluwarsa).

Kategori ini tidak menangkap kesalahan ketika pesan cloud-ke-perangkat berhasil dikirimkan tetapi kemudian ditangani dengan tidak benar oleh perangkat.

{
    "records":
    [
        {
            "time": " UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "messageExpired",
            "category": "C2DCommands",
            "level": "Error",
            "resultType": "Event status",
            "resultDescription": "MessageDescription",
            "properties": "{\"deviceId\":\"<deviceId>\",\"messageId\":\"<messageId>\",\"messageSizeInBytes\":\"<messageSize>\",\"protocol\":\"Amqp\",\"deliveryAcknowledgement\":\"<None, NegativeOnly, PositiveOnly, Full>\",\"deliveryCount\":\"0\",\"expiryTime\":\"<timestamp>\",\"timeInSystem\":\"<timeInSystem>\",\"ttl\":<ttl>, \"EventProcessedUtcTime\":\"<UTC timestamp>\",\"EventEnqueuedUtcTime\":\"<UTC timestamp>\", \"maskedIpAddress\": \"<maskedIpAddress>\", \"statusCode\": \"4XX\"}",
            "location": "Resource location"
        }
    ]
}

Operasi identitas perangkat

Kategori operasi identitas perangkat melacak kesalahan yang terjadi saat Anda mencoba membuat, memperbarui, atau menghapus entri di registri identitas IoT hub Anda. Melacak kategori ini berguna untuk memprovisi skenario.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "get",
            "category": "DeviceIdentityOperations",
            "level": "Error",
            "resultType": "Event status",
            "resultDescription": "MessageDescription",
            "properties": "{\"maskedIpAddress\":\"<maskedIpAddress>\",\"deviceId\":\"<deviceId>\", \"statusCode\":\"4XX\"}",
            "location": "Resource location"
        }
    ]
}

Operasi pengunggahan file

Kategori pengunggahan file melacak kesalahan yang terjadi di IoT hub dan terkait dengan fungsionalitas pengunggahan file. Kategori ini meliputi:

  • Kesalahan yang terjadi pada URI SAS, seperti saat URI SAS kedaluwarsa sebelum perangkat memberi tahu hub bahwa pengunggahan selesai.

  • Pengunggahan gagal yang dilaporkan oleh perangkat.

  • Kesalahan yang terjadi jika file tidak ditemukan di penyimpanan selama pembuatan pesan pemberitahuan IoT Hub.

Kategori ini tidak dapat menangkap kesalahan yang langsung terjadi saat perangkat mengunggah file ke penyimpanan.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "ingress",
            "category": "FileUploadOperations",
            "level": "Error",
            "resultType": "Event status",
            "resultDescription": "MessageDescription",
            "durationMs": "1",
            "properties": "{\"deviceId\":\"<deviceId>\",\"protocol\":\"<protocol>\",\"authType\":\"{\\\"scope\\\":\\\"device\\\",\\\"type\\\":\\\"sas\\\",\\\"issuer\\\":\\\"iothub\\\",\\\"acceptingIpFilterRule\\\":null}\",\"blobUri\":\"http//bloburi.com\"}",
            "location": "Resource location"
        }
    ]
}

Rute

Kategori perutean pesan melacak kesalahan yang terjadi selama evaluasi rute pesan dan kesehatan titik akhir seperti yang diterima oleh IoT Hub. Kategori ini mencakup peristiwa seperti:

  • Aturan mengevaluasi ke "tidak terdefinisi",
  • IoT Hub menandai titik akhir sebagai mati, atau
  • Kesalahan apa pun yang diterima dari titik akhir.

Kategori ini tidak menyertakan kesalahan spesifik tentang pesan itu sendiri (seperti kesalahan pembatasan perangkat), yang dilaporkan pada kategori "telemetri perangkat".

{
    "records":
    [
        {
            "time":"2019-12-12T03:25:14Z",
            "resourceId":"/SUBSCRIPTIONS/91R34780-3DEC-123A-BE2A-213B5500DFF0/RESOURCEGROUPS/ANON-TEST/PROVIDERS/MICROSOFT.DEVICES/IOTHUBS/ANONHUB1",
            "operationName":"endpointUnhealthy",
            "category":"Routes",
            "level":"Error",
            "resultType":"403004",
            "resultDescription":"DeviceMaximumQueueDepthExceeded",
            "properties":"{\"deviceId\":null,\"endpointName\":\"anon-sb-1\",\"messageId\":null,\"details\":\"DeviceMaximumQueueDepthExceeded\",\"routeName\":null,\"statusCode\":\"403\"}",
            "location":"westus"
        }
    ]
}

Berikut adalah detail selengkapnya tentang log perutean sumber daya:

Operasi kembar perangkat-ke-cloud

Kategori operasi kembar perangkat-ke-cloud melacak peristiwa yang dimulai perangkat pada kembaran perangkat. Operasi ini dapat mencakup mendapatkan kembaran, memperbarui properti yang dilaporkan, dan berlangganan properti yang diinginkan.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "update",
            "category": "D2CTwinOperations",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"deviceId\":\"<deviceId>\",\"protocol\":\"<protocol>\",\"authenticationType\":\"{\\\"scope\\\":\\\"device\\\",\\\"type\\\":\\\"sas\\\",\\\"issuer\\\":\\\"iothub\\\",\\\"acceptingIpFilterRule\\\":null}\"}",
            "location": "Resource location"
        }
    ]
}

Operasi kembar cloud-ke-perangkat

Kategori operasi kembar cloud-ke-perangkat melacak peristiwa yang dimulai perangkat pada kembaran perangkat. Operasi ini dapat mencakup dapatkan kembaran, perbarui atau ganti tag, dan perbarui atau ganti properti yang diinginkan.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "read",
            "category": "C2DTwinOperations",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"deviceId\":\"<deviceId>\",\"sdkVersion\":\"<sdkVersion>\",\"messageSize\":\"<messageSize>\"}",
            "location": "Resource location"
        }
    ]
}

Kueri kembar

Kategori kueri kembar melaporkan tentang permintaan kueri untuk kembaran perangkat yang dimulai di cloud.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "query",
            "category": "TwinQueries",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"query\":\"<twin query>\",\"sdkVersion\":\"<sdkVersion>\",\"messageSize\":\"<messageSize>\",\"pageSize\":\"<pageSize>\", \"continuation\":\"<true, false>\", \"resultSize\":\"<resultSize>\"}",
            "location": "Resource location"
        }
    ]
}

Operasi pekerjaan

Kategori operasi pekerjaan melaporkan permintaan pekerjaan untuk memperbarui kembaran perangkat atau memanggil metode langsung di beberapa perangkat. Permintaan ini dimulai di cloud.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "jobCompleted",
            "category": "JobsOperations",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"jobId\":\"<jobId>\", \"sdkVersion\": \"<sdkVersion>\",\"messageSize\": <messageSize>,\"filter\":\"DeviceId IN ['1414ded9-b445-414d-89b9-e48e8c6285d5']\",\"startTimeUtc\":\"Wednesday, September 13, 2017\",\"duration\":\"0\"}",
            "location": "Resource location"
        }
    ]
}

Metode Langsung

Kategori metode langsung melacak interaksi respons-permintaan yang dikirim ke masing-masing perangkat. Permintaan ini dimulai di cloud.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "send",
            "category": "DirectMethods",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"deviceId\":<messageSize>, \"RequestSize\": 1, \"ResponseSize\": 1, \"sdkVersion\": \"2017-07-11\"}",
            "location": "Resource location"
        }
    ]
}

Pelacakan Terdistribusi (Pratinjau)

Kategori pelacakan terdistribusi melacak ID korelasi untuk pesan yang membawa header konteks pelacakan. Untuk sepenuhnya mengaktifkan log ini, kode sisi klien harus diperbarui dengan mengikuti Menganalisis dan mendiagnosis aplikasi IoT ujung-ke-ujung dengan pelacakan terdistribusi IoT Hub (pratinjau).

Perhatikan bahwa correlationId sesuai dengan proposal W3C Trace Context, yang berisi trace-id maupun span-id.

Log IoT Hub D2C (perangkat-ke-cloud)

IoT Hub merekam log ini ketika pesan yang berisi properti jejak yang valid tiba di IoT Hub.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "DiagnosticIoTHubD2C",
            "category": "DistributedTracing",
            "correlationId": "00-8cd869a412459a25f5b4f31311223344-0144d2590aacd909-01",
            "level": "Information",
            "resultType": "Success",
            "resultDescription":"Receive message success",
            "durationMs": "",
            "properties": "{\"messageSize\": 1, \"deviceId\":\"<deviceId>\", \"callerLocalTimeUtc\": : \"2017-02-22T03:27:28.633Z\", \"calleeLocalTimeUtc\": \"2017-02-22T03:27:28.687Z\"}",
            "location": "Resource location"
        }
    ]
}

Di sini, durationMs tidak dihitung karena jam IoT Hub mungkin tidak sinkron dengan jam perangkat, dan dengan demikian perhitungan durasi dapat menyesatkan. Sebaiknya tulis logika menggunakan cap waktu di bagian properties tersebut untuk menangkap lonjakan latensi perangkat-ke-cloud.

Properti Jenis Deskripsi
messageSize Bilangan bulat Ukuran pesan perangkat-ke-cloud dalam byte
deviceId Untai karakter alfanumerik ASCII 7-bit Identitas perangkat
callerLocalTimeUtc Cap waktu UTC Waktu pembuatan pesan seperti yang dilaporkan oleh jam lokal perangkat
calleeLocalTimeUtc Cap waktu UTC Waktu kedatangan pesan di gateway IoT Hub seperti dilaporkan oleh jam sisi layanan IoT Hub

Log masuk IoT Hub

IoT Hub merekam log ini ketika pesan yang berisi properti jejak yang valid menulis ke Pusat Peristiwa internal atau bawaan.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "DiagnosticIoTHubIngress",
            "category": "DistributedTracing",
            "correlationId": "00-8cd869a412459a25f5b4f31311223344-349810a9bbd28730-01",
            "level": "Information",
            "resultType": "Success",
            "resultDescription":"Ingress message success",
            "durationMs": "10",
            "properties": "{\"isRoutingEnabled\": \"true\", \"parentSpanId\":\"0144d2590aacd909\"}",
            "location": "Resource location"
        }
    ]
}

Di bagian properties tersebut, log ini berisi informasi tambahan tentang masuknya pesan.

Properti Jenis Deskripsi
isRoutingEnabled Untai (karakter) Nilainya true atau fakse, menunjukkan apakah perutean pesan diaktifkan atau tidak di IoT Hub
parentSpanId Untai (karakter) Span-id pesan induk, yang akan menjadi jejak pesan D2C dalam kasus ini

Log keluar IoT Hub

IoT Hub merekam log ini jika perutean diaktifkan dan pesan ditulis ke titik akhir. Jika perutean tidak diaktifkan, IoT Hub tidak merekam log ini.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "DiagnosticIoTHubEgress",
            "category": "DistributedTracing",
            "correlationId": "00-8cd869a412459a25f5b4f31311223344-98ac3578922acd26-01",
            "level": "Information",
            "resultType": "Success",
            "resultDescription":"Egress message success",
            "durationMs": "10",
            "properties": "{\"endpointType\": \"EventHub\", \"endpointName\": \"myEventHub\", \"parentSpanId\":\"349810a9bbd28730\"}",
            "location": "Resource location"
        }
    ]
}

Di bagian properties tersebut, log ini berisi informasi tambahan tentang masuknya pesan.

Properti Jenis Deskripsi
endpointName Untai (karakter) Nama titik akhir perutean
endpointType Untai (karakter) Jenis titik akhir perutean
parentSpanId Untai (karakter) Span-id pesan induk, yang akan menjadi jejak pesan masuk IoT Hub dalam kasus ini

Konfigurasi

Log konfigurasi IoT Hub melacak peristiwa dan kesalahan untuk kumpulan fitur Manajemen Perangkat Otomatis.

{
    "records":
    [
         {
             "time": "2019-09-24T17:21:52Z",
             "resourceId": "Resource Id",
             "operationName": "ReadManyConfigurations",
             "category": "Configurations",
             "resultType": "",
             "resultDescription": "",
             "level": "Information",
             "durationMs": "17",
             "properties": "{\"configurationId\":\"\",\"sdkVersion\":\"2018-06-30\",\"messageSize\":\"0\",\"statusCode\":null}",
             "location": "southcentralus"
         }
    ]
}

Stream Perangkat (Pratinjau)

Kategori stream perangkat melacak interaksi permintaan-respons yang dikirim ke masing-masing perangkat.

{
    "records":
    [
         {
             "time": "2019-09-19T11:12:04Z",
             "resourceId": "Resource Id",
             "operationName": "invoke",
             "category": "DeviceStreams",
             "resultType": "",
             "resultDescription": "",    
             "level": "Information",
             "durationMs": "74",
             "properties": "{\"deviceId\":\"myDevice\",\"moduleId\":\"myModule\",\"sdkVersion\":\"2019-05-01-preview\",\"requestSize\":\"3\",\"responseSize\":\"5\",\"statusCode\":null,\"requestName\":\"myRequest\",\"direction\":\"c2d\"}",
             "location": "Central US"
         }
    ]
}

Tabel log Azure Monitor

Bagian ini merujuk ke semua tabel Kusto Log Azure Monitor yang relevan dengan Azure IoT Hub dan tersedia untuk kueri oleh Log Analytics. Untuk daftar tabel dan tautan ke informasi selengkapnya untuk jenis sumber daya Hub IoT, lihat IoT Hub dalam referensi tabel Log Azure Monitor.

Untuk referensi semua tabel Log Azure Monitor / Log Analytics, lihat Referensi Tabel Log Azure Monitor.

Lihat juga