Dramatiq
Learn how to import and use the Dramatiq integration.
The Dramatiq integration adds support for the Dramatiq background tasks library.
The Dramatiq integration only reports errors. Tracing is not yet supported. If you want to have more instrumentation, you need to do custom instrumentation.
This is the successor of the original DramatiqIntegration that can be found here: https://github.com/jacobsvante/sentry-dramatiq
The original maintainer has donated the integration to Sentry, so we can take over maintenance.
To get started, install sentry-sdk from PyPI.
pip install --upgrade sentry-sdk
Add DramatiqIntegration() to your integrations list:
import sentry_sdk
from sentry_sdk.integrations.dramatiq import DramatiqIntegration
sentry_sdk.init(
dsn="https://examplePublicKey@o0.ingest.sentry.io/0",
integrations=[
DramatiqIntegration(),
],
)
Trigger an error in your code to verify that the integration is sending events to Sentry.
import dramatiq
import sentry_sdk
sentry_sdk.init(...) # same as above
@dramatiq.actor(max_retries=0)
def dummy_actor(x, y):
return x / y
dummy_actor.send(5, 0)
Running this will create an error event (ZeroDivisionError) that you should be able to see in sentry.io.
- Dramatiq: 1.13+
- Python: 3.6+
The versions above apply for Sentry Python SDK version 2.0+, which drops support for some legacy Python and framework versions. If you're looking to use Sentry with older Python or framework versions, consider using an SDK version from the 1.x major line of releases.
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").