@mozilla/glean

Glean.js

Glean.js is a modern approach for a Telemetry library aimed at JavaScript environments. It is part of the Glean project.

Documentation

All documentation is available online:

The Glean Book

If you are using Glean.js in your project, this is the place to go. It contains user guides on getting started and other topics, as well as reference to Glean APIs.

Glean.js developer documentation

If you want to contribute to the Glean.js code base this is the place to go.

Glean.js internal reference

If you are looking for detailed documentation on the Glean APIs (internal or external) this is the place to go.

This documentation is autogenererated from the doc comments throughout the Glean.js codebase and the Glean book should be preferred over this documentation whenever possible.

Contact

To contact us you can:

• Find us in the #glean channel on chat.mozilla.org.
• To report issues or request changes, file a bug in Bugzilla in Data Platform & Tools :: Glean.js.
• Send an email to [e-mail].
• The Glean Core team is: :dexter, :janerik, :mdroettboom, :travis_, :chutten, :brizental.

Credits

The Glean logo artwork was contributed by Diana Ciufo. It's licensed under MPL.

License

This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/

Changelog

v0.24.0 (2021-11-04)

Full changelog

• #856: Expose the @mozilla/glean/web entry point for using Glean.js in websites.
• #856: Implement the PlatformInfo module for the web platform.
  • Out of os, os_version, architecture and locale, on the web platform, we can only retrieve os and locale information. The other information will default to the known value Unknown for all pings coming from this platform.
• #856: Expose the @mozilla/glean/web entry point for using Glean.js in websites.
• #908: BUGFIX: Guarantee internal uploadEnabled state always has a value.
  • When uploadEnabled was set to false and then Glean was restarted with it still false, the internal uploadEnabled state was not being set. That should not cause particularly harmful behavior, since undefined is still a "falsy" value. However, this would create a stream of loud and annoying log messages.
• #898: Implement the Storage module for the web platform.