Repository navigation
Dashboard KO
sh scripts/swarm.sh access의 Controller 주소를 열고 설정한 계정으로 로그인합니다. 이 문서는 실시간 패널과 조작을 설명합니다. 실행 절차는 실험 실행·복구, 기록 보존은 저장 결과, 노드·간선의 의미는 토폴로지를 참고하십시오.
Metrics 아래의 Network Overview, Exp Progress, Agent Status, Recent Network Events, Saved Results 탭으로 화면을 전환합니다. 한 번에 하나의 작업 화면을 표시하며 메트릭 행은 모든 탭 위에서 공통으로 볼 수 있습니다. 키보드 사용자는 Skip to dashboard 링크로 상단 메뉴를 건너뛸 수 있습니다.
상단 Tools 메뉴에는 Prometheus, Grafana, Log out이 있습니다. 보조 기능은 More 같은 메뉴에 모았습니다. Enter/Space로 메뉴를 열고 Up/Down과 Home/End로 사용 가능한 항목을 이동합니다. Escape는 메뉴를 닫고 버튼으로 초점을 돌려보냅니다. 메뉴 바깥을 클릭해도 닫힙니다.
Metrics는 클러스터·전달·대역폭·관측 지표 카드 11개를 가로 한 행에 표시합니다. 가로로 스크롤하거나 Previous metrics / Next metrics 화살표 버튼으로 이동하십시오. 카드에 마우스를 올리면 해당 카드 하나만 가로로 넓어지면서 상세 수치와 설명을 보여 줍니다. 긴 상세 내용은 펼친 카드 안에서 세로로 스크롤합니다. 폭이 좁은 모바일 화면에서는 상세 내용을 지표 수치 아래로 펼쳐 텍스트를 읽기 쉽게 표시합니다.
- 카드를 클릭하거나 탭하면 상세를 열고, 다시 선택하면 닫습니다. 터치 화면에서는 가로로 밀어 행을 이동합니다.
- 키보드 초점을 받으면 상세가 열립니다. Left/Right로 이전·다음 카드, Home/End로 첫·마지막 카드로 이동합니다. Enter/Space는 상세를 열고 닫으며, Escape 또는 행 바깥 클릭·탭으로 닫습니다.
- How delivery is measured는 행 바로 아래에 유지합니다. 설명과 펼침 상태는 실시간 갱신 중에도 유지됩니다.
Online Agents와 Ready Peers는 전체 클러스터, 메시지·대역폭 카드는 Run metrics에 표시된 실행을 대상으로 합니다. Observation quality의 대표 값은 Receipt / Continuity / Start 순서의 각 unknown 수이며, 서로 겹칠 수 있는 범주를 합산하지 않습니다. 펼치면 전체 레이블과 outcome 수를 확인할 수 있습니다.
Run이 완료·실패·취소되면 해당 실험의 캐러셀 수치는 초기 N/A·0으로 돌아갑니다. 카드는 그대로 유지하며 다음 run이 시작되면 새 수치를 표시합니다. 클러스터 수치는 실시간 상태를 유지하고 최종 측정값은 Saved results에서 확인합니다.
Available slots는 online Agent가 보고한 여유 Peer 수를 합산하며 offline Agent는 포함하지 않습니다. Capacity는 CPU·메모리 예약이 아닌 생성 허용 개수입니다. 값을 늘리기 전 Peer 배치와 capacity를 확인하십시오.
Saved results → Images에서 서버 백그라운드 분석을 접수하고 개요·메시지·반복 비교 그림을 PNG/CSV/ZIP으로 다운로드합니다. 저장 기록을 사용하며 Prometheus 보존과 독립적입니다. 조작 방법은 결과 이미지, 계산 정의는 실험 지표를 참고하십시오.
| 탭 | 내용 |
|---|---|
| Network Overview | 실시간 토폴로지, 레이어, 화면 조작과 Peer 상세 |
| Exp Progress | 실행 목록, 단계·작업 진행률, 종료 예상과 정지 |
| Agent Status | Agent 상태, 용량 설정과 메트릭 링크 |
| Recent Network Events | 최근 Peer 활동과 전달 이벤트 |
| Saved Results | 검색, 복구, 다운로드, 분석과 삭제 |
클릭·터치로 탭의 작업 화면을 전체 폭으로 엽니다. 탭에 포커스가 있을 때 좌우 방향키로 전환하고 Home/End로 첫 번째·마지막 탭을 선택합니다. Tab 키는 선택한 패널로 이동합니다. 좁은 화면에서는 탭 막대를 가로로 스크롤합니다. 패널의 Collapse/Expand 버튼은 사용하지 않습니다.
URL의 #network, #experiments, #agents, #events, #results가 선택한 탭을 나타내므로 새로고침·직접 링크·브라우저 뒤로/앞으로 이동 시 해당 화면을 복원합니다. URL에 탭이 없으면 Network Overview를 먼저 표시합니다. 시나리오 편집기에서 실행을 제출하거나 저장된 배치를 이어하기·재시도하면 Exp Progress로 이동합니다.
Overview 스위치는 페이지를 열 때마다 Off로 시작합니다. On으로 바꾸면 상세 토폴로지를 불러와 그래프를 만듭니다. Off 동안 그래프 계산·렌더링 없이 피어 수와 실험 지표를 계속 갱신합니다. 탭 전환으로 자동 활성화하지 않습니다. Off로 바꾸면 그래프 데이터와 선택을 해제합니다. 토폴로지 조작을 참고하십시오.
Agent Status → Refresh는 Offline을 포함한 등록 Agent를 다시 조회하여 Agent·Peer 상태를 갱신합니다. 버튼에 진행 상태를 표시하고, 갱신 수와 조회에 실패한 Agent를 알려주면서 기존 목록을 유지합니다. 실행 중인 Peer를 재시작하지 않고 현재 상태를 확인합니다. More → Discover Agents는 누락된 Swarm Agent도 찾아 재등록을 시도합니다.
Exp Progress → Refresh는 Saved Results → Refresh와 같은 저장 결과 목록 갱신을 수행한 뒤 두 결과 화면을 갱신합니다. 두 버튼은 요청과 처리 중 상태를 공유합니다. 필터와 펼친 결과 그룹을 유지하며, 요청이 실패해도 마지막으로 불러온 목록을 보존합니다.
Agent Status는 Agent + Peers, Agent only, Peers only 요약을 Agent 표 위에 표시하고 그 아래에 Controller & Services를 둡니다. 표는 각 영역 안에서 스크롤하며 측정 설명은 해당 영역에서 펼쳐 볼 수 있습니다. 일부 측정 실패 시에도 측정된 값은 유지하고 46/47 containers처럼 범위를 함께 표시합니다. CPU 환산·측정 범위·메모리 정의는 리소스 측정 범위와 단위를 참고하십시오.
- More → Current CSV로 최신 자원 사용량을 다운로드합니다.
- Measurement & exports를 열고 Start measurement → Stop으로 구간을 정합니다. 완료 구간을 선택한 뒤 Actions → Interval CSV 또는 Interval summary CSV로 다운로드합니다. 같은 메뉴에서 Delete interval을 사용할 수 있습니다.
- Resource history에서는 기간을 선택한 뒤 Export → History CSV 또는 Summary CSV를 사용합니다.
Measurement & exports가 접혀 있어도 측정 상태는 표시합니다. 공유 구간은 페이지 새로고침과 Controller 재시작 후에도 유지되며 최대 24시간 후 종료합니다. 다운로드는 Prometheus에 보존된 표본을 사용합니다. 갱신 상태·측정 오류·CSV 결과 안내도 접힌 조작 영역 밖에 표시합니다.
Saved Results의 개별 Run에는 Images와 ZIP 다운로드를, 배치 헤더에는 Analyze batch mean을 바로 표시합니다. 해당 행의 More 메뉴에서 사용 가능한 Add runs, Retry, Continue remaining, 삭제 기능을 선택합니다. 배치를 펼치면 개별 Run에 접근합니다. 좁은 화면에서도 같은 기능을 메뉴로 제공하여 모든 버튼이 결과 위에 쌓이지 않게 합니다.
탭을 바꿔도 실험·백그라운드 분석·실시간 갱신은 계속됩니다. Overview가 On이면 Network Overview를 벗어날 때 배치 애니메이션을 멈추며 돌아오면 최신 토폴로지를 표시합니다. 필터, 여전히 존재하는 Peer 선택과 Pause motion 설정을 유지합니다. 메트릭 행과 실시간 값은 모든 탭에서 공유하며 탭 전환 중에도 카드의 펼침 상태를 유지합니다.
세션이 만료되면 Login required를 표시하며 다시 로그인해 대시보드로 돌아옵니다. 페이지를 닫거나 숨기면 실시간 연결은 끊지만 접수된 실험과 분석은 Controller에서 계속됩니다. 페이지가 다시 보이면 현재 상태를 동기화합니다. Reconnecting은 브라우저 연결 상태이며 실험 결과를 뜻하지 않습니다.
복구 상태가 계속되면 스트림 진단을 확인하십시오. 세션 동작은 인증, 전송 형식은 Dashboard SSE가 정의합니다.
Dashboard는 몰려오는 telemetry를 초당 최대 4회 화면 갱신으로 병합하고, 동일한 텍스트·목록·토폴로지 요소를 유지합니다. 지표 갱신은 펼친 카드와 가로 스크롤 위치를 유지하면서 수치를 업데이트합니다.
Home · Documentation guide · kpl-v3 source
Commands run from the kpl-v3 source checkout.