Vercel Integration

Monitor deployments, build performance, and project analytics

Overview

The Vercel integration provides comprehensive deployment metrics including build times, deployment frequency, success rates, and project analytics.

What you’ll track:

• Deployment frequency
• Build success/failure rates
• Build duration
• Production vs preview deployments
• Project bandwidth usage
• Edge function invocations

Prerequisites

Before connecting Vercel, ensure you have:

• A Vercel account with active projects
• Owner or member access to projects you want to track
• A Dashtray account (any tier)

Connection Steps

1. Navigate to Integrations

   1. Log in to your Dashtray account
   2. Click Integrations in the sidebar
   3. Find Vercel in the Engineering category
   4. Click Connect
2. Authorize Vercel

   You’ll be redirected to Vercel’s OAuth authorization page.

   1. Select your Vercel account or team
   2. Review the requested permissions (read-only access)
   3. Click Authorize

   Dashtray only requests read-only access to deployment and project data. We never have permission to trigger deployments or modify settings.

3. Select Projects

   After authorization:

   1. Choose which projects to track
   2. Select all or specific projects
   3. Click Save

   You can modify this selection later in integration settings.

4. Initial Data Sync

   Dashtray will fetch:

   • Last 30 days of deployments
   • Build metrics and logs
   • Project configuration
   • Usage statistics

   This usually takes 1-2 minutes depending on deployment volume.

Available Metrics

Deployment Metrics

Metric	Description	Unit
vercel_deployments	Total deployments	count
vercel_deployments_today	Deployments in last 24 hours	count
vercel_deployments_success	Successful deployments	count
vercel_deployments_failed	Failed deployments	count

Build Metrics

Metric	Description	Unit
vercel_build_time	Average build duration	seconds
vercel_build_time_p95	95th percentile build time	seconds
vercel_build_success_rate	Build success rate	percentage

Usage Metrics

Metric	Description	Unit
vercel_bandwidth	Total bandwidth used	GB
vercel_edge_requests	Edge function invocations	count
vercel_serverless_invocations	Serverless function calls	count

Webhook Setup (Recommended)

For real-time deployment updates, configure Vercel webhooks:

1. Get Webhook URL

   1. Go to Integrations → Vercel → Settings
   2. Copy your unique webhook URL

   https://api.dashtray.com/webhooks/vercel/{your-project-id}
   
2. Add Webhook in Vercel

   1. Go to your project Settings → Webhooks
   2. Click Create Webhook
   3. Paste your Dashtray webhook URL
   4. Select events:
      • Deployment Created
      • Deployment Ready
      • Deployment Error
   5. Click Create Webhook
3. Verify Webhook

   Trigger a deployment to test the webhook.

   The deployment should appear in Dashtray within seconds.

Troubleshooting

Connection Failed

Problem: OAuth authorization fails.

Solutions:

• Ensure you have owner or member access to projects
• Check that you’re logged into the correct Vercel account
• Try disconnecting and reconnecting
• Verify Vercel is not experiencing outages

No Deployments Showing

Problem: Deployment metrics are zero or outdated.

Solutions:

• Verify you selected the correct projects
• Check that projects have recent deployments
• Click Refresh to trigger manual sync
• Ensure projects are not paused

Webhook Not Working

Problem: Real-time deployment updates aren’t appearing.

Solutions:

• Verify webhook URL is correct
• Check webhook secret matches (if configured)
• Review Vercel webhook logs in project settings
• Ensure webhook is active (not disabled)
• Check that selected events include deployment events

Build Time Inaccurate

Problem: Build time metrics don’t match Vercel dashboard.

Explanation:

• Build time includes queue time and actual build time
• Cold starts may increase initial build times
• Cached builds are faster than full rebuilds

Solutions:

• Compare with Vercel’s build logs
• Check if caching is properly configured
• Monitor p95 build time for outliers

Data Refresh

Manual Refresh

Click Refresh on your dashboard to fetch the latest data from Vercel.

Manual refresh fetches the last 7 days of deployments to capture recent changes.

Webhook Updates

With webhooks configured, updates appear in real-time:

• New deployments: Instant
• Build completion: Instant
• Deployment errors: Instant

Best Practices

1. Use Webhooks

Configure webhooks for real-time updates:

• Instant notification of deployment status
• Reduces API calls
• More accurate real-time metrics

2. Monitor Build Times

Track build duration to:

• Identify slow builds
• Optimize build configuration
• Improve deployment velocity

3. Track Failure Rates

Monitor deployment failures to:

• Catch issues early
• Improve build reliability
• Reduce downtime

4. Set Up Alerts

Create alerts for:

• Deployment failures
• Slow build times (> threshold)
• High bandwidth usage
• Edge function errors

Security & Privacy

Data Access

Dashtray requests read-only access to:

• Deployment history
• Build logs and metrics
• Project configuration
• Usage statistics

We never access:

• Environment variables
• Source code
• Deployment triggers
• Project settings modifications

Credential Storage

• OAuth tokens are encrypted with AES-256-GCM
• Tokens are stored securely in our database
• You can revoke access anytime from Vercel settings

Data Retention

Data retention depends on your tier:

• Starter: 3 days
• Basic: 30 days
• Pro/Scale: Unlimited

Disconnecting

To disconnect Vercel:

1. Go to Integrations → Vercel
2. Click Disconnect
3. Confirm disconnection

Disconnecting will stop data syncing. Historical data will be retained according to your tier’s retention policy.

You can also revoke access from Vercel:

1. Go to Vercel Settings
2. Find Dashtray
3. Click Disconnect

Next Steps

Create Engineering Dashboard

Build a deployment-focused dashboard

Set Up Alerts

Get notified of deployment issues

Connect GitHub

Track commits alongside deployments

Connect Sentry

Monitor errors after deployments

Support

Need help with Vercel integration?

• Email: [e-mail]
• Vercel Docs: vercel.com/docs
• Status: status.dashtray.com