Intégration de l’écosystème Lumen En développement
En tant qu’outil d’observabilité de la couche sémantique, Lumen se connecte en aval au moteur d’exécution Kova et à la passerelle Lurus API, reste compatible latéralement avec LangGraph et exporte vers l’extérieur des traces OTel standard vers Grafana / Datadog.
Socle de persistance WAL, reprise après panne à l’échelle de la microseconde.
Remplacement du Saver en une ligne.
Association automatique de la facturation des tokens.
Export de traces standard.
Avec Kova
Kova prend en charge la persistance de l’état WAL de bas niveau et la reprise après panne à l’échelle de la microseconde ; Lumen gère l’annotation des traces de la couche sémantique et le suivi des coûts.
from lumen_ai import LumenCheckpointer
from kova import KovaClient
kova = KovaClient("kova://prod")
graph.compile(checkpointer=LumenCheckpointer(kova_client=kova))Avec LangGraph
Remplacez directement le Saver (l’API est entièrement compatible avec 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())Avec Lurus API
Lorsque vous appelez un LLM via Lurus API, la facturation des tokens et la latence sont automatiquement associées à la trace 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
Exportez sous forme de trace OTel : LumenTracer(exporters=[to_otlp("http://otel-collector:4317")]) (from lumen_ai.otel import to_otlp).
Grafana / Datadog
Le flux est le suivant : le SDK Lumen pousse les traces vers l’OTel Collector via le protocole OTLP, qui les distribue ensuite à Grafana Tempo ou à Datadog APM :
graph LR
A[Lumen SDK] -->|OTLP| B[OTel Collector]
B --> C[Grafana Tempo]
B --> D[Datadog APM]Les modèles de tableaux de bord Grafana sont disponibles dans la bibliothèque officielle de modèles Lurus (recherchez « Lumen Dashboard »).