(DOCS-14924): created date included in mongos output (#159)

* (DOCS-14924): created date included in mongos output

* updates per copy review

* remove extra space

* remove extra space

* edit example output

* updates per copy review

* fix table format

* change 'ping' data type

* single source table

* milliseconds > seconds

Author: jeff-allen-mongo

source/includes/table-mongos-output-fields.rst

@@ -0,0 +1,45 @@
+.. list-table::
+   :header-rows: 1
+   :stub-columns: 1
+   :widths: 10 10 20
+
+   * - Field
+     - Data Type
+     - Description
+
+   * - ``_id``
+     - String
+     - The hostname and port where the
+       :binary:`~bin.mongos` is running. The ``_id`` is formatted as
+       ``<hostname>:<port>``.
+
+   * - ``advisoryHostFQDNs``
+     - Array of strings
+     - Array of the :binary:`~bin.mongos`'s fully qualified domain
+       names (FQDNs).
+
+   * - ``created``
+     - Date
+     - When the :binary:`~bin.mongos` was started.
+
+       .. versionadded:: 5.2
+
+   * - ``mongoVersion``
+     - String
+     - Version of MongoDB that the :binary:`~bin.mongos` is running.
+
+   * - ``ping``
+     - Date
+     - :binary:`~bin.mongos` instances send pings to the
+       :ref:`config server <sharding-config-server>` every 30
+       seconds. This field indicates the last ping time.
+
+   * - ``up``
+     - NumberLong
+     - Number of seconds the :binary:`~bin.mongos` has been up as of
+       the last ping.
+
+   * - ``waiting``
+     - Boolean
+     - As of MongoDB 3.4, this field is always ``true`` and is
+       only present for backward compatibility.

source/reference/config-database.txt

@@ -14,11 +14,11 @@ Config Database
 
 The collections in the ``config`` database support:
 
-- :doc:`sharded cluster operations </sharding>`, and
+- :doc:`Sharded cluster operations </sharding>`
 
-- starting in MongoDB 3.6, :ref:`causally consistent sessions
-  <sessions>` for standalones, replica sets, and sharded clusters and
-  retryable writes for replica sets and sharded clusters.
+- :ref:`Causally consistent sessions <sessions>` for standalones,
+  replica sets, and sharded clusters and retryable writes for replica
+  sets and sharded clusters.
 
 Restrictions
 ------------
@@ -333,29 +333,30 @@ to support sharding:
    .. include:: /includes/admonition-config-db-is-internal.rst
 
    The :data:`~config.mongos` collection stores a document for each
-   :binary:`~bin.mongos` instance affiliated with the
-   cluster. :binary:`~bin.mongos` instances send pings to all members of
-   the cluster every 30 seconds so the cluster can verify that the
-   :binary:`~bin.mongos` is active. The ``ping`` field shows the time of
-   the last ping, while the ``up`` field reports the uptime of the
-   :binary:`~bin.mongos` as of the last ping. The cluster maintains this
-   collection for reporting purposes.
+   :binary:`~bin.mongos` instance affiliated with the cluster. The
+   cluster maintains this collection for reporting purposes.
+   
+   Each document in the :data:`~config.mongos` collection contains these
+   fields:
+
+   .. include:: /includes/table-mongos-output-fields.rst
 
    The following document shows the status of the :binary:`~bin.mongos`
    running on ``example.com:27017``.
 
    .. code-block:: javascript
 
-      {
-         "_id" : "example.com:27017",
-         "advisoryHostFQDNs" : [
-            "example.com"
-         ],
-         "mongoVersion" : "4.2.0",
-         "ping" : ISODate("2019-09-25T19:26:52.360Z"),
-         "up" : NumberLong(50),
-         "waiting" : true
-      }
+      [
+         {
+           _id: 'example.com:27017',
+           advisoryHostFQDNs: [ "example.com" ],
+           created: ISODate("2021-11-22T16:32:13.708Z"),
+           mongoVersion: "5.2.0",
+           ping: ISODate("2021-12-15T22:09:23.161Z"),
+           up: Long("2007429"),
+           waiting: true
+         }
+      ]
 
 .. data:: config.rangeDeletions
 

source/reference/method/sh.status.txt

@@ -209,34 +209,32 @@ Sharding Version
 Active ``mongos`` Instances
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 3.2
-
 .. data:: sh.status.active-mongoses
 
    If ``verbose`` is ``false``, :data:`sh.status.active-mongoses` lists
    the version and count of the active :binary:`~bin.mongos` instances.
    Active :binary:`~bin.mongos` instances are :binary:`~bin.mongos`
-   instances that have been ping'ed within the last 60 seconds.
+   instances that have been pinged within the last 60 seconds.
 
-   If ``verbose`` is ``true``, returns for each active  :binary:`~bin.mongos`  instance:
-   
-   - Its hostname and port.
-   
-   - An array of the instance's fully qualified domain names (FQDNs).
-   
-   - Its MongoDB version.
-   
-   - Its most recent ping date and time.
-   
-   - Its uptime since the last ping.
+   If ``verbose`` is ``true``, :data:`sh.status.active-mongoses` returns
+   a document for each active :binary:`~bin.mongos` instance containing
+   the following fields:
 
-   - Its waiting status.
+   .. include:: /includes/table-mongos-output-fields.rst
 
    .. code-block:: javascript
 
       active mongoses:
 
-      {  "_id" : "<hostname:port>",  "advisoryHostFQDNs" : [ "<name>" ],  "mongoVersion" : <string>,  "ping" : <ISODate>,  "up" : <long>,  "waiting" : <boolean> }
+      { 
+         "_id" : "<hostname:port>", 
+         "advisoryHostFQDNs" : [ "<name>" ],
+         "created" : <ISODate>,
+         "mongoVersion" : <string>,
+         "ping" : <ISODate>,
+         "up" : <long>,
+         "waiting" : <boolean>
+      }
       ...
 
 .. _autosplit-status:

source/release-notes/5.2.txt

@@ -45,6 +45,19 @@ MongoDB 5.2 introduces the following aggregation operators:
    * - :expression:`$sortArray`
      - Sorts an array based on its elements. 
 
+.. _5.2-rel-notes-sharding:
+
+Sharding
+--------
+
+Starting in MongoDB 5.2, the time that a :binary:`~bin.mongos` was
+started is included in the:
+
+- Output of the :method:`sh.status()` method (when ``verbose`` is set
+  to ``true``)
+
+- :data:`config.mongos` collection
+
 .. _5.2-rel-notes-general:
 
 General Improvements