미리보기 플로우

입력 데이터소스, 모델, 출력 데이터소스가 라이브 파이프라인 그래프로 연결된 Preview Flow 캔버스 — Preview Flow — Input → Model → Output 파이프라인을 라이브 그래프로 표시합니다.

미리보기 플로우(UI 표기: Preview Flow, 경로: /preview-flow)는 관리자 전용 읽기 전용 캔버스로, 파이프라인을 그래프로 시각화합니다: 왼쪽에는 입력 데이터소스, 가운데에는 모델, 오른쪽에는 출력 데이터소스가 표시됩니다. 관리자 계정에만 표시됩니다 — 내비게이션 항목과 라우트가 모두 관리자 전용으로 제한되므로, 관리자가 아닌 사용자는 사이드바에 보이지 않아도 놓치는 것이 없습니다.

그래프는 기존 데이터소스 및 모델 구성으로부터 실시간으로 파생됩니다 — 별도의 미리보기 플로우 데이터 저장소, API, 데이터베이스 테이블은 존재하지 않습니다. 현재 페어링되어 있고, 활성화되어 있으며, 동작 중인 상태를 그대로 반영합니다.

노드

각 노드는 작은 유형 아이콘을 가지며, 다른 화면에서 이미 보았던 데이터를 그대로 반영합니다:

입력 데이터소스 — 유형, 태그 수, 그리고 Data Sources 표에 표시되는 것과 동일한 Enabled/Disabled 스위치(여기서는 읽기 전용이며, 전환은 드릴인 드로어에서 이루어집니다).
모델 — Version, Status, Output shape(Input shape는 아래의 드릴인 드로어에 표시됩니다).
출력 데이터소스 — 유형, 태그 수, 그리고 Enabled/Disabled 스위치.

입력이 참조하지만 모델 목록에 더 이상 존재하지 않는 모델은 조용히 사라지는 대신 Missing으로 표시된 고스트 노드로 렌더링됩니다.

엣지 범례

캔버스는 실행 중인 플로우만이 아니라 구성된 모든 플로우를 그립니다. 플로우는 입력 → 모델 → 출력의 한 사슬이며, 여러 플로우가 서로 다른 모델로 같은 입력을 읽을 수 있으므로 입력 노드 하나가 여러 모델로 갈라질 수 있습니다.

이를 구분하는 것은 활성 여부입니다. 활성화된 플로우의 사슬은 정상으로 그려지고, 나머지는 점선으로 흐리게 표시됩니다. 활성 플로우만 그리면 구성해 둔 토폴로지와 작업 관리자에 나열된 것이 화면에서 사라집니다.

입력 → 모델 — 플로우마다 한 개의 엣지. 해당 플로우의 모델이 모델 목록에 없으면 엣지가 조용히 사라지는 대신 고스트 노드를 가리키는 빨간/무효 엣지로 그려집니다. 무효 엣지는 흐리게 표시되더라도 눈에 띄게 유지됩니다 — 끊어진 모델 참조는 그 플로우가 실행 중이든 아니든 결함입니다.
모델 → 출력 — 플로우가 묶은 출력마다 한 개의 엣지. 모델이 해당 싱크를 실제로 채울 수 없으면(형상 파싱 불가 또는 채널 수 불일치) 그리지 않습니다. 활성 플로우에 묶였는데 아무것도 채울 수 없는 출력은 연결되지 않음으로 표시되어, 잘못 구성된 출력이 조용히 아무 일도 하지 않는 대신 계속 보이도록 합니다. 활성 플로우에 속하지 않은 출력은 그저 흐리게 표시됩니다 — 활성이 아닌 것은 결함이 아닙니다.

실시간 데이터 흐름 애니메이션

추론이 실행 중인 동안, 스트리밍 중인 체인 — 입력 → 그 플로우의 모델 → 그 모델에 연결된 출력들 — 이 애니메이션되어 실시간 “데이터 흐름”을 나타냅니다. 캔버스의 다른 모든 엣지는 정적으로 유지됩니다. 추론은 싱글톤이므로 한 번에 최대 하나의 체인만 애니메이션됩니다: 이 효과는 항상 실제로 실행 중인 단 하나의 파이프라인만 반영하며, 유휴 상태인 경로에 흐름이 있는 것처럼 암시하지 않습니다.

흐리게 표시하는 것과 애니메이션은 서로 다른 질문에 답합니다. 흐림은 “활성 플로우가 아님”을, 애니메이션은 “지금 예측이 흐르고 있음”을 뜻합니다. 플로우가 활성이면서 애니메이션되지 않을 수 있습니다 — 그것은 Ready이지만 아직 시작하지 않은 상태이며, 결함이 아니라 유효한 상태입니다.

노드와 상호작용하기

미리보기 플로우는 편집기가 아니라 뷰어입니다 — 노드를 드래그하거나 새 연결을 그릴 수 없습니다. 노드를 클릭하면 Data Sources 또는 Model Manager 화면에서 도달하는 것과 동일한 구성 대화상자가 드릴인 드로어로 열립니다:

입력 노드 — Edit config, Pair model, Map tags, 그리고 Enable/Disable 토글.
출력 노드 — Edit config, Map outputs, Test write, 그리고 Enable/Disable 토글.
모델 노드 — 읽기 전용 요약(Version, Status, Input shape, Output shape). 모델 상세 정보는 여기서 읽기 전용입니다. 모델 관리는 Model Manager 화면에서 하세요.

변경 사항을 저장하면 업데이트된 구성으로부터 캔버스가 다시 파생되므로, 드로어를 닫은 후에도 그래프는 항상 현재의 페어링/활성화 상태를 반영합니다.

문제가 발생하면

캔버스에 끊어지거나 유효하지 않은 페어링, 또는 “not connected” 출력이 표시되는 경우 — 입력을 유효한 모델과 페어링하거나, 출력의 형태를 활성 모델과 일치시키세요. 문제 해결 런북을 참조하세요.

다음 단계

예측값 모니터링 데이터소스가 스트리밍되는 동안의 지연 시간, 처리량, KPI.

입력 데이터소스 구성 모델에 데이터를 공급하기 위해 입력을 페어링, 활성화, 태그 매핑하세요.