İzleme Azure IoT Hub veri başvurusu

  • Makale

Azure izlemeyi kullanmaya başlamak için Azure IoT Hub için izleme verilerinin nasıl toplanıp analiz edildiğini anlamak için bkz. İzleme Azure IoT Hub.

Bu makale, Azure izlemeyi uygulamaya yönelik bir başvurudur.

Bu başvuru makalesindeki ana bölümler:

Ölçümler

Bu bölümde, Azure IoT Hub için otomatik olarak toplanan tüm platform ölçümleri listelenir. IoT Hub ölçümler için kaynak sağlayıcısı ad alanı Microsoft.Devices, Ad Alanı türü ise IoTHubs'dır.

Aşağıdaki alt bölümler, genel kategoriye göre IoT Hub platform ölçümlerini gösterir ve ölçümleri Azure portal atanan görünen adlarına göre listeler.

Azure İzleyici belgelerindeki Microsoft.Devices/IotHubs altında tüm IoT Hub platform ölçümlerini ölçüm adına göre listeleyen tek bir tablo da bulabilirsiniz. Bu tabloda, bu makaledeki bazı ölçümler için desteklenen toplamalar gibi tüm bilgiler sağlanmamaktadır.

Diğer Azure hizmetleri tarafından desteklenen ölçümler hakkında bilgi edinmek için bkz. Azure İzleyici ile desteklenen ölçümler.

Bu bölümdeki konular

Bu sayfadaki bilgilerine atlamak için bir konu seçin.

Desteklenen toplamalar

Her tablodaki Toplama Türü sütunu, bir grafik veya uyarı için ölçüm seçildiğinde kullanılan varsayılan toplamaya karşılık gelir.

Ölçümler için toplamayı gösteren ekran görüntüsü

Çoğu ölçüm için tüm toplama türleri geçerlidir; ancak, Birim sütun değeri Count olan sayım ölçümleri için yalnızca bazı toplamalar geçerlidir. Sayım ölçümleri iki türden biri olabilir:

  • Tek noktalı sayı ölçümleri için IoT Hub ölçülen işlem her gerçekleştiğinde tek bir veri noktasını (temelde 1) kaydeder. Azure İzleyici daha sonra bu veri noktalarını belirtilen ayrıntı düzeyi üzerinde toplar. Tek noktalı ölçümlere örnek olarak gönderilen telemetri iletileri ve tamamlanan C2D ileti teslimleri verilebilir. Bu ölçümler için tek ilgili toplama türü Toplam (Toplam) olur. Portal minimum, maksimum ve ortalamayı seçmenize olanak tanır; ancak, bu değerler her zaman 1 olur.

  • Anlık görüntü sayısı ölçümleri için IoT Hub ölçülen işlem gerçekleştiğinde toplam sayıyı kaydeder. Şu anda, IoT Hub tarafından gösterilen üç Anlık Görüntü ölçümü vardır: Kullanılan toplam ileti sayısı, Toplam cihaz ve Bağlı cihaz sayısı. Bu ölçümler her gönderilişinde bir "toplam" miktar sunduğundan, bunları belirtilen ayrıntı düzeyi üzerinde toplamak mantıklı değildir. Azure İzleyici, bu ölçümler için toplama türü için ortalama, en düşük ve en yüksek değerleri seçmenizi sınırlar.

Buluttan cihaza komut ölçümleri

Ölçüm Görünen Adı Ölçüm Birim Toplama Türü Açıklama Boyutlar
C2D İletilerinin Süresi Doldu C2DMessagesExpired Count Toplam Süresi dolan buluttan cihaza ileti sayısı Hiçbiri
C2D ileti teslimleri tamamlandı c2d.commands.egress.complete.success Count Toplam Cihazda başarıyla tamamlanan buluttan cihaza ileti teslimlerinin sayısı Hiçbiri
Bırakılan C2D iletileri c2d.commands.egress.abandon.success Count Toplam Cihaz tarafından bırakılan buluttan cihaza ileti sayısı Hiçbiri
Reddedilen C2D iletileri c2d.commands.egress.reject.success Count Toplam Cihaz tarafından reddedilen buluttan cihaza ileti sayısı Hiçbiri

Birim değeri Sayı olan ölçümler için yalnızca toplam (toplam) toplama geçerlidir. Minimum, maksimum ve ortalama toplamalar her zaman 1 döndürür. Daha fazla bilgi için bkz . Desteklenen toplamalar.

Buluttan cihaza doğrudan yöntemler ölçümleri

Ölçüm Görünen Adı Ölçüm Birim Toplama Türü Açıklama Boyutlar
Başarısız doğrudan yöntem çağrıları c2d.methods.failure Count Toplam Tüm başarısız doğrudan yöntem çağrılarının sayısı. Hiçbiri
Doğrudan yöntem çağrılarının istek boyutu c2d.methods.requestSize Bayt Ortalama Tüm başarılı doğrudan yöntem isteklerinin sayısı. Hiçbiri
Doğrudan yöntem çağrılarının yanıt boyutu c2d.methods.responseSize Bayt Ortalama Tüm başarılı doğrudan yöntem yanıtlarının sayısı. Hiçbiri
Başarılı doğrudan yöntem çağrıları c2d.methods.success Count Toplam Tüm başarılı doğrudan yöntem çağrılarının sayısı. Hiçbiri

Birim değeri Sayı olan ölçümler için yalnızca toplam (toplam) toplama geçerlidir. Minimum, maksimum ve ortalama toplamalar her zaman 1 döndürür. Daha fazla bilgi için bkz . Desteklenen toplamalar.

Buluttan cihaza ikizi işlem ölçümleri

Ölçüm Görünen Adı Ölçüm Birim Toplama Türü Açıklama Boyutlar
Arka uçtan başarısız ikiz okumaları c2d.twin.read.failure Count Toplam Başarısız arka uç tarafından başlatılan tüm ikiz okumalarının sayısı. Hiçbiri
Arka uçtan başarısız ikiz güncelleştirmeleri c2d.twin.update.failure Count Toplam Başarısız arka uç tarafından başlatılan tüm ikiz güncelleştirmelerinin sayısı. Hiçbiri
Arka uçtan ikiz okumalarının yanıt boyutu c2d.twin.read.size Bayt Ortalama Başarılı arka uç tarafından başlatılan tüm ikiz okumalarının sayısı. Hiçbiri
Arka uçtan ikiz güncelleştirmelerinin boyutu c2d.twin.update.size Bayt Ortalama Başarılı arka uç tarafından başlatılan tüm ikiz güncelleştirmelerinin toplam boyutu. Hiçbiri
Arka uçtan başarılı ikiz okumaları c2d.twin.read.success Count Toplam Başarılı arka uç tarafından başlatılan tüm ikiz okumalarının sayısı. Hiçbiri
Arka uçtan başarılı ikiz güncelleştirmeleri c2d.twin.update.success Count Toplam Başarılı arka uç tarafından başlatılan tüm ikiz güncelleştirmelerinin sayısı. Hiçbiri

Birim değeri Count olan ölçümler için yalnızca toplam (toplam) toplama geçerlidir. Minimum, maksimum ve ortalama toplamalar her zaman 1 döndürür. Daha fazla bilgi için bkz . Desteklenen toplamalar.

Yapılandırma ölçümleri

Ölçüm Görünen Adı Ölçüm Birim Toplama Türü Açıklama Boyutlar
Yapılandırma Ölçümleri Yapılandırma Count Toplam Bir hedef cihaz kümesinde cihaz yapılandırması ve IoT Edge dağıtımı için gerçekleştirilen toplam CRUD işlemlerinin sayısı. Bu yapılandırmalar nedeniyle cihaz ikizini veya modül ikizini değiştiren işlemlerin sayısı dahildir. Hiçbiri

Birim değeri Count olan ölçümler için yalnızca toplam (toplam) toplama geçerlidir. Minimum, maksimum ve ortalama toplamalar her zaman 1 döndürür. Daha fazla bilgi için bkz . Desteklenen toplamalar.

Günlük kota ölçümleri

Ölçüm Görünen Adı Ölçüm Birim Toplama Türü Açıklama Boyutlar
Toplam cihaz veri kullanımı deviceDataUsage Bayt Toplam IotHub'a bağlı tüm cihazlara ve cihazlardan aktarılan bayt sayısı Hiçbiri
Toplam cihaz veri kullanımı (önizleme) deviceDataUsageV2 Bayt Toplam IotHub'a bağlı tüm cihazlara ve cihazlardan aktarılan bayt sayısı Hiçbiri
Kullanılan toplam ileti sayısı dailyMessageQuotaUsed Count Ortalama Bugün kullanılan toplam ileti sayısı. Her gün saat 00:00 UTC'de sıfıra sıfırlanır bir kümülatif değer. Hiçbiri

Kullanılan toplam ileti sayısı için yalnızca en düşük, en yüksek ve ortalama toplamalar desteklenir. Daha fazla bilgi için bkz . Desteklenen toplamalar.

Cihaz ölçümleri

Ölçüm Görünen Adı Ölçüm Birim Toplama Türü Açıklama Boyutlar
Toplam cihaz sayısı (kullanım dışı) devices.totalDevices Count Toplam IoT hub'ınıza kayıtlı cihaz sayısı Hiçbiri
Bağlı cihazlar (kullanım dışı) devices.connectedDevices.allProtocol Count Toplam IoT hub'ınıza bağlı cihaz sayısı Hiçbiri
Toplam cihaz sayısı totalDeviceCount Count Ortalama IoT hub'ınıza kayıtlı cihaz sayısı Hiçbiri
Bağlı cihazlar connectedDeviceCount Count Ortalama IoT hub'ınıza bağlı cihaz sayısı Hiçbiri

Toplam cihaz sayısı (kullanım dışı) ve Bağlı cihazlar (kullanım dışı) için yalnızca toplam (toplam) toplama geçerlidir. Minimum, maksimum ve ortalama toplamalar her zaman 1 döndürür. Daha fazla bilgi için bkz . Desteklenen toplamalar.

Toplam cihaz sayısı ve Bağlı cihazlar için yalnızca en düşük, en yüksek ve ortalama toplamalar geçerlidir. Daha fazla bilgi için bkz . Desteklenen toplamalar.

Toplam cihaz ve Bağlı cihazlar tanılama ayarları aracılığıyla dışarı aktarılamaz.

Cihaz telemetri ölçümleri

Ölçüm Görünen Adı Ölçüm Birim Toplama Türü Açıklama Boyutlar
Azaltma hatası sayısı d2c.telemetry.ingress.sendThrottle Count Toplam Cihaz aktarım hızı azaltmalarından kaynaklanan azaltma hatalarının sayısı Hiçbiri
Telemetri 'ileti gönderme' denemeleri d2c.telemetry.ingress.allProtocol Count Toplam IoT hub'ınıza gönderilmeye çalışılacak cihazdan buluta telemetri iletilerinin sayısı Hiçbiri
Gönderilen telemetri iletileri d2c.telemetry.ingress.success Count Toplam IoT hub'ınıza başarıyla gönderilen cihazdan buluta telemetri iletilerinin sayısı Hiçbiri

Birim değeri Count olan ölçümler için yalnızca toplam (toplam) toplama geçerlidir. Minimum, maksimum ve ortalama toplamalar her zaman 1 döndürür. Daha fazla bilgi için bkz . Desteklenen toplamalar.

Cihazdan buluta ikiz işlemleri ölçümleri

Ölçüm Görünen Adı Ölçüm Birim Toplama Türü Açıklama Boyutlar
Cihazlardan başarısız ikiz okumaları d2c.twin.read.failure Count Toplam Cihaz tarafından başlatılan tüm ikiz okumalarının sayısı. Hiçbiri
Cihazlardan başarısız ikiz güncelleştirmeleri d2c.twin.update.failure Count Toplam Cihaz tarafından başlatılan tüm başarısız ikiz güncelleştirmelerinin sayısı. Hiçbiri
Cihazlardan ikiz okumalarının yanıt boyutu d2c.twin.read.size Bayt Ortalama Cihaz tarafından başlatılan tüm başarılı ikiz okumalarının sayısı. Hiçbiri
Cihazlardan ikiz güncelleştirmelerinin boyutu d2c.twin.update.size Bayt Ortalama Tüm başarılı cihaz tarafından başlatılan ikiz güncelleştirmelerinin toplam boyutu. Hiçbiri
Cihazlardan başarılı ikiz okumaları d2c.twin.read.success Count Toplam Cihaz tarafından başlatılan tüm başarılı ikiz okumalarının sayısı. Hiçbiri
Cihazlardan başarılı ikiz güncelleştirmeleri d2c.twin.update.success Count Toplam Cihaz tarafından başlatılan tüm başarılı ikiz güncelleştirmelerinin sayısı. Hiçbiri

Birim değeri Sayı olan ölçümler için yalnızca toplam (toplam) toplama geçerlidir. Minimum, maksimum ve ortalama toplamalar her zaman 1 döndürür. Daha fazla bilgi için bkz . Desteklenen toplamalar.

Event Grid ölçümleri

Ölçüm Görünen Adı Ölçüm Birim Toplama Türü Açıklama Boyutlar
Event Grid teslimleri EventGridDeliveries Count Toplam Event Grid'de yayımlanan IoT Hub olay sayısı. Başarılı ve başarısız isteklerin sayısı için Sonuç boyutunu kullanın. EventType boyutu olayın türünü (https://aka.ms/ioteventgrid) gösterir. Sonuç,
Olay türü
Daha fazla bilgi için bkz . Ölçüm boyutları.
Event Grid gecikme süresi EventGridLatency Milisaniye Ortalama Iot Hub olayının oluşturulmasından olayın Event Grid'de yayımlanmasına kadar olan ortalama gecikme süresi (milisaniye). Bu sayı, tüm olay türleri arasındaki ortalamadır. Belirli bir olay türünün gecikme süresini görmek için EventType boyutunu kullanın. Olay türü
Daha fazla bilgi için bkz . Ölçüm boyutları.

Birim değeri Sayı olan ölçümler için yalnızca toplam (toplam) toplama geçerlidir. Minimum, maksimum ve ortalama toplamalar her zaman 1 döndürür. Daha fazla bilgi için bkz . Desteklenen toplamalar.

İşler ölçümleri

Ölçüm Görünen Adı Ölçüm Birim Toplama Türü Açıklama Boyutlar
Tamamlanan işler jobs.completed Count Toplam Tamamlanan tüm işlerin sayısı. Hiçbiri
Liste işlerine başarısız çağrılar jobs.listJobs.failure Count Toplam Liste işlerine yapılan tüm başarısız çağrıların sayısı. Hiçbiri
Yöntem çağırma işlerinin başarısız oluşturmaları jobs.createDirectMethodJob.failure Count Toplam Doğrudan yöntem çağırma işlerinin tüm başarısız oluşturma işleminin sayısı. Hiçbiri
İkiz güncelleştirme işlerinin başarısız oluşturma işlemleri jobs.createTwinUpdateJob.failure Count Toplam İkiz güncelleştirme işlerinin tüm başarısız oluşturma işleminin sayısı. Hiçbiri
Başarısız iş iptalleri jobs.cancelJob.failure Count Toplam bir işi iptal etmek için yapılan tüm başarısız çağrıların sayısı. Hiçbiri
Başarısız iş sorguları jobs.queryJobs.failure Count Toplam Sorgu işlerine yapılan tüm başarısız çağrıların sayısı. Hiçbiri
Başarısız işler jobs.failed Count Toplam Tüm başarısız işlerin sayısı. Hiçbiri
Liste işlerine başarılı çağrılar jobs.listJobs.success Count Toplam Liste işlerine yapılan tüm başarılı çağrıların sayısı. Hiçbiri
Yöntem çağırma işlerinin başarılı bir şekilde oluşturulması jobs.createDirectMethodJob.success Count Toplam Doğrudan yöntem çağırma işlerinin başarılı bir şekilde oluşturulmasının sayısı. Hiçbiri
İkiz güncelleştirme işlerinin başarılı bir şekilde oluşturulması jobs.createTwinUpdateJob.
başarılı		 Count Toplam İkiz güncelleştirme işlerinin başarılı bir şekilde oluşturulmasının sayısı. Hiçbiri
Başarılı iş iptalleri jobs.cancelJob.success Count Toplam bir işi iptal etmek için yapılan tüm başarılı çağrıların sayısı. Hiçbiri
Başarılı iş sorguları jobs.queryJobs.success Count Toplam Sorgu işlerine yapılan tüm başarılı çağrıların sayısı. Hiçbiri

Birim değeri Sayı olan ölçümler için yalnızca toplam (toplam) toplama geçerlidir. Minimum, maksimum ve ortalama toplamalar her zaman 1 döndürür. Daha fazla bilgi için bkz . Desteklenen toplamalar.

Yönlendirme ölçümleri

Ölçüm Görünen Adı Ölçüm Birim Toplama Türü Açıklama Boyutlar
Yönlendirme Teslimleri (önizleme) RoutingDeliveries Count Toplam Yönlendirme teslim ölçümü. Belirli bir uç noktanın veya belirli bir yönlendirme kaynağının teslim durumunu belirlemek için boyutları kullanın. Sonuç,
RoutingSource,
EndpointType,
FailureReasonCategory,
EndpointName
Daha fazla bilgi için bkz . Ölçüm boyutları.
Teslim İletisi Boyutunu Bayt Cinsinden Yönlendirme (önizleme) RoutingDataSizeInBytesDelivered Bayt Toplam IoT Hub tarafından özel uç noktaya ve yerleşik uç noktaya yönlendirilen toplam bayt sayısı. Belirli bir uç noktaya veya belirli bir yönlendirme kaynağına yönlendirilen veri boyutunu tanımlamak için boyutları kullanın. RoutingSource,
EndpointType
EndpointName
Daha fazla bilgi için bkz . Ölçüm boyutları.
Yönlendirme Teslimi Gecikme Süresi (önizleme) RoutingDeliveryLatency Milisaniye Ortalama Yönlendirme teslimi gecikme süresi ölçümü. Belirli bir uç noktanın veya belirli bir yönlendirme kaynağının gecikme süresini belirlemek için boyutları kullanın. RoutingSource,
EndpointType,
EndpointName
Daha fazla bilgi için bkz . Ölçüm boyutları.
Yönlendirme: Bloblar depolamaya teslim edildi d2c.endpoints.egress.storage.blobs Count Toplam Blobları depolama uç noktalarına yönlendirme IoT Hub sayısı. Hiçbiri
Yönlendirme: depolamaya teslim edilen veriler d2c.endpoints.egress.storage.bytes Bayt Toplam Depolama uç noktalarına teslim edilen yönlendirme IoT Hub veri miktarı (bayt). Hiçbiri
Yönlendirme: Event Hubs için ileti gecikme süresi d2c.endpoints.latency.eventHubs Milisaniye Ortalama event hubs türündeki özel uç noktalara ileti girişi ile IoT Hub arasındaki ortalama gecikme süresi (milisaniye). Yerleşik uç noktaya (olaylar) ileti yolları dahil değildir. Hiçbiri
Yönlendirme: Service Bus Kuyruğu için ileti gecikme süresi d2c.endpoints.latency.serviceBusQueues Milisaniye Ortalama service Bus kuyruğu uç noktasına ileti girişi ile IoT Hub arasındaki ortalama gecikme süresi (milisaniye). Hiçbiri
Yönlendirme: Service Bus Konusu için ileti gecikme süresi d2c.endpoints.latency.serviceBusTopics Milisaniye Ortalama service Bus konu uç noktasına ileti girişi ile IoT Hub ileti girişi arasındaki ortalama gecikme süresi (milisaniye). Hiçbiri
Yönlendirme: iletiler/olaylar için ileti gecikme süresi d2c.endpoints.latency.builtIn.events Milisaniye Ortalama yerleşik uç noktaya (iletiler/olaylar) ve geri dönüş yoluna ileti girişi ile IoT Hub arasındaki ortalama gecikme süresi (milisaniye). Hiçbiri
Yönlendirme: depolama için ileti gecikme süresi d2c.endpoints.latency.storage Milisaniye Ortalama depolama uç noktasına ileti girişi ile IoT Hub arasındaki ortalama gecikme süresi (milisaniye). Hiçbiri
Yönlendirme: Event Hubs'a teslim edilen iletiler d2c.endpoints.egress.eventHubs Count Toplam IoT Hub iletileri Event Hubs türündeki özel uç noktalara başarıyla yönlendirme sayısı. Yerleşik uç noktaya (olaylar) ileti yolları dahil değildir. Hiçbiri
Yönlendirme: Service Bus Kuyruğuna teslim edilen iletiler d2c.endpoints.egress.serviceBusQueues Count Toplam IoT Hub başarıyla teslim edilen iletileri Service Bus kuyruğu uç noktalarına yönlendirme sayısı. Hiçbiri
Yönlendirme: Service Bus Konusuna teslim edilen iletiler d2c.endpoints.egress.serviceBusTopics Count Toplam Service Bus konu uç noktalarına başarıyla teslim edilen iletileri yönlendirme IoT Hub sayısı. Hiçbiri
Yönlendirme: geri dönüşe teslim edilen iletiler d2c.telemetry.egress.fallback Count Toplam Teslim edilen iletileri geri dönüş yolu ile ilişkili uç noktaya yönlendirme IoT Hub sayısı. Hiçbiri
Yönlendirme: iletilere/olaylara teslim edilen iletiler d2c.endpoints.egress.builtIn.events Count Toplam İletileri yerleşik uç noktaya (iletiler/olaylar) ve geri dönüş yoluna yönlendirmenin başarılı IoT Hub sayısı. Hiçbiri
Yönlendirme: depolamaya teslim edilen iletiler d2c.endpoints.egress.storage Count Toplam IoT Hub başarıyla teslim edilen iletileri depolama uç noktalarına yönlendirme sayısı. Hiçbiri
Yönlendirme: telemetri iletileri teslim edildi d2c.telemetry.egress.success Count Toplam İletilerin IoT Hub yönlendirme kullanılarak tüm uç noktalara başarıyla teslim edilen sayısı. bir ileti birden çok uç noktaya yönlendirilirse, bu değer her başarılı teslim için bir artar. Bir ileti aynı uç noktaya birden çok kez teslim edilirse, her başarılı teslim için bu değer bir artar. Hiçbiri
Yönlendirme: bırakılan telemetri iletileri d2c.telemetry.egress.dropped Count Toplam Geçersiz uç noktalar nedeniyle IoT Hub yönlendirme tarafından iletilerin bırakılma sayısı. Bırakılan iletiler oraya teslim edilmemiş olduğundan bu değer geri dönüş yoluna teslim edilen iletileri saymıyor. Hiçbiri
Yönlendirme: telemetri iletileri uyumsuz d2c.telemetry.egress.invalid Count Toplam Uç noktayla uyumsuzluk nedeniyle IoT Hub yönlendirmenin iletileri teslim etme sayısı. Iot Hub iletiyi bir uç noktaya teslim etmeye çalıştığında ve geçici olmayan bir hatayla başarısız olduğunda ileti uç noktayla uyumsuzdur. Geçersiz iletiler yeniden denenmiyor. Bu değer yeniden denemeleri içermez. Hiçbiri
Yönlendirme: yalnız bırakılmış telemetri iletileri d2c.telemetry.egress.orphaned Count Toplam Geri dönüş yolu devre dışı bırakıldığında, hiçbir yönlendirme sorgusuyla eşleşmedikleri için iletilerin IoT Hub yönlendirme tarafından yalnız bırakılma sayısı. Hiçbiri

Birim değeri Count olan ölçümler için yalnızca toplam (toplam) toplama geçerlidir. Minimum, maksimum ve ortalama toplamalar her zaman 1 döndürür. Daha fazla bilgi için bkz . Desteklenen toplamalar.

İkiz sorgu ölçümleri

Ölçüm Görünen Adı Ölçüm Birim Toplama Türü Açıklama Boyutlar
Başarısız ikiz sorguları twinQueries.failure Count Toplam Tüm başarısız ikiz sorgularının sayısı. Hiçbiri
Başarılı ikiz sorguları twinQueries.success Count Toplam Tüm başarılı ikiz sorgularının sayısı. Hiçbiri
İkiz sorguları sonuç boyutu twinQueries.resultSize Bayt Ortalama Tüm başarılı ikiz sorgularının sonuç boyutunun toplamı. Hiçbiri

Birim değeri Sayı olan ölçümler için yalnızca toplam (toplam) toplama geçerlidir. Minimum, maksimum ve ortalama toplamalar her zaman 1 döndürür. Daha fazla bilgi için bkz . Desteklenen toplamalar.

Ölçüm boyutları

Azure IoT Hub yönlendirme ve Event Grid ölçümlerinden bazılarıyla ilişkilendirilmiş aşağıdaki boyutlara sahiptir.

Boyut Adı Açıklama
EndpointName Uç nokta adı
EndpointType eventHubs, serviceBusQueues, cosmosDB, serviceBusTopics. builtin veya blobStorage
Eventtype Microsoft.Devices.DeviceCreated. Microsoft.Devices.DeviceDeleted, Microsoft.Devices.DeviceConnected, Microsoft.Devices.DeviceDisconnected veya Microsoft.Devices.DeviceTelemetry
Daha fazla bilgi için bkz . Olay türleri.
FailureReasonCategory Aşağıdakilerden biri: geçersiz, bırakılan, yalnız bırakılmış veya null.
Sonuç Başarı veya başarısızlık
RoutingSource Cihaz İletileri
İkiz Değişiklik Olayları
Cihaz Yaşam Döngüsü Olayları

Ölçüm boyutları hakkında daha fazla bilgi edinmek için bkz. Çok boyutlu ölçümler.

Kaynak günlükleri

Bu bölümde, Azure IoT Hub için toplanan tüm kaynak günlüğü kategorisi türleri ve şemaları listelenir. Tüm IoT Hub günlükleri için kaynak sağlayıcısı ve türü Microsoft.Devices/IotHubs'dır. Olaylar yalnızca bazı kategorilerdeki hatalar için yayılır.

Bu bölümdeki konular

Bağlantılar

Bağlantılar kategorisi, ioT hub'ından cihaz bağlantısı ve bağlantısını kesme olaylarını ve hataları izler. Bu kategori, yetkisiz bağlantı girişimlerini tanımlamak ve cihazlara bağlantıyı kaybettiğinde uyarı vermek için kullanışlıdır.

Cihazların güvenilir bağlantı durumu için bkz. Cihaz bağlantı durumunu izleme.

{
   "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"
        }
    ]
}

Cihaz bağlantısını izlemek için bağlantı günlüklerini kullanma hakkında ayrıntılı bilgi için bkz. Azure IoT Hub cihaz bağlantısını izleme, tanılama ve sorunlarını giderme.

Cihaz telemetrisi

Cihaz telemetri kategorisi IoT hub'ında oluşan hataları izler ve telemetri işlem hattıyla ilişkilidir. Bu kategori, telemetri olayları gönderirken (azaltma gibi) ve telemetri olaylarını alırken (yetkisiz okuyucu gibi) oluşan hataları içerir. Bu kategori, cihazın kendisinde çalışan kodun neden olduğu hataları yakalayamaz.

{
    "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"
        }
    ]
}

Buluttan cihaza komutlar

Buluttan cihaza komutlar kategorisi IoT hub'ında oluşan hataları izler ve buluttan cihaza ileti işlem hattıyla ilişkilidir. Bu kategori şunlardan oluşan hataları içerir:

  • Buluttan cihaza iletiler gönderme (yetkisiz gönderen hataları gibi),
  • Buluttan cihaza iletileri alma (teslim sayısı aşıldı hataları gibi) ve
  • Buluttan cihaza ileti geri bildirimi alma (geri bildirim süresi dolmuş hatalar gibi).

Bu kategori, buluttan cihaza ileti başarıyla teslim edildiğinde ancak cihaz tarafından yanlış işlendiğinde hata yakalamaz.

{
    "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"
        }
    ]
}

Cihaz kimliği işlemleri

Cihaz kimliği işlemleri kategorisi, IoT hub'ınızın kimlik kayıt defterinde bir girdi oluşturmaya, güncelleştirmeye veya silmeye çalıştığınızda oluşan hataları izler. Bu kategoriyi izlemek, sağlama senaryoları için yararlıdır.

{
    "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"
        }
    ]
}

Dosya karşıya yükleme işlemleri

Dosya karşıya yükleme kategorisi, IoT hub'ında oluşan hataları izler ve dosya yükleme işleviyle ilgilidir. Bu kategori şunları içerir:

  • SAS URI'siyle oluşan hatalar, örneğin bir cihazın tamamlanan karşıya yüklemenin hub'ına bildirimde bulunmasından önce süresinin dolması gibi hatalar.

  • Cihaz tarafından bildirilen başarısız karşıya yüklemeler.

  • IoT Hub bildirim iletisi oluşturma sırasında depolamada bir dosya bulunamadığında oluşan hatalar.

Bu kategori, cihaz depolama alanına dosya yüklerken doğrudan oluşan hataları yakalayamaz.

{
    "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"
        }
    ]
}

Yollar

İleti yönlendirme kategorisi, IoT Hub tarafından algılanan ileti yolu değerlendirmesi ve uç nokta durumu sırasında oluşan hataları izler. Bu kategori aşağıdaki gibi olayları içerir:

  • Bir kural "tanımsız" olarak değerlendirilir,
  • IoT Hub uç noktayı ölü olarak işaretler veya
  • Uç noktadan alınan tüm hatalar.

Bu kategori, "cihaz telemetrisi" kategorisi altında bildirilen iletilerin kendisi hakkında belirli hatalar (cihaz azaltma hataları gibi) içermez.

{
    "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"
        }
    ]
}

Kaynak günlüklerini yönlendirmeyle ilgili diğer ayrıntılar şunlardır:

Cihazdan buluta ikiz işlemleri

Cihazdan buluta ikiz işlemleri kategorisi, cihaz ikizlerinde cihaz tarafından başlatılan olayları izler. Bu işlemler ikiz alma, bildirilen özellikleri güncelleştirme ve istenen özelliklere abone olma işlemlerini içerebilir.

{
    "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"
        }
    ]
}

Buluttan cihaza ikiz işlemleri

Buluttan cihaza ikiz işlemleri kategorisi, cihaz ikizlerinde hizmet tarafından başlatılan olayları izler. Bu işlemler ikiz alma, etiketleri güncelleştirme veya değiştirme ve istenen özellikleri güncelleştirme veya değiştirme işlemlerini içerebilir.

{
    "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"
        }
    ]
}

İkiz sorguları

İkiz sorguları kategorisi, bulutta başlatılan cihaz ikizleri için sorgu isteklerini raporlar.

{
    "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"
        }
    ]
}

İş işlemleri

İş işlemleri kategorisi, cihaz ikizlerini güncelleştirme veya birden çok cihazda doğrudan yöntemleri çağırmaya yönelik iş isteklerini bildirir. Bu istekler bulutta başlatılır.

{
    "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"
        }
    ]
}

Doğrudan Yöntemler

Doğrudan yöntemler kategorisi, tek tek cihazlara gönderilen istek-yanıt etkileşimlerini izler. Bu istekler bulutta başlatılır.

{
    "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"
        }
    ]
}

Dağıtılmış İzleme (Önizleme)

Dağıtılmış izleme kategorisi, izleme bağlamı üst bilgisini taşıyan iletiler için bağıntı kimliklerini izler. Bu günlükleri tam olarak etkinleştirmek için istemci tarafı kodu, IoT Hub dağıtılmış izleme (önizleme) ile IoT uygulamalarını uçtan uca analiz etme ve tanılama adımları izlenerek güncelleştirilmelidir.

, correlationId bir ve span-idiçerdiği trace-idW3C İzleme Bağlamı teklifine uygundur.

D2C (cihazdan buluta) günlüklerini IoT Hub

IoT Hub, geçerli izleme özellikleri içeren bir ileti IoT Hub geldiğinde bu günlüğü kaydeder.

{
    "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"
        }
    ]
}

Burada, durationMs IoT Hub saati cihaz saatiyle eşitlenmemiş olabileceği için hesaplanmaz ve bu nedenle süre hesaplaması yanıltıcı olabilir. Cihazdan buluta gecikme sürelerindeki properties ani artışları yakalamak için bölümündeki zaman damgalarını kullanarak mantık yazmanızı öneririz.

Özellik Tür Açıklama
messageSize Tamsayı Cihazdan buluta iletinin bayt cinsinden boyutu
Deviceıd ASCII 7 bit alfasayısal karakter dizesi Cihazın kimliği
callerLocalTimeUtc UTC zaman damgası Cihazın yerel saati tarafından bildirilen ileti oluşturma zamanı
calleeLocalTimeUtc UTC zaman damgası IoT Hub ağ geçidine gelen iletinin IoT Hub hizmet yan saati tarafından bildirildiği saat

Giriş günlüklerini IoT Hub

IoT Hub, geçerli izleme özellikleri içeren ileti iç veya yerleşik Event Hubs'a yazılırken bu günlüğü kaydeder.

{
    "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"
        }
    ]
}

properties bölümünde, bu günlük ileti girişi hakkında ek bilgiler içerir.

Özellik Tür Açıklama
isRoutingEnabled Dize true veya false, IoT Hub ileti yönlendirmenin etkinleştirilip etkinleştirilmediğini gösterir
parentSpanId Dize Bu durumda D2C ileti izlemesi olabilecek üst iletinin span-id değeri

Çıkış günlüklerini IoT Hub

IoT Hub yönlendirme etkinleştirildiğinde ve ileti bir uç noktaya yazıldığında bu günlüğü kaydeder. Yönlendirme etkin değilse, IoT Hub bu günlüğü kaydetmez.

{
    "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"
        }
    ]
}

properties bölümünde, bu günlük ileti girişi hakkında ek bilgiler içerir.

Özellik Tür Açıklama
endpointName Dize Yönlendirme uç noktasının adı
endpointType Dize Yönlendirme uç noktasının türü
parentSpanId Dize Bu durumda IoT Hub giriş iletisi izlemesi olabilecek üst iletinin span-id değeri

Yapılandırmalar

IoT Hub yapılandırma günlükleri Otomatik Cihaz Yönetimi özellik kümesi için olayları ve hataları izler.

{
    "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"
         }
    ]
}

Cihaz Akışları (Önizleme)

Cihaz akışları kategorisi, tek tek cihazlara gönderilen istek-yanıt etkileşimlerini izler.

{
    "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"
         }
    ]
}

Azure İzleyici Günlükleri tabloları

Bu bölüm, log analytics tarafından sorgulanabilir ve Azure IoT Hub ile ilgili tüm Azure İzleyici Günlükleri Kusto tablolarını ifade eder. Bu tabloların listesi ve IoT Hub kaynak türüyle ilgili daha fazla bilgi için bkz. Azure İzleyici Günlükleri tablosu başvurusundaki IoT Hub.

Tüm Azure İzleyici Günlükleri/Log Analytics tablolarının başvurusu için bkz. Azure İzleyici Günlük Tablosu Başvurusu.

Ayrıca Bkz.