The celery events command.

See also

See preload-options and Daemon Options.

-d, --dump

Dump events to stdout.

-c, --camera

Take snapshots of events using this camera.


Camera: Detach and run in the background as a daemon.

-F, --freq, --frequency

Camera: Shutter frequency. Default is every 1.0 seconds.

-r, --maxrate

Camera: Optional shutter rate limit (e.g., 10/m).

-l, --loglevel

Logging level, choose between DEBUG, INFO, WARNING, ERROR, CRITICAL, or FATAL. Default is INFO.

-f, --logfile

Path to log file. If no logfile is specified, stderr is used.


Optional file used to store the process pid.

The program won’t start if this file already exists and the pid is still alive.


User id, or user name of the user to run as after detaching.


Group id, or group name of the main group to change to after detaching.


Effective umask (in octal) of the process after detaching. Inherits the umask of the parent process by default.


Optional directory to change to after detaching.


Executable to use for the detached process.

Module Contents


events() Event-stream utilities.


class events

Event-stream utilities.

# - Start graphical monitor (requires curses)
$ celery events --app=proj
$ celery events -d --app=proj
# - Dump events to screen.
$ celery events -b amqp://
# - Run snapshot camera.
$ celery events -c <camera> [options]
$ celery events
$ celery events -d
$ celery events -c mod.attr -F 1.0 --detach --maxrate=100/m -l info
run(dump=False, camera=None, frequency=1.0, maxrate=None, loglevel="INFO", logfile=None, prog_name="celery events", pidfile=None, uid=None, gid=None, umask=None, workdir=None, detach=False, **kwargs)
run_evcam(camera, logfile=None, pidfile=None, uid=None, gid=None, umask=None, workdir=None, detach=False, **kwargs)
set_process_status(prog, info="")