Tornado 日记记录支持
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 之前已损坏且未记录。