Skip to main content

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

  • BUGFIX: GleanGeckoMetricsMapping must include LabeledMetricType and CounterMetricType.

1.6.0 (2019-09-17)

  • 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

glean_parser-1.6.1.tar.gz (153.9 kB view hashes)

Uploaded Source

Built Distribution

glean_parser-1.6.1-py2.py3-none-any.whl (39.0 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page