自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

此页面由 Cloud Translation API 翻译。

HostStatsdMetricCollector

public class HostStatsdMetricCollector
extends BaseDeviceMetricCollector

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

已知的直接子类

BluetoothConnectionLatencyCollector 收集器会将预定义的 StatsD 时长指标配置推送到设备，并收集每个配置文件的蓝牙连接时长。

已知的间接子类

BluetoothConnectionStateCollector 此收集器将收集 BluetoothConnectionStateChanged 指标，并记录每个配置文件的连接状态编号。

一个 IMetricCollector，用于使用 statsd 实用程序命令从主机端收集 statsd 指标。它具有基本的推送指标和转储报告功能。子类可以对其进行扩展，以根据需要处理 statsd 指标报告。

摘要

公共构造函数
`HostStatsdMetricCollector()`

公共方法
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` 测试用例结束时的回调。
`void`	`onTestFail(DeviceMetricData testData, TestDescription test)` 测试用例失败时的回调。
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` 测试运行结束时的回调。
`void`	`onTestRunStart(DeviceMetricData runData)` 测试运行开始时的回调。
`void`	`onTestStart(DeviceMetricData testData)` 测试用例启动时的回调。

受保护的方法
`void`	`processStatsReport(ITestDevice device, InputStreamSource dataStream, DeviceMetricData runData)` 子类可以根据需要实现该方法来处理 Statsd 指标报告。

public HostStatsdMetricCollector ()

public 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`

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

测试用例失败时的回调。

参数
`testData`	`DeviceMetricData`：用于存储测试用例数据的 `DeviceMetricData`。
`test`	`TestDescription`：正在进行的测试用例的 `TestDescription`。

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

测试运行结束时的回调。现在应该是清理时间了。

参数
`runData`	`DeviceMetricData`：用于存储运行数据的 `DeviceMetricData`。将与 `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` 期间相同的对象。
`currentRunMetrics`	：传递给 `ERROR(/#testRunEnded(long,Map))` 的当前指标映射。

抛出
`DeviceNotAvailableException`

public void onTestRunStart (DeviceMetricData runData)

测试运行开始时的回调。

参数
`runData`	`DeviceMetricData`：用于存储运行数据的 `DeviceMetricData`。

抛出
`DeviceNotAvailableException`

public void onTestStart (DeviceMetricData testData)

测试用例启动时的回调。

参数
`testData`	`DeviceMetricData`：用于存储测试用例数据的 `DeviceMetricData`。

抛出
`DeviceNotAvailableException`

protected void processStatsReport (ITestDevice device, 
                InputStreamSource dataStream, 
                DeviceMetricData runData)

子类可以根据需要实现此方法来处理 Statsd 指标报告。系统会针对特定设备调用此接口来获取指标报告

参数
`device`	`ITestDevice`：statsd 报告的来源测试设备
`dataStream`	`InputStreamSource`：将统计信息报告作为输入流
`runData`	`DeviceMetricData`：要存储已处理指标的目标位置