MetricUtility

public class MetricUtility
extends Object

java.lang.Object
   ↳ com.android.tradefed.util.MetricUtility

Contém métodos utilitários comuns para armazenar as métricas de teste, agregar as métricas em testes semelhantes e gravar as métricas em um arquivo.

Resumo

Classes aninhadas

class MetricUtility.DimensionalIterationData

Classe auxiliar para armazenar o arquivo e o status de métrica dimensional de uma única iteração de teste. 

Construtores públicos

MetricUtility()

Métodos públicos

File aggregateDimensionalMetricsAndWriteToFile(List<MetricUtility.DimensionalIterationData> iterationDataList, Set<Integer> percentiles, String testIterationSeparator)

Lê todos os arquivos de relatório de métricas dimensionais armazenados, agrega os valores brutos, calcula estatísticas e grava um novo arquivo de relatório agregado.

Map<String, MetricMeasurement.Metric> aggregateMetrics(Map<String, MetricMeasurement.Metric> rawMetrics)

Agrega métricas separadas por vírgula.

File aggregateStoredTestMetricsAndWriteToFile(String fileName)

Agregue as métricas coletadas de várias iterações do teste e grave as métricas agregadas em um arquivo de resultado do teste.

void buildMetricFilterPatterns(Set<String> strictIncludeRegEx)

Crie padrões de expressão regular para filtrar as métricas.

Map<String, MetricMeasurement.Metric> filterMetrics(Map<String, MetricMeasurement.Metric> parsedMetrics)

Filtre as métricas que correspondem ao padrão.

static Map<String, Double> getStats(List<Double> values, Set<Integer> percentiles, int testIterations)

Calcule as estatísticas da lista de valores fornecida.

Map<String, List<MetricUtility.IterationData>> getTestIterations()
static boolean isAllDoubleValues(List<String> rawValues)

Verifica se todos os valores na lista são valores duplos.

void setIterationSeparator(String separator)
void setMetricsUseForTestIterations(Set<String> metricsUseForTestIterations)

Define as expressões regulares para métricas que devem usar iterações de teste aprovadas para o cálculo da média durante a agregação.

void setPercentiles(Set<Integer> percentiles)
void storeTestMetrics(TestDescription testDescription, Map<String, MetricMeasurement.Metric> testMetrics, boolean testFailed)

Usado para armazenar as métricas de teste individuais e para agregação.

void storeTestMetrics(TestDescription testDescription, Map<String, MetricMeasurement.Metric> testMetrics)

Versão sobrecarregada de "storeTestMetrics" para compatibilidade com versões anteriores.

File writeResultsToFile(String testFileSuffix, String testHeaderName, Map<String, String> metrics, File resultsFile)

Gravar métricas em um arquivo.

Construtores públicos

MetricUtility

public MetricUtility ()

Métodos públicos

aggregateDimensionalMetricsAndWriteToFile

public File aggregateDimensionalMetricsAndWriteToFile (List<MetricUtility.DimensionalIterationData> iterationDataList, 
                Set<Integer> percentiles, 
                String testIterationSeparator)

Lê todos os arquivos de relatório de métricas dimensionais armazenados, agrega os valores brutos, calcula estatísticas e grava um novo arquivo de relatório agregado.

Parâmetros
iterationDataList List

percentiles Set: os percentis a serem calculados.
testIterationSeparator String: o separador para iterações de teste.
Retorna
File Um File que contém o relatório agregado ou nulo se nenhuma agregação foi realizada.

aggregateMetrics

public Map<String, MetricMeasurement.Metric> aggregateMetrics (Map<String, MetricMeasurement.Metric> rawMetrics)

Agrega métricas separadas por vírgula.

Parâmetros
rawMetrics Map: métricas coletadas durante a execução do teste.
Retorna
Map<String, MetricMeasurement.Metric> métricas agregadas.

aggregateStoredTestMetricsAndWriteToFile

public File aggregateStoredTestMetricsAndWriteToFile (String fileName)

Agregue as métricas coletadas de várias iterações do teste e grave as métricas agregadas em um arquivo de resultado do teste.

Parâmetros
fileName String: nome do arquivo a ser usado ao gravar as métricas.
Retorna
File

buildMetricFilterPatterns

public void buildMetricFilterPatterns (Set<String> strictIncludeRegEx)

Crie padrões de expressão regular para filtrar as métricas.

Parâmetros
strictIncludeRegEx Set

filterMetrics

public Map<String, MetricMeasurement.Metric> filterMetrics (Map<String, MetricMeasurement.Metric> parsedMetrics)

Filtre as métricas que correspondem ao padrão.

Parâmetros
parsedMetrics Map

Retorna
Map<String, MetricMeasurement.Metric>

getStats

public static Map<String, Double> getStats (List<Double> values, 
                Set<Integer> percentiles, 
                int testIterations)

Calcule as estatísticas da lista de valores fornecida.

Parâmetros
values List: valores brutos para calcular a agregação.
percentiles Set: estatísticas a serem incluídas nas métricas finais.
testIterations int: número de iterações a serem usadas como divisor para a média. Se for 0, a média será calculada usando o tamanho da lista "values".
Retorna
Map<String, Double> valores agregados.

getTestIterations

public Map<String, List<MetricUtility.IterationData>> getTestIterations ()

Retorna
Map<String, List<MetricUtility.IterationData>>

isAllDoubleValues

public static boolean isAllDoubleValues (List<String> rawValues)

Verifica se todos os valores na lista são valores duplos.

Parâmetros
rawValues List: lista de valores a serem verificados.
Retorna
boolean "true" se todos os valores forem duplos, "false" caso contrário.

setIterationSeparator

public void setIterationSeparator (String separator)

Parâmetros
separator String

setMetricsUseForTestIterations

public void setMetricsUseForTestIterations (Set<String> metricsUseForTestIterations)

Define as expressões regulares para métricas que devem usar iterações de teste aprovadas para o cálculo da média durante a agregação.

Parâmetros
metricsUseForTestIterations Set: um conjunto de strings de expressão regular.

setPercentiles

public void setPercentiles (Set<Integer> percentiles)

Parâmetros
percentiles Set

storeTestMetrics

public void storeTestMetrics (TestDescription testDescription, 
                Map<String, MetricMeasurement.Metric> testMetrics, 
                boolean testFailed)

Usado para armazenar as métricas de teste individuais e para agregação.

Parâmetros
testDescription TestDescription: contém os detalhes do teste, como nome da classe e nome do teste.
testMetrics Map: métricas coletadas para o teste.
testFailed boolean: se o teste falhou.

storeTestMetrics

public void storeTestMetrics (TestDescription testDescription, 
                Map<String, MetricMeasurement.Metric> testMetrics)

Versão sobrecarregada de "storeTestMetrics" para compatibilidade com versões anteriores. O padrão é "testFailed" como "false".

Parâmetros
testDescription TestDescription

testMetrics Map

writeResultsToFile

public File writeResultsToFile (String testFileSuffix, 
                String testHeaderName, 
                Map<String, String> metrics, 
                File resultsFile)

Gravar métricas em um arquivo.

Parâmetros
testFileSuffix String: é usado como sufixo no nome do arquivo de métrica de teste.
testHeaderName String: as métricas serão gravadas no nome do cabeçalho de teste.
metrics Map: para gravar no arquivo.
resultsFile File: se for nulo, crie um arquivo e grave as métricas. Caso contrário, adicione o nome do cabeçalho do teste e a métrica ao arquivo.
Retorna
File arquivo com a métrica.