Memantau referensi data Azure IoT Hub
Untuk mulai menggunakan pemantauan Azure, lihat Memantau Azure IoT Hub untuk memahami cara mengumpulkan dan menganalisis data pemantauan untuk Azure IoT Hub.
Artikel ini adalah referensi untuk menerapkan pemantauan Azure.
Bagian utama dalam artikel referensi ini:
Metrik: daftar metrik platform IoT Hub berdasarkan topik
Dimensi metrik: dimensi untuk perutean dan metrik Event Grid
Log sumber daya: log berdasarkan jenis kategori dan skema yang dikumpulkan untuk Azure IoT Hub
Tabel Log Azure Monitor: membahas tabel Azure Monitor Logs Kusto
Atau, langsung buka Referensi Tabel Log Azure Monitor.
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 menunjukkan metrik platform IoT Hub menurut kategori umum dan metrik daftar berdasarkan nama tampilannya seperti yang ditetapkan dalam portal Azure.
Anda juga dapat menemukan satu tabel yang mencantumkan semua metrik platform IoT Hub menurut nama metrik di bawah Microsoft.Devices/IotHubs dalam dokumentasi Azure Monitor. Tabel ini tidak menyediakan semua informasi, seperti agregasi yang didukung untuk beberapa metrik, tersedia dalam artikel ini.
Untuk mempelajari tentang metrik yang didukung oleh layanan Azure lainnya, lihat Metrik yang didukung dengan Azure Monitor.
Topik di bagian ini
Pilih topik untuk melompat ke informasinya di halaman ini.
- Agregasi yang didukung
- Metrik perintah cloud ke perangkat
- Metrik metode langsung cloud ke perangkat
- Metrik operasi kembar cloud ke perangkat
- Metrik konfigurasi
- Metrik kuota harian
- Metrik perangkat
- Metrik telemetri perangkat
- Metrik operasi kembar perangkat ke cloud
- Metrik Event Grid
- Metrik pekerjaan
- Metrik perutean
- Metrik kueri kembar
Agregasi yang didukung
Kolom Jenis Agregasi di setiap tabel terkait dengan agregasi default yang digunakan saat metrik dipilih untuk bagan atau peringatan.
Untuk sebagian besar metrik, semua jenis agregasi valid; namun, untuk metrik hitungan dengan nilai kolom UnitHitungan, 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 dipancarkan oleh IoT Hub: Jumlah total pesan yang digunakan, Total perangkat, dan Perangkat tersambung. Karena metrik ini menyajikan kuantitas "total" setiap kali dipancarkan, 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 | 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. Termasuk jumlah operasi yang memodifikasi kembar perangkat 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. Nilai kumulatif yang direset ke nol pada pukul 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 | totalDeviceCount | Jumlah | Rata-rata | Jumlah perangkat yang terdaftar di IoT hub Anda | Tidak ada |
Perangkat yang tersambung | 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 dan Perangkat yang tersambung, hanya agregasi minimum, maksimum, dan rata-rata yang valid. Untuk informasi selengkapnya, lihat Agregasi yang didukung.
Total perangkat dan Perangkat tersambung 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 telemetri 'kirim pesan' | 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 Event Grid
Nama Tampilan Metrik | Metrik | Unit | Jenis Agregasi | Deskripsi | Dimensi |
---|---|---|---|---|---|
Pengiriman Event Grid | 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 Azure Event Grid | 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 |
---|---|---|---|---|---|
Pengiriman Perutean (pratinjau) | RoutingDeliveries | Jumlah | Total | 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 Pesan 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 Pengiriman Perutean (pratinjau) | RoutingDeliveryLatency | Milidetik | Rata-rata | 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 Pusat Aktivitas | d2c.endpoints.latency.eventHubs | Milidetik | Rata-rata | Latensi rata-rata (milidetik) antara ingress pesan ke IoT Hub dan ingress pesan ke titik akhir kustom jenis Azure Event Hubs. Rute pesan ke titik akhir bawaan (peristiwa) tidak disertakan. | 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 dikirim ke Pusat Aktivitas | d2c.endpoints.egress.eventHubs | Jumlah | Total | Berapa kali perutean IoT Hub berhasil mengirimkan pesan ke titik akhir kustom jenis Azure Event Hubs. Rute pesan ke titik akhir bawaan (peristiwa) tidak disertakan. | 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 dikirimkan ke rute fallback karena pesan yang dihilangkan tidak terkirim di sana. | 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 tidak valid tidak dicoba ulang. Nilai ini tidak menyertakan percobaan 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 Event Grid-nya.
Nama Dimensi | Deskripsi |
---|---|
EndpointName | Nama titik akhir |
EndpointType | eventHubs, serviceBusQueues, cosmosDB, serviceBusTopics. builtin, atau blobStorage |
EventType | 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 keberhasilan atau kegagalan |
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. Peristiwa dipancarkan hanya untuk kesalahan dalam beberapa kategori.
Topik di bagian ini
- Koneksi
- Telemetri perangkat
- Perintah cloud-ke-perangkat
- Operasi identitas perangkat
- Operasi pengunggahan file
- Rute
- Operasi kembar perangkat-ke-cloud
- Operasi kembar cloud-ke-perangkat
- Kueri kembar
- Operasi pekerjaan
- Metode Langsung
- Pelacakan Terdistribusi (Pratinjau)
- Konfigurasi
- Stream Perangkat (Pratinjau)
Koneksi
Kategori koneksi melacak peristiwa koneksi dan pemutusan perangkat dari hub dan kesalahan IoT. Kategori ini berguna untuk mengidentifikasi upaya koneksi yang tidak sah dan atau memperingatkan ketika Anda kehilangan koneksi ke perangkat.
Untuk status koneksi perangkat yang andal, lihat Memantau status koneksi 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 berjalan 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 saat 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 mencakup kesalahan spesifik tentang pesan itu sendiri (seperti kesalahan pembatasan perangkat), yang dilaporkan dalam 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 kembar, 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).
Sesuai correlationId
dengan proposal Konteks Jejak W3C , di mana ia berisi trace-id
dan 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 sebagai 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 saat pesan yang berisi properti pelacakan yang valid menulis ke Azure Event Hubs 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
- Lihat Memantau Azure IoT Hub untuk deskripsi pemantauan Azure IoT Hub.
- Lihat Memantau sumber daya Azure dengan Azure Monitor untuk detail tentang memantau sumber daya Azure.