sycommon-python-lib 0.2.10a10__tar.gz → 0.2.10a11__tar.gz

{sycommon_python_lib-0.2.10a10 → sycommon_python_lib-0.2.10a11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sycommon-python-lib
-Version: 0.2.10a10
+Version: 0.2.10a11
 Summary: Add your description here
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown

{sycommon_python_lib-0.2.10a10 → sycommon_python_lib-0.2.10a11}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sycommon-python-lib"
-version = "0.2.10a10"
+version = "0.2.10a11"
 description = "Add your description here"
 readme = "README.md"
 requires-python = ">=3.11"

{sycommon_python_lib-0.2.10a10 → sycommon_python_lib-0.2.10a11}/src/sycommon/health/readiness.py

@@ -7,9 +7,10 @@ from starlette.concurrency import run_in_threadpool
 
 from sycommon.logging.kafka_log import SYLogger
 
-# DB/Redis 拨测超时（秒）；MQ 通道往返探活略宽
+# DB/Redis 拨测超时（秒）；MQ 通道往返与 LLM 真实补全略宽
 PROBE_TIMEOUT_SECONDS = 3.0
 MQ_PROBE_TIMEOUT_SECONDS = 5.0
+LLM_PROBE_TIMEOUT_SECONDS = 8.0
 
 # 拨测结果 TTL 缓存（秒）：K8s/Nacos/LB 多源轮询直接命中缓存，
 # 避免故障期间探针流量放大成对依赖的额外负载
@@ -17,10 +18,13 @@ PROBE_CACHE_TTL_SECONDS = 2.0
 
 # 等拨测锁超时（秒）：底层库吞取消语义的兜底，防端点整体 wedged。
 # 预算必须覆盖最慢合法路径再加余量：MQ 撞换池窗口的兜底重探最坏
-# 2×MQ_PROBE_TIMEOUT —— 写小了会把正常慢探测误判成 wedged 答 stale
-# （对齐 Go lib fca8ee1 锁预算修复：TTL + 2×MQ + 余量）。
+# 2×MQ_PROBE_TIMEOUT，LLM 网关慢响应最坏 1×LLM_PROBE_TIMEOUT —— 取两者
+# 较大者再配余量（写小了会把正常慢探测误判成 wedged 答 stale，
+# 对齐 Go lib fca8ee1 锁预算修复思路：TTL + 最慢组件 + 余量）。
 LOCK_WAIT_TIMEOUT_SECONDS = (
-    PROBE_CACHE_TTL_SECONDS + 2 * MQ_PROBE_TIMEOUT_SECONDS + 5.0)
+    PROBE_CACHE_TTL_SECONDS
+    + max(2 * MQ_PROBE_TIMEOUT_SECONDS, LLM_PROBE_TIMEOUT_SECONDS)
+    + 5.0)
 
 
 def _skipped(reason: str) -> dict:
@@ -61,10 +65,11 @@ async def _probe_async_engine(engine) -> None:
         await connection.execute(text("SELECT 1"))
 
 
-async def _timed_probe(coro, timeout: float, probe_name: str) -> dict:
+async def _timed_probe(coro, timeout: float, probe_name: str, **extra) -> dict:
     """单组件拨测统一包裹：计时 + 超时 + 异常→DOWN，互不影响其他组件。
 
     error 只含异常类型名（详见 _err_type_only）；完整异常进 WARNING 日志。
+    extra 透传进 UP/DOWN 的 details（如 LLM 拨测的 model 名）。
     """
     start = time.monotonic()
     try:
@@ -76,6 +81,7 @@ async def _timed_probe(coro, timeout: float, probe_name: str) -> dict:
                 "probe": probe_name,
                 "error": "probe timeout",
                 "latency_ms": round((time.monotonic() - start) * 1000, 1),
+                **extra,
             },
         }
     except Exception as e:
@@ -90,6 +96,7 @@ async def _timed_probe(coro, timeout: float, probe_name: str) -> dict:
                 "probe": probe_name,
                 "error": _err_type_only(e),
                 "latency_ms": round((time.monotonic() - start) * 1000, 1),
+                **extra,
             },
         }
     return {
@@ -97,6 +104,7 @@ async def _timed_probe(coro, timeout: float, probe_name: str) -> dict:
         "details": {
             "probe": probe_name,
             "latency_ms": round((time.monotonic() - start) * 1000, 1),
+            **extra,
         },
     }
 
@@ -283,13 +291,92 @@ async def _probe_mq_pool_alive(pool) -> None:
         raise RuntimeError("mq connection not alive")
 
 
+async def _check_llm() -> dict:
+    """LLM 拨测：配置里没有任何 LLMConfig → SKIPPED（纯中间件服务不掺和）；
+    有配置则取 default 模型发一条 "1+1=" 真实补全，收到非空回复即 UP。
+
+    「能正常返回数据」的判定：通道通但 content 为空（网关 200 空补全）
+    同样算 DOWN —— 空回复对消费方等于不可用。错误只回显类型名/HTTP
+    状态码（同 _err_type_only 脱敏标准，网关错误文案可能内嵌上游信息）。
+    max_tokens 固定 16：拨测只要一个数字，防推理模型把输出预算烧满。
+    timeout 固定拨测预算（覆盖客户端默认 180s —— readiness 要求秒级）。
+    """
+    from sycommon.config.Config import Config
+
+    try:
+        cfg = Config()
+        default_cfg = cfg.get_default_llm_config()
+        model = default_cfg.get("model")
+        has_configs = bool(cfg.llm_configs)
+    except Exception:
+        has_configs = False
+        model = None
+
+    if not has_configs or not model:
+        if _declared("llm"):
+            return {
+                "status": "DOWN",
+                "details": {"reason": "llm declared but no LLMConfig loaded"},
+            }
+        return _skipped("no LLMConfig loaded")
+
+    async def _probe_llm_chat() -> None:
+        from langchain_core.messages import HumanMessage
+
+        from sycommon.llm.get_llm import get_llm
+
+        # thinking=False（指令模式）：get_llm 注入
+        # chat_template_kwargs.enable_thinking=False —— 推理模型（默认条目
+        # Qwen3.8-Flash-Next 实测）开着思考时 16 token 全烧在 reasoning、
+        # content 为 None → 撞 length 上限被空回复哨兵误判 DOWN；关思考后
+        # 同一预算直接吐 "1 + 1 = 2"。max_tokens=16 同理：拨测只要一个数字，
+        # 防推理模型把输出预算烧满；timeout 固定拨测预算（覆盖客户端默认
+        # 180s —— readiness 要求秒级）。
+        llm = get_llm(
+            model,
+            wrap_structured=False,
+            thinking=False,
+            max_retries=1,
+            timeout=LLM_PROBE_TIMEOUT_SECONDS,
+            max_tokens=16,
+            temperature=0,
+        )
+        # 拨测无请求上下文，强制走 nacos 全局 apiKey
+        #（current_llm_api_key 为空时 resolve_api_key 自会回退配置值）。
+        resp = await llm.ainvoke([HumanMessage(content="1+1=")])
+        content = resp.content if hasattr(resp, "content") else ""
+        if isinstance(content, list):  # 多模态 content 分片 → 拼纯文本
+            content = "".join(
+                part.get("text", "") for part in content
+                if isinstance(part, dict))
+        if not str(content).strip():
+            raise _EmptyCompletionError()
+
+    try:
+        return await _timed_probe(
+            _probe_llm_chat(), LLM_PROBE_TIMEOUT_SECONDS,
+            "chat completions", model=model)
+    except Exception as e:
+        SYLogger.warning(
+            f"[READINESS] llm check failed: {type(e).__name__}")
+        return {
+            "status": "DOWN",
+            "details": {"error": _err_type_only(e)},
+        }
+
+
+class _EmptyCompletionError(Exception):
+    """空回复哨兵：类型名即脱敏文案（通道通但没吐字）。"""
+
+
 def setup_readiness_handler(app: FastAPI):
-    """挂载 GET /actuator/health/readiness：按需拨测 DB/Redis/MQ。
+    """挂载 GET /actuator/health/readiness：按需拨测 DB/Redis/MQ/LLM。
 
     组件是否「在用」由各服务单例运行时状态判定（零配置）：
     - database: DatabaseService/AsyncDatabaseService engine 存在
     - redis:    RedisService.is_initialized()
     - mq:       RabbitMQService.is_configured()（mq.yml 已加载）
+    - llm:      Config 里存在 LLMConfig 条目（默认模型真实补全往返）
 
     在用组件任一 DOWN → HTTP 503；SKIPPED 不影响。
     结果带 PROBE_CACHE_TTL_SECONDS 缓存：多探针源（K8s/Nacos/LB）轮询
@@ -328,9 +415,9 @@ def setup_readiness_handler(app: FastAPI):
         # 单组件异常/导入失败不得炸掉整个 gather（否则取消兄弟任务）；
         # gather return_exceptions + 逐个兜底
         results = await asyncio.gather(
-            _check_database(), _check_redis(), _check_mq(),
+            _check_database(), _check_redis(), _check_mq(), _check_llm(),
             return_exceptions=True)
-        names = ("database", "redis", "mq")
+        names = ("database", "redis", "mq", "llm")
         components = {}
         for name, res in zip(names, results):
             if isinstance(res, BaseException):

{sycommon_python_lib-0.2.10a10 → sycommon_python_lib-0.2.10a11}/src/sycommon/logging/kafka_log.py

@@ -430,6 +430,11 @@ class KafkaSink:
                 "sySpanId": "",
                 "syBizId": "",
                 "ptxId": "",
+                # 2026-10-14 补齐(Java starter-log 字段表 30 项全集对照):
+                # pSpanId/pAgentId 在 Java 侧从 MDC PspanId / pinpoint.agentId
+                # 读,常态空但键存在 — 缺键会让 ES mapping/平台列两侧不齐
+                "pSpanId": "",
+                "pAgentId": "",
                 "time": record["time"].strftime("%Y-%m-%d %H:%M:%S,%f")[:-3],
                 "day": datetime.now().strftime("%Y.%m.%d"),
                 "msg": _msg_str,

{sycommon_python_lib-0.2.10a10 → sycommon_python_lib-0.2.10a11}/src/sycommon_python_lib.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sycommon-python-lib
-Version: 0.2.10a10
+Version: 0.2.10a11
 Summary: Add your description here
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown