What does `edr report` produce?

A single self-contained `elementary_report.html` with dbt test results, model run history, anomaly detections and the lineage view — designed to be opened in a browser without a server.

Why not use `edr send-report` to S3?

You can, and many teams do. It means provisioning a bucket, a policy and a distribution for a page whose whole point is that it is one file. Publishing it is the same outcome without the infrastructure.

Does the interactive part keep working?

Yes. Report HTML renders with scripts enabled inside a sandboxed iframe, so the filters, the test history charts and the lineage graph behave the way they do locally.

How often should it be regenerated?

After each dbt run, or on a daily schedule. One report id PATCHed each time gives you a revision per run and a URL that never changes.

Can analysts comment on a failing test?

Yes. Threads anchor to the rendered content, so 'this freshness failure is the upstream vendor's Sunday batch, expected' sits on that test.

Share an Elementary data report

Elementary sits on top of dbt and answers the question dbt's own output doesn't: not just "did the tests pass" but "is this column behaving the way it did last week". edr report renders all of it into a single HTML file.

Then the file sits on the machine that ran edr, and the analyst who needs it is somewhere else entirely.

Generate the report

pip install elementary-data
dbt deps && dbt run && dbt test   # populates elementary's tables

edr report --file-path elementary_report.html

One file, self-contained, no server.

Publish it

Drag elementary_report.html into the app, or from your orchestrator:

curl -fsS -X PATCH "https://commareports.com/api/v1/reports/$REPORT_ID" \
  -H "Authorization: Bearer $COMMA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$(jq -n --rawfile html elementary_report.html \
        --arg title "Data quality — $(date +%F)" '{title: $title, html: $html}')"

Same id every run. The link in the analytics channel keeps working; the runs behind it accumulate as revisions.

The alternative is a bucket

edr send-report will push to S3, GCS or Azure, and that is a reasonable thing to do if you already have the bucket, the lifecycle policy, the CDN and somebody who remembers how the IAM policy was written. For a single HTML file that changes once a day, it is a lot of infrastructure to own — see hosting an HTML file for the general version of this trade-off.

What the analysts get

Anchored threads on the failing test — "the vendor's Sunday batch lands late, this freshness failure is expected" — attached to the test rather than re-explained every Monday. See commenting on HTML.
Revisions, so "when did this column start drifting" is answerable.
A routine if you want the report regenerated and republished on a schedule.
Access per report — data quality reports name your tables; keep them team-scoped. See the sharing model.

Limits

Entry HTML: 5 MB. Assets: 25 MB per file, 250 MB and 500 files total. A project with thousands of models can produce a large single file — scope the report with --select if it approaches the entry cap.
60 requests/minute per token.

Try it

Comma is free — unlimited reports, unlimited commenters, unlimited revision history.

Publish a data report →