Skip to main content
Help us improve Python packaging – donate today!

Celery Flower

Project Description

Flower is a web based tool for monitoring and administrating Celery clusters.

Features

  • Shutdown or restart workers
  • View workers status (completed, running tasks, etc.)
  • View worker pool options (timeouts, processes, etc.)
  • Control worker pool size
  • View message broker options
  • View active queues, add or cancel queues
  • View processed task stats by type
  • View currently running tasks
  • View scheduled tasks
  • View reserved and revoked tasks
  • Apply time and rate limits
  • View all active configuration options
  • View all tasks (by type, by worker, etc.)
  • View all task options (arguments, start time, runtime, etc.)
  • Revoke or terminate tasks
  • View real-time execution graphs

API

Flower API enables to control the cluster via REST api and receive task events in real-time via WebSockets.

For example you can restart worker’s pool by:

$ curl -X POST http://localhost:5555/api/worker/pool/restart/myworker

Or terminate executing task by:

$ curl -X POST -d '{"terminate":True}' http://localhost:5555/api/task/revoke/8a4da87b-e12b-4547-b89a-e92e4d1f8efd

Or receive task completion events in real-time:

var ws = new WebSocket('ws://localhost:5555/api/task/events/task-succeeded/');
ws.onmessage = function (event) {
    console.log(event.data);
}

Installation

To install, simply:

$ pip install flower

Usage

Launch the server and open http://localhost:5555:

$ flower --port=5555

Or launch from celery:

$ celery flower --port=5555

Broker URL and other configuration options can be passed through the standard Celery options:

$ celery flower --broker=amqp://guest:guest@localhost:5672//

Screenshots

https://raw.github.com/mher/flower/master/docs/screenshots/dashboard.png https://raw.github.com/mher/flower/master/docs/screenshots/pool.png https://raw.github.com/mher/flower/master/docs/screenshots/tasks.png https://raw.github.com/mher/flower/master/docs/screenshots/task.png https://raw.github.com/mher/flower/master/docs/screenshots/monitor.png

More screenshots

Getting help

Please head over to #celery IRC channel on irc.freenode.net or open an issue.

Release history Release notifications

History Node

0.9.2

History Node

0.9.1

History Node

0.9.0

History Node

0.8.4

History Node

0.8.3

History Node

0.8.2

History Node

0.8.1

History Node

0.8.0

History Node

0.7.3

History Node

0.7.2

History Node

0.7.1

History Node

0.7.0

History Node

0.6.0

History Node

0.5.2

History Node

0.5.1

History Node

0.5.0

History Node

0.4.3

History Node

0.4.2

History Node

0.4.0

This version
History Node

0.3.1

History Node

0.3.0

History Node

0.2.0

History Node

0.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
flower-0.3.1.tar.gz (235.2 kB) Copy SHA256 hash SHA256 Source None Aug 23, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page