Skip to main content

tornado.log —记录支持

记录对Tornado的支持。

Tornado使用三个记录器流:

  • tornado.access:Tornado的HTTP服务器(以及将来的其他服务器)的每个请求日志记录,

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

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

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

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})[源代码]

在Tornado中使用的日志格式化程序。

此格式化程序的主要特点是:

  • 记录到支持它的终端时支持颜色。

  • 每个日志行上的时间戳。

  • 强大的str/字节编码问题。

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

参数:
  • color (bool) – 启用颜色支持。
  • fmt (string) – 日志消息格式。它将应用于日志记录的属性dict。如果颜色支持已打开,则 %(color)s%(end_color)s 之间的文本将根据级别显示颜色。
  • colors (dict) – 从日志级别到终端色码的颜色映射
  • datefmt (string) – 日期时间格式。用于在 prefix_fmt 中格式化 (asctime) 占位符。

在 3.2 版更改: 添加了 fmtdatefmt 参数。

tornado.log.enable_pretty_logging(options=None, logger=None)[源代码]

打开已配置的格式化日志输出。

这由 tornado.options.parse_command_linetornado.options.parse_config_file 自动调用。

tornado.log.define_logging_options(options=None)[源代码]

options 添加与日志相关的标志。

这些选项自动出现在默认选项实例上;此方法只有在您已创建自己的 OptionParser 时才需要。

4.2 新版功能: 这个功能存在于以前的版本,但破碎和无文档,直到4.2。