Dramatiq Performance Monitoring
Per-task timing, error tracking, and N+1 detection for your Dramatiq workers. Scout's Python agent instruments Dramatiq automatically with no configuration. Connects task failures to the full trace and surrounding log lines.
Errors, Logs, and Traces
Errors, Logs, and Traces for Every Dramatiq Task
Scout connects Dramatiq task failures to the full transaction trace and surrounding log lines in a single view. When a worker raises an exception, you see the error, the task trace with per-operation timing, and the log output together.
Error Monitoring
Automatic exception capture for every Dramatiq task. Errors are grouped by actor name, linked to the originating trace, and enriched with task context.
Log Management
Log output from Dramatiq workers is enriched with trace context. Filter logs by trace ID to see exactly what a specific task execution did, including database queries and HTTP requests.
App Traces
Every Dramatiq task execution appears as its own transaction in Scout with per-operation timing. See time spent in SQLAlchemy queries, Django ORM calls, Redis operations, and application code broken out by actor name.
Query Analysis
N+1 Detection Inside Dramatiq Tasks
Scout automatically detects N+1 query patterns in SQLAlchemy and the Django ORM within Dramatiq task executions. If a background task triggers repeated queries in a loop, Scout identifies the pattern, shows the code location, and reports the total performance impact.
Auto-Instrumentation
What Scout Instruments in Your Dramatiq Workers
Scout's Python agent auto-instruments Dramatiq tasks with per-execution timing and error tracking. SQLAlchemy queries, Django ORM calls, Redis operations, and UrlLib3/Requests HTTP calls made inside tasks are all captured automatically. No actor decorators or manual spans required.
Supported Frameworks
Works with the Dramatiq frameworks you already use
Scout auto-instruments the frameworks and libraries in your stack. No manual configuration required.
Task Queues
- Dramatiq
- Celery
- Huey
- RQ
Databases
- SQLAlchemy
- Django ORM
- Redis
- ElasticSearch
Web Frameworks
- Django
- Flask
- FastAPI
Memory Profiling
Memory Bloat Detection for Dramatiq
Dramatiq workers can accumulate memory over time, especially when processing large message payloads. Scout detects memory bloat at the task level, showing which actors and code paths are responsible for memory growth.
AI Native
Query Your Dramatiq App Data from AI Assistants and the Terminal
Scout offers hosted and local MCP servers with 17 tools, a Go CLI available via Homebrew with TOON format for LLM output, and a public API. Query your Dramatiq task performance, error rates, and N+1 insights from Claude Code, Cursor, or the terminal.
MCP Server
Hosted or local MCP server with 17 tools covering apps, endpoints, traces, errors, insights, background jobs, and usage data. Works with Claude Code, Cursor, VS Code Copilot, and any MCP-enabled assistant.
Scout CLI
Go binary available via Homebrew. Query app metrics, endpoint performance, traces, error groups, and insights from the terminal. Outputs human-friendly tables or TOON format for LLM consumption.
Public API
Full programmatic access to your monitoring data for building custom integrations, dashboards, or automation workflows.
Get Started in Minutes
Add Scout to Your Dramatiq App
Get Scout running on your Dramatiq workers in under 3 minutes.
Install the package:
pip install scout-apmConfigure in your Django settings or application setup, including your Scout key.
Deploy and see data in 5 minutes.
FAQ
Dramatiq Monitoring FAQ
What is the best monitoring tool for Dramatiq?
Scout Monitoring instruments Dramatiq tasks automatically. Every task execution appears as its own transaction with per-operation timing, SQLAlchemy and Django ORM N+1 detection, memory bloat tracking, and error capture linked to the full task trace.
How do I monitor Dramatiq with Scout?
Install scout-apm with pip, configure it in your Django settings or application setup, and deploy. Dramatiq tasks appear automatically in Scout as their own transactions. No actor wrappers or manual instrumentation required.
Does Scout detect N+1 queries inside Dramatiq tasks?
Yes. Scout automatically detects N+1 query patterns in SQLAlchemy and the Django ORM within Dramatiq task executions. The agent identifies repeated query patterns, shows the exact code location, and reports the total time wasted.
Does Scout support Celery as well as Dramatiq?
Yes. Scout auto-instruments Dramatiq, Celery, Huey, and RQ. Each task queue framework appears with per-task timing and error tracking in Scout.
Does Scout support error monitoring for Dramatiq?
Yes. Exceptions raised inside Dramatiq actors are captured automatically. Each error is grouped by actor name, linked to the task trace, and shown with the surrounding log context.