Coletor IMetric

public interface IMetricCollector
implements ILogSaverListener , IDisableable

com.android.tradefed.device.metric.IMetricCollector

Subclasses indiretas conhecidas AtraceCollector , AtraceRunMetricCollector , BaseDeviceMetricCollector , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothHciSnoopLogCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CountTestCasesCollector , DebugHostLogOnFail ureCollector , DeviceTraceCollector , FilePullerDeviceMetricCollector , FilePullerLogCollector , GcovCodeCoverageCollector e 12 outros. AtraceCollector Um IMetricCollector que executa umtrace durante um teste e coleta o resultado e registra-o na invocação. Coletor AtraceRunMetric Coleta os rastreamentos de todo o diretório de teste no diretório fornecido do dispositivo de teste, registra o diretório de teste e pós-processa os arquivos de rastreamento no diretório de teste e agrega as métricas. BaseDeviceMetricCollector Implementação básica de IMetricCollector que permite iniciar e parar a coleta em onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) e ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) . BluetoothConnectionLatencyCollector O coletor enviará uma configuração de métrica de duração statsd predefinida para os dispositivos e coletará a duração da conexão Bluetooth para cada perfil. BluetoothConnectionStateCollector Este coletor coletará métricas BluetoothConnectionStateChanged e registrará o número do estado da conexão para cada perfil. BluetoothHciSnoopLogCollector Coletor para ativar o registro de espionagem Bluetooth HCI no DUT e coletar o registro para cada teste. BugreportzOnFailureCollector Colete um bugreportz quando um caso de teste falhar. BugreportzOnTestCaseFailureCollector Colete um bugreportz quando um caso de teste falhar em uma execução. ClangCodeCoverageCollector Um BaseDeviceMetricCollector que extrairá medições de cobertura Clang do dispositivo e as registrará como artefatos de teste. CountTestCasesCollector Conte e relate o número de casos de teste para um determinado IRemoteTest . DebugHostLogOnFailureCollector Coletor que reunirá e registrará os logs do lado do host quando ocorrer uma falha no caso de teste. Coletor DeviceTrace Coletor que iniciará o rastreamento perfeito quando uma execução de teste for iniciada e registrará o arquivo de rastreamento no final. FilePullerDeviceMetricCollector Um BaseDeviceMetricCollector que escuta a chave de métricas proveniente do dispositivo e as extrai como um arquivo do dispositivo. FilePullerLogCollector Registrador do arquivo relatado pelo lado do dispositivo. Coletor GcovCodeCoverage Um BaseDeviceMetricCollector que extrairá medições de cobertura gcov do dispositivo e as registrará como artefatos de teste. GcovKernelCodeCoverageCollector Um BaseDeviceMetricCollector que extrairá medições de cobertura do kernel gcov do debugfs e do dispositivo e, finalmente, as registrará como artefatos de teste. HostStatsdMetricCollector Um IMetricCollector que coleta métricas statsd do lado do host usando comandos do utilitário statsd. JavaCodeCoverageCollector Um BaseDeviceMetricCollector que extrairá medições de cobertura Java do dispositivo e as registrará como artefatos de teste. LogcatOnFailureCollector Coletor que capturará e registrará um logcat quando um caso de teste falhar. LogcatTimingMetricCollector Um coletor de métrica que coleta informações de tempo (por exemplo, tempo de troca do usuário) do logcat durante um ou vários testes repetidos usando determinados padrões de regex para analisar sinais de início e fim de um evento a partir de linhas de logcat. MóduloLogcatCollector Versão do coletor logcat, mas para módulo. PerfettoPullerMetricCollector Implementação básica do FilePullerDeviceMetricCollector que permite extrair os arquivos perfeitos do dispositivo e coletar as métricas dele. RebootReasonCollector Coletor que coleta reinicializações do dispositivo durante a execução do teste e as reporta por motivo e contagens. RuntimeRestartCollector Coletor que coleta carimbos de data/hora de reinicializações de tempo de execução (travamentos do servidor do sistema) durante a execução do teste, se houver. Captura de telaOnFailureCollector Coletor que irá capturar e registrar uma captura de tela quando um caso de teste falhar. ShowmapPullerMetricCollector Implementação básica do FilePullerDeviceMetricCollector que permite extrair os arquivos showmap do dispositivo e coletar as métricas dele. TraceCmdCollector Um IMetricCollector que coleta rastreamentos durante o teste usando trace-cmd e os registra na invocação.

---

Esta interface será adicionada como decorador ao relatar resultados de testes para coletar métricas correspondentes.

Esta interface não pode ser usada como até estende ITestInvocationListener . A verificação da configuração irá rejeitá-lo. Deve ser usado como "metrics_collector".

Não se espera que os coletores mantenham um estado interno, pois podem ser reutilizados em vários locais. Se um estado interno realmente precisar ser usado, ele deverá ser limpo em init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener) .

Resumo

Métodos públicos
default boolean	captureModuleLevel () Se o coletor é ou não aplicável à captura em nível de módulo e deve ser init.
abstract	getBuildInfos () Retorna a lista de informações de build disponíveis na invocação.
abstract	getDevices () Retorna a lista de dispositivos disponíveis na invocação.
abstract ITestInvocationListener	getInvocationListener () Retorna o ITestInvocationListener original para onde estamos encaminhando os resultados.
abstract ITestInvocationListener	init ( IInvocationContext context, ITestInvocationListener listener) Inicialização do coletor com o contexto atual e para onde encaminhar os resultados.
abstract void	onTestAssumptionFailure ( DeviceMetricData testData, TestDescription test) Retorno de chamada quando um caso de teste falha com falha de suposição.
abstract void	onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test) onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test) Retorno de chamada quando um caso de teste é finalizado.
abstract void	onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics) onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics) Retorno de chamada quando um caso de teste é finalizado.
abstract void	onTestFail ( DeviceMetricData testData, TestDescription test) Retorno de chamada quando um caso de teste falha.
default void	onTestModuleEnded () Permite capturar o evento de término do módulo.
default void	onTestModuleStarted () Permite capturar o evento de módulo iniciado.
abstract void	onTestRunEnd ( DeviceMetricData runData, currentRunMetrics) onTestRunEnd ( DeviceMetricData runData, currentRunMetrics) Retorno de chamada quando uma execução de teste é encerrada.
abstract void	onTestRunStart ( DeviceMetricData runData) Retorno de chamada quando uma execução de teste é iniciada.
default void	onTestRunStart ( DeviceMetricData runData, int testCount) Retorno de chamada quando uma execução de teste é iniciada.
abstract void	onTestStart ( DeviceMetricData testData) Retorno de chamada quando um caso de teste é iniciado.

Métodos públicos

captureModuleLevel

public boolean captureModuleLevel ()

Se o coletor é ou não aplicável à captura em nível de módulo e deve ser init.

Devoluções
boolean

getBuildInfos

public abstract  getBuildInfos ()

Retorna a lista de informações de build disponíveis na invocação.

Devoluções

getDispositivos

public abstract  getDevices ()

Retorna a lista de dispositivos disponíveis na invocação.

Devoluções

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

Retorna o ITestInvocationListener original para onde estamos encaminhando os resultados.

Devoluções
ITestInvocationListener

iniciar

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Inicialização do coletor com o contexto atual e para onde encaminhar os resultados. Será chamado apenas uma vez por instância e espera-se que o coletor atualize seu contexto interno e ouvinte. Init nunca será chamado durante uma execução de teste antes.

Não substitua a menos que você saiba o que está fazendo.

Parâmetros
context	IInvocationContext : o IInvocationContext para a invocação em andamento.
listener	ITestInvocationListener : o ITestInvocationListener onde colocar os resultados.

Devoluções
ITestInvocationListener	o novo ouvinte envolvendo o original.

Lança
DeviceNotAvailableException

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Retorno de chamada quando um caso de teste falha com falha de suposição.

Parâmetros
testData	DeviceMetricData : o DeviceMetricData que contém os dados do caso de teste.
test	TestDescription : o TestDescription do caso de teste em andamento.

Lança
DeviceNotAvailableException

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

Retorno de chamada quando um caso de teste é finalizado. Este deve ser o momento da limpeza.

Parâmetros
testData	DeviceMetricData : o DeviceMetricData que contém os dados do caso de teste. Será o mesmo objeto de onTestStart(com.android.tradefed.device.metric.DeviceMetricData) .
currentTestCaseMetrics	: o mapa atual de métricas passado para ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) .
test	TestDescription : o TestDescription do caso de teste em andamento.

Lança
DeviceNotAvailableException

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Retorno de chamada quando um caso de teste é finalizado. Este deve ser o momento da limpeza.

Parâmetros
testData	DeviceMetricData : o DeviceMetricData que contém os dados do caso de teste. Será o mesmo objeto de onTestStart(com.android.tradefed.device.metric.DeviceMetricData) .
currentTestCaseMetrics	: o mapa atual de métricas passado para ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) .

Lança
DeviceNotAvailableException

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Retorno de chamada quando um caso de teste falha.

Parâmetros
testData	DeviceMetricData : o DeviceMetricData que contém os dados do caso de teste.
test	TestDescription : o TestDescription do caso de teste em andamento.

Lança
DeviceNotAvailableException

onTestModuleEnded

public void onTestModuleEnded ()

Permite capturar o evento de término do módulo.

Lança
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

Permite capturar o evento de módulo iniciado.

Lança
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Retorno de chamada quando uma execução de teste é encerrada. Este deve ser o momento da limpeza.

Parâmetros
runData	DeviceMetricData : o DeviceMetricData que contém os dados da execução. Será o mesmo objeto de onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) .
currentRunMetrics	: o mapa atual de métricas passado para ERROR(/#testRunEnded(long,Map)) .

Lança
DeviceNotAvailableException

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

Retorno de chamada quando uma execução de teste é iniciada.

Parâmetros
runData	DeviceMetricData : o DeviceMetricData que contém os dados da execução.

Lança
DeviceNotAvailableException

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

Retorno de chamada quando uma execução de teste é iniciada.

Parâmetros
runData	DeviceMetricData : o DeviceMetricData que contém os dados da execução.
testCount	int : o número de casos de teste nesta execução de teste.

Lança
DeviceNotAvailableException

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

Retorno de chamada quando um caso de teste é iniciado.

Parâmetros
testData	DeviceMetricData : o DeviceMetricData que contém os dados do caso de teste.

Lança
DeviceNotAvailableException