Python client for Sentry (https://sentry.io)
Project description
Bad software is everywhere, and we're tired of it. Sentry is on a mission to help developers write better software faster, so we can get back to enjoying technology. If you want to join us, check out our open positions.
Official Sentry SDK for Python
This is the official Python SDK for Sentry
Getting Started
Install
pip install --upgrade sentry-sdk
Configuration
import sentry_sdk
sentry_sdk.init(
"https://12927b5f211046b575ee51fd8b1ac34f@o1.ingest.sentry.io/1",
# Set traces_sample_rate to 1.0 to capture 100%
# of transactions for performance monitoring.
traces_sample_rate=1.0,
)
Usage
from sentry_sdk import capture_message
capture_message("Hello World") # Will create an event in Sentry.
raise ValueError() # Will also create an event in Sentry.
- To learn more about how to use the SDK refer to our docs.
- Are you coming from
raven-python
? Use this migration guide. - To learn about internals use the API Reference.
Integrations
(If you want to create a new integration, have a look at the Adding a new integration checklist.)
See the documentation for an up-to-date list of libraries and frameworks we support. Here are some examples:
- Django
- Flask
- FastAPI
- AIOHTTP
- SQLAlchemy
- asyncpg
- Redis
- Celery
- Apache Airflow
- Apache Spark
- asyncio
- Graphene
- Logging
- Loguru
- HTTPX
- AWS Lambda
- Google Cloud Functions
Migrating
Migrating From 1.x
to 2.x
If you're on SDK version 1.x, we highly recommend updating to the 2.x major. To make the process easier we've prepared a migration guide with the most common changes as well as a detailed changelog.
Migrating From raven-python
The old raven-python
client has entered maintenance mode and was moved here.
If you're using raven-python
, we recommend you to migrate to this new SDK. You can find the benefits of migrating and how to do it in our migration guide.
Contributing to the SDK
Please refer to CONTRIBUTING.md.
Getting Help/Support
If you need help setting up or configuring the Python SDK (or anything else in the Sentry universe) please head over to the Sentry Community on Discord. There is a ton of great people in our Discord community ready to help you!
Resources
License
Licensed under the MIT license, see LICENSE
Thanks to all the people who contributed!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for sentry_sdk-2.16.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 49139c31ebcd398f4f6396b18910610a0c1602f6e67083240c33019d1f6aa30c |
|
MD5 | 35d6f8d7c2e2d229a88611c5c8643fb1 |
|
BLAKE2b-256 | b3aa9f8dce2aec2e95d48c057ff3bcac48958cd15f67d4e9e80e74b46c324abf |