Skip to content


Repository files navigation

Glean Annotations


This repository stores user-defined annotations against glean metrics: both those defined in applications (for example, "fenix" aka "Firefox for Android") as well as libraries like android-components.

The published set of annotations is available at:

Documentation on how this repository works, as well as contribution information, is available at:

Local development

In general, the idea behind this repository is that most people will edit annotations from the Glean Dictionary. However, if you want to do local development the recommended setup process is to create a virtual environment and install the dependencies inside it. This requires a recent version of python (3.7+):

python3 -m venv venv/
source venv/bin/activate
pip install -r requirements.txt

After creating activating a virtual environment and installing the dependencies, run:

./scripts/ > api.json

This will create a JSON file which should be the same as the published set of annotations above.

To exit the virtual environment, use:

deactivate venv