(DOCS-13197): Explain result improvements for mongos

source/reference/explain-results.txt

@@ -637,7 +637,8 @@ the ``explain`` operation.
            content: |
 
               For sharded collections, ``explain`` returns the
-              ``serverInfo`` for each accessed shard.
+              ``serverInfo`` for each accessed shard, and a top-level
+              ``serverInfo`` object for the :binary:`~bin.mongos`.
 
               .. code-block:: none
 
@@ -659,6 +660,16 @@ the ``explain`` operation.
                           }
                           ...
                        ]
+                    }
+                  },
+                  "serverInfo" : {      // serverInfo for mongos
+                    "host" : <string>,
+                    "port" : <int>,
+                    "version" : <string>,
+                    "gitVersion" : <string>
+                  }
+                  ...
+
 
 3.0 Format Change
 -----------------

source/release-notes/4.4.txt

@@ -1741,6 +1741,26 @@ response from the KMIP server before giving up, or retrying:
 
 These settings are available in MongoDB Enterprise only.
 
+Improvements to ``explain`` Results
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Starting in version 4.4 (and 4.2.2, 4.0.14, 3.6.16):
+
+- :doc:`Explain results </reference/explain-results/>` for commands run
+  on sharded clusters include a top-level :ref:`serverInfo <serverInfo>`
+  object for the :binary:`~bin.mongos` in addition to the ``serverInfo``
+  objects returned for each shard.
+
+- :doc:`Explain results </reference/explain-results/>` include the
+  :ref:`serverInfo <serverInfo>` object when
+  :data:`~explain.queryPlanner.optimizedPipeline` is ``true``. In
+  previous versions of MongoDB, ``explain`` results would occasionally
+  not include the ``serverInfo`` object when
+  :data:`~explain.queryPlanner.optimizedPipeline` was ``true``.
+
+.. seealso::
+
+   :doc:`Explain results </reference/explain-results/>`.
 
 :doc:`Changes Affecting Compatibility </release-notes/4.4-compatibility>`
 -------------------------------------------------------------------------