I'm working on adding some material to the PG-repair page on the docs website, and after a bit of reading and watching of videos, I have boiled it down to a couple of commands:

Diagnose problems using this command:

$ sudo ceph pg dump --format=json-pretty

and then use the output of that command to discover the number of the placement group that is inconsistent or broken, and run a command that looks like this:

$ sudo ceph pg repair 1.4

where "1.4" is the number of the affected placement group.

This is a fine start, but I thought that I would ask everyone here for their experiences with "pg repair", because I'd like the docs to be a bit beefier than just a couple of commands.

Thanks in advance everyone.

Zac

(The documentation guy)