explaingit

engyossefyossry-crypto/n8n-sentinel-circuit-breaker-or-resilient-webhook-queue-engine

Analysis updated 2026-05-18

1Audience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

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.

Mindmap

mindmap
  root((n8n-sentinel-circuit-breaker))
    What it does
      Three state circuit breaker
      Dead letter queueing
      Automatic recovery
    Tech stack
      n8n
      JavaScript
      Webhooks
    Use cases
      Protect backend from outages
      Backoff with jitter retries
      Mock API testing
    Audience
      n8n automation builders
      Backend developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Protect a backend API from being overwhelmed by repeated webhook retries during an outage.

USE CASE 2

Automatically redirect failed webhook requests to a dead letter queue instead of losing them.

USE CASE 3

Recover automatically from an outage using a background health check and a single test request.

USE CASE 4

Test circuit breaker behavior safely against a mock API before pointing it at a real backend.

What is it built with?

n8nJavaScriptWebhooks

How does it compare?

engyossefyossry-crypto/n8n-sentinel-circuit-breaker-or-resilient-webhook-queue-engine0xkinno/neuralvault0xlocker/d17-contracts
Stars111
LanguageTypeScriptSolidity
Setup difficultymoderatehardhard
Complexity3/54/55/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a self-hosted or cloud n8n instance and pointing two nodes at your own backend and health check URLs.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

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.

Copy-paste prompts

Prompt 1
Help me import this workflow.json file into my n8n instance and connect it to a webhook trigger.
Prompt 2
Explain how the exponential backoff with jitter calculation works in the JS node of this workflow.
Prompt 3
Walk me through testing the OPEN and HALF_OPEN states using httpstat.us as a mock API target.
Prompt 4
Show me how to point the Heartbeat Ping node at my own service's health check endpoint.
Prompt 5
Help me understand how $getWorkflowStaticData is used to persist circuit state across runs.

Frequently asked questions

What is n8n-sentinel-circuit-breaker-or-resilient-webhook-queue-engine?

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.

What license does n8n-sentinel-circuit-breaker-or-resilient-webhook-queue-engine use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is n8n-sentinel-circuit-breaker-or-resilient-webhook-queue-engine to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is n8n-sentinel-circuit-breaker-or-resilient-webhook-queue-engine for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.