Persistent Volume

Persistent Volume 화면에서는 선택한 클러스터의 PV(PersistentVolume) 목록과 상태별 현황을 확인하고, 개별 PV의 상세 정보·메트릭·바인딩된 PVC·이벤트·YAML 정의를 조회할 수 있습니다.

좌측 메뉴에서 Kubernetes > Storage > Persistent Volume을 선택하세요. 이 화면의 좌측 Filters > Cluster는 라디오 버튼 방식으로, 다른 쿠버네티스 화면과 달리 한 번에 하나의 클러스터만 선택해 조회할 수 있습니다.

화면은 스코어보드, Persistent Volume List 두 영역으로 구성됩니다.

스코어보드에서 PV 현황 파악하기​

화면 상단의 스코어보드에서 선택한 클러스터의 PV 현황을 확인할 수 있습니다.

• Total에 전체 PV 개수가 표시됩니다.
• Status에 상태별(Bound, Available, Released, Failed) PV 개수가 표시됩니다.

상태 카드를 클릭하면 아래 Persistent Volume List가 해당 상태의 PV만으로 필터링됩니다. 다시 클릭하면 필터가 해제됩니다. 예를 들어 Failed를 클릭하면 실패한 PV만 바로 찾아볼 수 있습니다.

Persistent Volume List에서 PV 목록 확인하기​

클러스터에 속한 PV를 표로 확인할 수 있습니다. PV Name, Status, Storage Classes, PVC Name, Capacity, Age가 표시됩니다.

목록 상단의 필터 입력란에 텍스트를 입력하면 컬럼 값 기준으로 빠르게 필터링할 수 있고, 입력란 왼쪽의 OR/AND 드롭다운으로 여러 필터 조건을 어떻게 조합할지 선택할 수 있습니다. 우측 상단의 [⋮] 버튼을 클릭하면 Export to Excel로 목록을 엑셀 파일로 내보낼 수 있습니다.

PV 상세 확인하기​

목록에서 PV Name을 클릭하면 화면 우측에 PV 상세 슬라이드가 표시됩니다. 상단에는 PV 식별자가 표시되며, Information, Metric, Event, Claim, YAML 탭으로 전환할 수 있습니다. Storage Classes, PVC Name을 클릭하면 각각 연관된 리소스의 상세 슬라이드로 이동합니다.

Information 탭​

PV의 리소스 관계도와 기본 정보를 확인할 수 있습니다.

• Related Resources에서 PV가 속한 Cluster를 확인할 수 있습니다. PV와 바인딩된 PVC의 관계는 Claim 탭에서 확인할 수 있습니다.
• Persistent Volumes Information 영역에서 Name, Cluster, Finalizers, Capacity, Access Modes, Reclaim Policy, Storage Class Name, Source Type, Status, Creation Time, Age를 확인할 수 있습니다.

Metric 탭​

PV에 바인딩된 PVC의 스토리지 사용 추이를 지표별 차트로 확인할 수 있습니다.

• Storage Total, Storage Used, Storage Available, Storage Usage (%) 지표를 차트로 확인할 수 있습니다. 각 차트 제목의 PVC 태그는 이 지표가 PV 자체가 아니라 바인딩된 PVC 기준으로 수집된다는 것을 나타냅니다.
• 바인딩된 PVC가 없는 PV는 지표를 수집할 대상이 없어 데이터 없음으로 표시됩니다.
• 우측 상단의 기간 선택기로 차트에 표시할 시간 구간을 변경할 수 있습니다.

Event 탭​

PV와 관련된 쿠버네티스 이벤트를 확인할 수 있습니다.

• Event List에 Type, Create Time, Kind, Name, Namespace가 표시됩니다. 해당 기간에 이벤트가 없으면 "No data."로 표시됩니다.
• 상단 필터 입력창으로 이벤트를 좁혀 볼 수 있습니다.

Claim 탭​

PV에 바인딩된 PVC 정보를 확인할 수 있습니다.

• Type, Name, Namespace가 표시됩니다. Name을 클릭하면 해당 PVC의 상세 슬라이드로 연계됩니다. PVC 상세 슬라이드의 구성은 Persistent Volume Claim 문서를 참고하세요.
• 바인딩된 PVC가 없는 PV(Available, Released, Failed 상태 등)는 바인딩된 PVC가 없다는 안내가 표시됩니다.

YAML 탭​

PV의 정의를 YAML 형식으로 확인할 수 있습니다.

• apiVersion, kind, metadata, spec, status 등 PV의 전체 정의를 원문으로 확인할 수 있습니다.
• 우측 상단의 복사 버튼으로 YAML 내용을 복사할 수 있습니다.