How to Connect GitHub

4 min read Integrations

Connecting GitHub to Nova lets you correlate code deployments with incidents, track DORA metrics (deployment frequency, lead time, change failure rate, MTTR), and see exactly which commit caused a regression.

Steps

Install the Nova GitHub App

Go to Settings > Integrations > GitHub and click Install GitHub App. You will be redirected to GitHub to authorize the app.

Select repositories

Choose which repositories Nova should track. You can grant access to all repos or select specific ones. Nova only needs read access to commits, pull requests, and deployments.

Map repos to services

Back in Nova, map each repository to the corresponding service. This lets Nova show deployment markers on metric charts and link incidents to specific commits.

Enable deployment tracking

Add a deployment notification to your CI/CD pipeline:

curl -X POST https://api.novaaiops.com/v1/deployments \ -H "Authorization: Bearer $NOVA_API_KEY" \ -d '{"service":"api","version":"v1.2.3","commit":"abc123"}'

Tip:

Nova automatically detects GitHub Actions deployments if you use the standard deployment event. No extra curl command needed.

View deployment correlations

On any metric chart, deployment events appear as vertical markers. Click a marker to see the commit hash, author, and PR link. When an incident occurs near a deployment, Nova flags the deployment as a likely cause.

Ready to get started?

Connect GitHub and correlate deployments with incidents automatically.

Start Free Trial