可观测性¶
HiveFlow 暴露指标、审计日志,以及可选的 OpenTelemetry 追踪。
Studio 分析¶
启用真实模式后,Analytics 仪表盘读取:
GET /api/analytics/prometheus— 聚合的 Prometheus 风格指标- 工作流执行中的节点耗时统计(
record_node_execution)
Core 指标¶
from hiveflow import MetricsCollector
collector = MetricsCollector()
collector.record_counter("intents_scheduled", 1)
OpenTelemetry(可选)¶
安装 SDK extra 并配置 tracer:
pip install opentelemetry-api opentelemetry-sdk
from hiveflow.observability.tracing import create_tracer
tracer = create_tracer("my-service", sampling_rate=1.0)
with tracer.start_span("orchestrate") as span:
span.set_attribute("intent_id", "task-1")
若未安装 OpenTelemetry,HiveFlow 会回退到轻量级进程内 span 实现。
Studio 中的追踪¶
- Tracer 页面 — 实时事件流
- Replay(
/replay)— 按intent_id/trace_id索引的审计历史
生产环境¶
Prometheus 抓取端点与 Docker Compose 示例请参阅 部署。