[sentry-junior]

DESCRIBE YOUR PR

Companion to getsentry/sentry-javascript#25869, which moves Flue's gen_ai.chat spans to a new pi-ai integration. That integration needs Sentry's module hook or bundler plugin, so a Flue app that only calls instrument(Sentry.createFlueInstrumentation()) keeps agent and tool spans but has no model calls.

The Flue guides now treat the full setup as required instead of optional:

• Node: starting the server with --import=@sentry/node/import is part of the setup, not an extra step for database and cache spans. A warning explains what goes missing without it, and the troubleshooting section covers the SDK's new "model calls are not being traced" warning.
• Cloudflare: says the Vite plugin is required because it also instruments pi-ai, and adds the same troubleshooting entry.
• What gets captured: chat spans now have the auto.ai.pi_ai origin, and flue.turn.purpose is removed.

Draft until #25869 is released. The captured-data changes only become accurate with that release. If the pi-ai integration ships after 11.0.0, the minimum SDK version in the prerequisites and supported versions should go up to match.

IS YOUR CHANGE URGENT?

• Urgent deadline (GA date, etc.): YYYY-MM-DD
• Other deadline: Ship with the SDK release that includes feat(server-utils): Add pi-ai integration sentry-javascript#25869
• No deadline: Not urgent, can wait up to 1 week+

PRE-MERGE CHECKLIST

• Checked Vercel preview for correctness, including links
• PR was reviewed and approved by any necessary SMEs (subject matter experts)
• PR was reviewed and approved by a member of the Sentry docs team

via Francesco Gringl-Novy.

--

View Junior Session [Sentry]

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
sentry-docs	Ready	Preview	Oct 29, 2026 12:47pm UTC

1 Skipped Deployment

Project	Deployment	Actions	Updated
develop-docs	Ignored		Oct 29, 2026 12:47pm UTC