From 301452dc12743dd144935695be713fd4adc52031 Mon Sep 17 00:00:00 2001 From: AlexandreDevaux <74876666+AlexandreDevaux@users.noreply.github.com> Date: Thu, 26 Oct 2023 02:13:58 +0100 Subject: [PATCH 1/6] Update javascript.nextjs.mdx (#8327) Fixed typo --- .../getting-started-primer/javascript.nextjs.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/platform-includes/getting-started-primer/javascript.nextjs.mdx b/src/platform-includes/getting-started-primer/javascript.nextjs.mdx index f6cca58293a54..07243b2c70ca6 100644 --- a/src/platform-includes/getting-started-primer/javascript.nextjs.mdx +++ b/src/platform-includes/getting-started-primer/javascript.nextjs.mdx @@ -7,7 +7,7 @@ Features: - [Breadcrumbs](/platforms/javascript/enriching-events/breadcrumbs/) created for outgoing HTTP request with XHR and Fetch, and console logs - [Release health](/product/releases/health/) for tracking crash-free users and sessions - Automatic [Performance Monitoring](/product/performance/) for both the client and server -- Errors and Performance support for [Middleware](https://vercel.com/docs/concepts/functions/edge-middleware) and [Edge routes](https://vercel.com/docs/concepts/functions/edge-functions) in Vercel's edge runtime. Due to complexities with the runtime, some features of errors like stack traces may not not be as expected. Requires sentry.edge.config.js, more info [here](/platforms/javascript/guides/nextjs/manual-setup/#create-initialization-config-files) +- Errors and Performance support for [Middleware](https://vercel.com/docs/concepts/functions/edge-middleware) and [Edge routes](https://vercel.com/docs/concepts/functions/edge-functions) in Vercel's edge runtime. Due to complexities with the runtime, some features of errors like stack traces may not be as expected. Requires sentry.edge.config.js, more info [here](/platforms/javascript/guides/nextjs/manual-setup/#create-initialization-config-files) From 6afc5946d42925a2466445a1c909bf098fd8bd5b Mon Sep 17 00:00:00 2001 From: Stephanie Anderson Date: Thu, 26 Oct 2023 13:18:28 +0200 Subject: [PATCH 2/6] fetch API docs URL and display in package details box (#8329) * fetch API docs URL and display in package details box * only display api docs if it exists --------- Co-authored-by: Abhijeet Prasad --- src/components/platformSdkDetail.tsx | 13 +++++++++++-- .../createSchemaCustomization/packageSchema.ts | 1 + src/gatsby/sourceNodes/appRegistryNodes.ts | 1 + src/gatsby/sourceNodes/packageRegistryNodes.ts | 2 ++ src/gatsby/utils/genericRegistry.ts | 1 + src/types/platform.tsx | 2 +- 6 files changed, 17 insertions(+), 3 deletions(-) diff --git a/src/components/platformSdkDetail.tsx b/src/components/platformSdkDetail.tsx index 91d4d10fc76ef..a69f0c8a1f171 100644 --- a/src/components/platformSdkDetail.tsx +++ b/src/components/platformSdkDetail.tsx @@ -1,4 +1,4 @@ -import React from 'react'; +import React, {Fragment} from 'react'; import styled from '@emotion/styled'; import {graphql, useStaticQuery} from 'gatsby'; @@ -14,6 +14,7 @@ const query = graphql` url repoUrl version + apiDocsUrl } } } @@ -79,8 +80,16 @@ export function PlatformSdkDetail() {
{packageData.version}
Repository:
- +
+ {packageData.apiDocsUrl && ( + +
API Documentation:
+
+ +
+ + )} ); diff --git a/src/gatsby/createSchemaCustomization/packageSchema.ts b/src/gatsby/createSchemaCustomization/packageSchema.ts index c2d467b496170..46dedcb41d2cb 100644 --- a/src/gatsby/createSchemaCustomization/packageSchema.ts +++ b/src/gatsby/createSchemaCustomization/packageSchema.ts @@ -18,6 +18,7 @@ export const getPackageTypeDefs = () => { url: String repoUrl: String! version: String! + apiDocsUrl: String files: [PackageFile!] } `, diff --git a/src/gatsby/sourceNodes/appRegistryNodes.ts b/src/gatsby/sourceNodes/appRegistryNodes.ts index e2078641511ca..9777e8292ad3c 100644 --- a/src/gatsby/sourceNodes/appRegistryNodes.ts +++ b/src/gatsby/sourceNodes/appRegistryNodes.ts @@ -18,6 +18,7 @@ export const sourceAppRegistryNodes = async ({ version: appData.version, url: appData.package_url, repoUrl: appData.repo_url, + apiDocsUrl: appData.api_docs_url, files: appData.files ? Object.entries(appData.files).map(([fileName, fileData]: [string, any]) => fileData.checksums diff --git a/src/gatsby/sourceNodes/packageRegistryNodes.ts b/src/gatsby/sourceNodes/packageRegistryNodes.ts index 451c6cbc94005..918d4d228fcfc 100644 --- a/src/gatsby/sourceNodes/packageRegistryNodes.ts +++ b/src/gatsby/sourceNodes/packageRegistryNodes.ts @@ -18,6 +18,7 @@ export const sourcePackageRegistryNodes = async ({ version: sdkData.version, url: sdkData.package_url, repoUrl: sdkData.repo_url, + apiDocsUrl: sdkData.api_docs_url, files: sdkData.files ? Object.entries(sdkData.files).map(([fileName, fileData]: [string, any]) => fileData.checksums @@ -34,6 +35,7 @@ export const sourcePackageRegistryNodes = async ({ }; const content = JSON.stringify(data); + const nodeMeta = { id: sdkName, parent: null, diff --git a/src/gatsby/utils/genericRegistry.ts b/src/gatsby/utils/genericRegistry.ts index d485e828f2ed8..98c99da6c5260 100644 --- a/src/gatsby/utils/genericRegistry.ts +++ b/src/gatsby/utils/genericRegistry.ts @@ -13,6 +13,7 @@ type VersionData = { name: string; repo_url: string; version: string; + api_docs_url?: string; files?: { [name: string]: FileData; }; diff --git a/src/types/platform.tsx b/src/types/platform.tsx index faa3a55aeb510..8741f7830ce54 100644 --- a/src/types/platform.tsx +++ b/src/types/platform.tsx @@ -14,7 +14,7 @@ export interface Platform extends PlatformConfig { */ key: string; /** - * Same as key. Use `title` for a human readable platform name. + * Same as key. Use `title` for a human-readable platform name. * * @see Platform.key */ From be27b5799e95b25848f75062cf76f97b124089ae Mon Sep 17 00:00:00 2001 From: Stephanie Anderson Date: Thu, 26 Oct 2023 13:50:08 +0200 Subject: [PATCH 3/6] Replace traces_sample_rate with enable_tracing (#8321) * Replace traces_sample_rate with enable_tracing, since backpressure management is now handled * [getsentry/action-github-commit] Auto commit * Apply suggestions from code review Co-authored-by: Shana Matthews --------- Co-authored-by: getsantry[bot] <66042841+getsantry[bot]@users.noreply.github.com> Co-authored-by: Shana Matthews --- src/includes/opentelemetry-available.mdx | 2 +- .../configuration/config-intro/python.mdx | 6 +--- .../getting-started-config/python.mdx | 6 ++-- .../configure-sample-rate/python.mdx | 16 ++-------- .../opentelemetry-setup/python.mdx | 3 +- .../profiling/index/preface/_default.mdx | 0 .../profiling/index/preface/go.mdx | 5 ++++ .../profiling/index/preface/react-native.mdx | 5 ++++ .../profiling/index/preface/ruby.mdx | 5 ++++ src/platforms/common/performance/index.mdx | 12 ++++++-- src/platforms/common/profiling/index.mdx | 30 +------------------ .../integrations/aiohttp/aiohttp-client.mdx | 2 ++ .../python/integrations/aiohttp/index.mdx | 5 ++-- .../python/integrations/ariadne/index.mdx | 3 -- .../python/integrations/arq/index.mdx | 6 ++-- .../python/integrations/asgi/index.mdx | 5 +--- .../python/integrations/asyncio/index.mdx | 8 ++--- .../python/integrations/asyncpg/index.mdx | 8 ++--- .../aws-lambda/container-image/index.mdx | 10 ++----- .../python/integrations/aws-lambda/index.mdx | 21 +++++-------- .../python/integrations/beam/index.mdx | 10 ++----- .../python/integrations/boto3/index.mdx | 4 +-- .../python/integrations/bottle/index.mdx | 12 +++----- .../python/integrations/celery/crons.mdx | 29 ++++++++++-------- .../python/integrations/celery/index.mdx | 15 ++++++---- .../python/integrations/chalice/index.mdx | 4 +-- .../integrations/clickhouse-driver/index.mdx | 4 +-- .../cloudresourcecontext/index.mdx | 4 +-- .../python/integrations/django/index.mdx | 8 ++--- .../python/integrations/falcon/index.mdx | 10 ++----- .../python/integrations/fastapi/index.mdx | 26 +++++++++------- .../python/integrations/flask/index.mdx | 10 ++----- .../integrations/gcp-functions/index.mdx | 16 ++++------ .../python/integrations/graphene/index.mdx | 4 +-- .../python/integrations/grpc/index.mdx | 8 ++--- .../python/integrations/httpx/index.mdx | 4 +-- .../python/integrations/huey/index.mdx | 4 +-- src/platforms/python/integrations/index.mdx | 2 +- .../python/integrations/logging/index.mdx | 8 +---- .../python/integrations/pure_eval/index.mdx | 2 +- .../python/integrations/pymongo/index.mdx | 4 +-- .../python/integrations/pyramid/index.mdx | 8 ++--- .../python/integrations/quart/index.mdx | 4 +-- .../python/integrations/redis/index.mdx | 14 +++++---- .../python/integrations/rq/index.mdx | 16 +++------- .../python/integrations/sanic/index.mdx | 22 +++++++------- .../python/integrations/serverless/index.mdx | 4 +-- .../python/integrations/socket/index.mdx | 4 +-- .../python/integrations/spark/index.mdx | 12 ++------ .../python/integrations/sqlalchemy/index.mdx | 4 +-- .../python/integrations/starlette/index.mdx | 12 +++----- .../python/integrations/strawberry/index.mdx | 15 ++++++---- .../python/integrations/tornado/index.mdx | 4 +-- .../python/integrations/tryton/index.mdx | 4 +-- .../python/integrations/wsgi/index.mdx | 4 +-- 55 files changed, 177 insertions(+), 296 deletions(-) create mode 100644 src/platform-includes/profiling/index/preface/_default.mdx create mode 100644 src/platform-includes/profiling/index/preface/go.mdx create mode 100644 src/platform-includes/profiling/index/preface/react-native.mdx create mode 100644 src/platform-includes/profiling/index/preface/ruby.mdx diff --git a/src/includes/opentelemetry-available.mdx b/src/includes/opentelemetry-available.mdx index 421d32939da39..7ac8d2323af5c 100644 --- a/src/includes/opentelemetry-available.mdx +++ b/src/includes/opentelemetry-available.mdx @@ -2,7 +2,7 @@ Sentry can integrate with OpenTelemetry. You can find more information about it{" "} - here + here . diff --git a/src/platform-includes/configuration/config-intro/python.mdx b/src/platform-includes/configuration/config-intro/python.mdx index b6d6e1dcbe817..0874c7b09aef6 100644 --- a/src/platform-includes/configuration/config-intro/python.mdx +++ b/src/platform-includes/configuration/config-intro/python.mdx @@ -9,11 +9,7 @@ sentry_sdk.init( dsn="___PUBLIC_DSN___", max_breadcrumbs=50, debug=True, - - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - # We recommend adjusting this value in production, - traces_sample_rate=1.0, + enable_tracing=True, # By default the SDK will try to use the SENTRY_RELEASE # environment variable, or infer a git commit diff --git a/src/platform-includes/getting-started-config/python.mdx b/src/platform-includes/getting-started-config/python.mdx index 53958ebf877ec..7a755fb8c266d 100644 --- a/src/platform-includes/getting-started-config/python.mdx +++ b/src/platform-includes/getting-started-config/python.mdx @@ -8,9 +8,7 @@ import sentry_sdk sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - # We recommend adjusting this value in production. - traces_sample_rate=1.0, + # Enable performance monitoring + enable_tracing=True, ) ``` diff --git a/src/platform-includes/performance/configure-sample-rate/python.mdx b/src/platform-includes/performance/configure-sample-rate/python.mdx index 6689cf2f79346..7768c65b15ef9 100644 --- a/src/platform-includes/performance/configure-sample-rate/python.mdx +++ b/src/platform-includes/performance/configure-sample-rate/python.mdx @@ -1,24 +1,12 @@ -Performance Monitoring is available for the Sentry Python SDK version ≥ 0.11.2. +Activate performance monitoring by setting `enable_tracing` to `True`. Performance Monitoring is available for the Sentry Python SDK version ≥ 0.11.2. ```python import sentry_sdk -def traces_sampler(sampling_context): - # ... - # return a number between 0 and 1 or a boolean - sentry_sdk.init( dsn="___PUBLIC_DSN___", - - # To set a uniform sample rate - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - # We recommend adjusting this value in production, - traces_sample_rate=1.0, - - # Alternatively, to control sampling dynamically - traces_sampler=traces_sampler + enable_tracing=True ) ``` diff --git a/src/platform-includes/performance/opentelemetry-setup/python.mdx b/src/platform-includes/performance/opentelemetry-setup/python.mdx index 7fb77b241da5e..fc4e925aef9d5 100644 --- a/src/platform-includes/performance/opentelemetry-setup/python.mdx +++ b/src/platform-includes/performance/opentelemetry-setup/python.mdx @@ -7,7 +7,8 @@ import sentry_sdk sentry_sdk.init( dsn="___PUBLIC_DSN___", - traces_sample_rate=1.0, + enable_tracing=True, + # set the instrumenter to use OpenTelemetry instead of Sentry instrumenter="otel", ) diff --git a/src/platform-includes/profiling/index/preface/_default.mdx b/src/platform-includes/profiling/index/preface/_default.mdx new file mode 100644 index 0000000000000..e69de29bb2d1d diff --git a/src/platform-includes/profiling/index/preface/go.mdx b/src/platform-includes/profiling/index/preface/go.mdx new file mode 100644 index 0000000000000..4d11b21e2e535 --- /dev/null +++ b/src/platform-includes/profiling/index/preface/go.mdx @@ -0,0 +1,5 @@ + + +Go Profiling is currently in alpha. Alpha features are still in progress and may have bugs. We recognize the irony. + + diff --git a/src/platform-includes/profiling/index/preface/react-native.mdx b/src/platform-includes/profiling/index/preface/react-native.mdx new file mode 100644 index 0000000000000..48563be3e4f77 --- /dev/null +++ b/src/platform-includes/profiling/index/preface/react-native.mdx @@ -0,0 +1,5 @@ + + +React Native Profiling is currently in beta. Beta features are still in progress and may have bugs. We recognize the irony. + + diff --git a/src/platform-includes/profiling/index/preface/ruby.mdx b/src/platform-includes/profiling/index/preface/ruby.mdx new file mode 100644 index 0000000000000..911b110ab5a88 --- /dev/null +++ b/src/platform-includes/profiling/index/preface/ruby.mdx @@ -0,0 +1,5 @@ + + +Ruby Profiling is currently in beta. Beta features are still in progress and may have bugs. We recognize the irony. + + diff --git a/src/platforms/common/performance/index.mdx b/src/platforms/common/performance/index.mdx index ae484f48ee977..35c6c9ed039f4 100644 --- a/src/platforms/common/performance/index.mdx +++ b/src/platforms/common/performance/index.mdx @@ -65,8 +65,9 @@ Automatic instrumentation for monitoring the performance of your application is -## Configure the Sample Rate +## Configure + First, enable tracing and configure the sampling rate for transactions. Set the sample rate for your transactions by either: - Setting a uniform sample rate for all transactions using the option in your SDK config to a number between `0` and `1`. (For example, to send 20% of transactions, set to `0.2`.) @@ -74,6 +75,8 @@ First, enable tracing and configure the sampling rate for transactions. Set the The two options are meant to be mutually exclusive. If you set both, will take precedence. + + @@ -86,8 +89,9 @@ The Native SDK doesn't currently support sampling functions ( -Learn more about how the options work in Sampling Transactions. +Learn more about performance monitoring options, or how to sample transactions. + ## Verify @@ -178,6 +182,8 @@ After you set up Relay, you should see a dramatic improvement to the impact on y -**Next Steps:** + + +## Next Steps diff --git a/src/platforms/common/profiling/index.mdx b/src/platforms/common/profiling/index.mdx index e28dbb532c8ef..a500df1d4cd47 100644 --- a/src/platforms/common/profiling/index.mdx +++ b/src/platforms/common/profiling/index.mdx @@ -29,35 +29,7 @@ notSupported: description: "Learn how to enable profiling in your app if it is not already set up." --- - - - - -React Native Profiling is currently in beta. Beta features are still in progress and may have bugs. We recognize the irony. - - - - - - - - - -Go Profiling is currently in alpha. Alpha features are still in progress and may have bugs. We recognize the irony. - - - - - - - - - -Ruby Profiling is currently in beta. Beta features are still in progress and may have bugs. We recognize the irony. - - - - + With [profiling](/product/profiling/), Sentry allows you to collect and analyze performance profiles from real user devices in production to give you a complete picture of how your application performs in a variety of environments. diff --git a/src/platforms/python/integrations/aiohttp/aiohttp-client.mdx b/src/platforms/python/integrations/aiohttp/aiohttp-client.mdx index f383f0b02681f..dbde756ecb82c 100644 --- a/src/platforms/python/integrations/aiohttp/aiohttp-client.mdx +++ b/src/platforms/python/integrations/aiohttp/aiohttp-client.mdx @@ -29,6 +29,8 @@ from sentry_sdk.integrations.aiohttp import AioHttpIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", + # Enable performance monitoring + enable_tracing=True, integrations=[ AioHttpIntegration(), ], diff --git a/src/platforms/python/integrations/aiohttp/index.mdx b/src/platforms/python/integrations/aiohttp/index.mdx index 17f0151ee2108..5e46cf5308a9a 100644 --- a/src/platforms/python/integrations/aiohttp/index.mdx +++ b/src/platforms/python/integrations/aiohttp/index.mdx @@ -34,9 +34,7 @@ import sentry_sdk sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True ) ``` @@ -85,6 +83,7 @@ from sentry_sdk.integrations.aiohttp import AioHttpIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", + enable_tracing=True, integrations=[ AioHttpIntegration( transaction_style="method_and_path_pattern", diff --git a/src/platforms/python/integrations/ariadne/index.mdx b/src/platforms/python/integrations/ariadne/index.mdx index 6c2cc57b4a0d5..14a1170dfdb89 100644 --- a/src/platforms/python/integrations/ariadne/index.mdx +++ b/src/platforms/python/integrations/ariadne/index.mdx @@ -27,9 +27,6 @@ from sentry_sdk.integrations.ariadne import AriadneIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, integrations=[ AriadneIntegration(), ], diff --git a/src/platforms/python/integrations/arq/index.mdx b/src/platforms/python/integrations/arq/index.mdx index 7e8386d162d95..660da8eb2fe9e 100644 --- a/src/platforms/python/integrations/arq/index.mdx +++ b/src/platforms/python/integrations/arq/index.mdx @@ -17,7 +17,7 @@ pip install --upgrade "sentry-sdk[arq]" -Add `ArqIntegration()` to your `integrations` list: +Add `ArqIntegration()` to your `integrations` list and make sure that tracing is enabled: ```python import sentry_sdk @@ -25,9 +25,7 @@ from sentry_sdk.integrations.arq import ArqIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, integrations=[ ArqIntegration(), ], diff --git a/src/platforms/python/integrations/asgi/index.mdx b/src/platforms/python/integrations/asgi/index.mdx index 9401b67720c68..7aacccc3503cd 100644 --- a/src/platforms/python/integrations/asgi/index.mdx +++ b/src/platforms/python/integrations/asgi/index.mdx @@ -29,10 +29,7 @@ from my_asgi_app import app sentry_sdk.init( dsn="___PUBLIC_DSN___", - - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True ) app = SentryAsgiMiddleware(app) diff --git a/src/platforms/python/integrations/asyncio/index.mdx b/src/platforms/python/integrations/asyncio/index.mdx index 00a9ff2f31558..fed9d12630ca3 100644 --- a/src/platforms/python/integrations/asyncio/index.mdx +++ b/src/platforms/python/integrations/asyncio/index.mdx @@ -3,7 +3,7 @@ title: asyncio description: "Learn about the asyncio integration and how it adds support for applications the asyncio module." --- -The `AsyncioIntegration` integrates with applications doing concurrent code execution using Pythons [asyncio](https://docs.python.org/3/library/asyncio.html) module. +The `AsyncioIntegration` integrates with applications doing concurrent code execution using Python's [asyncio](https://docs.python.org/3/library/asyncio.html) module. ## Install @@ -13,7 +13,7 @@ pip install --upgrade 'sentry-sdk' ## Configure -Add `AsyncioIntegration()` to your list of `integrations` and be sure to call `sentry_sdk.init()` at the beginning of your async loop: +Add `AsyncioIntegration()` to your list of `integrations`, enable tracing and be sure to call `sentry_sdk.init()` at the beginning of your async loop: @@ -24,9 +24,7 @@ from sentry_sdk.integrations.asyncio import AsyncioIntegration async def main(): sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, integrations=[ AsyncioIntegration(), ], diff --git a/src/platforms/python/integrations/asyncpg/index.mdx b/src/platforms/python/integrations/asyncpg/index.mdx index 3b280e623d9ac..7005f978bc888 100644 --- a/src/platforms/python/integrations/asyncpg/index.mdx +++ b/src/platforms/python/integrations/asyncpg/index.mdx @@ -3,7 +3,7 @@ title: asyncpg description: "Learn about importing the asyncpg integration and how it captures queries from asyncpg." --- -The asyncpg integration captures queries from +The `AsyncPGIntegration` captures queries from [asyncpg](https://github.com/MagicStack/asyncpg), which can be viewed in Sentry's **Performance** page. ## Install @@ -16,7 +16,7 @@ pip install --upgrade sentry-sdk[asyncpg] ## Configure -Add `AsyncPGIntegration()` to your `integrations` list: +Add `AsyncPGIntegration()` to your `integrations` list, and enable tracing: @@ -26,9 +26,7 @@ from sentry_sdk.integrations.asyncpg import AsyncPGIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, integrations=[ AsyncPGIntegration(), ], diff --git a/src/platforms/python/integrations/aws-lambda/container-image/index.mdx b/src/platforms/python/integrations/aws-lambda/container-image/index.mdx index 6834e4473ce50..8f412f5a3854c 100644 --- a/src/platforms/python/integrations/aws-lambda/container-image/index.mdx +++ b/src/platforms/python/integrations/aws-lambda/container-image/index.mdx @@ -19,13 +19,13 @@ Set your image’s CMD value to the Sentry Handler: CMD ["sentry_sdk.integrations.init_serverless_sdk.sentry_lambda_handler"] ``` -Also, set the following environment variables in AWS: +Next, set the following environment variables in AWS: - Set `SENTRY_INITIAL_HANDLER` to the path of your function handler - Set `SENTRY_DSN` to your Sentry DSN - Set `SENTRY_TRACES_SAMPLE_RATE` to your preferred [sampling rate](/platforms/python/configuration/sampling/#sampling-transaction-events) for transactions -Alternatively, you can also set the environment variables in the Dockerfile: +Alternatively, you can also set the environment variables in your Dockerfile. Values set in AWS override the values in a Dockerfile if both are provided. @@ -34,9 +34,3 @@ ENV SENTRY_INITIAL_HANDLER="" ENV SENTRY_DSN="___PUBLIC_DSN___" ENV SENTRY_TRACES_SAMPLE_RATE="1.0" ``` - - - -The values you set in AWS override the value in the Dockerfile if both are set. - - diff --git a/src/platforms/python/integrations/aws-lambda/index.mdx b/src/platforms/python/integrations/aws-lambda/index.mdx index 71ab169ea2cf5..4c068dc2c340a 100644 --- a/src/platforms/python/integrations/aws-lambda/index.mdx +++ b/src/platforms/python/integrations/aws-lambda/index.mdx @@ -33,14 +33,10 @@ from sentry_sdk.integrations.aws_lambda import AwsLambdaIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", + enable_tracing=True, integrations=[ AwsLambdaIntegration(), - ], - - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - # We recommend adjusting this value in production, - traces_sample_rate=1.0, + ] ) def my_function(event, context): @@ -57,8 +53,7 @@ If you are using another web framework inside of AWS Lambda, the framework might ## Timeout Warning -The timeout warning reports an issue when the function execution time is near -the [configured timeout](https://docs.aws.amazon.com/lambda/latest/dg/configuration-console.html). +The timeout warning reports an issue when the function execution time is near the [configured timeout](https://docs.aws.amazon.com/lambda/latest/dg/configuration-console.html). To enable the warning, update the SDK initialization to set `timeout_warning` to `true`: @@ -68,14 +63,12 @@ To enable the warning, update the SDK initialization to set `timeout_warning` to ```python sentry_sdk.init( dsn="___PUBLIC_DSN___", + enable_tracing=True, integrations=[ - AwsLambdaIntegration(timeout_warning=True), + AwsLambdaIntegration( + timeout_warning=True + ), ], - - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - # We recommend adjusting this value in production, - traces_sample_rate=1.0, ) ``` diff --git a/src/platforms/python/integrations/beam/index.mdx b/src/platforms/python/integrations/beam/index.mdx index 61a8c8cf777ee..e9840b0a24fbb 100644 --- a/src/platforms/python/integrations/beam/index.mdx +++ b/src/platforms/python/integrations/beam/index.mdx @@ -5,9 +5,9 @@ redirect_from: description: "Learn about using Sentry with Beam." --- -The Beam integration currently parses the functions in [ParDo](https://github.com/apache/beam/blob/release-2.13.0/sdks/python/apache_beam/transforms/core.py#L991) to return exceptions in their respective setup, start_bundle, process, and finish_bundle functions. +The Beam integration currently parses the functions in [ParDo](https://github.com/apache/beam/blob/release-2.13.0/sdks/python/apache_beam/transforms/core.py#L991) to return exceptions in their respective `setup`, `start_bundle`, `process`, and `finish_bundle` functions. -**This integration is experimental.** It may be removed in minor versions. When enabling this integration, expect to see incorrect server_name and ip due to some distributed properties within Beam. +**This integration is experimental.** It may be removed in minor versions. When enabling this integration, expect to see incorrect `server_name` and `ip` due to some distributed properties within Beam. A Beam version of 2.12 or later is required. @@ -21,14 +21,10 @@ from sentry_sdk.integrations.beam import BeamIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", + enable_tracing=True, integrations=[ BeamIntegration(), ], - - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - # We recommend adjusting this value in production, - traces_sample_rate=1.0, ) ``` diff --git a/src/platforms/python/integrations/boto3/index.mdx b/src/platforms/python/integrations/boto3/index.mdx index cbafbe95f5fb9..b397c25deebbf 100644 --- a/src/platforms/python/integrations/boto3/index.mdx +++ b/src/platforms/python/integrations/boto3/index.mdx @@ -24,9 +24,7 @@ Initialization should happen as early as possible in your application's lifecycl ```python sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True ) ``` diff --git a/src/platforms/python/integrations/bottle/index.mdx b/src/platforms/python/integrations/bottle/index.mdx index 5ae3920b42ec1..0c02a6e1fba90 100644 --- a/src/platforms/python/integrations/bottle/index.mdx +++ b/src/platforms/python/integrations/bottle/index.mdx @@ -30,9 +30,7 @@ import sentry_sdk sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True ) app = Bottle() @@ -79,12 +77,10 @@ from sentry_sdk.integrations.bottle import BottleIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, - integrations = [ + enable_tracing=True, + integrations=[ BottleIntegration( - transaction_style="endpoint", + transaction_style="endpoint", ), ], ) diff --git a/src/platforms/python/integrations/celery/crons.mdx b/src/platforms/python/integrations/celery/crons.mdx index d97700d0af901..01ebe57fa918b 100644 --- a/src/platforms/python/integrations/celery/crons.mdx +++ b/src/platforms/python/integrations/celery/crons.mdx @@ -38,13 +38,17 @@ from celery import signals import sentry_sdk from sentry_sdk.integrations.celery import CeleryIntegration - #@signals.beat_init.connect @signals.celeryd_init.connect def init_sentry(**kwargs): sentry_sdk.init( dsn='___PUBLIC_DSN___', - integrations=[CeleryIntegration(monitor_beat_tasks=True)], # 👈 + enable_tracing=True, + integrations=[ + CeleryIntegration( + monitor_beat_tasks=True + ) + ], environment="local.dev.grace", release="v1.0", ) @@ -67,18 +71,18 @@ You can exclude Celery Beat tasks from being auto-instrumented. To do this, add ```python - exclude_beat_tasks = [ - "some-task-a", - "payment-check-.*", - ] - sentry_sdk.init( dsn='___PUBLIC_DSN___', + enable_tracing=True, integrations=[ CeleryIntegration( monitor_beat_tasks=True, - exclude_beat_tasks=exclude_beat_tasks), - ], + exclude_beat_tasks=[ + "some-task-a", + "payment-check-.*", + ] + ), + ], environment="local.dev.grace", release="v1.0", ) @@ -107,15 +111,16 @@ from celery import Celery, signals import sentry_sdk from sentry_sdk.integrations.celery import CeleryIntegration - app = Celery('tasks', broker='...') - @signals.celeryd_init.connect def init_sentry(**kwargs): sentry_sdk.init( dsn='___PUBLIC_DSN___', - integrations=[CeleryIntegration()], + enable_tracing=True, + integrations=[ + CeleryIntegration() + ], environment="local.dev.grace", release="v1.0", ) diff --git a/src/platforms/python/integrations/celery/index.mdx b/src/platforms/python/integrations/celery/index.mdx index 739f3c805facb..c3176e2061b2b 100644 --- a/src/platforms/python/integrations/celery/index.mdx +++ b/src/platforms/python/integrations/celery/index.mdx @@ -30,9 +30,7 @@ import sentry_sdk sentry_sdk.init( dsn='___PUBLIC_DSN___', - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True ) ``` @@ -81,11 +79,15 @@ from sentry_sdk.integrations.celery import CeleryIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", + enable_tracing=True, # ... integrations=[ CeleryIntegration( monitor_beat_tasks=True, - exclude_beat_tasks=["unimportant-task", "payment-check-.*"], + exclude_beat_tasks=[ + "unimportant-task", + "payment-check-.*" + ], ), ], ) @@ -136,8 +138,11 @@ import sentry_sdk # Enable global distributed traces (this is the default, just to be explicit.) sentry_sdk.init( dsn="___PUBLIC_DSN___", + enable_tracing=True, integrations=[ - CeleryIntegration(propagate_traces=True), + CeleryIntegration( + propagate_traces=True + ), ], ) diff --git a/src/platforms/python/integrations/chalice/index.mdx b/src/platforms/python/integrations/chalice/index.mdx index 352674c33bdfe..c024ba85cee4d 100644 --- a/src/platforms/python/integrations/chalice/index.mdx +++ b/src/platforms/python/integrations/chalice/index.mdx @@ -25,9 +25,7 @@ from sentry_sdk.integrations.chalice import ChaliceIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, integrations=[ ChaliceIntegration(), ], diff --git a/src/platforms/python/integrations/clickhouse-driver/index.mdx b/src/platforms/python/integrations/clickhouse-driver/index.mdx index 13aa5424c164e..678c708486a15 100644 --- a/src/platforms/python/integrations/clickhouse-driver/index.mdx +++ b/src/platforms/python/integrations/clickhouse-driver/index.mdx @@ -27,9 +27,7 @@ from sentry_sdk.integrations.clickhouse_driver import ClickhouseDriverIntegratio sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, integrations=[ ClickhouseDriverIntegration(), ], diff --git a/src/platforms/python/integrations/cloudresourcecontext/index.mdx b/src/platforms/python/integrations/cloudresourcecontext/index.mdx index 5cdf210f40648..6d24355fde1c6 100644 --- a/src/platforms/python/integrations/cloudresourcecontext/index.mdx +++ b/src/platforms/python/integrations/cloudresourcecontext/index.mdx @@ -25,9 +25,7 @@ from sentry_sdk.integrations.cloud_resource_context import CloudResourceContextI sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, integrations=[ CloudResourceContextIntegration(), ], diff --git a/src/platforms/python/integrations/django/index.mdx b/src/platforms/python/integrations/django/index.mdx index dd0502a110522..8c00053b09733 100644 --- a/src/platforms/python/integrations/django/index.mdx +++ b/src/platforms/python/integrations/django/index.mdx @@ -36,11 +36,7 @@ import sentry_sdk sentry_sdk.init( dsn="___PUBLIC_DSN___", - - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - # We recommend adjusting this value in production, - traces_sample_rate=1.0, + enable_tracing=True, ) ``` @@ -80,7 +76,7 @@ The following parts of your Django project are monitored: -The parameter `traces_sample_rate` needs to be set when initializing the Sentry SDK for performance measurements to be recorded. +The parameter `enable_tracing` needs to be set when initializing the Sentry SDK for performance measurements to be recorded. diff --git a/src/platforms/python/integrations/falcon/index.mdx b/src/platforms/python/integrations/falcon/index.mdx index 7d05607999bb0..6c18af7cc130d 100644 --- a/src/platforms/python/integrations/falcon/index.mdx +++ b/src/platforms/python/integrations/falcon/index.mdx @@ -29,9 +29,7 @@ import sentry_sdk sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, ) api = falcon.API() @@ -80,12 +78,10 @@ from sentry_sdk.integrations.falcon import FalconIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, integrations = [ FalconIntegration( - transaction_style="path", + transaction_style="path", ), ], ) diff --git a/src/platforms/python/integrations/fastapi/index.mdx b/src/platforms/python/integrations/fastapi/index.mdx index 3a3de03c66e3f..56e108e21a07c 100644 --- a/src/platforms/python/integrations/fastapi/index.mdx +++ b/src/platforms/python/integrations/fastapi/index.mdx @@ -28,9 +28,7 @@ import sentry_sdk sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, ) app = FastAPI() @@ -80,7 +78,7 @@ The following parts of your FastAPI project are monitored: -The parameter `traces_sample_rate` needs to be set when initializing the Sentry SDK for performance measurements to be recorded. +The parameter `enable_tracing` needs to be set when initializing the Sentry SDK for performance measurements to be recorded. @@ -95,12 +93,14 @@ from sentry_sdk.integrations.fastapi import FastApiIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, integrations=[ - StarletteIntegration(transaction_style="endpoint",), - FastApiIntegration(transaction_style="endpoint",), + StarletteIntegration( + transaction_style="endpoint" + ), + FastApiIntegration( + transaction_style="endpoint" + ), ] ) ``` @@ -119,8 +119,12 @@ You can pass the following keyword arguments to `StarletteIntegration()` and `Fa sentry_sdk.init( # ... integrations=[ - StarletteIntegration(transaction_style="endpoint"), - FastApiIntegration(transaction_style="endpoint"), + StarletteIntegration( + transaction_style="endpoint" + ), + FastApiIntegration( + transaction_style="endpoint" + ), ], ) diff --git a/src/platforms/python/integrations/flask/index.mdx b/src/platforms/python/integrations/flask/index.mdx index ca20fa9c33a2e..54d7ae07d750e 100644 --- a/src/platforms/python/integrations/flask/index.mdx +++ b/src/platforms/python/integrations/flask/index.mdx @@ -27,9 +27,7 @@ import sentry_sdk sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, ) app = Flask(__name__) @@ -78,12 +76,10 @@ from sentry_sdk.integrations.flask import FlaskIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, integrations = [ FlaskIntegration( - transaction_style="url", + transaction_style="url", ), ], ) diff --git a/src/platforms/python/integrations/gcp-functions/index.mdx b/src/platforms/python/integrations/gcp-functions/index.mdx index c998ae599e632..5b6d7bf48d962 100644 --- a/src/platforms/python/integrations/gcp-functions/index.mdx +++ b/src/platforms/python/integrations/gcp-functions/index.mdx @@ -31,14 +31,10 @@ from sentry_sdk.integrations.gcp import GcpIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", + enable_tracing=True, integrations=[ GcpIntegration(), ], - - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - # We recommend adjusting this value in production, - traces_sample_rate=1.0, ) def http_function_entrypoint(request): @@ -66,14 +62,12 @@ To enable the warning, update the SDK initialization to set `timeout_warning` to ```python sentry_sdk.init( dsn="___PUBLIC_DSN___", + enable_tracing=True, integrations=[ - GcpIntegration(timeout_warning=True), + GcpIntegration( + timeout_warning=True + ), ], - - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - # We recommend adjusting this value in production, - traces_sample_rate=1.0, ) ``` diff --git a/src/platforms/python/integrations/graphene/index.mdx b/src/platforms/python/integrations/graphene/index.mdx index 78f19bea6f76f..ba08a35a8ab8f 100644 --- a/src/platforms/python/integrations/graphene/index.mdx +++ b/src/platforms/python/integrations/graphene/index.mdx @@ -27,9 +27,7 @@ from sentry_sdk.integrations.graphene import GrapheneIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, integrations=[ GrapheneIntegration(), ], diff --git a/src/platforms/python/integrations/grpc/index.mdx b/src/platforms/python/integrations/grpc/index.mdx index 0683d09d1f45b..ebddab6a6753d 100644 --- a/src/platforms/python/integrations/grpc/index.mdx +++ b/src/platforms/python/integrations/grpc/index.mdx @@ -33,9 +33,7 @@ from sentry_sdk.integrations.grpc.server import ServerInterceptor sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, ) ... @@ -56,9 +54,7 @@ from sentry_sdk.integrations.grpc.client import ClientInterceptor sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, ) ... diff --git a/src/platforms/python/integrations/httpx/index.mdx b/src/platforms/python/integrations/httpx/index.mdx index a76b8e354d311..236f9d820378b 100644 --- a/src/platforms/python/integrations/httpx/index.mdx +++ b/src/platforms/python/integrations/httpx/index.mdx @@ -24,9 +24,7 @@ import sentry_sdk sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, ) ``` diff --git a/src/platforms/python/integrations/huey/index.mdx b/src/platforms/python/integrations/huey/index.mdx index f8bf8ac6ade79..0c3919df8d4c1 100644 --- a/src/platforms/python/integrations/huey/index.mdx +++ b/src/platforms/python/integrations/huey/index.mdx @@ -26,12 +26,10 @@ from sentry_sdk.integrations.huey import HueyIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", + enable_tracing=True, integrations=[ HueyIntegration(), ], - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, ) ``` diff --git a/src/platforms/python/integrations/index.mdx b/src/platforms/python/integrations/index.mdx index 63e8c5067408e..e642fbf87cb4f 100644 --- a/src/platforms/python/integrations/index.mdx +++ b/src/platforms/python/integrations/index.mdx @@ -1,7 +1,7 @@ --- title: Integrations description: "Sentry provides additional integrations designed to change configuration or add instrumentation to your application." -sidebar_order: 4 +sidebar_order: 40 --- The Sentry SDK uses Integrations to hook into the functionality of popular libraries to automatically instrument your application and give you the best data out of the box. diff --git a/src/platforms/python/integrations/logging/index.mdx b/src/platforms/python/integrations/logging/index.mdx index eef0325b9c92d..c057037b7f0ec 100644 --- a/src/platforms/python/integrations/logging/index.mdx +++ b/src/platforms/python/integrations/logging/index.mdx @@ -26,10 +26,7 @@ The logging integrations is a default integration so it will be enabled automati import sentry_sdk sentry_sdk.init( - dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + dsn="___PUBLIC_DSN___" ) ``` @@ -66,9 +63,6 @@ from sentry_sdk.integrations.logging import LoggingIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, integrations=[ LoggingIntegration( level=logging.INFO, # Capture info and above as breadcrumbs diff --git a/src/platforms/python/integrations/pure_eval/index.mdx b/src/platforms/python/integrations/pure_eval/index.mdx index c586ac607cef5..0d2fc14b48db3 100644 --- a/src/platforms/python/integrations/pure_eval/index.mdx +++ b/src/platforms/python/integrations/pure_eval/index.mdx @@ -1,5 +1,5 @@ --- -title: Enhanced Locals +title: pure_eval description: "Learn about `pure_eval` and how to add it to your integrations list." --- diff --git a/src/platforms/python/integrations/pymongo/index.mdx b/src/platforms/python/integrations/pymongo/index.mdx index 6be460a439ae0..8649f4c9deb9d 100644 --- a/src/platforms/python/integrations/pymongo/index.mdx +++ b/src/platforms/python/integrations/pymongo/index.mdx @@ -25,9 +25,7 @@ from sentry_sdk.integrations.pymongo import PyMongoIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, integrations=[ PyMongoIntegration(), ], diff --git a/src/platforms/python/integrations/pyramid/index.mdx b/src/platforms/python/integrations/pyramid/index.mdx index 9703ef0a244ae..5c9cc266fd768 100644 --- a/src/platforms/python/integrations/pyramid/index.mdx +++ b/src/platforms/python/integrations/pyramid/index.mdx @@ -27,9 +27,7 @@ import sentry_sdk sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, ) from pyramid.config import Configurator @@ -90,9 +88,7 @@ from sentry_sdk.integrations.pyramid import PyramidIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, integrations=[ PyramidIntegration( transaction_style="route_pattern", diff --git a/src/platforms/python/integrations/quart/index.mdx b/src/platforms/python/integrations/quart/index.mdx index 24b6304976442..1aa747fb7a8e0 100644 --- a/src/platforms/python/integrations/quart/index.mdx +++ b/src/platforms/python/integrations/quart/index.mdx @@ -27,9 +27,7 @@ from sentry_sdk.integrations.quart import QuartIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, integrations=[ QuartIntegration(), ], diff --git a/src/platforms/python/integrations/redis/index.mdx b/src/platforms/python/integrations/redis/index.mdx index 627030d36e888..b1ed6d2e100f9 100644 --- a/src/platforms/python/integrations/redis/index.mdx +++ b/src/platforms/python/integrations/redis/index.mdx @@ -23,9 +23,7 @@ from sentry_sdk.integrations.redis import RedisIntegration sentry_sdk.init( dsn='___PUBLIC_DSN___', - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, ) ``` @@ -116,8 +114,11 @@ from sentry_sdk.integrations.redis import RedisIntegration sentry_sdk.init( dsn='___PUBLIC_DSN___', + enable_tracing=True, integrations=[ - RedisIntegration(max_data_size=None), + RedisIntegration( + max_data_size=None + ), ] ) ``` @@ -132,8 +133,11 @@ from sentry_sdk.integrations.redis import RedisIntegration sentry_sdk.init( dsn='___PUBLIC_DSN___', + enable_tracing=True, integrations=[ - RedisIntegration(max_data_size=50), + RedisIntegration( + max_data_size=50 + ), ] ) ``` diff --git a/src/platforms/python/integrations/rq/index.mdx b/src/platforms/python/integrations/rq/index.mdx index fc026e37f46d5..5a6f723c0b9a5 100644 --- a/src/platforms/python/integrations/rq/index.mdx +++ b/src/platforms/python/integrations/rq/index.mdx @@ -29,10 +29,8 @@ Create a file called `mysettings.py` with the following content: import sentry_sdk sentry_sdk.init( - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, dsn="___PUBLIC_DSN___", + enable_tracing=True, ) ``` @@ -58,9 +56,7 @@ import sentry_sdk sentry_sdk.init( dsn=___PUBLIC_DSN___, - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, ) ``` @@ -94,9 +90,7 @@ import sentry_sdk # Sentry configuration for RQ worker processes sentry_sdk.init( dsn=___PUBLIC_DSN___, - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, ) ``` @@ -114,9 +108,7 @@ import sentry_sdk # Sentry configuration for main.py process sentry_sdk.init( dsn=___PUBLIC_DSN___, - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, ) q = Queue(connection=Redis()) diff --git a/src/platforms/python/integrations/sanic/index.mdx b/src/platforms/python/integrations/sanic/index.mdx index 934854a043681..69f95c48ef154 100644 --- a/src/platforms/python/integrations/sanic/index.mdx +++ b/src/platforms/python/integrations/sanic/index.mdx @@ -33,9 +33,7 @@ import sentry_sdk sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, ) app = Sanic(__name__) @@ -54,15 +52,15 @@ from sentry_sdk.integrations.sanic import SanicIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", - - # Configure the Sanic integration so that we - # generate transactions for all HTTP statuses, - # including 404 - integrations=[SanicIntegration(unsampled_statuses=None)] - - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, + + # Configure the Sanic integration so that we generate + # transactions for all HTTP status codes, including 404 + integrations=[ + SanicIntegration( + unsampled_statuses=None + ) + ] ) ``` diff --git a/src/platforms/python/integrations/serverless/index.mdx b/src/platforms/python/integrations/serverless/index.mdx index ffcb396fe9daa..24a74e35b0fd8 100644 --- a/src/platforms/python/integrations/serverless/index.mdx +++ b/src/platforms/python/integrations/serverless/index.mdx @@ -37,10 +37,8 @@ import sentry_sdk from sentry_sdk.integrations.serverless import serverless_function sentry_sdk.init( - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, dsn="___PUBLIC_DSN___", + enable_tracing=True, ) @serverless_function diff --git a/src/platforms/python/integrations/socket/index.mdx b/src/platforms/python/integrations/socket/index.mdx index 9b145fba99cab..7e78dd9651197 100644 --- a/src/platforms/python/integrations/socket/index.mdx +++ b/src/platforms/python/integrations/socket/index.mdx @@ -25,9 +25,7 @@ from sentry_sdk.integrations.socket import SocketIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, integrations=[ SocketIntegration(), ], diff --git a/src/platforms/python/integrations/spark/index.mdx b/src/platforms/python/integrations/spark/index.mdx index 1c07d4cefdfeb..4cb033d831fef 100644 --- a/src/platforms/python/integrations/spark/index.mdx +++ b/src/platforms/python/integrations/spark/index.mdx @@ -25,14 +25,10 @@ from sentry_sdk.integrations.spark import SparkIntegration if __name__ == "__main__": sentry_sdk.init( dsn="___PUBLIC_DSN___", + enable_tracing=True, integrations=[ SparkIntegration(), ], - - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - # We recommend adjusting this value in production, - traces_sample_rate=1.0, ) spark = SparkSession\ @@ -58,14 +54,10 @@ import pyspark.daemon as original_daemon if __name__ == '__main__': sentry_sdk.init( dsn="___PUBLIC_DSN___", + enable_tracing=True, integrations=[ SparkWorkerIntegration(), ], - - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - # We recommend adjusting this value in production, - traces_sample_rate=1.0, ) original_daemon.manager() diff --git a/src/platforms/python/integrations/sqlalchemy/index.mdx b/src/platforms/python/integrations/sqlalchemy/index.mdx index 63c5f3178e157..3bc9213aba1f4 100644 --- a/src/platforms/python/integrations/sqlalchemy/index.mdx +++ b/src/platforms/python/integrations/sqlalchemy/index.mdx @@ -22,9 +22,7 @@ import sentry_sdk sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, ) ``` diff --git a/src/platforms/python/integrations/starlette/index.mdx b/src/platforms/python/integrations/starlette/index.mdx index acf790876167b..47691fc137c8b 100644 --- a/src/platforms/python/integrations/starlette/index.mdx +++ b/src/platforms/python/integrations/starlette/index.mdx @@ -27,10 +27,8 @@ from starlette.applications import Starlette import sentry_sdk sentry_sdk.init( - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, dsn="___PUBLIC_DSN___", + enable_tracing=True, ) app = Starlette(routes=[...]) @@ -62,7 +60,7 @@ It takes a couple of moments for the data to appear in [sentry.io](https://sentr - Request data is attached to all events: **HTTP method, URL, headers, form data, JSON payloads**. Sentry excludes raw bodies and multipart file uploads. Sentry also excludes personally identifiable information (such as user ids, usernames, cookies, authorization headers, IP addresses) unless you set `send_default_pii` to `True`. -- If a `traces_sample_rate` is set, then performance information is also reported, which you can see on the **Performance** page of [sentry.io](https://sentry.io). +- If `enable_tracing` or a `traces_sample_rate` is set, then performance information is also reported, which you can see on the **Performance** page of [sentry.io](https://sentry.io). ## Options @@ -73,9 +71,7 @@ from sentry_sdk.integrations.starlette import StarletteIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, integrations=[ StarletteIntegration( transaction_style="endpoint", @@ -88,7 +84,7 @@ You can pass the following keyword arguments to `StarletteIntegration()`: - `transaction_style`: - ``` + ```python async def product_detail(request): return JSONResponse({...}) diff --git a/src/platforms/python/integrations/strawberry/index.mdx b/src/platforms/python/integrations/strawberry/index.mdx index 98abde034cd61..66f27b4eb81a0 100644 --- a/src/platforms/python/integrations/strawberry/index.mdx +++ b/src/platforms/python/integrations/strawberry/index.mdx @@ -27,12 +27,13 @@ from sentry_sdk.integrations.strawberry import StrawberryIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, integrations=[ - # Set async_execution to True if you have at least one async resolver - StrawberryIntegration(async_execution=True), + StrawberryIntegration( + # Set async_execution to True if you have + # at least one async resolver + async_execution=True + ), ], ) ``` @@ -98,7 +99,9 @@ based on installed web frameworks. sentry_sdk.init( # (...) other options integrations=[ - StrawberryIntegration(async_execution=True), # or False + StrawberryIntegration( + async_execution=True # or False + ), ], ) ``` diff --git a/src/platforms/python/integrations/tornado/index.mdx b/src/platforms/python/integrations/tornado/index.mdx index 0a7bedf454f4f..c748fdc34a0b3 100644 --- a/src/platforms/python/integrations/tornado/index.mdx +++ b/src/platforms/python/integrations/tornado/index.mdx @@ -33,9 +33,7 @@ import sentry_sdk sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, ) class MainHandler(tornado.web.RequestHandler): diff --git a/src/platforms/python/integrations/tryton/index.mdx b/src/platforms/python/integrations/tryton/index.mdx index d258fcaa1f980..8c835904964ca 100644 --- a/src/platforms/python/integrations/tryton/index.mdx +++ b/src/platforms/python/integrations/tryton/index.mdx @@ -20,9 +20,7 @@ from sentry_sdk.integrations.trytond import TrytondWSGIIntegration sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, integrations=[ TrytondWSGIIntegration(), ], diff --git a/src/platforms/python/integrations/wsgi/index.mdx b/src/platforms/python/integrations/wsgi/index.mdx index 18da5d80c916e..bdaa945c1e475 100644 --- a/src/platforms/python/integrations/wsgi/index.mdx +++ b/src/platforms/python/integrations/wsgi/index.mdx @@ -29,9 +29,7 @@ from my_wsgi_app import app sentry_sdk.init( dsn="___PUBLIC_DSN___", - # Set traces_sample_rate to 1.0 to capture 100% - # of transactions for performance monitoring. - traces_sample_rate=1.0, + enable_tracing=True, ) app = SentryWsgiMiddleware(app) From 62230bba28a05847f6775fc351a313f0461337db Mon Sep 17 00:00:00 2001 From: Sentry Release Bot <75840458+getsentry-release@users.noreply.github.com> Date: Thu, 26 Oct 2023 10:40:42 -0700 Subject: [PATCH 4/6] Bump API schema to 44624054 (#8338) Co-authored-by: openapi-getsentry-bot --- src/gatsby/utils/resolveOpenAPI.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/gatsby/utils/resolveOpenAPI.ts b/src/gatsby/utils/resolveOpenAPI.ts index f73d42361e39d..3b9dafdff0eb8 100644 --- a/src/gatsby/utils/resolveOpenAPI.ts +++ b/src/gatsby/utils/resolveOpenAPI.ts @@ -6,7 +6,7 @@ import {promises as fs} from 'fs'; // SENTRY_API_SCHEMA_SHA is used in the sentry-docs GHA workflow in getsentry/sentry-api-schema. // DO NOT change variable name unless you change it in the sentry-docs GHA workflow in getsentry/sentry-api-schema. -const SENTRY_API_SCHEMA_SHA = '8a5046b1467df8cd7ee2070de2876691fd3590ca'; +const SENTRY_API_SCHEMA_SHA = '4462405412748e2b763ff53c4c1ceb5e722c2b23'; const activeEnv = process.env.GATSBY_ENV || process.env.NODE_ENV || 'development'; From a5ab888c8decc7fd1de394065e0645066699873e Mon Sep 17 00:00:00 2001 From: JGS3089 <145158937+JGS3089@users.noreply.github.com> Date: Thu, 26 Oct 2023 13:50:03 -0400 Subject: [PATCH 5/6] Update vercel.json - 1026 (#8334) --- vercel.json | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/vercel.json b/vercel.json index 60fef0b73d198..281c71e2f12f9 100644 --- a/vercel.json +++ b/vercel.json @@ -860,6 +860,10 @@ "source": "/platforms/apple/guides/watchos/configuration/integrations/", "destination": "/platforms/apple/guides/watchos/integrations/" }, + { + "source": "/platforms/javascript/guides/remix/install/cdn/", + "destination": "/platforms/javascript/guides/remix/#install" + }, { "source": "/platforms/apple/guides/([^/]*)/configuration/integrations/([^/]*)/", "destination": "/platforms/apple/guides/$1/integrations/$2/" From 7a28d08b24be281718610e90ece87ae2f44a8bc0 Mon Sep 17 00:00:00 2001 From: JGS3089 <145158937+JGS3089@users.noreply.github.com> Date: Thu, 26 Oct 2023 13:52:07 -0400 Subject: [PATCH 6/6] Update vercel.json - 10261 (#8335) --- vercel.json | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/vercel.json b/vercel.json index 281c71e2f12f9..017a9642ed28a 100644 --- a/vercel.json +++ b/vercel.json @@ -864,6 +864,14 @@ "source": "/platforms/javascript/guides/remix/install/cdn/", "destination": "/platforms/javascript/guides/remix/#install" }, + { + "source": "/platforms/javascript/guides/vue/errors/context/", + "destination": "/platforms/javascript/guides/vue/" + }, + { + "source": "/platforms/javascript/guides/vue/errors/", + "destination": "/platforms/javascript/guides/vue/" + }, { "source": "/platforms/apple/guides/([^/]*)/configuration/integrations/([^/]*)/", "destination": "/platforms/apple/guides/$1/integrations/$2/"