Glean provides a few debugging features to assist with debugging a product using Glean.
Print the ping payload upon sending a ping.
Tags all outgoing pings as debug pings to make them available for real-time validation, on the Glean Debug View.
The Glean Debug View enables you to easily see in real-time what data your application is sending.
This data is what actually arrives in our data pipeline, shown in a web interface that is automatically updated when new data arrives. Any data sent from a Glean-instrumented application usually shows up within 10 seconds, updating the pages automatically. Pings are retained for 3 weeks.
If nothing is showing up on the dashboard after you set a
debugViewTag and you see
Glean must be enabled before sending pings. in the logs, Glean is disabled. Check with
the application author on how to re-enable it.
Tags outgoing pings with a maximum of 5 comma-separated tags.
Sends a ping on demand.
Each Glean SDK may expose one or more of the following methods to interact with and enable these debugging functionalities.
- Enable debugging features through APIs exposed through the Glean singleton;
- Enable debugging features through environment variables set at runtime;
- Enable debugging features through platform specific tooling.
For methods 1. and 2., refer to the API reference section "Debugging" for detailed information on how to use them.
For method 3. please refer to the platform specific pages on how to debug products using Glean.
- Debugging Android applications using the Glean SDK
- Debugging iOS applications using the Glean SDK
- Debugging Python applications using the Glean SDK
|Glean API||Environment Variables||Platform Specific Tooling|
|Firefox Desktop||✅||✅ 3|
The Glean Kotlin SDK exposes the
GleanDebugActivity for interacting with debug features. Although it is technically possible to also use environment variables in Android, the Glean team is not aware of a proper way to set environment variables in Android devices or emulators.
The Glean Swift SDK exposes a custom URL format for interacting with debug features.
In Firefox Desktop, developers may use the interface exposed through
about:glean to log, tag or send pings.