---
id: glean-parser
version: "20.2.0"
license: unclear
license_treatment: unclear
maintenance: active
---

# glean-parser — Parser tools for Mozilla's Glean telemetry

License: unclear · Maintenance: active · Downloads: 293.2K/mo

## What it is and what it does

Glean Parser is a command-line tool and library for working with Mozilla's Glean telemetry framework. It reads telemetry configuration files in YAML format (metrics.yaml and pings.yaml) and translates them into generated code for various Glean SDK integrations—such as Kotlin—while also performing validation and linting against the Glean schema. The tool is built on common Python libraries (Jinja2 for templating, jsonschema for validation, PyYAML for config parsing) and exposes both CLI commands and a programmatic API.

It is typically used by teams instrumenting applications with Glean telemetry to validate their metric definitions before deployment and to generate the boilerplate code needed to integrate those metrics into their SDKs. The package is actively maintained and supports modern Python versions (3.9 through 3.13).

Use it for:

- Validate metrics.yaml and pings.yaml files against Glean schema before committing to a repository.
- Generate Kotlin code from telemetry configuration for Android applications using Glean.
- Lint telemetry definitions to catch configuration errors early in the development cycle.
- Integrate telemetry validation into CI/CD pipelines for Glean-instrumented projects.
- Check incoming Glean ping payloads against the ping schema for correctness.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Parses and validates Glean telemetry configuration files (metrics.yaml and pings.yaml), generating code for various SDK integrations and performing linting checks.

Yes, if you are building or maintaining applications that use Mozilla's Glean telemetry framework. The package is actively maintained, has low install friction, and is production-stable. However, verify the license terms first, as the metadata does not clearly record the license under which it is distributed.

## Install

pip install glean-parser
uv add glean-parser
poetry add glean-parser

## Installing glean-parser

Before you install: Low install friction with six common dependencies (click, diskcache, jinja2, jsonschema, platformdirs, pyyaml). Active maintenance with a release 24 days ago and last commit on 2026-08-11.

License in practice: License status is unclear—no SPDX identifier or raw license text is recorded in the package metadata. Verify the actual license terms before adopting in proprietary or restricted-license projects.

Quickstart:

pip install glean-parser

glean_parser translate -o output_dir -f kotlin metrics.yaml
glean_parser check < ping.json

Requires Python 3.9 or later.

Verify before relying:

- Actual license under which glean-parser is distributed (metadata shows unclear status).
- Whether the package is suitable for production telemetry pipelines outside Mozilla infrastructure.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 293.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

glean telemetry parser, metrics.yaml validation, pings.yaml code generation, glean sdk integration, telemetry schema linting, mozilla glean tools, metrics configuration parser, telemetry, code-generation, schema-validation

[View on SkillFed](https://skillfed.io/packages/glean-parser) · [View on PyPI](https://pypi.org/project/glean-parser/)