Metric Feature Tags
To help find metrics in the Glean Dictionary and other tools, metrics should contain tag metadata corresponding to the feature area(s) that they belong to. In the case of Firefox for Android, tag information is based off of the GitHub feature labels for this repository:
https://github.com/mozilla-mobile/fenix/labels?q=feature%3A
You can see how tag information is rendered here:
https://dictionary.telemetry.mozilla.org/apps/fenix?itemType=tags&page=1
Adding feature tags to metrics
Adding tag information to a metric used to involve editing the Glean Annotations repository, but you can now add this
information directly when adding or modifying metrics.yaml
. Just add a section called metadata
to the metric and add a list of tags that correspond to it.
For example:
search_bar_tapped:
type: event
description: |
A user tapped the search bar
metadata:
tags:
- Search
...
Updating the feature tags
The set of valid tags is documented in a file called tags.yaml
, but should never be updated by hand.
If a feature labels is ever added or removed, you can synchronize the tags file in the source tree by running ./tools/update-glean-tags.py
in the root of the repository.
Note that a tag must be specified in tags.yaml
for it to be usable in a metric, so if a tag is removed from tags.yaml
all uses of it must be removed from metrics.yaml
.