ceph / ceph/ceph-csi

Add cephcsi troubleshooting guide

Open
#1,173 5 comments 5 reactions 0 assignees View on GitHub
component/docs enhancement keepalive
Dominant language
Go
Stars
1.6k
Forks
617
Avg merge
5d 10h
Merged PRs (30d)
43

Description

Currently, we don't have a troubleshooting guide to help users to understand the issue in first step. we need to come up with a document which helps in debugging the issues with cephcsi

* Which pod logs to check
* Any helper commands to identify the issue(in case of operation already exists, what logs user need to check and which command he execute and where to execute to check running/hang command)
* Force unmap if the mountpoint not present to unblock delete operation
* Check mon network connectivity from provisioner and plugin pods
etc...

Contributor guide

No contributing guide indexed for this repository

Research direction

No file, test, or documentation entry point is named. Start by reviewing the existing cephcsi documentation and operational guidance, then map the provisioner and plugin pods, mon connectivity checks, operation-hang logs and commands, and force-unmap procedure. Done means a troubleshooting guide covers each listed scenario with clear commands, locations, and expected checks.

Written by the indexing model from the issue text.

Assessment

Tech stack
kubernetes
Domain
devops, documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.