DOCS-13884 Log profiler changes

Author: jason-price-mongodb

source/includes/log-changes-to-database-profiler.rst

@@ -0,0 +1,5 @@
+Starting in MongoDB 4.2.12 (also available starting in 4.0.22), changes
+made to the :ref:`database profiler <database-profiler>` ``level``,
+``slowms``, or ``sampleRate`` using the :dbcommand:`profile` command or
+:method:`db.setProfilingLevel()` wrapper method are recorded in the
+:option:`log file <mongod --logpath>`.

source/reference/command/profile.txt

@@ -15,7 +15,7 @@ Definition
 
 .. dbcommand:: profile
 
-   .. versionchanged:: 4.0
+   .. versionchanged:: 4.2.12
 
       The command can be run on :binary:`~bin.mongos` with ``profile``
       level:
@@ -42,6 +42,8 @@ Definition
 
    .. include:: /includes/warning-profiler-performance.rst
 
+   .. include:: /includes/log-changes-to-database-profiler.rst
+
    The :dbcommand:`profile` command has the following syntax:
 
    .. code-block:: javascript

source/reference/method/db.setProfilingLevel.txt

@@ -23,15 +23,15 @@ Definition
    <set-profiling-level-options-sampleRate>`.
 
    If the :ref:`database profiler level <set-profiling-level-level>` is
-   ``1`` or ``2`` (i.e. the :doc:`database profiler
+   ``1`` or ``2`` (specifically, the :doc:`database profiler
    </tutorial/manage-the-database-profiler/>` is enabled), the
    :ref:`slowms <set-profiling-level-options-slowms>` and the
    :ref:`sampleRate <set-profiling-level-options-sampleRate>` affect
    the behavior of both the profiler and the :option:`diagnostic log
    <mongod --logpath>`.
 
    If the :ref:`database profiler level <set-profiling-level-level>` is
-   ``0`` (i.e. :doc:`database profiler
+   ``0`` (specifically, :doc:`database profiler
    </tutorial/manage-the-database-profiler/>` is disabled), the
    :ref:`slowms <set-profiling-level-options-slowms>` and the
    :ref:`sampleRate <set-profiling-level-options-sampleRate>` affect
@@ -48,6 +48,8 @@ Definition
    :method:`db.setProfilingLevel()` provides a wrapper around the
    :dbcommand:`profile` command.
 
+   .. include:: /includes/log-changes-to-database-profiler.rst
+
 Syntax
 ~~~~~~
 
@@ -83,7 +85,7 @@ Parameters
 
        .. include:: /includes/database-profiler-levels.rst
 
-       Since profiling is not available on :binary:`~bin.mongos`,
+       Because profiling is not available on :binary:`~bin.mongos`,
        :method:`db.setProfilingLevel()` cannot be used to set the profiling
        level to a value other than ``0`` on a :binary:`~bin.mongos` instance.
 
@@ -114,9 +116,9 @@ Parameters
               For :binary:`~bin.mongod` instances, the setting affects both the
               diagnostic log and, if enabled, the profiler.
 
-              For :binary:`~bin.mongos` instances, the setting affects the
-              diagnostic log only and not the profiler since profiling is not
-              available on :binary:`~bin.mongos`.
+              For :binary:`~bin.mongos` instances, the setting affects
+              the diagnostic log only and not the profiler because
+              profiling is not available on :binary:`~bin.mongos`.
 
               .. note::
                  This argument affects the same setting as the configuration
@@ -135,9 +137,9 @@ Parameters
               For :binary:`~bin.mongod` instances, the setting affects both the
               diagnostic log and, if enabled, the profiler.
 
-              For :binary:`~bin.mongos` instances, the setting affects the
-              diagnostic log only and not the profiler since profiling is not
-              available on :binary:`~bin.mongos`.
+              For :binary:`~bin.mongos` instances, the setting affects
+              the diagnostic log only and not the profiler because
+              profiling is not available on :binary:`~bin.mongos`.
 
               .. note::
                  This argument affects the same setting as the configuration option

source/tutorial/manage-the-database-profiler.txt

@@ -31,8 +31,7 @@ When enabled, profiling has an effect on database performance and
 disk use. See :ref:`Database Profiler Overhead<database-profiling-overhead>` for more information.
 
 This document outlines a number of key administration options for the
-database profiler. For additional related information, consider the
-following resources:
+database profiler. For additional related information, see:
 
 - :doc:`/reference/database-profiler`
 - :doc:`Profile Command </reference/command/profile>`
@@ -53,7 +52,7 @@ The following profiling levels are available:
 Enable and Configure Database Profiling
 ---------------------------------------
 
-You can enable database profiling for :binary:`~bin.mongod` instances .
+You can enable database profiling for :binary:`~bin.mongod` instances.
 
 This section uses the :binary:`~bin.mongo` shell helper
 :method:`db.setProfilingLevel()` helper to enable profiling. For
@@ -86,6 +85,8 @@ The ``"ok" : 1`` key-value pair indicates the operation succeeded:
 To verify the new setting, see the
 :ref:`database-profiling-view-status` section.
 
+.. include:: /includes/log-changes-to-database-profiler.rst
+
 .. _database-profiling-specify-slowms-threshold:
 
 Specify the Threshold for Slow Operations