Monitoring Azure IoT Hub data reference

  • مقالة
  • قراءة خلال 21 دقائق

راجع مراقبة Azure IoT Hub للحصول على تفاصيل حول جمع وتحليل بيانات المراقبة ل Azure IoT Hub .

المقاييس

يسرد هذا القسم جميع مقاييس النظام الأساسي التي تم جمعها تلقائيا ل Azure IoT Hub. مساحة اسم موفر الموارد لمقاييس IoT Hub هي Microsoft.Devices ونوع مساحة الاسم هو IoTHubs.

تقسم الأقسام الفرعية التالية مقاييس النظام الأساسي ل IoT Hub حسب الفئة العامة وتدرجها حسب اسم العرض الذي تظهر به في مدخل Azure. كما يتم توفير المعلومات ذات الصلة بالمقاييس التي تظهر في كل قسم فرعي.

يمكنك أيضا العثور على جدول واحد يسرد جميع مقاييس النظام الأساسي لمركز إنترنت الأشياء حسب اسم المقياس ضمن Microsoft.Devices/IotHubs في وثائق Azure Monitor. كن على علم بأن هذا الجدول لا يوفر بعض المعلومات، مثل التجميعات المدعومة لبعض المقاييس، المتوفرة في هذه المقالة.

للتعرف على المقاييس التي تدعمها خدمات Azure الأخرى، راجع المقاييس المدعومة باستخدام Azure Monitor.

المواضيع في هذا القسم

التجميعات المعتمدة

يتوافق عمود نوع التجميع في كل جدول مع التجميع الافتراضي الذي يتم استخدامه عند تحديد المقياس لمخطط أو تنبيه.

Screenshot showing aggregation for metrics

بالنسبة لمعظم المقاييس، تكون جميع أنواع التجميع صالحة؛ ومع ذلك، بالنسبة لمقاييس العد، تلك التي تحتوي على قيمة عمود وحدةللعدد، فإن بعض التجميعات فقط صالحة. يمكن أن تكون مقاييس العد واحدة من نوعين:

  • بالنسبة لمقاييس عد النقطة الواحدة ، يسجل IoT Hub نقطة بيانات واحدة - في الأساس 1 - في كل مرة تحدث فيها العملية المقاسة. ثم يجمع Azure Monitor نقاط البيانات هذه على الدقة المحددة. أمثلة على مقاييس النقطة الواحدة هي رسائل القياس عن بعد المرسلةوتسليم رسائل C2D المكتملة. بالنسبة إلى هذه المقاييس، يكون نوع التجميع الوحيد ذي الصلة هو الإجمالي (المجموع). تتيح لك البوابة اختيار الحد الأدنى والحد الأقصى والمتوسط. ومع ذلك ، ستكون هذه القيم دائما 1.

  • بالنسبة لمقاييس عدد اللقطات ، يسجل IoT Hub إجمالي عدد اللقطات عند حدوث العملية المقاسة. يوجد حاليا ثلاثة مقاييس لقطة منبعثة من IoT Hub: إجمالي عدد الرسائل المستخدمة، وإجمالي الأجهزة (المعاينة)، والأجهزة المتصلة (المعاينة). نظرا لأن هذه المقاييس تقدم كمية "إجمالية" في كل مرة تنبعث منها ، فإن جمعها على الدقة المحددة لا معنى له. يحدك Azure Monitor من تحديد المتوسط والحد الأدنى والحد الأقصى لنوع التجميع لهذه المقاييس.

مقاييس أوامر السحابة إلى الجهاز

الاسم المعروض للقياس متري الوحدة نوع التجميع الوصف الأبعاد
انتهت صلاحية رسائل C2D (إصدار أولي) C2DMessagesExpired العدد الإجمالي عدد الرسائل منتهية الصلاحية من السحابة إلى الجهاز بلا
اكتمال تسليم رسالة C2D c2d.commands.egress.complete.success العدد الإجمالي عدد عمليات تسليم الرسائل من السحابة إلى الجهاز التي تم إكمالها بنجاح بواسطة الجهاز بلا
رسائل C2D الملغاة c2d.commands.egress.abandon.success العدد الإجمالي عدد رسائل السحابة إلى الجهاز التي تم إلغاؤها بواسطة الجهاز بلا
تمت رفض رسالة C2D c2d.commands.egress.reject.success العدد الإجمالي عدد رسائل السحابة إلى الجهاز التي تم رفضها بواسطة الجهاز بلا

بالنسبة إلى المقاييس التي تحتوي على قيمة وحدة من العد، يكون التجميع الإجمالي (المجموع) فقط صالحا. الحد الأدنى والحد الأقصى ومتوسط التجميعات دائما إرجاع 1. لمزيد من المعلومات، راجع التجميعات المدعومة.

مقاييس الأساليب المباشرة من السحابة إلى الجهاز

الاسم المعروض للقياس متري الوحدة نوع التجميع الوصف الأبعاد
فشل استدعاءات الأسلوب المباشر c2d.methods.failure العدد الإجمالي عدد جميع استدعاءات الأسلوب المباشر الفاشلة. بلا
طلب حجم استدعاءات الأسلوب المباشر c2d.methods.requestSize بايت المتوسط عدد جميع طلبات الطرق المباشرة الناجحة. بلا
حجم استجابة استدعاءات الأسلوب المباشر c2d.methods.responseSize بايت المتوسط عدد جميع استجابات الطريقة المباشرة الناجحة. بلا
استدعاءات الأسلوب المباشر الناجحة c2d.methods.success العدد الإجمالي عدد جميع استدعاءات الأسلوب المباشر الناجحة. بلا

بالنسبة للمقاييس التي تحتوي على قيمةوحدة العد ، يكون التجميع الإجمالي (المجموع) فقط صالحا. الحد الأدنى والحد الأقصى ومتوسط التجميعات دائما إرجاع 1. لمزيد من المعلومات، راجع التجميعات المدعومة.

مقاييس العمليات المزدوجة من السحابة إلى الجهاز

الاسم المعروض للقياس متري الوحدة نوع التجميع الوصف الأبعاد
فشل القراءات المزدوجة من الخلفية c2d.twin.read.failure العدد الإجمالي عدد جميع عمليات القراءة المزدوجة الفاشلة التي بدأت في الخلفية. بلا
فشل التحديثات المُزدوجة من الخلفية c2d.twin.update.failure العدد الإجمالي عدد جميع التحديثات المزدوجة الفاشلة التي بدأت في الخلفية. بلا
حجم استجابة القراءات المزدوجة من الخلفية c2d.twin.read.size بايت المتوسط عدد جميع عمليات القراءة المزدوجة الناجحة التي بدأت في الخلفية. بلا
حجم التحديثات المُزدوجة من الخلفية c2d.twin.update.size بايت المتوسط الحجم الإجمالي لجميع التحديثات المزدوجة الناجحة التي تم إنشاؤها في الواجهة الخلفية. بلا
القراءات المزدوجة الناجحة من الخلفية c2d.twin.read.success العدد الإجمالي عدد جميع عمليات القراءة المزدوجة الناجحة التي بدأت في الخلفية. بلا
التحديثات المزدوجة الناجحة من الخلفية c2d.twin.update.success العدد الإجمالي عدد جميع التحديثات المزدوجة الناجحة التي بدأت في الخلفية. بلا

بالنسبة إلى المقاييس التي تحتوي على قيمة وحدة من العد، يكون التجميع الإجمالي (المجموع) فقط صالحا. الحد الأدنى والحد الأقصى ومتوسط التجميعات دائما إرجاع 1. لمزيد من المعلومات، راجع التجميعات المدعومة.

مقاييس التكوينات

الاسم المعروض للقياس متري الوحدة نوع التجميع الوصف الأبعاد
قياسات التكوين configurations العدد الإجمالي عدد إجمالي عمليات CRUD التي تم تنفيذها لتكوين الجهاز ونشر IoT Edge ، على مجموعة من الأجهزة المستهدفة. يتضمن ذلك أيضا عدد العمليات التي تعدل توأم الجهاز أو توأم الوحدة النمطية بسبب هذه التكوينات. بلا

بالنسبة إلى المقاييس التي تحتوي على قيمة وحدة من العد، يكون التجميع الإجمالي (المجموع) فقط صالحا. الحد الأدنى والحد الأقصى ومتوسط التجميعات دائما إرجاع 1. لمزيد من المعلومات، راجع التجميعات المدعومة.

مقاييس الحصص اليومية

الاسم المعروض للقياس متري الوحدة نوع التجميع الوصف الأبعاد
إجمالي استخدام بيانات الجهاز deviceDataUsage بايت الإجمالي وحدات البايت المرسلة من وإلى أي أجهزة متصلة بمركز IotHub بلا
إجمالي استخدام بيانات الجهاز (معاينة) deviceDataUsageV2 بايت الإجمالي وحدات البايت المرسلة من وإلى أي أجهزة متصلة بمركز IotHub بلا
إجمالي عدد الرسائل التي تم استخدامها dailyMessageQuotaUsed العدد المتوسط إجمالي عدد الرسائل المستخدمة اليوم. هذه قيمة تراكمية يُعاد تعيينها إلى الصفر في 00:00 بتوقيت عالمي متفق عليه كل يوم. بلا

بالنسبة إلى إجمالي عدد الرسائل المستخدمة، يتم دعم الحد الأدنى والحد الأقصى والمتوسط التجميعي فقط. لمزيد من المعلومات، راجع التجميعات المدعومة.

مقاييس الجهاز

الاسم المعروض للقياس متري الوحدة نوع التجميع الوصف الأبعاد
إجمالي للأجهزة (مهمل) devices.totalDevices العدد الإجمالي عدد الأجهزة المسجلة إلى مركز IoT بلا
الأجهِزة المتصلة (مهملة) devices.connectedDevices.allProtocol العدد الإجمالي عدد الأجهزة المتصلة بمركز IoT بلا
إجمالي الأجهزة (معاينة) totalDeviceCount العدد المتوسط عدد الأجهزة المسجلة إلى مركز IoT بلا
الأجهزة المتصلة (معاينة) connectedDeviceCount العدد المتوسط عدد الأجهزة المتصلة بمركز IoT بلا

بالنسبة إلى إجمالي الأجهزة (المهملة ) والأجهزة المتصلة (المهملة)، يكون التجميع الإجمالي (المجموع) فقط صالحا. الحد الأدنى والحد الأقصى ومتوسط التجميعات دائما إرجاع 1. لمزيد من المعلومات، راجع التجميعات المدعومة.

بالنسبة إلى إجمالي الأجهزة (المعاينة) والأجهزة المتصلة (المعاينة)، لا تتوفر سوى التجميعات الدنيا والقصوى والمتوسطة. لمزيد من المعلومات، راجع التجميعات المدعومة.

الأجهزة المتصلة (المعاينة) وإجمالي الأجهزة (المعاينة) غير قابلة للتصدير عبر إعدادات التشخيص.

مقاييس القياس عن بعد للجهاز

الاسم المعروض للقياس متري الوحدة نوع التجميع الوصف الأبعاد
عدد أخطاء التحكم بالنطاق الترددي d2c.telemetry.ingress.sendThrottle العدد الإجمالي عدد أخطاء التحكم بالنطاق الترددي بسبب تقييد معدل نقل الجهاز بلا
محاولات إرسال رسائل بيانات تتبع الاستخدام d2c.telemetry.ingress.allProtocol العدد الإجمالي عدد رسائل بيانات تتبع الاستخدام من الجهاز إلى السحابة التي تمت محاولة إرسالها إلى مركز IoT بلا
رسائل بيانات تتبع الاستخدام المرسلة d2c.telemetry.ingress.success العدد الإجمالي عدد رسائل بيانات تتبع الاستخدام من الجهاز إلى السحابة التي تم إرسالها إلى مركز IoT بلا

بالنسبة إلى المقاييس التي تحتوي على قيمة وحدة من العد، يكون التجميع الإجمالي (المجموع) فقط صالحا. الحد الأدنى والحد الأقصى ومتوسط التجميعات دائما إرجاع 1. لمزيد من المعلومات، راجع التجميعات المدعومة.

مقاييس العمليات المزدوجة من جهاز إلى سحابة

الاسم المعروض للقياس متري الوحدة نوع التجميع الوصف الأبعاد
فشل القراءات المزدوجة من الأجهزة d2c.twin.read.failure العدد الإجمالي عدد جميع عمليات القراءة المزدوجة الفاشلة التي بدأت من الجهاز. بلا
فشل التحديثات المزدوجة من الأجهزة d2c.twin.update.failure العدد الإجمالي عدد جميع عمليات التحديثات المزدوجة الفاشلة التي بدأت من الجهاز. بلا
حجم استجابة القراءات المزدوجة من الأجهزة d2c.twin.read.size بايت المتوسط يقرأ عدد جميع التوأم الناجح الذي بدأه الجهاز. بلا
حجم التحديثات المُزدوجة من الأجهزة d2c.twin.update.size بايت المتوسط الحجم الإجمالي لجميع التحديثات المزدوجة الناجحة التي بدأها الجهاز. بلا
القراءات المزدوجة الناجحة من الأجهزة يقرأ التوأم بنجاح d2c العدد الإجمالي عدد جميع عمليات القراءة المزدوجة الناجحة التي بدأت من الجهاز. بلا
التحديثات المزدوجة الناجحة من الأجهزة d2c.twin.update.success العدد الإجمالي عدد جميع التحديثات المزدوجة الناجحة التي بدأت من الجهاز. بلا

بالنسبة إلى المقاييس التي تحتوي على قيمة وحدة من العد، يكون التجميع الإجمالي (المجموع) فقط صالحا. الحد الأدنى والحد الأقصى ومتوسط التجميعات دائما إرجاع 1. لمزيد من المعلومات، راجع التجميعات المدعومة.

مقاييس شبكة الأحداث

الاسم المعروض للقياس متري الوحدة نوع التجميع الوصف الأبعاد
عمليات التسليم لخطوط شبكة الأحداث (معاينة) EventGridDeliveries العدد الإجمالي عدد أحداث مركز IoT المنشورة إلى خطوط شبكة الأحداث. استخدم بُعد Result لعدد الطلبات الناجحة والفاشلة. يعرض البعد EventType نوع الحدث (https://aka.ms/ioteventgrid). نتيجة
EventType
لمزيد من المعلومات، راجع أبعاد المقياس.
زمن انتقال خطوط شبكة الحدث (إصدار أولي) EventGridLatency مللي ثانية المتوسط متوسط زمن الانتقال (بالمللي ثانية) من وقت إنشاء حدث مركز Iot إلى وقت نشر الحدث إلى خطوط شبكة الأحداث. هذا الرقم هو المتوسط بين جميع أنواع الأحداث. استخدم بُعد EventType للاطلاع على زمن الانتقال لنوع معين من الأحداث. EventType
لمزيد من المعلومات، راجع أبعاد المقياس.

بالنسبة إلى المقاييس التي تحتوي على قيمة وحدة من العد، يكون التجميع الإجمالي (المجموع) فقط صالحا. الحد الأدنى والحد الأقصى ومتوسط التجميعات دائما إرجاع 1. لمزيد من المعلومات، راجع التجميعات المدعومة.

مقاييس الوظائف

الاسم المعروض للقياس متري الوحدة نوع التجميع الوصف الأبعاد
المهام المكتملة jobs.completed العدد الإجمالي عدد جميع المهام المكتملة. بلا
الاستدعاءات الفاشلة لسرد المهام jobs.listJobs.failure العدد الإجمالي عدد جميع الاستدعاءات الفاشلة لسرد المهام. بلا
فشل عمليات إنشاءات مهام استدعاء الأسلوب jobs.createDirectMethodJob.failure العدد الإجمالي عدد جميع عمليات الإنشاء الفاشلة لمهام استدعاء الأسلوب المباشر. بلا
فشل عمليات الإنشاء الخاصة بمهام التحديث المزدوج jobs.createTwinUpdateJob.failure العدد الإجمالي عدد جميع عمليات الإنشاء الفاشلة لمهام التحديث المزدوج. بلا
عمليات إلغاء المهام الفاشلة jobs.cancelJob.failure العدد الإجمالي عدد جميع الاستدعاءات الفاشلة لإلغاء مهمة. بلا
استعلامات فشل المهمة jobs.queryJobs.failure العدد الإجمالي عدد جميع الاستدعاءات الفاشلة لاستعلام المهام. بلا
المهام الفاشلة jobs.failed العدد الإجمالي عدد جميع المهام الفاشلة. بلا
الاستدعاءات الناجحة لسرد المهام jobs.listJobs.success العدد الإجمالي عدد جميع الاستدعاءات الناجحة لسرد المهام. بلا
عمليات الإنشاء الناجحة الخاصة بمهام استدعاء الأسلوب jobs.createDirectMethodJob.success العدد الإجمالي عدد جميع عمليات الإنشاء الناجحة لمهام استدعاء الأسلوب المباشر. بلا
عمليات الإنشاء الناجحة الخاصة بمهام التحديث المزدوج jobs.createTwinUpdateJob.
النجاح		 العدد الإجمالي عدد جميع عمليات الإنشاء الناجحة لمهام التحديث المزدوج. بلا
عمليات إلغاء المهام الناجحة jobs.cancelJob.success العدد الإجمالي عدد جميع الاستدعاءات الناجحة لإلغاء مهمة. بلا
استعلامات المُهمة الناجحة jobs.queryJobs.success العدد الإجمالي عدد جميع الاستدعاءات الناجحة لاستعلام المهام. بلا

بالنسبة إلى المقاييس التي تحتوي على قيمة وحدة من العد، يكون التجميع الإجمالي (المجموع) فقط صالحا. الحد الأدنى والحد الأقصى ومتوسط التجميعات دائما إرجاع 1. لمزيد من المعلومات، راجع التجميعات المدعومة.

مقاييس التوجيه

الاسم المعروض للقياس متري الوحدة نوع التجميع الوصف الأبعاد
توجيه محاولات التسليم (معاينة) RoutingDeliveries العدد الإجمالي هذا هو مقياس تسليم التوجيه. استخدم الأبعاد لتحديد حالة التسليم لنقطة نهاية معينة أو لمصدر توجيه معين. نتيجة
RoutingSource,
EndpointType,
الفشلالعقلالفئة,
EndpointName
لمزيد من المعلومات، راجع أبعاد المقياس.
توجيه حجم بيانات التسليم بالبايت (معاينة) RoutingDataSizeInBytesDelivered بايت الإجمالي إجمالي عدد وحدات البايت التي يتم توجيهها بواسطة IoT Hub إلى نقطة نهاية مخصصة ونقطة نهاية مضمنة. استخدم الأبعاد لتحديد حجم البيانات الموجهة إلى نقطة نهاية معينة أو لمصدر توجيه معين. RoutingSource,
EndpointType
EndpointName
لمزيد من المعلومات، راجع أبعاد المقياس.
زمن انتقال التوجيه (معاينة) RoutingDeliveryLatency مللي ثانية المتوسط هذا هو مقياس زمن انتقال تسليم التوجيه. استخدم الأبعاد لتحديد زمن الوصول لنقطة نهاية معينة أو لمصدر توجيه معين. RoutingSource,
EndpointType,
EndpointName
لمزيد من المعلومات، راجع أبعاد المقياس.
التوجيه: كائنات ثنائية كبيرة الحجم التي تم تسليمها إلى موقع التخزين d2c.endpoints.egress.storage.blobs العدد الإجمالي عدد المرات التي قام توجيه مركز IoT بتسليم كائنات ثنائية كبيرة الحجم إلى نقاط نهاية موقع التخزين. بلا
التوجيه: البيانات التي يتم تسليمها إلى موقع التخزين d2c.endpoints.egress.storage.bytes بايت الإجمالي مقدار البيانات (بالبايت) التي سلمها توجيه مركز IoT إلى نقاط نهاية موقع التخزين. بلا
التوجيه: زمن انتقال الرسالة لمركز الأحداث d2c.endpoints.latency.eventHubs مللي ثانية المتوسط متوسط زمن الوصول (مللي ثانية) بين دخول الرسالة إلى IoT Hub ودخول الرسالة إلى نقاط نهاية مخصصة من النوع Event Hub. لا يتضمن ذلك مسارات الرسائل إلى نقطة النهاية المضمنة (الأحداث). بلا
التوجيه: زمن انتقال الرسالة الخاص بقائمة انتظار ناقل الخدمة d2c.endpoints.latency.serviceBusQueues مللي ثانية المتوسط متوسط زمن الوصول (مللي ثانية) بين دخول الرسالة إلى مركز إنترنت الأشياء ودخول الرسالة إلى نقطة نهاية قائمة انتظار ناقل الخدمة. بلا
التوجيه: زمن انتقال الرسالة لموضوع ناقل خدمة Azure d2c.endpoints.latency.serviceBusTopics مللي ثانية المتوسط متوسط زمن الوصول (مللي ثانية) بين دخول الرسالة إلى مركز إنترنت الأشياء ودخول الرسالة إلى نقطة نهاية موضوع ناقل الخدمة. بلا
التوجيه: زمن انتقال الرسائل للرسائل/الأحداث d2c.endpoints.latency.builtIn.events مللي ثانية المتوسط متوسط زمن الوصول (مللي ثانية) بين دخول الرسالة إلى IoT Hub ودخول الرسالة إلى نقطة النهاية المضمنة (الرسائل/الأحداث) والمسار الاحتياطي. بلا
التوجيه: زمن انتقال الرسالة لموقع للتخزين d2c.endpoints.latency.storage مللي ثانية المتوسط متوسط زمن الوصول (مللي ثانية) بين دخول الرسالة إلى IoT Hub ودخول الرسالة إلى نقطة نهاية التخزين. بلا
التوجيه: الرسائل التي تمت تسليمها إلى مركز الحدث d2c.endpoints.egress.eventHubs العدد الإجمالي عدد المرات التي نجح فيها توجيه IoT Hub في تسليم الرسائل إلى نقاط نهاية مخصصة من النوع Event Hub. لا يتضمن ذلك مسارات الرسائل إلى نقطة النهاية المضمنة (الأحداث). بلا
التوجيه: الرسائل التي تم تسليمها إلى قائمة انتظار ناقل الخدمة d2c.endpoints.egress.serviceBusQueues العدد الإجمالي عدد المرات التي نجح فيها توجيه مركز IoT في تسليم الرسائل إلى نقاط نهاية قائمة انتظار ناقل الخدمة. بلا
التوجيه: الرسائل المُسلّمة إلى موضوع ناقل الخدمة d2c.endpoints.egress.serviceBusTopics العدد الإجمالي عدد المرات التي نجح فيها توجيه مركز IoT في تسليم الرسائل إلى نقاط نهاية موضوع ناقل الخدمة. بلا
التوجيه: الرسائل التي تمت تسليمها إلى الموقع الاحتياطي d2c.telemetry.egress.fallback العدد الإجمالي عدد المرات التي قام فيها توجيه مركز IoT بتسليم الرسائل إلى نقطة النهاية المقترنة بالمسار الاحتياطي. بلا
التوجيه: الرسائل التي يتم تسليمها إلى الرسائل/الأحداث d2c.endpoints.egress.builtIn.events العدد الإجمالي عدد المرات التي نجح فيها توجيه IoT Hub في تسليم الرسائل إلى نقطة النهاية المضمنة (الرسائل/الأحداث) والمسار الاحتياطي. بلا
التوجيه: الرسائل التي تمت تسليمها إلى موقع التخزين d2c.endpoints.egress.storage العدد الإجمالي عدد المرات التي نجح فيها توجيه مركز IoT في تسليم الرسائل إلى نقاط نهاية موقع التخزين. بلا
التوجيه: رسائل بيانات تتبع الاستخدام التي تم تسليمها d2c.telemetry.egress.success العدد الإجمالي عدد المرات التي تم فيها تسليم الرسائل بنجاح إلى جميع نقاط النهاية باستخدام توجيه مركز IoT. إذا تم توجيه رسالة إلى نقاط نهاية متعددة، تزيد هذه القيمة بمقدار واحد لكل عملية تسليم ناجحة. إذا تم تسليم رسالة إلى نقاط النهاية نفسها عدة مرات، تزيد هذه القيمة بمقدار واحد لكل عملية تسليم ناجحة. بلا
التوجيه: رسائل بيانات تتبع الاستخدام التي تم إسقاطها d2c.telemetry.egress.dropped العدد الإجمالي عدد المرات التي تم فيها إسقاط الرسائل بواسطة توجيه مركز IoT بسبب نقاط النهاية غير المستخدمة. لا تحسب هذه القيمة الرسائل التي تم تسليمها إلى التوجيه الاحتياطي حيث لا يتم تسليم الرسائل التي تم إسقاطها هناك. بلا
التوجيه: رسائل بيانات تتبع الاستخدام غير المتوافقة d2c.telemetry.egress.invalid العدد الإجمالي عدد المرات التي فشل فيها توجيه مركز IoT في تسليم الرسائل بسبب عدم التوافق مع نقطة النهاية. رسالة غير متوافقة مع نقطة نهاية عندما يحاول Iot Hub تسليم الرسالة إلى نقطة نهاية ويفشل بسبب خطأ غير عابر. لا تتم إعادة معالجة الرسائل غير الصالحة. لا تتضمن هذه القيمة إعادة المحاولة. بلا
التوجيه: رسائل بيانات تتبع الاستخدام المعزولة d2c.telemetry.egress.orphaned العدد الإجمالي عدد المرات التي تم فيها عزل الرسائل بواسطة توجيه IoT Hub لأنها لم تتطابق مع أي استعلام توجيه، عند تعطيل المسار الاحتياطي. بلا

بالنسبة إلى المقاييس التي تحتوي على قيمة وحدة من العد، يكون التجميع الإجمالي (المجموع) فقط صالحا. الحد الأدنى والحد الأقصى ومتوسط التجميعات دائما إرجاع 1. لمزيد من المعلومات، راجع التجميعات المدعومة.

مقاييس الاستعلام المزدوج

الاسم المعروض للقياس متري الوحدة نوع التجميع الوصف الأبعاد
فِشل الاستعلامات المزدوجة twinQueries.failure العدد الإجمالي عدد جميع الاستعلامات المزدوجة الفاشلة. بلا
الاستعلامات المزدوجة الناجحة twinQueries.success العدد الإجمالي عدد جميع الاستعلامات المزدوجة الناجحة. بلا
حجم نتيجة الاستعلامات المزدوجة twinQueries.resultSize بايت المتوسط إجمالي حجم النتيجة لجميع الاستعلامات المزدوجة الناجحة. بلا

بالنسبة إلى المقاييس التي تحتوي على قيمة وحدة من العد، يكون التجميع الإجمالي (المجموع) فقط صالحا. الحد الأدنى والحد الأقصى ومتوسط التجميعات دائما إرجاع 1. لمزيد من المعلومات، راجع التجميعات المدعومة.

الأبعاد المترية

يحتوي Azure IoT Hub على الأبعاد التالية المرتبطة ببعض مقاييس شبكة التوجيه والأحداث الخاصة به.

اسم البعد الوصف
EndpointName اسم نقطة النهاية.
EndpointType أحد الإجراءات التالية: eventHubs, serviceBusQueues, cosmosDB, serviceBusTopics. المدمج ، أو blobStorage.
EventType أحد أنواع أحداث شبكة الأحداث التالية: Microsoft.Devices.DeviceCreate. Microsoft.Devices.DeviceDelete، Microsoft.Devices.DeviceConnected، Microsoft.Devices.DeviceDisconnected، أو Microsoft.Devices.DeviceTelemetry. لمزيد من المعلومات، راجع أنواع الأحداث.
الفشلالسببالفئة أحد الإجراءات التالية: غير صالح أو مسقط، أو يتيم، أو باطل.
النتيجة إما النجاح أو الفشل.
RoutingSource رسائل الجهاز
فعاليات التغيير التوأم
أحداث دورة حياة الجهاز

لمعرفة المزيد حول أبعاد المقياس، راجع المقاييس متعددة الأبعاد.

سجلات الموارد

يسرد هذا القسم كافة أنواع فئات سجل الموارد والمخططات التي تم تجميعها ل Azure IoT Hub. موفر الموارد والنوع لجميع سجلات IoT Hub هو Microsoft.Devices/IotHubs. كن على علم بأن الأحداث تنبعث فقط للأخطاء في بعض الفئات.

المواضيع في هذا القسم

الاتصالات

تتعقب فئة الاتصالات اتصال الجهاز وفصل الأحداث من مركز إنترنت الأشياء بالإضافة إلى الأخطاء. هذه الفئة مفيدة لتحديد محاولات الاتصال غير المصرح بها و/أو التنبيه عند فقدان الاتصال بالأجهزة.

ملاحظة

للحصول على حالة اتصال موثوقة للأجهزة، تحقق من نبضات قلب الجهاز.

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

للحصول على معلومات مفصلة حول استخدام سجلات الاتصالات لمراقبة اتصال الجهاز، راجع مراقبة اتصال الجهاز ب Azure IoT Hub وتشخيصه واستكشاف الأخطاء وإصلاحه.

بيانات تتبع استخدام الجهاز

تتعقب فئة بيانات تتبع استخدام الجهاز الأخطاء التي تحدث في مركز IoT وتتعلق ببنية بيانات تتبع الاستخدام الرئيسية. تتضمن هذه الفئة الأخطاء التي تحدث عند إرسال أحداث تتعلق ببيانات تتبع الاستخدام (مثل التقييد) وتلقي أحداث تتعلق ببيانات تتبع الاستخدام (مثل القارئ غير المصرح به). لا يمكن لهذه الفئة التقاط الأخطاء الناجمة عن تشغيل تعليمة برمجية على الجهاز نفسه.

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

أوامر مرسلة من سحابة إلى جهاز

تتعقب فئة الأوامر المرسلة من سحابة إلى جهاز الأخطاء التي تحدث في مركز IoT وترتبط بالبنية الأساسية للرسائل المرسلة من سحابة إلى جهاز. تتضمن هذه الفئة الأخطاء التي تحدث جرّاء:

  • إرسال رسائل سحابية إلى الجهاز (مثل أخطاء المرسل غير المصرح به)،
  • تلقي رسائل من السحابة إلى الجهاز (مثل تجاوز عدد مرات التسليم للأخطاء)، و
  • تلقي ملاحظات الرسائل المرسلة من سحابة إلى جهاز (مثل أخطاء انتهاء صلاحية الملاحظات).

لا تلتقط هذه الفئة أي أخطاء عند تسليم رسالة مرسلة من سحابة إلى جهاز بنجاح، ولكن عندما لا يعالجها الجهاز بشكلٍ سليم فيما بعد.

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

عمليات معرّف الجهاز

تتعقب فئة عمليات معرّف الجهاز الأخطاء التي تحدث عند محاولة إجراء أي إدخال في سجل معرّف مركز IoT أو تحديثه أو حذفه. يُعد تعقب هذه الفئة مفيدًا لسيناريوهات التزويد.

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

عمليات تحميل الملفات

تتعقب فئة تحميل الملفات الأخطاء التي تحدث في مركز IoT وترتبط بوظائف تحميل الملفات. تشمل هذه الفئة ما يلي:

  • الأخطاء التي تحدث مع معرّف المواد المنتظم لـ SAS، مثل عندما تنتهي صلاحيته قبل أن ينبه جهاز المركز باكتمال التحميل.

  • التحميلات الفاشلة التي أبلغ عنها الجهاز.

  • الأخطاء التي تحدث عند عدم العثور على ملف في التخزين أثناء إنشاء رسالة تنبيه مركز IoT.

لا يمكن لهذه الفئة أن تلتقط الأخطاء التي تحدث مباشرة أثناء تحميل الجهاز لملف في حساب التخزين.

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

مسارات

تتعقب فئة توجيه الرسائل الأخطاء التي تحدث أثناء تقييم مسار الرسالة وسلامة نقطة النهاية كما يراها IoT Hub. تتضمن هذه الفئة أحداثًا مثل:

  • يتم تقييم القاعدة إلى "غير محددة" ،
  • يضع IoT Hub علامة على نقطة النهاية على أنها ميتة، أو
  • أية أخطاء تم تلقيها من نقطة نهاية.

لا تتضمن هذه الفئة أخطاء معينة حول الرسائل نفسها (مثل أخطاء تقييد الجهاز)، والتي يتم الإبلاغ عنها ضمن فئة "بيانات تتبع استخدام الجهاز".

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

فيما يلي مزيد من التفاصيل حول سجلات موارد التوجيه:

العمليات المزدوجة من جهاز إلى سحابة

تتعقب فئة العمليات المزدوجة من جهاز إلى سحابة الأحداث التي بدأها الجهاز على Device Twins. يمكن أن تتضمن هذه العمليات الحصول على خصائص مزدوجة ومحدثه تم الإبلاغ عنها، بالإضافة إلى الاشتراك في الخصائص المطلوبة.

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

العمليات المزدوجة من سحابة إلى جهاز

تتعقب فئة العمليات المزدوجة من سحابة إلى جهاز الأحداث التي بدأتها الخدمة على Device Twins. يمكن أن تتضمن هذه العمليات علامات مزدوجة أو تحديثها أو استبدالها وتحديث الخصائص المطلوبة أو استبدالها.

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

استعلامات مزدوجة

تبلِّغ فئة الاستعلامات المزدوجة عن طلبات الاستعلام عن Device Twins التي تنشأ في السحابة.

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

عمليات الوظائف

تبلِّغ فئة عمليات الوظائف عن طلبات العمل لتحديث Device Twins أو استدعاء أساليب مباشرة على أجهزة متعددة. تُنشأ هذه الطلبات في السحابة.

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

طرق مباشرة

تتعقب فئة الأساليب المباشرة تفاعلات الاستجابة للطلب المرسلة إلى الأجهزة الفردية. تُنشأ هذه الطلبات في السحابة.

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

تتبع الموزعة (معاينة)

تتعقب فئة التتبع الموزع معرفات الارتباط للرسائل التي تحمل رأس سياق التتبع. لتمكين هذه السجلات بشكل كامل، يجب تحديث التعليمات البرمجية من جانب العميل باتباع تحليل وتشخيص تطبيقات إنترنت الأشياء من البداية إلى النهاية باستخدام التتبع الموزع (المعاينة) ل IoT Hub.

لاحظ أنه correlationId يتوافق مع اقتراح W3C Trace Context ، حيث يحتوي على trace-id بالإضافة إلى span-id.

سجلات IoT Hub D2C (من الجهاز إلى السحابة)

يسجل IoT Hub هذا السجل عند وصول رسالة تحتوي على خصائص تتبع صالحة إلى 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"
        }
    ]
}

هنا ، لا يتم حسابها لأن ساعة IoT Hub قد لا تكون متزامنة مع ساعة الجهاز ، durationMs وبالتالي يمكن أن يكون حساب المدة مضللا. نوصي بكتابة المنطق باستخدام الطوابع الزمنية في القسم لالتقاط الطفرات properties في زمن انتقال الجهاز إلى السحابة.

الخاصية النوع الوصف
حجم الرسالةالحجم عدد صحيح حجم الرسالة من الجهاز إلى السحابة بالبايت
معرف الجهاز سلسلة من الأحرف الأبجدية الرقمية ASCII 7 بت هوية الجهاز
المتصلالتوقيت المحليالتوقيت العالمي الطابع الزمني UTC وقت إنشاء الرسالة كما تم الإبلاغ عنه بواسطة الساعة المحلية للجهاز
calleeLocalTimeUtc الطابع الزمني UTC وقت وصول الرسالة إلى بوابة IoT Hub كما هو مذكور بواسطة الساعة الجانبية لخدمة IoT Hub

سجلات دخول IoT Hub

يسجل IoT Hub هذا السجل عندما تكتب رسالة تحتوي على خصائص تتبع صالحة إلى مركز الأحداث الداخلي أو المضمن.

{
    "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 ، يحتوي هذا السجل على معلومات إضافية حول دخول الرسالة.

الخاصية النوع الوصف
isRoutingEnabled سلسلة سواء كان ذلك صحيحا أو خاطئا، يشير إلى ما إذا كان توجيه الرسائل ممكنا أم لا في مركز إنترنت الأشياء
parentSpanId سلسلة معرف المدى للرسالة الأصل، والذي سيكون تتبع رسالة D2C في هذه الحالة

سجلات خروج IoT Hub

يسجل IoT Hub هذا السجل عند تمكين التوجيه وكتابة الرسالة إلى نقطة نهاية. إذا لم يتم تمكين التوجيه، فلن يقوم IoT Hub بتسجيل هذا السجل.

{
    "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 ، يحتوي هذا السجل على معلومات إضافية حول دخول الرسالة.

الخاصية النوع الوصف
اسم نقطة النهاية سلسلة اسم نقطة نهاية التوجيه
نقطة النهاية سلسلة نوع نقطة نهاية التوجيه
parentSpanId سلسلة معرف المدى للرسالة الأصل، والذي سيكون تتبع رسالة دخول IoT Hub في هذه الحالة

التكوينات

يقوم تكوين IoT Hub بتتبع الأحداث والأخطاء لمجموعة ميزات إدارة الجهاز التلقائي.

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

أجهزة بث (معاينة)

تتعقب فئة تدفقات الأجهزة التفاعلات بين الطلب والاستجابة المرسلة إلى الأجهزة الفردية.

{
    "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 Monitor

يشير هذا القسم إلى جميع جداول Azure Monitor Logs Kusto ذات الصلة ب Azure IoT Hub والمتوفرة للاستعلام بواسطة Log Analytics. للحصول على قائمة بهذه الجداول والارتباطات إلى مزيد من المعلومات حول نوع مورد IoT Hub، راجع IoT Hub في مرجع جدول سجلات مراقبة Azure.

من أجل الحصول على مرجع لكل سجلات Azure Monitor / جداول تحليلات السجل، قم بمراجعة مرجع جدول سجل مراقبة Azure .

راجع أيضًا