Lumen 생태계 통합 개발 중
Lumen은 시맨틱 계층 관측 도구로서, 아래로는 Kova 실행 엔진과 Lurus API 게이트웨이에 연결되고, 옆으로는 LangGraph와 호환되며, 밖으로는 표준 OTel 트레이스를 Grafana / Datadog으로 내보냅니다.
Kova
WAL 영속화 기반, 마이크로초 단위 크래시 복구.
LangGraph
한 줄로 Saver 교체.
Lurus API
Token 과금 자동 연동.
OTel / Grafana / Datadog
표준 트레이스 내보내기.
Kova와 통합
Kova는 하위 계층의 WAL 상태 영속화와 마이크로초 단위 크래시 복구를 담당하고, Lumen은 시맨틱 계층의 트레이스 어노테이션과 비용 집계를 담당합니다.
python
from lumen_ai import LumenCheckpointer
from kova import KovaClient
kova = KovaClient("kova://prod")
graph.compile(checkpointer=LumenCheckpointer(kova_client=kova))LangGraph와 통합
Saver를 직접 교체하면 됩니다(API가 BaseCheckpointSaver와 완전히 호환):
diff
- 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())Lurus API와 통합
Lurus API를 통해 LLM을 호출하면 Token 과금과 소요 시간이 자동으로 Lumen 트레이스에 연동됩니다:
python
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
OTel 트레이스로 내보내기: LumenTracer(exporters=[to_otlp("http://otel-collector:4317")])(from lumen_ai.otel import to_otlp).
Grafana / Datadog
링크 구조는 다음과 같으며, Lumen SDK가 OTLP 프로토콜로 트레이스를 OTel Collector에 푸시한 뒤, 다시 Grafana Tempo 또는 Datadog APM으로 분배합니다:
graph LR
A[Lumen SDK] -->|OTLP| B[OTel Collector]
B --> C[Grafana Tempo]
B --> D[Datadog APM]Grafana 대시보드 템플릿은 Lurus 공식 템플릿 라이브러리에서 확인하세요("Lumen Dashboard" 검색).