Skip to main content
이 문서는 머신러닝 섹션의 일부입니다.

왜 Tracing이 필요한가요?

GenAI 애플리케이션(RAG 챗봇, AI 에이전트 등)은 전통적인 소프트웨어와 달리, LLM 호출, 문서 검색, Tool 실행 등 여러 단계가 체인으로 연결 되어 동작합니다. 사용자에게 잘못된 답변이 반환되었을 때, “어느 단계에서 문제가 생겼는지” 파악하기 어렵습니다.
💡 MLflow Tracing 은 GenAI 앱의 실행 흐름을 단계별로 추적 하는 기능입니다. 각 단계(Span)의 입력, 출력, 지연 시간, 토큰 사용량을 기록하여, 디버깅과 성능 최적화를 가능하게 합니다.
Trace 예시: 사용자 질문 → 답변

Span 유형

각 Trace는 여러 개의 Span(구간) 으로 구성됩니다. Span은 중첩(Nested)될 수 있어, 호출 트리를 형성합니다.

자동 트레이싱 (Autolog)

MLflow는 주요 GenAI 프레임워크에 대해 코드 한 줄로 자동 트레이싱 을 활성화할 수 있습니다.

지원 프레임워크

사용 예시


수동 트레이싱

자동 트레이싱이 지원되지 않는 프레임워크나 커스텀 로직에는 수동으로 Span을 추가 할 수 있습니다.

데코레이터 방식 (권장)

Context Manager 방식

더 세밀한 제어가 필요한 경우 with 문을 사용합니다.