실험
프로젝트별 MLflow 실험과 Run 목록, Run 비교, Run 의 지표·파라미터·아티팩트 확인
필요 권한: 조회
학습마다 생성되는 기록(Run)을 한곳에서 조회. 플랫폼 학습으로 실행한 Run 과 개인 PC 에서 MLflow 로 기록한 Run 이 같은 테넌트 기록이면 모두 여기에 표시. ML 엔지니어가 결과 비교와 좋은 Run 의 모델 레지스트리 등록에 사용.
기록 구성: 프로젝트 → 실험 → Run. 프로젝트는 MLflow 실험 태그로 결정, 태그가 없으면 default 프로젝트로 분류.
실험 목록
| 번호 | 영역 | 설명 |
|---|---|---|
| ① | 검색 | 실험 이름이나 Run id 로 필터링(Run 이름은 대상이 아님). 화면에 불러온 Run 중에서만 검색. |
| ② | 비교 | 체크한 Run 이 2개 이상이면 활성화. 괄호 안은 선택한 개수. |
| ③ | 실험 | 실험 이름과 Run 수. 실험마다 최근 Run 20개를 먼저 표시, 더 있으면 Run 더 보기 로 20개씩 추가로 불러옴. 오른쪽 휴지통은 실험 삭제(develop, 확인 창을 거침). |
| ④ | 비교 선택 | Run 을 비교 대상으로 선택. 서로 다른 실험의 Run 도 선택 가능. |
| ⑤ | Run | 이름(없으면 짧은 id)·상태·대표 지표·시작 시각. 대표 지표는 이름에 acc·iou·f1·score 가 포함된 지표, 없으면 첫 지표. 이름 클릭 시 Run 상세로 이동. 플랫폼 학습으로 만든 Run 에는 학습 실행 상세로 이동하는 학습 링크 표시. |
Run 비교
2개 이상의 Run 을 나란히 비교. 처음에는 메트릭 탭이 열리고, 값이 다른 줄은 노란색으로 강조.
| 번호 | 영역 | 설명 |
|---|---|---|
| ① | 탭 | 개요(상태·시작 시각), 메트릭, 파라미터, 그래프. |
| ② | 차이만 보기 | 메트릭·파라미터 탭에서 모든 Run 의 값이 같은 줄 숨김. 한쪽 Run 에만 있는 값도 다른 값으로 간주. |
| ③ | 비교 표 | 첫 열은 지표·파라미터 이름, 나머지 열은 Run(짧은 id). |
그래프 탭은 지표마다 Run 들의 곡선을 한 차트에 겹쳐 표시. 차트 오른쪽 위 확대 아이콘 클릭 시 차트 확대 표시.
Run 상세
| 번호 | 영역 | 설명 |
|---|---|---|
| ① | 요약 | Run 이름·상태, 실험 ID, 시작·종료, 소요 시간, 메트릭 수. 플랫폼 학습으로 만든 Run 에는 학습 실행 보기 링크 표시. |
| ② | 동작 | 모델 등록(model_register, 완료(FINISHED) Run 만), 중지(develop, 아직 종료되지 않은 Run 만, 확인 창을 거침), 삭제(develop, 완료·실패·중단된 Run 만). 권한이 없으면 버튼이 표시되지 않고, 상태가 맞지 않으면 흐리게 표시. |
| ③ | 탭 | 개요(최종 메트릭·파라미터), 메트릭(차트), 파라미터(검색), 태그, 아티팩트(파일 탐색). |
메트릭 탭은 기록된 모든 지표를 작은 차트로 표시(전체 보기). 차트 클릭 시 단일 보기로 전환되어 최종·최소·최대·평균·스텝 수를 함께 표시, 오른쪽 위 선택 상자로 지표 선택. 지표가 하나뿐이면 처음부터 단일 보기.
아티팩트 탭은 Run 이 업로드한 파일(가중치, 결과 이미지, 로그)을 트리로 표시. 파일 선택 시 오른쪽에 미리보기(이미지·텍스트·JSON·CSV 앞 200행) 표시, 파일마다 다운로드 로 내려받기. 2 MB 를 넘는 텍스트·CSV 와 가중치 같은 바이너리는 미리보기 없이 내려받기만 가능. 전체 다운로드 는 전체를 zip 으로 내려받음.
주요 작업
- 실험 목록에서 비교할 Run 2개 이상에 체크 후 비교 클릭.
실험: ① 검색 ② 비교(선택 2개 이상) ③ 실험 ④ Run 비교 선택 ⑤ Run 이름(상세로) - 메트릭 탭에서 차이만 보기 로 값이 다른 지표만 확인.
Run 비교: ① 개요·메트릭·파라미터·그래프 탭 ② 차이만 보기 ③ Run 별 값(다른 값은 강조) - 가장 좋은 Run 을 열고 모델 등록 클릭. 모델 이름 입력 후 등록 하면 새 버전이 Staging 으로 등록, 완료 안내의 버전 보기 로 그 버전 열기. 같은 이름으로 다시 등록하면 버전 번호 증가.
모델 레지스트리 등록: 새 버전은 Staging 으로 등록
모델 등록 시 Run 의 아티팩트에서 모델 파일 탐색. MLflow 로 기록한 모델 → model/ 폴더 → weights/best.pt → weights/last.pt 순서로 찾아 처음 찾은 파일 사용. weights/ 의 파일 하나로 등록된 버전에는 MLflow 모델 정보(MLmodel)가 없어 서빙 이미지 빌드 불가.
상태·배지
| 배지 | 값 | 뜻 |
|---|---|---|
| 실행 중 | RUNNING | 학습 진행 중. 지표 기록 중. |
| 완료 | FINISHED | 정상 종료. 모델 등록은 이 상태에서만 가능. |
| 실패 | FAILED | 오류로 종료됨. |
| 중단됨 | KILLED | 사용자가 중지했거나, 플랫폼 학습이 중지·중단되어 종료됨. |
| 예약됨 | SCHEDULED | 시작 전. |