From 83ff1475c92334bb3b4bfd20c27a3d6564affdde Mon Sep 17 00:00:00 2001 From: Rachel Mackintosh Date: Mon, 23 Mar 2026 11:57:04 -0400 Subject: [PATCH 1/6] note about adaptive rate limiting --- dbx/adaptive-rate-limiting.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 dbx/adaptive-rate-limiting.rst diff --git a/dbx/adaptive-rate-limiting.rst b/dbx/adaptive-rate-limiting.rst new file mode 100644 index 0000000..9bac1f1 --- /dev/null +++ b/dbx/adaptive-rate-limiting.rst @@ -0,0 +1,13 @@ +.. note:: + + You may find errors with ``SystemOverloadedError`` or ``RetryableError`` in + your application logs if your have not updated your |driver-name| to version + |ivm-compatible-version|. These errors indicate that the server is under + heavy load and is applying adaptive rate limiting to manage resources + effectively. To mitigate these errors, consider updating your |driver-name| + to version |ivm-compatible-version|. + + For more information, see the :atlas:`Reliability, Availability, and Workload + Management ` page or :atlas:`Overload + Errors ` page in + the Atlas documentation. \ No newline at end of file From 2bae3ecbd8ae1c6d219545815f99f91d3df9842d Mon Sep 17 00:00:00 2001 From: Rachel Mackintosh Date: Wed, 25 Mar 2026 10:05:08 -0400 Subject: [PATCH 2/6] PF and AL feedback --- dbx/adaptive-rate-limiting.rst | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/dbx/adaptive-rate-limiting.rst b/dbx/adaptive-rate-limiting.rst index 9bac1f1..e1e47fe 100644 --- a/dbx/adaptive-rate-limiting.rst +++ b/dbx/adaptive-rate-limiting.rst @@ -1,11 +1,12 @@ .. note:: - You may find errors with ``SystemOverloadedError`` or ``RetryableError`` in - your application logs if your have not updated your |driver-name| to version - |ivm-compatible-version|. These errors indicate that the server is under - heavy load and is applying adaptive rate limiting to manage resources - effectively. To mitigate these errors, consider updating your |driver-name| - to version |ivm-compatible-version|. + If you find errors with ``SystemOverloadedError`` or ``RetryableError`` + labels in your application logs, you can consider changes to your retry + settings. One option is to enable adaptive rate limiting on your server. + Adaptive rate limiting helps manage server load by dynamically adjusting + request rates based on current conditions, while also managing client-side + retry requests to mitigate errors. This feature is available on MongoDB 8.3 + and supported by the |driver-name| version |ivm-compatible-version|. For more information, see the :atlas:`Reliability, Availability, and Workload Management ` page or :atlas:`Overload From 7a77bdd86454c690cd448a79d05a132fadc06737 Mon Sep 17 00:00:00 2001 From: Rachel Mackintosh Date: Mon, 30 Mar 2026 16:28:20 -0400 Subject: [PATCH 3/6] NS feedback --- dbx/adaptive-rate-limiting.rst | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/dbx/adaptive-rate-limiting.rst b/dbx/adaptive-rate-limiting.rst index e1e47fe..15d6d4c 100644 --- a/dbx/adaptive-rate-limiting.rst +++ b/dbx/adaptive-rate-limiting.rst @@ -1,12 +1,13 @@ -.. note:: +.. note:: Adaptive Rate Limiting - If you find errors with ``SystemOverloadedError`` or ``RetryableError`` - labels in your application logs, you can consider changes to your retry - settings. One option is to enable adaptive rate limiting on your server. - Adaptive rate limiting helps manage server load by dynamically adjusting - request rates based on current conditions, while also managing client-side - retry requests to mitigate errors. This feature is available on MongoDB 8.3 - and supported by the |driver-name| version |ivm-compatible-version|. + If errors with ``SystemOverloadedError`` or ``RetryableError`` + labels are causing application failures, or appearing in your application + logs, you can consider changes to your retry settings. One option is to + enable adaptive rate limiting. Adaptive rate limiting helps + manage server load by dynamically adjusting request rates based on current + conditions, while also managing client-side retry requests to mitigate + errors. This feature is available on MongoDB 8.3 and supported by the + |driver-name| version |ivm-compatible-version|. For more information, see the :atlas:`Reliability, Availability, and Workload Management ` page or :atlas:`Overload From aaba87765a20cf75f06c599604c343f3a80b3231 Mon Sep 17 00:00:00 2001 From: Rachel Mackintosh Date: Wed, 8 Apr 2026 10:26:14 -0400 Subject: [PATCH 4/6] NS feedback --- dbx/adaptive-rate-limiting.rst | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/dbx/adaptive-rate-limiting.rst b/dbx/adaptive-rate-limiting.rst index 15d6d4c..3fd474a 100644 --- a/dbx/adaptive-rate-limiting.rst +++ b/dbx/adaptive-rate-limiting.rst @@ -1,14 +1,14 @@ .. note:: Adaptive Rate Limiting - If errors with ``SystemOverloadedError`` or ``RetryableError`` - labels are causing application failures, or appearing in your application - logs, you can consider changes to your retry settings. One option is to - enable adaptive rate limiting. Adaptive rate limiting helps - manage server load by dynamically adjusting request rates based on current - conditions, while also managing client-side retry requests to mitigate - errors. This feature is available on MongoDB 8.3 and supported by the - |driver-name| version |ivm-compatible-version|. - + If you see ``SystemOverloadedError`` or ``RetryableError`` errors in your + application logs or failures in your application, your driver may not be + upgraded to a version that supports adaptive rate limiting. We recommend + upgrading your |driver-name| to version |ivm-compatible-version| or later. + + Adaptive rate limiting helps manage server load by dynamically adjusting + request rates based on current conditions. This feature is available on + MongoDB 8.3 and later. + For more information, see the :atlas:`Reliability, Availability, and Workload Management ` page or :atlas:`Overload Errors ` page in From f1165f72d7e9f7ce9677109f07586c0b59f1dde4 Mon Sep 17 00:00:00 2001 From: Rachel Mackintosh Date: Thu, 9 Apr 2026 10:36:10 -0400 Subject: [PATCH 5/6] NS Feedback --- dbx/adaptive-rate-limiting.rst | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) diff --git a/dbx/adaptive-rate-limiting.rst b/dbx/adaptive-rate-limiting.rst index 3fd474a..18ff8f4 100644 --- a/dbx/adaptive-rate-limiting.rst +++ b/dbx/adaptive-rate-limiting.rst @@ -1,15 +1,18 @@ .. note:: Adaptive Rate Limiting - If you see ``SystemOverloadedError`` or ``RetryableError`` errors in your - application logs or failures in your application, your driver may not be - upgraded to a version that supports adaptive rate limiting. We recommend - upgrading your |driver-name| to version |ivm-compatible-version| or later. + If errors with ``SystemOverloadedError`` or ``RetryableError`` labels are causing + failures in your application or appearing in your application logs, your + driver may not be upgraded to a version that supports adaptive rate limiting. + We recommend upgrading your |driver-name| to version |ivm-compatible-version| + or later. If you continue to see these errors after upgrading, you may need + to review your Intelligent Workload Management (IWM) configuration. Adaptive rate limiting helps manage server load by dynamically adjusting request rates based on current conditions. This feature is available on MongoDB 8.3 and later. - For more information, see the :atlas:`Reliability, Availability, and Workload - Management ` page or :atlas:`Overload - Errors ` page in - the Atlas documentation. \ No newline at end of file + For more information about IWM, see the :atlas:`Reliability, Availability, + and Workload Management ` page or + :atlas:`Overload Errors + ` page in the Atlas + documentation. \ No newline at end of file From 6b592bc8b3bef511f470b931ad27c8f71dc6cc91 Mon Sep 17 00:00:00 2001 From: Rachel Mackintosh Date: Fri, 10 Apr 2026 12:11:52 -0400 Subject: [PATCH 6/6] NS Feedback --- dbx/adaptive-rate-limiting.rst | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/dbx/adaptive-rate-limiting.rst b/dbx/adaptive-rate-limiting.rst index 18ff8f4..5793c9f 100644 --- a/dbx/adaptive-rate-limiting.rst +++ b/dbx/adaptive-rate-limiting.rst @@ -4,8 +4,12 @@ failures in your application or appearing in your application logs, your driver may not be upgraded to a version that supports adaptive rate limiting. We recommend upgrading your |driver-name| to version |ivm-compatible-version| - or later. If you continue to see these errors after upgrading, you may need - to review your Intelligent Workload Management (IWM) configuration. + or later. If you continue to see these errors after upgrading, you can + address them through server-side changes, such as reviewing your + Intelligent Workload Management (IWM) configuration, or through + application-side changes, such as implementing custom error handling or + client-side request throttling. Depending on your situation, + application-side changes may be preferable or necessary. Adaptive rate limiting helps manage server load by dynamically adjusting request rates based on current conditions. This feature is available on