123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109 |
- import ExternalLink from 'sentry/components/links/externalLink';
- import {Layout, LayoutProps} from 'sentry/components/onboarding/gettingStartedDoc/layout';
- import {ModuleProps} from 'sentry/components/onboarding/gettingStartedDoc/sdkDocumentation';
- import {StepType} from 'sentry/components/onboarding/gettingStartedDoc/step';
- import {t, tct} from 'sentry/locale';
- // Configuration Start
- export const steps = ({
- dsn,
- }: {
- dsn?: string;
- } = {}): LayoutProps['steps'] => [
- {
- type: StepType.INSTALL,
- description: (
- <p>
- {tct(
- 'The Flask integration adds support for the [flaskWebFrameworkLink:Flask Web Framework].',
- {
- flaskWebFrameworkLink: (
- <ExternalLink href="https://flask.palletsprojects.com/en/2.3.x/" />
- ),
- }
- )}
- </p>
- ),
- configurations: [
- {
- language: 'bash',
- description: (
- <p>
- {tct(
- 'Install [sentrySdkCode:sentry-sdk] from PyPI with the [sentryFlaskCode:flask] extra:',
- {
- sentrySdkCode: <code />,
- sentryFlaskCode: <code />,
- }
- )}
- </p>
- ),
- code: "pip install --upgrade 'sentry-sdk[flask]'",
- },
- ],
- },
- {
- type: StepType.CONFIGURE,
- description: t(
- 'To configure the SDK, initialize it with the integration before or after your app has been initialized:'
- ),
- configurations: [
- {
- language: 'python',
- code: `
- import sentry_sdk
- from flask import Flask
- from sentry_sdk.integrations.flask import FlaskIntegration
- sentry_sdk.init(
- dsn="${dsn}",
- integrations=[
- FlaskIntegration(),
- ],
- # 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
- )
- app = Flask(__name__)
- `,
- },
- ],
- additionalInfo: (
- <p>
- {tct(
- 'The above configuration captures both error and performance data. To reduce the volume of performance data captured, change [code:traces_sample_rate] to a value between 0 and 1.',
- {code: <code />}
- )}
- </p>
- ),
- },
- {
- type: StepType.VERIFY,
- description: t(
- 'You can easily verify your Sentry installation by creating a route that triggers an error:'
- ),
- configurations: [
- {
- language: 'python',
- code: `
- @app.route('/debug-sentry')
- def trigger_error():
- division_by_zero = 1 / 0
- `,
- },
- ],
- additionalInfo: t(
- 'Visiting this route will trigger an error that will be captured by Sentry.'
- ),
- },
- ];
- // Configuration End
- export function GettingStartedWithFlask({dsn, ...props}: ModuleProps) {
- return <Layout steps={steps({dsn})} {...props} />;
- }
- export default GettingStartedWithFlask;
|