Skip to content

fix(server-utils): Record Vercel AI experimental_telemetry.metadata on gen_ai spans - #24721

Open
isaacs wants to merge 1 commit into
developfrom
isaacschlueter/js-3800-vercelaiintegration-experimental_telemetrymetadata-no-longer
Open

isaacs wants to merge 1 commit into
developfrom
isaacschlueter/js-3800-vercelaiintegration-experimental_telemetrymetadata-no-longer

Conversation

@isaacs

@isaacs isaacs commented Sep 24, 2026

Copy link
Copy Markdown
Member

v10 got vercel.ai.telemetry.metadata.<key> attributes from the AI SDK's own OTel spans. In v11, ai 4 to 6 go through the orchestrion subscriber, which never read metadata, so v11 dropped it.

The orchestrion subscriber now passes the metadata to the channel subscriber, which sets it as span attributes when each span starts. The invoke_agent, generate_content and embeddings spans get the attributes, and execute_tool spans don't. This matches the AI SDK, which leaves metadata off its ai.toolCall spans.

fixes JS-3800
fixes #24720
Re: #24706

@isaacs
isaacs requested review from a team as code owners September 24, 2026 22:11
@isaacs
isaacs requested review from JPeer264 and mydea and removed request for a team September 24, 2026 22:11
@linear-code

linear-code Bot commented Sep 24, 2026

Copy link
Copy Markdown

JS-3800

@github-actions

github-actions Bot commented Sep 24, 2026 •

Copy link
Copy Markdown
Contributor

size-limit report 📦

⚠️ Warning: Base artifact is not the latest one, because the latest workflow run is not done yet. This may lead to incorrect results. Try to re-run all tests to get up to date results.

Path Size % Change Change
@sentry/browser 29.51 kB - -
@sentry/browser - with treeshaking flags 27.68 kB - -
@sentry/browser - with treeshaking flags tracing without tracing 27.58 kB - -
@sentry/browser (incl. Tracing) 51.46 kB - -
@sentry/browser (incl. Tracing + Span Streaming) 51.47 kB - -
@sentry/browser (incl. Tracing, Profiling) 54.47 kB - -
@sentry/browser (incl. Tracing, Replay) 91.05 kB - -
@sentry/browser (incl. Tracing, Replay) - with treeshaking flags 80.03 kB - -
@sentry/browser (incl. Tracing, Replay with Canvas) 95.73 kB - -
@sentry/browser (incl. Tracing, Replay, Feedback) 108.72 kB - -
@sentry/browser (incl. Feedback) 47.04 kB - -
@sentry/browser (incl. sendFeedback) 34.57 kB - -
@sentry/browser (incl. FeedbackAsync) 39.69 kB - -
@sentry/browser (incl. Metrics) 30.53 kB - -
@sentry/browser (incl. Logs) 30.82 kB - -
@sentry/browser (incl. Metrics & Logs) 31.48 kB - -
@sentry/react 31.36 kB - -
@sentry/react (incl. Tracing) 53.82 kB - -
@sentry/vue 37.51 kB - -
@sentry/vue (incl. Tracing) 54.36 kB - -
@sentry/svelte 29.54 kB - -
@sentry/remix (Remix 3 client bundle) 55.75 kB - -
CDN Bundle 31.22 kB - -
CDN Bundle (incl. Tracing) 51.99 kB - -
CDN Bundle (incl. Logs, Metrics) 33.46 kB - -
CDN Bundle (incl. Tracing, Logs, Metrics) 53.94 kB - -
CDN Bundle (incl. Replay, Logs, Metrics) 74.2 kB - -
CDN Bundle (incl. Tracing, Replay) 89.56 kB - -
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) 91.54 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback) 95.73 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) 97.73 kB - -
CDN Bundle - uncompressed 92.14 kB - -
CDN Bundle (incl. Tracing) - uncompressed 154.53 kB - -
CDN Bundle (incl. Logs, Metrics) - uncompressed 98.71 kB - -
CDN Bundle (incl. Tracing, Logs, Metrics) - uncompressed 160.48 kB - -
CDN Bundle (incl. Replay, Logs, Metrics) - uncompressed 228.28 kB - -
CDN Bundle (incl. Tracing, Replay) - uncompressed 274.26 kB - -
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) - uncompressed 280.2 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback) - uncompressed 287.96 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) - uncompressed 293.89 kB - -
@sentry/nextjs (client) 56.33 kB - -
@sentry/sveltekit (client) 51.88 kB - -
@sentry/core/server 39.99 kB - -
@sentry/core/browser 13.63 kB - -
@sentry/node 144.55 kB +0.05% +72 B 🔺
@sentry/node/import (ESM hook with diagnostics-channel injection) 83.08 kB - -
@sentry/node - without tracing 93.03 kB +0.02% +10 B 🔺
@sentry/node - without channel injection 122.83 kB +0.07% +77 B 🔺
@sentry/aws-serverless 101.33 kB +0.01% +7 B 🔺
@sentry/cloudflare (withSentry) - minified 207.1 kB - -
@sentry/cloudflare (withSentry) 515.31 kB - -

View base workflow run

@JPeer264 JPeer264 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Implementation LGTM. However I'm not sure if we should send vercel.ai specific attributes. I added @andreiborza and @RulaKhaled who know more about status quo on these fields and if we should (re-)add them

@RulaKhaled RulaKhaled left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also lgtm. I’d bring this up in the agent tracing channel before merging, vercel.ai.telemetry.metadata.* attributes aren’t in @sentry/conventions, they probably can’t be convention constants but maybe we could register a prefix

const baseAttributes: Record<string, string | number | boolean> = {
const baseAttributes: SpanAttributes = {
[SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]: ORIGIN,
...telemetryMetadataAttributes(event.telemetryMetadata),

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wonder if this should be gated on recordInputs or dataCollection.genAI

@isaacs
isaacs force-pushed the isaacschlueter/js-3800-vercelaiintegration-experimental_telemetrymetadata-no-longer branch from e652f6b to aea4552 Compare September 25, 2026 17:53
@isaacs

isaacs commented Sep 25, 2026

Copy link
Copy Markdown
Member Author

I’d bring this up in the agent tracing channel before merging

Good call! Pinged them for input.

@github-actions

Copy link
Copy Markdown
Contributor

👋 @mydea — Please review this PR when you get a chance!

@github-actions

Copy link
Copy Markdown
Contributor

👋 @andreiborza — Please review this PR when you get a chance!

@RulaKhaled RulaKhaled left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could you add the prefix to our conventions please?

… on gen_ai spans

v10 got `vercel.ai.telemetry.metadata.<key>` attributes from the AI
SDK's own OTel spans. In v11, `ai` 4 to 6 go through the orchestrion
subscriber, which never read `metadata`, so v11 dropped it.

The orchestrion subscriber now passes the metadata to the channel
subscriber, which sets it as span attributes when each span starts.
The `invoke_agent`, `generate_content` and `embeddings` spans get the
attributes, and `execute_tool` spans don't. This matches the AI SDK,
which leaves metadata off its `ai.toolCall` spans.

fixes JS-3800
fixes #24720
Re: #24706

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@isaacs

isaacs commented Oct 2, 2026

Copy link
Copy Markdown
Member Author

@RulaKhaled

Could you add the prefix to our conventions please?

PR open: getsentry/sentry-conventions#662

@isaacs
isaacs force-pushed the isaacschlueter/js-3800-vercelaiintegration-experimental_telemetrymetadata-no-longer branch from e5e058e to 94d0f9e Compare October 2, 2026 03:55

This branch has not been deployed

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

vercelAIIntegration: experimental_telemetry.metadata no longer recorded on gen_ai spans (v11 regression, ai <= 6)

3 participants