萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python logging 同時輸出控制台與檔案完整配置

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.

生產環境最佳實踐 (dictConfig / YAML)


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)
LevelCRITICAL(50) > ERROR(40) > WARNING(30) > INFO(20) > DEBUG(10) > NOTSET(0)
copyright © 萬盛學電腦網 all rights reserved