본문으로 건너뛰기

Object Topology

Object Topology 화면에서는 선택한 클러스터·Namespace에 속한 쿠버네티스 객체를 종류별 열로 나열하고, 객체 간 연결 관계를 관계도로 확인할 수 있습니다. HPA, Ingress, Service, Pod, Node, Config Map, PVC, PV, Storage Class까지 총 9종의 객체를 한 화면에서 함께 살펴볼 수 있습니다.

화면에 들어가려면 좌측 메뉴에서 Kubernetes > Inventory > Object Topology를 선택하세요. 좌측 Filters 패널의 Cluster 트리에서 클러스터를 펼쳐 조회할 Namespace를 하나 선택하면, 그 Namespace에 속한 객체가 열마다 카드로 표시됩니다.

Object Topology 전체 화면

화면은 객체 종류별 열로 구성된 관계도와 우상단의 범례(Warning/Critical)·확대·축소 컨트롤 영역으로 구성됩니다.

객체 종류별 열에서 연결 관계 확인하기

각 열은 HPA, Ingress, Service, Pod, Node, Config Map, PVC, PV, Storage Class 순서로 객체 종류를 나타내며, 열 안의 카드는 실제 객체 하나하나를 의미합니다. 카드 사이를 잇는 선은 두 객체가 서로 연관되어 있음을 나타냅니다.

  • 카드에는 객체 종류 아이콘과 이름이 표시되며, 이름이 길면 줄여 표시됩니다.
  • 예를 들어 Pod 카드에서 뻗은 선을 따라가면 그 Pod가 속한 Node, 연결된 Service·Config Map 등을 한 번에 파악할 수 있습니다.

특정 Pod의 배포 구조나 연결 관계가 복잡하게 얽혀 있을 때, 이 화면에서 카드 사이의 선을 따라가면 관련 리소스를 빠르게 추적할 수 있습니다.

표시할 객체 종류 선택하기

좌측 Filters 패널 하단의 Object 목록에서 화면에 표시할 객체 종류를 선택할 수 있습니다.

  • Select all을 선택하면 9종의 객체를 모두 표시하고, 체크를 해제하면 해당 종류의 열이 화면에서 사라집니다.
  • 특정 객체 종류만 체크 해제하면 관계도가 단순해져, 확인하고자 하는 리소스 사이의 연결선을 더 쉽게 따라갈 수 있습니다.

알람 발생 객체 확인하기

카드의 아이콘 색상으로 해당 객체의 알람 심각도를 확인할 수 있습니다.

Node·Pod 카드의 알람 심각도 색상

  • 파란색: Normal(정상) 상태입니다.
  • 주황색: Warning(경고) 상태입니다.
  • 빨간색: Critical(심각) 상태입니다.

화면 우측 상단의 Warning/Critical 범례로 색상의 의미를 다시 확인할 수 있습니다.

Show Pod created within 1 Minute 체크박스를 켜면 최근 1분 안에 새로 생성된 Pod만 강조해서 볼 수 있어, 배포·스케일 아웃 직후 새로 뜬 Pod를 빠르게 확인할 수 있습니다.

관계도 확대·축소하기

관계도 좌측 하단의 컨트롤로 화면 배치를 조정할 수 있습니다.

  • +/-로 관계도를 확대·축소할 수 있습니다.
  • 확대·축소 버튼 아래의 전체 화면 아이콘을 누르면 모든 카드가 한 화면에 들어오도록 배치를 맞춥니다.
  • 우측 하단의 미니맵에서 현재 화면에 보이는 영역의 위치를 확인할 수 있습니다.

객체 상세 확인하기

열에 있는 카드를 클릭하면 화면 우측에 해당 객체의 상세 슬라이드가 표시됩니다. 상단의 리소스 관계도에서 클릭한 객체가 속한 Cluster·Node·Namespace부터 상위 리소스(Deployment 등)와 하위 리소스(Container 등)까지 한 번에 확인할 수 있습니다.

Pod 상세 슬라이드의 리소스 관계도

  • 리소스 관계도에서 다른 카드를 클릭하면 상세 슬라이드의 내용이 그 객체로 전환됩니다.
  • 관계도 아래에는 클릭한 객체의 속성이 표시되며, 탭 구성과 세부 항목은 객체 종류에 따라 다릅니다. Pod는 Pod, Node는 Node, HPA는 HPA, Ingress는 Ingress, PVC·PV는 각각 PVC·PV, Storage Class는 Storage Class 문서를 참고하세요.

상세 슬라이드 우측 상단의 [Slide History]를 누르면 이전에 열어 본 상세 항목을 다시 확인할 수 있습니다.