DOCSP-27281-add-chunkSize-field (#2340)

Co-authored-by: jason-price-mongodb <[email protected]>

Author: jason-price-mongodb

source/includes/sharding/balancer-status-defrag-example.rst

@@ -5,6 +5,7 @@ If the queried namespace is going through chunk defragmentation, the
    :copyable: false
 
    {
+      "chunkSize": Long("128"),
       "balancerCompliant": false,
       "firstComplianceViolation": "defragmentingChunks",
       "details": {

source/reference/command/balancerCollectionStatus.txt

@@ -70,6 +70,7 @@ The following is an example of a document returned by the command:
 .. code-block:: json
 
    {
+      "chunkSize": Long("128"),
       "balancerCompliant" : false,
       "firstComplianceViolation" : "chunksImbalance",
       "ok" : 1,
@@ -91,14 +92,16 @@ The following is an example of a document returned by the command:
    * - Field
      - Description
 
-   * - ``"balancerCompliant"``
+   * - ``"chunkSize"``
+     - .. versionadded:: 5.3
+
+       An integer that indicates the chunk size in megabytes.
 
+   * - ``"balancerCompliant"``
      - A boolean that indicates whether the chunks do not need to be
        moved (``true``) or need to be moved (``false``).
 
-
    * - ``"firstComplianceViolation"``
-
      - A string that indicates the reason chunks for this namespace need
        to be moved. The field is only available if
        ``"balancerCompliant"`` is ``false``.
@@ -113,26 +116,22 @@ The following is an example of a document returned by the command:
             - Description
 
           * - ``"chunksImbalance"``
-      
             - The difference in the number of chunks between the shard
               with the most chunks for the collection and the shard
               with the fewest chunks for the collection exceed the
               :ref:`migration threshold<sharding-migration-thresholds>`.
 
           * - ``"defragmentingChunks"``
-
             - The queried namespace is currently going through the chunk
               defragmentation process. Defragmentation can be triggered
               by the :dbcommand:`configureCollectionBalancing` command.
 
           * - ``"draining"``
-
             - A :ref:`remove shard operation
               <remove-shard-remove-chunks>` is in progress and MongoDB
               must drain chunks off the removed shard to other shard(s).
 
           * - ``"zoneViolation"``
-
             - Chunks violate the :ref:`defined zone ranges
               <zone-sharding-balancer>` for a shard.
 
@@ -144,7 +143,6 @@ The following is an example of a document returned by the command:
           ``firstComplianceViolation``.
 
    * - ``"details"``
-     
      - An object containing information on the ongoing defragmentation
        process. This object indicates the current phase of the
        defragmentation and how many chunks are left to process in that
@@ -177,6 +175,7 @@ returns an output similar to the following:
    :copyable: false
 
    {
+      "chunkSize": Long("128"),
       "balancerCompliant" : true,
       "ok" : 1,
       "operationTime" : Timestamp(1583193238, 1),