⚑ v0.4.1 β€” 213 tests passing, 6 packages

The Black Box
for Software

Record any production request across 10+ microservices.
Replay it on your laptop β€” byte-for-byte identical.
Debug in 5 minutes what used to take 5 hours.

━━━ VERIFICATION ━━━━━━━━━━━━━━━━━━━━━━━━

  βœ… PERFECT REPLAY β€” BYTE-FOR-BYTE IDENTICAL

  Original requestId:  57wbkit6
  Replayed requestId:  57wbkit6  β† EXACT MATCH

  Date.now()     β†’ 1712345678901  βœ“ deterministic
  Math.random()  β†’ 0.73421847     βœ“ deterministic
  Response body  β†’ identical       βœ“ byte-for-byte

━━━ 2 services, 98 events ━━━━━━━━━━━━━━━━━━━━

From install to replay
in 60 seconds

~/my-app β€” zsh

Your debugging tools
are stuck in 2005

Logs tell you WHAT happened. Traces tell you WHEN. But nobody tells you WHY β€” until now.

πŸ”₯

Can't Reproduce

"Works on my machine." The bug only happens in production with that exact request, that exact DB state, that exact timing. Your local env is useless.

πŸ“Š

Logs Are Noise

50,000 log lines. 10 services. 3 engineers staring at Datadog for 4 hours. You see WHAT failed, but the actual state that caused it? Gone forever.

⏱️

Traces Show Timing, Not Data

Jaeger shows you Service A called Service B in 23ms. Cool. But what was the request body? What did the DB return? Traces don't capture state.

Three lines of code.
Complete time-travel.

1

Record

Add the probe to your Express app. Every HTTP request, DB query, random value, and timer is captured at I/O boundaries β€” with <1% CPU overhead.

β†’
2

Replay

Download the recording. Run it locally. All I/O is mocked with recorded values. The app executes exactly as it did in production β€” deterministically.

β†’
3

Fix

Step through the timeline. See every DB query result, every API response, every timestamp. Find the bug in 5 minutes β€” not 5 hours.

app.ts
import { ErgenekonProbe } from '@ergenekon/probe';

const probe = new ErgenekonProbe({
  serviceName: 'checkout-service',
});

app.use(probe.middleware()); // That's it. You're recording.

The only tool that does
all four

Tool Record Replay Distributed Production-Safe
Datadog βœ“ βœ— βœ“ βœ“
Sentry βœ“ βœ— βœ“ βœ“
rr (Mozilla) βœ“ βœ“ βœ— βœ—
Replay.io βœ“ βœ“ βœ— βœ“
ERGENEKON ⚑ βœ“ βœ“ βœ“ βœ“

One pipeline.
End-to-end determinism.

From production HTTP request to byte-perfect local replay β€”
five decoupled packages, zero shared state.

npm πŸ”¬
PROBE
@ergenekon/probe
Express middleware β€” intercepts HTTP, DB, DNS, FS, timers, globals at I/O boundaries
server πŸ“¦
COLLECTOR
@ergenekon/collector
Ingest server β€” rate-limited, checksummed, durable writes to disk in NDJSON + binary
shared βš›οΈ
CORE
@ergenekon/core
HLC clock Β· ULID IDs Β· Ed25519 licenses Β· shared types β€” zero runtime deps
engine βͺ
REPLAY
@ergenekon/replay
Deterministic re-execution β€” mocks all I/O with recorded values, byte-for-byte identical
UI πŸ–₯️
DASHBOARD
@ergenekon/ui
Time-travel debugger β€” session list, timeline scrubber, service flow, diff view

πŸ”¬ Probe intercepts

  • HTTP incoming / outgoing
  • Node:fs β€” read/write/stat
  • Node:dns β€” lookup/resolve
  • Database queries (pg, mysql2)
  • Date.now() Β· Math.random()
  • setTimeout / setInterval

πŸ“¦ Collector guarantees

  • Token bucket: 100 req/min/IP
  • SHA-256 checksum per session
  • Durable write: fsync before ACK
  • NDJSON + binary .prdx format
  • HLC timestamp ordering
  • Spill buffer on disconnect

βš›οΈ Core guarantees

  • Hybrid Logical Clock (HLC)
  • ULID β€” monotonic, sortable IDs
  • Ed25519 license signing
  • Zero external dependencies
  • Strict TypeScript types
  • 213 tests, 0 flaky

βͺ Replay guarantees

  • Byte-for-byte identical output
  • All I/O mocked from recording
  • Deep diff on response body
  • Multi-service trace alignment
  • Property-based tested
  • No network in replay mode
13x
ROI β€” every $1 returns $13
<1%
CPU overhead in production
5 min
MTTR β€” down from 5 hours
213
Tests passing, zero tolerance

3 months free. Then you decide.

Full Pro access for 90 days β€” no credit card required. After trial, choose the plan that fits.

Community
$0
Forever free, open-source
  • Single service record & replay
  • 24-hour retention
  • CLI tool (11 commands)
  • Time-Travel UI
  • Community support
Get Started
Enterprise
$199
/dev/month
🎁 3 MONTHS FREE β€” NO CREDIT CARD
Full Enterprise access for 90 days Β· Then $199/dev/mo
  • Everything in Pro
  • Unlimited retention
  • SSO / SAML
  • RBAC access control
  • On-premise deployment
  • SLA 99.9%
  • Dedicated support

Stop guessing.
Start replaying.

Install the probe. Record your first request. Replay it locally. See the difference in 2 minutes.

$ npm install @ergenekon/probe @ergenekon/collector πŸ“‹

Open source under BSL-1.1 Β· View source on GitHub