본문으로 건너뛰기

ADR-0037: 실험 추적 — MLflow 스토어 + GenD UI (자체 SDK 비채택)

  • 상태: 승인
  • 날짜: 2026-08-05
  • 관련: ADR-014 (MLOps Governance), spec docs/superpowers/specs/2026-08-05-experiment-tracking-design.md

맥락

wandb 류 실험 추적 요구(런 비교 차트·라이브 갱신·시스템 메트릭)가 있었고, "GenD 내장 vs 별도 솔루션(자체 SDK+서버)" 선택이 필요했다. GenD 는 이미 MLflow v2.22.4 트래킹 서버·모델 레지스트리를 운영하고, 서빙·거버넌스가 전부 MLflow 를 기준으로 배선되어 있다.

결정

  1. 자체 트래킹 SDK/스토어를 만들지 않는다. 기록은 표준 mlflow SDK, 스토어는 기존 MLflow 서버. wandb 3층(SDK/스토어/UI) 중 UI 만 GenD 가 소유한다.
  2. 백엔드는 mlflow_proxy.py 의 read-only 프록시 확장(run 상세· metrics-history 배치·artifacts·workspace 태그 필터)으로 한정한다.
  3. 라이브 갱신은 폴링(8초)이다 — MLflow 스토어에 push 채널이 없고, wandb 웹 UI 도 폴링이다.
  4. workspace 소속은 MLflow experiment 태그 gend.workspace 로 표현한다. PG 매핑 테이블을 두지 않는다. 필터는 옵션으로 시작하고(부여-먼저), 강제 격리는 태깅 커버리지 실측 후 별도 결정한다.

결과

  • 신규 인프라 0, 신규 DB 테이블 0. 사내 팀(GenOS/quant-ai)은 mlflow SDK 를 GenD 트래킹 서버로 향하게 하면 동일 UI 를 쓴다 (온프레미스 충족).
  • 기각: 자체 SDK+서버 신규 제작(트래킹 이중화 + offline buffering/retry 를 떠안음 — GenD 없는 단독 판매 전제가 없어 부당), MLflow UI 직노출 유지 (workspace 격리·비교 UX 부재).