139 lines
4.9 KiB
Python
139 lines
4.9 KiB
Python
"""行为日志记录模块:简洁记录关键操作,包含耗时信息。"""
|
||
from __future__ import annotations
|
||
|
||
import time
|
||
import logging
|
||
import os
|
||
from typing import Any, Dict, Optional
|
||
from .log_formatter import format_action_log
|
||
from .performance_tracker import PerformanceTracker
|
||
|
||
_perf = PerformanceTracker()
|
||
_logger = logging.getLogger("action_logger")
|
||
if not _logger.handlers:
|
||
_logger.setLevel(logging.INFO)
|
||
|
||
# 添加控制台处理器
|
||
_console_handler = logging.StreamHandler()
|
||
_logger.addHandler(_console_handler)
|
||
|
||
# 添加文件处理器,写入到 actions.log
|
||
try:
|
||
# 获取日志目录
|
||
log_dir = os.path.join(os.path.dirname(os.path.dirname(os.path.dirname(__file__))), "logs")
|
||
os.makedirs(log_dir, exist_ok=True)
|
||
|
||
actions_log_path = os.path.join(log_dir, "actions.log")
|
||
|
||
# 创建轮转文件处理器(使用 SafeRotatingFileHandler 以应对 Windows 上文件被外部程序占用导致的重命名失败)
|
||
import time
|
||
import shutil
|
||
from logging.handlers import RotatingFileHandler
|
||
|
||
class SafeRotatingFileHandler(RotatingFileHandler):
|
||
"""在 rotate 时对 PermissionError 做重试与回退拷贝,减少因外部进程占用文件导致的异常"""
|
||
|
||
def rotate(self, source: str, dest: str) -> None: # type: ignore[override]
|
||
try:
|
||
super().rotate(source, dest)
|
||
return
|
||
except PermissionError:
|
||
# 重试若干次(短等待),常见于文件被短期占用
|
||
for attempt in range(3):
|
||
try:
|
||
time.sleep(0.1 * (attempt + 1))
|
||
super().rotate(source, dest)
|
||
return
|
||
except PermissionError:
|
||
continue
|
||
|
||
# 回退方案:尝试拷贝到目标文件然后截断原文件
|
||
try:
|
||
shutil.copy2(source, dest)
|
||
try:
|
||
with open(source, "w", encoding=getattr(self, "encoding", None) or "utf-8"):
|
||
pass
|
||
except Exception:
|
||
pass
|
||
return
|
||
except Exception:
|
||
try:
|
||
super().rotate(source, dest)
|
||
except Exception:
|
||
return
|
||
|
||
_file_handler = SafeRotatingFileHandler(
|
||
actions_log_path,
|
||
maxBytes=10 * 1024 * 1024, # 10MB
|
||
backupCount=5,
|
||
encoding="utf-8",
|
||
)
|
||
_file_handler.setFormatter(logging.Formatter('%(asctime)s - %(message)s'))
|
||
_logger.addHandler(_file_handler)
|
||
except Exception:
|
||
# 如果文件处理器创建失败,至少保留控制台输出
|
||
pass
|
||
|
||
class ActionLogger:
|
||
def log_operation(self, operation: str, details: Optional[str] = None, **kwargs: Any) -> None:
|
||
extra = dict(kwargs)
|
||
elapsed = None
|
||
if "elapsed" in extra:
|
||
elapsed = extra.pop("elapsed")
|
||
elif "elapsed_seconds" in extra:
|
||
elapsed = extra.pop("elapsed_seconds")
|
||
|
||
elapsed_val = None
|
||
if elapsed is not None:
|
||
try:
|
||
# 统一保留两位小数,便于日志阅读
|
||
elapsed_val = round(float(elapsed), 2)
|
||
extra["elapsed_seconds"] = elapsed_val
|
||
except Exception:
|
||
elapsed_val = None
|
||
|
||
# 标记异常慢的操作(阈值可调整)
|
||
if elapsed_val is not None and elapsed_val >= 10.0:
|
||
extra["slow"] = 1
|
||
|
||
msg = format_action_log(operation, details or "", **extra)
|
||
_logger.info(msg)
|
||
|
||
def log_step(self, name: str, elapsed: Optional[float] = None) -> None:
|
||
self.log_operation("Step", name, elapsed=elapsed)
|
||
|
||
|
||
# ============================================================
|
||
# track_action 装饰器(合并自 action_tracker.py)
|
||
# ============================================================
|
||
from functools import wraps as _wraps # noqa: E402
|
||
|
||
|
||
_action_logger_singleton = ActionLogger()
|
||
|
||
|
||
def track_action(name: str = ""):
|
||
"""函数装饰器:自动记录函数耗时与操作信息。"""
|
||
|
||
def decorator(func):
|
||
@_wraps(func)
|
||
def wrapper(*args, **kwargs):
|
||
timer = _perf.start_timer(name or func.__name__)
|
||
t0 = time.time()
|
||
try:
|
||
return func(*args, **kwargs)
|
||
finally:
|
||
elapsed = _perf.end_timer(timer)
|
||
if elapsed is None:
|
||
elapsed = time.time() - t0
|
||
_action_logger_singleton.log_step(
|
||
name or func.__name__, elapsed=elapsed
|
||
)
|
||
|
||
return wrapper
|
||
|
||
return decorator
|
||
|
||
|
||
__all__ = ["ActionLogger", "track_action"]
|