Skip to main content

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

Project description

Sentry

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

Build Status PyPi page link -- version Discord

This is the official Python SDK for Sentry


Note about SDK 2.0.0rc1

Sentry SDK 2.0.0rc1 has been tested under load on Sentry itself. But we advice you to still be careful if you test this in production.

Please give it a spin and test it with your project. If you have any questions or feedback please contact us on Discord in the #sdk-chat channel or create a GitHub Issue or start a GitHub Discussion.

Thanks!

https://discord.com/channels/621778831602221064/621783758739079168

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.

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:

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

  • Documentation
  • Forum
  • Discord
  • Stack Overflow
  • Twitter Follow

License

Licensed under the MIT license, see LICENSE

Supported by

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