The Atlan MCP Cookbook

Trace a broken dashboard to its root cause

Trace lineage upstream from a broken dashboard to find the source of wrong numbers.

All recipes

On the menu

Use case
Change & fix data safely
Action
Look up
Persona
Data/BI Analyst, Data Engineer
Effort
Moderate
Runs in
any AI tool

The task

Scenario. The Weekly Sales Dashboard has shown revenue about 30% low since Monday, and the cause is not on the dashboard; it is somewhere in the chain of tables and transforms behind it. You want to walk the lineage back and find where the numbers went wrong, with the owners and any recent notices along the way.

The ask

  • The upstream lineage of the dashboard
  • Every source table and transformation in the chain
  • The owners, recent announcements, and any DQ rule failures along it

Hero prompt

Hero prompt

The Weekly Sales Dashboard is showing revenue figures 30% lower than expected since Monday. Trace its upstream lineage hop by hop and show me the source tables and transformations in the chain along with their owners, any recent announcements, and the DQ rule failures on each.

Step by step

  1. Find the dashboard and confirm its upstream lineage.

    Step 1

    The <dashboard> has shown <metric> about <30%> off since <Monday> — find it and confirm it has upstream lineage to walk.

  2. Trace its upstream lineage, one hop at a time.

    Step 2

    Walk the upstream source tables and transformations hop by hop toward the source.

  3. Read the owners, recent announcements, and any DQ failures along the chain.

    Step 3

    For each node, show the owner, any recent announcements, and its current DQ rule failures or incidents, so I can pinpoint where the numbers break.

What you'll give it

Required context

  • The dashboard and the anomaly (Weekly Sales, revenue 30% low since Monday)
  • Lineage populated back to the sources

Optional context

  • When it was last correct, to bound which upstream changes to suspect
  • The metric's known source table, if you want to start mid-chain
  • Data Quality Studio (or another data quality connector) enabled on the chain, to surface real DQ rule failures alongside announcements

What Atlan creates

Outputs

  • The dashboard's upstream chain: every source table and transformation
  • The owner of each node in the chain
  • Any recent announcements and DQ rule failures along the way — the likely first suspects

Summary. The search narrows from "the dashboard is wrong" to a short chain with owners and a timeline. Half the time a recent announcement or a DQ rule failure upstream already names the change that broke it.

Read-only

Nothing is written. This recipe only reads lineage, metadata, announcements, and DQ rule failures, so it is safe to run mid-incident against production.

Follow-up prompts

Keep going once the first answer lands.

Zero in

Zero in

Which nodes in that chain changed or got an announcement since last Friday? Start there.

Get the owners

Get the owners

For the top suspect tables, resolve each owning group to the specific person or on-call to contact.

Write it up

Write it up

Draft a short root-cause note summarizing the chain and the most likely cause for the dashboard's owner.

Tips & troubleshooting

Cook's note

Check announcements first. Half the time someone already flagged the upstream change.

  • Match the tool to the work. Run it in whatever AI tool is open during the incident; speed matters, and the recipe is read-only. Trace one hop at a time from the dashboard rather than pulling the whole upstream graph at once, and make sure the asset actually has lineage before you start.
  • Automate or chain it. Chain it to your alerting: when a dashboard's metric moves beyond a threshold, run the upstream trace and attach it to the alert.
  • It only reads. No writes, no risk. Run it against production as many times as you need while you narrow the cause.
THE ATLAN MCP COOKBOOK

Point your AI at the Atlan MCP.
Run your first recipe.

[Website env: production]