IMetricCollector

public interface IMetricCollector
implements ILogSaverListener , IDisableable

com.android.tradefed.device.metric.IMetricCollector

Subclasses indiretas conhecidas AtraceCollector , AtraceRunMetricCollector , BaseDeviceMetricCollector , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CountTestCasesCollector , DebugHostLogOnFailureCollector , DeviceTraceCollector , FilePullerDeviceMetricCollector , FilePullerLogCollector , GcovCodeCoverageCollector , GcovKernelCodeCoverageCollector , and 11 others. AtraceCollectorName Um IMetricCollector que executa um rastreamento durante um teste e coleta o resultado e os registra na invocação. AtraceRunMetricCollectorName 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 base do 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 estatística predefinida aos dispositivos e coletará a duração da conexão Bluetooth para cada perfil. BluetoothConnectionStateCollector Esse coletor coletará métricas BluetoothConnectionStateChanged e registrará o número do estado da conexão para cada perfil. BugreportzOnFailureCollector Colete um relatório de bug quando um caso de teste falhar. BugreportzOnTestCaseFailureCollector Colete um bugreportz quando um caso de teste em uma execução falhar. ClangCodeCoverageCollector Um BaseDeviceMetricCollector que extrairá as 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 de caso de teste. DeviceTraceCollector Coletor que iniciará o rastreamento perfeito quando uma execução de teste for iniciada e o arquivo de rastreamento de log no final. FilePullerDeviceMetricCollector Um BaseDeviceMetricCollector que detecta a chave de métricas vinda do dispositivo e as extrai como um arquivo do dispositivo. FilePullerLogCollectorName Logger do arquivo reportado pelo device-side. GcovCodeCoverageCollector Um BaseDeviceMetricCollector que extrairá as medições de cobertura gcov do dispositivo e as registrará como artefatos de teste. GcovKernelCodeCoverageCollector Um BaseDeviceMetricCollector que extrairá as medições de cobertura do kernel gcov dos 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 irá 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 regex para analisar os sinais de início e fim de um evento das linhas do logcat. ModuleLogcatCollector Versão do coletor logcat, mas para o módulo. PerfettoPullerMetricCollector Implementação base do FilePullerDeviceMetricCollector que permite extrair os arquivos perfetto do dispositivo e coletar as métricas dele. RebootReasonCollector Coletor que coleta a reinicialização do dispositivo durante a execução do teste e os relata por motivo e contagens. RuntimeRestartCollector Coletor que coleta carimbos de data/hora de reinicializações do 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 base 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.

---

Essa interface será adicionada como um decorador ao relatar os resultados dos testes para coletar métricas correspondentes.

Esta interface não pode ser usada como mesmo estende ITestInvocationListener . A verificação da configuração irá rejeitá-lo. Deve ser usado como um "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 de nível de módulo e deve ser inicializado.
abstract	getBuildInfos () Retorna a lista de informações de construção 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) Callback 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) Callback quando um caso de teste é encerrado.
abstract void	onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics) onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics) Callback quando um caso de teste é encerrado.
abstract void	onTestFail ( DeviceMetricData testData, TestDescription test) Callback quando um caso de teste falha.
default void	onTestModuleEnded () Permite capturar o evento finalizado do módulo.
default void	onTestModuleStarted () Permite capturar o evento iniciado do módulo.
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) Callback quando uma execução de teste é iniciada.
default void	onTestRunStart ( DeviceMetricData runData, int testCount) Callback quando uma execução de teste é iniciada.
abstract void	onTestStart ( DeviceMetricData testData) Callback quando um caso de teste é iniciado.

Métodos públicos

captureModuleLevel

public boolean captureModuleLevel ()

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

devoluções
boolean

getBuildInfos

public abstract  getBuildInfos ()

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

devoluções

obter dispositivos

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 sempre 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.

lances
DeviceNotAvailableException

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

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

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

lances
DeviceNotAvailableException

onTestEnd

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

Callback quando um caso de teste é encerrado. Este deve ser o momento da limpeza.

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

lances
DeviceNotAvailableException

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Callback quando um caso de teste é encerrado. Este deve ser o momento da limpeza.

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

lances
DeviceNotAvailableException

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Callback quando um caso de teste falha.

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

lances
DeviceNotAvailableException

onTestModuleEnded

public void onTestModuleEnded ()

Permite capturar o evento finalizado do módulo.

lances
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

Permite capturar o evento iniciado do módulo.

lances
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 para a execução. Será o mesmo objeto durante onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) .
currentRunMetrics	: o mapa atual de métricas passadas para ERROR(/#testRunEnded(long,Map)) .

lances
DeviceNotAvailableException

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

Callback quando uma execução de teste é iniciada.

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

lances
DeviceNotAvailableException

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

Callback quando uma execução de teste é iniciada.

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

lances
DeviceNotAvailableException

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

Callback quando um caso de teste é iniciado.

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

lances
DeviceNotAvailableException