Heron 流量观测

从网络流量还原 Agent 调用与 LLM 性能,无需修改工作负载代码。

源仓库
Netis/heron
Star 数
★ 104
最近更新
1 个月前
License
Apache-2.0
主语言
Rust

30 秒速览

运行形态
命令行工具网页应用自托管服务
可在哪里用
通用 · 跨平台OpenAI API · Claude APICodex · Claude Code(部分支持)
费用
免费,无需付费服务
上手难度
低 · 几分钟可跑通
开始前需要
libpcapDuckDBClickHouse(可选)Shell / 命令行网络访问本地文件系统
典型场景
Agent 开发者排查工具调用停滞或计划循环时,用回合时间线查看完整调用链。
不适合
  • 只能在客户端安装监控工具、无法提供明文流量的团队
  • 需要跨集群客户端链路追踪的团队
官网
heron-ai.pages.dev ↗ 来自 GitHub 仓库设置
维护状态
近半年有提交最近提交 2026-10-12最新版本 v0.8.3(2026-10-12)

这个 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。

  1. Agent 开发者排查工具调用停滞或计划循环时,用回合时间线查看完整调用链。
  2. 推理平台团队需要厘清 LiteLLM 到 vLLM、SGLang 等后端的服务路径时,用拓扑图和逐跳指标检查流量。
  3. 运维团队要比较不同模型端点的 TTFT、延迟、吞吐量和错误率时,从真实请求流量汇总指标。
  4. 合规或安全团队需要按 Agent 类型和会话查看请求及响应证据时,使用调用详情与原始 HTTP 页面。
  5. 模型训练团队希望复用真实 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?

FollowAgents 源码审查 · FARS-2.1
存在缺口
68/ 100 五分制 3.4 / 5
信任安全 14/29
可靠稳定 9/14
适用触发 14/18
规范维护 14/18
有效结果 12/13
证据核验 5/8
查看各维度的扣分理由
信任安全14 / 29 · 2.4/5

安装文档提供用户本地安装、文件能力和 systemd 能力收窄等选项,且 eBPF 明确为可选;但实时抓包仍需较强权限,外部调用者可通过 API 更新采集源并触发重启,材料没有展示该操作的确认或授权机制,因此未给满分。文档明确说明会捕获明文并可保存完整请求/响应、pcap 和遥测数据,也给出保留期及卸载备份提示;但样本未展示敏感字段脱敏或访问控制策略。安装脚本通过 curl 管道执行,虽提供校验和说明,仍未见依赖锁定或依赖审计证据。

可靠稳定9 / 14 · 3.2/5

README、安装和配置文档对 pcap 回放后服务继续运行、保留期及构建 console 的注意事项基本一致;API 与捕获源码也展示了明确的错误映射及能力门控。材料提到 CI、故障注入和迁移测试,但这些是仓库文档中的陈述,且当前包未完整提供工作流、测试实现或全部代码,故只能部分采信,未给满分。

适用触发14 / 18 · 3.9/5

材料覆盖开发、推理运维、财务、合规和训练场景,提供多种采集源、存储选择、平台说明及环境要求,因此受众和使用场景描述充分。边界也有说明,包括明文可见性要求、HTTP/1.x 限制、eBPF 实验状态及不支持的导出格式;但部分能力覆盖范围主要由 README 声称,样本不足以全面核实,触发条件与适用环境也未形成完整决策指南。

规范维护14 / 18 · 3.9/5

文档入口、架构、配置、安装、术语表和变更记录组织清晰;安装、权限、验证、构建和卸载说明较具体。Apache-2.0 与许可证文件相符。README 描述版本和路线图,但当前样本未包含完整变更记录、发布流程或维护责任人信息;FAQ 与例子覆盖面良好但不完整。AGENTS.md/CLAUDE.md 同时含开发规范与产品架构背景,部分内容像贡献者指引,不能完全视为面向用户的产品说明。

有效结果12 / 13 · 4.6/5

产品将网络流量重建为调用、Agent turns、服务拓扑、指标和可导出的训练数据,面向给定场景有明确增量价值;界面、API、指标和回放工作流的输出用途具体。安装文档说明了权限与资源配置取舍,但对高吞吐量下的存储成本、明文数据治理成本及部署运维成本没有充分量化,故成本收益未给满分。

证据核验5 / 8 · 3.1/5

README 的架构与功能描述可由配置、API、采集源码及安装说明部分交叉印证,限制和实验特性也有明确标示。CI 与 soak 的质量声明在所给材料中主要是描述,不能当作已独立验证的结果;样本文件不完整,部分核心实现和 changelog 细节不可见。总体有一定事实与推断区分,但多项产品性能与覆盖率主张仍缺少样本内的直接证据。

风险与缓解建议
  • 采集内容可能包含提示词、模型响应、工具调用及其他敏感明文;上线前核实监听地址、API 访问控制、数据目录权限和保留策略。
  • 实时抓包和 eBPF 需要高权限能力;eBPF 为实验功能且需要特定内核条件。
  • 安装示例会下载并执行脚本;部署前审阅脚本并按文档校验发布校验和。
证据充分度:低 评估于 2026年11月11日 审查版本 3e8b2ea09ff7
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/heron.svg?lang=zh)](https://followagents.com/zh/agents/heron)
<a href="https://followagents.com/zh/agents/heron"><img src="https://followagents.com/badge/heron.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. 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 查看 ↗
  2. 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 查看 ↗
  3. 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 密钥?
README 所述的 PCAP 回放和监控功能不要求 LLM API 密钥;软件采用 Apache 2.0 许可证。
我能在加密流量上直接运行普通抓包吗?
不能。常规抓包需要明文 HTTP;可在 TLS 终止后部署,或在 Linux 上选择实验性的 eBPF SSL uprobes。
实时抓包需要什么权限?
Linux 网卡抓包需要 CAP_NET_RAW。可选的 eBPF 采集需要 CAP_BPF、内核 BTF,并在构建时启用 ebpf feature。
PCAP 回放结束后,控制台会关闭吗?
默认情况下进程会继续提供 API 和控制台,供用户浏览结果;传入 --exit-after-drain 可在管道排空后退出。
Heron 能提供跨集群客户端链路追踪吗?
不能。README 将缺少跨集群客户端追踪列为其取舍。
Heron 流量观测 官网是什么?
Heron 流量观测 的 GitHub 仓库填写的官网是 https://heron-ai.pages.dev。这个链接由仓库作者设置;源码在 GitHub(Netis/heron)。
Heron 流量观测 开源吗?
开源。源码在 GitHub(Netis/heron),许可证是 Apache-2.0。
Heron 流量观测 还在维护吗?
更新变慢了:GitHub 上最近一次提交是 2026-10-12,在最近半年内,但不在最近 30 天内。最新版本是 v0.8.3(2026-10-12)。
Heron 流量观测 是谁开发的?
Heron 流量观测 由 GitHub 账号 Netis 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

相关核心概念