> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dqlabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Install the Prizm Pulse GitHub App to monitor merged pull requests and automatically link dbt code changes to data quality alerts.

<script type="application/ld+json">
  {`{
            "@context": "https://schema.org",
            "@type": "TechArticle",
            "headline": "GitHub App Overview",
            "description": "Install the Prizm Pulse GitHub App to monitor merged pull requests and automatically link dbt code changes to data quality alerts.",
            "url": "https://docs.dqlabs.ai/integrations/githubapp/overview",
            "publisher": {
              "@type": "Organization",
              "name": "DQLabs Inc",
              "logo": "https://media.brand.dev/332adc35-5bc4-4d2b-bf78-256aa4a5e414.svg"
            }
            }`}
</script>

## What is the GitHub App integration?

The GitHub App integration installs **Prizm Pulse** on your GitHub organization. Prizm continuously monitors pull requests and commits across configured dbt repositories, captures change metadata, and makes it available to the Investigation Agent. When a data quality alert fires on a downstream asset, the Investigation Agent traverses the lineage graph upstream and matches the alert to recent PRs or commits that touched the affected models — surfacing a root-cause hypothesis with the exact PR, files, author, and timestamp.

For organizations running dbt, this closes the gap between code deployments and data quality incidents: instead of manually reviewing git history after an alert, engineers get a direct, lineage-aware link between the quality event and the code change that caused it.

## What this integration enables

| Capability                       | Description                                                                                                                                 |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Merged PR monitoring**         | Captures PR open and merge events on configured repositories and branches. Detects changes to `.sql`, `.yml`, and `.csv` files.             |
| **Commit-level change tracking** | Parses diffs to identify which dbt models were changed, what changed, and who made the change.                                              |
| **Root-cause analysis**          | When an alert fires, the Investigation Agent traverses lineage upstream and identifies recent PRs that touched models in the affected path. |
| **Ranked root-cause hypotheses** | Each hypothesis includes PR number, link, changed files, author, merge timestamp, and downstream assets impacted.                           |
| **Multi-repository support**     | Connect multiple dbt repositories, each with independent target branches (e.g., `main`, `develop`, `prod`).                                 |
| **Auditable change log**         | Every merged PR is stored and linked to the assets it touched — traceable record for incident reviews and governance audits.                |

## Where this surfaces in Prizm

**Alert detail page** — The Investigation Agent panel displays root-cause hypotheses linking the alert to recent PRs, with a direct link to the PR on GitHub.

**Root Cause Analysis tab** — A ranked list of PRs that may have caused the alert, traversed upstream through the lineage graph from the impacted asset.

**Asset lineage view** — PR change history for upstream dbt models appears in the lineage graph alongside quality metrics.

## Prerequisites

* GitHub Organization administrator access to install the Prizm Pulse app
* Repository administrator permissions for repositories to be monitored
* Admin or privileged user access in Prizm to configure integrations
* dbt repositories with `.sql` and `.yml` model files

<CardGroup cols={2}>
  <Card title="Setup" icon="gear" href="/integrations/githubapp/setup">
    Install Prizm Pulse, configure the webhook, and connect your repositories in Prizm.
  </Card>

  <Card title="Integration" icon="arrows-left-right" href="/integrations/githubapp/integrations">
    How the Investigation Agent uses PR metadata for root-cause analysis and what data Prizm captures.
  </Card>
</CardGroup>