quart.tsx 3.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138
  1. import ExternalLink from 'sentry/components/links/externalLink';
  2. import {StepType} from 'sentry/components/onboarding/gettingStartedDoc/step';
  3. import type {
  4. Docs,
  5. DocsParams,
  6. OnboardingConfig,
  7. } from 'sentry/components/onboarding/gettingStartedDoc/types';
  8. import {getPythonMetricsOnboarding} from 'sentry/components/onboarding/gettingStartedDoc/utils/metricsOnboarding';
  9. import replayOnboardingJsLoader from 'sentry/gettingStartedDocs/javascript/jsLoader/jsLoader';
  10. import {crashReportOnboardingPython} from 'sentry/gettingStartedDocs/python/python';
  11. import {t, tct} from 'sentry/locale';
  12. type Params = DocsParams;
  13. const getInstallSnippet = () => `pip install --upgrade 'sentry-sdk[quart]'`;
  14. const getSdkSetupSnippet = (params: Params) => `
  15. import sentry_sdk
  16. from sentry_sdk.integrations.quart import QuartIntegration
  17. from quart import Quart
  18. sentry_sdk.init(
  19. dsn="${params.dsn}",
  20. integrations=[QuartIntegration()],${
  21. params.isPerformanceSelected
  22. ? `
  23. # Set traces_sample_rate to 1.0 to capture 100%
  24. # of transactions for performance monitoring.
  25. traces_sample_rate=1.0,`
  26. : ''
  27. }${
  28. params.isProfilingSelected
  29. ? `
  30. # Set profiles_sample_rate to 1.0 to profile 100%
  31. # of sampled transactions.
  32. # We recommend adjusting this value in production.
  33. profiles_sample_rate=1.0,`
  34. : ''
  35. }
  36. )
  37. `;
  38. const onboarding: OnboardingConfig = {
  39. introduction: () =>
  40. tct('The Quart integration adds support for the [link:Quart Web Framework].', {
  41. link: <ExternalLink href="https://quart.palletsprojects.com/" />,
  42. }),
  43. install: () => [
  44. {
  45. type: StepType.INSTALL,
  46. description: tct(
  47. 'Install [sentrySdkCode:sentry-sdk] from PyPI with the [sentryQuartCode:quart] extra:',
  48. {
  49. sentrySdkCode: <code />,
  50. sentryQuartCode: <code />,
  51. }
  52. ),
  53. configurations: [
  54. {
  55. language: 'bash',
  56. code: getInstallSnippet(),
  57. },
  58. ],
  59. },
  60. ],
  61. configure: (params: Params) => [
  62. {
  63. type: StepType.CONFIGURE,
  64. description: t(
  65. 'To configure the SDK, initialize it with the integration before or after your app has been initialized:'
  66. ),
  67. configurations: [
  68. {
  69. language: 'python',
  70. code: `
  71. ${getSdkSetupSnippet(params)}
  72. app = Quart(__name__)
  73. `,
  74. },
  75. ],
  76. },
  77. ],
  78. verify: (params: Params) => [
  79. {
  80. type: StepType.VERIFY,
  81. description: t(
  82. 'You can easily verify your Sentry installation by creating a route that triggers an error:'
  83. ),
  84. configurations: [
  85. {
  86. language: 'python',
  87. code: `
  88. ${getSdkSetupSnippet(params)}
  89. app = Quart(__name__)
  90. @app.route("/")
  91. async def hello():
  92. 1/0 # raises an error
  93. return {"hello": "world"}
  94. app.run()
  95. `,
  96. },
  97. ],
  98. additionalInfo: (
  99. <span>
  100. <p>
  101. {tct(
  102. 'When you point your browser to [link:http://localhost:5000/] a transaction in the Performance section of Sentry will be created.',
  103. {
  104. link: <ExternalLink href="http://localhost:5000/" />,
  105. }
  106. )}
  107. </p>
  108. <p>
  109. {t(
  110. 'Additionally, an error event will be sent to Sentry and will be connected to the transaction.'
  111. )}
  112. </p>
  113. <p>{t('It takes a couple of moments for the data to appear in Sentry.')}</p>
  114. </span>
  115. ),
  116. },
  117. ],
  118. nextSteps: () => [],
  119. };
  120. const docs: Docs = {
  121. onboarding,
  122. replayOnboardingJsLoader,
  123. customMetricsOnboarding: getPythonMetricsOnboarding({
  124. installSnippet: getInstallSnippet(),
  125. }),
  126. crashReportOnboarding: crashReportOnboardingPython,
  127. };
  128. export default docs;