DOCSP-47122-disable-logging (#381)

* init

* WIP

* first draft

* add section to re-enable logging

* edits

* review feedback and consistency

Author: jeff-allen-mongo

source/includes/list-table-shell-properties.rst

@@ -7,6 +7,11 @@
      - Default
      - Description
 
+   * - ``disableLogging``
+     - boolean
+     - ``false``
+     - Specifies whether |mdb-shell| writes log entries.
+
    * - ``displayBatchSize``
      - integer
      - 20

source/logs.txt

@@ -69,5 +69,6 @@ automatically deletes log files older than 30 days.
 .. toctree::
    :titlesonly:
 
+   Disable Logging </logs/disable>
    Specify Log Location <logs/location> 
    Write Custom Log Entries <logs/custom-entries> 

source/logs/disable.txt

@@ -0,0 +1,75 @@
+.. _mongosh-logs-disable:
+
+===============
+Disable Logging
+===============
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+To specify whether |mdb-shell| writes log messages, use the
+``disableLogging`` configuration option. Logging is enabled by default.
+
+About this Task
+---------------
+
+When you toggle logging, the change affects the current |mdb-shell|
+session. You don't need to start a new session for the change to take
+effect.
+
+Before you Begin
+----------------
+
+To check if logging is currently disabled, run the following command:
+
+.. code-block:: javascript
+
+   config.get("disableLogging")
+
+- If the command returns ``true``, logging is disabled.
+- If the command returns ``false``, logging is enabled.
+
+Steps
+-----
+
+You can set the ``disableLogging`` configuration option with the
+:ref:`configuration API <configure-settings-api>` or a
+:ref:`configuration file <configure-settings-global>`.
+
+Disable Logging with the Configuration API
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The following command uses the config API to disable logging for
+|mdb-shell|:
+
+.. io-code-block::
+   :copyable: true
+
+   .. input::
+      :language: javascript
+
+      config.set("disableLogging", true)
+
+   .. output::
+      :language: javascript
+
+      Setting "disableLogging" has been changed
+
+Disable Logging with a Configuration File
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The following configuration file disables logging for |mdb-shell|:
+
+.. code-block:: yaml
+
+   mongosh:
+     disableLogging: true
+
+Re-Enable Logging
+~~~~~~~~~~~~~~~~~
+
+To enable logging, set ``disableLogging`` to ``false``. You can perform
+this action through the config API or configuration file.