---
title: "Dramatiq"
description: "Learn how to import and use the Dramatiq integration."
url: https://docs.sentry.io/platforms/python/integrations/dramatiq/
---

# Dramatiq for Python

The Dramatiq integration adds support for the [Dramatiq](https://dramatiq.io/) 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](https://docs.sentry.io/platforms/python/tracing/instrumentation/custom-instrumentation.md).

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](https://github.com/getsentry/sentry-python/issues/3387), so we can take over maintenance.

## [Install](https://docs.sentry.io/platforms/python/integrations/dramatiq.md#install)

To get started, install `sentry-sdk` from PyPI.

```bash
pip install "sentry-sdk"
```

*Other available variations of the above snippet: uv*

## [Configure](https://docs.sentry.io/platforms/python/integrations/dramatiq.md#configure)

Add `DramatiqIntegration()` to your `integrations` list:

```python
import sentry_sdk
from sentry_sdk.integrations.dramatiq import DramatiqIntegration

sentry_sdk.init(
    dsn="https://<key>@o<orgId>.ingest.sentry.io/<projectId>",
    # Add data like request headers and IP for users, if applicable;
    # see https://docs.sentry.io/platforms/python/data-management/data-collected/ for more info
    send_default_pii=True,
    integrations=[
        DramatiqIntegration(),
    ],
)
```

## [Verify](https://docs.sentry.io/platforms/python/integrations/dramatiq.md#verify)

Trigger an error in your code to verify that the integration is sending events to Sentry.

```python
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](https://sentry.io).

## [Supported Versions](https://docs.sentry.io/platforms/python/integrations/dramatiq.md#supported-versions)

* Dramatiq: 1.9+

* Python:

  * 3.6+ (SDK <3.0)
  * 3.7+ (SDK 3.0+)

If you're looking to use Sentry with older Python or framework versions, consider using an older major version of the SDK. The minimum versions for each major version are listed above.