MetricUtility

public class MetricUtility
extends Object

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

Contient des méthodes utilitaires courantes pour stocker les métriques de test, les agréger dans des tests similaires et les écrire dans un fichier.

Résumé

Classes imbriquées

class MetricUtility.DimensionalIterationData

Classe d'assistance permettant de contenir le fichier de métriques dimensionnelles et l'état d'une seule itération de test. 

Constructeurs publics

MetricUtility()

Méthodes publiques

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

Lit tous les fichiers de rapports sur les métriques dimensionnelles stockés, agrège les valeurs brutes, calcule les statistiques et écrit un nouveau fichier de rapport agrégé.

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

Métriques agrégées séparées par une virgule.

File aggregateStoredTestMetricsAndWriteToFile(String fileName)

Agrège les métriques collectées à partir de plusieurs itérations du test et écrit les métriques agrégées dans un fichier de résultats de test.

void buildMetricFilterPatterns(Set<String> strictIncludeRegEx)

Créez des modèles d'expression régulière pour filtrer les métriques.

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

Filtrez les métriques qui correspondent au modèle.

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

Calculez les statistiques à partir de la liste de valeurs fournie.

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

Vérifie si toutes les valeurs de la liste sont des valeurs doubles.

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

Définit les expressions régulières pour les métriques qui doivent utiliser les itérations de test réussies pour le calcul de la moyenne lors de l'agrégation.

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

Utilisé pour stocker les métriques de test individuelles et les agréger.

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

Version surchargée de storeTestMetrics pour la rétrocompatibilité.

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

Écrire des métriques dans un fichier

Constructeurs publics

MetricUtility

public MetricUtility ()

Méthodes publiques

aggregateDimensionalMetricsAndWriteToFile

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

Lit tous les fichiers de rapports sur les métriques dimensionnelles stockés, agrège les valeurs brutes, calcule les statistiques et écrit un nouveau fichier de rapport agrégé.

Paramètres
iterationDataList List

percentiles Set : centiles à calculer.
testIterationSeparator String : séparateur pour les itérations de test.
Renvoie
File Un File contenant le rapport agrégé ou la valeur null si aucune agrégation n'a été effectuée.

aggregateMetrics

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

Métriques agrégées séparées par une virgule.

Paramètres
rawMetrics Map : métriques collectées lors de l'exécution du test.
Renvoie
Map<String, MetricMeasurement.Metric> métriques agrégées.

aggregateStoredTestMetricsAndWriteToFile

public File aggregateStoredTestMetricsAndWriteToFile (String fileName)

Agrège les métriques collectées à partir de plusieurs itérations du test et écrit les métriques agrégées dans un fichier de résultats de test.

Paramètres
fileName String : nom de fichier à utiliser lors de l'écriture des métriques.
Renvoie
File

buildMetricFilterPatterns

public void buildMetricFilterPatterns (Set<String> strictIncludeRegEx)

Créez des modèles d'expression régulière pour filtrer les métriques.

Paramètres
strictIncludeRegEx Set

filterMetrics

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

Filtrez les métriques qui correspondent au modèle.

Paramètres
parsedMetrics Map

Renvoie
Map<String, MetricMeasurement.Metric>

getStats

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

Calculez les statistiques à partir de la liste de valeurs fournie.

Paramètres
values List : valeurs brutes pour calculer l'agrégation.
percentiles Set : statistiques à inclure dans les métriques finales.
testIterations int : nombre d'itérations à utiliser comme diviseur pour la moyenne. Si la valeur est 0, la moyenne est calculée à l'aide de la taille de la liste "values".
Renvoie
Map<String, Double> des valeurs agrégées.

getTestIterations

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

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

isAllDoubleValues

public static boolean isAllDoubleValues (List<String> rawValues)

Vérifie si toutes les valeurs de la liste sont des valeurs doubles.

Paramètres
rawValues List : liste des valeurs à vérifier.
Renvoie
boolean "true" si toutes les valeurs sont des valeurs doubles, "false" dans le cas contraire.

setIterationSeparator

public void setIterationSeparator (String separator)

Paramètres
separator String

setMetricsUseForTestIterations

public void setMetricsUseForTestIterations (Set<String> metricsUseForTestIterations)

Définit les expressions régulières pour les métriques qui doivent utiliser les itérations de test réussies pour le calcul de la moyenne lors de l'agrégation.

Paramètres
metricsUseForTestIterations Set : ensemble de chaînes d'expressions régulières.

setPercentiles

public void setPercentiles (Set<Integer> percentiles)

Paramètres
percentiles Set

storeTestMetrics

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

Utilisé pour stocker les métriques de test individuelles et les agréger.

Paramètres
testDescription TestDescription : contient les détails du test, comme le nom de la classe et le nom du test.
testMetrics Map : métriques collectées pour le test.
testFailed boolean : indique si le test a échoué.

storeTestMetrics

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

Version surchargée de storeTestMetrics pour la rétrocompatibilité. La valeur par défaut de testFailed est "false".

Paramètres
testDescription TestDescription

testMetrics Map

writeResultsToFile

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

Écrire des métriques dans un fichier

Paramètres
testFileSuffix String : utilisé comme suffixe dans le nom du fichier de métriques de test.
testHeaderName String : les métriques seront écrites sous le nom de l'en-tête de test.
metrics Map : à écrire dans le fichier.
resultsFile File : si la valeur est nulle, créez un fichier et écrivez les métriques. Sinon, ajoutez le nom de l'en-tête de test et la métrique au fichier.
Renvoie
File avec la métrique.