如何通过 Glean 在 engine-gecko 中报告 Gecko Telemetry

在 Gecko 中，遥测 系统收集了各种 Gecko 性能、硬件、使用情况和自定义设置的指标。当 Gecko 引擎嵌入使用 Glean SDK 进行数据收集的 Android 产品时，Gecko 指标可以报告在 Glean 探针 中。本文概述了在 Glean 中报告任何现有或新的遥测数据收集所需的内容。

重要

Firefox 中的每个新的或更改后的数据收集都需要来自数据管理员的 数据收集审查。

使用 Glean

简而言之，在所有使用 Gecko 的 Mozilla 产品中收集数据的方法是使用 Glean。Glean SDK 存在于 Gecko 和所有 Firefox 桌面版中，通过 Firefox on Glean (FOG) 实现。如果您使用 Glean 指标为您的 Gecko 数据收集添加代码，只要它在 toolkit/components/glean/metrics_index.py 的 gecko_metrics 列表的 metrics.yaml 文件中定义，所有同时使用 Gecko 和 Glean 的产品都会报告这些数据。

请参阅 这些文档 获取详细信息。此指南介绍如何将 Firefox 遥测收集迁移到 Glean 中涵盖了其他相关概念。

为了确保您的数据在代码在 Firefox 桌面版中执行时也报告在遥测中，您必须确保在遥测中镜像该收集。如果可能，您应该使用 Glean Interface For Firefox Telemetry (GIFFT) 并让 FOG 为您镜像该调用。如果这看起来不适合您，您可以改为在您的遥测 API 调用旁边添加您的 Glean API 调用。

与往常一样，如果您有任何疑问，您可以在 Mozilla 的 Matrix 上的 #telemetry 频道 中找到乐于助人的人。