Сборщики метрик, управляемые хостом, работают на хосте, а не на стороне устройства. Они взаимодействуют с устройством со стороны хоста для сбора целевых показателей.
Проектирование коллектора метрик
Базовым классом, который расширяют все сборщики, является 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>
Рекомендации
Просмотрите существующий список сборщиков , чтобы убедиться, что вы не дублируете работу. Мы стараемся обеспечить максимальную возможность повторного использования, поэтому выполнение каждым сборщиком сбора одного типа позволяет лучше смешивать и сопоставлять различные сборщики во время выполнения теста.