README.md

Ceph Diagnostics

This repository contains a script that collects the ceph diagnostic informations and store it in a tarfile.

What is being collected ?

Script collects information, some at OS level, some at the cluster level and some at the daemon level. Script assumes that ceph config file is in /etc/ceph/ceph.config

1. Operating system level
   1. uname
   2. lsb_release
   3. system statistics - RAM, CPU
2. Cluster level
   1. ceph status
   2. ceph version and ceph versions(if applicable)
   3. fsid
   4. ceph config file (reads config file)
   5. ceph health
   6. ceph health detail
   7. ceph df
3. Daemons
   1. Monitors
      1. ceph mon stat
      2. ceph mon dump
      3. ceph mon getmap
      4. ceph mon metadata
   2. OSD
      1. ceph osd df
      2. ceph osd tree
      3. ceph osd dump
      4. ceph osd stat
      5. ceph osd getmap
      6. ceph osd getcrushmap
      7. ceph osd perf
      8. ceph osd metadata
   3. Placement groups
      1. ceph pg stat
      2. ceph pg dump
      3. ceph pg dump_stuck
   4. Meta Data Server
      1. ceph mds stat
      2. ceph mds dump
      3. ceph mds getmap

Ceph diagnostic collect script collects all the above information and puts the result of every command in a file and forms a tarball of all the files in /tmp folder.

How to execute ?

Script makes use of librados python library to execute monitor commands.

python ceph_diagnostics_collect.py [--ceph-config-file] [--results-dir] [--timeout]

• defaults :
  • ceph-config-file = /etc/ceph/ceph.config
  • results-dir = /tmp
  • timeout = 10 seconds