Source code
Revision control
Copy as Markdown
Other Tools
Metadata-Version: 2.1
Name: sentry-sdk
Version: 1.14.0
Author: Sentry Team and Contributors
Author-email: hello@sentry.io
License: BSD
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: certifi
Requires-Dist: urllib3 (>=1.25.7) ; python_version <= "3.4"
Requires-Dist: urllib3 (>=1.26.9) ; python_version == "3.5"
Requires-Dist: urllib3 (>=1.26.11) ; python_version >= "3.6"
Provides-Extra: aiohttp
Requires-Dist: aiohttp (>=3.5) ; extra == 'aiohttp'
Provides-Extra: beam
Requires-Dist: apache-beam (>=2.12) ; extra == 'beam'
Provides-Extra: bottle
Requires-Dist: bottle (>=0.12.13) ; extra == 'bottle'
Provides-Extra: celery
Requires-Dist: celery (>=3) ; extra == 'celery'
Provides-Extra: chalice
Requires-Dist: chalice (>=1.16.0) ; extra == 'chalice'
Provides-Extra: django
Requires-Dist: django (>=1.8) ; extra == 'django'
Provides-Extra: falcon
Requires-Dist: falcon (>=1.4) ; extra == 'falcon'
Provides-Extra: fastapi
Requires-Dist: fastapi (>=0.79.0) ; extra == 'fastapi'
Provides-Extra: flask
Requires-Dist: flask (>=0.11) ; extra == 'flask'
Requires-Dist: blinker (>=1.1) ; extra == 'flask'
Provides-Extra: httpx
Requires-Dist: httpx (>=0.16.0) ; extra == 'httpx'
Provides-Extra: opentelemetry
Requires-Dist: opentelemetry-distro (>=0.35b0) ; extra == 'opentelemetry'
Provides-Extra: pure_eval
Requires-Dist: pure-eval ; extra == 'pure_eval'
Requires-Dist: executing ; extra == 'pure_eval'
Requires-Dist: asttokens ; extra == 'pure_eval'
Provides-Extra: pymongo
Requires-Dist: pymongo (>=3.1) ; extra == 'pymongo'
Provides-Extra: pyspark
Requires-Dist: pyspark (>=2.4.4) ; extra == 'pyspark'
Provides-Extra: quart
Requires-Dist: quart (>=0.16.1) ; extra == 'quart'
Requires-Dist: blinker (>=1.1) ; extra == 'quart'
Provides-Extra: rq
Requires-Dist: rq (>=0.6) ; extra == 'rq'
Provides-Extra: sanic
Requires-Dist: sanic (>=0.8) ; extra == 'sanic'
Provides-Extra: sqlalchemy
Requires-Dist: sqlalchemy (>=1.2) ; extra == 'sqlalchemy'
Provides-Extra: starlette
Requires-Dist: starlette (>=0.19.1) ; extra == 'starlette'
Provides-Extra: starlite
Requires-Dist: starlite (>=1.48) ; extra == 'starlite'
Provides-Extra: tornado
Requires-Dist: tornado (>=5) ; extra == 'tornado'
<p align="center">
<img src="https://sentry-brand.storage.googleapis.com/sentry-wordmark-dark-280x84.png" alt="Sentry" width="280" height="84">
</a>
</p>
_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 [<kbd>**Check out our open positions**</kbd>](https://sentry.io/careers/)_
# Official Sentry SDK for Python
[](https://github.com/getsentry/sentry-python/actions/workflows/ci.yml)
[](https://pypi.python.org/pypi/sentry-sdk)
---
## Getting Started
### Install
```bash
pip install --upgrade sentry-sdk
```
### Configuration
```python
import sentry_sdk
sentry_sdk.init(
# 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/)
## 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).)
## 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/)
- [](http://stackoverflow.com/questions/tagged/sentry)
- [](https://twitter.com/intent/follow?screen_name=getsentry)
## License
Licensed under the BSD license, see [`LICENSE`](LICENSE)