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

ينطبق على: IoT Edge 1.5 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.

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

• جمع ونقل المقاييس
• فهم وقت تشغيل Azure IoT Edge وهندسته
• خصائص عامل IoT Edge وتوائم وحدة مركز IoT Edge