Parser tools for Mozilla's Glean telemetry
Project description
Glean Parser
Parser tools for Mozilla’s Glean telemetry.
Features
Parses the metrics.yaml files for the Glean telemetry SDK and produces output for various integrations.
Documentation
The full documentation is available here.
Requirements
Python 3.7 (or later)
The following library requirements are installed automatically when glean_parser is installed by pip.
appdirs
Click
diskcache
inflection
Jinja2
jsonschema
PyYAML
Usage
$ glean_parser --help
Read in metrics.yaml, translate to kotlin format, and output to output_dir:
$ glean_parser translate -o output_dir -f kotlin metrics.yaml
Check a Glean ping against the ping schema:
$ glean_parser check < ping.json
History
Unreleased
1.8.3 (2019-10-02)
Fix indentation for generated Swift code
1.8.2 (2019-10-01)
Created labeled metrics and events in Swift code and wrap it in a configured namespace
1.8.1 (2019-09-27)
BUGFIX: memory_unit is now passed to the Kotlin generator.
1.8.0 (2019-09-26)
A new parser config, do_not_disable_expired, was added to turn off the feature that expired metrics are automatically disabled. This is useful if you want to retain the disabled value that is explicitly in the metrics.yaml file.
glinter will now report about superfluous no_lint entries.
1.7.0 (2019-09-24)
A “glinter” tool is now included to find common mistakes in metric naming and setup. This check is run during translate and warnings will be displayed. ⚠ These warnings will be treated as errors in a future revision.
1.6.1 (2019-09-17)
BUGFIX: GleanGeckoMetricsMapping must include LabeledMetricType and CounterMetricType.
1.6.0 (2019-09-17)
NEW: Support for outputting metrics in Swift.
BUGFIX: Provides a helpful error message when geckoview_datapoint is used on an metric type that doesn’t support GeckoView exfiltration.
Generate a lookup table for Gecko categorical histograms in GleanGeckoMetricsMapping.
Introduce a ‘Swift’ output generator.
1.4.1 (2019-08-28)
Documentation only.
1.4.0 (2019-08-27)
Added support for generating markdown documentation from metrics.yaml files.
1.3.0 (2019-08-22)
quantity metric type has been added.
1.2.1 (2019-08-13)
BUGFIX: includeClientId was not being output for PingType.
1.2.0 (2019-08-13)
memory_distribution metric type has been added.
custom_distribution metric type has been added.
labeled_timespan is no longer an allowed metric type.
1.1.0 (2019-08-05)
Add a special all_pings value to send_in_pings.
1.0.0 (2019-07-29)
First release to start following strict semver.
0.1.0 (2018-10-15)
First release on PyPI.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for glean_parser-1.8.3-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ab347045ee87b8f44141b1894013652cbe9dd52bdac83cfdf33b19be2a095779 |
|
MD5 | 689970506d9d1500fcb53b16e6c9f7da |
|
BLAKE2b-256 | 7c237b2c98e3188be6dbd35035080e30b9cfd50eb6cc864ca82413aa3f5dfe93 |