tornado.log — Logging support
Logging support for Tornado.
Tornado uses three logger streams:
- tornado.access: Per-request logging for Tornado’s HTTP servers (and
potentially other servers in the future)
- tornado.application: Logging of errors from application code (i.e.
uncaught exceptions from callbacks)
- tornado.general: General-purpose logging, including any errors
or warnings from Tornado itself.
These streams may be configured independently using the standard library’s
logging module. For example, you may wish to send tornado.access logs
to a separate file for analysis.
-
class tornado.log.LogFormatter(color=True, fmt='%(color)s[%(levelname)1.1s %(asctime)s %(module)s:%(lineno)d]%(end_color)s %(message)s', datefmt='%y%m%d %H:%M:%S', colors={40: 1, 10: 4, 20: 2, 30: 3})[source]
Log formatter used in Tornado.
Key features of this formatter are:
- Color support when logging to a terminal that supports it.
- Timestamps on every log line.
- Robust against str/bytes encoding problems.
This formatter is enabled automatically by
tornado.options.parse_command_line (unless --logging=none is
used).
Parameters: |
- color (bool) – Enables color support.
- fmt (string) – Log message format.
It will be applied to the attributes dict of log records. The
text between %(color)s and %(end_color)s will be colored
depending on the level if color support is on.
- colors (dict) – color mappings from logging level to terminal color
code
- datefmt (string) – Datetime format.
Used for formatting (asctime) placeholder in prefix_fmt.
|
Changed in version 3.2: Added fmt and datefmt arguments.
-
tornado.log.enable_pretty_logging(options=None, logger=None)[source]
Turns on formatted logging output as configured.
This is called automaticaly by tornado.options.parse_command_line
and tornado.options.parse_config_file.