Usage
English | 中文
Building from Source
1. Clone the repository and initialize submodules
git clone https://github.com/eunomia-bpf/agentsight.git
cd agentsight
git submodule update --init --recursiveIf you have already cloned the repository but the submodule directories (libbpf/ and bpftool/) are empty, run:
git submodule update --init --recursive2. Install system dependencies
make installThis installs the required build dependencies: libelf, zlib, clang, llvm, Node.js, and the Rust toolchain.
3. Build
make buildAfter a successful build, the agentsight binary is located at collector/target/release/agentsight.
You can also build individual components:
make build-bpf # eBPF C programs only
make build-rust # Rust collector only
make build-frontend # Frontend onlyRunning from Source
Navigate to the repository root after make build. Commands that load eBPF
probes should be run with sudo; AgentSight can request sudo if you forget, but
explicit sudo is the recommended path.
# Live view of local agent sessions
sudo ./collector/target/release/agentsight top
# Launch and record a command
sudo ./collector/target/release/agentsight record -- claude
# Attach to an already-running process family
sudo ./collector/target/release/agentsight record -c claude
# Debug-level configurable tracing
sudo ./collector/target/release/agentsight debug trace --server -c claude
# Raw SSL debug capture with HTTP parsing
sudo ./collector/target/release/agentsight debug ssl --http-parserContinue exploring
Back to index
AgentSight: System-wide AI agent tracing and monitoring with eBPF
  
Previous
OpenTelemetry GenAI Export
AgentSight can export the LLM calls it captures as OpenTelemetry GenAI semantic-convention (genai.) spans, sent to any OpenTelemetry Collector over OTLP/HTTP.
- Last updated
- Jun 3, 2026
- First published
- Jun 2, 2026
- Contributors
- LinuxDev9002
Was this page helpful?