eunomia-bpf/agentsight

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

해결하는 문제

AgentSight는 AI 에이전트에 대한 시스템 수준의 관측성을 제공하여, 애플리케이션 수준의 도구(LangSmith 또는 Langfuse와 같은)가 해결하지 못하는 공백을 메웁니다. 에이전트에 내장된 SDK나 프록시가 필요 없이 에이전트가 머신에서 실제로 수행하는 작업(프로세스 생성, 파일 수정, 네트워크 호출 등)을 모니터링할 수 있습니다. 이는 내부 로그가 제한적이거나 사용할 수 없는 오픈 소스가 아닌 CLI 에이전트에 특히 유용합니다.

작동 원리

AgentSight는 eBPF(extended Berkeley Packet Filter)와 TLS 트래픽 트레이싱을 사용하여 Linux 커널 수준에서 에이전트 활동을 관찰합니다. SSL/TLS 호출 경계에서 평문 LLM 페이로드를 캡처하고 이러한 프롬프트와 모델 응답을 프로세스 실행 및 파일 액세스와 같은 실시간 시스템 이벤트와 상관 관계를 맺습니다. 시스템 경계에서 작동하므로 모니터링되는 에이전트에 코드 변경이 필요하지 않습니다.

대상 사용자

AI 에이전트(Claude Code, Gemini CLI 또는 aider 등)를 사용하며 오류 디버깅, 보안 민감 파일/네트워크 변경 감사 또는 토큰 및 리소스 소비 분석이 필요한 개발자 및 보안 감사인을 위해 설계되었습니다.

주요 특징

  • SDK 불필요: SDK, 프록시 또는 벤더 통합 없이도 모든 바이너리 또는 CLI 에이전트에서 작동합니다.
  • 시스템 전체 모니터링: LLM 호출과 함께 프로세스 트리, 파일 작업 및 네트워크 활동을 추적합니다.
  • 라이브 및 오프라인 분석: top 스타일의 라이브 뷰, 타임라인 및 메트릭을 위한 웹 인터페이스, 토큰 사용량의 시맨틱 플레임그래프를 생성하는 agentpprof를 포함합니다.
  • OpenTelemetry 지원: 캡처된 LLM 호출을 OTLP/HTTP를 통해 표준을 준수하는 GenAI span으로 내보낼 수 있습니다.
  • 낮은 오버헤드: 일반적인 워크로드에서 3% 미만의 CPU 오버헤드를 기록합니다.