首选项和定义

用户首选项

datareporting.healthreport.uploadEnabled

这决定了 Glean SDK 是否启用。用户可以通过 about:preferences#privacy 控制它。如果从 true 设置为 false，我们会发送一个 “删除请求” Ping，并且从那时起不会持久保存或报告任何数据收集。

仅测试首选项

telemetry.fog.test.localhost_port

如果设置为大于 0 的值 port，则 Ping 将发送到 https://127.0.0.1:port 而不是 https://incoming.telemetry.mozilla.org。如果设置为小于 0 的值 port，则 FOG 将

  1. 告诉 Glean 上传已启用，即使它没有启用。

  2. 获取所有计划上传的 Ping 并将其丢弃，并告诉 Glean SDK 它已成功发送。

这是一种模拟“记录已启用但上传已禁用”（例如 Firefox 遥测中的开发者版本）的方式。当从 port < 0 切换到 port >= 0 时，Glean 将被告知（即使只是暂时）上传已禁用。这将清除已记录但未报告的数据的存储。默认为 0。

telemetry.fog.test.activity_limit telemetry.fog.test.inactivity_limit

这对首选项控制活动（或反之亦然）持续多长时间，然后 FOG 才会通知 SDK 的客户端活动 API 客户端处于（非）活动状态。用于允许进行测试，而无需弄清楚如何模拟 Rust 的时钟。它们的值是以秒为单位的整数。值 -1 被视为无限制（从不触发（非）活动）。默认为 120（活动）、1200（非活动）。

内部首选项

telemetry.fog.artifact_build

只读。仅当在配置期间设置了 MOZ_ARTIFACT_BUILDS 时，此首选项才为 true。如果为 true，则 JOG 会启用，以便工件构建会显示其 Glean 指标的变化。

定义

MOZ_AUTOMATION

如果设置，并且 GLEAN_SOURCE_TAGS 未设置，则 FOG 将设置一个 Glean 源标签 为 automation，并且 FOG 将禁用“指标” Ping 的提交。

如果 GLEAN_SOURCE_TAGS 已设置，则不会自动添加 automation 源标签。

如果未设置，则 GLEAN_SOURCE_TAGS 设置的任何标签都将存在。

MOZ_GLEAN_ANDROID

如果设置，则假定 Glean SDK 由 FOG 以外的其他内容管理，这意味着

  • GIFFT 已禁用。

  • FOG 不会初始化 Glean

  • FOG 不会将（非）活动或实验注释中继到 Glean

MOZILLA_OFFICIAL

如果未设置，我们将在 gkrust 和 gkrust-shared 中设置一个 glean_disable_upload Rust 功能，该功能被转发到 fog_control 作为 disable_upload。此功能将 FOG 默认为“上传禁用”模式，其中客户端上的收集照常进行，但不会发送任何 Ping。此模式可以通过两种方式在运行时覆盖

  • 如果 Ping 具有 调试标签，则会发送它，以便可以在 Glean 调试 Ping 查看器 中检查它。

  • 如果首选项 telemetry.fog.test.localhost_port 设置为大于 0 的值，则 Ping 将发送到在该端口本地运行的服务器（即使 Ping 具有调试标签），以启用测试。

MOZILLA_OFFICIAL 倾向于在大多数发布给用户的版本中设置，包括 Linux 发行版分发的版本。它往往不会在本地开发者版本中设置。有关详细信息，请参阅 bug 1680025。

MOZ_ARTIFACT_BUILDS

如果在构建配置中设置了 MOZ_ARTIFACT_BUILDS，则 JOG 将为指标和 Ping 的运行时注册生成一个文件。这是为了支持 工件构建。

另请参阅 telemetry.fog.artifact_build。

OS_TARGET

如果未设置为 'Android'，我们将设置一个 glean_million_queue Rust 功能（参见 gkrust-features.mozbuild），该功能在传递给 Glean SDK 时，将我们选择加入一个 preinit 队列，该队列不会丢弃任务，直到有 10^6 个任务。

有关详细信息，请参阅 bug 1797494。