MetricUtility

public class MetricUtility
extends Object

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

Содержит распространенные вспомогательные методы для хранения метрик тестирования, агрегирования метрик в аналогичных тестах и ​​записи метрик в файл.

Краткое содержание

Вложенные классы

class MetricUtility.DimensionalIterationData

Вспомогательный класс для хранения файла с метриками и статуса для одной итерации теста.

Государственные строители

MetricUtility ()

Общедоступные методы

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

Программа считывает все сохраненные файлы отчетов по многомерным метрикам, агрегирует исходные значения, вычисляет статистику и записывает новый агрегированный файл отчета.

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

Сводные показатели, разделенные запятыми.

File aggregateStoredTestMetricsAndWriteToFile (String fileName)

Объедините метрики, собранные в ходе нескольких итераций теста, и запишите объединенные метрики в файл с результатами теста.

void buildMetricFilterPatterns (Set<String> strictIncludeRegEx)

Создайте шаблоны регулярных выражений для фильтрации метрик.

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

Отфильтруйте метрики, соответствующие шаблону.

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

Вычислите статистические данные на основе предоставленного списка значений.

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

Проверяет, являются ли все значения в списке значениями типа double.

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

Задает регулярные выражения для метрик, которые должны использовать пройденные тестовые итерации для вычисления среднего значения во время агрегирования.

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

Используется для хранения отдельных метрик тестирования и последующего их агрегирования.

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

Перегруженная версия storeTestMetrics для обеспечения обратной совместимости.

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

Запись метрик в файл.

Государственные строители

MetricUtility 

public MetricUtility ()

Общедоступные методы

aggregateDimensionalMetricsAndWriteToFile 

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

Программа считывает все сохраненные файлы отчетов по многомерным метрикам, агрегирует исходные значения, вычисляет статистику и записывает новый агрегированный файл отчета.

Параметры
iterationDataList List

percentiles Set : Процентили для вычисления.

testIterationSeparator String : Разделитель для итераций теста.

Возвраты
File File содержащий сводный отчет, или значение null, если сводный отчет не выполнялся.

aggregateMetrics 

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

Сводные показатели, разделенные запятыми.

Параметры
rawMetrics Map : метрики, собранные во время тестового запуска.

Возвраты
Map<String, MetricMeasurement.Metric> агрегированные показатели.

aggregateStoredTestMetricsAndWriteToFile 

public File aggregateStoredTestMetricsAndWriteToFile (String fileName)

Объедините метрики, собранные в ходе нескольких итераций теста, и запишите объединенные метрики в файл с результатами теста.

Параметры
fileName String : имя файла, используемое при записи метрик.

Возвраты
File

buildMetricFilterPatterns 

public void buildMetricFilterPatterns (Set<String> strictIncludeRegEx)

Создайте шаблоны регулярных выражений для фильтрации метрик.

Параметры
strictIncludeRegEx Set

filterMetrics 

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

Отфильтруйте метрики, соответствующие шаблону.

Параметры
parsedMetrics Map

Возвраты
Map<String, MetricMeasurement.Metric>

getStats 

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

Вычислите статистические данные на основе предоставленного списка значений.

Параметры
values List : исходные значения для вычисления агрегации.

percentiles Set : статистические данные, которые будут включены в итоговые показатели.

testIterations int : количество итераций, используемых в качестве делителя для вычисления среднего значения. Если 0, среднее значение вычисляется с использованием размера списка 'values'.

Возвраты
Map<String, Double> агрегированные значения.

getTestIterations 

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

Возвраты
Map<String, List<MetricUtility.IterationData>>

isAllDoubleValues 

public static boolean isAllDoubleValues (List<String> rawValues)

Проверяет, являются ли все значения в списке значениями типа double.

Параметры
rawValues List : перечень значений для проверки.

Возвраты
boolean Если все значения являются значениями типа double, то значение будет истинным, в противном случае — ложным.

setIterationSeparator 

public void setIterationSeparator (String separator)

Параметры
separator String

setMetricsUseForTestIterations 

public void setMetricsUseForTestIterations (Set<String> metricsUseForTestIterations)

Задает регулярные выражения для метрик, которые должны использовать пройденные тестовые итерации для вычисления среднего значения во время агрегирования.

Параметры
metricsUseForTestIterations Set : набор строк регулярных выражений.

setPercentiles 

public void setPercentiles (Set<Integer> percentiles)

Параметры
percentiles Set

storeTestMetrics 

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

Используется для хранения отдельных метрик тестирования и последующего их агрегирования.

Параметры
testDescription TestDescription : содержит подробную информацию о тесте, такую ​​как название класса и название теста.

testMetrics Map : метрики, собранные для теста.

testFailed boolean : указывает, не пройден ли тест.

storeTestMetrics 

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

Перегруженная версия функции storeTestMetrics для обратной совместимости. Значение testFailed по умолчанию — false.

Параметры
testDescription TestDescription

testMetrics Map

writeResultsToFile 

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

Запись метрик в файл.

Параметры
testFileSuffix String :" используется в качестве суффикса в имени файла метрик теста.

testHeaderName String : метрики будут записаны под именем заголовка теста.

metrics Map : для записи в файл.

resultsFile File : если значение равно null, создайте новый файл и запишите в него метрики; в противном случае добавьте в файл имя заголовка теста и метрику.

Возвраты
File файл с метрикой.