Google Cloud Functions
Add the Sentry SDK to your requirements.txt
:
requirements.txt
sentry-sdk>=0.17.1
The GCP integration currently supports only the Python 3.7
runtime environment. If you try to run it with a newer version (such as 3.9
), an error message will be displayed (with debug mode on).
Limited Sentry support is available on newer Python runtimes by directly enabling integrations for supported frameworks and/or using the generic serverless integration.
You can use the Google Cloud Functions integration for the Python SDK like this:
import sentry_sdk
from sentry_sdk.integrations.gcp import GcpIntegration
sentry_sdk.init(
dsn="https://examplePublicKey@o0.ingest.sentry.io/0",
enable_tracing=True,
integrations=[
GcpIntegration(),
],
)
def http_function_entrypoint(request):
# ...
Check out Sentry's GCP sample apps for detailed examples.
Note
If you are using a web framework inside of 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 the Python main page for more information.
The timeout warning reports an issue when the function execution time is near the configured timeout.
To enable the warning, update the SDK initialization to set timeout_warning
to true
:
sentry_sdk.init(
dsn="https://examplePublicKey@o0.ingest.sentry.io/0",
enable_tracing=True,
integrations=[
GcpIntegration(
timeout_warning=True
),
],
)
The timeout warning is sent only if the timeout in the Cloud Function configuration is set to a value greater than one second.
With the Google Cloud Functions integration enabled, the Python SDK will:
Automatically report all events from your Cloud Functions
You can modify the transaction sample rate using
traces_sample_rate
.Issues reports automatically include:
- A link to the stackdriver logs
- Function details
sys.argv
for the function- Function execution time (in milliseconds)
- Function configured time (in seconds)
- You can add more data as described here
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
toTrue
.Each request has a separate scope. Changes to the scope within a view, for example setting a tag, will only apply to events sent as part of the request being handled.
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").
- Package:
- pypi:sentry-sdk
- Version:
- 2.0.0
- Repository:
- https://github.com/getsentry/sentry-python
- API Documentation:
- https://getsentry.github.io/sentry-python/