Skip to main content

Python client for Sentry (https://sentry.io)

Project description

Sentry for Python

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.

Discord Twitter Follow PyPi page link -- version python Build Status


Official Sentry SDK for Python

Welcome to the official Python SDK for Sentry.

📦 Getting Started

Prerequisites

You need a Sentry account and project.

Installation

Getting Sentry into your project is straightforward. Just run this command in your terminal:

pip install --upgrade sentry-sdk

Basic Configuration

Here's a quick configuration example to get Sentry up and running:

import sentry_sdk

sentry_sdk.init(
    "https://[email protected]/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:

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.

🧩 Integrations

Sentry integrates with a ton of popular Python libraries and frameworks, including FastAPI, Django, Celery, OpenAI and many, many more. Check out the full list of 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 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.

🙌 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 and explore the open 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. There is a ton of great people there ready to help!

🔗 Resources

Here are all resources to help you make the most of Sentry:

📃 License

The SDK is open-source and available under the MIT license. Check out the LICENSE file for more information.

😘 Contributors

Thanks to everyone who has helped improve the SDK!

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

sentry_sdk-2.27.0.tar.gz (323.6 kB view details)

Uploaded Source

Built Distribution

sentry_sdk-2.27.0-py2.py3-none-any.whl (340.8 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file sentry_sdk-2.27.0.tar.gz.

File metadata

  • Download URL: sentry_sdk-2.27.0.tar.gz
  • Upload date:
  • Size: 323.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.2

File hashes

Hashes for sentry_sdk-2.27.0.tar.gz
Algorithm Hash digest
SHA256 90f4f883f9eff294aff59af3d58c2d1b64e3927b28d5ada2b9b41f5aeda47daf
MD5 6472126f7e94dddf59809f703b5caaaa
BLAKE2b-256 cfb6a92ae6fa6d7e6e536bc586776b1669b84fb724dfe21b8ff08297f2d7c969

See more details on using hashes here.

File details

Details for the file sentry_sdk-2.27.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for sentry_sdk-2.27.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 c58935bfff8af6a0856d37e8adebdbc7b3281c2b632ec823ef03cd108d216ff0
MD5 b9844ca3c28906956e74934bf3f2a17b
BLAKE2b-256 dd8bfb496a45854e37930b57564a20fb8e90dd0f8b6add0491527c00f2163b00

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page