circuit_breaker

El circuit breaker detecta cuando un servicio/agente está fallando repetidamente y corta el flujo de peticiones temporalmente, evitando la cascada de fallos y permitiendo recuperación.

When to use

Envolver todas las llamadas a servicios externos, modelos ML y otros agentes con un circuit breaker.

Instructions

1. Instalar: pip install pybreaker tenacity.
2. Con pybreaker:

```python import pybreaker facematchbreaker = pybreaker.CircuitBreaker(failmax=5, resettimeout=60)

@facematchbreaker def callfacematchservice(embedding1, embedding2): return facematchclient.compare(embedding1, embedding_2) ```

1. Estados: CLOSED (normal) → OPEN (fallo, rechaza peticiones) → HALF_OPEN (prueba recuperación).
2. Configurar failmax=5 (5 fallos consecutivos → OPEN) y resettimeout=60 (60s antes de HALF_OPEN).
3. En OPEN: devolver respuesta de fallback o error con código específico SERVICE_UNAVAILABLE.
4. Emitir métrica a Prometheus cuando el breaker cambia de estado.

Notes

• tenacity complementa el circuit breaker con retry + backoff exponencial para errores transitorios.
• Cada agente debe tener su propio circuit breaker con parámetros ajustados a su SLO.