IPostProcessor

public interface IPostProcessor
implements IDisableable, ILogSaverListener, ITestInvocationListener

com.android.tradefed.postprocessor.IPostProcessor

既知の間接的なサブクラス AggregatePostProcessor、AveragePostProcessor、BasePostProcessor、BluetoothConnectionSuccessRatePostProcessor、MetricFilePostProcessor、PerfettoGenericPostProcessor、StatsdBeforeAfterGaugeMetricPostProcessor、StatsdEventMetricPostProcessor、StatsdGenericPostProcessor AggregatePostProcessor 複数の反復テスト実行中に収集された数値指標の最小値、最大値、平均値、分散、標準偏差、合計、カウント、および必要に応じてパーセンタイルをダブルとして扱う指標アグリゲータ。  AveragePostProcessor 指標リストの平均を計算するポストプロセッサの実装。  BasePostProcessor すべての実装で拡張する必要があるベースの IPostProcessor。  BluetoothConnectionSuccessRatePostProcessor Bluetooth プロファイルの成功率を計算するポストプロセッサの実装 「metric-key-match」を使用して、数値配列（例: [0, 1, 2, 3, 0, 1, 2, 3]）で Bluetooth 接続状態を含む指標を指定します。  MetricFilePostProcessor テストレベルと実行レベルで収集された指標ログファイルをアップロードするために使用されます。  PerfettoGenericPostProcessor 数値フィールドが検出されるまで、文字列値を含む proto メッセージとフィールドを再帰的に展開して、テキスト/バイナリ指標の perfetto proto ファイルを Key-Value ペアとして処理するポストプロセッサ。  StatsdBeforeAfterGaugeMetricPostProcessor 「前後」アプローチで収集されたゲージ指標を処理するポストプロセッサ。 StatsdEventMetricPostProcessor プロセッサで指定されたフォーマッタを使用して、statsd レポートのイベント指標を Key-Value ペアに処理するポストプロセッサ。  StatsdGenericPostProcessor バイナリ proto statsd レポートを Key-Value ペアに処理するポストプロセッサ。レポートをツリー構造として展開します。

---

ポストプロセッサは、テストの後、結果レポートの前に指標とログを処理することを目的とした Trade Federation オブジェクトです。これにより、一部のデータをポストプロセッシングし、すべての result_reporter オブジェクトがそのデータを受信できます。1 つの result_reporter 内でのみポストプロセッシングを行うと、新しいデータを渡す際に問題が発生する可能性があります。

概要

パブリック メソッド
abstract ITestInvocationListener	init(ITestInvocationListener listener) ポストプロセッサの初期化ステップ。
abstract	processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs) このメソッドを実装して、すべてのテストの指標とログを集約します。
abstract	processRunMetricsAndLogs( rawMetrics, runLogs) このメソッドを実装して、既存の指標とログから一連の新しい指標を生成します。
abstract	processTestMetricsAndLogs(TestDescription testDescription, testMetrics, testLogs) このメソッドを実装して、各テストの指標とログをポスト処理します。

パブリック メソッド

init

public abstract ITestInvocationListener init (ITestInvocationListener listener)

ポストプロセッサの初期化ステップ。テストのコールバックの前に必ず呼び出されます。

パラメータ
listener	ITestInvocationListener

戻り値
ITestInvocationListener

processAllTestMetricsAndLogs

public abstract  processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, 
                 allTestLogs)

このメソッドを実装して、すべてのテストの指標とログを集約します。このメソッドから出力される指標は、実行指標としてレポートされます。新しく生成された指標のみを返す必要があります。キー名は一意にする必要があります（既存のキーとの競合は許可されません）。

パラメータ
allTestMetrics	ListMultimap: 指標名でグループ化された各テストの指標を格納する HashMultimap。
allTestLogs	: 各テストの TestDescription をキーとして、各テストのログファイルのマップをデータ名でキーに格納するマップ。

戻り値
	すべてのテスト指標から新しく生成された指標のセット。

processRunMetricsAndLogs

public abstract  processRunMetricsAndLogs ( rawMetrics, 
                 runLogs)

このメソッドを実装すると、既存の指標とログから一連の新しい指標を生成できます。新しく生成された指標のみを返す必要があります。キー名は一意にする必要があります（既存のキーとの競合は許可されません）。

パラメータ
rawMetrics	: 実行に使用できる元の指標のセット。
runLogs	: テスト実行のログファイルのセット。

戻り値
	実行指標から新しく生成された指標のセット。

processTestMetricsAndLogs

public abstract  processTestMetricsAndLogs (TestDescription testDescription, 
                 testMetrics, 
                 testLogs)

このメソッドを実装して、各テストの指標とログをポスト処理します。新しく生成された指標のみを返す必要があります。キー名は一意にする必要があります（既存のキーとの競合は許可されません）。

パラメータ
testDescription	TestDescription: テストを記述する TestDescription オブジェクト。
testMetrics	: テストの指標のセット。
testLogs	: テスト中にログに記録されたファイルのセット。

戻り値
	テスト指標から新しく生成された指標のセット。