flower man page

flower — flower Documentation


flower [Options]


Flower is a web based tool for monitoring and administrating Celery clusters. It has these features:

  • Real-time monitoring using Celery Events

    • Task progress and history
    • Ability to show task details (arguments, start time, runtime, and more)
    • Graphs and statistics
  • Remote Control

    • View worker status and statistics
    • Shutdown and restart worker instances
    • Control worker pool size and autoscale settings
    • View and modify the queues a worker instance consumes from
    • View currently running tasks
    • View scheduled tasks (ETA/countdown)
    • View reserved and revoked tasks
    • Apply time and rate limits
    • Configuration viewer
    • Revoke or terminate tasks
  • Broker monitoring

    • View statistics for all Celery queues
    • Queue length graphs
  • Basic Auth and Google OpenID authentication



run on the given address


regexp  of emails to grant access


colon separated user-password to enable basic auth


inspect broker e.g. http://guest:guest@localhost:15672/api/


path to SSL certificate file


flower database file (default flower.db)


run in debug mode (default False)


show this help information


inspect workers (default True)


inspect timeout (in milliseconds) (default 1000)


path to SSL key file


maximum number of workers to keep in memory (default 5000)


maximum number of tasks to keep in memory (default 10000)


enable persistent mode (default False)


run on the given port (default 5555)


base url prefix


enable support for the 'X-Real-Ip' and 'X-Scheme' headers. (default False)

Tornado Options


max size of log files before rollover (default 100000000)


number of log files to keep (default 10)


Path prefix for log files. Note that if you are running multiple tornado processes, log_file_prefix must be different for each of them (e.g. include the port number)


Send log output to stderr (colorized if possible). By default use stderr if --log_file_prefix is not set and no other logging is configured.


Set the Python log level. If none, tornado won't touch the logging configuration. (default info)


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

$ flower -A proj --port=5555

Or, launch from Celery:

$ celery flower -A proj --address= --port=5555

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

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


Mher Movsisyan


Feb 11, 2017 0.9 Flower