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

    XMLWordPrintableJSON

Details

    • Icon: Bug Bug
    • Resolution: Done
    • Icon: Minor - P4 Minor - P4
    • 3.2.0-rc0
    • None
    • Documentation
    • None

    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

        Activity

          People

            sam.rossi@mongodb.com Samuel Rossi (Inactive)
            david.golden@mongodb.com David Golden
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: