Skip to content

Add Vercel Plugin#66

Open
andrewmumblebee wants to merge 2 commits into
mainfrom
work/ah/vercel
Open

Add Vercel Plugin#66
andrewmumblebee wants to merge 2 commits into
mainfrom
work/ah/vercel

Conversation

@andrewmumblebee

@andrewmumblebee andrewmumblebee commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

🔌 Plugin overview

  • Plugin name: Vercel
  • Purpose / problem solved: Monitoring of Vercel platform analytics, i.e. deployments, cost, firewall events
  • Primary audience (e.g. platform teams, SREs, product teams): DevOps
  • Authentication method(s) (e.g. OAuth, Username/Password, API Key): API Key

🖼️ Plugin screenshots

Plugin configuration

image image

Default dashboards

image image image image

🧪 Testing


⚠️ Known limitations

  • Deployments are not indexed. They are available only as data streams, because deployment volume and churn make them unsuitable as long-lived graph objects.
  • No real-time analytics or metrics via REST. Vercel does not expose Web Analytics (pageviews/visitors), Speed Insights (Core Web Vitals), or real-time Observability metrics (edge requests, function invocations, bandwidth) through its public REST API. Operational usage is available only as daily billed quantities via the cost stream — not real-time, per-request telemetry.
  • Cost data is daily granularity and the billing endpoint returns very large datasets, so the cost stream is restricted to the Last 24 hours and Last 7 days timeframes, even then we may get time outs or lambda response size errors
  • Team members and cost require a Team and a token with adequate role/plan. On personal/Hobby accounts these streams may be empty.
    • One connection = one scope. Each configured plugin instance monitors either your personal account or a single team. To monitor multiple teams, add the plugin once per team.
  • Rate limits. Vercel enforces per-action rate limits (HTTP 429). Very large accounts may occasionally see throttling during imports.

📚 Checklist

  • Plugin, datastream and UI naming follow SquaredUp guidelines
  • Logo added
  • One or more dashboards added
  • README added including configuration guidance
  • No secrets or credentials included
  • I agree to the Code of Conduct

@github-actions

Copy link
Copy Markdown

🧩 Plugin PR Summary

📦 Modified Plugins

  • plugins/Vercel/v1

📋 Results

Step Status
Validation ❌ Failed
Deployment ⏭️ Skipped

🔍 Validation Details

plugins/Vercel/v1
{
  "valid": false,
  "errors": [
    {
      "file": "metadata.json",
      "message": "Unsupported metadata schema version: 2.1. Expected version 2.0."
    },
    {
      "file": "configValidation.json",
      "message": "Step references a data stream that is invalid or doesn't exist in this plugin: currentUser",
      "path": [
        "steps",
        0,
        "dataStream",
        "name"
      ]
    }
  ]
}

@andrewmumblebee andrewmumblebee marked this pull request as ready for review June 16, 2026 14:28
@andrewmumblebee andrewmumblebee requested a review from a team June 16, 2026 14:28
@andrewmumblebee

Copy link
Copy Markdown
Contributor Author

schemaVersion is breaking validation, as fix for it not live in prod yet.

Waiting on Vercel's APIs to be back up to share Cost dashboard, as currently failing due to platform issues on their end

@clarkd

clarkd commented Jun 17, 2026

Copy link
Copy Markdown
Member

@claude review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants