ripple

A triage tool for broken data tables in DataHub. Give it a table that's broken and it shows you:

• every table, chart, and dashboard downstream that's affected

• which of them matter most, and an overall severity (SEV1 to SEV3)

• who owns them and should be told

Then it records the incident on the table in DataHub.

Try the online demo, no setup needed.

Requirements

• A running DataHub (a local datahub docker quickstart works)

• Python 3.10+

• A DataHub access token

Related MCP server: semley

Install

git clone https://github.com/chakri192/ripple.git
cd ripple
pip install -e .
cp .env.example .env      # add your DataHub token

Try it

Load a sample setup into DataHub (an orders table feeding five tables and three dashboards), then triage it:

python demo/seed_incident_demo.py
ripple triage "urn:li:dataset:(urn:li:dataPlatform:snowflake,prod.raw.orders_raw,PROD)" --no-write-back

Commands

Each triage prints a summary in the terminal and saves a Markdown report in examples/_scratch/.

Severity

• SEV1: a dashboard or chart is affected (tag a dashboard internal in DataHub if it isn't customer-facing)

• SEV2: something is affected, but nothing customer-facing

• SEV3: nothing downstream is affected

What it changes in DataHub

• Adds an incident tag to the broken table

• Adds the incident report to the table's description, below anything already written there (running triage again replaces only the report)

• With --incident (and always in watch mode), creates a DataHub incident

Use --no-write-back if you don't want DataHub changed at all.

Settings

In .env:

License

Apache-2.0

Contributors