Effective in 2026, to align with our trunk stable development model and ensure platform stability for the ecosystem, we will publish source code to AOSP in Q2 and Q4. For building and contributing to AOSP, use android-latest-release. The android-latest-release manifest branch will always reference the most recent release pushed to AOSP. For more information, see Changes to AOSP.

IPostProcessor

public interface IPostProcessor
implements IDisableable, ILogSaverListener, ITestInvocationListener

com.android.tradefed.postprocessor.IPostProcessor

Known indirect subclasses

AggregatePostProcessor, AveragePostProcessor, BasePostProcessor, BluetoothConnectionSuccessRatePostProcessor, GeminiDebuggingPostProcessor, MetricFilePostProcessor, PerfettoGenericPostProcessor, PerfettoTracePostProcessor, SimpleperfProfilePostProcessor, StatsdBeforeAfterGaugeMetricPostProcessor, StatsdEventMetricPostProcessor, StatsdGenericPostProcessor

AggregatePostProcessor	A metric aggregator that gives the min, max, mean, variance, standard deviation, total, count and optionally percentiles for numeric metrics collected during multiple-iteration test runs, treating them as doubles.
AveragePostProcessor	Implementation of post processor that calculate the average of the list of metrics.
BasePostProcessor	The base `IPostProcessor` that every implementation should extend.
BluetoothConnectionSuccessRatePostProcessor	Implementation of postprocessor which calculates success rate for a bluetooth profile Use "metric-key-match" to specify metrics which contain bluetooth connection states in numeric array Example [0, 1, 2, 3, 0, 1, 2, 3].
GeminiDebuggingPostProcessor	Post processor creating prompt queries for debugging errors.
MetricFilePostProcessor	Used for uploading the metrics log file collected during the test and run level.
PerfettoGenericPostProcessor	A post processor that processes text/binary metric perfetto proto file into key-value pairs by recursively expanding the proto messages and fields with string values until the field with numeric value is encountered.
PerfettoTracePostProcessor	A post processor which retrieves perfetto trace files from the test logs and runs the trace processor on them to produce a perfetto metric proto.
SimpleperfProfilePostProcessor	A post processor that finds simpleperf profiling data and generates a pprof profile.
StatsdBeforeAfterGaugeMetricPostProcessor	A post processor that processes gauge metrics collected in a "before/after" approach, i.e.
StatsdEventMetricPostProcessor	A post processor that processes event metrics in statsd reports into key-value pairs, using the formatters specified on the processor.
StatsdGenericPostProcessor	A post processor that processes binary proto statsd reports into key-value pairs by expanding the report as a tree structure.

Post processors is a Trade Federation object meant to allow the processing of metrics and logs AFTER the tests and BEFORE result reporting. This allows to post-process some data and have all result_reporter objects receive it, rather than doing the post-processing inside only one result_reporter and having issue to pass the new data around.

Summary

Public methods
`abstract ITestInvocationListener`	`init(ITestInvocationListener listener)` Initialization step of the post processor.
`abstract Map<String, MetricMeasurement.Metric.Builder>`	`processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, Map<TestDescription, Map<String, LogFile>> allTestLogs)` Implement this method to aggregate metrics and logs across all tests.
`abstract Map<String, MetricMeasurement.Metric.Builder>`	`processRunMetricsAndLogs(HashMap<String, MetricMeasurement.Metric> rawMetrics, Map<String, LogFile> runLogs)` Implement this method in order to generate a set of new metrics from the existing metrics and logs.
`abstract Map<String, MetricMeasurement.Metric.Builder>`	`processTestMetricsAndLogs(TestDescription testDescription, HashMap<String, MetricMeasurement.Metric> testMetrics, Map<String, LogFile> testLogs)` Implement this method to post process metrics and logs from each test.

Public methods

init

public abstract ITestInvocationListener init (ITestInvocationListener listener)

Initialization step of the post processor. Ensured to be called before any of the tests callbacks.

Parameters
`listener`	`ITestInvocationListener`

Returns
`ITestInvocationListener`

processAllTestMetricsAndLogs

public abstract Map<String, MetricMeasurement.Metric.Builder> processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, 
                Map<TestDescription, Map<String, LogFile>> allTestLogs)

Implement this method to aggregate metrics and logs across all tests. Metrics coming out of this method will be reporter as run metrics. Only the newly generated metrics should be returned, and with unique key name (no collision with existing keys are allowed).

Parameters
`allTestMetrics`	`ListMultimap`: A HashMultimap storing the metrics from each test grouped by metric names.
`allTestLogs`	`Map`: A map storing each test's map of log files keyed by their data names, using the each test's `TestDescription` as keys.

Returns
`Map<String, MetricMeasurement.Metric.Builder>`	The set of newly generated metrics from all test metrics.

processRunMetricsAndLogs

public abstract Map<String, MetricMeasurement.Metric.Builder> processRunMetricsAndLogs (HashMap<String, MetricMeasurement.Metric> rawMetrics, 
                Map<String, LogFile> runLogs)

Implement this method in order to generate a set of new metrics from the existing metrics and logs. Only the newly generated metrics should be returned, and with unique key name (no collision with existing keys are allowed).

Parameters
`rawMetrics`	`HashMap`: The set of raw metrics available for the run.
`runLogs`	`Map`: The set of log files for the test run.

Returns
`Map<String, MetricMeasurement.Metric.Builder>`	The set of newly generated metrics from the run metrics.

processTestMetricsAndLogs

public abstract Map<String, MetricMeasurement.Metric.Builder> processTestMetricsAndLogs (TestDescription testDescription, 
                HashMap<String, MetricMeasurement.Metric> testMetrics, 
                Map<String, LogFile> testLogs)

Implement this method to post process metrics and logs from each test. Only the newly generated metrics should be returned, and with unique key name (no collision with existing keys are allowed).

Parameters
`testDescription`	`TestDescription`: The TestDescription object describing the test.
`testMetrics`	`HashMap`: The set of metrics from the test.
`testLogs`	`Map`: The set of files logged during the test.

Returns
`Map<String, MetricMeasurement.Metric.Builder>`	The set of newly generated metrics from the test metrics.