3.1. 대시보드
Kubernetes 클러스터의 전체 현황을 실시간으로 한눈에 파악하는 화면입니다.

개요
클러스터 대시보드는 모니터링 중인 Kubernetes 클러스터의 리소스 사용 상태, 워크로드(Workload) 상태, Pod 현황, 이벤트 등을 실시간으로 보여주는 메인 화면입니다. 클러스터에 이상이 없는지 빠르게 확인하거나, 문제 발생 시 어느 영역에서 시작되었는지 파악하는 데 활용합니다.
좌측 사이드바에서 클러스터 대시보드 메뉴를 클릭하면 진입할 수 있습니다. 대시보드는 실시간 전용 화면으로, 상단의 시간 선택기는 비활성화됩니다.
참고: 이 문서 곳곳에 나오는 시계열 차트의 공통 조작(확대·범례 토글·툴팁·예측·이상치 탐지 등)은 21장 공통 차트 가이드를 참고하세요.
화면 구성
대시보드는 다음과 같은 영역으로 구성됩니다.
| 영역 | 설명 |
|---|---|
| 상단 헤더 | 실시간 연결 상태, 카테고리 필터, 네임스페이스 필터, 전체 화면 버튼 |
| 클러스터 리소스 게이지 | 클러스터 전체 CPU, 메모리, 디스크, Pod 사용 현황 |
| 클러스터 상태 카드 | 노드, Pod, 워크로드, 인시던트, 배포의 현황 요약 |
| 네임스페이스 리소스 배분 | 네임스페이스별 리소스 사용 비중 트리맵 |
| Pod 맵 | 전체 Pod의 상태를 타일로 시각화 |
| 리소스 상위 소비자 | CPU, 메모리를 가장 많이 사용하는 워크로드 목록 |
| 노드 히트맵 | 노드별 리소스 사용률 히트맵 |
| 클러스터 이벤트 | 최근 발생한 Kubernetes 이벤트 목록 |
| 리소스 추세 | 시간대별 클러스터 리소스 사용량 추이 차트 |
주요 기능
실시간 연결 상태 확인
대시보드는 서버와 실시간으로 데이터를 주고받습니다. 화면 제목 옆의 배지에서 현재 연결 상태를 확인할 수 있습니다.
| 배지 | 뜻 |
|---|---|
| 실시간 (초록색 점) | 서버와 연결되어 있습니다. 클러스터 데이터가 실시간으로 갱신됩니다. |
| 연결 중... | 서버에 처음 연결하는 중입니다. 연결이 끊긴 직후 첫 재시도까지 약 1초 동안에도 이 문구가 남은 초(예: (1s))와 함께 나옵니다. 아직 시도 횟수가 0 이기 때문입니다. |
| 재연결 중 (N)... | 연결이 끊어져 자동으로 다시 연결하는 중입니다. N 은 시도 횟수이고, 그 뒤의 초는 다음 시도까지 남은 시간입니다. |
| 연결 끊김 (빨간색 점) | 10회 시도 해도 연결하지 못했습니다. 배지 옆에 마지막으로 데이터를 받은 시각이 나옵니다(예: 14:32 (5h)). |
연결이 끊어지면
연결이 끊어지면 화면이 스스로 서버에 다시 연결합니다. 사용자가 조작하지 않아도 됩니다.
- 처음 10회는 1초, 2초, 4초, 8초, 16초, 30초 간격으로 시도합니다. 간격이 30초에 이르면 10회째까지 30초 간격을 유지합니다.
- 10회 안에 연결하지 못하면 배지가 연결 끊김 으로 바뀝니다. 그 뒤에도 화면은 60초마다 다시 연결을 시도합니다. 시도는 멈추지 않습니다.
- 여러 화면이 한꺼번에 다시 연결하지 않도록, 실제 간격은 위 값보다 조금 길거나 짧습니다.
- 서버가 다시 응답하면 다음 시도에서 연결이 복구되고 배지가 실시간 으로 돌아옵니다.
그래서 TV 처럼 사람이 조작하지 않는 화면도 서버가 돌아오면 저절로 복구됩니다. 페이지를 새로고침하지 않아도 됩니다.
배지가 연결 끊김 이면 다음 항목도 함께 나옵니다.
- 안내 바: 화면 상단에 연결이 끊어졌다는 안내와 재연결 버튼이 나옵니다. 버튼을 클릭하면 다음 시도를 기다리지 않고 바로 다시 연결합니다. 시도 횟수도 처음부터 다시 셉니다.
- 상단 바의 빨간 아이콘: 화면 맨 위 오른쪽에 빨간 아이콘과 숫자가 나옵니다. 숫자는 연결이 끊긴 실시간 채널 수입니다. 아 이콘을 클릭하면 채널 목록이 열리고, 모두 재연결 로 모든 채널을 다시 연결할 수 있습니다.

참고: 연결이 끊긴 동안 화면의 숫자와 차트는 마지막으로 받은 값입니다. 배지 옆의 마지막 수신 시각으로 그 값이 언제 것인지 확인하세요.
토폴로지 맵, APM 대시보드, 사용자수 추정, 보안공격 탐지 화면도 같은 방식으로 다시 연결합니다. 다만 토폴로지 맵과 보안공격 탐지 화면의 배지는 재시도 중에도 시도 횟수 없이 연결 중... 과 남은 초만 표시합니다.
카테고리 및 네임스페이스 필터
대시보드 상단 헤더에서 카테고리와 네임스페이스를 선택하여 특정 범위의 리소스만 표시할 수 있습니다.
- 카테고리 필터: 드롭다운에서 카테고리를 선택하면, 해당 카테고리에 속하는 애플리케이션의 데이터만 대시보드에 표시됩니다. 클러스터 상태 카드, 네임스페이스 리소스 배분, Pod 맵, 리소스 상위 소비자 등 모든 영역이 선택한 카테고리 기준으로 갱신됩니다. X 버튼을 클릭하면 필터가 해제됩니다.
- 네임스페이스 필터: 특정 네임스페이스를 선택하면, 해당 네임스페이스의 데이터만 표시됩니다. 기본값은 전체 네임스페이스입니다.
참고: 네임스페이스(Namespace)는 Kubernetes에서 리소스를 논리적으로 구분하는 단위입니다.
클러스터 리소스 게이지

클러스터 전체의 리소스 사용 현황을 원형 게이지로 보여줍니다. 다음 네 가지 항목이 표시됩니다.
| 게이지 | 설명 |
|---|---|
| CPU | CPU 사용률(%). 현재 사용량 / 전체 용량 |
| 메모리 | 메모리 사용률(%). 현재 사용량 / 전체 용량 |
| 디스크 | 디스크 사용률(%). 현재 사용량 / 전체 용량 |
| Pods | Pod 사용 비율(%). 현재 Pod 수 / 최대 허용 Pod 수 |
각 게이지는 사용률에 따라 색상이 달라집니다.
| 색상 | 기준 | 의미 |
|---|---|---|
| 초록색 | 75% 미만 | 정상 |
| 노란색 | 75% 이상 90% 미만 | 주의 |
| 빨간색 | 90% 이상 | 위험 |
게이지 아래에는 현재 사용량과 전체 용량이 수치로 표시됩니다(예: 2.5 / 8.0 cores, 12.3 / 32.0 GB).
게이지 상세 툴팁
게이지 위에 마우스를 올리면 상세 툴팁이 나타나며, 다음 정보를 확인할 수 있습니다.
| 항목 | 설명 |
|---|---|
| 사용량 | 현재 사용량과 게이지 바 |
| 용량 | 전체 용량 |
| 가용 | 잔여 가용량 |
| 요청 | 요청량 (CPU, 메모리만 해당) |
| 제한 | 제한량 (CPU, 메모리만 해당) |
클러스터 상태 카드

클러스터의 핵심 현황을 6개의 카드로 요약합니다. 각 카드를 클릭하면 관련 상세 화면으로 바로 이동할 수 있습니다. 단, 활성 사용자 카드는 카드 전체가 아니라 표시된 숫자(값)를 클릭해야 사용자수 추정 화면으로 이동합니다. (호스트 모드에서는 Pods·워크로드가 서비스 카드 하나로 합쳐져 5개로 표시됩니다.)
| 카드 |
|---|