_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**](https://sentry.io/careers/)_ # Official Sentry SDK for Python [](https://travis-ci.com/getsentry/sentry-python) [](https://pypi.python.org/pypi/sentry-sdk) [](https://discord.gg/cWnMQeA) This is the official Python SDK for [Sentry](http://sentry.io/) --- ## Getting Started ### Install ```bash pip install --upgrade sentry-sdk ``` ### Configuration ```python 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. # We recommend adjusting this value in production. traces_sample_rate=1.0, ) ``` ### Usage ```python 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](https://docs.sentry.io/platforms/python/) - Are you coming from raven-python? [Use this migration guide](https://docs.sentry.io/platforms/python/migration/) - To learn about internals use the [API Reference](https://getsentry.github.io/sentry-python/) ## Integrations (If you want to create a new integration have a look at the [Adding a new integration checklist](CONTRIBUTING.md#adding-a-new-integration-checklist).) - [Django](https://docs.sentry.io/platforms/python/guides/django/) - [Flask](https://docs.sentry.io/platforms/python/guides/flask/) - [Bottle](https://docs.sentry.io/platforms/python/guides/bottle/) - [AWS Lambda](https://docs.sentry.io/platforms/python/guides/aws-lambda/) - [Google Cloud Functions](https://docs.sentry.io/platforms/python/guides/gcp-functions/) - [WSGI](https://docs.sentry.io/platforms/python/guides/wsgi/) - [ASGI](https://docs.sentry.io/platforms/python/guides/asgi/) - [AIOHTTP](https://docs.sentry.io/platforms/python/guides/aiohttp/) - [RQ (Redis Queue)](https://docs.sentry.io/platforms/python/guides/rq/) - [Celery](https://docs.sentry.io/platforms/python/guides/celery/) - [Chalice](https://docs.sentry.io/platforms/python/guides/chalice/) - [Falcon](https://docs.sentry.io/platforms/python/guides/falcon/) - [Quart](https://docs.sentry.io/platforms/python/guides/quart/) - [Sanic](https://docs.sentry.io/platforms/python/guides/sanic/) - [Tornado](https://docs.sentry.io/platforms/python/guides/tornado/) - [Tryton](https://docs.sentry.io/platforms/python/guides/tryton/) - [Pyramid](https://docs.sentry.io/platforms/python/guides/pyramid/) - [Logging](https://docs.sentry.io/platforms/python/guides/logging/) - [Apache Airflow](https://docs.sentry.io/platforms/python/guides/airflow/) - [Apache Beam](https://docs.sentry.io/platforms/python/guides/beam/) - [Apache Spark](https://docs.sentry.io/platforms/python/guides/pyspark/) ## Migrate From sentry-raven The old `raven-python` client has entered maintenance mode and was moved [here](https://github.com/getsentry/raven-python). 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](https://docs.sentry.io/platforms/python/migration/). ## Contributing to the SDK Please refer to [CONTRIBUTING.md](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](https://discord.com/invite/Ww9hbqr). There is a ton of great people in our Discord community ready to help you! ## Resources - [](https://docs.sentry.io/quickstart/) - [](https://forum.sentry.io/c/sdks) - [](https://discord.gg/Ww9hbqr) - [](http://stackoverflow.com/questions/tagged/sentry) - [](https://twitter.com/intent/follow?screen_name=getsentry) ## License Licensed under the BSD license, see [`LICENSE`](LICENSE)