From e94bf2f5d78888d114d8cc331706a4d439c2f5ce Mon Sep 17 00:00:00 2001 From: Luca Forstner Date: Thu, 5 Dec 2024 16:23:18 +0100 Subject: [PATCH 1/8] Add docs for `browserSessionIntegration` and `trackIncomingRequestsAsSessions` as alternative to `autoSessionTracking` in JS SDKs --- .../integrations/browsersession.mdx | 39 ++++++++++++++++ .../configuration/integrations/http.mdx | 7 +++ .../common/configuration/options.mdx | 46 ++++++++++++------- .../integrations/mainprocesssession.mdx | 7 ++- .../javascript.electron.mdx | 2 + .../auto-session-tracking/javascript.mdx | 17 +++++++ .../auto-session-tracking/javascript.node.mdx | 15 ++++++ .../integrations/javascript.astro.mdx | 1 + .../integrations/javascript.gatsby.mdx | 1 + .../configuration/integrations/javascript.mdx | 1 + .../integrations/javascript.nextjs.mdx | 1 + .../integrations/javascript.nuxt.mdx | 1 + .../integrations/javascript.remix.mdx | 1 + .../integrations/javascript.solidstart.mdx | 1 + .../integrations/javascript.sveltekit.mdx | 1 + .../integrations/javascript.vue.mdx | 1 + .../integrations/javascript.wasm.mdx | 1 + 17 files changed, 123 insertions(+), 20 deletions(-) create mode 100644 docs/platforms/javascript/common/configuration/integrations/browsersession.mdx diff --git a/docs/platforms/javascript/common/configuration/integrations/browsersession.mdx b/docs/platforms/javascript/common/configuration/integrations/browsersession.mdx new file mode 100644 index 0000000000000..89d4b4b780741 --- /dev/null +++ b/docs/platforms/javascript/common/configuration/integrations/browsersession.mdx @@ -0,0 +1,39 @@ +--- +title: BrowserSession +description: "Track healthy Sessions in the Browser." +notSupported: + - javascript.cordova + - javascript.node + - javascript.aws-lambda + - javascript.azure-functions + - javascript.connect + - javascript.express + - javascript.fastify + - javascript.gcp-functions + - javascript.hapi + - javascript.koa + - javascript.nestjs + - javascript.deno + - javascript.cloudflare + - javascript.bun +--- + + + +This integration only works inside a browser environment. + + + +_Import name: `Sentry.browserSessionIntegration`_ + +Sentry's [Release Health](/product/releases/health/) feature allows you to track user adoption and your application's crash-free rate. + +The BrowserSession integration will create a Session that is used to track the health of your release when the user loads your page or application. +Sessions will be marked as faulty when an error is captured while a Session is active. +Read more about Sessions. + +```JavaScript +Sentry.init({ + integrations: [Sentry.browserSessionIntegration()], +}); +``` diff --git a/docs/platforms/javascript/common/configuration/integrations/http.mdx b/docs/platforms/javascript/common/configuration/integrations/http.mdx index f6942de92e067..808b8fe166097 100644 --- a/docs/platforms/javascript/common/configuration/integrations/http.mdx +++ b/docs/platforms/javascript/common/configuration/integrations/http.mdx @@ -73,6 +73,13 @@ The callback function receives two arguments: - `urlPath`: The URL path of the incoming request, including the query string if available. For example: `/users?name=John`. - `request`: An object of type `IncomingMessage` containing the incoming request. You can use this to filter on properties like the request method or headers. +### `trackIncomingRequestsAsSessions` + +_Type: `boolean`_ (Defaults to `true`) + +Whether the integration should create [Sessions](/product/releases/health/#sessions) for incoming requests to track the health and crash-free rate of your releases in Sentry. +Read more about [Release Health](/product/releases/health/). + ### `instrumentation` You can also pass some hooks through to the [underlying OpenTelemetry Instrumentation](https://www.npmjs.com/package/@opentelemetry/instrumentation-http): diff --git a/docs/platforms/javascript/common/configuration/options.mdx b/docs/platforms/javascript/common/configuration/options.mdx index 0d999a9aad1a6..dc474d212fe22 100644 --- a/docs/platforms/javascript/common/configuration/options.mdx +++ b/docs/platforms/javascript/common/configuration/options.mdx @@ -41,12 +41,14 @@ Turns debug mode on or off. If debug is enabled SDK will attempt to print out us Sets the release. Some SDKs will try to automatically configure a release out of the box but it's a better idea to manually set it to guarantee that the release is in sync with your deploy integrations or source map uploads. Release names are strings, but some formats are detected by Sentry and might be rendered differently. Learn more about how to send release data so Sentry can tell you about regressions between releases and identify the potential source in [the releases documentation](/product/releases/) or the sandbox. - -By default the SDK will try to read this value from the `SENTRY_RELEASE` environment variable. + + By default the SDK will try to read this value from the `SENTRY_RELEASE` + environment variable. - -By default the SDK will try to read this value from `window.SENTRY_RELEASE.id` if available. + + By default the SDK will try to read this value from `window.SENTRY_RELEASE.id` + if available. @@ -102,9 +104,10 @@ Grouping in Sentry is different for events with stack traces and without. As a r - This option can be used to supply a "server name." When provided, the name of the server is sent along and persisted in the event. For many integrations, the server name actually corresponds to the device hostname, even in situations where the machine is not actually a server. +This option can be used to supply a "server name." When provided, the name of the server is sent along and persisted in the event. For many integrations, the server name actually corresponds to the device hostname, even in situations where the machine is not actually a server. + +Most SDKs will attempt to auto-discover this value. - Most SDKs will attempt to auto-discover this value. @@ -141,6 +144,15 @@ Grouping in Sentry is different for events with stack traces and without. As a r Defaults to `true`. When set to `true`, the SDK will send session events to Sentry. This is supported in all browser SDKs, emitting one session per pageload and page navigation to Sentry. In mobile SDKs, when the app goes to the background for longer than 30 seconds, sessions are ended. + + +{/* We don't use platform links here because we always have to link to node and browser here and doing a conditional just for that feels overkill. */} + +The `autoSessionTracking` option is deprecated from SDK version `8.43.0` onwards. +Instead, use the [BrowserSession integration](/platforms/javascript/configuration/integrations/browsersession/) for the Browser and the [Http integration](/platforms/javascript/guides/node/configuration/integrations/http/) (via the `trackIncomingRequestsAsSessions` option) for the Node.js runtime. + + + @@ -155,7 +167,6 @@ Data to be set to the initial scope. Initial scope can be defined either as an o Object: - ```javascript Sentry.init({ dsn: "___PUBLIC_DSN___", @@ -316,17 +327,20 @@ Switches out the transport used to send events. How this works depends on the SD Options used to configure the transport. This is an object with the following possible optional keys: - -- `headers`: An object containing headers to be sent with every request. -- `proxy`: A proxy used for outbound requests. Can be http or https. -- `caCerts`: A path or list of paths to a CA certificate, or a buffer of CA certificates. -- `httpModule`: A custom HTTP module to use for requests. Defaults to the the native `http` and `https` modules. -- `keepAlive`: Determines whether to keep the socket alive between requests. Defaults to `false`. + + - `headers`: An object containing headers to be sent with every request. - + `proxy`: A proxy used for outbound requests. Can be http or https. - + `caCerts`: A path or list of paths to a CA certificate, or a buffer of CA + certificates. - `httpModule`: A custom HTTP module to use for requests. + Defaults to the the native `http` and `https` modules. - `keepAlive`: + Determines whether to keep the socket alive between requests. Defaults to + `false`. - -- `headers`: An object containing headers to be sent with every request. Used by the SDK's fetch and XHR transports. -- `fetchOptions`: An object containing options to be passed to the `fetch` call. Used by the SDK's fetch transport. + + - `headers`: An object containing headers to be sent with every request. Used + by the SDK's fetch and XHR transports. - `fetchOptions`: An object containing + options to be passed to the `fetch` call. Used by the SDK's fetch transport. diff --git a/docs/platforms/javascript/guides/electron/configuration/integrations/mainprocesssession.mdx b/docs/platforms/javascript/guides/electron/configuration/integrations/mainprocesssession.mdx index 9e38a68cd5d89..74fe277d48bf3 100644 --- a/docs/platforms/javascript/guides/electron/configuration/integrations/mainprocesssession.mdx +++ b/docs/platforms/javascript/guides/electron/configuration/integrations/mainprocesssession.mdx @@ -12,8 +12,9 @@ use the BrowserWindowSession integration in the renderer processes. -Unless `autoSessionTracking` is set to `false`, this integration will be automatically added. +{/* TODO(v9): When electron does a new major, update this since autoSessionTracking got removed */} +Unless `autoSessionTracking` is set to `false`, this integration will be automatically added. ```javascript import * as Sentry from "@sentry/electron/main"; @@ -31,8 +32,6 @@ import * as Sentry from "@sentry/electron/main"; Sentry.init({ dsn: "___PUBLIC_DSN___", - integrations: [ - Sentry.mainProcessSessionIntegration({ sendOnCreate: true }), - ], + integrations: [Sentry.mainProcessSessionIntegration({ sendOnCreate: true })], }); ``` diff --git a/platform-includes/configuration/auto-session-tracking/javascript.electron.mdx b/platform-includes/configuration/auto-session-tracking/javascript.electron.mdx index 369d998135246..7367794a79fdf 100644 --- a/platform-includes/configuration/auto-session-tracking/javascript.electron.mdx +++ b/platform-includes/configuration/auto-session-tracking/javascript.electron.mdx @@ -10,6 +10,8 @@ Due to the nature of `crashed` and `abnormal` exits, these sessions are finished To receive data on user adoption, such as users crash free rate percentage, and the number of users that have adopted a specific release, set the user on the [`initialScope`](/platforms/javascript/configuration/options/#initial-scope) when initializing the SDK. +{/* TODO(v9): When electron does a new major, update this since autoSessionTracking got removed */} + To disable sending sessions, set the `autoSessionTracking` flag to `false`: ```javascript diff --git a/platform-includes/configuration/auto-session-tracking/javascript.mdx b/platform-includes/configuration/auto-session-tracking/javascript.mdx index 3611241228df3..feb54b59040d7 100644 --- a/platform-includes/configuration/auto-session-tracking/javascript.mdx +++ b/platform-includes/configuration/auto-session-tracking/javascript.mdx @@ -1,3 +1,5 @@ +{/* TODO(v9): Update this for the new behaviour (sessions are persisted in sessionStorage or memory) */} + We create a session for every page load. For single-page applications, we will create a new session for every navigation change (History API). We mark the session as: @@ -14,3 +16,18 @@ Sentry.init({ autoSessionTracking: false, // default: true }); ``` + +{/* TODO(v9): Remove this notice? */} + + + + + +{/* We don't use platform links here because we always have to link to node and browser here and doing a conditional just for that feels overkill. */} + +The `autoSessionTracking` option is deprecated from SDK version `8.43.0` onwards. +Instead, use the [BrowserSession integration](/platforms/javascript/configuration/integrations/browsersession/) for the Browser and the [Http integration](/platforms/javascript/guides/node/configuration/integrations/http/) (via the `trackIncomingRequestsAsSessions` option) for the Node.js runtime. + + + + diff --git a/platform-includes/configuration/auto-session-tracking/javascript.node.mdx b/platform-includes/configuration/auto-session-tracking/javascript.node.mdx index 281cba0bd66e7..bd168260b22fa 100644 --- a/platform-includes/configuration/auto-session-tracking/javascript.node.mdx +++ b/platform-includes/configuration/auto-session-tracking/javascript.node.mdx @@ -14,3 +14,18 @@ Sentry.init({ autoSessionTracking: false, // default: true }); ``` + +{/* TODO(v9): Remove this notice? */} + + + + + +{/* We don't use platform links here because we always have to link to node and browser here and doing a conditional just for that feels overkill. */} + +The `autoSessionTracking` option is deprecated from SDK version `8.43.0` onwards. +Instead, use the [BrowserSession integration](/platforms/javascript/configuration/integrations/browsersession/) for the Browser and the [Http integration](/platforms/javascript/guides/node/configuration/integrations/http/) (via the `trackIncomingRequestsAsSessions` option) for the Node.js runtime. + + + + diff --git a/platform-includes/configuration/integrations/javascript.astro.mdx b/platform-includes/configuration/integrations/javascript.astro.mdx index 9a4c097d41e6c..b88dcd119870d 100644 --- a/platform-includes/configuration/integrations/javascript.astro.mdx +++ b/platform-includes/configuration/integrations/javascript.astro.mdx @@ -30,6 +30,7 @@ Depending on whether an integration enhances the functionality of a particular r | [`globalHandlersIntegration`](./globalhandlers) | ✓ | ✓ | | | | | [`httpContextIntegration`](./httpcontext) | ✓ | | | | ✓ | | [`browserProfilingIntegration`](./browserprofiling) | | | ✓ | | | +| [`browserSessionIntegration`](./browsersession) | ✓ | | | | ✓ | | [`contextLinesIntegration`](./contextlines) | | ✓ | | | | | [`httpClientIntegration`](./httpclient) | | ✓ | | | | | [`moduleMetadataIntegration`](./modulemetadata) | | | | | ✓ | diff --git a/platform-includes/configuration/integrations/javascript.gatsby.mdx b/platform-includes/configuration/integrations/javascript.gatsby.mdx index ce71e5b4b9582..ba419ec70729c 100644 --- a/platform-includes/configuration/integrations/javascript.gatsby.mdx +++ b/platform-includes/configuration/integrations/javascript.gatsby.mdx @@ -11,6 +11,7 @@ | [`inboundFiltersIntegration`](./inboundfilters) | ✓ | ✓ | | | | | [`linkedErrorsIntegration`](./linkederrors) | ✓ | ✓ | | | | | [`browserProfilingIntegration`](./browserprofiling) | | | ✓ | | | +| [`browserSessionIntegration`](./browsersession) | ✓ | | | | ✓ | | [`browserTracingIntegration`](./browsertracing) | | | ✓ | | ✓ | | [`captureConsoleIntegration`](./captureconsole) | | | | | ✓ | | [`contextLinesIntegration`](./contextlines) | | ✓ | | | | diff --git a/platform-includes/configuration/integrations/javascript.mdx b/platform-includes/configuration/integrations/javascript.mdx index ce71e5b4b9582..ba419ec70729c 100644 --- a/platform-includes/configuration/integrations/javascript.mdx +++ b/platform-includes/configuration/integrations/javascript.mdx @@ -11,6 +11,7 @@ | [`inboundFiltersIntegration`](./inboundfilters) | ✓ | ✓ | | | | | [`linkedErrorsIntegration`](./linkederrors) | ✓ | ✓ | | | | | [`browserProfilingIntegration`](./browserprofiling) | | | ✓ | | | +| [`browserSessionIntegration`](./browsersession) | ✓ | | | | ✓ | | [`browserTracingIntegration`](./browsertracing) | | | ✓ | | ✓ | | [`captureConsoleIntegration`](./captureconsole) | | | | | ✓ | | [`contextLinesIntegration`](./contextlines) | | ✓ | | | | diff --git a/platform-includes/configuration/integrations/javascript.nextjs.mdx b/platform-includes/configuration/integrations/javascript.nextjs.mdx index 1852010463c4f..92356373b4fe4 100644 --- a/platform-includes/configuration/integrations/javascript.nextjs.mdx +++ b/platform-includes/configuration/integrations/javascript.nextjs.mdx @@ -31,6 +31,7 @@ Depending on whether an integration enhances the functionality of a particular r | [`globalHandlersIntegration`](./globalhandlers) | ✓ | ✓ | | | | | [`httpContextIntegration`](./httpcontext) | ✓ | | | | ✓ | | [`browserProfilingIntegration`](./browserprofiling) | | | ✓ | | | +| [`browserSessionIntegration`](./browsersession) | ✓ | | | | ✓ | | [`contextLinesIntegration`](./contextlines) | | ✓ | | | | | [`httpClientIntegration`](./httpclient) | | ✓ | | | | | [`moduleMetadataIntegration`](./modulemetadata) | | | | | ✓ | diff --git a/platform-includes/configuration/integrations/javascript.nuxt.mdx b/platform-includes/configuration/integrations/javascript.nuxt.mdx index 2a308f7a735e7..accaa03bf467f 100644 --- a/platform-includes/configuration/integrations/javascript.nuxt.mdx +++ b/platform-includes/configuration/integrations/javascript.nuxt.mdx @@ -30,6 +30,7 @@ Depending on whether an integration enhances the functionality of a particular r | [`globalHandlersIntegration`](./globalhandlers) | ✓ | ✓ | | | | | [`httpContextIntegration`](./httpcontext) | ✓ | | | | ✓ | | [`browserProfilingIntegration`](./browserprofiling) | | | ✓ | | | +| [`browserSessionIntegration`](./browsersession) | ✓ | | | | ✓ | | [`contextLinesIntegration`](./contextlines) | | ✓ | | | | | [`httpClientIntegration`](./httpclient) | | ✓ | | | | | [`moduleMetadataIntegration`](./modulemetadata) | | | | | ✓ | diff --git a/platform-includes/configuration/integrations/javascript.remix.mdx b/platform-includes/configuration/integrations/javascript.remix.mdx index 4af355c061ad1..7c314fa1505c4 100644 --- a/platform-includes/configuration/integrations/javascript.remix.mdx +++ b/platform-includes/configuration/integrations/javascript.remix.mdx @@ -30,6 +30,7 @@ Depending on whether an integration enhances the functionality of a particular r | [`globalHandlersIntegration`](./globalhandlers) | ✓ | ✓ | | | | | [`httpContextIntegration`](./httpcontext) | ✓ | | | | ✓ | | [`browserProfilingIntegration`](./browserprofiling) | | | ✓ | | | +| [`browserSessionIntegration`](./browsersession) | ✓ | | | | ✓ | | [`contextLinesIntegration`](./contextlines) | | ✓ | | | | | [`httpClientIntegration`](./httpclient) | | ✓ | | | | | [`moduleMetadataIntegration`](./modulemetadata) | | | | | ✓ | diff --git a/platform-includes/configuration/integrations/javascript.solidstart.mdx b/platform-includes/configuration/integrations/javascript.solidstart.mdx index 6a3ab25941e0a..01e0575ac52ce 100644 --- a/platform-includes/configuration/integrations/javascript.solidstart.mdx +++ b/platform-includes/configuration/integrations/javascript.solidstart.mdx @@ -30,6 +30,7 @@ Depending on whether an integration enhances the functionality of a particular r | [`globalHandlersIntegration`](./globalhandlers) | ✓ | ✓ | | | | | [`httpContextIntegration`](./httpcontext) | ✓ | | | | ✓ | | [`browserProfilingIntegration`](./browserprofiling) | | | ✓ | | | +| [`browserSessionIntegration`](./browsersession) | ✓ | | | | ✓ | | [`contextLinesIntegration`](./contextlines) | | ✓ | | | | | [`httpClientIntegration`](./httpclient) | | ✓ | | | | | [`moduleMetadataIntegration`](./modulemetadata) | | | | | ✓ | diff --git a/platform-includes/configuration/integrations/javascript.sveltekit.mdx b/platform-includes/configuration/integrations/javascript.sveltekit.mdx index f3815cbb86dd3..795be37ce3ce0 100644 --- a/platform-includes/configuration/integrations/javascript.sveltekit.mdx +++ b/platform-includes/configuration/integrations/javascript.sveltekit.mdx @@ -30,6 +30,7 @@ Depending on whether an integration enhances the functionality of a particular r | [`globalHandlersIntegration`](./globalhandlers) | ✓ | ✓ | | | | | [`httpContextIntegration`](./httpcontext) | ✓ | | | | ✓ | | [`browserProfilingIntegration`](./browserprofiling) | | | ✓ | | | +| [`browserSessionIntegration`](./browsersession) | ✓ | | | | ✓ | | [`contextLinesIntegration`](./contextlines) | | ✓ | | | | | [`httpClientIntegration`](./httpclient) | | ✓ | | | | | [`moduleMetadataIntegration`](./modulemetadata) | | | | | ✓ | diff --git a/platform-includes/configuration/integrations/javascript.vue.mdx b/platform-includes/configuration/integrations/javascript.vue.mdx index 1a8bf9d1943f2..88de3ae444768 100644 --- a/platform-includes/configuration/integrations/javascript.vue.mdx +++ b/platform-includes/configuration/integrations/javascript.vue.mdx @@ -12,6 +12,7 @@ | [`linkedErrorsIntegration`](./linkederrors) | ✓ | ✓ | | | | | [`vueIntegration`](./vue) | ✓ | ✓ | ✓ | | | | [`browserProfilingIntegration`](./browserprofiling) | | | ✓ | | | +| [`browserSessionIntegration`](./browsersession) | ✓ | | | | ✓ | | [`browserTracingIntegration`](./browsertracing) | | | ✓ | | ✓ | | [`captureConsoleIntegration`](./captureconsole) | | | | | ✓ | | [`contextLinesIntegration`](./contextlines) | | ✓ | | | | diff --git a/platform-includes/configuration/integrations/javascript.wasm.mdx b/platform-includes/configuration/integrations/javascript.wasm.mdx index 18ae96f5d6fed..7d229e84dfcff 100644 --- a/platform-includes/configuration/integrations/javascript.wasm.mdx +++ b/platform-includes/configuration/integrations/javascript.wasm.mdx @@ -11,6 +11,7 @@ | [`inboundFiltersIntegration`](./inboundfilters) | ✓ | ✓ | | | | | [`linkedErrorsIntegration`](./linkederrors) | ✓ | ✓ | | | | | [`browserProfilingIntegration`](./browserprofiling) | | | ✓ | | | +| [`browserSessionIntegration`](./browsersession) | ✓ | | | | ✓ | | [`browserTracingIntegration`](./browsertracing) | | | ✓ | | ✓ | | [`captureConsoleIntegration`](./captureconsole) | | | | | ✓ | | [`contextLinesIntegration`](./contextlines) | | ✓ | | | | From d922c95c079706bd11fbe9cf509139d6f0617164 Mon Sep 17 00:00:00 2001 From: Luca Forstner Date: Wed, 11 Dec 2024 12:57:00 +0100 Subject: [PATCH 2/8] Update docs/platforms/javascript/common/configuration/integrations/browsersession.mdx Co-authored-by: Liza Mock --- .../common/configuration/integrations/browsersession.mdx | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/platforms/javascript/common/configuration/integrations/browsersession.mdx b/docs/platforms/javascript/common/configuration/integrations/browsersession.mdx index 89d4b4b780741..42d9e8679fd4b 100644 --- a/docs/platforms/javascript/common/configuration/integrations/browsersession.mdx +++ b/docs/platforms/javascript/common/configuration/integrations/browsersession.mdx @@ -27,9 +27,7 @@ This integration only works inside a browser environment. _Import name: `Sentry.browserSessionIntegration`_ Sentry's [Release Health](/product/releases/health/) feature allows you to track user adoption and your application's crash-free rate. - -The BrowserSession integration will create a Session that is used to track the health of your release when the user loads your page or application. -Sessions will be marked as faulty when an error is captured while a Session is active. +When the BrowserSession integration is enabled, it automatically creates a session each time a user loads your page or application. These sessions are used to track your release health. If an error is captured during an active session, the session will be flagged as faulty. Read more about Sessions. ```JavaScript From a616060480035cc05620f3435824a078549cf7a8 Mon Sep 17 00:00:00 2001 From: Luca Forstner Date: Wed, 11 Dec 2024 12:57:44 +0100 Subject: [PATCH 3/8] Update docs/platforms/javascript/common/configuration/integrations/http.mdx Co-authored-by: Liza Mock --- .../javascript/common/configuration/integrations/http.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/platforms/javascript/common/configuration/integrations/http.mdx b/docs/platforms/javascript/common/configuration/integrations/http.mdx index 808b8fe166097..37957be586680 100644 --- a/docs/platforms/javascript/common/configuration/integrations/http.mdx +++ b/docs/platforms/javascript/common/configuration/integrations/http.mdx @@ -77,7 +77,7 @@ The callback function receives two arguments: _Type: `boolean`_ (Defaults to `true`) -Whether the integration should create [Sessions](/product/releases/health/#sessions) for incoming requests to track the health and crash-free rate of your releases in Sentry. +Determines whether the integration should create [Sessions](/product/releases/health/#sessions) for incoming requests to track the health and crash-free rate of your releases in Sentry. Read more about [Release Health](/product/releases/health/). ### `instrumentation` From 08af3dc63265f9ac7038bfdb09c1f322d907c618 Mon Sep 17 00:00:00 2001 From: Luca Forstner Date: Wed, 11 Dec 2024 12:57:51 +0100 Subject: [PATCH 4/8] Update docs/platforms/javascript/common/configuration/options.mdx Co-authored-by: Liza Mock --- docs/platforms/javascript/common/configuration/options.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/platforms/javascript/common/configuration/options.mdx b/docs/platforms/javascript/common/configuration/options.mdx index dc474d212fe22..c75b0553c1003 100644 --- a/docs/platforms/javascript/common/configuration/options.mdx +++ b/docs/platforms/javascript/common/configuration/options.mdx @@ -42,7 +42,7 @@ Turns debug mode on or off. If debug is enabled SDK will attempt to print out us Sets the release. Some SDKs will try to automatically configure a release out of the box but it's a better idea to manually set it to guarantee that the release is in sync with your deploy integrations or source map uploads. Release names are strings, but some formats are detected by Sentry and might be rendered differently. Learn more about how to send release data so Sentry can tell you about regressions between releases and identify the potential source in [the releases documentation](/product/releases/) or the sandbox. - By default the SDK will try to read this value from the `SENTRY_RELEASE` + By default, the SDK will try to read this value from the `SENTRY_RELEASE` environment variable. From 6387f108697505e9e7e16edea13de08ff73465a3 Mon Sep 17 00:00:00 2001 From: Luca Forstner Date: Wed, 11 Dec 2024 12:57:57 +0100 Subject: [PATCH 5/8] Update docs/platforms/javascript/common/configuration/options.mdx Co-authored-by: Liza Mock --- docs/platforms/javascript/common/configuration/options.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/platforms/javascript/common/configuration/options.mdx b/docs/platforms/javascript/common/configuration/options.mdx index c75b0553c1003..85109bb690664 100644 --- a/docs/platforms/javascript/common/configuration/options.mdx +++ b/docs/platforms/javascript/common/configuration/options.mdx @@ -47,7 +47,7 @@ Sets the release. Some SDKs will try to automatically configure a release out of - By default the SDK will try to read this value from `window.SENTRY_RELEASE.id` + By default, the SDK will try to read this value from `window.SENTRY_RELEASE.id` if available. From 5f620e935a7939d0c72071c8b02a87a5f7090efa Mon Sep 17 00:00:00 2001 From: Luca Forstner Date: Wed, 11 Dec 2024 12:58:52 +0100 Subject: [PATCH 6/8] Update docs/platforms/javascript/common/configuration/options.mdx Co-authored-by: Liza Mock --- docs/platforms/javascript/common/configuration/options.mdx | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/platforms/javascript/common/configuration/options.mdx b/docs/platforms/javascript/common/configuration/options.mdx index 85109bb690664..0fca67939aa86 100644 --- a/docs/platforms/javascript/common/configuration/options.mdx +++ b/docs/platforms/javascript/common/configuration/options.mdx @@ -147,9 +147,7 @@ Defaults to `true`. When set to `true`, the SDK will send session events to Sent {/* We don't use platform links here because we always have to link to node and browser here and doing a conditional just for that feels overkill. */} - -The `autoSessionTracking` option is deprecated from SDK version `8.43.0` onwards. -Instead, use the [BrowserSession integration](/platforms/javascript/configuration/integrations/browsersession/) for the Browser and the [Http integration](/platforms/javascript/guides/node/configuration/integrations/http/) (via the `trackIncomingRequestsAsSessions` option) for the Node.js runtime. +Starting with SDK version 8.43.0 and up, the `autoSessionTracking` option has been deprecated. You can use the [BrowserSession integration](/platforms/javascript/configuration/integrations/browsersession/) in browser environments and the [Http integration](/platforms/javascript/guides/node/configuration/integrations/http/) (via the `trackIncomingRequestsAsSessions` option) in Node.js runtime. From ba482052c1eeae3b3e50ffa615579af2f1e64013 Mon Sep 17 00:00:00 2001 From: Luca Forstner Date: Wed, 11 Dec 2024 12:59:09 +0100 Subject: [PATCH 7/8] Update platform-includes/configuration/auto-session-tracking/javascript.mdx Co-authored-by: Liza Mock --- .../configuration/auto-session-tracking/javascript.mdx | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/platform-includes/configuration/auto-session-tracking/javascript.mdx b/platform-includes/configuration/auto-session-tracking/javascript.mdx index feb54b59040d7..bb56140881db0 100644 --- a/platform-includes/configuration/auto-session-tracking/javascript.mdx +++ b/platform-includes/configuration/auto-session-tracking/javascript.mdx @@ -25,8 +25,7 @@ Sentry.init({ {/* We don't use platform links here because we always have to link to node and browser here and doing a conditional just for that feels overkill. */} -The `autoSessionTracking` option is deprecated from SDK version `8.43.0` onwards. -Instead, use the [BrowserSession integration](/platforms/javascript/configuration/integrations/browsersession/) for the Browser and the [Http integration](/platforms/javascript/guides/node/configuration/integrations/http/) (via the `trackIncomingRequestsAsSessions` option) for the Node.js runtime. +Starting with SDK version 8.43.0 and up, the `autoSessionTracking` option has been deprecated. You can use the [BrowserSession integration](/platforms/javascript/configuration/integrations/browsersession/) in browser environments and the [Http integration](/platforms/javascript/guides/node/configuration/integrations/http/) (via the `trackIncomingRequestsAsSessions` option) in Node.js runtime. From 73e79199c877ef6be75cbc24bec64ac018a17bf4 Mon Sep 17 00:00:00 2001 From: Luca Forstner Date: Wed, 11 Dec 2024 12:59:15 +0100 Subject: [PATCH 8/8] Update platform-includes/configuration/auto-session-tracking/javascript.node.mdx Co-authored-by: Liza Mock --- .../configuration/auto-session-tracking/javascript.node.mdx | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/platform-includes/configuration/auto-session-tracking/javascript.node.mdx b/platform-includes/configuration/auto-session-tracking/javascript.node.mdx index bd168260b22fa..c873abdc882f0 100644 --- a/platform-includes/configuration/auto-session-tracking/javascript.node.mdx +++ b/platform-includes/configuration/auto-session-tracking/javascript.node.mdx @@ -23,8 +23,7 @@ Sentry.init({ {/* We don't use platform links here because we always have to link to node and browser here and doing a conditional just for that feels overkill. */} -The `autoSessionTracking` option is deprecated from SDK version `8.43.0` onwards. -Instead, use the [BrowserSession integration](/platforms/javascript/configuration/integrations/browsersession/) for the Browser and the [Http integration](/platforms/javascript/guides/node/configuration/integrations/http/) (via the `trackIncomingRequestsAsSessions` option) for the Node.js runtime. +Starting with SDK version 8.43.0 and up, the `autoSessionTracking` option has been deprecated. You can use the [BrowserSession integration](/platforms/javascript/configuration/integrations/browsersession/) in browser environments and the [Http integration](/platforms/javascript/guides/node/configuration/integrations/http/) (via the `trackIncomingRequestsAsSessions` option) in Node.js runtime.