DOCS-15617-TLS-metrics-and-move-others-to-6.2 (#1886)

jason-price-mongodb · jason-price-mongodb · web-flow · commit 1d02fc43eb14 · 2022-09-20T16:32:53.000-07:00
* DOCS-15617-TLS-metrics-and-move-others-to-6.2

* DOCS-15617-TLS-metrics-and-move-others-to-6.2

* DOCS-15617-TLS-metrics-and-move-others-to-6.2

* DOCS-15617-TLS-metrics-and-move-others-to-6.2

* DOCS-15617-TLS-metrics-and-move-others-to-6.2

* DOCS-15617-TLS-metrics-and-move-others-to-6.2

Co-authored-by: jason-price-mongodb &lt;jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com&gt;
diff --git a/snooty.toml b/snooty.toml
@@ -227,7 +227,7 @@ windows-dir-version = "6.0" # wizard
 package-name-org = "mongodb-org"
 package-name-enterprise = "mongodb-enterprise"
 package-name = "mongodb"
-version = "6.1"
+version = "6.2"
 latest-lts-version = "6.0"
 release = "6.0.1"
 version-dev = "6.0"
diff --git a/source/reference/command/connPoolStats.txt b/source/reference/command/connPoolStats.txt
@@ -428,7 +428,7 @@ Output
 
 .. data:: connPoolStats.acquisitionWaitTimes
 
-   .. versionadded:: 6.1
+   .. versionadded:: 6.2
 
    Document reports a histogram with the wait times for requests to
    acquire a connection from :binary:`~bin.mongos` to
diff --git a/source/reference/command/serverStatus.txt b/source/reference/command/serverStatus.txt
@@ -269,7 +269,7 @@ connections
       "current" : <num>,
       "available" : <num>,
       "totalCreated" : <num>,
-      "rejected" : <num>,  // Added in MongoDB 6.1
+      "rejected" : <num>,  // Added in MongoDB 6.2
       "active" : <num>,
       "threaded" : <num>,
       "exhaustIsMaster" : <num>,
@@ -310,12 +310,12 @@ connections
 
 .. serverstatus:: connections.rejected
 
+   .. versionadded:: 6.2
+
    The number of incoming connections the server rejected because the
    server doesn't have the capacity to accept additional connections or
    the :setting:`net.maxIncomingConnections` setting is reached.
 
-   .. versionadded:: 6.1
-
 .. serverstatus:: connections.active
 
    The number of active client connections to the server. Active client
@@ -1504,6 +1504,11 @@ metrics
             totalOpened : Long("<num>")
          }
       },
+      network : {  // Added in MongoDB 6.2
+         totalEgressConnectionEstablishmentTimeMillis : Long("<num>"),
+         totalIngressTLSConnections : Long("<num>"),
+         totalIngressTLSHandshakeTimeMillis : Long("<num>")
+      },
       operation : {
             scanAndOrder : Long("<num>"),
             writeConflicts : Long("<num>")
@@ -2611,7 +2616,7 @@ network
             "clientsWaitingForData" : <num>
          }
       },
-      "listenerProcessingTime" : { durationMicros: <num> }  // Added in MongoDB 6.1
+      "listenerProcessingTime" : { durationMicros: <num> }  // Added in MongoDB 6.2
    }
 
 .. serverstatus:: network
@@ -2794,15 +2799,15 @@ network
 
 .. serverstatus:: network.listenerProcessingTime
 
-   .. versionadded:: 6.1
+   .. versionadded:: 6.2
 
    A document that reports the total time the database listener spends
    allocating incoming database connection requests to dedicated
    threads.
 
 .. serverstatus:: network.listenerProcessingTime.durationMicros
 
-   .. versionadded:: 6.1
+   .. versionadded:: 6.2
 
    Total time in microseconds the database listener spends allocating
    incoming database connection requests to dedicated threads that
@@ -5035,16 +5040,31 @@ transactions
 
 .. serverstatus:: metrics.network
 
-   A document that reports the total time to establish server
-   connections.
+   .. versionadded:: 6.2
 
-   .. versionadded:: 6.1
+   A document that reports server network metrics.
 
 .. serverstatus:: metrics.network.totalEgressConnectionEstablishmentTimeMillis
 
+   .. versionadded:: 6.2
+
    The total time in milliseconds to establish server connections.
 
-   .. versionadded:: 6.1
+.. serverstatus:: metrics.network.totalIngressTLSConnections
+
+   .. versionadded:: 6.2
+
+   The total number of incoming connections to the server that use TLS.
+   The number is cumulative and is the total after the server was
+   started.
+
+.. serverstatus:: metrics.network.totalIngressTLSHandshakeTimeMillis
+
+   .. versionadded:: 6.2
+
+   The total time in milliseconds that incoming connections to the
+   server have to wait for the TLS network handshake to complete. The
+   number is cumulative and is the total after the server was started.
 
 .. serverstatus:: transactions.retriedCommandsCount
 
diff --git a/source/reference/parameters.txt b/source/reference/parameters.txt
@@ -1088,6 +1088,8 @@ General Parameters
 
 .. parameter:: slowConnectionThresholdMillis
 
+   .. versionadded:: 6.2
+   
    *Default*: 100
 
    |both|
diff --git a/source/release-notes/6.1.txt b/source/release-notes/6.1.txt
@@ -47,7 +47,6 @@ results in a slower query than one without the option specified.
 For an example that uses the ``*UCP`` option, see
 :ref:`regex-example-pcre2-ucp`.
 
-
 General Changes
 ---------------
 
@@ -73,60 +72,6 @@ Improved Efficiency for Multiple Document Deletions
 
 .. include:: /includes/multi-deletes.rst
 
-``connPoolStats`` Metrics
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Starting in MongoDB 6.1, the :dbcommand:`connPoolStats` command has
-these output changes:
-
-.. list-table::
-   :header-rows: 1
-   :widths: 50 50
-
-   * - Document
-     - Field(s)
-
-   * - New :data:`connPoolStats.acquisitionWaitTimes` document that
-       reports the wait times for requests to acquire a connection from
-       :binary:`~bin.mongos` to :binary:`~bin.mongod`. 
-     - New fields:
-
-       - Time ranges with the number of connection requests in each
-         range.
-       - Total number of connection requests for all time ranges.
-
-``serverStatus`` Metrics
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-Starting in MongoDB 6.1, the :dbcommand:`serverStatus` command and the
-:method:`db.serverStatus()` method have these output changes:
-
-.. list-table::
-   :header-rows: 1
-   :widths: 50 50
-
-   * - Document
-     - Field(s)
-
-   * - New :serverstatus:`network.listenerProcessingTime` document that
-       reports the time the database listener spends allocating
-       incoming database connection requests.
-     - New field:
-
-       - :serverstatus:`network.listenerProcessingTime.durationMicros`
-
-   * - New :serverstatus:`metrics.network` document that reports the
-       total time to establish server connections.
-     - New field:
-
-       - :serverstatus:`metrics.network.totalEgressConnectionEstablishmentTimeMillis`
-
-   * - Addition to :serverstatus:`connections` document.
-     - New field that reports the number of incoming connections the
-       server has rejected.
-
-       - :serverstatus:`connections.rejected`
-
 Storage Engine
 ~~~~~~~~~~~~~~
 
@@ -141,8 +86,6 @@ Starting in MongoDB 6.1, MongoDB adds the following new parameters:
   between retries after a write failure. 
 - :parameter:`temporarilyUnavailableMaxRetries` limits the number of
   retries after a write failure.
-- :parameter:`slowConnectionThresholdMillis` sets the time limit to log
-  the establishment of slow server connections. 
 
 Report an Issue
 ---------------
diff --git a/source/release-notes/6.2-compatibility.txt b/source/release-notes/6.2-compatibility.txt
@@ -0,0 +1,18 @@
+.. _6.2-compatibility:
+
+========================================================
+Compatibility Changes in MongoDB 6.2 (Release Candidate)
+========================================================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+.. include:: /includes/in-dev.rst
+
+This page describes changes introduced in MongoDB 6.2 that can affect
+compatibility with older versions of MongoDB.
diff --git a/source/release-notes/6.2.txt b/source/release-notes/6.2.txt
@@ -0,0 +1,96 @@
+.. _release-notes-6.2:
+
+=================================================
+Release Notes for MongoDB 6.2 (Release Candidate)
+=================================================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: twocols
+
+.. include:: /includes/in-dev.rst
+
+General Changes
+---------------
+
+``serverStatus`` Metrics
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Starting in MongoDB 6.2, the :dbcommand:`serverStatus` command and the
+:method:`db.serverStatus()` method have these output changes:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 50 50
+
+   * - Document
+     - Field(s)
+
+   * - New :serverstatus:`network.listenerProcessingTime` document that
+       reports the time the database listener spends allocating
+       incoming database connection requests.
+     - Field:
+
+       - :serverstatus:`network.listenerProcessingTime.durationMicros`
+
+   * - Addition to :serverstatus:`connections` document.
+     - New field that reports the number of incoming connections the
+       server has rejected.
+
+       - :serverstatus:`connections.rejected`
+
+   * - New :serverstatus:`metrics.network` document that reports
+       additional server network metrics.
+     - Fields:
+
+       - :serverstatus:`metrics.network.totalEgressConnectionEstablishmentTimeMillis`
+       - :serverstatus:`metrics.network.totalIngressTLSConnections`
+       - :serverstatus:`metrics.network.totalIngressTLSHandshakeTimeMillis`
+
+``connPoolStats`` Metrics
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Starting in MongoDB 6.2, the :dbcommand:`connPoolStats` command has
+these output changes:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 50 50
+
+   * - Document
+     - Field(s)
+
+   * - New :data:`connPoolStats.acquisitionWaitTimes` document that
+       reports the wait times for requests to acquire a connection from
+       :binary:`~bin.mongos` to :binary:`~bin.mongod`. 
+     - New fields:
+
+       - Time ranges with the number of connection requests in each
+         range.
+       - Total number of connection requests for all time ranges.
+
+Server Parameters
+-----------------
+
+Starting in MongoDB 6.2, MongoDB adds the following new parameter:
+
+- :parameter:`slowConnectionThresholdMillis` sets the time limit to log
+  the establishment of slow server connections. 
+
+Report an Issue
+---------------
+
+To report an issue, see
+https://github.com/mongodb/mongo/wiki/Submit-Bug-Reports for
+instructions on how to file a JIRA ticket for the MongoDB server or one
+of the related projects.
+
+.. toctree::
+   :titlesonly:
+   :hidden:
+
+   /release-notes/6.2-compatibility
