Songhaoz666andClaude Opus 4.8
54cb327348
- 基准标准 v2.1：SwarmMetrics（15 字段）、τ/η/P_decision/reward 公式、对称 G_E,c（修正 C_base=1.0 退化）、Σλ=1.0 校验；新增基线对比与运行记录 schema；指标覆盖缺口分析；参考系数暂留为元数据（待量化）。 - 主控 Agent 实体（分解 / 评审决策 / 汇总）；事件契约修正（timeline.title、budget.threshold_pct、handoff 角色、task.released）+ 契约校验脚本。 - 实质性 LLM 对等回复（含降级回退）；集成契约（runtime / event / usage / audit / frontend / capability / security）；CLIENT_GUIDE 客户端指南；CI 工作流；治理与交付文档。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2.9 KiB
2.9 KiB
Telemetry Architecture（数据采集架构）
状态：规划中（部分信号已发出，统一采集管道未接入）。
依据：Agent 蜂群指标量化与标准 v2.0 §8.2。配套：
swarm-metrics-schema.md、event-schema、audit-trace。O（可观测性）分量来源于本文。
1. 数据来源矩阵（标准 §8.2）
| 指标类型 | 数据来源 | 推荐平台 | 本仓现状 |
|---|---|---|---|
| 任务完成 | Task Logs、Handoff Logs | Elasticsearch | ✅ 任务状态 + 事件流（按 swarm_id）；未汇入 ES |
| 成本 / Token | Runtime Metrics | Prometheus | 🟡 usage 已采集；Prometheus 指标可抓取 |
| 质量 | CI/CD Results、Code Review | 各 CI 平台 | 🔴 未接入 |
| 治理合规 | Audit Logs | OpenTelemetry | 🟡 事件流可作审计源，未独立留存 |
| 通信 | WebSocket Logs | ClickHouse | 🟡 连接事件有日志；消息成功率未计数 |
| 基础设施 | Infrastructure Metrics | Prometheus | 🔴 未接入（cpu/memory/Pod） |
3. 本仓已发出的信号
| 信号 | 实现 | 去向 |
|---|---|---|
| Prometheus 指标 | ✅ 编排器 GET /metrics；Agent METRICS_PORT |
可被 Prometheus 抓取（k8s/prometheus-config.yaml） |
| OpenTelemetry tracing | 🟡 orchestrator/tracing.py（OTEL_EXPORTER_OTLP_ENDPOINT） |
需配置 collector |
| 事件流（lifecycle/DAG/handoff/usage） | ✅ 按 swarm_id 持久化 + 回调 |
Redis + HM 回调；可导出 ClickHouse/ES（未接） |
| 任务/用量/预算 | ✅ /tasks、/metrics、budget.alert |
REST + 事件 |
4. 目标采集管道（草案）
Agent / Orchestrator
├─ Prometheus ← /metrics（指标：任务、时长、并发、被拒/重复、reconnect…）
├─ OpenTelemetry → OTLP collector → trace 存储（task/agent/handoff span）
└─ 事件流（event-schema） → 导出器 → ClickHouse / Elasticsearch（用于 benchmark 聚合与回放）
↑
SwarmMetricsCollector 读取并产出 SwarmMetrics
5. 缺口
| 项 | 状态 |
|---|---|
| Prometheus 指标暴露 | ✅ 已有（指标项可再补：消息成功率、恢复率、治理计数） |
| OTel trace 实际导出 | 🟡 模块在，collector/span 覆盖待完善 |
| 事件 → ClickHouse/ES 导出器 | 🔴 未实现 |
| CI/CD、Git、基础设施指标接入 | 🔴 未实现 |
统一 SwarmMetricsCollector 落地 |
🔴 未实现（见 swarm-metrics-schema §0） |
| 刷新可恢复 / 断线回补（前端） | 🟡 /logs?cursor=（见 frontend-event-api） |
6. 待对齐
- 选定后端（ClickHouse / ES）与 schema、留存期（与 Audit Team）。
- 指标命名规范与标签（
swarm_id/agent_role/scenario）。 - 导出器归属（本仓 exporter vs 平台统一采集）。