Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
49 commits
Select commit Hold shift + click to select a range
32477c5
docs(javascript): Align tracing attributes and behavior with v11 (#19…
msonnb Sep 22, 2026
428e2be
docs(ember): Document explicit addon setup and tracing (#19472)
msonnb Sep 22, 2026
cf9487f
docs(javascript): Document span streaming as the default (#19429)
msonnb Sep 22, 2026
355f9fa
docs(javascript): Prepare browser JavaScript docs for v11 (#19369)
msonnb Sep 22, 2026
f8405b0
docs(javascript): Document OpenTelemetry interoperability in v11 (#19…
msonnb Sep 22, 2026
79bbd29
docs(js): Restructure the Node install methods for v11 (#19368)
JPeer264 Sep 22, 2026
0efd2ce
docs(sveltekit): Import sentrySvelteKit from the vite subpath (#19394)
JPeer264 Sep 22, 2026
a9434b6
docs(js): Switch stream mode to be the default in v11 (#19464)
JPeer264 Sep 22, 2026
386d289
docs(agent-tracing): Document AI integrations as auto-instrumented fo…
mydea Sep 22, 2026
e436f56
docs(remix): Update form data collection for v11 (#19434)
chargome Sep 22, 2026
73beac7
docs(react-router): Update framework guides for v11 (#19366)
chargome Sep 22, 2026
83767bd
docs(js): Update metrics docs for v11 (#19396)
chargome Sep 22, 2026
2a0bc89
docs(fastify): Fix imports in error handler snippet (#19426)
chargome Sep 22, 2026
0bd21d5
docs(remix): Fix manual setup and document Cloudflare Workers for v11…
chargome Sep 22, 2026
d439097
docs(js): Replace legacy profiling options with session-based API (#1…
chargome Sep 22, 2026
859d90b
docs(astro): update minimum Astro version to 4 (#19315)
nicohrubec Sep 22, 2026
e272f47
docs(javascript): Note that tags and extra don't apply to streamed sp…
chargome Sep 22, 2026
718008c
docs(js): Remove deprecated framework error handler setup calls (#19428)
chargome Sep 22, 2026
9900850
docs(node): update minimum Node.js version to 20.19.0 (#19317)
nicohrubec Sep 22, 2026
0d11a14
docs(js): Rename InboundFilters integration to EventFilters (#19431)
chargome Sep 22, 2026
bd02b21
docs(javascript): Apply httpIntegration option renames (#19548)
chargome Sep 22, 2026
f531196
docs(nextjs): Document Vercel AI as unsupported on the Edge runtime (…
chargome Sep 22, 2026
16277e1
docs(js): Remove breadcrumbs console and instrumentation warnings (#1…
chargome Sep 22, 2026
30b76e3
docs(bun): Document the build plugin in the instrumentation step (#19…
JPeer264 Sep 22, 2026
0473b96
docs(js): Document `bfcacheMetricsIntegration` for v11 (#18936)
logaretm Sep 22, 2026
af55930
docs(javascript): Document Mistral AI integration (#19532)
nicohrubec Sep 22, 2026
3fe56a8
docs(deno): update minimum Deno version to 2.8.3 (#19311)
nicohrubec Sep 22, 2026
5c3e765
docs(nextjs): Update getting started and manual setup for v11 (#19336)
chargome Sep 22, 2026
9b89161
docs(agent-tracing): remove the streamGenAiSpans option (#19337)
nicohrubec Sep 22, 2026
2b6eb78
docs(fastify): update minimum Fastify version to 3.21 (#19312)
nicohrubec Sep 22, 2026
625186d
docs(js): update attachStacktrace default to true (#19316)
nicohrubec Sep 22, 2026
67eb835
docs(browser): drop Safari 14 from supported browsers (#19313)
nicohrubec Sep 22, 2026
0a3d3be
docs(agent-tracing): update gen_ai attribute names and rename instrum…
nicohrubec Sep 22, 2026
5ab7a03
docs(solidstart): Document the SolidStart 2 setup (#19376)
JPeer264 Sep 22, 2026
742ea0d
docs(js): Update Deno guide for v11 (#19365)
JPeer264 Sep 22, 2026
e1bfa63
docs(js): Remove the lightweight mode page (#19516)
JPeer264 Sep 22, 2026
1e4eeb7
docs(aws-lambda): Add a versioned Lambda Layer page for v10 (#19468)
JPeer264 Sep 22, 2026
a2d9df5
docs(js): Remove the Connect guide and redirect it to Node (#19371)
JPeer264 Sep 23, 2026
10a06e7
docs(javascript): Correct Anthropic instrumented operations (#19568)
nicohrubec Sep 23, 2026
8894623
docs(js): Remove sendDefaultPii from the v11 docs (#19574)
andreiborza Sep 23, 2026
6ddcd6a
docs(javascript): Document Google Gen AI v2 and embeddings support (#…
nicohrubec Sep 23, 2026
daa0d36
docs(cloudflare): Rework the guide for v11 (#19331)
JPeer264 Sep 23, 2026
4ccf1b3
feat(docs): Add agent prompt for JavaScript v11 migration (#19575)
msonnb Sep 23, 2026
a54bf73
docs(nuxt): Update docs for v11 (#19466)
s1gr1d Sep 23, 2026
a3bc96c
feat(node): Update node docs for v11 (#19577)
mydea Sep 23, 2026
84f05e5
Merge remote-tracking branch 'origin/master' into js-v11-docs
andreiborza Sep 23, 2026
a32b264
docs(js): Update dataCollection snippets for v10 and genAI (#19579)
s1gr1d Sep 23, 2026
e4920f7
docs(javascript): Sync v11 migration guides with SDK changes (#19582)
msonnb Sep 23, 2026
4772a16
docs(cloudflare): Replace D1 page with a bindings overview (#19581)
JPeer264 Sep 23, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 1 addition & 1 deletion docs/concepts/key-terms/agent-tracing/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -152,7 +152,7 @@ Click into a specific model for a detailed dashboard view, or scroll through the

Depending on the data your agents handle, some of it may be sensitive and shouldn't be recorded in a span. Prompts and agent output aren't recorded by default in Sentry. This is an opt-in feature you can enable by setting `recordInputs`, `recordOutputs`, or both, to true in your Sentry SDK integration options.

[Here is an example from our JavaScript SDK using the Vercel AI SDK →](/platforms/javascript/guides/cloudflare/agent-tracing/vercelai/#record-inputs-and-outputs)
[Here is an example from our JavaScript SDK using the Vercel AI SDK →](/platforms/javascript/guides/cloudflare/configuration/integrations/vercelai/#options)

You can explore <PlatformLink to="/agent-tracing/">agent tracing for your SDK here</PlatformLink>.

Expand Down
2 changes: 1 addition & 1 deletion docs/concepts/otlp/sentry-with-otel.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -87,7 +87,7 @@ If you're running both a Sentry SDK and OTel instrumentation in the same backend
- <LinkWithPlatformIcon
platform="javascript.node"
label="Node.js"
url="/platforms/javascript/guides/node/install/lightweight/#using-with-opentelemetry-otlp"
url="/platforms/javascript/guides/node/configuration/integrations/opentelemetry/"
/>
- <LinkWithPlatformIcon
platform="java"
Expand Down
4 changes: 1 addition & 3 deletions docs/platforms/javascript/common/agent-tracing/flue.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -109,7 +109,6 @@ Sentry.init({
enabled: Boolean(process.env.SENTRY_DSN),
tracesSampleRate,
traceLifecycle: "stream",
streamGenAiSpans: true,
enableLogs: true,
// Flue already emits one `chat` span per model call, so Sentry's
// AI provider integrations are removed to avoid double counting.
Expand Down Expand Up @@ -166,7 +165,6 @@ export const cloudflare = extend({
release: env.SENTRY_RELEASE,
tracesSampleRate: clampRate(env.SENTRY_TRACES_SAMPLE_RATE, 0),
traceLifecycle: "stream",
streamGenAiSpans: true,
enableLogs: true,
integrations: (defaults) =>
defaults.filter((i) => !SENTRY_AI_PROVIDER_INTEGRATIONS.has(i.name)),
Expand Down Expand Up @@ -214,7 +212,7 @@ Also confirm that a wrapped agent delivers spans, logs, and issues from `workerd
## Troubleshooting

- **Logs and issues arrive but no traces.** `SENTRY_TRACES_SAMPLE_RATE` defaults to `0`. Set it above `0`.
- **Token and cost values are doubled.** Don't add a second AI tracing integration such as the <PlatformLink to="/agent-tracing/vercelai/">Vercel AI integration</PlatformLink> or <PlatformLink to="/agent-tracing/anthropic/">Anthropic integration</PlatformLink>. The blueprint removes them on purpose because Flue already emits the model spans.
- **Token and cost values are doubled.** Don't add a second AI tracing integration such as the <PlatformLink to="/configuration/integrations/vercelai/">Vercel AI integration</PlatformLink> or <PlatformLink to="/configuration/integrations/anthropic/">Anthropic integration</PlatformLink>. The blueprint removes them on purpose because Flue already emits the model spans.
- **A tool error did not create an issue.** Only terminal operation and submission failures create issues. A recovered tool error stays on the trace as diagnostic context.

## Supported Versions
Expand Down
113 changes: 28 additions & 85 deletions docs/platforms/javascript/common/agent-tracing/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,52 +13,9 @@ With <Link to="/product/agents/dashboards/">Sentry Agent Tracing</Link>, you can

<AgentSetupCallout skill="sentry-setup-ai-monitoring" />

## Getting Started
## Supported Instrumentation

Enable <PlatformLink to="/tracing/">tracing</PlatformLink> and pass `dataCollection` so generative AI content follows the SDK defaults (including prompts and responses when left unconfigured).

`dataCollection: {}` also opts into other **permissive** defaults (bodies, cookies, user info, and more). Tighten via <PlatformLink to="/configuration/options/#dataCollection">`dataCollection`</PlatformLink>.

<PlatformSection notSupported={["javascript.cloudflare"]}>

```javascript
import * as Sentry from "___SDK_PACKAGE___";

Sentry.init({
dsn: "___PUBLIC_DSN___",
tracesSampleRate: 1.0,
dataCollection: {},
});
```

</PlatformSection>

<PlatformSection supported={["javascript.cloudflare"]}>

```javascript
import * as Sentry from "@sentry/cloudflare";

export default Sentry.withSentry(
(env) => ({
dsn: "___PUBLIC_DSN___",
tracesSampleRate: 1.0,
dataCollection: {},
}),
{
async fetch(request, env, ctx) {
// your worker
},
}
);
```

Durable Objects / <PlatformLink to="/agent-tracing/agents-sdk/">Agents SDK</PlatformLink>: use <PlatformLink to="/features/durableobject/">`instrumentDurableObjectWithSentry`</PlatformLink> with the same options.

</PlatformSection>

## Instrumentation

Pick your AI stack. Some libraries auto-instrument; others need a short setup — each page has the details.
As of SDK version `11.0.0`, Sentry auto-instruments the most popular AI SDKs and frameworks out of the box — no manual setup is required. Just enable <PlatformLink to="/tracing/">tracing</PlatformLink>, then pick your AI stack below. Each integration page has the details.

<IntegrationGrid
integrations={[
Expand All @@ -67,15 +24,17 @@ Pick your AI stack. Some libraries auto-instrument; others need a short setup
href: "/platforms/javascript/guides/cloudflare/agent-tracing/workers-ai/",
title: "Workers AI",
icon: "cloudflare",
supported: ["javascript.cloudflare"],
},
{
to: "/agent-tracing/agents-sdk/",
href: "/platforms/javascript/guides/cloudflare/agent-tracing/agents-sdk/",
title: "Agents SDK",
icon: "cloudflare",
supported: ["javascript.cloudflare"],
},
{
to: "/agent-tracing/vercelai/",
to: "/configuration/integrations/vercelai/",
title: "Vercel AI SDK",
icon: "vercel",
notSupported: [
Expand All @@ -86,39 +45,54 @@ Pick your AI stack. Some libraries auto-instrument; others need a short setup
],
},
{
to: "/agent-tracing/openai/",
to: "/configuration/integrations/openai/",
title: "OpenAI",
icon: "openai",
},
{
to: "/agent-tracing/anthropic/",
to: "/configuration/integrations/anthropic/",
title: "Anthropic",
icon: "anthropic",
},
{
to: "/agent-tracing/google-genai/",
to: "/configuration/integrations/google-genai/",
title: "Google Gen AI SDK",
icon: "google-genai",
},
{
to: "/agent-tracing/langchain/",
to: "/configuration/integrations/langchain/",
title: "LangChain",
icon: "langchain",
},
{
to: "/agent-tracing/langgraph/",
to: "/configuration/integrations/langgraph/",
title: "LangGraph",
icon: "langgraph",
},
{
to: "/configuration/integrations/mistral/",
title: "Mistral AI",
icon: "mistral",
},
{
to: "/configuration/integrations/groq/",
title: "Groq",
icon: "groq",
},
{
to: "/configuration/integrations/together-ai/",
title: "Together AI",
icon: "together-ai",
},
{
to: "/agent-tracing/mastra/",
href: "/platforms/javascript/guides/mastra/",
title: "Mastra",
icon: "mastra",
supported: [
"javascript.astro",
"javascript.aws-lambda",
"javascript.azure-functions",
"javascript.connect",
"javascript.express",
"javascript.fastify",
"javascript.gcp-functions",
Expand All @@ -137,6 +111,7 @@ Pick your AI stack. Some libraries auto-instrument; others need a short setup
},
{
to: "/agent-tracing/eve/",
href: "/platforms/javascript/guides/eve/",
title: "Eve",
icon: "eve",
supported: ["javascript.node"],
Expand Down Expand Up @@ -230,46 +205,14 @@ export default Sentry.withSentry(
);
```

On the default CF entrypoint, control Vercel AI I/O with `experimental_telemetry` per call (or integration-level `record*` via `nodejs_compat`). See each integration page.
On Cloudflare, control Vercel AI I/O with integration-level `record*` options or with `experimental_telemetry` per call. See each integration page.

</PlatformSection>

### Streaming Gen AI Spans

From SDK `10.61.0`, `gen_ai` spans are sent as standalone envelope items (avoids large-payload drops; required for <Link to="/product/agents/conversations/">Conversations</Link>).

Self-hosted Sentry users should set `streamGenAiSpans: false` if standalone `gen_ai` spans may not be ingested.

<PlatformSection notSupported={["javascript.cloudflare"]}>

```javascript
Sentry.init({
dsn: "___PUBLIC_DSN___",
streamGenAiSpans: false,
});
```

</PlatformSection>

<PlatformSection supported={["javascript.cloudflare"]}>

```javascript
export default Sentry.withSentry(
(env) => ({
dsn: "___PUBLIC_DSN___",
tracesSampleRate: 1.0,
streamGenAiSpans: false,
}),
{
async fetch(request, env, ctx) {
/* ... */
},
}
);
```

</PlatformSection>

## Manual Instrumentation

<PlatformSection
Expand Down
63 changes: 0 additions & 63 deletions docs/platforms/javascript/common/agent-tracing/langgraph.mdx

This file was deleted.

94 changes: 0 additions & 94 deletions docs/platforms/javascript/common/agent-tracing/openai.mdx

This file was deleted.

Loading
Loading