Metric.Measurement

Measurement(name: String, data: Double)

Represents a measurement with a single value captured per iteration.

For example, in a startup Macrobenchmark, StartupTimingMetric returns a single measurement for timeToInitialDisplayMs.

Measurement(name: String, dataSamples: List<Double>)

Represents a measurement with a value sampled an arbitrary number of times per iteration.

For example, in a jank Macrobenchmark, FrameTimingMetric can return multiple measurements for frameOverrunMs - one for each observed frame.

When measurements are merged across multiple iterations, percentiles are extracted from the total pool of samples: P50, P90, P95, and P99.

val data: List<Double>

Measurement values captured by the metric, length constraints defined by requireSingleValue.

val name: String

Unique name of the metric, should be camel case with abbreviated suffix, e.g. startTimeNs

val requireSingleValue: Boolean

True if the data param is a single value per measurement, false if it contains an arbitrary number of samples.