tornado.log — Logging support

记录对龙卷风的支持.

龙卷风使用三个记录器流:

  • tornado.access :Tornado的HTTP服务器(以及将来可能的其他服务器)的按请求记录

  • tornado.application :记录应用程序代码中的错误(即,回调中未捕获的异常)

  • tornado.general :通用日志记录,包括来自Tornado本身的任何错误或警告.

可以使用标准库的logging模块独立配置这些流. 例如,您可能希望将tornado.access日志发送到单独的文件中进行分析.

tornado.log.curses = <module 'curses' from '/home/docs/checkouts/readthedocs.org/user_builds/tornado/conda/stable/lib/python3.7/curses/__init__.py'>
class tornado.log.LogFormatter(fmt: str = '%(color)s[%(levelname)1.1s %(asctime)s %(module)s:%(lineno)d]%(end_color)s %(message)s', datefmt: str = '%y%m%d %H:%M:%S', style: str = '%', color: bool = True, colors: Dict[int, int] = {10: 4, 20: 2, 30: 3, 40: 1})[source]

龙卷风中使用的日志格式化程序.

该格式化程序的主要功能是:

  • 登录到支持颜色的终端时支持颜色.

  • 每条日志行上的时间戳.

  • 健壮的str / bytes编码问题.

此格式器由tornado.options.parse_command_linetornado.options.parse_config_file自动启用(除非使用--logging=none ).

通过使用colorama库启用了不支持ANSI颜色代码的Windows版本上的颜色支持. 希望使用此功能的应用程序必须首先通过调用colorama.init来初始化colorama.init . 有关详细信息,请参见colorama文档.

在版本4.5中更改:添加了对colorama支持. 将构造函数签名更改为与logging.config.dictConfig兼容.

Parameters
  • colorbool )–启用颜色支持.

  • fmtstr )–日志消息格式. 它将应用于日志记录的属性字典. 如果启用了颜色支持,则%(color)s%(end_color)s之间的文本将根据级别进行着色.

  • colorsdict )–从日志记录级别到终端颜色代码的颜色映射

  • datefmtstr )–日期时间格式. 用于在prefix_fmt格式化(asctime)占位符.

在3.2版中进行了更改: Added fmt and datefmt arguments.

tornado.log.enable_pretty_logging(options: Any = None, logger: logging.Logger = None) → None[source]

按照配置打开格式化的日志记录输出.

这由tornado.options.parse_command_linetornado.options.parse_config_file自动tornado.options.parse_config_file .

tornado.log.define_logging_options(options: Any = None) → None[source]

将与日志记录相关的标志添加到options .

这些选项自动显示在默认选项实例上. 仅当您创建了自己的OptionParser才需要此方法.

4.2版中的新增功能此功能在以前的版本中已存在,但在4.2版之前已被破坏且未记录.