指标功能标签

为了帮助在Glean 词典和其他工具中查找指标,指标应包含与其所属功能区域相对应的标签元数据。对于 Firefox for Android,标签信息基于此存储库的 GitHub 功能标签

https://github.com/mozilla-mobile/fenix/labels?q=feature%3A

您可以在这里查看标签信息的呈现方式

https://dictionary.telemetry.mozilla.org/apps/fenix?itemType=tags&page=1

向指标添加功能标签

向指标添加标签信息过去需要编辑Glean 注释存储库,但您现在可以在添加或修改metrics.yaml时直接添加此信息。只需向指标添加一个名为metadata的部分,并添加与之对应的标签列表。

例如

  search_bar_tapped:
    type: event
    description: |
      A user tapped the search bar
    metadata:
      tags:
        - Search
    ...

更新功能标签

有效标签集在名为tags.yaml的文件中记录,但切勿手动更新。如果某个功能标签被添加或删除,您可以通过在存储库的根目录中运行./tools/update-glean-tags.py来同步源代码树中的标签文件。请注意,标签 *必须* 在tags.yaml中指定才能在指标中使用,因此,如果标签从tags.yaml中删除,则必须从metrics.yaml中删除其所有使用。