import {Fragment} from 'react'; import styled from '@emotion/styled'; import Alert from 'sentry/components/alert'; 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 {ProductSolution} from 'sentry/components/onboarding/productSelection'; import {t, tct} from 'sentry/locale'; import {space} from 'sentry/styles/space'; // Configuration Start const profilingConfiguration = ` # Set profiles_sample_rate to 1.0 to profile 100% # of sampled transactions. # We recommend adjusting this value in production. profiles_sample_rate=1.0,`; const performanceConfiguration = ` # 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,`; export const steps = ({ dsn, sentryInitContent, }: { dsn: string; sentryInitContent: string; }): LayoutProps['steps'] => [ { type: StepType.INSTALL, description: (

{tct('Install our Python SDK using [code:pip]:', {code: })}

), configurations: [ { language: 'bash', code: 'pip install --upgrade sentry-sdk', }, ], }, { type: StepType.CONFIGURE, description: t( 'You can use the Google Cloud Functions integration for the Python SDK like this:' ), configurations: [ { language: 'python', code: ` import sentry_sdk from sentry_sdk.integrations.gcp import GcpIntegration sentry_sdk.init( ${sentryInitContent} ) def http_function_entrypoint(request): ... `, }, ], additionalInfo: (

{tct("Check out Sentry's [link:GCP sample apps] for detailed examples.", { link: ( ), })}

), }, { title: t('Timeout Warning'), description: (

{tct( 'The timeout warning reports an issue when the function execution time is near the [link:configured timeout].', { link: ( ), } )}

), configurations: [ { description: (

{tct( 'To enable the warning, update the SDK initialization to set [codeTimeout:timeout_warning] to [codeStatus:true]:', {codeTimeout: , codeStatus: } )}

), language: 'python', code: ` sentry_sdk.init( dsn="${dsn}", integrations=[ GcpIntegration(timeout_warning=True), ], ) `, }, ], additionalInfo: t( 'The timeout warning is sent only if the timeout in the Cloud Function configuration is set to a value greater than one second.' ), }, ]; // Configuration End export function GettingStartedWithGCPFunctions({ dsn, activeProductSelection = [], ...props }: ModuleProps) { const otherConfigs: string[] = []; let sentryInitContent: string[] = [ ` dsn="${dsn}",`, ` integrations=[GcpIntegration()],`, ]; if (activeProductSelection.includes(ProductSolution.PERFORMANCE_MONITORING)) { otherConfigs.push(performanceConfiguration); } if (activeProductSelection.includes(ProductSolution.PROFILING)) { otherConfigs.push(profilingConfiguration); } sentryInitContent = sentryInitContent.concat(otherConfigs); return ( {tct( 'If you are using a web framework in your Cloud Function, the framework might catch those exceptions before we get to see them. Make sure to enable the framework specific integration as well, if one exists. See [link:Integrations] for more information.', { link: ( ), } )} ); } export default GettingStartedWithGCPFunctions; const AlertWithMarginBottom = styled(Alert)` margin-top: ${space(2)}; margin-bottom: 0; `;