DOCS-16384 readPreferenceCounters Metrics in serverStatus (#5196)

* DOCS-16384 readPreferenceCounters Metrics in serverStatus

* add availability note

* rn

* order

* internal review feedback

* AM feedback

* update rn

* *

Author: ajhuh-mdb

source/reference/command/serverStatus.txt

@@ -4103,6 +4103,97 @@ readConcernCounters
    time, which means a point in time was omitted and the server will
    read the most recently committed snapshot available to the node.
 
+.. _server-status-readPreferenceCounters:
+
+readPreferenceCounters
+~~~~~~~~~~~~~~~~~~~~~~
+
+*Available starting in MongoDB 7.2 (and 7.0.3, 6.0.11).*
+
+|mongod-only|
+
+.. code-block:: javascript
+
+   readPreferenceCounters : {
+      executedOnPrimary : { 
+         primary : {
+            internal : Long("<num>"),
+            external : Long("<num>") 
+         }, 
+         primaryPreferred : {
+            internal : Long("<num>"),
+            external : Long("<num>") 
+         }, 
+         secondary : {
+            internal : Long("<num>"),
+            external : Long("<num>") 
+         },
+         secondaryPreferred : {
+            internal : Long("<num>"),
+            external : Long("<num>") 
+         },
+         nearest : {
+            internal : Long("<num>"),
+            external : Long("<num>") 
+         },
+         tagged : {
+            internal : Long("<num>"),
+            external : Long("<num>") 
+         }
+      },
+      executedOnSecondary : { 
+         primary : {
+            internal : Long("<num>"),
+            external : Long("<num>") 
+         }, 
+         primaryPreferred : {
+            internal : Long("<num>"),
+            external : Long("<num>") 
+         }, 
+         secondary : {
+            internal : Long("<num>"),
+            external : Long("<num>") 
+         },
+         secondaryPreferred : {
+            internal : Long("<num>"),
+            external : Long("<num>") 
+         },
+         nearest : {
+            internal : Long("<num>"),
+            external : Long("<num>") 
+         },
+         tagged : {
+            internal : Long("<num>"),
+            external : Long("<num>") 
+         }
+      }
+   }
+
+.. serverstatus:: readPreferenceCounters
+
+   |mongod-only|
+
+   A document that reports the number of operations received by this 
+   :binary:`~bin.mongod` node with the specified 
+   :ref:`read preference <read-pref-summary>`.
+
+   The ``tagged`` sub-field refers to any read preference passed in 
+   with a :ref:`tag <replica-set-read-preference-tag-sets>`.
+
+.. serverstatus:: readPreferenceCounters.executedOnPrimary 
+
+   |mongod-only|
+
+   A document that counts how many internal and external read preference 
+   operations the node received while serving as the primary.
+
+.. serverstatus:: readPreferenceCounters.executedOnSecondary
+
+   |mongod-only|
+
+   A document that counts how many internal and external read preference 
+   operations the node received while serving as a secondary.
+
 .. _server-status-repl:
 
 repl

source/release-notes/7.2.txt

@@ -24,6 +24,16 @@ New Bulk Write Command
 
 .. include:: /includes/bulkWrite-introduction.rst
 
+.. _7.2-rel-notes-serverStatus:
+
+``serverStatus`` Metrics
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Starting in MongoDB 7.2, the :dbcommand:`serverStatus` command and the
+:method:`db.serverStatus()` method outputs include the following new metrics:
+
+- :serverstatus:`readPreferenceCounters`
+
 .. toctree::
    :titlesonly:
    :hidden: