feat(otel #876): 双 Claw 强制标签 + 入口接线 + Grafana 双 Claw 对比看板

#876 OpenTelemetry 可观测（双 Claw 标签）：
- app/core/otel.py: 新增 set_otel_ctx/get_otel_ctx(ContextVar 三元组 tenant_id+claw_type+
  trace_id)；current_span_cm 自动注入双 Claw 强制标签，全部 13 个 span 调用点零签名侵入带维度；
  record_span_metrics 指标维度补 tenant_id+claw_type（trace_id 因高基数不计入指标标签）。
- app/core/llm_router.py: set_route_ctx 桥接转调 set_otel_ctx（单次入口注入双端共享：
  路由上下文 + OTel 标签），失败安全。
- app/api/chat.py: send_message 与 send_message_stream 入口注入 set_route_ctx(web)，
  stream 经 asyncio.create_task 子协程自动传播 contextvars，使 _send_message_core 内
  所有 span 均带 tenant_id+claw_type。
- app/api/im_llm.py: _call_real_llm 入口最早注入 set_route_ctx(im_wechat)，并显式开启
  im.send_message span（此前 IM Claw 完全无 span，Grafana 无 IM 数据点），finally 关闭。
- tests/test_dual_claw.py: R-DUAL-6 由 skip 转为确定性断言（Web/IM 双 Claw span 必带
  tenant_id+claw_type），作为持续哨兵。
- 交付 Grafana 双 Claw 对比看板 JSON（aiflow_span_* / aiflow_llm_route_total 按 claw_type
  分组：P50/P95 延迟、成功率、QPS、租户健康 Top10）。Alloy OTLP 仅桥接 metrics→Prometheus，
  trace 无 pipeline（#800 已压制 UNIMPLEMENTED 噪声），看板基于 metrics 出图。

safe-align: 仅复制 5 个 git-tracked 文件，未触碰 secrets/venv/node_modules/caches。本地提交不 push。

backend/python/app/core/llm_router.py

@@ -51,10 +51,20 @@ _route_claw_var: ContextVar[str] = ContextVar("aiflow_route_claw", default="web"
 
 
 def set_route_ctx(*, tenant_id: str = "", claw_type: str = "web") -> None:
-    """在请求入口注入路由上下文。tenant_id/claw_type 为空时保留默认值。"""
+    """在请求入口注入路由上下文（#875）。tenant_id/claw_type 为空时保留默认值。
+
+    #876 桥接：同时注入 OTel 双 Claw 强制标签（set_otel_ctx），使单次入口调用
+    即可让后续所有 span / metric 自动带上 tenant_id + claw_type + trace_id。
+    失败安全：otel 不可用时静默跳过。
+    """
     if tenant_id:
         _route_tenant_var.set(tenant_id)
     _route_claw_var.set(claw_type or "web")
+    try:
+        from app.core.otel import set_otel_ctx
+        set_otel_ctx(tenant_id=tenant_id, claw_type=claw_type or "web")
+    except Exception:
+        pass
 
 
 def get_route_ctx() -> dict:

backend/python/app/core/otel.py

@@ -15,12 +15,21 @@ OpenTelemetry 桥接 (Phase 1.I 标准化)
     init_otel()            首次调用时构建 TracerProvider + MeterProvider（幂等）
     get_tracer()           返回 tracer（未启用/失败则 None）
     get_meter()            返回 meter（未启用/失败则 None）
-    current_span_cm(name)  返回一个 OTel span 的上下文管理器（供 observability 嵌套）
-    record_span_metrics(name, elapsed_ms, status)  记录 span 指标（耗时直方图 + 计数）
+    current_span_cm(name)  返回一个 OTel span 的上下文管理器（供 observability 嵌套）；
+                           **自动注入** tenant_id + claw_type + trace_id 双 Claw 强制标签
+    record_span_metrics(name, elapsed_ms, status)  记录 span 指标（耗时直方图 + 计数，
+                           维度带 tenant_id + claw_type，供 Grafana 双 Claw 对比板）
+    set_otel_ctx(tenant_id, claw_type)  入口注入双 Claw 强制标签（与 llm_router.set_route_ctx 同源）
+    get_otel_ctx()         读取当前 contextvars 三元组 {tenant_id, claw_type, trace_id}
+
+双 Claw 强制标签（#876 §D）：每个 span / metric 必带 tenant_id + claw_type + trace_id
+（+ 业务字段 model / node_type 由 span(name, model=..., node_type=...) 透传）。
+入口调用一次 set_otel_ctx（或 set_route_ctx，已桥接转调），全链路自动带维度，业务零改动。
 """
 
 import os
 import logging
+from contextvars import ContextVar
 
 logger = logging.getLogger(__name__)
 
@@ -35,6 +44,44 @@ _initialized = False
 _duration_hist = None
 _span_counter = None
 
+# ---------------------------------------------------------------------------
+# 强制标签上下文（#876 · 双 Claw 维度）
+# ---------------------------------------------------------------------------
+# 每个 span / metric 必带 tenant_id + claw_type + trace_id（设计书 §D）。
+# 经 contextvars 注入，零签名侵入：入口调用 set_otel_ctx() 一次，
+# 全部 span 经 current_span_cm 自动带上维度，业务侧无需改动。
+# 与 #875 llm_router.set_route_ctx 同源（set_route_ctx 内部转调本函数）。
+_otel_tenant_var: ContextVar[str] = ContextVar("aiflow_otel_tenant", default="")
+_otel_claw_var: ContextVar[str] = ContextVar("aiflow_otel_claw", default="web")
+
+
+def set_otel_ctx(*, tenant_id: str = "", claw_type: str = "web") -> None:
+    """在请求入口注入 OTel 强制标签（双 Claw 维度）。
+
+    与 llm_router.set_route_ctx 共享同一调用点：入口调用一次即可让
+    后续所有 span / metric 自动带上 tenant_id + claw_type + trace_id。
+    """
+    if tenant_id:
+        _otel_tenant_var.set(tenant_id)
+    _otel_claw_var.set(claw_type or "web")
+
+
+def get_otel_ctx() -> dict:
+    """读取当前 OTel 上下文三元组（含 trace_id，复用 observability）。
+
+    失败安全：observability 不可用时 trace_id 回退为 '-'。
+    """
+    try:
+        from app.core.observability import get_trace_id
+        _trace = get_trace_id()
+    except Exception:
+        _trace = "-"
+    return {
+        "tenant_id": _otel_tenant_var.get(),
+        "claw_type": _otel_claw_var.get(),
+        "trace_id": _trace,
+    }
+
 
 def init_otel() -> None:
     """构建 TracerProvider + MeterProvider（幂等）。失败则降级为 no-op。"""
@@ -100,19 +147,32 @@ def get_meter():
 
 
 def current_span_cm(name: str, attributes: dict | None = None):
-    """返回一个 OTel span 的上下文管理器（同步/异步通用）。失败时返回 None。"""
+    """返回一个 OTel span 的上下文管理器（同步/异步通用）。失败时返回 None。
+
+    自动注入双 Claw 强制标签（#876 §D）：tenant_id + claw_type + trace_id。
+    setdefault 语义——业务已显式传入的字段不会被覆盖。
+    """
     tr = get_tracer()
     if tr is None:
         return None
     try:
-        return tr.start_as_current_span(name, attributes=attributes or {})
+        attrs = dict(attributes or {})
+        ctx = get_otel_ctx()
+        attrs.setdefault("tenant_id", ctx["tenant_id"])
+        attrs.setdefault("claw_type", ctx["claw_type"])
+        attrs.setdefault("trace_id", ctx["trace_id"])
+        return tr.start_as_current_span(name, attributes=attrs)
     except Exception as e:  # pragma: no cover
         logger.warning(f"[otel] start_span failed: {e}")
         return None
 
 
 def record_span_metrics(name: str, elapsed_ms: float, status: str) -> None:
-    """记录 span 指标：耗时直方图 + 调用计数（供 Grafana 出图）。失败安全。"""
+    """记录 span 指标：耗时直方图 + 调用计数（供 Grafana 出图）。失败安全。
+
+    指标维度带 tenant_id + claw_type（trace_id 因高基数不计入指标标签，
+    仅作为 span 属性存在）。双 Claw 对比看板据此按 claw_type 分组。
+    """
     m = get_meter()
     if m is None:
         return
@@ -123,7 +183,13 @@ def record_span_metrics(name: str, elapsed_ms: float, status: str) -> None:
                 "aiflow_span_duration_ms", "Span duration in milliseconds"
             )
             _span_counter = m.create_counter("aiflow_span_count", "Span invocation count")
-        attrs = {"span": name, "status": status}
+        ctx = get_otel_ctx()
+        attrs = {
+            "span": name,
+            "status": status,
+            "tenant_id": ctx["tenant_id"],
+            "claw_type": ctx["claw_type"],
+        }
         _duration_hist.record(elapsed_ms, attrs)
         _span_counter.add(1, attrs)
     except Exception:  # pragma: no cover