Skip to main content

​
How the GitHub App works

Once Prizm Pulse is installed and your repositories are registered in Prizm, GitHub delivers pull request events to the Prizm webhook (/api/v1/integration/webhook/github). Prizm monitors the repositories and target branches you configured, captures metadata for each change, and stores it so the Investigation Agent can use it later. Prizm Pulse has read-only access to pull requests, repository metadata, branch information, and commit metadata. It does not modify your repositories.

​
What Prizm captures

Every merged PR is stored and linked to the assets it touched. This gives you an auditable change log for incident reviews and governance audits.

​
How root-cause analysis works

When a data quality alert fires on a downstream asset, the Investigation Agent works through the following steps:
  1. Start from the alert. It identifies the asset that raised the alert.
  2. Traverse lineage upstream. It walks the lineage graph from that asset to the upstream dbt models in its path.
  3. Match recent changes. It looks for recent PRs or commits that touched those models.
  4. Rank the hypotheses. Each match becomes a root-cause hypothesis, ranked and shown with the PR number and link, the changed files, the author, the merge timestamp, and the downstream assets impacted.
Instead of reviewing git history by hand after an alert, you get a lineage-aware link between the quality event and the code change that may have caused it.

​
Where this surfaces in Prizm

​
Multiple repositories and branches

You can connect more than one dbt repository. Each repository has its own list of target branches (for example main, develop, and prod), and Prizm monitors merged PR events on those branches only. To add a repository or branch later, follow Updating repository access.

​
Troubleshooting

No pull requests appear in Prizm — Confirm the webhook is enabled in the Prizm Pulse app settings on GitHub and that the webhook URL points to your Prizm instance. Check that the repository name is in org/repo format and that the PR targets one of the branches configured for that repository. A repository is not monitored — The Prizm Pulse app needs access to the repository on GitHub, and the repository must also be added in Prizm. If the app does not have access to a repository listed in Prizm, monitoring for that repository fails silently. See Updating repository access. Saving the integration fails — Verify that the numeric Installation ID matches the one in the GitHub installation URL for your organization. A PR does not appear in root-cause hypotheses — Prizm detects changes to .sql, .yml, and .csv files. A PR that does not change any of these file types is not matched to dbt models. The PR also has to touch a model in the lineage path of the asset that raised the alert.

Overview

What the GitHub App integration is and what it enables.

Setup

Install Prizm Pulse, configure the webhook, and connect your repositories in Prizm.