eunomia-bpf/agentsight

system-level profiler/monitor and skills for Agents in eBPF or Mac

解決的問題

AgentSight 為 AI Agent 提供系統級可觀測性，填補了應用層工具（如 LangSmith 或 Langfuse）無法涵蓋的空白。它允許開發者在無需 Agent 內建 SDK 或代理的情況下，監控 Agent 在機器上實際執行的操作——例如啟動進程、修改檔案和進行網路呼叫。這對於內部日誌有限或無法取得的閉源 CLI Agent 尤為有用。

工作原理

AgentSight 使用 eBPF (extended Berkeley Packet Filter) 和 TLS 流量追蹤，從 Linux 核心層級觀察 Agent 活動。它在 SSL/TLS 呼叫邊界擷取明文 LLM 負載，並將這些提示詞 (prompts) 與模型回應與即時系統事件（如進程執行和檔案存取）進行關聯。由於它在系統邊界運行，因此無需對被監控的 Agent 進行任何程式碼更改。

適用對象

專為使用 AI Agent（如 Claude Code、Gemini CLI 或 aider）並需要除錯故障、稽核安全性敏感的檔案/網路變更或分析 Token 及資源消耗的開發者與安全稽核人員設計。

亮點

  • 無需 SDK: 適用於任何二進位檔案或 CLI Agent，無需 SDK、代理或廠商整合。
  • 全系統監控: 在 LLM 呼叫的同時追蹤進程樹、檔案操作和網路活動。
  • 即時與離線分析: 包括類似 top 的即時檢視、用於時間軸與指標的 Web 介面，以及用於生成 Token 使用量語義火焰圖的 agentpprof。
  • 支援 OpenTelemetry: 可以透過 OTLP/HTTP 將擷取的 LLM 呼叫作為符合標準的 GenAI spans 匯出。
  • 低開銷: 在典型工作負載下，CPU 開銷低於 3%。