Data lineage in Knowledge Catalog (formerly Dataplex Universal Catalog) lets you
manually record lineage information for systems that aren't supported by
[automated data lineage
tracking](https://docs.cloud.google.com/knowledge-catalog/docs/about-data-lineage#lineage-supported-systems),
such as external or on-premises databases. You can use the Data Lineage API
to log custom processes, runs, and events that capture data movement and
maintain a complete, end-to-end view of your data.

## Record custom events

To track data movement when integrating with external or on-premises databases,
create the following resources in order:

1. Create a [process](https://docs.cloud.google.com/knowledge-catalog/docs/reference/data-lineage/rest/v1/projects.locations.processes.md.txt#Process) using the [processes.create](https://docs.cloud.google.com/knowledge-catalog/docs/reference/data-lineage/rest/v1/projects.locations.processes/create.md.txt) method.
2. Create a [run](https://docs.cloud.google.com/knowledge-catalog/docs/reference/data-lineage/rest/v1/projects.locations.processes.runs.md.txt#resource:-run) using the [processes.runs.create](https://docs.cloud.google.com/knowledge-catalog/docs/reference/data-lineage/rest/v1/projects.locations.processes.runs/create.md.txt) method.
3. Create a [lineage event](https://docs.cloud.google.com/knowledge-catalog/docs/reference/data-lineage/rest/v1/projects.locations.processes.runs.lineageEvents.md.txt#resource:-lineageevent) using the [processes.runs.lineageEvents.create](https://docs.cloud.google.com/knowledge-catalog/docs/reference/data-lineage/rest/v1/projects.locations.processes.runs.lineageEvents/create.md.txt) method.