Deployment Platforms

Overview

Koalr integrates with 10+ deployment platforms to capture deployment events in real time. Each deployment is automatically correlated with:

• The pull request(s) it contains
• The pre-merge deploy risk score for those PRs
• Any incidents that occur within 2 hours of the deployment
• DORA metrics (deployment frequency, lead time, change failure rate, MTTR)

Supported platforms

Platform	Connection method	Data captured
Vercel	Vercel webhook → Koalr	Deploy started, succeeded, failed; preview vs. production
Railway	Railway webhook → Koalr	Deploy started, succeeded, failed; service name, environment
Netlify	Netlify webhook → Koalr	Build started, succeeded, failed; branch, deploy context
Render	Render webhook → Koalr	Deploy started, live, failed; service type
Fly.io	Fly.io webhook → Koalr	Deploy events, machine restarts
AWS CodeDeploy	AWS EventBridge rule → Koalr	Deployment group, revision, lifecycle events
Buildkite	Buildkite webhook → Koalr	Build queued, running, passed, failed; pipeline name
ArgoCD	ArgoCD notification → Koalr	Application sync status, health, revision
GitHub Actions	GitHub webhook (workflow_run)	Workflow run start/completion; job-level outcomes
Azure DevOps	Azure Service Hook → Koalr	Release pipeline events, stage status

Connecting a deployment platform

1. Navigate to Settings → Deployment Sources
2. Click Connect next to your platform
3. Copy the Koalr webhook URL shown in the modal
4. Paste it into your platform's webhook settings (see platform-specific instructions below)
5. Send a test event — Koalr will confirm receipt and show the deployment in your Deployments dashboard

Vercel

1. Go to Vercel → Your Project → Settings → Webhooks
2. Add webhook URL: https://api.koalr.com/webhooks/vercel
3. Select events: deployment.created, deployment.succeeded, deployment.error, deployment.canceled
4. Add the X-Koalr-Token header (found in your Koalr integration settings) for authentication

Railway

1. Go to Railway → Project → Settings → Webhooks
2. Add webhook URL: https://api.koalr.com/webhooks/railway
3. Railway sends all deployment events by default — no event selection needed

Netlify

1. Go to Netlify → Site → Site configuration → Build & deploy → Deploy notifications → Outgoing webhooks
2. Add webhook URL: https://api.koalr.com/webhooks/netlify
3. Select events: Deploy started, Deploy succeeded, Deploy failed, Deploy locked, Deploy unlocked

Fly.io

1. Use the Fly CLI: fly webhooks create --app YOUR_APP --url https://api.koalr.com/webhooks/flyio --events deploy
2. Or use the Fly dashboard → App → Webhooks

AWS CodeDeploy

1. Create an EventBridge rule in your AWS account:
   • Event source: aws.codedeploy
   • Events: CodeDeploy Deployment State-change Notification
2. Set the target to an API Gateway endpoint or Lambda that forwards to https://api.koalr.com/webhooks/aws-codedeploy
3. Add your X-Koalr-Token in the HTTP header

GitHub Actions

GitHub Actions events are captured automatically via your existing GitHub integration — no additional webhook setup required. Koalr listens for workflow_run events on your connected repositories.

Deployment data in Koalr

Once connected, deployments appear in:

• Deployments dashboard — timeline, success rate, per-environment breakdown
• Deploy Heatmap — frequency by day/hour heatmap
• Deploy Risk — each deployment linked to its PR risk score and outcome
• DORA Metrics — deployment frequency and change failure rate computed from deployment events
• Incidents — auto-correlated with PagerDuty/Opsgenie incidents occurring within 2 hours

Environment tagging

Koalr distinguishes production from staging/preview deployments. Production deployments count toward DORA metrics; staging deployments are tracked separately. Platform-specific environment detection:

• Vercel: target === "production" = production; preview deployments are staging
• Railway: deployments to the production environment = production
• Netlify: context === "production" = production; deploy previews = staging
• Others: configurable via the environment mapping in Settings → Deployment Sources