Python logging 模組支援多 Handler 同時輸出不同層級、格式到控制台與檔案。本文提供生產就緒的完整配置範本,含輪轉、格式化、層級過濾、模組化 Logger 獲取。
# -*- coding: utf-8 -*-
import logging
import logging.handlers
import sys
# 1. 基礎配置:檔案 DEBUG 以上
logging.basicConfig(
level=logging.DEBUG,
format='%(asctime)s %(name)-12s %(levelname)-8s %(message)s',
datefmt='%m-%d %H:%M',
filename='myapp.log',
filemode='w' # 'a' 追加
)
# 2. 控制台 Handler:INFO 以上,簡潔格式
console = logging.StreamHandler(sys.stdout)
console.setLevel(logging.INFO)
formatter = logging.Formatter('%(name)-12s: %(levelname)-8s %(message)s')
console.setFormatter(formatter)
# 3. 加入 root logger
logging.getLogger('').addHandler(console)
# 4. (可選) 檔案輪轉:按大小/時間
file_handler = logging.handlers.RotatingFileHandler(
'myapp_rotating.log', maxBytes=10*1024*1024, backupCount=5, encoding='utf-8'
)
file_handler.setLevel(logging.DEBUG)
file_handler.setFormatter(logging.Formatter(
'%(asctime)s %(name)-12s %(levelname)-8s %(message)s'))
logging.getLogger('').addHandler(file_handler)
# 5. 模組化 Logger 使用
logger1 = logging.getLogger('myapp.area1')
logger2 = logging.getLogger('myapp.area2')
logger1.debug('Quick zephyrs blow, vexing daft Jim.')
logger1.info('How quickly daft jumping zebras vex.')
logger2.warning('Jail zesty vixen who grabbed pay from quack.')
logger2.error('The five boxing wizards jump quickly.')
# 控制台 (INFO+) myapp.area1 : INFO How quickly daft jumping zebras vex. myapp.area2 : WARNING Jail zesty vixen who grabbed pay from quack. myapp.area2 : ERROR The five boxing wizards jump quickly. # 檔案 (DEBUG+) 01-15 10:30 myapp.area1 DEBUG Quick zephyrs blow, vexing daft Jim. 01-15 10:30 myapp.area1 INFO How quickly daft jumping zebras vex. 01-15 10:30 myapp.area2 WARNING Jail zesty vixen who grabbed pay from quack. 01-15 10:30 myapp.area2 ERROR The five boxing wizards jump quickly.
import logging.config
import yaml
with open('logging.yaml') as f:
config = yaml.safe_load(f)
logging.config.dictConfig(config)
logging.yaml 可集中管理所有 Logger、Handler、Formatter、Filter,支援環境變數覆蓋,適合容器化部署。
| 概念 | 說明 |
|---|---|
| Logger | 程式碼呼叫入口 (logging.getLogger(__name__)),層級過濾第一道關卡 |
| Handler | 決定輸出去向 (StreamHandler, FileHandler, SysLogHandler, HTTPHandler...) |
| Formatter | 決定輸出格式 (%(asctime)s %(levelname)s %(message)s) |
| Filter | 精細控制哪些 LogRecord 通過 (可注入上下文如 request_id) |
| Level | CRITICAL(50) > ERROR(40) > WARNING(30) > INFO(20) > DEBUG(10) > NOTSET(0) |