DOCSP-35385 v7.0 (#6352)

Author: jmd-mongo

source/includes/shardedDataDistribution-orphaned-docs.rst

@@ -0,0 +1,18 @@
+Starting in MongoDB 6.0.3, you can run an aggregation using the 
+:pipeline:`$shardedDataDistribution` stage to confirm no orphaned 
+documents remain:
+
+.. code-block:: javascript
+
+   db.aggregate([
+      { $shardedDataDistribution: { } },
+      { $match: { "ns": "<database>.<collection>" } }
+   ])
+
+``$shardedDataDistribution`` has output similar to the following:
+
+.. include:: /includes/shardedDataDistribution-output-example.rst
+
+Ensure that ``"numOrphanedDocs"`` is ``0`` for each shard in the
+cluster.
+

source/reference/command/cleanupOrphaned.txt

@@ -10,6 +10,13 @@ cleanupOrphaned
    :depth: 1
    :class: singlecol
 
+.. important::
+
+   Starting in MongoDB 6.0.3, you should run an aggregation using the 
+   :pipeline:`$shardedDataDistribution` stage to confirm no orphaned 
+   documents remain. For details, 
+   see :ref:`shardedDataDistribution-no-orphaned-docs`.
+
 Definition
 ----------
 

source/reference/operator/aggregation/shardedDataDistribution.txt

@@ -51,12 +51,50 @@ following fields:
 Examples
 --------
 
+Return All Sharded Data Distibution Metrics
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To return all sharded data distribution metrics, run the following:
+
 .. code-block:: javascript
 
-   db.aggregate( [
+   db.aggregate([
       { $shardedDataDistribution: { } }
-   ] )
+   ])
 
 Example output:
 
 .. include:: /includes/shardedDataDistribution-output-example.rst
+
+Return Metrics for a Specific Shard
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To return sharded data distribution metrics for a specific shard,
+run the following:
+
+.. code-block:: javascript
+
+   db.aggregate([ 
+      { $shardedDataDistribution: { } },
+      { $match: {  "shards.shardName": "<name of the shard>" } }
+   ])
+
+Return Metrics for a Namespace
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To return sharded data distribution data for a namespace, run the
+following:
+
+.. code-block:: javascript
+
+   db.aggregate([ 
+      { $shardedDataDistribution: { } }, 
+      { $match: {  "ns": "<database>.<collection>" } }
+   ])
+
+.. _shardedDataDistribution-no-orphaned-docs:
+
+Confirm No Orphaned Documents Remain
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. include:: /includes/shardedDataDistribution-orphaned-docs.rst