---
id: kedro-telemetry
version: "0.8.0"
license: Apache Software License (Apache 2.0)
license_treatment: permissive
maintenance: active
---

# kedro-telemetry — Kedro-Telemetry

License: permissive · Maintenance: active · Downloads: 674.2K/mo

## What it is and what it does

Kedro-Telemetry is a Kedro plugin that automatically collects anonymized usage data from Kedro projects and sends it to Heap Analytics. It uses pluggy hooks and requests to gather information about how Kedro is used, helping the Kedro team prioritize product improvements. The plugin is enabled by default when installed.

You can disable telemetry collection in three ways: by setting the DO_NOT_TRACK or KEDRO_DISABLE_TELEMETRY environment variables, by creating a .telemetry file in your project root with consent set to false, or by using the --telemetry=no flag when creating a new Kedro project. If you later withdraw consent, data collection stops immediately. The plugin depends on appdirs, requests, tomli, and tomli-w in addition to Kedro itself.

Use it for:

- Understand adoption patterns and feature usage across your organization's Kedro projects through dashboards accessible to project maintainers.
- Disable telemetry in production or sensitive environments by setting DO_NOT_TRACK or KEDRO_DISABLE_TELEMETRY environment variables.
- Opt out of data collection on a per-project basis by creating a .telemetry file with consent: false in your Kedro project root.
- Contribute to Kedro's product roadmap by allowing the team to see which features are most heavily used.

## Worth the install?

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

Kedro-Telemetry is a plugin that collects anonymized usage analytics from Kedro projects and sends them to Heap Analytics to help the Kedro team understand how the framework is used.

Yes, if you use Kedro and are comfortable with anonymized usage analytics being collected by default. The plugin is actively maintained, has no known vulnerabilities, and imposes low install friction. If you prefer not to participate in telemetry, disabling it is straightforward via environment variables or a configuration file. Uninstalling is a last resort since it breaks Kedro's dependency expectations.

## Install

pip install kedro-telemetry
uv add kedro-telemetry
poetry add kedro-telemetry

## Installing kedro-telemetry

Before you install: Low install friction with a pure-Python wheel distribution. The package is actively maintained with a recent release and no known vulnerabilities. It depends on five common packages including kedro itself, requests, and TOML utilities.

License in practice: Licensed under Apache 2.0 (permissive), allowing use in both open-source and commercial projects with minimal restrictions. You must retain license notices but face no copyleft obligations.

Quickstart:

pip install kedro-telemetry

# Telemetry is enabled by default once installed as a Kedro plugin.
# To disable: set environment variable DO_NOT_TRACK=1 or KEDRO_DISABLE_TELEMETRY=1
# Or create .telemetry file in project root with 'consent: false'

Requires Python 3.10 or later. Requires kedro to be installed. Uninstalling this plugin may cause pip check to report dependency issues since Kedro expects it.

Verify before relying:

- Whether telemetry data is truly anonymized and aggregated as claimed, and what specific fields are transmitted.
- Heap Analytics' data retention and privacy policies beyond what Kedro documentation specifies.
- Performance impact of telemetry collection on Kedro pipeline execution.

## Package facts

- License: Apache Software License (Apache 2.0) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 674.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

kedro analytics plugin, usage telemetry for kedro, anonymized kedro metrics, kedro project monitoring, data pipeline telemetry, kedro adoption tracking, usage data collection kedro, kedro-plugin, analytics, opt-out

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