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.