2026년부터 트렁크 안정 개발 모델과 일치하고 생태계의 플랫폼 안정성을 보장하기 위해 2분기와 4분기에 AOSP에 소스 코드를 게시합니다. AOSP를 빌드하고 기여하려면 android-latest-release를 사용하세요. android-latest-release 매니페스트 브랜치는 항상 AOSP에 푸시된 최신 버전을 참조합니다. 자세한 내용은 AOSP 변경사항을 참고하세요.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

알려진 간접 하위 클래스

AtraceCollector, AtraceRunMetricCollector, BaseDeviceMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, FilePullerLogCollector 등 16개

AtraceCollector	테스트 중에 atrace를 실행하고 결과를 수집하여 호출에 로깅하는 `IMetricCollector`입니다.
AtraceRunMetricCollector	지정된 디렉터리 아래의 모든 테스트 디렉터리에서 테스트 기기의 트레이스를 수집하고, 테스트 디렉터리를 로깅하고, 테스트 디렉터리 아래의 트레이스 파일을 후처리하고, 측정항목을 집계합니다.
BaseDeviceMetricCollector	`onTestRunStart(DeviceMetricData)` 및 `onTestRunEnd(DeviceMetricData,Map)`에서 수집을 시작하고 중지할 수 있는 `IMetricCollector`의 기본 구현
BluetoothConnectionLatencyCollector	수집기는 사전 정의된 statsd 기간 측정항목 구성을 기기에 푸시하고 각 프로필의 블루투스 연결 기간을 수집합니다.
BluetoothConnectionStateCollector	이 수집기는 BluetoothConnectionStateChanged 측정항목을 수집하고 각 프로필의 연결 상태 번호를 기록합니다.
BluetoothHciSnoopLogCollector	DUT에서 블루투스 HCI 스누프 로깅을 사용 설정하고 각 테스트의 로그를 수집하는 수집기
BugreportzOnFailureCollector	테스트 사례가 실패하면 bugreportz를 수집합니다.
BugreportzOnTestCaseFailureCollector	실행 중인 테스트 사례가 실패하면 bugreportz를 수집합니다.
ClangCodeCoverageCollector	기기에서 Clang 커버리지 측정을 가져와 테스트 아티팩트로 로깅하는 `BaseDeviceMetricCollector`
CodeCoverageCollector	기기에서 Java 및 네이티브 적용 범위 측정을 가져와 테스트 아티팩트로 로깅하는 `BaseDeviceMetricCollector`
CountTestCasesCollector	지정된 `IRemoteTest`의 테스트 사례 수를 집계하고 보고합니다.
DebugHostLogOnFailureCollector	테스트 사례 실패가 발생할 때 호스트 측 로그를 수집하고 기록하는 수집기입니다.
DeviceTraceCollector	테스트 실행이 시작될 때 perfetto 트레이스를 시작하고 끝날 때 트레이스 파일을 로깅하는 수집기
FilePullerDeviceMetricCollector	기기에서 전송되는 측정항목 키를 수신하고 기기에서 파일로 가져오는 `BaseDeviceMetricCollector`
FilePullerLogCollector	기기 측에서 보고한 파일의 로거입니다.
GcovCodeCoverageCollector	기기에서 gcov 커버리지 측정을 가져와 테스트 아티팩트로 로깅하는 `BaseDeviceMetricCollector`입니다.
GcovKernelCodeCoverageCollector	debugfs에서 gcov 커널 적용 범위 측정을 가져와 기기에서 오프한 후 최종적으로 테스트 아티팩트로 로깅하는 `BaseDeviceMetricCollector`
HostStatsdMetricCollector	statsd 유틸리티 명령어를 사용하여 호스트 측에서 statsd 측정항목을 수집하는 `IMetricCollector`입니다.
JavaCodeCoverageCollector	기기에서 Java 적용 범위 측정을 가져와 테스트 아티팩트로 로깅하는 `BaseDeviceMetricCollector`입니다.
LogcatOnFailureCollector	테스트 사례 또는 테스트 실행이 실패할 때 logcat을 캡처하고 기록하는 수집기입니다.
LogcatTimingMetricCollector	제공된 정규식 패턴을 사용하여 로그캣 줄에서 이벤트의 시작 및 종료 신호를 파싱하여 하나 이상의 반복 테스트 중에 로그캣에서 타이밍 정보 (예: 사용자 전환 시간)를 수집하는 측정항목 수집기입니다.
ModuleLogcatCollector	logcat 수집기의 버전(모듈용)입니다.
ModulePerfettoCollector	테스트 모듈이 시작 및 종료되고 기기가 재부팅될 때 Perfetto 트레이스를 시작하는 수집기입니다.
PerfettoFilePullerCollector	기기에서 Perfetto 트레이스 파일을 가져오고, 선택적으로 압축하고, 테스트 로그에 추가하는 수집기입니다.
PerfettoPullerMetricCollector	이 클래스는 지원 중단되었습니다. 대신 `PerfettoFilePullerCollector` 및 `ERROR(/PerfettoTracePostProcessor)`를 사용하세요.
RebootReasonCollector	테스트 실행 중에 기기 재부팅을 수집하고 이유와 개수로 보고하는 수집기입니다.
RuntimeRestartCollector	테스트 실행 중에 런타임 다시 시작(시스템 서버 비정상 종료)의 타임스탬프를 수집하는 수집기입니다(있는 경우).
ScreenRecordOnFailureCollector	테스트 사례가 실패할 때 화면 녹화 동영상을 캡처하고 기록하는 수집기
ScreenshotOnFailureCollector	테스트 사례가 실패할 때 스크린샷을 캡처하고 기록하는 수집기
ShowmapPullerMetricCollector	기기에서 showmap 파일을 가져오고 여기에서 측정항목을 수집할 수 있는 `FilePullerDeviceMetricCollector`의 기본 구현
TraceCmdCollector	trace-cmd를 사용하여 테스트 중에 트레이스를 수집하고 호출에 로깅하는 `IMetricCollector`입니다.

이 인터페이스는 일치하는 측정항목을 수집하기 위해 테스트 결과를 보고할 때 데코레이터로 추가됩니다.

이 인터페이스는 ITestInvocationListener를 확장하더라도 로 사용할 수 없습니다. 구성 확인에서 거부합니다. 'metrics_collector'로 사용해야 합니다.

수집기는 여러 위치에서 재사용될 수 있으므로 내부 상태를 유지하지 않습니다. 내부 상태를 반드시 사용해야 하는 경우 init(IInvocationContext,ITestInvocationListener)에서 정리해야 합니다.

요약

공개 메서드
`default boolean`	`captureModuleLevel()` 수집기가 모듈 수준 캡처에 적용되고 초기화되어야 하는지 여부입니다.
`default boolean`	`doesModuleContainFailure()` 현재 모듈에 테스트 사례 또는 테스트 실행 실패가 포함된 경우 true를 반환합니다.
`default void`	`enableDefaultMetricCollection()` 수집기가 기본 측정항목 수집을 사용 설정할 수 있도록 허용합니다.
`default IMetricCollector.MetricCollectionLevel`	`getAlwaysOnCollectionLevel()`
`abstract List<IBuildInfo>`	`getBuildInfos()` 호출에서 사용할 수 있는 빌드 정보 목록을 반환합니다.
`abstract List<ITestDevice>`	`getDevices()` 호출에서 사용 가능한 기기 목록을 반환합니다.
`abstract ITestInvocationListener`	`getInvocationListener()` 결과를 전달하는 원래 `ITestInvocationListener`를 반환합니다.
`default IMetricCollector.MetricCollectionLevel`	`getOnFailureCollectionLevel()`
`abstract ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` 현재 컨텍스트와 결과를 전달할 위치를 사용하여 수집기를 초기화합니다.
`default boolean`	`isDefaultMetricCollectionEnabled()` 수집기가 기본 측정항목 수집의 일부로 측정항목을 수집하는지 여부입니다.
`abstract void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` 가정 실패로 테스트 사례가 실패할 때 호출되는 콜백입니다.
`abstract void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)` 테스트 사례가 종료될 때 호출되는 콜백입니다.
`abstract void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)` 테스트 사례가 종료될 때 호출되는 콜백입니다.
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` 테스트 사례가 실패할 때 호출되는 콜백입니다.
`default void`	`onTestModuleEnded()` 모듈 종료 이벤트를 캡처할 수 있습니다.
`default void`	`onTestModuleStarted()` 모듈 시작 이벤트를 캡처할 수 있습니다.
`abstract void`	`onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)` 테스트 실행이 종료될 때 호출되는 콜백입니다.
`abstract void`	`onTestRunStart(DeviceMetricData runData)` 테스트 실행이 시작될 때 호출되는 콜백입니다.
`default void`	`onTestRunStart(DeviceMetricData runData, int testCount)` 테스트 실행이 시작될 때 호출되는 콜백입니다.
`default void`	`onTestRunStartBlocking()` 수집기를 지원하는 경우 수동으로 시작하는 명시적 콜백입니다.
`abstract void`	`onTestStart(DeviceMetricData testData)` 테스트 사례가 시작될 때 호출되는 콜백입니다.
`default void`	`setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level)` 실패와 관계없이 수집기가 로그를 수집해야 하는 수준을 설정합니다.
`default void`	`setModuleContainsFailure()` 모듈에 실패 (테스트 사례, 테스트 실행)가 있었는지 설정합니다.
`default void`	`setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level)` 실패 시 수집기가 로그를 수집해야 하는 수준을 설정합니다.

공개 메서드

captureModuleLevel

public boolean captureModuleLevel ()

수집기가 모듈 수준 캡처에 적용되고 초기화되어야 하는지 여부입니다.

반환
`boolean`

doesModuleContainFailure

public boolean doesModuleContainFailure ()

현재 모듈에 테스트 사례 또는 테스트 실행 실패가 포함된 경우 true를 반환합니다.

반환
`boolean`

enableDefaultMetricCollection

public void enableDefaultMetricCollection ()

수집기가 기본 측정항목 수집을 사용 설정할 수 있도록 허용합니다. 기본 측정항목 수집이 사용 설정된 경우 수집기는 지정된 수집 수준에서만 수집해야 합니다.

getAlwaysOnCollectionLevel

public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()

반환
`IMetricCollector.MetricCollectionLevel`

getBuildInfos

public abstract List<IBuildInfo> getBuildInfos ()

호출에서 사용할 수 있는 빌드 정보 목록을 반환합니다.

반환
`List<IBuildInfo>`

getDevices

public abstract List<ITestDevice> getDevices ()

호출에서 사용 가능한 기기 목록을 반환합니다.

반환
`List<ITestDevice>`

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

결과를 전달하는 원래 ITestInvocationListener를 반환합니다.

반환
`ITestInvocationListener`

getOnFailureCollectionLevel

public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()

반환
`IMetricCollector.MetricCollectionLevel`

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

현재 컨텍스트와 결과를 전달할 위치를 사용하여 수집기를 초기화합니다. 인스턴스당 한 번만 호출되며 수집기는 내부 컨텍스트와 리스너를 업데이트해야 합니다. 테스트 실행 중에는 항상 이전에 init이 호출되지 않습니다.

어떤 기능인지 잘 아는 경우에만 재정의하세요.

매개변수
`context`	`IInvocationContext`: 진행 중인 호출의 `IInvocationContext`입니다.
`listener`	`ITestInvocationListener`: 결과를 배치할 `ITestInvocationListener`입니다.

반환
`ITestInvocationListener`	원래 리스너를 래핑하는 새 리스너

생성 값
`DeviceNotAvailableException`

isDefaultMetricCollectionEnabled

public boolean isDefaultMetricCollectionEnabled ()

수집기가 기본 측정항목 수집의 일부로 측정항목을 수집하는지 여부입니다.

반환
`boolean`

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

가정 실패로 테스트 사례가 실패할 때 호출되는 콜백입니다.

매개변수
`testData`	`DeviceMetricData`: 테스트 사례의 데이터를 보유하는 `DeviceMetricData`입니다.
`test`	`TestDescription`: 진행 중인 테스트 사례의 `TestDescription`입니다.

생성 값
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, 
                TestDescription test)

테스트 사례가 종료될 때 호출되는 콜백입니다. 이때 정리해야 합니다.

매개변수
`testData`	`DeviceMetricData`: 테스트 사례의 데이터를 보유하는 `DeviceMetricData`입니다. `onTestStart(DeviceMetricData)` 중에 사용된 객체와 동일한 객체입니다.
`currentTestCaseMetrics`	`Map`: `testEnded(TestDescription,Map)`에 전달된 현재 측정항목 맵입니다.
`test`	`TestDescription`: 진행 중인 테스트 사례의 `TestDescription`입니다.

생성 값
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

테스트 사례가 종료될 때 호출되는 콜백입니다. 이때 정리해야 합니다.

매개변수
`testData`	`DeviceMetricData`: 테스트 사례의 데이터를 보유하는 `DeviceMetricData`입니다. `onTestStart(DeviceMetricData)` 중에 사용된 객체와 동일한 객체입니다.
`currentTestCaseMetrics`	`Map`: `testEnded(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, 
                Map<String, MetricMeasurement.Metric> currentRunMetrics)

테스트 실행이 종료될 때 호출되는 콜백입니다. 이때 정리해야 합니다.

매개변수
`runData`	`DeviceMetricData`: 실행 데이터를 보유하는 `DeviceMetricData`입니다. `onTestRunStart(DeviceMetricData)`과 동일한 객체입니다.
`currentRunMetrics`	`Map`: `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`

onTestRunStartBlocking

public void onTestRunStartBlocking ()

수집기를 지원하는 경우 수동으로 시작하는 명시적 콜백입니다. 이를 통해 비동기식 테스트 수명 주기를 벗어날 수 있습니다.

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

테스트 사례가 시작될 때 호출되는 콜백입니다.

매개변수
`testData`	`DeviceMetricData`: 테스트 사례의 데이터를 보유하는 `DeviceMetricData`입니다.

생성 값
`DeviceNotAvailableException`

setAlwaysOnCollectionLevel

public void setAlwaysOnCollectionLevel (IMetricCollector.MetricCollectionLevel level)

실패와 관계없이 수집기가 로그를 수집해야 하는 수준을 설정합니다.

NULL 수준은 컬렉션이 생성되지 않습니다.

매개변수
`level`	`IMetricCollector.MetricCollectionLevel`: 로그가 수집될 `MetricCollectionLevel`입니다.

setModuleContainsFailure

public void setModuleContainsFailure ()

모듈에 실패 (테스트 사례, 테스트 실행)가 있었는지 설정합니다.

setOnFailureCollectionLevel

public void setOnFailureCollectionLevel (IMetricCollector.MetricCollectionLevel level)

실패 시 수집기가 로그를 수집해야 하는 수준을 설정합니다.

NULL 수준은 컬렉션이 생성되지 않습니다.

매개변수
`level`	`IMetricCollector.MetricCollectionLevel`: 로그가 수집될 `MetricCollectionLevel`입니다.