---
id: aa-taskmonitor
version: "1.1.1"
license: unclear
license_treatment: permissive
maintenance: active
---

# aa-taskmonitor — An Alliance Auth app for monitoring celery tasks.

License: permissive · Maintenance: active · Downloads: 238.7K/mo

## What it is and what it does

Task Monitor is a Django admin plugin for Alliance Auth that captures and stores logs of every celery task executed on your system—including failed and retried tasks. It records task parameters, results, exception tracebacks, and execution metadata, then lets administrators search, filter, and analyze this data through the web interface or command-line tools. The package automatically manages storage by deleting logs older than a configurable age (default 24 hours) and truncating deeply nested task data to reduce disk usage.

Administrators can generate reports with charts answering common operational questions (task failure rates, runtime distribution, queue backlog over time), export all logs to CSV for external analysis, and view detailed statistics per task. A command-line utility (`taskmonitorctl`) provides direct access to log inspection and queue management. The package depends on allianceauth and humanize, and supports Python 3.10, 3.11, and 3.12 under Django 4.2 and 5.2.

Use it for:

- Diagnose why celery tasks are failing by reviewing exception messages and task parameters in the admin UI.
- Generate charts showing which tasks consume the most time or fail most frequently to identify optimization targets.
- Export task logs to CSV for trend analysis or compliance auditing over longer periods than the default retention.
- Monitor queue backlog growth over time to detect when your task workers are falling behind.
- Investigate task retry patterns to understand whether retries are succeeding or masking underlying issues.
- Use the CLI to purge or inspect the task queue without writing custom scripts.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Django admin plugin for Alliance Auth that logs, searches, and analyzes celery task execution with charts, statistics, and CSV export.

Yes, if you run Alliance Auth with celery and need operational visibility into task execution. Install friction is minimal, maintenance is active, and there are no known vulnerabilities. The permissive MIT license poses no restriction. Worth installing unless you already have equivalent monitoring (e.g., Flower or Celery Analytics) integrated into your stack.

## Install

pip install aa-taskmonitor
uv add aa-taskmonitor
poetry add aa-taskmonitor

## Installing aa-taskmonitor

Before you install: Low friction install as a pure-Python wheel. Active maintenance with a release 45 days ago. Requires Alliance Auth and celery already running; no compiled dependencies.

License in practice: MIT license (permissive) means you can use, modify, and redistribute freely with minimal restrictions.

Quickstart:

pip install aa-taskmonitor

# In Alliance Auth local.py:
INSTALLED_APPS = [..., 'taskmonitor']

# Then:
python manage.py migrate
python manage.py collectstatic --noinput

# Inspect logs via CLI:
python manage.py taskmonitorctl inspect logs

Requires an existing Alliance Auth installation with celery already configured and running.

Verify before relying:

- Whether the package works with celery versions beyond what Alliance Auth itself supports.
- Performance impact on systems with very high task volumes (the FAQ mentions 100K+ tasks/day but doesn't quantify overhead).
- Whether CSV export handles all task data types without loss or corruption.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 238.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

celery task monitoring, django admin task logs, celery queue analytics, task execution reports, celery failure tracking, alliance auth plugin, task performance analysis, django-admin-plugin, celery-ops, task-analytics

[View on SkillFed](https://skillfed.io/packages/aa-taskmonitor) · [View on PyPI](https://pypi.org/project/aa-taskmonitor/)