Uploaded image for project: 'C++ Driver'
  1. C++ Driver
  2. CXX-994

Fix missing or misleading docs about pools, thread/fork safety and background monitoring

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Minor - P4
    • Resolution: Fixed
    • Affects Version/s: None
    • Fix Version/s: 3.2.0-rc0
    • Component/s: Documentation
    • Labels:
      None
    • Story Points:
      1
    • Sprint:
      Perl/CXX 2017-03-24, Perl/CXX 2017-05-05

      Description

      Pool docs imply that single clients have a background monitoring thread, but this is incorrect.

      More generally, thread safety and monitoring behaviors are not prominently documented:

      • mongocxx::client – not thread-safe and uses the single-threaded monitoring algorithm (stop the world every 60 seconds to scan)
      • mongocxx::pool – thread-safe and uses a background thread per server to monitor every 10 seconds

      We should also document Server Discovery and Monitoring and Server Selection options configurable via the URI. See mongoc_uri_t docs for an example.

        Attachments

          Issue Links

            Activity

              People

              • Votes:
                0 Vote for this issue
                Watchers:
                4 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: