FilePullerDeviceMetricCollector

public abstract class FilePullerDeviceMetricCollector
extends BaseDeviceMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector
	↳	com.android.tradefed.device.metric.FilePullerDeviceMetricCollector

Known direct subclasses

AtraceRunMetricCollector, FilePullerLogCollector, PerfettoPullerMetricCollector

AtraceRunMetricCollector	Collects the traces from all the test directory under the given directory from the test device, log the test directory and post process the trace files under the test directory and aggregate the metrics.
FilePullerLogCollector	Logger of the file reported by the device-side.
PerfettoPullerMetricCollector	Base implementation of `FilePullerDeviceMetricCollector` that allows pulling the perfetto files from the device and collect the metrics from it.

Known indirect subclasses

IncidentReportCollector

IncidentReportCollector Pulls and processes incident reports that are reported device-side.

A BaseDeviceMetricCollector that listen for metrics key coming from the device and pull them as a file from the device. Can be extended for extra-processing of the file.

Summary

Fields
`protected`	`mDirectoryKeys`

Public constructors
`FilePullerDeviceMetricCollector()`

Public methods
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` Callback when a test case is ended.
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Callback when a test run is ended.
`abstract void`	`processMetricDirectory(String key, File metricDirectory, DeviceMetricData data)` Implementation of the method should allow to log the directory, parse it for metrics to be put in `DeviceMetricData`.
`abstract void`	`processMetricFile(String key, File metricFile, DeviceMetricData data)` Implementation of the method should allow to log the file, parse it for metrics to be put in `DeviceMetricData`.

Protected methods
`void`	`addKeys(String... keys)` Adds additional pattern keys to the pull from the device.

Fields

mDirectoryKeys

protected  mDirectoryKeys

Public constructors

FilePullerDeviceMetricCollector

public FilePullerDeviceMetricCollector ()

Public methods

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Callback when a test case is ended. This should be the time for clean up.

Parameters
`testData`	`DeviceMetricData`: the `DeviceMetricData` holding the data for the test case. Will be the same object as during `BaseDeviceMetricCollector.onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: the current map of metrics passed to `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`.

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Callback when a test run is ended. This should be the time for clean up.

Parameters
`runData`	`DeviceMetricData`: the `DeviceMetricData` holding the data for the run. Will be the same object as during `BaseDeviceMetricCollector.onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	: the current map of metrics passed to `ERROR(/#testRunEnded(long,Map))`.

processMetricDirectory

public abstract void processMetricDirectory (String key, 
                File metricDirectory, 
                DeviceMetricData data)

Implementation of the method should allow to log the directory, parse it for metrics to be put in DeviceMetricData.

Parameters
`key`	`String`: the option key associated to the directory that was pulled.
`metricDirectory`	`File`: the `ERROR(/File)` pulled from the device matching the option key.
`data`	`DeviceMetricData`: the `DeviceMetricData` where metrics can be stored.

processMetricFile

public abstract void processMetricFile (String key, 
                File metricFile, 
                DeviceMetricData data)

Implementation of the method should allow to log the file, parse it for metrics to be put in DeviceMetricData.

Parameters
`key`	`String`: the option key associated to the file that was pulled.
`metricFile`	`File`: the `ERROR(/File)` pulled from the device matching the option key.
`data`	`DeviceMetricData`: the `DeviceMetricData` where metrics can be stored.

Protected methods

addKeys

protected void addKeys (String... keys)

Adds additional pattern keys to the pull from the device.

Parameters
`keys`	`String`