Here’s a link to a checkbox version of this guide that you can download and use to track your progress: Download as markdown.
Identify Critical Assets
Goal: Identify business-critical assets in your pipeline and make sure their documentation and ownership are clear.- In the Catalog, identify and mark three critical assets
- Add or update descriptions, tags, and owners for these assets
- Use AI Governance to complete missing metadata based on project context and according to your instructions.
- View end-to-end, column-level lineage for each critical asset
Setup monitoring on critical assets
Goal: Ensure critical assets are covered with the right tests so issues are detected before they affect consumers.- Open the Test Coverage view to understand existing coverage by dimension
- Add missing tests such as freshness, volume, uniqueness, anomaly detection, schema changes or custom logic
- Use AI Test Coverage for suggested tests based on patterns and lineage
- For source monitoring: Elementary automatically adds ML-based freshness and volume tests to all sources to catch pipeline and ingestion issues early
Setup Alerts
Goal: Create a routing process that gets the right alerts to the right people while avoiding alert fatigue.- Use tags, owners, and subscribers to define who should be notified and who is responsible for action
- Build an internal alert response plan: who fixes the issue, who needs awareness, and what the SLA should be (see the full playbook here)
- Create alert rules that translate this plan into routing, using tags, owners, subscribers, and severity
Triage & Resolution
Goal: Investigate and resolve issues quickly and confidently.- Triage: Review lineage and upstream failures alongside recent commits and dbt run history to understand what changed and what the issue is impacting
- Use AI Triage & Resolution to run the investigation for you by analyzing lineage, failures, recent changes, and dependencies, and surfacing root causes
- Use the Incidents screen to manage issues collaboratively and keep track of everything that’s currently open
Optimize Performance
Goal: Meet your SLAs, improve run times, and ensure your pipelines operate efficiently.- Identify long-running tests and models using the Performance pages
- Use AI Performance & Cost to optimize queries by surfacing inefficiencies, suggesting improved SQL patterns, and identifying opportunities to reduce data scans or simplify logic
Measure Progress and Data Health
Goal: Track improvements in reliability and identify where further attention is needed.- Use the Data Health screen to monitor overall health scores for your assets
- Filter the screen by domain, owners, or critical assets to measure progress at a higher resolution and keep accountability clear
Enable analysts and business users
Goal: Make it easy for anyone to discover assets, understand what they represent, see how they’re built, and know whether they can be trusted.- Use the Catalog to explore assets, their definitions, ownership, and current health status
- Review Lineage to see how the asset is built, what depends on it, and whether any upstream issues or test failures affect it
- Use AI Catalog to get clear explanations of the asset, how it’s calculated, and any current reliability concerns
Advanced: Use MCP to Extend Elementary Everywhere
For Engineers
Goal: Make development safer and faster by bringing full pipeline context into your coding environment.- Enable Elementary MCP inside your IDE or coding assistant (Cursor, Claude Code, etc.)
- Add metadata or validations at scale without touching the UI or code manually
- Check lineage, coverage, and asset health while you code so you can spot issues early, understand downstream impact, and prevent problems from reaching production
For Analysts and Business Users
Goal: Bring Elementary’s context into the tools people already use.- Connect Elementary MCP to any MCP-enabled client (Claude, ChatGPT, or internal AI agents)
- Allow users to ask about assets, see definitions and ownership, review lineage, and check health or incidents directly through their AI assistant
- (Optional) Connect additional MCPs such as dbt or Atlan so users can navigate across multiple systems from a single conversational interface

