Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update glam docs - part 1 #856

Merged
merged 6 commits into from
Dec 16, 2024
Merged

Update glam docs - part 1 #856

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
3c4dc8a
Update GLAM cookbook
edugfilho Dec 13, 2024
c305214
Update glam datasets page
edugfilho Dec 13, 2024
54c9981
Fix spelling, apply prettier
edugfilho Dec 13, 2024
c58d8c3
enhance intro
edugfilho Dec 16, 2024
22f2881
Update src/datasets/glam.md
edugfilho Dec 16, 2024
f11fc4a
Update src/datasets/glam.md
edugfilho Dec 16, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions .spelling
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -495,3 +495,7 @@ rescan
unmute
2023-Q4
2024-H1
is_lineage_mode
schemaFilter
client_scalar_probe_counts
20Definition
15 changes: 3 additions & 12 deletions src/cookbooks/glam.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# Introduction to GLAM

GLAM was built to help Mozillians answer their data questions without needing data analysis or coding skills. It contains a visualization layer meant to answer most "easy" questions about how a probe or metric has changed over build ids and releases.
GLAM was built to help Mozillians answer most "easy" questions about how a probe or metric has changed over build ids and releases.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is it for Desktop or all browsers?
When I read it I think "easy" is a bit vague, maybe easier to just remove it / give one or two examples?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reading below I see is for all apps, so probably just good to mention it in the intro. Your call.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks! That whole paragraph was a little vague.


GLAM is one of several high-level data tools that we provide at Mozilla. For more information, see [Tools for Data Analysis](../introduction/tools.md).

Access to GLAM is currently limited to Mozilla employees and designated contributors (this [may change in the future](https://bugzilla.mozilla.org/show_bug.cgi?id=1712353)). For more information, see [gaining access](../concepts/gaining_access.md).
Access to GLAM is public!
Copy link
Contributor

@lucia-vargas-a lucia-vargas-a Dec 16, 2024 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🥳


## How to use GLAM

Expand All @@ -14,7 +14,7 @@ You can visit GLAM at [`glam.telemetry.mozilla.org`](https://glam.telemetry.mozi

![](../assets/GLAM_screenshots/front-page.png)

The front page includes two main sections: the search bar and the random probe explorer. Fuzzy tech search is implemented to let users search not only by the probe title, but also by the full description.
The front page includes two main sections: the search bar and the random probe explorer. Users can search not only by the probe title, but also by the full description.

GLAM is currently serving data for Firefox Desktop and Firefox for Android.

Expand Down Expand Up @@ -43,15 +43,6 @@ Clicking on a probe or metric name takes you to the individual explorer, where m

**`(6)`** shows the volume of clients with each given Build ID

## Differences between GLAM and `telemetry.mozilla.org` dashboard

GLAM is aggregated per client, `telemetry.mozilla.org` (TMO) is aggregated per ping. This will cause different movements in the visualization between the two systems. Notably:

- Because GLAM normalizes the aggregations by client ID, a single client weighs equally to all other clients, regardless of how many samples that client sends.
- Reversely, TMO does not normalize by client ID, so if a single client sends a lot of pings, that client will impact the distribution more heavily. This can result in some changes appearing bigger on TMO.

As of July 2022, TMO serves only Firefox Desktop (telemetry) data, while GLAM supports Firefox Desktop (both telemetry and Glean), Firefox for Android (Fenix), with ongoing efforts to integrate Firefox iOS and more products that use Glean as their telemetry system.

## Going deeper

For more information about the datasets that power GLAM, see [GLAM Datasets](../datasets/glam.md).
Expand Down
Loading
Loading