index updates

rachel-mack · rachel-mack · commit d2763fb7a63b · 2025-03-18T09:57:41.000-04:00
diff --git a/snooty.toml b/snooty.toml
@@ -14,6 +14,7 @@ toc_landing_pages = [
     "/builders",
     "/data-formats",
     "/references",
+    "/logging-monitoring",
     "/api-documentation",
     "/security",
     "/security/auth"
diff --git a/source/connection/specify-connection-options.txt b/source/connection/specify-connection-options.txt
@@ -9,11 +9,12 @@ Specify Connection Options
    Stable API </connection/specify-connection-options/stable-api>
    Connection Pools </connection/specify-connection-options/connection-pools>
    Cluster Settings </connection/specify-connection-options/cluster-settings>
+   Server Settings </connection/specify-connection-options/server-settings>
+   Socket Settings </connection/specify-connection-options/socket-settings>
    Configure Client-level CRUD Settings </connection/specify-connection-options/configure-crud>
    Network Compression </connection/specify-connection-options/network-compression>
    JNDI Datasource </connection/specify-connection-options/jndi>
-   AWS Lambda <https://www.mongodb.com/docs/atlas/manage-connections-aws-lambda/>
-   Connection Security Settings </connection/specify-connection-options/security-connection-options>
+   AWS Lambda <https://www.mongodb.com/docs/atlas/manage-connections-aws-lambda/
 
 .. facet::
    :name: genre
@@ -27,4 +28,22 @@ Overview
 
 This section describes the MongoDB connection and authentication options
 available in the {+driver-short+}. You can specify connection options in the
-following ways: 
+following ways: 
+
+Security and Authentication
+---------------------------
+
+MongoDB supports many options for securing your data before and during
+transportation. For information about security options, see the :ref:`Security
+section <java-security>`, which includes the following:
+
+.. include:: /includes/security/security-pages.rst
+
+Logging and Monitoring
+----------------------
+
+You can learn how to using logging and monitoring with the {+driver-short+} in
+the :ref:`Logging and Monitoring section <java-logging-monitoring>`, which
+includes the following:
+
+.. include:: /includes/security/logging-monitoring-pages.rst
diff --git a/source/connection/specify-connection-options/cluster-settings.txt b/source/connection/specify-connection-options/cluster-settings.txt
@@ -37,45 +37,45 @@ String` or :guilabel:`MongoClientSettings` tab to see the options available:
 
     .. list-table:: 
        :header-rows: 1 
-       :widths: 20,20,60
+       :widths: 25,20,60
 
        * - Option Name
          - Type
          - Description
         
-       * - **serverSelectionTimeoutMS**
+       * - ``serverSelectionTimeoutMS``
          - integer
          - Specifies the maximum amount of time, in milliseconds, the driver
            will wait for server selection to succeed before throwing an
            exception. 
             
-           **Default**: ``30000`` (30 seconds)
+           *Default*: ``30000`` (30 seconds)
         
-       * - **localThresholdMS**
+       * - ``localThresholdMS``
          - integer
          - When communicating with multiple instances of MongoDB in a replica
            set, the driver will only send requests to a server whose response
            time is less than or equal to the server with the fastest response
            time plus the local threshold, in milliseconds.  
             
-           **Default**: ``15``
-       * - **replicaSet**
+           *Default*: ``15``
+       * - ``replicaSet``
          - string
          - Specifies that the :ref:`connection string <connection-uri>`
            provided includes multiple hosts. When specified, the driver
            attempts to find all members of that set. 
             
-           **Default**: ``null``
+           *Default*: ``null``
         
-       * - **directConnection**
+       * - ``directConnection``
          - boolean
          - Specifies that the driver must connect to the host directly. This
            maps to applying ``mode(ClusterConnectionMode.SINGLE)`` to your
            ``MongoClientSettings``. 
             
-           **Default**: ``false``
+           *Default*: ``false``
         
-       * - **srvServiceName**
+       * - ``srvServiceName``
          - string
          - Specifies the service name of the `SRV resource records
            <https://www.rfc-editor.org/rfc/rfc2782>`__ the driver retrieves to
@@ -85,7 +85,7 @@ String` or :guilabel:`MongoClientSettings` tab to see the options available:
            </reference/connection-string/#dns-seed-list-connection-format>` in
            your :ref:`connection URI <connection-uri>` to use this option.  
             
-           **Default**: ``mongodb``
+           *Default*: ``mongodb``
     
     This example connects the driver directly to a server,
     regardless of the type of MongoDB cluster it's a part of:
@@ -132,9 +132,9 @@ String` or :guilabel:`MongoClientSettings` tab to see the options available:
 
        * - ``localThreshold()``
          - Sets the amount of time that a server’s round trip can take and
-              still be eligible for server selection.
+           still be eligible for server selection.
            
-           **Default**: ``15 milliseconds``
+           *Default*: ``15 milliseconds``
 
        * - ``mode()``
          - Sets how to connect to a MongoDB deployment.
@@ -149,7 +149,7 @@ String` or :guilabel:`MongoClientSettings` tab to see the options available:
          - Sets the maximum time to select a primary node before throwing a
            timeout exception.  
            
-           **Default**: ``30 seconds``
+           *Default*: ``30 seconds``
 
        * - ``serverSelector()``
          - Adds a server selector to apply before server selection.
@@ -170,8 +170,8 @@ String` or :guilabel:`MongoClientSettings` tab to see the options available:
 
        * - ``srvMaxHosts()``
          - Sets the maximum number of hosts the driver can connect to when
-              using the DNS seedlist (SRV) connection protocol, identified by
-              the ``mongodb+srv`` connection string prefix.  
+           using the DNS seedlist (SRV) connection protocol, identified by
+           the ``mongodb+srv`` connection string prefix.  
            
            Throws an exception if you are not using the SRV connection protocol.
 
@@ -187,10 +187,12 @@ String` or :guilabel:`MongoClientSettings` tab to see the options available:
 
     .. tip::
 
-        This is analogous to the ``directConnection`` parameter you can specify
-        in your connection URI. See :ref:`<connection-options>` for more
-        information.
+       This is analogous to the ``directConnection`` parameter you can specify
+       in your connection URI. See :ref:`<connection-options>` for more
+       information.
 
-    For more information, see the `MongoClientSettings.Builder
+    For more information about the chained methods, see the `MongoClientSettings.Builder
     <{+api+}/apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.Builder.html>`__
-    API documentation.
+    API documentation.
+          
+          
diff --git a/source/connection/specify-connection-options/configure-crud.txt b/source/connection/specify-connection-options/configure-crud.txt
@@ -44,54 +44,54 @@ string <connection-uri>` or by passing a ``MongoClientSettings`` object to the
     
     .. list-table:: 
        :header-rows: 1 
-       :widths: 20,20,60
+       :widths: 25,20,60
 
        * - Option Name
          - Type
          - Description
 
-       * - **journal**
+       * - ``journal``
          - boolean
          - Specifies that the driver must wait for the connected MongoDB instance to group commit to the journal file on disk for all writes.  
           
-           **Default**: ``false``
+           *Default*: ``false``
 
-       * - **w**
+       * - ``w``
          - string or integer
          - Specifies the write concern. For more information about values, see
            the server documentation for the :manual:`w option
            </reference/write-concern/#w-option>`. 
 
-           **Default**: ``1``
+           *Default*: ``1``
 
-       * - **wtimeoutMS**
+       * - ``wtimeoutMS``
          - integer
          - Specifies a time limit, in milliseconds, for the write concern. For
            more information, see the server documentation for the
            :manual:`wtimeoutMS option
            </reference/connection-string/#write-concern-options>`. A value of
            ``0`` instructs the driver to never time out write operations.
 
-           **Default**: ``0``
+           *Default*: ``0``
 
-       * - **readPreference**
+       * - ``readPreference``
          - string
          - Specifies the read preference. For more information about values, see
            the server documentation for the :manual:`readPreference option
            </reference/connection-string/#urioption.readPreference>`.  
           
-           **Default**: ``primary``
+           *Default*: ``primary``
 
-       * - **readPreferenceTags**
+       * - ``readPreferenceTags``
          - string
          - Specifies the read preference tags. For more information about
            values, see the server documentation for the
            :manual:`readPreferenceTags option
            </reference/connection-string/#urioption.readPreferenceTags>`.  
           
-           **Default**: ``null``
+           *Default*: ``null``
 
-       * - **maxStalenessSeconds**
+       * - ``maxStalenessSeconds``
          - integer
          - Specifies, in seconds, how stale a secondary can be before the driver
            stops communicating with that secondary. The minimum value is either
@@ -102,30 +102,30 @@ string <connection-uri>` or by passing a ``MongoClientSettings`` object to the
            providing a parameter or explicitly specifying ``-1`` indicates that
            there must be no staleness check for secondaries. 
           
-           **Default**: ``-1``
+           *Default*: ``-1``
 
-       * - **uuidRepresentation**
+       * - ``uuidRepresentation``
          - string
          - Specifies the UUID representation to use for read and write
            operations. For more information, see the driver documentation for
            the `MongoClientSettings.getUuidRepresentation() method
            <{+api+}/apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.html#getUuidRepresentation()>`__.  
           
-           **Default**: ``unspecified``
+           *Default*: ``unspecified``
 
-       * - **retryWrites**
+       * - ``retryWrites``
          - boolean
          - Specifies that the driver must retry supported write operations if
            they are unable to complete due to a network error.  
           
-           **Default**: ``true``
+           *Default*: ``true``
 
-       * - **retryReads**
+       * - ``retryReads``
          - boolean
          - Specifies that the driver must retry supported read operations if
            they are unable to complete due to a network error.  
           
-           **Default**: ``true``
+           *Default*: ``true``
 
     The following example sets the read preference to read from the nearest
     replica set member:
@@ -145,7 +145,6 @@ string <connection-uri>` or by passing a ``MongoClientSettings`` object to the
     Chain the following methods to your ``MongoClientSettings``  constructor to modify the driver's read/write behavior:
 
     .. list-table::
-       :header-rows: 1
        :stub-columns: 1
        :widths: 40 60
 
@@ -157,19 +156,19 @@ string <connection-uri>` or by passing a ``MongoClientSettings`` object to the
        * - ``readPreference()``
          - Sets the :manual:`read preference </reference/read-preference/>`
            
-           **Default**: ``primary``
+           *Default*: ``primary``
 
        * - ``retryReads()``
          - Whether the driver performs :manual:`retry reads
            </core/retryable-reads/>` if a network error occurs. 
            
-           **Default**: ``true``
+           *Default*: ``true``
 
        * - ``retryWrites()``
          - Whether the driver performs :manual:`retry writes
            </core/retryable-writes/>` if a network error occurs.  
           
-           **Default**: ``true``
+           *Default*: ``true``
 
        * - ``uuidRepresentation()``
          - Sets the UUID representation to use when encoding instances of UUID
@@ -178,7 +177,7 @@ string <connection-uri>` or by passing a ``MongoClientSettings`` object to the
        * - ``writeConcern()``
          - Sets the :manual:`write concern </reference/write-concern/>`. 
            
-           **Default**: ``WriteConcern#ACKNOWLEDGED``. 
+           *Default*: ``WriteConcern#ACKNOWLEDGED``. 
            | For more information about the default value, see :manual:`Implicit Default Write Concern </reference/write-concern/#implicit-default-write-concern>`.  
 
     The following example sets the read preference to read from the nearest
diff --git a/source/connection/specify-connection-options/network-compression.txt b/source/connection/specify-connection-options/network-compression.txt
@@ -68,30 +68,30 @@ tab to see the corresponding syntax:
 
     .. list-table:: 
        :header-rows: 1 
-       :widths: 20,20,60
+       :widths: 25,20,60
 
        * - Option Name
          - Type
          - Description
 
-       * - **compressors**
+       * - ``compressors``
          - string
          - Specifies one or more compression algorithms that the driver will
            attempt to use to compress requests sent to the connected MongoDB
            instance. Possible values include: ``zlib``, ``snappy``, and
            ``zstd``. 
             
-           **Default**: ``null``
+           *Default*: ``null``
 
-       * - **zlibCompressionLevel**
+       * - ``zlibCompressionLevel``
          - integer
          - Specifies the degree of compression that `Zlib <https://zlib.net/>`__
            uses to decrease the size of requests to the connected MongoDB
            instance. The level can range from ``-1`` to ``9``, with lower values
            compressing faster (but resulting in larger requests) and larger
            values compressing slower (but resulting in smaller requests). 
             
-           **Default**: ``null``
+           *Default*: ``null``
    
     The following specifies the order in which the driver will attempt to
     compress requests before they are sent:
@@ -125,7 +125,9 @@ tab to see the corresponding syntax:
        :end-before: end-specify-client-settings
        :language: java
 
-    For more information, see the `MongoClientSettings.Builder <{+api+}/apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.Builder.html>`__ API documentation.
+    For more information about the chained methods, see the `MongoClientSettings.Builder
+    <{+api+}/apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.Builder.html>`__
+    API documentation.
 
 .. _java-compression-dependencies:
 
diff --git a/source/connection/specify-connection-options/server-settings.txt b/source/connection/specify-connection-options/server-settings.txt
@@ -33,7 +33,7 @@ Configuring Server Settings
 
     .. list-table:: 
        :header-rows: 1 
-       :widths: 20,20,60
+       :widths: 25,20,60
 
        * - Option Name
          - Type
@@ -119,12 +119,14 @@ Configuring Server Settings
     - The cluster monitor to attempt reaching a server every ``15 SECONDS``
 
     .. literalinclude:: /includes/fundamentals/code-snippets/MCSettings.java
-      :start-after: begin ServerSettings
-      :end-before: end ServerSettings
-      :language: java
-      :emphasize-lines: 3-5
-      :dedent:
+       :start-after: begin ServerSettings
+       :end-before: end ServerSettings
+       :language: java
+       :emphasize-lines: 3-5
+       :dedent:
     
-    For more information, see the `MongoClientSettings.Builder
+    For more information about the chained methods, see the `MongoClientSettings.Builder
     <{+api+}/apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.Builder.html>`__
     API documentation.
+          
+          
diff --git a/source/connection/specify-connection-options/socket-settings.txt b/source/connection/specify-connection-options/socket-settings.txt
diff --git a/source/includes/connect/logging-monitoring-pages.rst b/source/includes/connect/logging-monitoring-pages.rst
diff --git a/source/logging-monitoring.txt b/source/logging-monitoring.txt
