IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

Sottoclassi indirette note AtraceCollector, AtraceRunMetricCollector, BaseDeviceMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, FilePullerLogCollector e altri 16. AtraceCollector Un IMetricCollector che esegue una traccia durante un test e raccoglie il risultato e il log per l'invocazione.  AtraceRunMetricCollector Raccoglie le tracce da tutte le directory di test nella directory specificata dal dispositivo di test, registra la directory di test ed elabora i file di traccia nella directory di test e aggrega le metriche.  BaseDeviceMetricCollector Implementazione di base di IMetricCollector che consente di avviare e interrompere la raccolta su onTestRunStart(DeviceMetricData) e onTestRunEnd(DeviceMetricData,Map).  BluetoothConnectionLatencyCollector L'agente di raccolta invierà ai dispositivi una configurazione predefinita della metrica di durata statsd e raccoglierà la durata della connessione Bluetooth per ogni profilo.  BluetoothConnectionStateCollector Questo agente di raccolta raccoglierà le metriche BluetoothConnectionStateChanged e registrerà il numero di stato della connessione per ogni profilo.  BluetoothHciSnoopLogCollector Collector per attivare la registrazione di esame HCI Bluetooth sul DUT e raccogliere il log per ogni test.  BugreportzOnFailureCollector Raccogli un bugreportz quando uno scenario di test non riesce.  BugreportzOnTestCaseFailureCollector Raccogli un bugreportz quando uno scenario di test in un'esecuzione non riesce.  ClangCodeCoverageCollector Un BaseDeviceMetricCollector che estrae le misurazioni della copertura Clang dal dispositivo e le registra come artefatti di test.  CodeCoverageCollector Un BaseDeviceMetricCollector che estrae le misurazioni della copertura Java e nativa dal dispositivo e le registra come artefatti di test.  CountTestCasesCollector Conta e segnala il numero di scenari di test per un determinato IRemoteTest.  DebugHostLogOnFailureCollector Agente di raccolta che raccoglierà e registrerà i log lato host quando si verifica un errore dello scenario di test.  DeviceTraceCollector Il raccoglitore che avvierà la traccia perfetto all'inizio di un test e registrerà il file di traccia al termine.  FilePullerDeviceMetricCollector Un BaseDeviceMetricCollector che ascolta la chiave delle metriche proveniente dal dispositivo e le estrae come file dal dispositivo.  FilePullerLogCollector Logger del file segnalato dal lato dispositivo.  GcovCodeCoverageCollector Un BaseDeviceMetricCollector che estrae le misurazioni della copertura gcov dal dispositivo e le registra come artefatti di test.  GcovKernelCodeCoverageCollector Un BaseDeviceMetricCollector che estrae le misurazioni della copertura del kernel gcov da debugfs e dal dispositivo e le registra infine come artefatti di test.  HostStatsdMetricCollector Un IMetricCollector che raccoglie le metriche statsd dal lato host utilizzando i comandi dell'utilità statsd.  JavaCodeCoverageCollector Un BaseDeviceMetricCollector che estrae le misurazioni della copertura Java dal dispositivo e le registra come artefatti di test.  LogcatOnFailureCollector Il raccoglitore che acquisisce e registra un logcat quando uno scenario di test o un'esecuzione di test non riesce.  LogcatTimingMetricCollector Un agente di raccolta di metriche che raccoglie informazioni sulla sincronizzazione (ad es. tempo di cambio utente) da logcat durante uno o più test ripetuti utilizzando espressioni regolari fornite per analizzare i segnali di inizio e fine di un evento dalle righe di logcat.  ModuleLogcatCollector Versione del raccoglitore logcat, ma per il modulo.  ModulePerfettoCollector Collector che avvierà la traccia Perfetto all'inizio e alla fine di un modulo di test e al riavvio del dispositivo.  PerfettoFilePullerCollector Un agente di raccolta che esegue il pull dei file di traccia Perfetto dal dispositivo, li comprime facoltativamente e li aggiunge ai log di test.  PerfettoPullerMetricCollector Questa classe è obsoleta. Utilizza invece PerfettoFilePullerCollector e ERROR(/PerfettoTracePostProcessor).  RebootReasonCollector Agente di raccolta che raccoglie i riavvii del dispositivo durante l'esecuzione del test e li segnala per motivo e conteggio.  RuntimeRestartCollector Agente di raccolta che raccoglie i timestamp dei riavvii del runtime (arresti anomali del server di sistema) durante l'esecuzione del test, se presenti.  ScreenRecordOnFailureCollector Il raccoglitore che acquisisce e registra una registrazione dello schermo quando uno scenario di test non riesce.  ScreenshotOnFailureCollector Il raccoglitore che acquisisce e registra uno screenshot quando uno scenario di test non va a buon fine.  ShowmapPullerMetricCollector Implementazione di base di FilePullerDeviceMetricCollector che consente di estrarre i file showmap dal dispositivo e raccogliere le metriche.  TraceCmdCollector Un IMetricCollector che raccoglie le tracce durante il test utilizzando trace-cmd e le registra nell'invocazione.

---

Questa interfaccia verrà aggiunta come decoratore durante la generazione di report sui risultati dei test per raccogliere le metriche corrispondenti.

Questa interfaccia non può essere utilizzata come anche se estende ITestInvocationListener. Il controllo della configurazione lo rifiuterà. Deve essere utilizzato come "metrics_collector".

Non è previsto che i raccoglitori mantengano uno stato interno, in quanto potrebbero essere riutilizzati in più posizioni. Se uno stato interno deve essere utilizzato, deve essere pulito su init(IInvocationContext,ITestInvocationListener).

Riepilogo

Metodi pubblici
default boolean	captureModuleLevel() Indica se l'agente di raccolta è applicabile all'acquisizione a livello di modulo e deve essere inizializzato.
default boolean	doesModuleContainFailure() Restituisce true se il modulo corrente contiene errori di test case o di esecuzione dei test.
default void	enableDefaultMetricCollection() Consente agli agenti di raccolta di abilitare la raccolta delle metriche predefinita.
default IMetricCollector.MetricCollectionLevel	getAlwaysOnCollectionLevel()
abstract List<IBuildInfo>	getBuildInfos() Restituisce l'elenco delle informazioni sulla build disponibili nella chiamata.
abstract List<ITestDevice>	getDevices() Restituisce l'elenco dei dispositivi disponibili nella chiamata.
abstract ITestInvocationListener	getInvocationListener() Restituisce l'ITestInvocationListener originale a cui inoltriamo i risultati.
default IMetricCollector.MetricCollectionLevel	getOnFailureCollectionLevel()
abstract ITestInvocationListener	init(IInvocationContext context, ITestInvocationListener listener) Inizializzazione dell'agente di raccolta con il contesto corrente e la destinazione a cui inoltrare i risultati.
default boolean	isDefaultMetricCollectionEnabled() Indica se l'agente di raccolta raccoglie metriche nell'ambito della raccolta di metriche predefinita.
abstract void	onTestAssumptionFailure(DeviceMetricData testData, TestDescription test) Callback quando uno scenario di test non riesce a causa di un errore di ipotesi.
abstract void	onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test) Callback al termine di uno scenario di test.
abstract void	onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics) Callback al termine di uno scenario di test.
abstract void	onTestFail(DeviceMetricData testData, TestDescription test) Callback quando uno scenario di test non riesce.
default void	onTestModuleEnded() Consente di acquisire l'evento di fine del modulo.
default void	onTestModuleStarted() Consente di acquisire l'evento di avvio del modulo.
abstract void	onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics) Callback al termine di un test.
abstract void	onTestRunStart(DeviceMetricData runData) Callback quando viene avviata un'esecuzione di test.
default void	onTestRunStart(DeviceMetricData runData, int testCount) Callback quando viene avviata un'esecuzione di test.
default void	onTestRunStartBlocking() Callback esplicito per avviare manualmente un raccoglitore, se supportato.
abstract void	onTestStart(DeviceMetricData testData) Callback quando viene avviato uno scenario di test.
default void	setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level) Imposta il livello a cui l'agente di raccolta deve raccogliere i log indipendentemente dagli errori.
default void	setModuleContainsFailure() Indica se il modulo ha avuto errori (scenario di test, esecuzione del test).
default void	setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level) Imposta il livello a cui l'agente di raccolta deve raccogliere i log durante gli errori.

Metodi pubblici

captureModuleLevel

public boolean captureModuleLevel ()

Indica se l'agente di raccolta è applicabile all'acquisizione a livello di modulo e deve essere inizializzato.

Resi
boolean

doesModuleContainFailure

public boolean doesModuleContainFailure ()

Restituisce true se il modulo corrente contiene errori di test case o di esecuzione dei test.

Resi
boolean

enableDefaultMetricCollection

public void enableDefaultMetricCollection ()

Consente agli agenti di raccolta di abilitare la raccolta delle metriche predefinita. Quando la raccolta predefinita delle metriche è abilitata, l'agente di raccolta deve raccogliere solo al livello di raccolta specificato.

getAlwaysOnCollectionLevel

public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()

Resi
IMetricCollector.MetricCollectionLevel

getBuildInfos

public abstract List<IBuildInfo> getBuildInfos ()

Restituisce l'elenco delle informazioni sulla build disponibili nella chiamata.

Resi
List<IBuildInfo>

getDevices

public abstract List<ITestDevice> getDevices ()

Restituisce l'elenco dei dispositivi disponibili nella chiamata.

Resi
List<ITestDevice>

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

Restituisce l'ITestInvocationListener originale a cui inoltriamo i risultati.

Resi
ITestInvocationListener

getOnFailureCollectionLevel

public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()

Resi
IMetricCollector.MetricCollectionLevel

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Inizializzazione dell'agente di raccolta con il contesto corrente e la destinazione a cui inoltrare i risultati. Verrà chiamato una sola volta per istanza e l'agente di raccolta deve aggiornare il contesto e il listener interni. Init non verrà mai chiamato durante l'esecuzione di un test, ma sempre prima.

Non eseguire l'override a meno che tu non sappia cosa stai facendo.

Parametri
context	IInvocationContext: il IInvocationContext per la chiamata in corso.
listener	ITestInvocationListener: il ITestInvocationListener in cui inserire i risultati.

Resi
ITestInvocationListener	il nuovo ascoltatore che avvolge quello originale.

Genera
DeviceNotAvailableException

isDefaultMetricCollectionEnabled

public boolean isDefaultMetricCollectionEnabled ()

Indica se l'agente di raccolta raccoglie metriche nell'ambito della raccolta di metriche predefinita.

Resi
boolean

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Callback quando uno scenario di test non riesce a causa di un errore di ipotesi.

Parametri
testData	DeviceMetricData: il DeviceMetricData contenente i dati per lo scenario di test.
test	TestDescription: il TestDescription dello scenario di test in corso.

Genera
DeviceNotAvailableException

onTestEnd

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

Callback al termine di uno scenario di test. Questo dovrebbe essere il momento di liberare spazio.

Parametri
testData	DeviceMetricData: il DeviceMetricData contenente i dati per lo scenario di test. Sarà lo stesso oggetto di onTestStart(DeviceMetricData).
currentTestCaseMetrics	Map: la mappa attuale delle metriche trasmesse a testEnded(TestDescription,Map).
test	TestDescription: il TestDescription dello scenario di test in corso.

Genera
DeviceNotAvailableException

onTestEnd

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

Callback al termine di uno scenario di test. Questo dovrebbe essere il momento di liberare spazio.

Parametri
testData	DeviceMetricData: il DeviceMetricData contenente i dati per lo scenario di test. Sarà lo stesso oggetto di onTestStart(DeviceMetricData).
currentTestCaseMetrics	Map: la mappa attuale delle metriche trasmesse a testEnded(TestDescription,Map).

Genera
DeviceNotAvailableException

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Callback quando uno scenario di test non riesce.

Parametri
testData	DeviceMetricData: il DeviceMetricData contenente i dati per lo scenario di test.
test	TestDescription: il TestDescription dello scenario di test in corso.

Genera
DeviceNotAvailableException

onTestModuleEnded

public void onTestModuleEnded ()

Consente di acquisire l'evento di fine del modulo.

Genera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

Consente di acquisire l'evento di avvio del modulo.

Genera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

onTestRunEnd

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

Callback al termine di un test. Questo dovrebbe essere il momento di liberare spazio.

Parametri
runData	DeviceMetricData: il DeviceMetricData contenente i dati per l'esecuzione. Sarà lo stesso oggetto di onTestRunStart(DeviceMetricData).
currentRunMetrics	Map: la mappa attuale delle metriche trasmesse a testRunEnded(long,Map).

Genera
DeviceNotAvailableException

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

Callback quando viene avviata un'esecuzione di test.

Parametri
runData	DeviceMetricData: il DeviceMetricData contenente i dati per l'esecuzione.

Genera
DeviceNotAvailableException

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

Callback quando viene avviata un'esecuzione di test.

Parametri
runData	DeviceMetricData: il DeviceMetricData contenente i dati per l'esecuzione.
testCount	int: il numero di scenari di test in questa esecuzione di test.

Genera
DeviceNotAvailableException

onTestRunStartBlocking

public void onTestRunStartBlocking ()

Callback esplicito per avviare manualmente un raccoglitore, se supportato. Ciò consente di garantire che non ci troviamo in un ciclo di vita di test asincrono.

Genera
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

Callback quando viene avviato uno scenario di test.

Parametri
testData	DeviceMetricData: il DeviceMetricData contenente i dati per lo scenario di test.

Genera
DeviceNotAvailableException

setAlwaysOnCollectionLevel

public void setAlwaysOnCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Imposta il livello a cui l'agente di raccolta deve raccogliere i log indipendentemente dagli errori.

Il livello NULL non comporterà alcuna raccolta.

Parametri
level	IMetricCollector.MetricCollectionLevel: MetricCollectionLevel in cui verranno raccolti i log.

setModuleContainsFailure

public void setModuleContainsFailure ()

Indica se il modulo ha avuto errori (scenario di test, esecuzione del test).

setOnFailureCollectionLevel

public void setOnFailureCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Imposta il livello a cui l'agente di raccolta deve raccogliere i log durante gli errori.

Il livello NULL non comporterà alcuna raccolta.

Parametri
level	IMetricCollector.MetricCollectionLevel: MetricCollectionLevel in cui verranno raccolti i log.