# run event, defined with a sourced example

GLOSSARY, read 10 Nov 2026

**The short answer.** A single OpenLineage message saying that a job run started, completed or failed, with its input and output datasets. A stream of run events is what a lineage backend turns into a graph. Each event carries a run ID so start and end can be paired. DataHub ingests OpenLineage events through a REST endpoint and a Spark event listener plugin.

## Definition

A single OpenLineage message saying that a job run started, completed or failed, with its input and output datasets. A stream of run events is what a lineage backend turns into a graph. Each event carries a run ID so start and end can be paired.

## Example from a real tool

**Example.** DataHub ingests OpenLineage events through a REST endpoint and a Spark event listener plugin.

## Related terms

- [job](/glossary/job/): In OpenLineage, a process that reads datasets and writes datasets, such as an Airflow task, a Spark application or a dbt model run.
- [dataset (OpenLineage sense)](/glossary/dataset-openlineage-sense/): In OpenLineage, any named collection of data a job reads or writes: a table, a file, a topic.
- [Marquez](/glossary/marquez/): The open-source reference implementation of the OpenLineage API.

## Where to read more

- [The Lineage Depth Matrix](/matrix/)
- [All glossary terms](/glossary/)

## Sources

- docs.datahub.com/docs/lineage/openlineage: https://docs.datahub.com/docs/lineage/openlineage (read 10 Nov 2026)

Last reviewed 10 Nov 2026. Canonical: https://datalineagecompare.com/glossary/run-event/
