"""日志初始化:控制台 + 按大小滚动的文件。 原项目全程 print,容器里 detached 运行就查不到历史,出问题无法回溯。 这里统一收口到 logging,容器 stdout 由 docker json-file 限制大小,文件另有 5MB 滚动。 """ from __future__ import annotations import logging import sys from logging.handlers import RotatingFileHandler from pathlib import Path def setup_logging(log_dir: Path, level: str = "INFO", max_bytes: int = 5 * 1024 * 1024, backup_count: int = 5) -> logging.Logger: log_dir.mkdir(parents=True, exist_ok=True) root = logging.getLogger() root.setLevel(getattr(logging, level.upper(), logging.INFO)) # 避免重复初始化(测试中多次调用) for h in list(root.handlers): root.removeHandler(h) fmt = logging.Formatter( "%(asctime)s %(levelname)-7s [%(name)s] %(message)s", datefmt="%Y-%m-%d %H:%M:%S", ) console = logging.StreamHandler(stream=sys.stdout) console.setFormatter(fmt) root.addHandler(console) file_handler = RotatingFileHandler( log_dir / "monitor.log", maxBytes=max_bytes, backupCount=backup_count, encoding="utf-8", ) file_handler.setFormatter(fmt) root.addHandler(file_handler) # requests/urllib3 的连接细节太吵,只留警告 logging.getLogger("urllib3").setLevel(logging.WARNING) return root