TimedRotatingFileHandler YAML 配置讓框架內部日誌同步生效Tornado 內建日誌若不特別配置,預設只輸出到控制台。採用 logging.config.dictConfig + YAML 配置 TimedRotatingFileHandler,可實現按天/小時分割、多 Logger 統一輸出、格式標準化。
logging.yaml
version: 1
disable_existing_loggers: false
formatters:
simple:
format: '%(asctime)s - %(name)s - %(levelname)s - %(message)s'
loggers:
all:
handlers: [all]
propagate: false
tornado:
handlers: [all]
propagate: false
handlers:
console:
class: logging.StreamHandler
level: INFO
formatter: simple
stream: ext://sys.stdout
all:
class: logging.handlers.TimedRotatingFileHandler
level: INFO
formatter: simple
when: midnight
filename: ./logs/server.log
root:
level: INFO
handlers: [console, all]
propagate: true
disable_existing_loggers: false:保留 Tornado 已建立的 logger(tornado.access、tornado.application、tornado.general)。loggers.tornado:明確指定 Tornado logger 使用 all handler,否則其日誌不會進檔案。when: midnight:每天 00:00 分割(含時區感知),優於 D(啟動後每 24h)。propagate: false:避免日誌重複向 root 傳播導致雙份輸出。
import yaml, logging.config
logging.config.dictConfig(yaml.load(open('logging.yaml', 'r')))
置於 Tornado Application 建立前、IOLoop.start() 前。
when 參數| 值 | 分割週期 | 備註 |
|---|---|---|
S | 秒 | 測試用 |
M | 分 | |
H | 時 | 高頻服務 |
D | 天 | 從啟動時間起算 24h |
midnight | 每日 00:00 | 推薦生產環境 |
W0-W6 | 週一~週日 | 週分割 |