> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oleander.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Lineage

> Unified API for lineage metadata interoperability.

## oleander and OpenLineage: A unified approach

oleander, in its simplest form, is a [consumer/producer](https://openlineage.io/ecosystem) implementation of the [OpenLineage specification](https://github.com/OpenLineage/OpenLineage/blob/main/spec/OpenLineage.json). OpenLineage is an open standard for lineage metadata 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](https://openlineage.io/docs/spec/object-model) is extensible through [custom](https://openlineage.io/docs/spec/facets/) facets that enrich the core entities.

<img className="rounded-md" src="https://mintcdn.com/oleander/Pkx46010SxSD-P6X/images/ol-oleander.png?fit=max&auto=format&n=Pkx46010SxSD-P6X&q=85&s=e603fd3f020fa82dae57b4164d5221f1" alt="OpenLineage and oleander" width="1600" height="874" data-path="images/ol-oleander.png" />

## OpenLineage facets

<Tip>
  We provide the facet tool that we use to validate the facets that are attached to the core entities. This can be found [here](https://oleander.dev/ol-validate).
</Tip>

OpenLineage provides a set of ever-growing [facets](https://openlineage.io/docs/spec/facets/) that can be attached to the core entities. These facets are designed to enrich the core entities with additional metadata that can be used to provide more context around the lineage of the data. The facets are designed to be extensible and can be added to the core entities as needed. oleander provides support for many of the most popular facets and is always looking to add more.

> More information on OpenLineage can be found at [openlineage.io](https://openlineage.io).

See the [lineage graph](/observability/lineage/graph) and [events](/observability/events) pages for how oleander surfaces OpenLineage in the product.