AA TaskMonitor

0.23.1 verified Mon Apr 27 auth: no python

An Alliance Auth app for monitoring Celery tasks, providing real-time status and history. Current version 0.23.1, updated regularly as part of the Alliance Auth ecosystem.

pip install aa-taskmonitor

Common errors

error ModuleNotFoundError: No module named 'aa_taskmonitor' ↓

cause Package not installed or virtual environment not activated.

fix

Run 'pip install aa-taskmonitor' in the correct environment.

error django.core.exceptions.ImproperlyConfigured: No module named 'aa_taskmonitor.urls' ↓

cause Incorrect import path or inability to locate urls.

fix

Ensure 'aa_taskmonitor' is in INSTALLED_APPS and run 'python manage.py migrate'.

Warnings

gotcha Requires Celery results backend to be configured in Alliance Auth. Without a result backend (e.g., Redis, database), tasks will not appear in the monitor. ↓

fix Set CELERY_RESULT_BACKEND in your Django settings, e.g., 'django-db' or 'redis://localhost:6379/0'.

gotcha The app must be listed before other custom apps in INSTALLED_APPS to avoid URL routing issues. ↓

fix Place 'aa_taskmonitor' before other custom apps in INSTALLED_APPS.

Imports

urls
```
from aa_taskmonitor import urls
```
Correct import for app URLs

admin

from aa_taskmonitor.admin import TaskMonitorAdmin

Admin registration

models
```
from aa_taskmonitor.models import Task
```
Correct model import

Quickstart

Install and integrate into an existing Alliance Auth project.

pip install aa-taskmonitor

# Add to INSTALLED_APPS in your Alliance Auth settings:
INSTALLED_APPS += ['aa_taskmonitor']

# Run migrations and collect static files
python manage.py migrate
python manage.py collectstatic --noinput

# App will be available in the Alliance Auth admin panel.