Heron 流量观测
从网络流量还原 Agent 调用与 LLM 性能,无需修改工作负载代码。
- 源仓库
- Netis/heron
- Star 数
- ★ 104
- 最近更新
- 1 个月前
- License
- Apache-2.0
- 主语言
- Rust
- FA 评分
- 68/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API · Claude APICodex · Claude Code(部分支持)
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- Agent 开发者排查工具调用停滞或计划循环时,用回合时间线查看完整调用链。
- 不适合
- 只能在客户端安装监控工具、无法提供明文流量的团队
- 需要跨集群客户端链路追踪的团队
- 官网
- heron-ai.pages.dev ↗ 来自 GitHub 仓库设置
- 维护状态
- 近半年有提交最近提交 2026-10-12最新版本 v0.8.3(2026-10-12)
- 源码审查
- 68/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
Heron 是一款被动式 Agent 与 LLM 可观测工具,通过 libpcap、PCAP 回放、cloud-probe 的 ZMQ 输入或实验性的 Linux eBPF SSL uprobes 获取流量。并行工作线程解析 HTTP/SSE、识别线协议 API 并提取语义,再由 turn tracker 组合 Agent 回合,指标聚合器计算性能数据。DuckDB 是默认的嵌入式存储,也可配置 ClickHouse;内置 REST API 和嵌入式 React 控制台在 localhost:3000 提供查询与可视化。它运行在流量已解密的位置,或在 Linux 上选择启用 eBPF,在请求路径之外观测服务。除 OpenAI、Anthropic 和 Gemini 接口外,README 还列出 Claude Code 与 OpenAI Codex CLI 的命名 Agent 配置文件。
Heron 从实时网卡、.pcap 文件或 cloud-probe ZMQ 流读取数据,并可选用 Linux eBPF SSL uprobes 在进程的 SSL_read/SSL_write 边界采集 TLS 流量。它按连接分派数据,解析 HTTP/SSE,并检测 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 和 Gemini AI Studio 等线协议。语义提取结果被 turn tracker 拼接为 Agent 回合与会话;系统记录 TTFT、端到端延迟、TPOT、吞吐量、错误率等指标,并保存结构化请求/响应及原始正文。用户可通过 REST API 或 localhost:3000 的控制台查看调用、回合、服务拓扑和性能,也可将回合或会话导出为 OpenAI 风格 messages JSONL。
- Agent 开发者排查工具调用停滞或计划循环时,用回合时间线查看完整调用链。
- 推理平台团队需要厘清 LiteLLM 到 vLLM、SGLang 等后端的服务路径时,用拓扑图和逐跳指标检查流量。
- 运维团队要比较不同模型端点的 TTFT、延迟、吞吐量和错误率时,从真实请求流量汇总指标。
- 合规或安全团队需要按 Agent 类型和会话查看请求及响应证据时,使用调用详情与原始 HTTP 页面。
- 模型训练团队希望复用真实 Agent 运行数据时,将选定回合或会话导出为 JSONL 轨迹。
如何安装或部署这个 Agent?
Linux 或 macOS 可使用用户级安装脚本;此路径不需要 sudo。要实时抓取网卡流量,Linux 需要 CAP_NET_RAW;Linux eBPF TLS 采集是可选实验功能,需要以 ebpf cargo feature 构建、CAP_BPF 和内核 BTF。也可以先用已有 PCAP 回放,无需抓包权限。
如何使用这个 Agent?
先安装并回放 PCAP,再打开本地控制台。实时接口采集可改用 -i 参数;该模式需要相应抓包权限。
这个 Agent 有哪些优点和局限?
- 观测器在请求路径之外运行,不需要修改 Agent 或 SDK,也不会因观测器故障阻断被观测调用。
- turn tracker 自动将规划、工具调用和结果串成可查询的 Agent 回合。
- 同一套解析覆盖 OpenAI、Anthropic、Gemini 及 OpenAI 兼容服务,并支持导出 JSONL 训练轨迹。
- 默认使用单文件嵌入式 DuckDB,并提供可选 ClickHouse 后端和嵌入式控制台。
- 常规抓包只能读取明文 HTTP;部署点必须位于流量已解密处,或提供可信流量源。
- Linux eBPF TLS 采集标为实验性功能,且要求 CAP_BPF、内核 BTF 和启用 ebpf 构建特性。
- README 明确说明不提供跨集群客户端追踪。
- ClickHouse 适用于高流量分析,但需要额外配置;PostgreSQL 后端尚未接通。
这个 Agent 与同类方案有什么区别?
与 SDK 埋点相比,Heron 不需要逐个客户端改造,但依赖可观测的明文流量;与反向代理相比,它不在请求路径中,也不要求客户端改指代理;与服务器端 OpenTelemetry 相比,它从流量重建调用与回合,不依赖服务端发出标签。README 同时指出,Heron 不提供跨集群客户端追踪。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Heron 流量观测 当前 | 68 · 存在缺口 | 命令行工具免费 | ★ 104 | 1 个月前 | Rust | OpenAI API · Claude API |
| ClawMetry | 71 · 存在缺口 | 命令行工具免费版 + 付费版 | ★ 439 | 1 天前 | Python | Codex · Claude Code |
| Langtrace | 48 · 缺口较多 | 代码库 / SDK免费版 + 付费版 | ★ 1.2k | 1 年前 | TypeScript | OpenAI API · Claude API |
| AgentSight | 69 · 存在缺口 | 命令行工具免费 | ★ 801 | 1 天前 | C | Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
安装文档提供用户本地安装、文件能力和 systemd 能力收窄等选项,且 eBPF 明确为可选;但实时抓包仍需较强权限,外部调用者可通过 API 更新采集源并触发重启,材料没有展示该操作的确认或授权机制,因此未给满分。文档明确说明会捕获明文并可保存完整请求/响应、pcap 和遥测数据,也给出保留期及卸载备份提示;但样本未展示敏感字段脱敏或访问控制策略。安装脚本通过 curl 管道执行,虽提供校验和说明,仍未见依赖锁定或依赖审计证据。
README、安装和配置文档对 pcap 回放后服务继续运行、保留期及构建 console 的注意事项基本一致;API 与捕获源码也展示了明确的错误映射及能力门控。材料提到 CI、故障注入和迁移测试,但这些是仓库文档中的陈述,且当前包未完整提供工作流、测试实现或全部代码,故只能部分采信,未给满分。
材料覆盖开发、推理运维、财务、合规和训练场景,提供多种采集源、存储选择、平台说明及环境要求,因此受众和使用场景描述充分。边界也有说明,包括明文可见性要求、HTTP/1.x 限制、eBPF 实验状态及不支持的导出格式;但部分能力覆盖范围主要由 README 声称,样本不足以全面核实,触发条件与适用环境也未形成完整决策指南。
文档入口、架构、配置、安装、术语表和变更记录组织清晰;安装、权限、验证、构建和卸载说明较具体。Apache-2.0 与许可证文件相符。README 描述版本和路线图,但当前样本未包含完整变更记录、发布流程或维护责任人信息;FAQ 与例子覆盖面良好但不完整。AGENTS.md/CLAUDE.md 同时含开发规范与产品架构背景,部分内容像贡献者指引,不能完全视为面向用户的产品说明。
产品将网络流量重建为调用、Agent turns、服务拓扑、指标和可导出的训练数据,面向给定场景有明确增量价值;界面、API、指标和回放工作流的输出用途具体。安装文档说明了权限与资源配置取舍,但对高吞吐量下的存储成本、明文数据治理成本及部署运维成本没有充分量化,故成本收益未给满分。
README 的架构与功能描述可由配置、API、采集源码及安装说明部分交叉印证,限制和实验特性也有明确标示。CI 与 soak 的质量声明在所给材料中主要是描述,不能当作已独立验证的结果;样本文件不完整,部分核心实现和 changelog 细节不可见。总体有一定事实与推断区分,但多项产品性能与覆盖率主张仍缺少样本内的直接证据。
- 采集内容可能包含提示词、模型响应、工具调用及其他敏感明文;上线前核实监听地址、API 访问控制、数据目录权限和保留策略。
- 实时抓包和 eBPF 需要高权限能力;eBPF 为实验功能且需要特定内核条件。
- 安装示例会下载并执行脚本;部署前审阅脚本并按文档校验发布校验和。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v0.8.3 Heron v0.8.3
发布说明摘录
[0.8.3] — 2026-10-12 Fixed - Active calls climbed without bound and never came back down. A deployment whose real concurrency peaked at 28 reported a near-constant 16,600 globally and 48,878 for one model. Concurrency was tracked as +1 per Start and −1 per Complete *by dimension*, and the two events name the model from different places: the Start from the request, the Complete from the response. A server that answers a request for one name with another — an alias, a canonical id — left every such call counted forever, and because …在 GitHub 查看 ↗ -
v0.8.2 Heron v0.8.2
发布说明摘录
[0.8.2] — 2026-09-16 Performance - **Opening a large agent turn, and the services topology graph, were spending almost all of their time in one search.** aglake charges a fixed cost per search-position term, linear in the number of terms and independent of how many events match, so the no-JOIN read pattern — fetch the parent, then id IN (?, ?, …) for its children — bought nothing from batching the ids into one query and paid for every one of them serially. Measured on a production instance: opening an agent turn cost about 35 ms per call it contained, so the …在 GitHub 查看 ↗ -
v0.8.1 Heron v0.8.1
发布说明摘录
[0.8.1] — 2026-09-12 v0.8.0 was tagged from this same content but never released: the aarch64-unknown-linux-musl leg of the release matrix failed to link, so no release was created and nothing shipped. 0.8.1 is that content plus the build fix — there is no released 0.8.0 to upgrade from. Changed - The aglake storage backend now targets aglake 0.3 and is named for it. The log platform Heron writes to renamed itself from sglog to Netis Aglake, and made the rename a breaking boundary rather than an alias layer — the REST …在 GitHub 查看 ↗
常见问题
Heron 是否需要付费 LLM 服务或 API 密钥?
我能在加密流量上直接运行普通抓包吗?
实时抓包需要什么权限?
PCAP 回放结束后,控制台会关闭吗?
Heron 能提供跨集群客户端链路追踪吗?
Heron 流量观测 官网是什么?
Heron 流量观测 开源吗?
Heron 流量观测 还在维护吗?
Heron 流量观测 是谁开发的?
谢谢反馈,我们会据此改进页面。