tornado.log ---日志支持

Tornado 的日志支持。

Tornado使用日志记录器流：

• tornado.access ：按请求记录Tornado的HTTP服务器（以及未来可能的其他服务器）

• tornado.application ：记录应用程序代码中的错误（即回调中未捕获的异常）

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

这些流可以使用标准库的 logging 模块。例如，您可能希望发送 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) -- 日志消息格式。它将应用于日志记录的属性dict。文本介于 %(color)s 和 %(end_color)s 如果启用颜色支持，将根据级别进行着色。

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

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

在 3.2 版更改: 补充 fmt 和 datefmt 参数。

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

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

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

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

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

这些选项会自动出现在默认选项实例上；只有在创建了自己的选项实例后，才需要使用此方法。 OptionParser .

4.2 新版功能: 此函数存在于以前的版本中，但在4.2之前已被破坏和未记录。