skills.rest
yaacov
yaacovCOMMUNITY
Explore all skills by this author →
GitHub

check-ceph-health

Diagnose and remediate Ceph storage health issues on OpenShift OCS/ODF clusters.

Updated Feb 25, 2026
Search Tags:#troubleshooting#diagnostics#openshift#ceph#pvc#ocs#odf
One-click install
npx skills add https://github.com/yaacov/forklift-skills --skill check-ceph-health
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: check-ceph-health
Source: https://github.com/yaacov/forklift-skills/tree/main/skills/check-ceph-health
Command: npx skills add https://github.com/yaacov/forklift-skills --skill check-ceph-health

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenShift clusters running Ceph-backed storage (OCS/ODF) can encounter health issues that block provisioning, degrade performance, or cause PVCs to stay Pending. This guide provides diagnostics and remediation steps to restore storage health.

Core Features & Use Cases

  • Retrieve and interpret Ceph cluster health status and capacity.
  • Inspect OSD health, pods, and storage devices; diagnose degraded or full OSD conditions.
  • Diagnose PVCs, PVs, and CSI provisioning to identify provisioning or retention problems.
  • Provide actionable remediation steps for common Ceph health problems in OpenShift.

Quick Start

Run quick health checks in the openshift-storage namespace to assess Ceph cluster health and identify affected components.

Frequently Asked Questions about check-ceph-health

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose Ceph health issues on an OpenShift OCS or ODF cluster?▼

To diagnose Ceph health on OpenShift OCS/ODF, access kubectl in the openshift-storage namespace to read cephcluster status, inspect OSD details, and check PVC/PV status for degraded conditions or full storage devices.

Why are PVCs stuck in Pending state on my OpenShift Ceph storage cluster?▼

PVCs remain Pending on OpenShift Ceph storage when CSI provisioning fails or the Ceph cluster is degraded. Diagnose the issue by inspecting PVC/PV status, CSI pods, and OSD capacity to identify provisioning or retention blockages.

How do I troubleshoot full or degraded OSDs in OpenShift storage?▼

Troubleshoot full or degraded OSDs in OpenShift storage by inspecting OSD health, pods, and storage devices. Diagnose capacity limits and apply actionable remediation steps to restore the Ceph cluster's storage health.

What is the best way to check Ceph cluster capacity and storage health in OpenShift?▼

The best way to check Ceph cluster capacity and storage health in OpenShift is running quick health checks in the openshift-storage namespace to retrieve and interpret cephcluster status and identify affected components.

When should I run Ceph storage diagnostics on my OpenShift cluster?▼

Run Ceph storage diagnostics on your OpenShift cluster when PVCs are Pending, provisioning fails, Ceph is degraded, OSDs are full, or the cluster requires diagnosis to restore OCS or ODF storage health.

Can I use kubectl to remediate Ceph provisioning problems in the openshift-storage namespace?▼

Yes, you can use kubectl in the openshift-storage namespace to diagnose and apply actionable remediation steps for common Ceph provisioning problems, addressing CSI pod failures and PV retention issues on OCS/ODF clusters.

Related Skills

Explore More Software Engineering Skills→
openshift-engopenshift-eng
112

LVMS Analyzer

Diagnose LVMS storage issues from must-gather data into a structured report.

Community
Intermediate
ChanghwanKChanghwanK

devops:storage-ops

Diagnose Rook-Ceph cluster health and PVC issues in the infra-k8s-idc cluster.

Community
Advanced
dapperdiversdapperdivers
1

ceph-health-monitor

Collect and analyze Rook-Ceph cluster health, OSD, and pool status.

Community
Advanced
keiretsu-labskeiretsu-labs
9

Storage Operations

Diagnoses Rook-Ceph and local-path-provisioner storage issues in Kubernetes clusters.

Official
Intermediate