AgentChat 로깅
AgentChat 로깅 (AgentChat Logging)
AgentChat에서 로깅은 디버깅과 관측성을 위한 핵심 도구예요. AutoGen은 크게 **추적 로깅(trace logging)**과 **구조화 로깅(structured logging)**을 제공하는데, 이 문서는 AgentChat 이벤트에 특화된 로깅 설정을 다뤄요.
AgentChat은 핵심 이벤트(agent 대화, 툴 실행, 메시지 흐름 등)를 구조화된 이벤트로 내보내요. 이 이벤트들은 EVENT_LOGGER_NAME 로거에 기록되며, 커스텀 핸들러를 붙여 수집하거나 기본 로깅 설정을 조정해 확인할 수 있어요.
import logging
from autogen_core import EVENT_LOGGER_NAME
logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(EVENT_LOGGER_NAME)
logger.addHandler(logging.StreamHandler())
logger.setLevel(logging.INFO)
이렇게 하면 AgentChat 에이전트들이 주고받는 핵심 이벤트가 콘솔에 출력돼요. 어떤 메시지가 어떤 에이전트 사이에서 오갔는지, 언제 툴이 호출됐는지 등을 흐름대로 추적할 수 있어요.
AgentChat 로깅은 에이전트 팀을 디버깅할 때 특히 유용해요. 여러 에이전트가 어떻게 상호작용하는지, 언제 종료 조건이 충족되는지, 잘못된 메시지 흐름이 어디서 생기는지 로그만으로 파악할 수 있거든요.
참고: 더 상세한 추적(tracing)이 필요하면 Tracing and Observability 문서를 참고하세요. 이 문서는 OpenTelemetry 기반의 정교한 분산 추적을 다룹니다.