OpenLineage

Overview

OpenLineage is an Open standard for metadata and lineage collection designed to instrument jobs as they are running. It defines a generic model of run, job, and dataset entities identified using consistent naming strategies. The core lineage model is extensible by defining specific facets to enrich those entities.

OpenLineage is an LF AI & Data Foundation Graduate project under active development, and we welcome contributions.

Problem

Before

• Duplication of effort: each project has to instrument all jobs
• Integrations are external and can break with new versions

With OpenLineage

• The effort of integration is shared
• An integration can be pushed in each project: no need to play catch up

Scope

OpenLineage defines the metadata for running jobs and the corresponding events. A configurable backend allows the user to choose what protocol to send the events to.

Core model

A facet is an atomic piece of metadata attached to one of the core entities. See the spec for more details.

Spec

The specification is defined using OpenAPI and allows extension through custom facets.

Integrations

OpenLineage supports integrations with Spark, Airflow, dbt, Flink, and more. For the most up-to-date and complete list of supported integrations, their capabilities, and matrices, please refer to the official OpenLineage Integrations Documentation.

Related projects

• Marquez: Marquez is an LF AI & DATA project to collect, aggregate, and visualize a data ecosystem's metadata. It is the reference implementation of the OpenLineage API.
  • OpenLineage collection implementation
• Egeria: Egeria offers open metadata and governance for enterprises - automatically capturing, managing and exchanging metadata between tools and platforms, no matter the vendor.

Community

• Website: openlineage.io
• Slack: OpenLineage.slack.com
• Twitter: @OpenLineage
• Mailing list: openlineage-tsc
• Wiki: OpenLineage+Home
• LinkedIn: 13927795
• YouTube: channel
• Mastodon: @[email protected]

Talks

• Flink Forward, October 2024. Data Lineage for Apache Flink with OpenLineage
• Airflow Summit, September 2024. Activating operational metadata with Airflow, Atlan and OpenLineage
• Kafka Summit, March 2024. OpenLineage for Stream Processing
• Data Council Austin, March 2024. Data Lineage: We've Come a Long Way
• Data+AI Summit June 2023. Cross-Platform Data Lineage with OpenLineage
• Berlin Buzzwords, June 2023. Column-Level Lineage is Coming to the Rescue
• Berlin Buzzwords, June 2022. Cross-Platform Data Lineage with OpenLineage
• Berlin Buzzwords, June 2021. Observability for Data Pipelines with OpenLineage
• Data Driven NYC, February 2021. Data Observability and Pipelines: OpenLineage and Marquez
• Big Data Technology Warsaw Summit, February 2021. Data lineage and Observability with Marquez and OpenLineage
• Metadata Day 2020. OpenLineage Lightning Talk
• Open Core Summit 2020. Observability for Data Pipelines: OpenLineage Project Launch

Contributing

See CONTRIBUTING.md for more details about how to contribute.

Report a Vulnerability

If you discover a vulnerability in the project, please open an issue and attach the "security" label.

Star History

---

SPDX-License-Identifier: Apache-2.0
Copyright 2018-2026 contributors to the OpenLineage project