GitHub

The GitHub integration is the foundation of Koalr. Most features — deploy risk, DORA metrics, CODEOWNERS, PR analytics — require GitHub to be connected.

Connecting GitHub

1. Click Integrations in the sidebar
2. Click the GitHub card, then Connect
3. You'll be redirected to GitHub to authorize the Koalr OAuth App
4. Click Authorize to grant Koalr access

Koalr requests the following OAuth scopes:

• read:org — list your GitHub organization and teams
• repo — read repository contents, PRs, and deployments
• read:user — resolve contributor identities

What Koalr syncs from GitHub

Data	Sync method	Frequency
Pull requests (merged)	Webhook + REST backfill	Real-time
Deployments	Webhook	Real-time
CODEOWNERS files	REST (all repos)	Webhook + daily
GitHub Teams	REST	On-demand (import)
Check runs / CI status	Webhook	Real-time
GitHub Actions workflow runs	Webhook (workflow_run)	Real-time
Repository metadata	REST backfill	On connect

GitHub Deployments API

Koalr reads deployments from the GitHub Deployments API. If your CI/CD pipeline doesn't create GitHub Deployments, you can also send deployments via:

• Vercel webhook (auto-creates deployment records)
• Railway webhook
• Netlify webhook
• Render webhook
• Fly.io webhook
• AWS CodeDeploy → SNS

CODEOWNERS sync

Koalr parses CODEOWNERS files from 3 locations in each repository:

1. .github/CODEOWNERS
2. CODEOWNERS (root)
3. docs/CODEOWNERS

Changes to CODEOWNERS files trigger an immediate re-sync via webhook. A daily drift detection cron (3 AM UTC) checks for any divergence and sends Slack alerts if configured.

GitHub Actions CI Analytics

When GitHub is connected, Koalr ingests workflow_run and check_run webhook events to build a CI health picture across all your repositories.

Koalr tracks:

• Pass rate per workflow and per job
• Flakiness score — ratio of flap events (pass → fail → pass within 24h) to total runs
• Duration trend — P50 and P75 run time per workflow over the past 90 days

Jobs with flakiness > 10% are flagged in the CI Analytics dashboard. This surfaces the highest-ROI tests to fix.

See CI Analytics for the full dashboard documentation.

Troubleshooting

PRs not appearing: Check that the webhook is active in your GitHub OAuth App settings. Go to Settings → Developer Settings → OAuth Apps → Koalr.

CODEOWNERS not syncing: Ensure the file is in one of the 3 supported locations. Check that the GitHub OAuth App has contents: read permission on the repository.

Deployment events missing: Confirm your CI/CD pipeline creates GitHub Deployment records. Many pipelines use gh deployment create or the Deployments API directly.