Hostbasierte Messwert-Collectors

Hostbasierte Messwert-Erfassungen werden auf dem Host und nicht auf Geräteseite ausgeführt. Sie interagieren von der Hostseite aus mit dem Gerät, um die Messwerte zu erfassen, auf die sie ausgerichtet sind.

Design des Messwert-Collectors

Die Basisklasse, die alle Collector erweitern, ist BaseDeviceMetricCollector. Sie bietet dieselben gemeinsamen grundlegenden Funktionen:

  • Filtern
  • Deaktivierung
  • Sammlung von Testfällen im Vergleich zu Testläufen

Sie folgen dem Modell eines Ergebnisberichters, da sie mit der Testausführung auf dem Host synchronisiert werden. Mit anderen Worten: Wenn Tests hostbasiert sind, werden die Collectors ausgeführt, bevor der Test mit dem nächsten Ausführungsschritt fortfährt.

Wenn der Collector beispielsweise bei testEnded ausgeführt wird, werden die entsprechenden Daten erfasst, bevor mit testStart der nächste Test ausgeführt wird.

Hostbasierten Messwert-Collector implementieren

Wenn Sie die Basisklasse BaseDeviceMetricCollector implementieren, können Sie festlegen, wann die Messwerte während des Lebenszyklus erfasst werden sollen:

  • Wenn ein Testlauf beginnt: onTestRunStart
  • Zu Beginn eines Testfalls: onTestStart
  • Wenn ein Testfall endet: onTestEnd
  • Wenn ein Test abgeschlossen ist: onTestRunEnd

Asynchrone Datenerhebung durchführen

Zusätzlich zu den synchronen Methoden bietet TF eine Basisklasse zur Implementierung, die eine regelmäßige asynchrone Erhebung durchführt, ScheduledDeviceMetricCollector, die eine zu implementierende collect-Methode bietet, die regelmäßig ausgeführt wird.

Der Zeitraum kann über Optionen angepasst werden.

XML-Konfiguration

Das Objekt-Tag ist metrics_collector, z. B.:

<metrics_collector class="com.android.tradefed.device.metric.AtraceCollector">
    <option name="categories" value="freq"/>
</metrics_collector>

Empfehlungen

Sehen Sie sich die Liste der vorhandenen Messwerte an, um zu vermeiden, dass Sie Arbeit duplizieren. Wir versuchen, die Wiederverwendbarkeit zu maximieren. Wenn jeder Collector nur eine Art von Datenerhebung durchführt, können verschiedene Collector während der Testausführung besser kombiniert und abgeglichen werden.