engyossefyossry-crypto/n8n-sentinel-circuit-breaker-or-resilient-webhook-queue-engine — explained in plain English
Analysis updated 2026-05-18
Protect a backend API from being overwhelmed by repeated webhook retries during an outage.
Automatically redirect failed webhook requests to a dead letter queue instead of losing them.
Recover automatically from an outage using a background health check and a single test request.
Test circuit breaker behavior safely against a mock API before pointing it at a real backend.
| engyossefyossry-crypto/n8n-sentinel-circuit-breaker-or-resilient-webhook-queue-engine | 0xkinno/neuralvault | 0xlocker/d17-contracts | |
|---|---|---|---|
| Stars | 1 | 1 | 1 |
| Language | — | TypeScript | Solidity |
| Setup difficulty | moderate | hard | hard |
| Complexity | 3/5 | 4/5 | 5/5 |
| Audience | developer | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires a self-hosted or cloud n8n instance and pointing two nodes at your own backend and health check URLs.
This project is a ready made workflow for n8n, a visual automation tool where you build processes by connecting boxes on a canvas instead of writing a full program by hand. It solves a specific reliability problem: what happens when a webhook, meaning an incoming request that triggers your automation, keeps trying to reach a backend service that has gone down. Without protection, an automation like this can keep hammering a broken server over and over, making the outage worse. The workflow implements a pattern from traditional backend engineering called a circuit breaker, built entirely with native n8n nodes rather than any AI or language model components. It works in three states. In the normal, closed state, requests pass straight through to the target server as usual. If the target fails five times in a row, the circuit trips to an open state, where new requests are immediately redirected to a separate holding area called a dead letter queue instead of being sent to the already struggling server, protecting it from more load. A background check runs every two minutes while the circuit is open, and once that check succeeds, the workflow moves to a half open state where it lets exactly one test request through. If that test succeeds, the circuit fully resets to normal, if it fails, the workflow immediately trips back to the open state rather than flooding the server again. To avoid many failed requests retrying at the exact same moment and overwhelming a recovering server, the workflow calculates wait times using a growing delay that also includes some randomness, a common technique called exponential backoff with jitter. The current state and retry counts are stored using n8n's built in shared memory feature, so the circuit breaker remembers what state it is in across separate, unrelated runs of the workflow rather than starting fresh each time. Setting it up means importing a single workflow.json file into an existing n8n installation, then pointing two nodes at your own backend, one for the main API you are calling and one for a health check endpoint used by the background recovery test. The README also walks through a manual test plan using a free mock API service so you can watch the circuit breaker open, redirect traffic, and recover without needing a real backend to fail on purpose. The project is released under the MIT license.
An n8n workflow that implements a three state circuit breaker to protect a backend from a failing webhook target using retry backoff, a dead letter queue, and automatic recovery checks.
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.