يتم تشغيل أدوات جمع المقاييس المستندة إلى المضيف على المضيف وليس على الجهاز. ويتفاعلون مع الجهاز من جهة المضيف لجمع المقاييس التي يستهدفونها.
تصميم أداة جمع المقاييس
الفئة الأساسية التي يجمعها جميع هواة التجميع هي
BaseDeviceMetricCollector،
وهي تساعد في توفير الوظائف الأساسية المشتركة نفسها:
- التصفية
- إيقاف
- جمع بيانات حالات الاختبار في مقابل عمليات الاختبار
تتّبع أدوات الالتقاط نموذج مُسجّل النتائج لأنّها تتم مزامنتها مع تنفيذ الاختبار على المضيف. بمعنى آخر، إذا كانت الاختبارات تعتمد على المضيف، فسيتم تنفيذ أدوات التجميع قبل أن ينتقل الاختبار إلى خطوة التنفيذ التالية.
على سبيل المثال، إذا تم تنفيذ عملية جمع البيانات في testEnded، يتم تنفيذ عمليات جمع البيانات
قبل أن ينتقل التنفيذ إلى الاختبار التالي باستخدام testStart.
تنفيذ أداة جمع مقاييس مستندة إلى المضيف
عند التنفيذ على مستوى الفئة الأساسية BaseDeviceMetricCollector، يمكنك تحديد الوقت المناسب لجمع المقاييس:
- عند بدء عملية اختبار:
onTestRunStart - عند بدء نموذج اختبار:
onTestStart - عند انتهاء حالة اختبار:
onTestEnd - عند انتهاء عملية التشغيل التجريبي:
onTestRunEnd
تنفيذ عملية جمع غير متزامنة
بالإضافة إلى الطرق المتزامنة، يوفّر TF فئة أساسية للتنفيذ
تُجري عملية جمع غير متزامن دورية،
ScheduledDeviceMetricCollector،
والتي توفّر طريقة collect لتنفيذها بشكل دوري.
يمكن تخصيص الفترة من خلال الخيارات.
إعدادات XML
علامة الكائن هي metrics_collector، على سبيل المثال:
<metrics_collector class="com.android.tradefed.device.metric.AtraceCollector">
<option name="categories" value="freq"/>
</metrics_collector>
الاقتراحات
اطّلِع على القائمة الحالية للمجمعين للتأكّد من أنّك لا تكرّر العمل. نحاول ضمان أقصى قدر من إمكانية إعادة الاستخدام، لذلك، يسمح تعيين كلّ جامع لنوع واحد من عمليات الجمع بمزيد من المزج ومطابقة المجمعات المختلفة أثناء تنفيذ الاختبار.