Persistent Volume Claim

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

좌측 메뉴에서 Kubernetes > Storage > Persistent Volume Claim을 선택하세요.

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

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

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

• Total에 전체 PVC 개수가 표시됩니다.
• Status에 상태별(Bound, Pending, Lost) PVC 개수가 표시됩니다.
• Alert에 알람 심각도별(Normal, Warning, Critical) PVC 개수가 표시됩니다.

상태·알람 카드를 클릭하면 아래 Persistent Volume Claim List가 해당 상태의 PVC만으로 필터링됩니다. 다시 클릭하면 필터가 해제됩니다. 예를 들어 Status의 Lost를 클릭하면 유실된 PVC만 바로 찾아볼 수 있습니다.

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

클러스터에 속한 PVC를 표로 확인할 수 있습니다. PVC Name, Status, Namespace, PV Name, Storage Classes, Storage Used, Storage Available, Storage Total, Storage Usage (%), Age, Alert가 표시됩니다.

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

PVC 상세 확인하기​

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

Information 탭​

PVC의 리소스 관계도와 기본 정보, 마운트된 Pod를 확인할 수 있습니다.

• Related Resources에서 PVC·PV·Storage Class의 연결 관계를 도식으로 확인할 수 있습니다.
• Persistent Volumes Claims 영역에서 Name, Cluster, Namespace, Finalizers, Access Modes, Storage Class Name, Storage Total, Volume Mode, Status, Labels, Creation Time, Age를 확인할 수 있습니다.
• Pods & Mounts에서 이 PVC를 마운트한 Pod의 Node, Status, Mount Path를 확인할 수 있습니다.

Metric 탭​

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

• Storage Total, Storage Used, Storage Available, Storage Usage, Inode Usage (%) 등의 지표를 차트로 확인할 수 있습니다.
• 우측 상단의 기간 선택기로 차트에 표시할 시간 구간을 변경할 수 있습니다.

Storage Usage가 지속적으로 높은 PVC는 용량 부족으로 장애가 발생할 수 있으므로, Metric 탭에서 증가 추이를 미리 확인해 용량 확장 시점을 판단하는 데 유용합니다.

Pod 탭​

이 PVC를 사용하는 Pod 목록을 확인할 수 있습니다.

• Pod List에 Pod Name, Namespace, Containers, Alert, Status가 표시됩니다.
• Pod Name을 클릭하면 해당 파드의 상세 슬라이드로 연계됩니다. 파드 상세 슬라이드의 구성은 Pod 문서를 참고하세요.

Event 탭​

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

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

Selector 탭​

PVC에 설정된 셀렉터 조건을 확인할 수 있습니다.

• Match Labels, MatchExpressions가 표시됩니다. 동적 프로비저닝으로 생성되어 셀렉터가 설정되지 않은 PVC는 -로 표시됩니다.

YAML 탭​

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

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

Alert 탭​

PVC에 적용된 알람 룰과 발생 현황을 확인할 수 있습니다.

• Rule List에 Rule Name, Alert Stat Name, Target, Alert Detail, Last Triggered, Rule Type 등이 표시됩니다.
• Show only Triggered Alert로 발생한 알람만 추려서 볼 수 있고, List·Bar 보기로 전환할 수 있습니다.