Integración del ecosistema Lumen En desarrollo
Como herramienta de observabilidad de la capa semántica, Lumen se conecta hacia abajo con el motor de ejecución Kova y la pasarela Lurus API, es compatible lateralmente con LangGraph, y exporta hacia afuera trazas OTel estándar a Grafana / Datadog.
Base de persistencia WAL, recuperación ante fallos en microsegundos.
Reemplazo del Saver en una línea.
Asociación automática de la facturación de tokens.
Exporta trazas estándar.
Con Kova
Kova se encarga de la persistencia del estado WAL de bajo nivel y de la recuperación ante fallos en microsegundos; Lumen se encarga del etiquetado de trazas de la capa semántica y de las estadísticas de coste.
from lumen_ai import LumenCheckpointer
from kova import KovaClient
kova = KovaClient("kova://prod")
graph.compile(checkpointer=LumenCheckpointer(kova_client=kova))Con LangGraph
Reemplazo directo del Saver (la API es totalmente compatible con BaseCheckpointSaver):
- from langgraph.checkpoint.sqlite import SqliteSaver
+ from lumen_ai import LumenCheckpointer
- graph = wf.compile(checkpointer=SqliteSaver.from_conn_string(":memory:"))
+ graph = wf.compile(checkpointer=LumenCheckpointer())Con Lurus API
Al invocar el LLM a través de Lurus API, la facturación de tokens y el tiempo de ejecución se asocian automáticamente a la traza de Lumen:
from openai import OpenAI
from lumen_ai import LumenTracer
client = OpenAI(base_url="https://hub.lurus.cn/v1", api_key="sk-...")
tracer = LumenTracer()
with tracer.span("classify"):
resp = client.chat.completions.create(...)
# 调用自动记录，鹿贝消费可追溯OpenTelemetry
Exportar como traza OTel: LumenTracer(exporters=[to_otlp("http://otel-collector:4317")]) (from lumen_ai.otel import to_otlp).
Grafana / Datadog
El flujo es el siguiente: el SDK de Lumen empuja las trazas al OTel Collector mediante el protocolo OTLP, que luego las distribuye a Grafana Tempo o a Datadog APM:
graph LR
A[Lumen SDK] -->|OTLP| B[OTel Collector]
B --> C[Grafana Tempo]
B --> D[Datadog APM]Las plantillas de paneles de Grafana están en la biblioteca de plantillas oficial de Lurus (busca "Lumen Dashboard").