الوصول إلى المقاييس المضمنة في 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_filesystem disk_filetype |
النوع: مقياس مقدار المساحة المتبقية على القرص |
edgeAgent_total_disk_space_bytes |
disk_name ، ، disk_filesystem disk_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_features host_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. |