Ceph Monitoring 명령어 정리 (2025년 기준)

Ceph 모니터링 명령어 총정리 (2025년 최신 버전 기준)

Ceph 클러스터 운영에서 모니터링은 필수 작업입니다. 특히 분산 스토리지 특성상 장애 원인을 빠르게 파악하고 조치하기 위해, 다양한 ceph 모니터링 명령어를 정확히 알고 활용하는 것이 중요합니다.

이 글에서는 최신 버전(2025년 기준)의 Ceph 환경을 기준으로 자주 사용하는 실무 명령어를 정리하고, 각 명령어의 목적과 실시간 모니터링 팁까지 포함하였습니다.

---

1. Ceph 상태 전체 확인 명령어

• ceph -s : 클러스터 전체 상태 요약
• ceph health detail : 상태 이상 항목 상세 확인
• ceph -w : 실시간 클러스터 상태 스트리밍

ceph -s
ceph health detail
ceph -w

특히 ceph -w는 모니터링 대시보드가 없을 경우 유용하게 사용할 수 있는 실시간 상태 로그입니다.

🔗 Ceph 공식 문서 - Monitoring Ceph

---

2. 클러스터 용량 및 통계 확인

• ceph df : 전체 클러스터의 사용량 요약
• ceph df detail : 각 Pool 별 상세 용량 정보
• rados df : RADOS 레벨에서의 통계 정보

ceph df
ceph df detail
rados df

특히 ceph df detail은 Pool별 데이터 저장 상태를 분석할 때 필수입니다.

---

3. OSD, MON, MGR 상태 점검

• ceph osd dump : 전체 OSD 설정 및 상태
• ceph osd tree : OSD Tree Map 확인
• ceph osd df : OSD별 사용량 및 상태
• ceph mon dump : Monitor 정보 확인
• ceph mgr dump : Manager 모듈 상태 확인

ceph osd dump
ceph osd tree
ceph osd df
ceph mon dump
ceph mgr dump

운영 중 OSD down이나 out 상태 발생 시 ceph osd tree로 구조 파악을 하고, osd df로 용량 병목 구간을 체크하는 것이 좋습니다.

🔗 OSD 관리 문서 (Ceph 공식)

---

4. Placement Group(PG) 관련 확인

• ceph pg dump : PG 상태 상세 출력

ceph pg dump

PG의 상태가 active+clean이 아닐 경우, 클러스터 내 데이터 불일치나 복구 지연이 발생하고 있는 것입니다.

실무 팁: ceph pg stat 명령어도 요약 상태 확인에 유용합니다.

---

5. Pool, Keyring, RADOS 정보

• ceph osd pool ls : Pool 리스트 출력
• ceph auth list : 인증 Keyring 정보 확인

ceph osd pool ls
ceph auth list

auth list는 서비스 별로 keyring이 정상 발급되었는지 확인할 때 필수입니다.

🔗 Ceph 유저 인증 관리 문서

---

6. CephFS 파일시스템 모니터링

• ceph fs status <파일시스템명> : CephFS 상태 확인

ceph fs status cephfs

클러스터에 다수의 CephFS 파일시스템이 있을 경우 ceph fs ls로 목록을 먼저 확인한 후 사용합니다.

ceph fs dump를 사용하면 더 많은 구조 정보를 확인할 수 있습니다.

---

7. 실무에서 유용한 추가 명령어

• ceph orch ps : Cephadm 기반 배포 환경에서 daemon 상태 확인
• ceph versions : 전체 데몬별 버전 정보 확인
• ceph crash ls : 최근 crash 로그 목록
• ceph telemetry show : 클러스터 원격 진단용 정보 확인

ceph orch ps
ceph versions
ceph crash ls

특히 ceph versions 명령어는 클러스터 구성 요소 간 버전 불일치 문제를 진단할 때 매우 유용합니다.

---

🔍 결론 및 요약

Ceph 클러스터는 다양한 구성 요소(OSD, MON, MGR, PG, Pool 등)로 이루어져 있고, 각 상태를 모니터링하기 위한 명령어도 매우 다양합니다. 본 글에서 정리한 명령어들은 RADOS 기반 모니터링을 중심으로 최신 Ceph 버전에 맞게 업데이트되어 있으며, 실무 환경에서도 바로 적용이 가능합니다.

운영 중 발생할 수 있는 장애에 대해 빠르게 대응하기 위해선 ceph -s, ceph health detail, ceph osd tree, ceph pg dump 등을 숙지하고 있어야 하며, 문제가 발생했을 때 ceph crash ls와 ceph versions는 유용한 진단 도구가 됩니다.

Ceph는 여전히 발전 중이며, 최신 버전에서는 cephadm과 함께 Orchestrator 모듈을 활용하는 모니터링도 중요해지고 있습니다. 관련 명령어 역시 함께 익혀두는 것이 좋습니다.

---