Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.elementary-data.com/llms.txt

Use this file to discover all available pages before exploring further.

Every failure or warning in Elementary automatically opens an incident or is added as an event to an ongoing one. Incidents give your team a single place to track what’s broken, who’s on it, and what’s happened since the issue started.
Elementary Incidents

How incidents work

Based on grouping rules, related failures are grouped into the same incident rather than creating separate noise. Grouping rules:
  1. Additional failures of the same test or monitor on a table that already has an active incident.
  2. Coming soon — Freshness and volume issues downstream of an open model failure.
  3. Coming soon — Failures of the same test or monitor on downstream tables of an active incident.
An incident closes automatically when the failing tests, monitors, or models are successful again — or when the status is manually set to Resolved.

Managing incidents

The Incidents page gives a full view of current and past incidents, with filters to slice by status, severity, model name, assignee, and timeframe.
Each incident has a status, assignee, and severity — set from the Incidents page or directly from an alert in integrations that support alert actions.
  • StatusOpen by default. Can be changed to Acknowledged. Setting to Resolved closes the incident permanently.
  • Assignee — Assign to any team member. They’ll be notified. Leave status as Open until they acknowledge.
  • Severity — Low, Normal, High, or Critical. Model errors default to Critical, test failures to High, warnings to Normal. Can be changed manually.
Incident severity is used to prioritize response — it is not the same as dbt test severity.

Incident deep dive

Clicking an incident opens the test overview side panel with:
  1. Owner, tags, and subscribers for the test or model
  2. Execution history — result, timing, failed row samples, alert destination, and anomaly chart per run
  3. Test or model configuration — the YAML or SQL. For Cloud tests, configuration is editable directly.
  4. Upstream and downstream lineage — columns for column tests, tables for table tests
Elementary Test Overview side panel

Triage with the AI Agent

From any incident, click Investigate with AI to trigger the Triage & Resolution Agent. It inspects code changes, execution history, and lineage to surface the root cause and propose a fix.