Kanchi Documentation

Real-time monitoring for Celery that actually feels good to use. If you've spent years squinting at logs or refreshing Flower tabs, this one's for you.

What Kanchi does

Kanchi connects directly to your message broker — no agents, no SDK changes — and gives you real-time visibility into task execution. Tasks, workers, retries, failures, everything you need to debug issues and prevent outages.

Live task monitoring WebSocket-based updates mean you see tasks as they flow through your system. No refresh button, no polling lag. Switch between streaming mode for active debugging and paginated views for historical analysis.

Orphan detection When tasks fail because a worker crashed or the network dropped, Kanchi flags them automatically. Bulk retry with batch tracking so you can recover gracefully instead of scrambling through logs.

Workflow automation Event-driven actions that respond to task failures without writing code. Circuit breaker protection prevents infinite retry loops. Slack integration for notifications. Pre-built templates for common scenarios.

Worker health at a glance Live worker status with heartbeat tracking. See which workers are handling the most load, which ones are idle, and which ones disappeared mid-task.

Quick start

Get Kanchi running in under 5 minutes with Docker Compose and pre-built images from Docker Hub:

# Create a minimal docker-compose.yaml
cat > docker-compose.yaml <<'EOF'
services:
  kanchi:
    image: getkanchi/kanchi:latest
    container_name: kanchi
    ports:
      - "3000:3000"
      - "8765:8765"
    environment:
      CELERY_BROKER_URL: ${CELERY_BROKER_URL}
    volumes:
      - kanchi-data:/data
    restart: unless-stopped

volumes:
  kanchi-data:
EOF

# Configure your broker
export CELERY_BROKER_URL=amqp://user:pass@your-rabbit:5672//

# Start Kanchi
docker compose up -d --pull always

Open http://localhost:3000 and you're done.

Key features

Real-time monitoring

WebSocket-powered updates. See tasks as they execute. Multi-dimensional filtering: status, date range, task name, worker, queue. Full-text search across task arguments and results.

Task management

Detailed retry tracking with parent-child task relationships. Complete state transition history. Deep-linkable URLs for sharing specific task failures with your team.

Orphan detection

Automatic identification of tasks that started but never completed. One-click bulk retry with batch tracking. Orphan recovery workflows that run automatically.

Workflow automation

Event-driven responses to task failures. Circuit breakers to prevent infinite retry loops. Slack integration for notifications. Pre-built templates for common scenarios.

Worker health

Live status with heartbeat tracking. Task distribution metrics. Queue assignments for each worker. Automatic detection of offline workers.

Analytics

Daily task statistics aggregated by status. Historical trend analysis. Worker utilization metrics. Task failure rate tracking.

Core concepts

Get help

Questions? Open an issue on GitHub

Contributing? Read the authoring guide to understand how to write documentation.

Built for developers who need intuitive visibility into distributed systems. Try it out and let us know what breaks.