Automation & Ops ebpfobservabilitytls-tracingai-agent-monitoringcli-toolingopentelemetryflamegraph

AgentSight

eBPF-based system-level observability for AI agents — see what agents actually do on your machine with zero SDK, proxy, or vendor integration.

FollowAgents review · FARS-2.1
Use with care
Why not a higher tier: Trust & safety is 17/29, below the 18/29 needed for “Recommended”; the tier is lowered because risk is not averaged away.
77/ 100 5-point scale 3.9 / 5
1 2 3 4 5 6
1Trust17 / 29 · 2.9/5

Evidence shows a local-first system observability tool: eBPF probes need root, but docs state the monitored agent still runs as the normal user with only probes elevated, and there is a no-sudo fallback to snapshots and native session files (least_privilege=2). Data flow is documented in detail in the FAQ (local SQLite, ~/.agentsight/monitor, localhost web UI), earning high transparency (=3). However, captured content includes plaintext TLS LLM payloads, prompts, headers, and network targets; the docs only advise treating logs as sensitive, with no redaction/encryption or explicit user-confirmation flow, and the monitor can install a background service without a documented consent/undo path (user_confirmation=1, sensitive_data_handling=2, rollback=1). CI uses lockfiles and vendoring, but no audit/vulnerability scanning is shown (=1). Optional OTLP export is an explicit opt-in feature (=2). MIT license, eunomia-bpf attribution, and arXiv paper give clear sourcing (=2). Deductions: sensitive-data protection stays at the advisory level; no confirmation/rollback detail.

2Reliability11 / 14 · 3.9/5

README, CI, and tests are mutually consistent: command examples (top/record/report/vis), field names, and test assertions align with one coherent event model (self_consistency=3). Dependencies (cargo/crates.io, npm, Chromium/FFmpeg) are addressed in docs and CI but carry external availability risk, e.g., GIF export needs local Chromium (=2). The FAQ provides troubleshooting guidance and tests use WARN/SKIP soft failure for kernel variance (failure_messages=2). No contradictions found; deduction is that failure handling is FAQ-based rather than systematic error codes/recovery docs.

3Adaptability16 / 18 · 4.4/5

Clearly targets Claude Code, Codex, Gemini CLI, OpenCode, and arbitrary commands, distinguishing the eBPF path from the agent-native session path (audience_and_scenarios=3). Capability boundaries are unusually honest: Cursor IDE not traceable via eBPF, statically linked SSL capture limits, kernel 4.1+/5.0+ requirements are all stated (capability_boundaries=3). Auto-discovery of binaries and SSL libraries lowers the barrier, but precision depends on explicit -p/--session selectors; default modes capture broadly (=2). Linux/macOS/partial Windows plus Docker are covered with environment-specific notes (environment_fit=3).

4Convention16 / 18 · 4.4/5

Documentation is well structured: Quick Start, Usage, FAQ, Contributing, License with a complete docs/ index (information_architecture=3). Installation covers cargo, Homebrew, binaries, Docker, and source builds with platform differences (install_notes=3). Examples are abundant and consistent with the command table; the FAQ directly addresses permissions, performance, data location, and failure triage (examples_and_faq=3). Known limitations (Cursor, static SSL, unpublished Windows assets) are stated (known_limitations=3). The MIT LICENSE file matches the badge (license=3). Naming is mostly stable (agentsight/agentpprof) though the unsuffixed asset is a vague 'compatibility alias' (=2). Versions are semver-managed by CI, but the release snapshot force-pushes master and changelogs rely on generated notes (versioning_changelog=2). Maintainer is the eunomia-bpf org with a clear release process, but publisher identity is unverified (maintenance_responsibility=2).

5Effectiveness12 / 13 · 4.6/5

Output usability is strong: live top view, web dashboard, report JSON/SQLite queries, standards-based OTel export, and pprof-compatible flamegraphs (output_usability=3). Relative to application-level tools like LangSmith/Langfuse, it fills the system-boundary gap with zero-SDK adoption; the marginal value argument is explicit and differentiated (marginal_value=3). The <3% CPU overhead claim cites a paper but cannot be reproduced in static review, and the eBPF+root+privileged-Docker operational cost is nontrivial for ordinary users (cost_benefit=2).

6Verifiability5 / 8 · 3.1/5

Most claims trace to in-repo material: the <3% overhead figure points to the arXiv paper and DOI; install/build claims point to docs files; CI steps map to repo paths (claim_traceability=2). README, CI workflows, and bpf tests corroborate the event model and command behavior across three sources (cross_source_corroboration=2). Facts and inference are mostly separated, but promotional framing ('The Future of AI Observability') and the performance number are not distinguished by evidence strength in-text (fact_inference_separation=2). Deduction: no in-repo benchmark data backs the performance claim, and it cannot be verified statically.

Evidence confidence: Low Reviewed Sep 07, 2026 Reviewed revision bb99b66f8f98
Before you use it
  • Captured data includes plaintext TLS payloads, prompts, file paths, and network targets, stored by default as SQLite files in the working directory; treat as sensitive and avoid committing or sharing.
  • eBPF mode requires root/privileged containers; monitor can install a persistent background service — verify its capture scope and autostart behavior and how to uninstall before deploying.
  • The performance claim (<3% CPU overhead) comes from the project's own paper and was not executed or verified in this review; benchmark on your own workload.
  • Publisher identity is unverified, and the release flow force-pushes version snapshots to master; audit the release chain before production adoption.
Review evidence [1][2][3][4][5][6][7]
See the full review method →

What does this agent do, and when should you use it?

AgentSight is a local-first, `top`/`strace`-like observability tool for AI agents that connects prompts, model calls, and tool decisions to their real effects on your machine. It works through eBPF kernel probes and TLS traffic tracing, so it can observe closed-source CLIs like Claude Code without any SDK, proxy, or vendor integration. `agentsight top` gives a live ranked view of sessions by health, token usage, and tool calls; `agentsight record` persists sessions to SQLite databases; `agentsight report` answers structured queries; `agentsight vis` renders animated replays of agent file activity; and `agentpprof` produces offline pprof-style semantic flamegraphs. The project is MIT-licensed, installable via Cargo, Homebrew, release binaries, or Docker, and exports captured LLM calls as OpenTelemetry GenAI spans.

AgentSight observes existing binaries and CLI agents from outside using eBPF probes and SSL/TLS call-site tracing, with no in-process instrumentation. agentsight top ranks live sessions, processes, model and tool calls, file and network activity; sudo agentsight record -- <command> auto-discovers binaries, SSL libraries, and container processes, captures plaintext LLM payloads, subprocess executions, file operations, and resource use, storing sessions in agentsight-*.db SQLite files; agentsight report provides summaries, token usage (groupable by working directory), audit JSON, a web UI (report serve on port 7395), and snapshot export; agentsight vis scans local Claude/Codex/Gemini sessions and renders an agent-nebula replay GIF; agentpprof aggregates local Codex/Claude sessions by project, agent, session tag, prompt tag, model, and token kind into pprof flamegraphs; debug trace --otel exports LLM calls as GenAI spans over OTLP/HTTP.

  1. A developer debugging failed or stalled Claude Code/Codex runs who wants to correlate prompts with actual errors and subprocess behavior.
  2. A team auditing security-sensitive effects: which remote services received requests and which files an agent changed.
  3. An engineering lead analyzing token cost distribution by project, model, or session using agentpprof's token flamegraphs.
  4. A maintainer wanting to replay how a coding agent read, wrote, created, renamed, and deleted files across a repository with agentsight vis.
  5. A team with existing application-level observability (LangSmith/Langfuse) that lacks process- and file-level visibility, using AgentSight as a system-boundary complement and exporting OTel spans to existing backends.

What are this agent's strengths and limitations?

Pros
  • Zero-SDK, zero-proxy design: observes closed-source CLIs (Claude Code, Gemini CLI, etc.) via eBPF and TLS call-site tracing with no application code changes.
  • Kernel-level events independent of agent-controlled logs capture subprocess executions, file operations, and plaintext LLM payloads that application-level tools miss.
  • Evaluation reports less than 3% CPU overhead for typical traced workloads, with standards-compliant OpenTelemetry GenAI export.
  • Rich analysis surfaces: live top view, SQLite persistence, web UI, replay animations, and pprof flamegraphs.
Limitations
  • Live eBPF capture requires Linux and root privileges (sudo or CAP_BPF/CAP_SYS_ADMIN); macOS/Windows are limited to non-eBPF session-file paths.
  • Apps with statically linked SSL libraries (BoringSSL in Claude/Bun, OpenSSL in all Node.js) cannot be hooked by sslsniff by default and rely on auto-discovery or --binary-path.
  • IDE agents like Cursor cannot be traced via eBPF: Electron apps with TLS inside stripped binaries and protobuf traffic.
  • Captured data includes prompts, responses, paths, headers, and network targets, so logs and databases are sensitive and must be managed accordingly.

How do you install or deploy this agent?

Install via:
- cargo install agentsight
- or download the release binary: wget https://github.com/eunomia-bpf/agentsight/releases/latest/download/agentsight && chmod +x agentsight
- Homebrew on Linux: brew tap eunomia-bpf/tap && brew install eunomia-bpf/tap/agentsight
- Docker (requires privileged host access) or build from source (see docs/build.md).
Live eBPF capture requires Linux kernel 4.1+ (5.0+ recommended) and sudo; top, bind, vis, and report work without eBPF using agent-native session files.

How do you use this agent?

Key commands:
- agentsight top — live ranked view (enables eBPF automatically when sudo is available)
- sudo agentsight record -- claude — record a command (also gemini, kimi, grok, -c python, -c node --binary-path docker://openclaw, etc.)
- agentsight report / report list / report token --group-by dir / report audit -- — query saved sessions
- agentsight vis — generate a session replay inside a Git worktree (GIF needs local Chromium and FFmpeg; HTML export needs neither)

- Open http://127.0.0.1:7395 for timeline, process tree, event log, and metrics views

- sudo ./agentsight debug trace --otel --otel-endpoint http://localhost:4318 for OpenTelemetry export
After a source build, run tests with make test.

How does this agent compare with similar options?

The README contrasts AgentSight with application-level tools (LangSmith, Langfuse, Phoenix) and gateway/proxy tools (Helicone): those require SDK, callback, or gateway integration and suit scenarios where you own the application code; AgentSight instead observes existing binaries from the system boundary, capturing subprocess executions, plaintext LLM payloads at TLS call sites, file operations, and cross-boundary behavior — complementary rather than a replacement.

FAQ

What permissions does it need?
top uses live eBPF capture with sudo or cached sudo, otherwise falls back to process snapshots and native agent session files. With record -- <command>, the monitored agent runs as your normal user; only the probes are elevated.
What is the performance impact?
The evaluation reports less than 3% CPU overhead for typical traced agent workloads.
Where does captured data go?
record writes agentsight-*.db SQLite files to the current directory by default; monitor stores weekly DBs under ~/.agentsight/monitor; top shows only live sessions. Data includes prompts, responses, and paths, so treat it as sensitive.
Why can't it capture Claude Code or Node.js traffic by default?
They statically link their SSL libraries (BoringSSL for Claude/Bun, OpenSSL for all Node.js), leaving nothing for sslsniff to hook; AgentSight handles this via record -- <command> auto-discovery or --binary-path.
Can it trace IDE agents like Cursor?
Not via eBPF: Cursor is an Electron app whose TLS sits inside a stripped binary and helper process, with protobuf traffic; support goes through the agent-native session path (e.g., agentsight top reads its local sessions without sudo).

Compare agents like this one

The same FARS review applied across the shortlist this agent qualifies for.

Related agents