1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
|
Metadata-Version: 2.4
Name: sentry-sdk
Version: 2.24.1
Summary: Python client for Sentry (https://sentry.io)
Home-page: https://github.com/getsentry/sentry-python
Author: Sentry Team and Contributors
Author-email: hello@sentry.io
License: MIT
Project-URL: Documentation, https://docs.sentry.io/platforms/python/
Project-URL: Changelog, https://github.com/getsentry/sentry-python/blob/master/CHANGELOG.md
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 :: 3
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: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: urllib3>=1.26.11
Requires-Dist: certifi
Provides-Extra: aiohttp
Requires-Dist: aiohttp>=3.5; extra == "aiohttp"
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.16; extra == "anthropic"
Provides-Extra: arq
Requires-Dist: arq>=0.23; extra == "arq"
Provides-Extra: asyncpg
Requires-Dist: asyncpg>=0.23; extra == "asyncpg"
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: celery-redbeat
Requires-Dist: celery-redbeat>=2; extra == "celery-redbeat"
Provides-Extra: chalice
Requires-Dist: chalice>=1.16.0; extra == "chalice"
Provides-Extra: clickhouse-driver
Requires-Dist: clickhouse-driver>=0.2.0; extra == "clickhouse-driver"
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"
Requires-Dist: markupsafe; extra == "flask"
Provides-Extra: grpcio
Requires-Dist: grpcio>=1.21.1; extra == "grpcio"
Requires-Dist: protobuf>=3.8.0; extra == "grpcio"
Provides-Extra: http2
Requires-Dist: httpcore[http2]==1.*; extra == "http2"
Provides-Extra: httpx
Requires-Dist: httpx>=0.16.0; extra == "httpx"
Provides-Extra: huey
Requires-Dist: huey>=2; extra == "huey"
Provides-Extra: huggingface-hub
Requires-Dist: huggingface_hub>=0.22; extra == "huggingface-hub"
Provides-Extra: langchain
Requires-Dist: langchain>=0.0.210; extra == "langchain"
Provides-Extra: launchdarkly
Requires-Dist: launchdarkly-server-sdk>=9.8.0; extra == "launchdarkly"
Provides-Extra: litestar
Requires-Dist: litestar>=2.0.0; extra == "litestar"
Provides-Extra: loguru
Requires-Dist: loguru>=0.5; extra == "loguru"
Provides-Extra: openai
Requires-Dist: openai>=1.0.0; extra == "openai"
Requires-Dist: tiktoken>=0.3.0; extra == "openai"
Provides-Extra: openfeature
Requires-Dist: openfeature-sdk>=0.7.1; extra == "openfeature"
Provides-Extra: opentelemetry
Requires-Dist: opentelemetry-distro>=0.35b0; extra == "opentelemetry"
Provides-Extra: opentelemetry-experimental
Requires-Dist: opentelemetry-distro; extra == "opentelemetry-experimental"
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: statsig
Requires-Dist: statsig>=0.55.3; extra == "statsig"
Provides-Extra: tornado
Requires-Dist: tornado>=6; extra == "tornado"
Provides-Extra: unleash
Requires-Dist: UnleashClient>=6.0.1; extra == "unleash"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary
<a href="https://sentry.io/?utm_source=github&utm_medium=logo" target="_blank">
<img src="https://sentry-brand.storage.googleapis.com/github-banners/github-sdk-python.png" alt="Sentry for Python">
</a>
<div align="center">
_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/)_.
[](https://discord.gg/wdNEHETs87)
[](https://twitter.com/intent/follow?screen_name=getsentry)
[](https://pypi.python.org/pypi/sentry-sdk)
<img src="https://img.shields.io/badge/python-3.7 | 3.8 | 3.9 | 3.10 | 3.11 | 3.12 | 3.13-blue.svg" alt="python">
[](https://github.com/getsentry/sentry-python/actions/workflows/ci.yml)
<br/>
</div>
# Official Sentry SDK for Python
Welcome to the official Python SDK for **[Sentry](http://sentry.io/)**.
## 📦 Getting Started
### Prerequisites
You need a Sentry [account](https://sentry.io/signup/) and [project](https://docs.sentry.io/product/projects/).
### Installation
Getting Sentry into your project is straightforward. Just run this command in your terminal:
```bash
pip install --upgrade sentry-sdk
```
### Basic Configuration
Here's a quick configuration example to get Sentry up and running:
```python
import sentry_sdk
sentry_sdk.init(
"https://12927b5f211046b575ee51fd8b1ac34f@o1.ingest.sentry.io/1", # Your DSN here
# Set traces_sample_rate to 1.0 to capture 100%
# of traces for performance monitoring.
traces_sample_rate=1.0,
)
```
With this configuration, Sentry will monitor for exceptions and performance issues.
### Quick Usage Example
To generate some events that will show up in Sentry, you can log messages or capture errors:
```python
import sentry_sdk
sentry_sdk.init(...) # same as above
sentry_sdk.capture_message("Hello Sentry!") # You'll see this in your Sentry dashboard.
raise ValueError("Oops, something went wrong!") # This will create an error event in Sentry.
```
## 📚 Documentation
For more details on advanced usage, integrations, and customization, check out the full documentation on [https://docs.sentry.io](https://docs.sentry.io/).
## 🧩 Integrations
Sentry integrates with a ton of popular Python libraries and frameworks, including [FastAPI](https://docs.sentry.io/platforms/python/integrations/fastapi/), [Django](https://docs.sentry.io/platforms/python/integrations/django/), [Celery](https://docs.sentry.io/platforms/python/integrations/celery/), [OpenAI](https://docs.sentry.io/platforms/python/integrations/openai/) and many, many more. Check out the [full list of integrations](https://docs.sentry.io/platforms/python/integrations/) to get the full picture.
## 🚧 Migrating Between Versions?
### From `1.x` to `2.x`
If you're using the older `1.x` version of the SDK, now's the time to upgrade to `2.x`. It includes significant upgrades and new features. Check our [migration guide](https://docs.sentry.io/platforms/python/migration/1.x-to-2.x) for assistance.
### From `raven-python`
Using the legacy `raven-python` client? It's now in maintenance mode, and we recommend migrating to the new SDK for an improved experience. Get all the details in our [migration guide](https://docs.sentry.io/platforms/python/migration/raven-to-sentry-sdk/).
## 🙌 Want to Contribute?
We'd love your help in improving the Sentry SDK! Whether it's fixing bugs, adding features, writing new integrations, or enhancing documentation, every contribution is valuable.
For details on how to contribute, please read our [contribution guide](CONTRIBUTING.md) and explore the [open issues](https://github.com/getsentry/sentry-python/issues).
## 🛟 Need Help?
If you encounter issues or need help setting up or configuring the SDK, don't hesitate to reach out to the [Sentry Community on Discord](https://discord.com/invite/Ww9hbqr). There is a ton of great people there ready to help!
## 🔗 Resources
Here are all resources to help you make the most of Sentry:
- [Documentation](https://docs.sentry.io/platforms/python/) - Official documentation to get started.
- [Discord](https://img.shields.io/discord/621778831602221064) - Join our Discord community.
- [X/Twitter](https://twitter.com/intent/follow?screen_name=getsentry) - Follow us on X (Twitter) for updates.
- [Stack Overflow](https://stackoverflow.com/questions/tagged/sentry) - Questions and answers related to Sentry.
<a name="license"></a>
## 📃 License
The SDK is open-source and available under the MIT license. Check out the [LICENSE](LICENSE) file for more information.
## 😘 Contributors
Thanks to everyone who has helped improve the SDK!
<a href="https://github.com/getsentry/sentry-python/graphs/contributors">
<img src="https://contributors-img.web.app/image?repo=getsentry/sentry-python" />
</a>
|
