عميل القياس عن بُعد هو تطبيق يتفاعل مع خدمة القياس عن بُعد من أجل ضبط إعدادات جمع البيانات وإدارة إعدادات المقاييس وتلقّي تقارير القياس عن بُعد. تستخدم البرامج مكتبة libsdv_telemetry_rust_wrapper Rust للتفاعل مع الخدمة.
نظرة عامة على مساحة واجهة برمجة التطبيقات
يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات لمكتبة عميل القياس عن بُعد في Rust للاطّلاع على مستندات واجهة برمجة التطبيقات.
توفّر المكتبة واجهة Rust للتفاعل مع خدمة القياس عن بُعد الأساسية، وهي مسؤولة عن المجالات التالية:
إدارة مراحل نشاط الخدمة: تدير عملية الاتصال بخدمة القياس عن بُعد.
- الإعداد: يتم إنشاء اتصال بالخدمة باستخدام مكالمة حظر. بعد الربط، يمكنك تسجيل عمليات ردّ الاتصال لتلقّي إشعارات غير متزامنة بشأن حالة النظام وتوفّر تقارير جديدة.
- الإيقاف: يوفّر طريقة لإلغاء الربط بالخدمة بشكل سليم وتنظيف جميع الموارد المرتبطة بها.
إدارة دورة حياة إعدادات المقاييس: تتيح التحكّم في دورة حياة إعدادات المقاييس.
- الإدارة: يمكن للعملاء إضافة إعدادات المقاييس وإزالتها وتفعيلها وإيقافها.
- الفحص: يمكنك طلب قائمة بالإعدادات النشطة وغير النشطة.
التعامل مع التقارير واسترجاعها: تسهّل هذه الخدمة الوصول إلى البيانات التي تجمعها خدمة القياس عن بُعد.
- الإشعارات: يتم إعلام العملاء بشكل غير متزامن باستخدام دالة رد الاتصال عندما يكون تقرير مقاييس جديد جاهزًا للاسترداد.
- الوصول إلى البيانات: يوفّر طرقًا لاسترداد تقارير محدّدة من خلال معرّفها الفريد العالمي (UUID) واسترداد قائمة بجميع التقارير المتاحة.
إعداد التقارير عن الحالة والأخطاء: يقدّم هذا الخيار إحصاءات حول سلامة خدمة القياس عن بُعد وحالتها.
- تحديثات الحالة غير المتزامنة: يتلقّى العملاء تحديثات الحالة في الوقت الفعلي، بما في ذلك الأخطاء والتحذيرات، من خلال دالة ردّ مخصّصة. يتيح لك ذلك اتّخاذ إجراءات فعالة لمعالجة الأخطاء ومراقبة حالة الخدمة.
مثال للاستخدام
للحصول على تطبيق كامل وقابل للتجميع يوضّح دورة الحياة الكاملة، يمكنك الاطّلاع على نموذج تنفيذ العميل:
samples/telemetry/client/rust/telemetry_client/telemetry_rust_c_client.rs.
عميل المثال هو أداة سطر أوامر تتفاعل مع واجهة برمجة التطبيقات الكاملة للمكتبة. يوضّح المثال كيفية ربط واجهة المكتبة المستندة إلى عمليات الرجوع بوقت تشغيل غير متزامن للغة Rust (Tokio) باستخدام القنوات.
ينفّذ العميل تسلسل العمليات التالي:
- تنشئ هذه السمة اتصالاً بخدمة القياس عن بُعد وتسجّل عمليات رد الاتصال لتلقّي إشعارات حول آخر الأخبار عن الحالة وتقارير المقاييس.
- يقرأ ملفات إعداد المقاييس المقدَّمة كمعلمات في سطر الأوامر، ثم يضيف الإعدادات ويفعّلها في الخدمة.
- يستخدم مهمة في الخلفية لتسجيل رسائل الحالة غير المتزامنة (الأخطاء أو التحذيرات) التي يتم تلقّيها من الخدمة.
- يدير حلقة استرجاع البيانات من خلال تنفيذ الإجراءات التالية:
- تنتظر هذه الدالة تلقّي إشعار بأنّ تقرير المقاييس جاهز.
- يجلب بيانات تقرير المقاييس الكاملة.
- يكتب التقرير اختياريًا على القرص كملف بروتوكول ثنائي.
- يزيل إعدادات المقاييس من الخدمة بعد أن تنتج تقرير المقاييس الأول. تجدر الإشارة إلى أنّ هذا التنفيذ تجريبي، ويمكن أن تتلقّى برامجك أي عدد من التقارير.
- يؤدي هذا الإجراء إلى إغلاق الاتصال بالخدمة بشكل سليم.