This page describes the steps for adding Glean to a project. This does not include the steps for adding a new metrics or pings to an existing Glean integration. If that is what your are looking for, refer to the Adding new metrics or the Adding new pings guide.
The Glean integration checklist can help to ensure your Glean SDK-using product is meeting all of the recommended guidelines.
Products (applications or libraries) using the Glean SDK to collect telemetry must:
Integrate the Glean SDK into the build system. Since the Glean SDK does some code generation for your metrics at build time, this requires a few more steps than just adding a library.
Go through data review process for all newly collected data.
Ensure that telemetry coming from automated testing or continuous integration is either not sent to the telemetry server or tagged with the
automationtag using the
Additionally, applications (but not libraries) must:
Request a data review to add Glean to your application (since it can send data out of the box).
Initialize Glean as early as possible at application startup.
Provide a way for users to turn data collection off (e.g. providing settings to control
Glean.setUploadEnabled()). The exact method used is application-specific.
Step-by-step tutorials for each supported language/platform, can be found on the specific integration guides: