[Metrics] use v2 endpoints by Jooliashi · Pull Request #15876 · vercel/vercel

Jooliashi · 2026-04-08T10:04:03Z

Switches vercel metrics from the V1 event/measure contract to the V2 metric-id contract, using --metric for queries and schema inspection.
Updates the CLI to call the V2 observability endpoints: GET /v2/observability/schema, GET /v2/observability/schema/:metricId, and POST /v2/observability/query.
Removes CLI-side metric semantics/validation in favor of API-driven validation, and consistently surfaces API code, message, and allowedValues in both text and JSON output.

changeset-bot · 2026-04-08T10:04:12Z

🦋 Changeset detected

Latest commit: 9cc6049

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
vercel	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

github-actions · 2026-04-08T10:04:21Z

📦 CLI Tarball Ready

The Vercel CLI tarball for this PR is now available!

Quick Test

You can test this PR's CLI directly by running:

npx https://vercel-o9exts2a6.vercel.sh/tarballs/vercel.tgz --help

Use in vercel.json

To use this CLI version in your project builds, add to your vercel.json:

{
  "build": {
    "env": {
      "VERCEL_CLI_VERSION": "vercel@https://vercel-o9exts2a6.vercel.sh/tarballs/vercel.tgz"
    }
  }
}

Python Runtime Wheel

A vercel-runtime wheel was also built for this PR.
To use in your Python project builds, also set this environment variable:

VERCEL_RUNTIME_PYTHON="vercel-runtime @ https://vercel-o9exts2a6.vercel.sh/tarballs/vercel_runtime-0.13.0.dev1775748901+9cc6049-py3-none-any.whl"

Python Workers Wheel

A vercel-workers wheel was also built for this PR.
To use in your Python project builds, also set this environment variable:

VERCEL_WORKERS_PYTHON="vercel-workers @ https://vercel-o9exts2a6.vercel.sh/tarballs/vercel_workers-0.1.0.dev1775748901+9cc6049-py3-none-any.whl"

vercel · 2026-04-08T10:05:26Z

Low Risk — CLI API version migration with updated endpoints, flag names, and request/response shapes.

command.ts: renamed --event/--measure flags to --metric, updated examples
query.ts: switched from /v1/observability/query to /v2/observability/query, removed CLI-side validation in favor of API-driven validation
schema-api.ts: replaced event-based schema fetching with metric-based endpoints (/v2/observability/schema)

^{Assessed at 9cc6049.}

github-actions · 2026-04-08T10:07:53Z

🧪 Unit Test Strategy

Comparing: ae85c7c → 9cc6049 (view diff)

Strategy: Affected packages only

✅ Only testing packages that have been modified or depend on modified packages.

Affected packages - 1 (3%)

vercel

Unaffected packages - 39 (98%)

@vercel-internals/get-package-json
@vercel/backends
@vercel/build-utils
@vercel/cervel
@vercel/cli-auth
@vercel/client
@vercel/config
@vercel/detect-agent
@vercel/edge
@vercel/elysia
@vercel/error-utils
@vercel/express
@vercel/fastify
@vercel/firewall
@vercel/frameworks
@vercel/fs-detectors
@vercel/functions
@vercel/gatsby-plugin-vercel-builder
@vercel/go
@vercel/h3
@vercel/hono
@vercel/hydrogen
@vercel/koa
@vercel/nestjs
@vercel/next
@vercel/node
@vercel/oidc
@vercel/oidc-aws-credentials-provider
@vercel/python
@vercel/python-analysis
@vercel/redwood
@vercel/related-projects
@vercel/remix-builder
@vercel/routing-utils
@vercel/ruby
@vercel/rust
@vercel/static-build
@vercel/static-config
examples

Results

Unit tests: Only affected packages will run unit tests
E2E tests: Running in parallel via E2E Tests workflow
Type checks: Only affected packages will run type checks

This comment is automatically generated based on the affected testing strategy

ergunsh

LGTM % we need to expose dimensions through schema as well so that agents can now which group by values are possible and a few nits!

ergunsh

LGTM % follow-ups:

Remove fetching metric detail for running query: https://linear.app/vercel/issue/O11Y-4128/remove-fetching-metric-detail-for-running-query
Metric detail table is too long and it sometimes wraps: https://linear.app/vercel/issue/O11Y-4129/metric-detail-table-is-too-long-and-it-sometimes-wraps

We can tackle the follow-ups later :ITG:

This PR was opened by the [Changesets release](https://github.com/changesets/action) GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated. # Releases ## vercel@50.43.0 ### Minor Changes - Add Deployment Checks support to `deploy --prod`. Shows "Running Checks..." spinner when checks are pending, detects check failures before alias promotion, and displays failed check run details with links to logs. ([#15884](#15884)) - Extend marketplace integration CLI parity: add `vercel integration installations` to list team installations (with optional `--integration` filter and JSON output), align `vercel integration update` argument parsing with other subcommands (parse only tokens after `update`, so the integration slug is the first positional), and ship related help/telemetry updates. ([#15849](#15849)) - Add `vercel project protection` actions for automation protection bypass via PATCH `/v1/projects/.../protection-bypass` (`--protection-bypass`). ([#15862](#15862)) - Add `vercel project protection` actions for customer support code visibility (`--customer-support-code-visibility`). ([#15860](#15860)) - Add `vercel project protection` actions for Git fork protection (`--git-fork-protection`). ([#15861](#15861)) - [services] migrate python workers to Queues V3 API ([#15885](#15885)) - [cli] Add `vercel flags override` subcommand to encrypt and decrypt flag override tokens for the `vercel-flag-overrides` cookie ([#15875](#15875)) ### Patch Changes - Persist CLI telemetry across invocations with bounded-time sessions, stable installation device IDs, and per-invocation identifiers. ([#15872](#15872)) - Update the `vercel metrics` CLI to use the V2 observability metrics API with `--metric`-based schema inspection and querying. ([#15876](#15876)) - Improve `vercel integration add` command to support fallback to the discover API and first-party integrations. ([#15788](#15788)) - refactor(cli): remove FF_AUTO_PROVISION_INSTALL feature flag and dead code from `integration add` ([#15871](#15871)) - Updated dependencies \[[`5e02289f927050a6c1025cc0edb7eda607fd5e73`](5e02289), [`2e15ee828f14de4a849a462429ca03feab161174`](2e15ee8), [`a31c84d1bda56a60da6d7bc6d611b0b18ba3bf57`](a31c84d)]: - @vercel/detect-agent@1.2.2 - @vercel/build-utils@13.14.1 - @vercel/backends@0.0.58 - @vercel/elysia@0.1.61 - @vercel/express@0.1.71 - @vercel/fastify@0.1.64 - @vercel/go@3.4.7 - @vercel/h3@0.1.70 - @vercel/hono@0.2.64 - @vercel/hydrogen@1.3.6 - @vercel/koa@0.1.44 - @vercel/nestjs@0.2.65 - @vercel/next@4.16.5 - @vercel/node@5.7.3 - @vercel/python@6.29.0 - @vercel/redwood@2.4.12 - @vercel/remix-builder@5.7.2 - @vercel/ruby@2.3.2 - @vercel/rust@1.1.0 - @vercel/static-build@2.9.11 ## @vercel/client@17.3.0 ### Minor Changes - Add Deployment Checks support to `deploy --prod`. Shows "Running Checks..." spinner when checks are pending, detects check failures before alias promotion, and displays failed check run details with links to logs. ([#15884](#15884)) ### Patch Changes - Updated dependencies \[[`2e15ee828f14de4a849a462429ca03feab161174`](2e15ee8), [`a31c84d1bda56a60da6d7bc6d611b0b18ba3bf57`](a31c84d)]: - @vercel/build-utils@13.14.1 ## @vercel/backends@0.0.58 ### Patch Changes - Updated dependencies \[[`2e15ee828f14de4a849a462429ca03feab161174`](2e15ee8), [`a31c84d1bda56a60da6d7bc6d611b0b18ba3bf57`](a31c84d)]: - @vercel/build-utils@13.14.1 ## @vercel/build-utils@13.14.1 ### Patch Changes - Restore `finalizeLambda()` to return `zipPath: null` for the default in-memory path, preserving the existing caller-facing result contract while keeping custom ZIP strategies supported. ([#15887](#15887)) - feat(node): filter non-entrypoint Node.js files in `/api` directory ([#15873](#15873)) ## @vercel/cervel@0.0.45 ### Patch Changes - Updated dependencies \[]: - @vercel/backends@0.0.58 ## @vercel/detect-agent@1.2.2 ### Patch Changes - Detect Cursor agent execution when `CURSOR_EXTENSION_HOST_ROLE=agent-exec` is set so tools launched from Cursor still report the `cursor-cli` agent when `CURSOR_AGENT` is not present. ([#15879](#15879)) ## @vercel/elysia@0.1.61 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.3 ## @vercel/express@0.1.71 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.3 - @vercel/cervel@0.0.45 ## @vercel/fastify@0.1.64 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.3 ## @vercel/fs-detectors@5.15.1 ### Patch Changes - feat(node): filter non-entrypoint Node.js files in `/api` directory ([#15873](#15873)) - Updated dependencies \[[`2e15ee828f14de4a849a462429ca03feab161174`](2e15ee8), [`a31c84d1bda56a60da6d7bc6d611b0b18ba3bf57`](a31c84d)]: - @vercel/build-utils@13.14.1 ## @vercel/gatsby-plugin-vercel-builder@2.1.11 ### Patch Changes - Updated dependencies \[[`2e15ee828f14de4a849a462429ca03feab161174`](2e15ee8), [`a31c84d1bda56a60da6d7bc6d611b0b18ba3bf57`](a31c84d)]: - @vercel/build-utils@13.14.1 ## @vercel/h3@0.1.70 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.3 ## @vercel/hono@0.2.64 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.3 ## @vercel/koa@0.1.44 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.3 ## @vercel/nestjs@0.2.65 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.3 ## @vercel/node@5.7.3 ### Patch Changes - Updated dependencies \[[`2e15ee828f14de4a849a462429ca03feab161174`](2e15ee8), [`a31c84d1bda56a60da6d7bc6d611b0b18ba3bf57`](a31c84d)]: - @vercel/build-utils@13.14.1 ## @vercel/static-build@2.9.11 ### Patch Changes - Updated dependencies \[]: - @vercel/gatsby-plugin-vercel-builder@2.1.11 ## @vercel/python-workers@0.0.14 ### Patch Changes - [services] migrate python workers to Queues V3 API ([#15885](#15885)) Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

ergunsh and others added 10 commits March 29, 2026 11:08

Add vercel prefix with snake casing

72d5d72

Make the measures & dimensions snake cased

b46b3cd

Add measure support in -e flag

9c84d38

Address review comments

54be1a3

use v2

8f9513b

restore examples

814a102

remove allowedValues

0c1d005

move validation to api

fdd69f0

add back coverage

eb6410b

add back allowed Values

648a31a

vercel Bot reviewed Apr 8, 2026

View reviewed changes

Comment thread packages/cli/src/commands/metrics/output.ts Outdated

Comment thread packages/cli/test/unit/commands/metrics/output.test.ts

fix lint

7a0d0b0

vercel Bot deployed to Preview April 9, 2026 09:31 View deployment

remove format

e7160d3

vercel Bot deployed to Preview April 9, 2026 09:48 View deployment

combine test

7b844b5

vercel Bot deployed to Preview April 9, 2026 10:52 View deployment

refactor

07c9834

vercel Bot deployed to Preview April 9, 2026 11:24 View deployment

Jooliashi changed the title ~~metrics vercel prefix~~ [Metrics] use v2 endpoints Apr 9, 2026

Jooliashi marked this pull request as ready for review April 9, 2026 11:35

Jooliashi requested review from a team as code owners April 9, 2026 11:35

Jooliashi requested review from ergunsh April 9, 2026 11:35

ergunsh reviewed Apr 9, 2026

View reviewed changes

add back the tests

4f8a975

vercel Bot deployed to Preview April 9, 2026 13:13 View deployment

add back the comments

00a00f0

vercel Bot deployed to Preview April 9, 2026 13:19 View deployment

add back tests

5e90058

vercel Bot deployed to Preview April 9, 2026 13:31 View deployment

add back tests

9c8a3c5

vercel Bot deployed to Preview April 9, 2026 13:44 View deployment

mock in beforeEach

e660506

vercel Bot deployed to Preview April 9, 2026 13:58 View deployment

Merge branch 'main' into ergunsh/metrics-vercel-prefix

705a19a

vercel Bot deployed to Preview April 9, 2026 14:15 View deployment

combine default aggregation

66437f2

vercel Bot deployed to Preview April 9, 2026 15:03 View deployment

ergunsh approved these changes Apr 9, 2026

View reviewed changes

adriancooney reviewed Apr 9, 2026

View reviewed changes

Comment thread packages/cli/src/commands/metrics/command.ts

adriancooney reviewed Apr 9, 2026

View reviewed changes

Comment thread packages/cli/src/commands/metrics/query.ts Outdated

clarify variable name

9cc6049

vercel Bot deployed to Preview April 9, 2026 15:38 View deployment

adriancooney approved these changes Apr 9, 2026

View reviewed changes

Jooliashi enabled auto-merge (squash) April 9, 2026 18:08

Jooliashi merged commit cea9f86 into main Apr 9, 2026
179 checks passed

Jooliashi deleted the ergunsh/metrics-vercel-prefix branch April 9, 2026 18:08

vercel-cli-release-bot mentioned this pull request Apr 9, 2026

Version Packages #15880

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[Metrics] use v2 endpoints#15876

[Metrics] use v2 endpoints#15876
Jooliashi merged 22 commits into
mainfrom
ergunsh/metrics-vercel-prefix

Jooliashi commented Apr 8, 2026 •

edited

Loading

Uh oh!

changeset-bot Bot commented Apr 8, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Apr 8, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Apr 8, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Apr 8, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

ergunsh left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ergunsh left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

Jooliashi commented Apr 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot Bot commented Apr 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

github-actions Bot commented Apr 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📦 CLI Tarball Ready

Quick Test

Use in vercel.json

Python Runtime Wheel

Python Workers Wheel

Uh oh!

vercel Bot commented Apr 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Apr 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🧪 Unit Test Strategy

Results

Uh oh!

Uh oh!

Uh oh!

ergunsh left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ergunsh left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Jooliashi commented Apr 8, 2026 •

edited

Loading

changeset-bot Bot commented Apr 8, 2026 •

edited

Loading

github-actions Bot commented Apr 8, 2026 •

edited

Loading

vercel Bot commented Apr 8, 2026 •

edited

Loading

github-actions Bot commented Apr 8, 2026 •

edited

Loading