Django Celery Panel

DJ Celery Panel brings Celery monitoring directly into the Django Admin.

Compatible with dj-control-room. Register this panel in the Control Room to manage it from a centralized dashboard.

• Official site: djangocontrolroom.com
• Project repo: dj-control-room

Docs

https://django-control-room.github.io/dj-celery-panel/

Features

• Workers Monitoring: View active Celery workers, their status, pool type, and concurrency
• Task Management: Browse and inspect Celery tasks with detailed information
• Queue Overview: Monitor configured queues and their routing
• Periodic Tasks: View scheduled periodic tasks and their schedules
• Real-time Inspection: Live data from Celery's inspect API
• Django Admin Integration: Seamlessly integrated into your existing Django admin interface
• Swappable Backends: Pluggable architecture for custom data sources and monitoring integrations (see Configuration)

Requirements

• Python 3.9+
• Django 4.2+

Screenshots

Django Admin Integration

Seamlessly integrated into your Django admin interface. A new section for dj-celery-panel will appear in the same places where your models appear.

NOTE: This application does not actually introduce any model or migrations.

Dashboard Overview

Get a quick overview of your Celery infrastructure including active workers, recent tasks, and queue status.

Workers Monitoring

View all active Celery workers with detailed information about their status, pool type, concurrency, and processing capabilities.

Task Management

Browse and inspect your Celery tasks with complete details including status, arguments, results, and execution time.

Configuration

View your Celery configuration including broker settings, result backend, and other runtime parameters.

Installation

pip install dj-celery-panel dj-control-room

Add it to INSTALLED_APPS, include its URLs, and migrate:

INSTALLED_APPS = [
    # ...
    "dj_control_room_base",
    "dj_celery_panel",
    "dj_control_room",
    # ...
]

urlpatterns = [
    path("admin/dj-control-room-base/", include("dj_control_room_base.urls")),
    path("admin/dj-celery-panel/", include("dj_celery_panel.urls")),
    path("admin/dj-control-room/", include("dj_control_room.urls")),
    path("admin/", admin.site.urls),
]

python manage.py migrate

Then visit /admin/ and look for the "DJ CELERY PANEL" section.

Note: The panel requires at least one Celery worker to be running to display worker and queue information.

For the full walkthrough, settings reference (swappable backends, periodic tasks, CSS), and production recommendations, see the Installation and Configuration docs. See Scopes for per-view permission scopes.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Development Setup

Want to contribute or set up the project for local development? See docs/development.md for prerequisites, Docker/virtualenv setup, running the example project, and the test suite.