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
- Leverage the Governance AI agent - 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
- Leverage the Test Recommendation AI agent 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 the Triage & Resolution AI agent 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 the Optimization AI agent 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 the Discovery AI agent 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

