阅读(1512) (0)

Tornado 日记记录支持

2022-03-11 09:54:12 更新

Tornado 使用三个记录器流:

  • tornado.access​:Tornado 的 HTTP 服务器(以及可能在​future​中的其他服务器)的每个请求日志记录
  • tornado.application​:记录应用程序代码中的错误(即回调中未捕获的异常)
  • tornado.general​:通用日志记录,包括来自 Tornado 本身的任何错误或警告。

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

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, 50: 5})

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

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

  • 登录到支持它的终端时显示对应支持的颜色。
  • 每个日志行上的时间戳。
  • 对 str/bytes 编码问题具有抵抗性。

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

不支持 ANSI 颜色代码的 Windows 版本的颜色支持通过使用 ​colorama库启用。 希望使用它的应用程序必须首先通过调用 ​colorama.init​ 来初始化 ​colorama​。

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

参数:

color(bool) – 启用颜色支持。

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

colors(dict) – 从日志级别到终端颜色代码的颜色映射

datefmt(str) -- 日期时间格式。 用于在 ​prefix_fmt中格式化 ​(asctime)​ 占位符。

在 3.2 版更改: 添加了 ​fmt和 ​datefmt参数。

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

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

这是由 ​tornado.options.parse_command_line​ 和 ​tornado.options.parse_config_file​ 自动调用的。

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

将与日志记录相关的标志添加到选项。

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

4.2 版中的新功能:此功能在以前的版本中存在,但在 4.2 之前已损坏且未记录。