主机驱动的指标收集器

主机驱动的指标收集器在主机上运行,而不是在设备端运行。这些收集器从主机端与设备进行交互,以收集它们瞄准的指标。

指标收集器设计

所有收集器都将扩展的基类是 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>

建议

查看现有的收集器列表,以确保您没做重复的工作。我们会尽力确保实现最高的可重用性,因此应让每个收集器执行一种类型的收集,因为这样可以在测试执行期间更多地混合搭配不同的收集器。