mirror of https://github.com/ceph/ceph
59 lines
1.3 KiB
ReStructuredText
59 lines
1.3 KiB
ReStructuredText
Progress Module
|
|
===============
|
|
|
|
The progress module is used to inform users about the recovery progress of PGs
|
|
(Placement Groups) that are affected by events such as (1) OSDs being marked
|
|
in or out and (2) ``pg_autoscaler`` trying to match the target PG number.
|
|
|
|
The ``ceph -s`` command returns something called " Global Recovery Progress",
|
|
which reports the overall recovery progress of PGs and is based on the number
|
|
of PGs that are in the ``active+clean`` state.
|
|
|
|
Enabling
|
|
--------
|
|
|
|
The *progress* module is enabled by default, but it can be enabled manually by
|
|
running the following command:
|
|
|
|
.. prompt:: bash #
|
|
|
|
ceph progress on
|
|
|
|
The module can be disabled at anytime by running the following command:
|
|
|
|
.. prompt:: bash #
|
|
|
|
ceph progress off
|
|
|
|
Commands
|
|
--------
|
|
|
|
Show the summary of all the ongoing and completed events and their duration:
|
|
|
|
.. prompt:: bash #
|
|
|
|
ceph progress
|
|
|
|
Show the summary of ongoing and completed events in JSON format:
|
|
|
|
.. prompt:: bash #
|
|
|
|
ceph progress json
|
|
|
|
Clear all ongoing and completed events:
|
|
|
|
.. prompt:: bash #
|
|
|
|
ceph progress clear
|
|
|
|
PG Recovery Event
|
|
-----------------
|
|
|
|
An event for each PG affected by recovery event can be shown in
|
|
`ceph progress` This is completely optional, and disabled by default
|
|
due to CPU overheard:
|
|
|
|
.. prompt:: bash #
|
|
|
|
ceph config set mgr mgr/progress/allow_pg_recovery_event true
|