[2.1-2.5] FAM-Core 六个子模块 - Scheduler/Dispatcher/Event-Receiver/Chat-Handler/Member-Manager/Video-Server + DB层 + 配置

fam-core/src/fam_core/logger.py

@@ -0,0 +1,31 @@
+"""
+日志工具 - 统一格式，带 task_id 作为 trace_id
+"""
+import logging
+import sys
+from datetime import datetime
+
+
+def setup_logger(name='fam-core', level=logging.INFO):
+    """配置并返回 logger"""
+    logger = logging.getLogger(name)
+    if logger.handlers:
+        return logger
+    logger.setLevel(level)
+    handler = logging.StreamHandler(sys.stdout)
+    formatter = logging.Formatter(
+        '%(asctime)s [%(name)s] %(levelname)s %(message)s',
+        datefmt='%Y-%m-%d %H:%M:%S'
+    )
+    handler.setFormatter(formatter)
+    logger.addHandler(handler)
+    return logger
+
+
+def log_task(logger, task_id, stage, message, level=logging.INFO, duration_ms=None):
+    """带 task_id 的结构化日志"""
+    parts = [f"[task_id={task_id}]", stage]
+    if duration_ms is not None:
+        parts.append(f"done in {duration_ms}ms")
+    parts.append(message)
+    logger.log(level, ' '.join(parts))