الوصول إلى المقاييس المضمنة في Azure IoT Edge

ينطبق على: علامة اختيار IoT Edge 1.5 IoT Edge 1.5 علامة اختيار IoT Edge 1.4 IoT Edge 1.4

هام

IoT Edge 1.5 LTS وIoT Edge 1.4 LTS هي إصدارات مدعومة. IoT Edge 1.4 LTS هو نهاية العمر الافتراضي في 12 نوفمبر 2024. إذا كنت تستخدم إصدارا سابقا، فشاهد تحديث IoT Edge.

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

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

يتم عرض المقاييس تلقائيا بشكل افتراضي على المنفذ 9600 من الوحدات النمطية edgeHub وedgeAgent (http://edgeHub:9600/metrics وhttp://edgeAgent:9600/metrics). لا يتم تعيين المنفذ إلى المضيف بشكل افتراضي.

الوصول إلى المقاييس من المضيف عن طريق الكشف عن منفذ المقاييس وتعيينه من الوحدة النمطية createOptions. يعين المثال أدناه منفذ المقاييس الافتراضي إلى المنفذ 9601 على المضيف:

{
  "ExposedPorts": {
    "9600/tcp": {}
  },
  "HostConfig": {
    "PortBindings": {
      "9600/tcp": [
        {
          "HostPort": "9601"
        }
      ]
    }
  }
}

اختر أرقام منفذ مضيف مختلفة وفريدة إذا كنت تقوم بتعيين كل من نقاط نهاية مقاييس edgeHub وedgeAgent.

إشعار

يجب عدم تعيين متغير httpSettings__enabled البيئة إلى false للمقاييس المضمنة لتكون متاحة للمجموعة.

يتم سرد متغيرات البيئة التي يمكن استخدامها لتعطيل المقاييس في مستند azure/iotedge repo.

المقاييس المتوفرة

تحتوي المقاييس على علامات للمساعدة في تحديد طبيعة المقياس الذي يتم جمعه. تحتوي جميع المقاييس على العلامات التالية:

علامة ‏‏الوصف
مركز IoT المركز الذي يتحدث إليه الجهاز
edge_device معرف الجهاز الحالي
instance_number GUID يمثل وقت التشغيل الحالي. عند إعادة التشغيل، تتم إعادة تعيين جميع المقاييس. يسهل هذا المعرف الفريد العمومي (GUID) التوفيق بين عمليات إعادة التشغيل.

في تنسيق معرض Prometheus، هناك أربعة أنواع قياسية أساسية: العداد والمقياس والمصفوفة التكرارية والملخص. لمزيد من المعلومات حول أنواع المقاييس المختلفة، راجع وثائق أنواع مقاييس Prometheus.

الكمية المتوفرة لمقاييس المدرج التكراري والملخص المضمنة هي 0.1 و0.5 و0.9 و0.99.

تنتج وحدة edgeHub المقاييس التالية:

الاسم أبعاد ‏‏الوصف
edgehub_gettwin_total source (مصدر العملية)
id (معرف الوحدة النمطية)
النوع: عداد
العدد الإجمالي لمكالمات GetTwin
edgehub_messages_received_total route_output (الإخراج الذي أرسل رسالة)
id
النوع: عداد
إجمالي عدد الرسائل المستلمة من العملاء
edgehub_messages_sent_total from (مصدر الرسالة)
to (وجهة الرسالة)
from_route_output
to_route_input (إدخال وجهة الرسالة)
priority (أولوية الرسالة للوجهة)
النوع: عداد
إجمالي عدد الرسائل المرسلة إلى العملاء أو المصدر
to_route_input يكون فارغا عندما to يكون $upstream
edgehub_reported_properties_total target(هدف التحديث)
id
النوع: عداد
إجمالي مكالمات تحديثات الخصائص المبلغ عنها
edgehub_message_size_bytes id
النوع: ملخص
حجم الرسالة من العملاء
يمكن الإبلاغ عن القيم كما NaN لو لم يتم الإبلاغ عن قياسات جديدة لفترة زمنية معينة (10 دقائق حاليا)؛ للنوع summary والمطابق _count والعدادات _sum التي يتم إصدارها.
edgehub_gettwin_duration_seconds source
id
النوع: ملخص
الوقت المستغرق للحصول على عمليات مزدوجة
edgehub_message_send_duration_seconds from
to
from_route_output
to_route_input
النوع: ملخص
الوقت المستغرق لإرسال رسالة
edgehub_message_process_duration_seconds from
to
priority
النوع: ملخص
الوقت المستغرق لمعالجة رسالة من قائمة الانتظار
edgehub_reported_properties_update_duration_seconds target
id
النوع: ملخص
الوقت المستغرق لتحديث الخصائص المبلغ عنها
edgehub_direct_method_duration_seconds from (المتصل)
to (جهاز استقبال)
النوع: ملخص
الوقت المستغرق لحل رسالة مباشرة
edgehub_direct_methods_total from
to
النوع: عداد
إجمالي عدد الرسائل المباشرة المرسلة
edgehub_queue_length endpoint (مصدر الرسالة)
priority (أولوية قائمة الانتظار)
النوع: مقياس
الطول الحالي لقائمة انتظار edgeHub لأولوية معينة
edgehub_messages_dropped_total reason (no_route، ttl_expiry)
from
from_route_output
النوع: عداد
إجمالي عدد الرسائل التي تمت إزالتها بسبب السبب
edgehub_messages_unack_total reason (storage_failure)
from
from_route_output
النوع: عداد
إجمالي عدد الرسائل غير المعترف بها بسبب فشل التخزين
edgehub_offline_count_total id النوع: عداد
إجمالي عدد المرات التي ذهب فيها edgeHub دون اتصال
edgehub_offline_duration_seconds id النوع: ملخص
لوحة وصل الحافة الزمنية غير متصلة
edgehub_operation_retry_total id
operation (اسم العملية)
النوع: عداد
إجمالي عدد المرات التي تمت فيها إعادة محاولة عمليات edgeHub
edgehub_client_connect_failed_total id
reason (غير مصادق عليه)
النوع: عداد
إجمالي عدد المرات التي فشل فيها العملاء في الاتصال ب edgeHub

تنتج وحدة edgeAgent المقاييس التالية:

الاسم أبعاد ‏‏الوصف
edgeAgent_total_time_running_correctly_seconds module_name النوع: مقياس
مقدار الوقت الذي تم فيه تحديد الوحدة النمطية في النشر وكانت في حالة التشغيل
edgeAgent_total_time_expected_running_seconds module_name النوع: مقياس
مقدار الوقت الذي تم فيه تحديد الوحدة النمطية في النشر
edgeAgent_module_start_total module_name, module_version النوع: عداد
عدد المرات التي طلب فيها edgeAgent من docker بدء الوحدة النمطية
edgeAgent_module_stop_total module_name, module_version النوع: عداد
عدد المرات التي طلب فيها edgeAgent من docker إيقاف الوحدة النمطية
edgeAgent_command_latency_seconds command النوع: مقياس
كم من الوقت استغرق docker لتنفيذ الأمر المحدد. الأوامر المحتملة هي: الإنشاء والتحديث والإزالة والبدء والإيقاف وإعادة التشغيل
edgeAgent_iothub_syncs_total النوع: عداد
عدد المرات التي حاولت edgeAgent مزامنة توأمها مع iotHub، سواء كانت ناجحة أو غير ناجحة. يتضمن هذا الرقم كلا من الوكيل الذي يطلب توأما وإعلام Hub بتحديث مزدوج
edgeAgent_unsuccessful_iothub_syncs_total النوع: عداد
عدد المرات التي فشل فيها edgeAgent في مزامنة توأمه مع iotHub.
edgeAgent_deployment_time_seconds النوع: عداد
مقدار الوقت المستغرق لإكمال نشر جديد بعد تلقي تغيير.
edgeagent_direct_method_invocations_count method_name النوع: عداد
عدد المرات التي يتم فيها استدعاء أسلوب edgeAgent مباشر مضمن، مثل Ping أو Restart.
edgeAgent_host_uptime_seconds النوع: مقياس
المدة التي كان فيها المضيف قيد التشغيل
edgeAgent_iotedged_uptime_seconds النوع: مقياس
كم من الوقت تم تشغيل iotedged
edgeAgent_available_disk_space_bytes disk_name، ، disk_filesystemdisk_filetype النوع: مقياس
مقدار المساحة المتبقية على القرص
edgeAgent_total_disk_space_bytes disk_name، ، disk_filesystemdisk_filetype النوع: مقياس
حجم القرص
edgeAgent_used_memory_bytes module_name النوع: مقياس
مقدار ذاكرة الوصول العشوائي المستخدمة من قبل جميع العمليات
edgeAgent_total_memory_bytes module_name النوع: مقياس
ذاكرة الوصول العشوائي المتوفرة
edgeAgent_used_cpu_percent module_name النوع: مدرج تكراري
النسبة المئوية لوحدة المعالجة المركزية المستخدمة من قبل جميع العمليات
edgeAgent_created_pids_total module_name النوع: مقياس
عدد العمليات أو مؤشرات الترابط التي أنشأتها الحاوية
edgeAgent_total_network_in_bytes module_name النوع: مقياس
عدد وحدات البايت المستلمة من الشبكة
edgeAgent_total_network_out_bytes module_name النوع: مقياس
عدد وحدات البايت المرسلة إلى الشبكة
edgeAgent_total_disk_read_bytes module_name النوع: مقياس
عدد وحدات البايت المقروءة من القرص
edgeAgent_total_disk_write_bytes module_name النوع: مقياس
عدد وحدات البايت المكتوبة على القرص
edgeAgent_metadata edge_agent_version، ، experimental_featureshost_information النوع: مقياس
بيانات التعريف العامة حول الجهاز. القيمة دائما 0، ويتم ترميز المعلومات في العلامات. ملاحظة experimental_features و host_information كائنات json. host_information يبدو مثل {"OperatingSystemType": "linux", "Architecture": "x86_64", "Version": "1.2.7", "Provisioning": {"Type": "dps.tpm", "DynamicReprovisioning": false, "AlwaysReprovisionOnStartup": false}, "ServerVersion": "20.10.11+azure-3", "KernelVersion": "5.11.0-1027-azure", "OperatingSystem": "Ubuntu 20.04.4 LTS", "NumCpus": 2, "Virtualized": "yes"}. ملاحظة ServerVersion هي إصدار Docker وهي Version إصدار البرنامج الخفي لأمان IoT Edge.

الخطوات التالية