Skip to content

Commit 8f6d89e

Browse files
authored
DOCSP 33147 v4.4 backport: Clarifying and simplifying language for serverStatus metrics (#4930)
* DOCSP-33147 improve serverStatus descriptions for metrics (#4805) * DOCSP-33147 improve serverStatus descriptions for metrics * DOCSP-33147 improve serverStatus descriptions for metrics * DOCSP-33147 improve serverStatus descriptions for metrics * DOCSP-33147 improve serverStatus descriptions for metrics * DOCSP-33147 active voice * DOCSP-33147 active voice * DOCSP-33147 consistency * DOCSP-33147 consistency * DOCSP-33147 copy edits * DOCSP-33147 copy edits * DOCSP-33147 typo * DOCSP-33147-v4.4-backport backport edits
1 parent 26b28e5 commit 8f6d89e

File tree

1 file changed

+24
-27
lines changed

1 file changed

+24
-27
lines changed

source/reference/command/serverStatus.txt

Lines changed: 24 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -2593,23 +2593,23 @@ shardingStatistics
25932593

25942594
.. serverstatus:: shardingStatistics.countDonorMoveChunkStarted
25952595

2596-
The total number of times that the :dbcommand:`moveChunk` command
2597-
has started on the shard, of which this node is a member, as part of
2598-
a :ref:`chunk migration process <chunk-migration-procedure>`. This
2599-
increasing number does not consider whether the chunk migrations
2600-
succeed or not.
2596+
The total number of times that MongoDB starts the
2597+
:dbcommand:`moveChunk` command on the primary node of the shard as
2598+
part of the :ref:`chunk migration process
2599+
<chunk-migration-procedure>`. This increasing number does not
2600+
consider whether the chunk migrations succeed or not.
26012601

26022602
*Only present when run on a shard.*
26032603

26042604
.. serverstatus:: shardingStatistics.totalDonorChunkCloneTimeMillis
26052605

2606-
The cumulative time, in milliseconds, taken by the :ref:`clone phase
2607-
of the chunk migrations <chunk-migration-procedure>` from this
2608-
shard, of which this node is a member. Specifically, for each
2609-
migration from this shard, the tracked time starts with the
2610-
:dbcommand:`moveChunk` command and ends before the destination shard
2611-
enters a catch-up phase to apply changes that occurred during the
2612-
:ref:`chunk migrations <chunk-migration-procedure>`.
2606+
The cumulative time, in milliseconds, that the :ref:`clone phase of
2607+
the chunk migrations <chunk-migration-procedure>` takes on the
2608+
primary node of the shard. Specifically, for each migration on this
2609+
shard, the tracked time starts with the :dbcommand:`moveChunk`
2610+
command and ends before the destination shard enters a ``catchup``
2611+
phase to apply changes that occurred during the :ref:`chunk
2612+
migrations <chunk-migration-procedure>`.
26132613

26142614
*Only present when run on a shard.*
26152615

@@ -2624,10 +2624,9 @@ shardingStatistics
26242624

26252625
.. serverstatus:: shardingStatistics.totalCriticalSectionTimeMillis
26262626

2627-
The cumulative time, in milliseconds, taken by the :ref:`catch-up
2627+
The cumulative time, in milliseconds, that the :ref:`catch-up
26282628
phase and the update metadata phase of the chunk migrations
2629-
<chunk-migration-procedure>` from this shard, of which this node is
2630-
a member.
2629+
<chunk-migration-procedure>` takes on the primary node of the shard.
26312630

26322631
To calculate the duration of the catch-up phase, subtract
26332632
:serverstatus:`~shardingStatistics.totalCriticalSectionCommitTimeMillis` from
@@ -2641,19 +2640,17 @@ shardingStatistics
26412640

26422641
.. serverstatus:: shardingStatistics.countDocsClonedOnRecipient
26432642

2644-
Cumulative, always-increasing count of documents that have been
2645-
cloned on this member where it acted as the primary of the recipient
2646-
shard.
2643+
The cumulative, always-increasing count of documents that MongoDB
2644+
clones on the primary node of the recipient shard.
26472645

26482646
*Only present when run on a shard.*
26492647

26502648
.. versionadded:: 4.2
26512649

26522650
.. serverstatus:: shardingStatistics.countDocsClonedOnDonor
26532651

2654-
Cumulative, always-increasing count of documents that haves been
2655-
cloned on this member where it acted as the primary of the donor
2656-
shard.
2652+
The cumulative, always-increasing count of documents that MongoDB
2653+
clones on the primary node of the donor shard.
26572654

26582655
*Only present when run on a shard.*
26592656

@@ -2671,19 +2668,19 @@ shardingStatistics
26712668

26722669
.. serverstatus:: shardingStatistics.countDocsDeletedOnDonor
26732670

2674-
Cumulative, always-increasing count of documents that have been
2675-
deleted on this member during chunk migration where the member acted
2676-
as the primary of the donor shard.
2671+
The cumulative, always-increasing count of documents that MongoDB
2672+
deletes on the primary node of the donor shard during chunk
2673+
migration.
26772674

26782675
*Only present when run on a shard.*
26792676

26802677
.. versionadded:: 4.2
26812678

26822679
.. serverstatus:: shardingStatistics.countDonorMoveChunkLockTimeout
26832680

2684-
Cumulative, always-increasing count of chunk migrations that were
2685-
aborted due to lock acquisition timeouts, where the member acted as
2686-
the primary of the donor shard.
2681+
The cumulative, always-increasing count of chunk migrations that MongoDB
2682+
aborts on the primary node of the donor shard due to lock acquisition
2683+
timeouts.
26872684

26882685
*Only present when run on a shard.*
26892686

0 commit comments

Comments
 (0)