IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

既知の間接的なサブクラス AtraceCollector テスト中に atrace を実行し、結果とログを収集する IMetricCollector 呼び出すことができます。  AtraceRunMetricCollector 指定されたディレクトリの下にあるすべてのテスト ディレクトリからトレースを収集します。 テスト デバイスからテスト ディレクトリをログに記録し、トレース ファイルを後処理します。 指標を集計します。  BaseDeviceMetricCollector 収集の開始と停止を可能にする IMetricCollector の基本実装 onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) と ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))。  BluetoothConnectionLatencyCollector コレクタは事前定義済みの statsd 期間指標設定をデバイスに push し、 各プロファイルの Bluetooth 接続時間。  BluetoothConnectionStateCollector（Bluetooth 接続状態コレクタ） このコレクタは BluetoothConnectionStateChanged 指標を収集し、接続状態を記録します。 番号を入力します。  BluetoothHciSnoopLogCollector DUT で Bluetooth HCI スヌープ ロギングを有効にし、各テストのログを収集するコレクタ  BugreportzOnFailureCollector（バグレポート） テストケースが失敗した場合にバグレポートを収集します。  BugreportzOnTestCaseFailureCollector 実行内のテストケースが失敗した場合にバグレポートを収集します。  ClangCodeCoverageCollector Clang を pull する BaseDeviceMetricCollector カバレッジ測定値をデバイスから取得し、テスト アーティファクトとしてログに記録します。  CountTestCasesCollector 指定された IRemoteTest のテストケースの数をカウントしてレポートします。  DebugHostLogOnFailureCollector テストケースの失敗時に、ホスト側のログを収集してログに記録するコレクタ。  DeviceTraceCollector テスト実行の開始時に perfetto トレースを開始し、終了時にトレース ファイルをログに記録するコレクタ。  FilePullerDeviceMetricCollector デバイスからの指標キーをリッスンして pull する BaseDeviceMetricCollector デバイスからファイルとしてエクスポートできます。  FilePullerLogCollector デバイス側から報告されたファイルのロガー。  GcovCodeCoverageCollector gcov を pull する BaseDeviceMetricCollector カバレッジ測定値をデバイスから取得し、テスト アーティファクトとしてログに記録します。  GcovKernelCodeCoverageCollector gcov カーネルを pull する BaseDeviceMetricCollector カバレッジ測定を debugfs とデバイスの外で行い、最終的にテストとしてログに記録 アーティファクトです  HostStatsdMetricCollector statsd ユーティリティを使用してホスト側から statsd 指標を収集する IMetricCollector 使用できます。  JavaCodeCoverageCollector Java を pull する BaseDeviceMetricCollector カバレッジ測定値をデバイスから取得し、テスト アーティファクトとしてログに記録します。  LogcatOnFailureCollector テストケースが失敗したときに logcat をキャプチャしてログに記録するコレクタ。  LogcatTimingMetricCollector イベント発生中に logcat からタイミング情報（例: ユーザーの切り替え時間）を収集する指標コレクタ 特定の正規表現パターンを使用して、特定の文字列の開始シグナルと終了シグナルを イベントを記録します。  ModuleLogcatCollector モジュール用の logcat コレクタのバージョン。  PerfettoPullerMetricCollector 以下を許可する FilePullerDeviceMetricCollector の基本実装 デバイスから perfetto ファイルを取得し、デバイスから指標を収集します。  RebootReasonCollector テスト実行中にデバイスの再起動を収集し、理由とカウント別に報告するコレクタ。  RuntimeRestartCollector テスト中にランタイム再起動（システム サーバー クラッシュ）のタイムスタンプを収集するコレクタ 表示されます。  ScreenshotOnFailureCollector: テストケースが失敗したときにスクリーンショットをキャプチャしてログに記録するコレクタ。  ShowmapPullerMetricCollector ショーマップを pull できる FilePullerDeviceMetricCollector の基本実装 デバイスから指標を収集します。  TraceCmdCollector trace-cmd を使用してテスト中にトレースを収集し、ログに記録する IMetricCollector あります。

---

このインターフェースは、テスト結果を報告する際にデコレータとして追加され、 一致します

このインターフェースは ITestInvocationListener を拡張するとしても、 として使用することはできません。構成チェックで拒否されます。必ず 「metrics_collector」。

コレクタは複数のリージョンで再利用される可能性があるため、内部状態を保持することは想定されていません。 できます。内部状態を本当に使用する必要がある場合は、init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener) で消去する必要があります。

概要

パブリック メソッド
default boolean	captureModuleLevel() コレクタがモジュール レベルのキャプチャに適用可能で、init である必要があるかどうか。
abstract	getBuildInfos() 呼び出しで使用できるビルド情報のリストを返します。
abstract	getDevices() 呼び出しで使用可能なデバイスのリストを返します。
abstract ITestInvocationListener	getInvocationListener() 結果の転送先となる元の ITestInvocationListener を返します。
abstract ITestInvocationListener	init(IInvocationContext context, ITestInvocationListener listener) 現在のコンテキストと結果の転送先でコレクタを初期化します。
abstract void	onTestAssumptionFailure(DeviceMetricData testData, TestDescription test) テストケースが仮定エラーで失敗したときに呼び出されるコールバック。
abstract void	onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test) テストケースが終了したときに呼び出されるコールバック。
abstract void	onTestEnd(DeviceMetricData testData, currentTestCaseMetrics) テストケースが終了したときに呼び出されるコールバック。
abstract void	onTestFail(DeviceMetricData testData, TestDescription test) テストケースが失敗した場合のコールバック。
default void	onTestModuleEnded() モジュール終了イベントをキャプチャできるようにします。
default void	onTestModuleStarted() モジュール開始イベントをキャプチャできるようにします。
abstract void	onTestRunEnd(DeviceMetricData runData, currentRunMetrics) テスト実行が終了したときのコールバック。
abstract void	onTestRunStart(DeviceMetricData runData) テスト実行が開始されたときのコールバック。
default void	onTestRunStart(DeviceMetricData runData, int testCount) テスト実行が開始されたときのコールバック。
abstract void	onTestStart(DeviceMetricData testData) テストケースが開始されたときのコールバック。

パブリック メソッド

キャプチャ モジュール レベル

public boolean captureModuleLevel ()

コレクタがモジュール レベルのキャプチャに適用可能で、init である必要があるかどうか。

戻り値
boolean

getBuildInfo

public abstract  getBuildInfos ()

呼び出しで使用できるビルド情報のリストを返します。

戻り値

getDevices

public abstract  getDevices ()

呼び出しで使用可能なデバイスのリストを返します。

戻り値

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

結果の転送先となる元の ITestInvocationListener を返します。

戻り値
ITestInvocationListener

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

現在のコンテキストと結果の転送先でコレクタを初期化します。ウィル インスタンスごとに 1 回だけ呼び出され、コレクタは自身の内部 コンテキストとリスナー。テスト実行中に init が呼び出されることはありません。

自分が何をしているかを明確にしていない限り、オーバーライドしないでください。

パラメータ
context	IInvocationContext: 進行中の呼び出しの IInvocationContext。
listener	ITestInvocationListener: 結果を配置する ITestInvocationListener。

戻り値
ITestInvocationListener	元のリスナーをラップする新しいリスナーです。

例外
DeviceNotAvailableException

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

テストケースが仮定エラーで失敗したときに呼び出されるコールバック。

パラメータ
testData	DeviceMetricData: テストケースのデータを保持する DeviceMetricData。
test	TestDescription: 進行中のテストケースの TestDescription。

例外
DeviceNotAvailableException

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

テストケースが終了したときに呼び出されるコールバック。この時点でクリーンアップを行います。

パラメータ
testData	DeviceMetricData: テストケースのデータを保持する DeviceMetricData。アップグレード前の onTestStart(com.android.tradefed.device.metric.DeviceMetricData) のときと同じオブジェクトです。
currentTestCaseMetrics	: ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) に渡される指標の現在のマップ。
test	TestDescription: 進行中のテストケースの TestDescription。

例外
DeviceNotAvailableException

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

テストケースが終了したときに呼び出されるコールバック。この時点でクリーンアップを行います。

パラメータ
testData	DeviceMetricData: テストケースのデータを保持する DeviceMetricData。アップグレード前の onTestStart(com.android.tradefed.device.metric.DeviceMetricData) のときと同じオブジェクトです。
currentTestCaseMetrics	: ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) に渡される指標の現在のマップ。

例外
DeviceNotAvailableException

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

テストケースが失敗した場合のコールバック。

パラメータ
testData	DeviceMetricData: テストケースのデータを保持する DeviceMetricData。
test	TestDescription: 進行中のテストケースの TestDescription。

例外
DeviceNotAvailableException

onTestModuleEnded

public void onTestModuleEnded ()

モジュール終了イベントをキャプチャできるようにします。

例外
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

モジュール開始イベントをキャプチャできるようにします。

例外
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

テスト実行が終了したときのコールバック。この時点でクリーンアップを行います。

パラメータ
runData	DeviceMetricData: 実行のデータを保持する DeviceMetricData。変更なし オブジェクト（onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) など）。
currentRunMetrics	: ERROR(/#testRunEnded(long,Map)) に渡される指標の現在のマップ。

例外
DeviceNotAvailableException

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

テスト実行が開始されたときのコールバック。

パラメータ
runData	DeviceMetricData: 実行のデータを保持する DeviceMetricData。

例外
DeviceNotAvailableException

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

テスト実行が開始されたときのコールバック。

パラメータ
runData	DeviceMetricData: 実行のデータを保持する DeviceMetricData。
testCount	int: このテスト実行のテストケースの数。

例外
DeviceNotAvailableException

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

テストケースが開始されたときのコールバック。

パラメータ
testData	DeviceMetricData: テストケースのデータを保持する DeviceMetricData。

例外
DeviceNotAvailableException