From a51c1b064531d9121b98b1f99ccca851e77c63c7 Mon Sep 17 00:00:00 2001 From: Charly Gomez Date: Mon, 21 Sep 2026 11:10:44 +0200 Subject: [PATCH 1/2] docs(js): Remove breadcrumbs console and instrumentation warnings The `console` option of `breadcrumbsIntegration` was removed from `@sentry/browser` and `@sentry/deno` in v11, and `consoleIntegration` is a default integration in both now. Point readers at that integration and show how to turn console breadcrumbs off by filtering it out. The `disableInstrumentationWarnings` option was also removed, since channel-based instrumentation can no longer detect a framework imported before `Sentry.init()`. Drop it from the options reference. Also add the missing `consoleIntegration` rows to the browser, Deno, Vue, Gatsby, and Wasm integration tables, replace the two examples that configured the old option, and add a Deno migration item alongside the browser one. Fixes SDK-1488 Co-Authored-By: Claude Opus 5 --- .../integrations/breadcrumbs.mdx | 13 ++------- .../configuration/integrations/console.mdx | 11 ++++++- .../configuration/integrations/index.mdx | 29 +++++++++++++++++-- .../common/configuration/options.mdx | 14 --------- .../data-management/data-collected/index.mdx | 2 +- .../common/migration/v10-to-v11/index.mdx | 3 +- .../integrations/breadcrumbs.mdx | 11 ++----- .../javascript-v11/console-breadcrumbs.mdx | 13 ++++++++- .../deno-console-breadcrumbs.mdx | 23 +++++++++++++++ .../integrations/javascript.deno.mdx | 1 + .../integrations/javascript.gatsby.mdx | 1 + .../configuration/integrations/javascript.mdx | 1 + .../integrations/javascript.vue.mdx | 1 + .../integrations/javascript.wasm.mdx | 1 + 14 files changed, 86 insertions(+), 38 deletions(-) create mode 100644 includes/migration/javascript-v11/deno-console-breadcrumbs.mdx diff --git a/docs/platforms/javascript/common/configuration/integrations/breadcrumbs.mdx b/docs/platforms/javascript/common/configuration/integrations/breadcrumbs.mdx index 208836528ac366..ae9de07c2ab3f1 100644 --- a/docs/platforms/javascript/common/configuration/integrations/breadcrumbs.mdx +++ b/docs/platforms/javascript/common/configuration/integrations/breadcrumbs.mdx @@ -20,8 +20,6 @@ notSupported: - javascript.bun --- - - This integration only works inside a browser environment. @@ -34,13 +32,14 @@ This integration is enabled by default. If you'd like to modify your default int The `breadcrumbsIntegration` wraps native APIs to capture breadcrumbs. -By default, the Sentry SDK wraps the `console`, `dom`, `fetch`, `history`, and `xhr` browser APIs to add breadcrumbs. You can opt out of capturing breadcrumbs for specific parts of your application (for example, you could say don't capture `console.log` calls as breadcrumbs) via the options below. +By default, the Sentry SDK wraps the `dom`, `fetch`, `history`, and `xhr` browser APIs to add breadcrumbs. You can opt out of capturing breadcrumbs for specific parts of your application (for example, you could say don't capture click and keypress events as breadcrumbs) via the options below. + +Console calls are captured by the `consoleIntegration`, which is enabled by default. ```JavaScript Sentry.init({ integrations: [ Sentry.breadcrumbsIntegration({ - console: true, dom: true, fetch: true, history: true, @@ -52,12 +51,6 @@ Sentry.init({ ## Options -### `console` - -_Type: `boolean`_ - -Log calls to `console.log`, `console.debug`, and so on. - ### `dom` _Type: `boolean` | `{ serializeAttribute: string | string[] }`_ diff --git a/docs/platforms/javascript/common/configuration/integrations/console.mdx b/docs/platforms/javascript/common/configuration/integrations/console.mdx index d187b87951d8b1..c2c480f3b605b5 100644 --- a/docs/platforms/javascript/common/configuration/integrations/console.mdx +++ b/docs/platforms/javascript/common/configuration/integrations/console.mdx @@ -1,8 +1,17 @@ --- title: Console description: "Capture console logs as breadcrumbs. (default)" -customCanonicalTag: "/platforms/javascript/guides/express/configuration/integrations/console/" +customCanonicalTag: "/platforms/javascript/configuration/integrations/console/" supported: + - javascript + - javascript.angular + - javascript.ember + - javascript.gatsby + - javascript.react + - javascript.solid + - javascript.svelte + - javascript.vue + - javascript.wasm - javascript.node - javascript.aws-lambda - javascript.azure-functions diff --git a/docs/platforms/javascript/common/configuration/integrations/index.mdx b/docs/platforms/javascript/common/configuration/integrations/index.mdx index cfedf1d887d79a..190de9e44db67e 100644 --- a/docs/platforms/javascript/common/configuration/integrations/index.mdx +++ b/docs/platforms/javascript/common/configuration/integrations/index.mdx @@ -18,19 +18,44 @@ Integrations automatically add error instrumentation, performance instrumentatio To disable system integrations, set `defaultIntegrations: false` when calling `init()`. -To override their settings, provide a new instance with your config to the `integrations` option. For example, to turn off browser capturing console calls: +To override their settings, provide a new instance with your config to the `integrations` option. + + + +For example, to stop capturing click and keypress events as breadcrumbs: ```javascript {3-7} Sentry.init({ dsn: "___PUBLIC_DSN___", integrations: [ Sentry.breadcrumbsIntegration({ - console: false, + dom: false, }), ], }); ``` + + + + + +For example, to stop recording breadcrumbs for outgoing HTTP requests: + +```javascript {3-7} +Sentry.init({ + dsn: "___PUBLIC_DSN___", + integrations: [ + Sentry.httpIntegration({ + breadcrumbs: false, + }), + ], +}); +``` + + + + ## Adding an Integration You can add additional integrations in your `init` call: diff --git a/docs/platforms/javascript/common/configuration/options.mdx b/docs/platforms/javascript/common/configuration/options.mdx index 00747954306fdf..4a8766a7bb1012 100644 --- a/docs/platforms/javascript/common/configuration/options.mdx +++ b/docs/platforms/javascript/common/configuration/options.mdx @@ -380,20 +380,6 @@ Controls how many seconds to wait before shutting down. Sentry SDKs send events - - -Depending on your setup, the Sentry SDK will try to detect if it has been incorrectly set up. This can result in warnings like this being logged: - -> [Sentry] < libraryName > is not instrumented. This is likely because you required/imported < libraryName > before calling `Sentry.init()`. - -Or - -> [Sentry] < libraryName > is not instrumented. Please make sure to initialize Sentry in a separate file that you \`--import\` when running node, see: < docs link >. - -This means the SDK detected that the library hasn't been wrapped for automatic performance instrumentation. This may result in some spans not being reported correctly. If this is not affecting you (for example because the warning is a false positive or you do not care about these specific spans), you can disable this warning by setting this option to `true`. - - - **Note:** Electron `main` process only. diff --git a/docs/platforms/javascript/common/data-management/data-collected/index.mdx b/docs/platforms/javascript/common/data-management/data-collected/index.mdx index 4197f17a1a69c7..028b7881ad6dcb 100644 --- a/docs/platforms/javascript/common/data-management/data-collected/index.mdx +++ b/docs/platforms/javascript/common/data-management/data-collected/index.mdx @@ -166,7 +166,7 @@ By default, the Sentry SDK sends information about the device and runtime to Sen By default, the Sentry SDK sends JS console logs to Sentry as breadcrumbs which may contain PII data. - To disable sending console messages, set `console: false` in your `Sentry.breadcrumbsIntegration` config, see the Breadcrumbs documentation. + To disable sending console messages, remove the `Console` integration from your `integrations` config, see the Console documentation. ## Referrer URL diff --git a/docs/platforms/javascript/common/migration/v10-to-v11/index.mdx b/docs/platforms/javascript/common/migration/v10-to-v11/index.mdx index 83aa7dbabd85a7..ade2de5ea7c8fd 100644 --- a/docs/platforms/javascript/common/migration/v10-to-v11/index.mdx +++ b/docs/platforms/javascript/common/migration/v10-to-v11/index.mdx @@ -942,6 +942,7 @@ Web vitals also changed: - `denoHttpIntegration` and `denoServeIntegration` honor `ignoreStatusCodes`, using the same default list as `httpIntegration`: incoming requests whose response status falls in `[[401, 404], [301, 303], [305, 399]]` are dropped. Each integration owns the option for the requests it instruments. Pass an empty array to keep everything. The filter only applies in transaction mode, which is why the option is deprecated and will be removed in v12. - The incoming span hooks `onIncomingSpanCreated` and `onIncomingSpanEnd` were renamed to `onSpanCreated` and `onSpanEnd`. `denoHttpIntegration` also accepts `outgoingRequestHook`, `outgoingResponseHook`, and `outgoingRequestApplyCustomAttributes` now. - The default integrations were renamed to match the other SDKs: `DenoAmqplib`, `DenoKoa`, `DenoMongodb`, `DenoMongoose`, `DenoMysql`, and `DenoPostgres` became `Amqplib`, `Koa`, `Mongodb`, `Mongoose`, `Mysql`, and `Postgres`. The old `deno*Integration` exports are kept as deprecated aliases. +- The `console` option of `breadcrumbsIntegration` was removed. Console breadcrumbs come from the default `consoleIntegration` now. To disable them, filter out the `Console` integration, and if you set `defaultIntegrations: false`, add `consoleIntegration()` to keep them. @@ -1352,7 +1353,7 @@ import type { BrowserClientReplayOptions } from "@sentry/core/browser"; ### Browser -- The `console` option of `breadcrumbsIntegration` was removed. Use `consoleIntegration` to capture console breadcrumbs. +- The `console` option of `breadcrumbsIntegration` was removed. Console breadcrumbs come from the default `consoleIntegration` now. To disable them, filter out the `Console` integration, and if you set `defaultIntegrations: false`, add `consoleIntegration()` to keep them. - AI integrations are no longer available in the browser SDK. They remain available in the server-side SDKs. diff --git a/docs/platforms/javascript/guides/deno/configuration/integrations/breadcrumbs.mdx b/docs/platforms/javascript/guides/deno/configuration/integrations/breadcrumbs.mdx index 4ea7e58cefb93c..7ca434721ea97e 100644 --- a/docs/platforms/javascript/guides/deno/configuration/integrations/breadcrumbs.mdx +++ b/docs/platforms/javascript/guides/deno/configuration/integrations/breadcrumbs.mdx @@ -10,15 +10,11 @@ _Import name: `Sentry.breadcrumbsIntegration`_ This integration is enabled by default. You can also [modify default integrations](./../#modifying-default-integrations). The `breadcrumbsIntegration` wraps native APIs to capture breadcrumbs. -By default, the Sentry SDK wraps all APIs. You can opt out of capturing breadcrumbs for specific parts of your application (for example, you could say don't capture `console.log` calls as breadcrumbs) via the options below. +By default, the Sentry SDK wraps all APIs. You can opt out of capturing breadcrumbs for specific parts of your application (for example, you could say don't capture outgoing fetch requests as breadcrumbs) via the options below. -## Options - -### `console` - -_Type: `boolean`_ +Console calls are captured by the [`consoleIntegration`](./console), which is enabled by default. -Log calls to `console.log`, `console.debug`, and so on. +## Options ### `fetch` @@ -31,4 +27,3 @@ Log HTTP requests done with the Fetch API. _Type: `boolean`_ Log whenever we send an event to the server. - diff --git a/includes/migration/javascript-v11/console-breadcrumbs.mdx b/includes/migration/javascript-v11/console-breadcrumbs.mdx index 00d8eb6ca3414a..3e3001f39c65c1 100644 --- a/includes/migration/javascript-v11/console-breadcrumbs.mdx +++ b/includes/migration/javascript-v11/console-breadcrumbs.mdx @@ -9,4 +9,15 @@ platformCategory: browser order: 205 --- -The `console` option of `breadcrumbsIntegration` was removed. Use `consoleIntegration` to capture console breadcrumbs. +The `console` option of `breadcrumbsIntegration` was removed. Console breadcrumbs come from the default `consoleIntegration` now, which matches the server SDKs. + +To disable console breadcrumbs, filter out the `Console` integration: + +```js +Sentry.init({ + integrations: (integrations) => + integrations.filter((integration) => integration.name !== "Console"), +}); +``` + +If you set `defaultIntegrations: false`, add `Sentry.consoleIntegration()` to keep capturing them. diff --git a/includes/migration/javascript-v11/deno-console-breadcrumbs.mdx b/includes/migration/javascript-v11/deno-console-breadcrumbs.mdx new file mode 100644 index 00000000000000..e29a4cf67b4a1f --- /dev/null +++ b/includes/migration/javascript-v11/deno-console-breadcrumbs.mdx @@ -0,0 +1,23 @@ +--- +id: deno-console-breadcrumbs +title: "Deno console breadcrumbs moved to `consoleIntegration`" +phase: code-changes +category: removed-api +severity: action-required +frameworks: [deno] +platformCategory: server +order: 311 +--- + +The `console` option of `breadcrumbsIntegration` was removed. Console breadcrumbs come from the default `consoleIntegration` now, which matches the other server SDKs. + +To disable console breadcrumbs, filter out the `Console` integration: + +```js +Sentry.init({ + integrations: integrations => + integrations.filter(integration => integration.name !== "Console"), +}); +``` + +If you set `defaultIntegrations: false`, add `Sentry.consoleIntegration()` to keep capturing them. diff --git a/platform-includes/configuration/integrations/javascript.deno.mdx b/platform-includes/configuration/integrations/javascript.deno.mdx index 4aab5d17afbf3c..7c23e138fb13b7 100644 --- a/platform-includes/configuration/integrations/javascript.deno.mdx +++ b/platform-includes/configuration/integrations/javascript.deno.mdx @@ -3,6 +3,7 @@ | | **Auto Enabled** | **Errors** | **Tracing** | **Cron** | **Additional Context** | | --------------------------------------------------- | :--------------: | :--------: | :---------: | :------: | :--------------------: | | [`breadcrumbsIntegration`](./breadcrumbs) | ✓ | | | | ✓ | +| [`consoleIntegration`](./console) | ✓ | | | | ✓ | | [`contextLinesIntegration`](./contextlines) | ✓ | ✓ | | | | | [`dedupeIntegration`](./dedupe) | ✓ | ✓ | | | | | [`denoContextIntegration`](./denocontext) | ✓ | | | | ✓ | diff --git a/platform-includes/configuration/integrations/javascript.gatsby.mdx b/platform-includes/configuration/integrations/javascript.gatsby.mdx index 5aff5b73147a26..0136aeecc7d0b9 100644 --- a/platform-includes/configuration/integrations/javascript.gatsby.mdx +++ b/platform-includes/configuration/integrations/javascript.gatsby.mdx @@ -4,6 +4,7 @@ |-------------------------------------------------------|:----------------:|:----------:|:-----------:|:----------:|:----------------------:| | [`breadcrumbsIntegration`](./breadcrumbs) | ✓ | | | | ✓ | | [`browserApiErrorsIntegration`](./browserapierrors) | ✓ | ✓ | | | | +| [`consoleIntegration`](./console) | ✓ | | | | ✓ | | [`dedupeIntegration`](./dedupe) | ✓ | ✓ | | | | | [`functionToStringIntegration`](./functiontostring) | ✓ | | | | | | [`globalHandlersIntegration`](./globalhandlers) | ✓ | ✓ | | | | diff --git a/platform-includes/configuration/integrations/javascript.mdx b/platform-includes/configuration/integrations/javascript.mdx index 3061f61c3fe67d..8d446f1d2d4145 100644 --- a/platform-includes/configuration/integrations/javascript.mdx +++ b/platform-includes/configuration/integrations/javascript.mdx @@ -5,6 +5,7 @@ | [`breadcrumbsIntegration`](./breadcrumbs) | ✓ | | | | ✓ | | [`browserApiErrorsIntegration`](./browserapierrors) | ✓ | ✓ | | | | | [`browserSessionIntegration`](./browsersession) | ✓ | | | | ✓ | +| [`consoleIntegration`](./console) | ✓ | | | | ✓ | | [`dedupeIntegration`](./dedupe) | ✓ | ✓ | | | | | [`functionToStringIntegration`](./functiontostring) | ✓ | | | | | | [`globalHandlersIntegration`](./globalhandlers) | ✓ | ✓ | | | | diff --git a/platform-includes/configuration/integrations/javascript.vue.mdx b/platform-includes/configuration/integrations/javascript.vue.mdx index ecbd989aa0f011..ed1ad1cc876248 100644 --- a/platform-includes/configuration/integrations/javascript.vue.mdx +++ b/platform-includes/configuration/integrations/javascript.vue.mdx @@ -5,6 +5,7 @@ | [`breadcrumbsIntegration`](./breadcrumbs) | ✓ | | | | ✓ | | [`browserApiErrorsIntegration`](./browserapierrors) | ✓ | ✓ | | | | | [`browserSessionIntegration`](./browsersession) | ✓ | | | | ✓ | +| [`consoleIntegration`](./console) | ✓ | | | | ✓ | | [`dedupeIntegration`](./dedupe) | ✓ | ✓ | | | | | [`functionToStringIntegration`](./functiontostring) | ✓ | | | | | | [`globalHandlersIntegration`](./globalhandlers) | ✓ | ✓ | | | | diff --git a/platform-includes/configuration/integrations/javascript.wasm.mdx b/platform-includes/configuration/integrations/javascript.wasm.mdx index ac3c8c7eab56d3..bd7469d519e569 100644 --- a/platform-includes/configuration/integrations/javascript.wasm.mdx +++ b/platform-includes/configuration/integrations/javascript.wasm.mdx @@ -4,6 +4,7 @@ |-------------------------------------------------------|:----------------:|:----------:|:-----------:|:----------:|:----------------------:| | [`breadcrumbsIntegration`](./breadcrumbs) | ✓ | | | | ✓ | | [`browserApiErrorsIntegration`](./browserapierrors) | ✓ | ✓ | | | | +| [`consoleIntegration`](./console) | ✓ | | | | ✓ | | [`dedupeIntegration`](./dedupe) | ✓ | ✓ | | | | | [`functionToStringIntegration`](./functiontostring) | ✓ | | | | | | [`globalHandlersIntegration`](./globalhandlers) | ✓ | ✓ | | | | From 1d4c91dd9d000741c66438bd0e41a73b0c34ccf8 Mon Sep 17 00:00:00 2001 From: Charly Gomez Date: Mon, 21 Sep 2026 12:54:37 +0200 Subject: [PATCH 2/2] docs(js): Fix console link on the Deno breadcrumbs page The relative `./console` link resolved against the page's trailing-slash URL, producing `integrations/breadcrumbs/console` and a 404. Use `PlatformLink` so it points at the guide's Console page. Co-Authored-By: Claude Opus 5 --- .../guides/deno/configuration/integrations/breadcrumbs.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/platforms/javascript/guides/deno/configuration/integrations/breadcrumbs.mdx b/docs/platforms/javascript/guides/deno/configuration/integrations/breadcrumbs.mdx index 7ca434721ea97e..616a821ec58d8f 100644 --- a/docs/platforms/javascript/guides/deno/configuration/integrations/breadcrumbs.mdx +++ b/docs/platforms/javascript/guides/deno/configuration/integrations/breadcrumbs.mdx @@ -12,7 +12,7 @@ This integration is enabled by default. You can also [modify default integration The `breadcrumbsIntegration` wraps native APIs to capture breadcrumbs. By default, the Sentry SDK wraps all APIs. You can opt out of capturing breadcrumbs for specific parts of your application (for example, you could say don't capture outgoing fetch requests as breadcrumbs) via the options below. -Console calls are captured by the [`consoleIntegration`](./console), which is enabled by default. +Console calls are captured by the `consoleIntegration`, which is enabled by default. ## Options