
295
10
장
운영 환경 모니터링
없이 핵심 개념을 보여 주기에 적합합니다. 스택을 정했다면 다음 단계는 계측입니다. 에이전
트 런타임에 텔레메트리를 직접 심어 의미 있는 시그널을 포착하는 작업을 다음 절에서 살펴봅
니다.
10.4
오픈텔레메트리 계측
효과적인 모니터링 루프를 구축하는 첫 단계는 계측입니다. 에이전트 런타임에 고품질 시그널
이 직접 심어져 있지 않다면 사실상 눈을 가린 채로 운영하는 셈입니다. 오픈텔레메트리는 트
레이스, 지표, 로그 전반에 걸친 구조화되고 상호운용 가능한 텔레메트리의 기반을 제공하며
랭그래프 기반 에이전트 시스템과도 잘 통합됩니다.
랭그래프는 비동기 함수 호출의 그래프로 구성됩니다. 그래프의 각 노드는 에이전트 워크플로
의 기능적 단계를 의미합니다. 예를 들어 계획 수립, 도구 호출,
LLM
으로 응답 생성 같은 단계
입니다. 각 단계가 이미 분리되어 명시적으로 선언돼 있으므로 각 단계를 오픈텔레메트리 스팬
으로 계측하기가 간단합니다. 이 스팬은 단계의 시작과 종료 시점뿐 아니라 무엇을 시도했고
어떻게 수행됐는지도 기록하는 구조화된 트레이스를 만듭니다.
각 노드마다 함수 시작 시 스팬을 시작하고 관련 메타데이터로 주석을 다는 것을 권장합니다.
예를 들어 도구 호출 노드에서는 도구 이름, 호출한 메서드, 응답 지연시간, 성공/실패