Docs 15705 session workflow log (#2293)

* DOCS-15705-session-workflow-log

* DOCS-15705-session-workflow-log

* DOCS-15705-session-workflow-log

* DOCS-15705-session-workflow-log

* DOCS-15705-session-workflow-log

* DOCS-15705-session-workflow-log

* DOCS-15705-session-workflow-log

* DOCS-15705-session-workflow-log

* DOCS-15705-session-workflow-log

* DOCS-15705-session-workflow-log

* DOCS-15705-session-workflow-log

* DOCS-15705-session-workflow-log

Co-authored-by: jason-price-mongodb <[email protected]>

Author: jason-price-mongodb

source/reference/command/profile.txt

@@ -81,8 +81,6 @@ The command has the following syntax:
      }
    )
 
-.. _slowms-threshold-option:
-
 Command Fields
 --------------
 
@@ -109,7 +107,9 @@ The command takes the following fields:
 
    * - ``slowms``
      - int
-     - Optional. Default: 100
+     - .. _slowms-threshold-option:
+     
+       Optional. Default: 100
 
        .. include:: /includes/dbcommand-slowms-definition.rst
 

source/reference/log-messages.txt

@@ -1586,3 +1586,78 @@ authorization cache.
       "userCacheWaitTimeMicros": 508
     },
 
+.. _log-messages-session-workflow-example:
+
+Session Workflow Log Message
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Starting in MongoDB 6.3, a message is added to the log if the time to
+send an operation response exceeds the :ref:`slowms threshold option
+<slowms-threshold-option>`.
+
+The message is known as a session workflow log message and contains
+various times to perform an operation in a database session.
+
+Example session workflow log message:
+
+.. code-block:: javascript
+   :copyable: false
+
+   {
+      "t": {
+        "$date": "2022-12-14T17:22:44.233+00:00"
+      },
+      "s": "I",
+      "c": "EXECUTOR",
+      "id": 6983000,
+      "ctx": "conn1",
+      "msg": "Slow network response send time",
+      "attr": {
+         "elapsed": {
+            "totalMillis": 109,
+            "activeMillis": 30,
+            "receiveWorkMillis": 2,
+            "processWorkMillis": 10,
+            "sendResponseMillis": 22,
+            "yieldMillis": 15,
+            "finalizeMillis": 30
+         }
+      }
+   }
+
+The times are in milliseconds.
+
+A session workflow message is added to the log if ``sendResponseMillis``
+exceeds the :ref:`slowms threshold option <slowms-threshold-option>`.
+
+.. list-table::
+   :header-rows: 1
+   :widths: 15 85
+
+   * - Field
+     - Description
+
+   * - ``totalMillis``
+     - Total time to perform the operation in the session, which
+       includes the time spent waiting for a message to be received.
+
+   * - ``activeMillis``
+     - Time between receiving a message and completing the operation
+       associated with that message. Time includes sending a response
+       and performing any clean up.
+
+   * - ``receivedWorkMillis``
+     - Time to receive the operation information over the network.
+
+   * - ``processWorkMillis``
+     - Time to process the operation and create the response.
+
+   * - ``sendResponseMillis``
+     - Time to send the response.
+
+   * - ``yieldMillis``
+     - Time between releasing the worker thread and the thread being
+       used again.
+
+   * - ``finalize``
+     - Time to end and close the session workflow.

source/release-notes/6.3.txt

@@ -65,6 +65,14 @@ these output changes:
        range.
        Total number of connection requests for all time ranges.
 
+Session Workflow Log Message
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Starting in MongoDB 6.3, a message is added to the log if the time to
+send an operation response exceeds the :ref:`slowms threshold option
+<slowms-threshold-option>`. For details, see
+:ref:`log-messages-session-workflow-example`.
+
 Server Parameters
 -----------------