From fdcc3fbe8b96567ba7e2d2ee22caa6e6a3e50214 Mon Sep 17 00:00:00 2001
From: Mahdi Azarboon <21277296+azarboon@users.noreply.github.com>
Date: Wed, 9 Oct 2024 13:24:59 +0800
Subject: [PATCH] Update circuitbreaker.md

---
 docs/src/main/paradox/common/circuitbreaker.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/src/main/paradox/common/circuitbreaker.md b/docs/src/main/paradox/common/circuitbreaker.md
index ccca962ab89..65a9994a43a 100644
--- a/docs/src/main/paradox/common/circuitbreaker.md
+++ b/docs/src/main/paradox/common/circuitbreaker.md
@@ -61,6 +61,10 @@ The Apache Pekko library provides an implementation of a circuit breaker called
 
 ![circuit-breaker-states.png](../images/circuit-breaker-states.png)
 
+## Challenges
+
+Circuit breakers can misinterpret a partial failure as total system failure and inadvertently bring down the entire system. In particular, sharded systems and cell-based architectures are vulnerable to this issue. A workaround is that the server indicates to the client which specific part is overloaded and the client uses a corresponding mini circuit breaker. However, this workaround can be complex and expensive.
+
 ## Examples
 
 ### Initialization