Files
douyi_guaji_main/douyin/logging/action_logger.py
T

139 lines
4.9 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""行为日志记录模块:简洁记录关键操作,包含耗时信息。"""
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"]