Skip to main content
TealCircuit implements the circuit breaker pattern to prevent cascading failures in distributed systems.

Overview

TealCircuit provides:
  • Three-state circuit breaker (CLOSED, OPEN, HALF_OPEN)
  • Automatic failure detection and recovery
  • Decision contract for consistency
  • Correlation IDs for traceability

Class

Configuration

Creating a Circuit

Basic Configuration

With State Change Callback

Executing Operations

Basic Execution

With Retry Logic

Evaluating Circuit State

Check State Before Operation

Monitor Circuit State

Circuit States

CLOSED State

OPEN State

HALF_OPEN State

Manual Control

Reset Circuit

Force Open

Force Close

Integration with TealAudit

Error Handling

Async/Await Support

Performance

TealCircuit targets:
  • < 1ms overhead per operation (p99)
  • < 0.5ms for evaluate() (p99)
  • Thread-safe for concurrent operations

Best Practices

Use Appropriate Thresholds

Provide Fallback Responses

Monitor Circuit Health

Type Hints