ceph/doc/dev/osd_internals/scrub.rst

   1
   2 Scrub internals and diagnostics
   3 ===============================
   4
   5 Scrubbing Behavior Table
   6 ------------------------
   7
   8 +-------------------------------------------------+----------+-----------+---------------+----------------------+
   9 |                                          Flags  | none     | noscrub   | nodeep_scrub  | noscrub/nodeep_scrub |
  10 +=================================================+==========+===========+===============+======================+
  11 | Periodic tick                                   |   S      |    X      |     S         |         X            |
  12 +-------------------------------------------------+----------+-----------+---------------+----------------------+
  13 | Periodic tick after osd_deep_scrub_interval     |   D      |    D      |     S         |         X            |
  14 +-------------------------------------------------+----------+-----------+---------------+----------------------+
  15 | Initiated scrub                                 |   S      |    S      |     S         |         S            |
  16 +-------------------------------------------------+----------+-----------+---------------+----------------------+
  17 | Initiated scrub after osd_deep_scrub_interval   |   D      |    D      |     S         |         S            |
  18 +-------------------------------------------------+----------+-----------+---------------+----------------------+
  19 | Initiated deep scrub                            |   D      |    D      |     D         |         D            |
  20 +-------------------------------------------------+----------+-----------+---------------+----------------------+
  21
  22 - X = Do nothing
  23 - S = Do regular scrub
  24 - D = Do deep scrub
  25
  26 State variables
  27 ---------------
  28
  29 - Periodic tick state is !must_scrub && !must_deep_scrub && !time_for_deep
  30 - Periodic tick after osd_deep_scrub_interval state is !must_scrub && !must_deep_scrub && time_for_deep
  31 - Initiated scrub state is  must_scrub && !must_deep_scrub && !time_for_deep
  32 - Initiated scrub after osd_deep_scrub_interval state is must scrub && !must_deep_scrub && time_for_deep
  33 - Initiated deep scrub state is  must_scrub && must_deep_scrub
  34
  35 Scrub Reservations
  36 ------------------
  37
  38 An OSD daemon command dumps total local and remote reservations::
  39
  40   ceph daemon osd.<id> dump_scrub_reservations
  41