This document describes the current stable version of Celery (5.2). For development docs, go here.

celery.app.log

Logging configuration.

The Celery instances logging section: Celery.log.

Sets up logging for the worker and other programs, redirects standard outs, colors log output, patches logging related compatibility fixes, and so on.

class celery.app.log.Logging(app)

Application logging setup (app.log).

already_setup = False

colored(logfile=None, enabled=None)

get_default_logger(name='celery', **kwargs)

redirect_stdouts(loglevel=None, name='celery.redirected')

redirect_stdouts_to_logger(logger, loglevel=None, stdout=True, stderr=True)

Redirect sys.stdout and sys.stderr to logger.

Parameters:

• logger (logging.Logger) – Logger instance to redirect to.

• loglevel (int, str) – The loglevel redirected message will be logged as.

setup(loglevel=None, logfile=None, redirect_stdouts=False, redirect_level='WARNING', colorize=None, hostname=None)

setup_handlers(logger, logfile, format, colorize, formatter=<class 'celery.utils.log.ColorFormatter'>, **kwargs)

setup_logging_subsystem(loglevel=None, logfile=None, format=None, colorize=None, hostname=None, **kwargs)

setup_task_loggers(loglevel=None, logfile=None, format=None, colorize=None, propagate=False, **kwargs)

Setup the task logger.

If logfile is not specified, then sys.stderr is used.

Will return the base task logger object.

supports_color(colorize=None, logfile=None)

class celery.app.log.TaskFormatter(fmt=None, use_color=True)

Formatter for tasks, adding the task name and id.

format(record)

Format the specified record as text.

The record’s attribute dictionary is used as the operand to a string formatting operation which yields the returned string. Before formatting the dictionary, a couple of preparatory steps are carried out. The message attribute of the record is computed using LogRecord.getMessage(). If the formatting string uses the time (as determined by a call to usesTime(), formatTime() is called to format the event time. If there is exception information, it is formatted using formatException() and appended to the message.