A partir de 2026, para alinearnos con nuestro modelo de desarrollo llamado Trunk Stable y garantizar la estabilidad de la plataforma para el ecosistema, publicaremos el código fuente en el AOSP en el segundo y cuarto trimestre. Para compilar el AOSP y contribuir a él, usa android-latest-release. La rama del manifiesto android-latest-release siempre hará referencia a la versión más reciente que se envió al AOSP. Para obtener más información, consulta Cambios en el 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

Subcategorías indirectas conocidas

AtraceCollector, AtraceRunMetricCollector, BaseDeviceMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, FilePullerLogCollector y 16 más.

AtraceCollector	Un `IMetricCollector` que ejecuta atrace durante una prueba y recopila el resultado y lo registra en la invocación.
AtraceRunMetricCollector	Recopila los registros de todos los directorios de prueba del directorio determinado del dispositivo de prueba, registra el directorio de prueba y posprocesa los archivos de registro del directorio de prueba, y agrega las métricas.
BaseDeviceMetricCollector	Es la implementación base de `IMetricCollector` que permite iniciar y detener la recopilación en `onTestRunStart(DeviceMetricData)` y `onTestRunEnd(DeviceMetricData,Map)`.
BluetoothConnectionLatencyCollector	El recopilador enviará una configuración de métricas de duración de statsd predefinida a los dispositivos y recopilará la duración de la conexión Bluetooth para cada perfil.
BluetoothConnectionStateCollector	Este recopilador recopilará métricas de BluetoothConnectionStateChanged y registrará el número de estado de conexión para cada perfil.
BluetoothHciSnoopLogCollector	Es el recopilador que habilita el registro de búsqueda de HCI de Bluetooth en el DUT y recopila el registro de cada prueba.
BugreportzOnFailureCollector	Recopila un bugreportz cuando falla un caso de prueba.
BugreportzOnTestCaseFailureCollector	Recopila un bugreportz cuando falla un caso de prueba en una ejecución.
ClangCodeCoverageCollector	Un `BaseDeviceMetricCollector` que extraerá las mediciones de cobertura de Clang del dispositivo y las registrará como artefactos de prueba.
CodeCoverageCollector	Un `BaseDeviceMetricCollector` que extraerá las mediciones de cobertura nativa y de Java del dispositivo y las registrará como artefactos de prueba.
CountTestCasesCollector	Cuenta y registra la cantidad de casos de prueba para un `IRemoteTest` determinado.
DebugHostLogOnFailureCollector	Es el recopilador que reunirá y registrará los registros del host cuando se produzca un error en un caso de prueba.
DeviceTraceCollector	Es el recopilador que iniciará el registro de perfetto cuando comience una ejecución de prueba y registrará el archivo de registro al final.
FilePullerDeviceMetricCollector	Un `BaseDeviceMetricCollector` que escucha la clave de métricas proveniente del dispositivo y las extrae como un archivo del dispositivo.
FilePullerLogCollector	Es el registrador del archivo que informa el dispositivo.
GcovCodeCoverageCollector	Un `BaseDeviceMetricCollector` que extraerá las mediciones de cobertura de gcov del dispositivo y las registrará como artefactos de prueba.
GcovKernelCodeCoverageCollector	Un `BaseDeviceMetricCollector` que extraerá las mediciones de cobertura del kernel de gcov de debugfs y del dispositivo, y, luego, las registrará como artefactos de prueba.
HostStatsdMetricCollector	Un `IMetricCollector` que recopila métricas de statsd desde el host con comandos de utilidad de statsd.
JavaCodeCoverageCollector	Un `BaseDeviceMetricCollector` que extraerá las mediciones de cobertura de Java del dispositivo y las registrará como artefactos de prueba.
LogcatOnFailureCollector	Es el recopilador que capturará y registrará un logcat cuando falle un caso de prueba o una ejecución de prueba.
LogcatTimingMetricCollector	Es un recopilador de métricas que recopila información de sincronización (p.ej., el tiempo de cambio de usuario) de logcat durante una o varias pruebas repetidas con patrones de regex determinados para analizar los indicadores de inicio y finalización de un evento a partir de las líneas de logcat.
ModuleLogcatCollector	Es la versión del recopilador de logcat, pero para el módulo.
ModulePerfettoCollector	Es el recopilador que iniciará el registro de perfetto cuando se inicie y finalice un módulo de prueba, y cuando se reinicie el dispositivo.
PerfettoFilePullerCollector	Es un recopilador que extrae archivos de registro de Perfetto del dispositivo, los comprime de forma opcional y los agrega a los registros de prueba.
PerfettoPullerMetricCollector	Esta clase dejó de estar disponible. En su lugar, usa `PerfettoFilePullerCollector` y `ERROR(/PerfettoTracePostProcessor)`.
RebootReasonCollector	Es un recopilador que recopila los reinicios del dispositivo durante la ejecución de la prueba y los informa por motivo y recuento.
RuntimeRestartCollector	Es el recopilador que recopila las marcas de tiempo de los reinicios del entorno de ejecución (fallas del servidor del sistema) durante la ejecución de la prueba, si hay alguno.
ScreenRecordOnFailureCollector	Es el recopilador que capturará y registrará una grabación de pantalla cuando falle un caso de prueba.
ScreenshotOnFailureCollector	Es un recopilador que capturará y registrará una captura de pantalla cuando falle un caso de prueba.
ShowmapPullerMetricCollector	Implementación base de `FilePullerDeviceMetricCollector` que permite extraer los archivos de showmap del dispositivo y recopilar las métricas de ellos.
TraceCmdCollector	Un `IMetricCollector` que recopila registros durante la prueba con trace-cmd y los registra en la invocación.

Esta interfaz se agregará como un decorador cuando se informen los resultados de las pruebas para recopilar métricas coincidentes.

Esta interfaz no se puede usar como , incluso si extiende ITestInvocationListener. La verificación de configuración la rechazará. Se debe usar como "metrics_collector".

No se espera que los recopiladores mantengan un estado interno, ya que se pueden volver a usar en varios lugares. Si realmente se debe usar un estado interno, se debe limpiar en init(IInvocationContext,ITestInvocationListener).

Resumen

Métodos públicos
`default boolean`	`captureModuleLevel()` Indica si el recopilador se aplica a la captura a nivel del módulo y si se debe inicializar.
`default boolean`	`doesModuleContainFailure()` Devuelve verdadero si el módulo actual contenía algún caso de prueba o fallas en la ejecución de pruebas.
`default void`	`enableDefaultMetricCollection()` Permite que los recopiladores habiliten la recopilación de métricas predeterminadas.
`default IMetricCollector.MetricCollectionLevel`	`getAlwaysOnCollectionLevel()`
`abstract List<IBuildInfo>`	`getBuildInfos()` Devuelve la lista de información de compilación disponible en la invocación.
`abstract List<ITestDevice>`	`getDevices()` Devuelve la lista de dispositivos disponibles en la invocación.
`abstract ITestInvocationListener`	`getInvocationListener()` Devuelve el `ITestInvocationListener` original al que reenviamos los resultados.
`default IMetricCollector.MetricCollectionLevel`	`getOnFailureCollectionLevel()`
`abstract ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Inicialización del recopilador con el contexto actual y el lugar al que se deben reenviar los resultados.
`default boolean`	`isDefaultMetricCollectionEnabled()` Indica si el recopilador recopila métricas como parte de la recopilación de métricas predeterminada.
`abstract void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Devolución de llamada cuando falla un caso de prueba debido a una falla de suposición.
`abstract void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)` Devolución de llamada cuando finaliza un caso de prueba.
`abstract void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)` Devolución de llamada cuando finaliza un caso de prueba.
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Devolución de llamada cuando falla un caso de prueba.
`default void`	`onTestModuleEnded()` Permite capturar el evento de finalización del módulo.
`default void`	`onTestModuleStarted()` Permite capturar el evento de inicio del módulo.
`abstract void`	`onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)` Devolución de llamada cuando finaliza una ejecución de prueba.
`abstract void`	`onTestRunStart(DeviceMetricData runData)` Devolución de llamada cuando se inicia una ejecución de prueba.
`default void`	`onTestRunStart(DeviceMetricData runData, int testCount)` Devolución de llamada cuando se inicia una ejecución de prueba.
`default void`	`onTestRunStartBlocking()` Es una devolución de llamada explícita para iniciar un recopilador de forma manual si lo admite.
`abstract void`	`onTestStart(DeviceMetricData testData)` Es la devolución de llamada cuando se inicia un caso de prueba.
`default void`	`setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Establece el nivel en el que el recopilador debe recopilar registros, independientemente de las fallas.
`default void`	`setModuleContainsFailure()` Establece si el módulo tuvo alguna falla (caso de prueba, ejecución de prueba).
`default void`	`setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Establece el nivel en el que el recopilador debe recopilar registros durante las fallas.

Métodos públicos

captureModuleLevel

public boolean captureModuleLevel ()

Indica si el recopilador se aplica a la captura a nivel del módulo y si se debe inicializar.

Muestra
`boolean`

doesModuleContainFailure

public boolean doesModuleContainFailure ()

Devuelve verdadero si el módulo actual contenía algún caso de prueba o fallas en la ejecución de pruebas.

Muestra
`boolean`

enableDefaultMetricCollection

public void enableDefaultMetricCollection ()

Permite que los recopiladores habiliten la recopilación de métricas predeterminadas. Cuando la recopilación de métricas predeterminada está habilitada, el recopilador solo debe recopilar en el nivel de recopilación especificado.

getAlwaysOnCollectionLevel

public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()

Muestra
`IMetricCollector.MetricCollectionLevel`

getBuildInfos

public abstract List<IBuildInfo> getBuildInfos ()

Devuelve la lista de información de compilación disponible en la invocación.

Muestra
`List<IBuildInfo>`

getDevices

public abstract List<ITestDevice> getDevices ()

Devuelve la lista de dispositivos disponibles en la invocación.

Muestra
`List<ITestDevice>`

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

Devuelve el ITestInvocationListener original al que reenviamos los resultados.

Muestra
`ITestInvocationListener`

getOnFailureCollectionLevel

public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()

Muestra
`IMetricCollector.MetricCollectionLevel`

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Inicialización del recopilador con el contexto actual y el lugar al que se deben reenviar los resultados. Solo se llamará una vez por instancia, y se espera que el recopilador actualice su contexto interno y su objeto de escucha. Nunca se llamará a Init durante una ejecución de prueba siempre anterior.

No anules este método, a menos que sepas lo que estás haciendo.

Parámetros
`context`	`IInvocationContext`: Es el `IInvocationContext` de la invocación en curso.
`listener`	`ITestInvocationListener`: Es el `ITestInvocationListener` en el que se colocarán los resultados.

Muestra
`ITestInvocationListener`	Es el nuevo objeto de escucha que envuelve al original.

Arroja
`DeviceNotAvailableException`

isDefaultMetricCollectionEnabled

public boolean isDefaultMetricCollectionEnabled ()

Indica si el recopilador recopila métricas como parte de la recopilación de métricas predeterminada.

Muestra
`boolean`

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Devolución de llamada cuando falla un caso de prueba debido a una falla de suposición.

Parámetros
`testData`	`DeviceMetricData`: Es el `DeviceMetricData` que contiene los datos del caso de prueba.
`test`	`TestDescription`: Es el `TestDescription` del caso de prueba en curso.

Arroja
`DeviceNotAvailableException`

onTestEnd

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

Devolución de llamada cuando finaliza un caso de prueba. Este debería ser el momento de limpiar.

Parámetros
`testData`	`DeviceMetricData`: Es el `DeviceMetricData` que contiene los datos del caso de prueba. Será el mismo objeto que durante `onTestStart(DeviceMetricData)`.
`currentTestCaseMetrics`	`Map`: Es el mapa actual de métricas que se pasa a `testEnded(TestDescription,Map)`.
`test`	`TestDescription`: Es el `TestDescription` del caso de prueba en curso.

Arroja
`DeviceNotAvailableException`

onTestEnd

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

Devolución de llamada cuando finaliza un caso de prueba. Este debería ser el momento de limpiar.

Parámetros
`testData`	`DeviceMetricData`: Es el `DeviceMetricData` que contiene los datos del caso de prueba. Será el mismo objeto que durante `onTestStart(DeviceMetricData)`.
`currentTestCaseMetrics`	`Map`: Es el mapa actual de métricas que se pasa a `testEnded(TestDescription,Map)`.

Arroja
`DeviceNotAvailableException`

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Devolución de llamada cuando falla un caso de prueba.

Parámetros
`testData`	`DeviceMetricData`: Es el `DeviceMetricData` que contiene los datos del caso de prueba.
`test`	`TestDescription`: Es el `TestDescription` del caso de prueba en curso.

Arroja
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

Permite capturar el evento de finalización del módulo.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

Permite capturar el evento de inicio del módulo.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunEnd

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

Devolución de llamada cuando finaliza una ejecución de prueba. Este debería ser el momento de limpiar.

Parámetros
`runData`	`DeviceMetricData`: Es el `DeviceMetricData` que contiene los datos de la ejecución. Será el mismo objeto que durante `onTestRunStart(DeviceMetricData)`.
`currentRunMetrics`	`Map`: Es el mapa actual de métricas que se pasa a `testRunEnded(long,Map)`.

Arroja
`DeviceNotAvailableException`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

Devolución de llamada cuando se inicia una ejecución de prueba.

Parámetros
`runData`	`DeviceMetricData`: Es el `DeviceMetricData` que contiene los datos de la ejecución.

Arroja
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

Devolución de llamada cuando se inicia una ejecución de prueba.

Parámetros
`runData`	`DeviceMetricData`: Es el `DeviceMetricData` que contiene los datos de la ejecución.
`testCount`	`int`: Es la cantidad de casos de prueba en esta ejecución de prueba.

Arroja
`DeviceNotAvailableException`

onTestRunStartBlocking

public void onTestRunStartBlocking ()

Es una devolución de llamada explícita para iniciar un recopilador de forma manual si lo admite. Esto permite garantizar que salimos de algún ciclo de vida de prueba que es asíncrono.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

Es la devolución de llamada cuando se inicia un caso de prueba.

Parámetros
`testData`	`DeviceMetricData`: Es el `DeviceMetricData` que contiene los datos del caso de prueba.

Arroja
`DeviceNotAvailableException`

setAlwaysOnCollectionLevel

public void setAlwaysOnCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Establece el nivel en el que el recopilador debe recopilar registros, independientemente de las fallas.

El nivel NULL no generará ninguna recopilación.

Parámetros
`level`	`IMetricCollector.MetricCollectionLevel`: `MetricCollectionLevel` en el que se recopilarán los registros.

setModuleContainsFailure

public void setModuleContainsFailure ()

Establece si el módulo tuvo alguna falla (caso de prueba, ejecución de prueba).

setOnFailureCollectionLevel

public void setOnFailureCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Establece el nivel en el que el recopilador debe recopilar registros durante las fallas.

El nivel NULL no generará ninguna recopilación.

Parámetros
`level`	`IMetricCollector.MetricCollectionLevel`: `MetricCollectionLevel` en el que se recopilarán los registros.