Pipeline Lineage View

Scope: This document explains the Lineage screen located at pages/client/[id]/pipeline/[pipelinename]/lineage/index.vue.

1. Purpose

The Lineage View renders an interactive graph of every asset produced or consumed by the selected pipeline. It helps you:

• Identify upstream dependencies that might affect data freshness
• Understand which downstream jobs rely on a given asset
• Quickly navigate large DAGs via asset search and focus tools

2. Layout & Controls

Control	Location	Action
Mouse wheel	Anywhere	Zoom in / out (30 % – 200 %)
Drag	Background	Pan graph
Asset List dropdown	Top-right	Select an asset to focus & centre the view
⌘ / Ctrl + 0	Keyboard	Fit graph to viewport

The graph is auto-laid out left-to-right (LR) for readability.

3. Node & Edge Types

• Blue nodes – assets created by the current pipeline
• Grey nodes – external assets (produced elsewhere)
• Arrows – data flow direction

Hover a node to view the full asset name; click to highlight its immediate neighbours.

4. Troubleshooting

”Unable to Load Pipeline Data” error

• Ensure you navigated from the Pipelines screen so a pipeline is selected.
• The pipeline might not have lineage metadata yet. Trigger a run and refresh.

Graph looks empty

• Check that the pipeline produced at least one asset in the last run.
• Verify the backend endpoint /lineage/full_lineage/:dag_id returns nodes & edges.

5. FAQ

Can I download the graph? Export to PNG / SVG is on the roadmap. For now take a screenshot or use the browser’s print-to-PDF.

Can I change the layout orientation? Not yet from the UI, but internally we use Dagre; a future setting will let you switch between vertical (TB) and horizontal (LR) layouts.

6. Change Log

Date	Author	Notes
2025-07-07	Docs Team	Initial version