MetricUtility

public class MetricUtility
extends Object

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

כולל שיטות נפוצות לאחסון מדדי הבדיקה, צבירת המדדים בבדיקות דומות וכתיבת המדדים לקובץ.

סיכום

כיתות מוטמעות

class MetricUtility.DimensionalIterationData

מחלקת עזר להחזקת קובץ מדדים רב-ממדי וסטטוס עבור איטרציה אחת של בדיקה. 

‫constructors ציבוריים

MetricUtility()

‫methods ציבוריים

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)

כתיבת מדדים לקובץ.

‫constructors ציבוריים

MetricUtility

public MetricUtility ()

‫methods ציבוריים

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, הממוצע מחושב לפי הגודל של רשימת הערכים.
החזרות
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 הפונקציה מחזירה true אם כל הערכים הם ערכים מסוג double, אחרת היא מחזירה false.

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 לתאימות לאחור. ברירת המחדל היא 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 קובץ עם המדד.