Event-driven Hook 기반 Arize 연동을 통한 AI Agent Observability 확보

Context

자율적 동작과 복잡한 도구 호출 체인을 가진 OpenClaw Agent의 내부 실행 과정이 Black Box 형태로 운영됨에 따른 가시성 부족 문제 발생. 특히 로컬 환경 실행 및 비동기 작업으로 인한 디버깅 난이도 증가와 실행 흐름 추적의 한계 존재.

Technical Solution

• Event-driven Architecture를 활용하여 Agent Lifecycle, Message Flow, Tool Execution 등 주요 시점에 Hook을 배치하는 구조 설계
• Plugin 기반 Hook 구현을 통한 시스템 코어 수정 없는 확장성 확보 및 재사용 가능한 관측 모듈 배포 구조 채택
• OpenTelemetry 프로토콜을 사용하여 캡처된 이벤트 데이터를 Arize 플랫폼으로 전송하는 Instrumentation 파이프라인 구축
• handler.ts 내에 비즈니스 로직을 분리하여 특정 이벤트 발생 시 메타데이터와 Latency를 추출하는 인터셉터 패턴 적용
• Plugin SDK를 통한 버전 관리와 Gateway 호환성 정의로 분산 환경에서의 배포 안정성 강화