DOCS-14213 printSecondaryReplicationInfo not documented

Author: jason-price-mongodb

.tx/config

@@ -3252,6 +3252,11 @@ file_filter = locale/<lang>/LC_MESSAGES/reference/method/db.cloneCollection.po
 source_file = locale/pot/reference/method/db.cloneCollection.pot
 source_lang = en
 
+[mongodb-manual.reference--method--db_printSecondaryReplicationInfo]
+file_filter = locale/<lang>/LC_MESSAGES/reference/method/db.printSecondaryReplicationInfo.po
+source_file = locale/pot/reference/method/db.printSecondaryReplicationInfo.pot
+source_lang = en
+
 [mongodb-manual.reference--method--db_printSlaveReplicationInfo]
 file_filter = locale/<lang>/LC_MESSAGES/reference/method/db.printSlaveReplicationInfo.po
 source_file = locale/pot/reference/method/db.printSlaveReplicationInfo.pot
@@ -4087,6 +4092,11 @@ file_filter = locale/<lang>/LC_MESSAGES/reference/method/db.collection.copyTo.po
 source_file = locale/pot/reference/method/db.collection.copyTo.pot
 source_lang = en
 
+[mongodb-manual.reference--method--rs_printSecondaryReplicationInfo]
+file_filter = locale/<lang>/LC_MESSAGES/reference/method/rs.printSecondaryReplicationInfo.po
+source_file = locale/pot/reference/method/rs.printSecondaryReplicationInfo.pot
+source_lang = en
+
 [mongodb-manual.reference--method--rs_printSlaveReplicationInfo]
 file_filter = locale/<lang>/LC_MESSAGES/reference/method/rs.printSlaveReplicationInfo.po
 source_file = locale/pot/reference/method/rs.printSlaveReplicationInfo.pot

source/includes/deprecated-db.printSlaveReplicationInfo.rst

@@ -0,0 +1,2 @@
+*Deprecated since version 4.4.1:* Use
+:method:`db.printSecondaryReplicationInfo()` instead.

source/includes/deprecated-rs.printSlaveReplicationInfo.rst

@@ -0,0 +1,2 @@
+*Deprecated since version 4.4.1:* Use
+:method:`rs.printSecondaryReplicationInfo()` instead.

source/includes/extracts-replSetReconfig.yaml

@@ -30,10 +30,10 @@ content: |
       Typically, the current configuration has already been installed on
       a majority of voting replica set members. However, the majority
       committed writes in the previous configuration may not all be
-      committed in the current configuration. 
-      :rsconf:`Delayed <members[n].slaveDelay>` members *or* members 
-      that are :method:`lagging behind <rs.printSlaveReplicationInfo()>` 
-      the primary can increase the time spent in this phase.
+      committed in the current configuration. :rsconf:`Delayed
+      <members[n].slaveDelay>` members *or* members that are
+      :method:`lagging behind <rs.printSecondaryReplicationInfo()>` the
+      primary can increase the time spent in this phase.
          
       If the operation was issued with a 
       |reconfig-maxTimeMS| limit *and* 

source/includes/note-method-does-not-return-json.rst

@@ -1,5 +1,5 @@
 .. note::
 
-   The |method| in the :binary:`~bin.mongo` shell does **not** return
-   :term:`JSON`. Use |method| for manual inspection, and
+   The |method| method run in the :binary:`~bin.mongo` shell does
+   **not** return :term:`JSON`. Use |method| for manual inspection, and
    |method-alternative| in scripts.

source/includes/output-printSecondaryReplicationInfo.rst

@@ -0,0 +1,32 @@
+Example |method| output when run on a replica set with two secondary
+members:
+
+.. code-block:: javascript
+
+   source: m1.example.net:27002
+       syncedTo: Mon Mar 01 2021 16:30:50 GMT-0800 (PST)
+       0 secs (0 hrs) behind the primary
+   source: m2.example.net:27003
+       syncedTo: Mon Mar 01 2021 16:30:50 GMT-0800 (PST)
+       0 secs (0 hrs) behind the primary
+
+.. include:: /includes/note-method-does-not-return-json.rst
+
+A :ref:`delayed member <replica-set-delayed-members>` may show as ``0``
+seconds behind the primary when the inactivity period on the primary is
+greater than the :rsconf:`members[n].slaveDelay` value.
+
+A member may show a negative time value behind the primary when |method|
+is run. This is expected if |method| is run after a secondary replicates
+a write that follows a period of inactivity, but before the secondary
+receives a heartbeat from the primary with the latest :term:`optime
+<optime>`.
+
+.. note::
+
+   The lag reported by secondaries may not be representative of cluster
+   health. Negative values do not indicate that the secondary is ahead
+   of the primary.
+
+   To obtain the most current status for your replica set, run |method|
+   on the primary.

source/reference/method.txt

@@ -528,13 +528,18 @@ Database
 
      - Prints a report of the status of the replica set from the perspective of the primary.
 
+   * - :method:`db.printSecondaryReplicationInfo()`
+
+     - Prints the status of the replica set from the
+       perspective of the secondaries.
+
    * - :method:`db.printShardingStatus()`
 
      - Prints a report of the sharding configuration and the chunk ranges.
 
    * - :method:`db.printSlaveReplicationInfo()`
 
-     - Prints a report of the status of the replica set from the perspective of the secondaries.
+     - .. include:: /includes/deprecated-db.printSlaveReplicationInfo.rst
 
    * - :method:`db.resetError()`
 
@@ -932,11 +937,17 @@ Replication
 
    * - :method:`rs.printReplicationInfo()`
 
-     - Prints a report of the status of the replica set from the perspective of the primary.
+     - Prints a formatted report of the replica set status from the
+       perspective of the primary.
+
+   * - :method:`rs.printSecondaryReplicationInfo()`
+
+     - Prints a formatted report of the replica set status from the
+       perspective of the secondaries.
 
    * - :method:`rs.printSlaveReplicationInfo()`
 
-     - Prints a report of the status of the replica set from the perspective of the secondaries.
+     - .. include:: /includes/deprecated-rs.printSlaveReplicationInfo.rst
 
    * - :method:`rs.reconfig()`
 

source/reference/method/db.printSecondaryReplicationInfo.txt

@@ -0,0 +1,28 @@
+==================================
+db.printSecondaryReplicationInfo()
+==================================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+Definition
+----------
+
+.. method:: db.printSecondaryReplicationInfo()
+
+   Prints a formatted report of the :term:`replica set` status from the
+   perspective of the :term:`secondary` member of the set. The output is
+   identical to the :method:`rs.printSecondaryReplicationInfo()` method.
+
+Output
+------
+
+.. |method| replace:: :method:`db.printSecondaryReplicationInfo()`
+.. |method-alternative| replace:: :method:`rs.status()`
+
+.. include:: /includes/output-printSecondaryReplicationInfo.rst

source/reference/method/db.printSlaveReplicationInfo.txt

@@ -15,6 +15,8 @@ Definition
 
 .. method:: db.printSlaveReplicationInfo()
 
+   .. include:: /includes/deprecated-db.printSlaveReplicationInfo.rst
+
    Returns a formatted report of the status of a :term:`replica set`
    from the perspective of the :term:`secondary` member of the set. The
    output is identical to that of

source/reference/method/js-database.txt

@@ -146,15 +146,21 @@ Database Methods
 
    * - :method:`db.printReplicationInfo()`
 
-     - Prints a report of the status of the replica set from the perspective of the primary.
+     - Prints a formatted report of the replica set status from
+       the perspective of the primary.
+
+   * - :method:`db.printSecondaryReplicationInfo()`
+
+     - Prints a formatted report of the replica set status from the
+       perspective of the secondaries.
 
    * - :method:`db.printShardingStatus()`
 
      - Prints a report of the sharding configuration and the chunk ranges.
 
    * - :method:`db.printSlaveReplicationInfo()`
 
-     - Prints a report of the status of the replica set from the perspective of the secondaries.
+     - .. include:: /includes/deprecated-db.printSlaveReplicationInfo.rst
 
    * - :method:`db.resetError()`
 
@@ -240,6 +246,7 @@ Database Methods
    /reference/method/db.logout
    /reference/method/db.printCollectionStats
    /reference/method/db.printReplicationInfo
+   /reference/method/db.printSecondaryReplicationInfo
    /reference/method/db.printShardingStatus
    /reference/method/db.printSlaveReplicationInfo
    /reference/method/db.resetError

source/reference/method/js-replication.txt

@@ -46,11 +46,17 @@ Replication Methods
 
    * - :method:`rs.printReplicationInfo()`
 
-     - Prints a report of the status of the replica set from the perspective of the primary.
+     - Prints a formatted report of the replica set status from the
+       perspective of the primary.
+
+   * - :method:`rs.printSecondaryReplicationInfo()`
+
+     - Prints a formatted report of the replica set status from the
+       perspective of the secondaries.
 
    * - :method:`rs.printSlaveReplicationInfo()`
 
-     - Prints a report of the status of the replica set from the perspective of the secondaries.
+     - .. include:: /includes/deprecated-rs.printSlaveReplicationInfo.rst
 
    * - :method:`rs.reconfig()`
 
@@ -88,6 +94,7 @@ Replication Methods
    /reference/method/rs.help
    /reference/method/rs.initiate
    /reference/method/rs.printReplicationInfo
+   /reference/method/rs.printSecondaryReplicationInfo
    /reference/method/rs.printSlaveReplicationInfo
    /reference/method/rs.reconfig
    /reference/method/rs.remove

source/reference/method/rs.printSecondaryReplicationInfo.txt

@@ -0,0 +1,28 @@
+==================================
+rs.printSecondaryReplicationInfo()
+==================================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+Definition
+----------
+
+.. method:: rs.printSecondaryReplicationInfo()
+
+   Prints a formatted report of the :term:`replica set` status from the
+   perspective of the :term:`secondary` member of the set. The output is
+   identical to :method:`db.printSecondaryReplicationInfo()`.
+
+Output
+------
+
+.. |method| replace:: :method:`rs.printSecondaryReplicationInfo()`
+.. |method-alternative| replace:: :method:`rs.status()`
+
+.. include:: /includes/output-printSecondaryReplicationInfo.rst

source/reference/method/rs.printSlaveReplicationInfo.txt

@@ -15,6 +15,8 @@ Definition
 
 .. method:: rs.printSlaveReplicationInfo()
 
+   .. include:: /includes/deprecated-rs.printSlaveReplicationInfo.rst
+
    Returns a formatted report of the status of a :term:`replica set`
    from the perspective of the :term:`secondary` member of the set. The
    output is identical to that of

source/reference/replication.txt

@@ -47,11 +47,17 @@ Replication Methods in the ``mongo`` Shell
 
    * - :method:`rs.printReplicationInfo()`
 
-     - Prints a report of the status of the replica set from the perspective of the primary.
+     - Prints a formatted report of the replica set status from the
+       perspective of the primary.
+
+   * - :method:`rs.printSecondaryReplicationInfo()`
+
+     - Prints a formatted report of the replica set status from the
+       perspective of the secondaries.
 
    * - :method:`rs.printSlaveReplicationInfo()`
 
-     - Prints a report of the status of the replica set from the perspective of the secondaries.
+     - .. include:: /includes/deprecated-rs.printSlaveReplicationInfo.rst
 
    * - :method:`rs.reconfig()`
 

source/tutorial/troubleshoot-replica-sets.txt

@@ -45,7 +45,7 @@ will be inconsistent.
 To check the current length of replication lag:
 
 - In a :binary:`~bin.mongo` shell connected to the primary, call the
-  :method:`rs.printSlaveReplicationInfo()` method.
+  :method:`rs.printSecondaryReplicationInfo()` method.
 
   Returns the ``syncedTo`` value for each member,
   which shows the time when the last oplog entry was written to the