Ab 2026 werden wir, um unser stabiles Entwicklungsmodell für den Trunk zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten, den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen. Verwenden Sie android-latest-release, um AOSP zu entwickeln und dazu beizutragen. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

Bekannte indirekte Unterklassen

AtraceCollector, AtraceRunMetricCollector, BaseDeviceMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, FilePullerLogCollector und 16 weitere.

AtraceCollector	Ein `IMetricCollector`, das atrace während eines Tests ausführt, das Ergebnis erfasst und es im Aufruf protokolliert.
AtraceRunMetricCollector	Sammelt die Traces aus allen Testverzeichnissen unter dem angegebenen Verzeichnis vom Testgerät, protokolliert das Testverzeichnis und verarbeitet die Trace-Dateien im Testverzeichnis nach und fasst die Messwerte zusammen.
BaseDeviceMetricCollector	Die Basisimplementierung von `IMetricCollector` ermöglicht das Starten und Beenden der Erhebung auf `onTestRunStart(DeviceMetricData)` und `onTestRunEnd(DeviceMetricData,Map)`.
BluetoothConnectionLatencyCollector	Der Collector überträgt eine vordefinierte statsd-Messwertkonfiguration für die Dauer an Geräte und erfasst die Dauer der Bluetooth-Verbindung für jedes Profil.
BluetoothConnectionStateCollector	Dieser Collector erfasst BluetoothConnectionStateChanged-Messwerte und zeichnet die Verbindungsstatusnummer für jedes Profil auf.
BluetoothHciSnoopLogCollector	Collector zum Aktivieren der Bluetooth-HCI-Snoop-Protokollierung auf dem DUT und zum Erfassen des Protokolls für jeden Test.
BugreportzOnFailureCollector	Erstellen Sie einen Fehlerbericht, wenn ein Testlauf fehlschlägt.
BugreportzOnTestCaseFailureCollector	Erstellen Sie einen bugreportz, wenn ein Testlauf fehlschlägt.
ClangCodeCoverageCollector	Ein `BaseDeviceMetricCollector`, das Clang-Coverage-Messungen vom Gerät abruft und als Testartefakte protokolliert.
CodeCoverageCollector	Ein `BaseDeviceMetricCollector`, das Java- und native Abdeckungsmessungen vom Gerät abruft und als Testartefakte protokolliert.
CountTestCasesCollector	Zählt und meldet die Anzahl der Testläufe für eine bestimmte `IRemoteTest`.
DebugHostLogOnFailureCollector	Collector, der die Host-seitigen Logs erfasst und protokolliert, wenn ein Testlauf fehlschlägt.
DeviceTraceCollector	Collector, der beim Start eines Testlaufs einen Perfetto-Trace startet und am Ende die Trace-Datei protokolliert.
FilePullerDeviceMetricCollector	Ein `BaseDeviceMetricCollector`, das auf den vom Gerät gesendeten Messwertschlüssel wartet und die Messwerte als Datei vom Gerät abruft.
FilePullerLogCollector	Logger der Datei, die von der Geräteseite gemeldet wird.
GcovCodeCoverageCollector	Ein `BaseDeviceMetricCollector`, das gcov-Abdeckungsdaten vom Gerät abruft und als Testartefakte protokolliert.
GcovKernelCodeCoverageCollector	Ein `BaseDeviceMetricCollector`, das gcov-Kernel-Abdeckungsdaten aus debugfs und vom Gerät abruft und sie schließlich als Testartefakte protokolliert.
HostStatsdMetricCollector	Ein `IMetricCollector`, das StatsD-Messwerte von der Hostseite mit StatsD-Dienstprogramm-Befehlen erfasst.
JavaCodeCoverageCollector	Ein `BaseDeviceMetricCollector`, das Java-Abdeckungsdaten vom Gerät abruft und als Testartefakte protokolliert.
LogcatOnFailureCollector	Collector, der einen Logcat erfasst und protokolliert, wenn ein Testlauf oder Testlauf fehlschlägt.
LogcatTimingMetricCollector	Ein Messwert-Collector, der Zeitinformationen (z. B. die Zeit für den Nutzerwechsel) aus Logcat während eines oder mehrerer wiederholter Tests erfasst. Dazu werden die Start- und Endsignale eines Ereignisses aus Logcat-Zeilen mit den angegebenen regulären Ausdrücken geparst.
ModuleLogcatCollector	Version des Logcat-Collectors, aber für das Modul.
ModulePerfettoCollector	Collector, der den Perfetto-Trace startet, wenn ein Testmodul beginnt und endet und das Gerät neu gestartet wird.
PerfettoFilePullerCollector	Ein Collector, der Perfetto-Tracedateien vom Gerät abruft, sie optional komprimiert und den Testlogs hinzufügt.
PerfettoPullerMetricCollector	Diese Klasse wurde eingestellt. Verwenden Sie stattdessen `PerfettoFilePullerCollector` und `ERROR(/PerfettoTracePostProcessor)`.
RebootReasonCollector	Collector, der Geräte-Neustarts während des Testlaufs erfasst und nach Grund und Anzahl meldet.
RuntimeRestartCollector	Collector, der Zeitstempel von Laufzeitneustarts (Systemserverabstürzen) während des Testlaufs erfasst, sofern vorhanden.
ScreenRecordOnFailureCollector	Collector, der eine Bildschirmaufzeichnung aufzeichnet und protokolliert, wenn ein Testlauf fehlschlägt.
ScreenshotOnFailureCollector	Collector, der einen Screenshot aufnimmt und protokolliert, wenn ein Testlauf fehlschlägt.
ShowmapPullerMetricCollector	Basisimplementierung von `FilePullerDeviceMetricCollector`, mit der die Showmap-Dateien vom Gerät abgerufen und die Messwerte daraus erfasst werden können.
TraceCmdCollector	Eine `IMetricCollector`, die während des Tests mit trace-cmd Traces erfasst und sie im Aufruf protokolliert.

Diese Schnittstelle wird als Decorator hinzugefügt, wenn Testergebnisse gemeldet werden, um passende Messwerte zu erfassen.

Diese Schnittstelle kann nicht als verwendet werden, auch wenn sie ITestInvocationListener erweitert. Die Konfigurationsprüfung lehnt sie ab. Sie muss als „metrics_collector“ verwendet werden.

Von Collectors wird nicht erwartet, dass sie einen internen Status beibehalten, da sie an mehreren Stellen wiederverwendet werden können. Wenn ein interner Status wirklich verwendet werden muss, sollte er bei init(IInvocationContext,ITestInvocationListener) bereinigt werden.

Zusammenfassung

Öffentliche Methoden
`default boolean`	`captureModuleLevel()` Gibt an, ob der Collector für die Erfassung auf Modulebene geeignet ist und initialisiert werden sollte.
`default boolean`	`doesModuleContainFailure()` Gibt „true“ zurück, wenn das aktuelle Modul Testlauf- oder Testfallfehler enthält.
`default void`	`enableDefaultMetricCollection()` Ermöglicht es Collectoren, die standardmäßige Messwerterfassung zu aktivieren.
`default IMetricCollector.MetricCollectionLevel`	`getAlwaysOnCollectionLevel()`
`abstract List<IBuildInfo>`	`getBuildInfos()` Gibt die Liste der Build-Informationen zurück, die im Aufruf verfügbar sind.
`abstract List<ITestDevice>`	`getDevices()` Gibt die Liste der in der Anfrage verfügbaren Geräte zurück.
`abstract ITestInvocationListener`	`getInvocationListener()` Gibt die ursprüngliche `ITestInvocationListener` zurück, an die die Ergebnisse weitergeleitet werden.
`default IMetricCollector.MetricCollectionLevel`	`getOnFailureCollectionLevel()`
`abstract ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Initialisierung des Collectors mit dem aktuellen Kontext und Angabe des Ziels für die Weiterleitung der Ergebnisse.
`default boolean`	`isDefaultMetricCollectionEnabled()` Gibt an, ob der Collector Messwerte im Rahmen der Standardmesswerterfassung erfasst.
`abstract void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Callback, wenn ein Testlauf aufgrund eines Annahmefehlers fehlschlägt.
`abstract void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)` Callback, wenn ein Testlauf beendet wird.
`abstract void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)` Callback, wenn ein Testlauf beendet wird.
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Callback, wenn ein Testlauf fehlschlägt.
`default void`	`onTestModuleEnded()` Ermöglicht das Erfassen des Ereignisses „Modul beendet“.
`default void`	`onTestModuleStarted()` Ermöglicht das Erfassen des Ereignisses „Modul gestartet“.
`abstract void`	`onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)` Callback, wenn ein Testlauf beendet wird.
`abstract void`	`onTestRunStart(DeviceMetricData runData)` Callback, wenn ein Testlauf gestartet wird.
`default void`	`onTestRunStart(DeviceMetricData runData, int testCount)` Callback, wenn ein Testlauf gestartet wird.
`default void`	`onTestRunStartBlocking()` Expliziter Callback zum manuellen Starten eines Collectors, sofern dieser dies unterstützt.
`abstract void`	`onTestStart(DeviceMetricData testData)` Callback, wenn ein Testlauf gestartet wird.
`default void`	`setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Legt die Ebene fest, auf der der Collector unabhängig von Fehlern Logs erfassen soll.
`default void`	`setModuleContainsFailure()` Gibt an, ob im Modul Fehler aufgetreten sind (Testlauf, Testlauf).
`default void`	`setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Legt die Ebene fest, auf der der Collector bei Fehlern Logs erfassen soll.

Öffentliche Methoden

captureModuleLevel

public boolean captureModuleLevel ()

Gibt an, ob der Collector für die Erfassung auf Modulebene geeignet ist und initialisiert werden sollte.

Gibt Folgendes zurück:
`boolean`

doesModuleContainFailure

public boolean doesModuleContainFailure ()

Gibt „true“ zurück, wenn das aktuelle Modul Testlauf- oder Testfallfehler enthält.

Gibt Folgendes zurück:
`boolean`

enableDefaultMetricCollection

public void enableDefaultMetricCollection ()

Ermöglicht es Collectoren, die standardmäßige Messwerterfassung zu aktivieren. Wenn die Standarderfassung von Messwerten aktiviert ist, sollte der Collector nur auf der angegebenen Erfassungsebene Daten erfassen.

getAlwaysOnCollectionLevel

public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()

Gibt Folgendes zurück:
`IMetricCollector.MetricCollectionLevel`

getBuildInfos

public abstract List<IBuildInfo> getBuildInfos ()

Gibt die Liste der Build-Informationen zurück, die im Aufruf verfügbar sind.

Gibt Folgendes zurück:
`List<IBuildInfo>`

getDevices

public abstract List<ITestDevice> getDevices ()

Gibt die Liste der in der Anfrage verfügbaren Geräte zurück.

Gibt Folgendes zurück:
`List<ITestDevice>`

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

Gibt die ursprüngliche ITestInvocationListener zurück, an die die Ergebnisse weitergeleitet werden.

Gibt Folgendes zurück:
`ITestInvocationListener`

getOnFailureCollectionLevel

public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()

Gibt Folgendes zurück:
`IMetricCollector.MetricCollectionLevel`

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Initialisierung des Collectors mit dem aktuellen Kontext und Angabe des Ziels für die Weiterleitung der Ergebnisse. Wird nur einmal pro Instanz aufgerufen. Der Collector muss seinen internen Kontext und Listener aktualisieren. „Init“ wird während eines Testlaufs nie aufgerufen, sondern immer davor.

Überschreiben Sie die Funktion nur, wenn Sie wissen, was Sie tun.

Parameter
`context`	`IInvocationContext`: Der `IInvocationContext` für den laufenden Aufruf.
`listener`	`ITestInvocationListener`: die `ITestInvocationListener`, in die die Ergebnisse eingefügt werden sollen.

Gibt Folgendes zurück:
`ITestInvocationListener`	Der neue Listener umschließt den ursprünglichen Listener.

Löst aus
`DeviceNotAvailableException`

isDefaultMetricCollectionEnabled

public boolean isDefaultMetricCollectionEnabled ()

Gibt an, ob der Collector Messwerte im Rahmen der Standardmesswerterfassung erfasst.

Gibt Folgendes zurück:
`boolean`

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Callback, wenn ein Testlauf aufgrund eines Annahmefehlers fehlschlägt.

Parameter
`testData`	`DeviceMetricData`: Der `DeviceMetricData`, der die Daten für den Testlauf enthält.
`test`	`TestDescription`: die `TestDescription` des laufenden Testlaufs.

Löst aus
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, 
                TestDescription test)

Callback, wenn ein Testlauf beendet wird. Jetzt ist es an der Zeit, aufzuräumen.

Parameter
`testData`	`DeviceMetricData`: Der `DeviceMetricData`, der die Daten für den Testlauf enthält. Ist dasselbe Objekt wie während `onTestStart(DeviceMetricData)`.
`currentTestCaseMetrics`	`Map`: Die aktuelle Zuordnung von Messwerten, die an `testEnded(TestDescription,Map)` übergeben werden.
`test`	`TestDescription`: die `TestDescription` des laufenden Testlaufs.

Löst aus
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

Callback, wenn ein Testlauf beendet wird. Jetzt ist es an der Zeit, aufzuräumen.

Parameter
`testData`	`DeviceMetricData`: Der `DeviceMetricData`, der die Daten für den Testlauf enthält. Ist dasselbe Objekt wie während `onTestStart(DeviceMetricData)`.
`currentTestCaseMetrics`	`Map`: Die aktuelle Zuordnung von Messwerten, die an `testEnded(TestDescription,Map)` übergeben werden.

Löst aus
`DeviceNotAvailableException`

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Callback, wenn ein Testlauf fehlschlägt.

Parameter
`testData`	`DeviceMetricData`: Der `DeviceMetricData`, der die Daten für den Testlauf enthält.
`test`	`TestDescription`: die `TestDescription` des laufenden Testlaufs.

Löst aus
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

Ermöglicht das Erfassen des Ereignisses „Modul beendet“.

Löst aus
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

Ermöglicht das Erfassen des Ereignisses „Modul gestartet“.

Löst aus
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                Map<String, MetricMeasurement.Metric> currentRunMetrics)

Callback, wenn ein Testlauf beendet wird. Jetzt ist es an der Zeit, aufzuräumen.

Parameter
`runData`	`DeviceMetricData`: Der `DeviceMetricData` mit den Daten für den Lauf. Ist dasselbe Objekt wie während `onTestRunStart(DeviceMetricData)`.
`currentRunMetrics`	`Map`: Die aktuelle Zuordnung von Messwerten, die an `testRunEnded(long,Map)` übergeben werden.

Löst aus
`DeviceNotAvailableException`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

Callback, wenn ein Testlauf gestartet wird.

Parameter
`runData`	`DeviceMetricData`: Der `DeviceMetricData` mit den Daten für den Lauf.

Löst aus
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

Callback, wenn ein Testlauf gestartet wird.

Parameter
`runData`	`DeviceMetricData`: Der `DeviceMetricData` mit den Daten für den Lauf.
`testCount`	`int`: Die Anzahl der Testläufe in diesem Testlauf.

Löst aus
`DeviceNotAvailableException`

onTestRunStartBlocking

public void onTestRunStartBlocking ()

Expliziter Callback zum manuellen Starten eines Collectors, sofern dieser dies unterstützt. So können wir sicherstellen, dass wir uns nicht in einem asynchronen Testlebenszyklus befinden.

Löst aus
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

Callback, wenn ein Testlauf gestartet wird.

Parameter
`testData`	`DeviceMetricData`: Der `DeviceMetricData`, der die Daten für den Testlauf enthält.

Löst aus
`DeviceNotAvailableException`

setAlwaysOnCollectionLevel

public void setAlwaysOnCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Legt die Ebene fest, auf der der Collector unabhängig von Fehlern Logs erfassen soll.

Bei NULL-Level erfolgt keine Erhebung.

Parameter
`level`	`IMetricCollector.MetricCollectionLevel`: `MetricCollectionLevel`, auf der die Logs erfasst werden.

setModuleContainsFailure

public void setModuleContainsFailure ()

Gibt an, ob im Modul Fehler aufgetreten sind (Testlauf, Testlauf).

setOnFailureCollectionLevel

public void setOnFailureCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Legt die Ebene fest, auf der der Collector bei Fehlern Logs erfassen soll.

Bei NULL-Level erfolgt keine Erhebung.

Parameter
`level`	`IMetricCollector.MetricCollectionLevel`: `MetricCollectionLevel`, auf der die Logs erfasst werden.