{"body": "
\n

# flower\u00b6

\n
\n

## SYNOPSIS\u00b6

\n

`flower` [OPTIONS]

\n
\n
\n

## DESCRIPTION\u00b6

\n

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

\n

\n

- Real-time monitoring using Celery Events

  \n

  > \n
  > \n
  > - Task progress and history
  > \n
  > - Ability to show task details (arguments, start time, runtime, and more)
  > \n
  > - Graphs and statistics
  > \n
  > \n

  \n
\n

- Remote Control

  \n

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

  \n
\n

- Broker monitoring

  \n

  > \n
  > \n
  > - View statistics for all Celery queues
  > \n
  > - Queue length graphs
  > \n
  > \n

  \n
\n

- HTTP API

  \n
\n

- Basic Auth and Google OpenID authentication

  \n
\n

\n
\n
\n

## OPTIONS\u00b6

\n

> \n

> \n\n\n
> \n
> \n`--address`\n | run on the given address
> \n
> \n`--auth`\n | regexp of emails to grant access
> \n
> \n`--basic_auth`\n | colon separated user-password to enable\nbasic auth
> \n
> \n`--broker_api`\n | inspect broker e.g.\nhttp://guest:guest@localhost:15672/api/
> \n
> \n`--certfile`\n | path to SSL certificate file
> \n
> \n`--db`\n | flower database file (default flower.db)
> \n
> \n`--debug`\n | run in debug mode (default False)
> \n
> \n`--help`\n | show this help information
> \n
> \n`--inspect`\n | inspect workers (default True)
> \n
> \n`--inspect_timeout`\n
> \n
> | inspect timeout (in milliseconds) (default\n1000)
> \n
> \n`--keyfile`\n | path to SSL key file
> \n
> \n`--max_workrs`\n | maximum number of workers to keep in memory\n(default 5000)
> \n
> \n`--max_tasks`\n | maximum number of tasks to keep in memory\n(default 10000)
> \n
> \n`--persistent`\n | enable persistent mode (default False)
> \n
> \n`--port`\n | run on the given port (default 5555)
> \n
> \n`--url_prefix`\n | base url prefix
> \n
> \n`--xheaders`\n | enable support for the ‘X-Real-Ip’ and\n‘X-Scheme’ headers. (default False)
> \n
> \n

> \n

\n
\n
\n

## TORNADO OPTIONS\u00b6

\n

> \n

> \n\n\n
> \n
> \n`--log_file_max_size`\n
> \n
> | max size of log files before rollover\n(default 100000000)
> \n
> \n`--log_file_num_backups`\n
> \n
> | number of log files to keep (default 10)
> \n
> \n`--log_file_prefix=PATH`\n
> \n
> | Path prefix for log files. Note that if you\nare running multiple tornado processes,\nlog_file_prefix must be different for each\nof them (e.g. include the port number)
> \n
> \n`--log_to_stderr`\n
> \n
> | Send log output to stderr (colorized if\npossible). By default use stderr if\n`--log_file_prefix` is not set and no other\nlogging is configured.
> \n
> \n

> \n
> \n
> –logging=debug|info|warning|error|none
> \n
>   Set the Python log level. If none, tornado\nwon’t touch the logging configuration.\n(default info)
> \n
> \n

\n
\n
\n

## USAGE\u00b6

\n

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

\n

    $ flower -A proj --port=5555\n

\n
\n

Or, launch from Celery:

\n

    $ celery flower -A proj --address=127.0.0.1 --port=5555\n

\n
\n

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

\n

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

\n
\n
\n
\n", "alabaster_version": "0.7.7", "display_toc": true, "title": "flower", "sourcename": "man.txt", "customsidebar": null, "metatags": "", "current_page_name": "man", "next": null, "rellinks": [], "meta": {}, "parents": [], "sidebars": ["sidebarlogo.html", "localtoc.html", "relations.html", "sourcelink.html", "searchbox.html"], "toc": "

\n
- flower
  \n
  - SYNOPSIS
  \n
  - DESCRIPTION
  \n
  - OPTIONS
  \n
  - TORNADO OPTIONS
  \n
  - USAGE
  \n
  \n
\n

\n", "prev": null, "page_source_suffix": ".rst"}