stream-pressure-lab / index.html
DataDrivenAlex's picture
Add Stream Pressure Lab simulator
aceb68f verified
Raw History Blame Contribute Delete
15.3 kB
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="description" content="An interactive systems lab for reasoning about streaming throughput, queue growth, backpressure and overload policies.">
<title>Stream Pressure Lab — Backpressure & Queueing Simulator</title>
<style>
:root{--bg:#09111d;--panel:#111d2d;--panel2:#0d1827;--line:#26384f;--muted:#9aabc1;--text:#edf4ff;--cyan:#55d9d2;--blue:#76a9ff;--orange:#ffb66e;--red:#ff7b83;--green:#7de0a3;--shadow:0 20px 60px #02081388}*{box-sizing:border-box}body{margin:0;background:radial-gradient(ellipse at 15% 0%,#14263c 0,transparent 38%),linear-gradient(145deg,#09111d,#0b1421 60%,#0a1220);color:var(--text);font:15px/1.5 Inter,ui-sans-serif,system-ui,-apple-system,Segoe UI,sans-serif;min-height:100vh}button,input,select{font:inherit;color:inherit}main{max-width:1220px;margin:auto;padding:36px 26px 56px}.top{display:flex;justify-content:space-between;align-items:center;gap:18px;margin-bottom:28px}.brand{display:flex;align-items:center;gap:11px;color:#bdd0e9;font-weight:700;letter-spacing:.12em;font-size:11px}.mark{width:30px;height:30px;border:1px solid #4b6a87;border-radius:10px;display:grid;place-items:center;color:var(--cyan);font-size:18px;background:#102337}.tag{border:1px solid #34465d;border-radius:99px;color:#b7c7dc;padding:5px 10px;font-size:11px;letter-spacing:.08em;text-transform:uppercase}.hero{display:grid;grid-template-columns:1.15fr .85fr;gap:30px;align-items:end;margin-bottom:28px}.eyebrow{color:var(--cyan);font-size:12px;font-weight:700;letter-spacing:.17em;text-transform:uppercase}h1{font-size:clamp(36px,5.2vw,62px);line-height:1.02;letter-spacing:-.045em;margin:12px 0 14px;max-width:690px}.lead{color:#b5c4d8;max-width:670px;font-size:17px;margin:0}.hero-note{border-left:2px solid var(--cyan);padding:12px 16px;color:#afc0d5;background:linear-gradient(90deg,#132538aa,transparent);font-size:13px}.layout{display:grid;grid-template-columns:350px 1fr;gap:18px;align-items:start}.panel{background:linear-gradient(160deg,#122034ee,#0e1928f2);border:1px solid var(--line);border-radius:18px;box-shadow:var(--shadow)}.controls{padding:22px;position:sticky;top:14px}.panel-head{font-size:12px;letter-spacing:.14em;text-transform:uppercase;color:#a8bad1;font-weight:700;margin-bottom:18px}.field{margin:19px 0}.field label{display:flex;justify-content:space-between;gap:12px;color:#d8e3f2;font-size:13px;margin-bottom:8px}.value{font-variant-numeric:tabular-nums;color:var(--cyan);font-weight:700}.help{font-size:11px;color:var(--muted);margin-top:5px}.range{width:100%;accent-color:var(--cyan)}select{width:100%;padding:10px 12px;border:1px solid #354962;border-radius:10px;background:#0a1625}.presets{display:flex;flex-wrap:wrap;gap:7px;margin:15px 0 19px}.preset{border:1px solid #354962;background:#132136;color:#c3d3e7;border-radius:9px;padding:7px 9px;font-size:11px;cursor:pointer}.preset:hover,.preset.active{border-color:var(--cyan);color:var(--cyan);background:#112b36}.run{width:100%;border:0;border-radius:11px;background:linear-gradient(100deg,#45cec6,#6bb7ff);color:#071521;font-weight:800;padding:13px;cursor:pointer;box-shadow:0 8px 24px #47cfc333}.run:hover{filter:brightness(1.08);transform:translateY(-1px)}.reset{width:100%;margin-top:8px;border:1px solid #354962;border-radius:10px;background:transparent;color:#c1d0e2;padding:10px;cursor:pointer}.stage{display:grid;gap:16px}.metrics{display:grid;grid-template-columns:repeat(4,1fr);gap:12px}.metric{padding:17px 18px;min-height:110px}.metric .k{color:#a6b8cd;font-size:11px;letter-spacing:.09em;text-transform:uppercase}.metric .v{font-size:28px;font-weight:750;letter-spacing:-.03em;margin-top:5px;font-variant-numeric:tabular-nums}.metric .sub{font-size:11px;color:#9aabc1}.accent{color:var(--cyan)}.warn{color:var(--orange)}.bad{color:var(--red)}.good{color:var(--green)}.chart{padding:17px 19px 14px}.charttitle{display:flex;justify-content:space-between;align-items:center;gap:10px;margin-bottom:8px}.charttitle strong{font-size:14px}.charttitle span{font-size:11px;color:var(--muted)}canvas{width:100%;height:230px;display:block}.legend{display:flex;gap:15px;flex-wrap:wrap;color:#afbed0;font-size:11px;padding:4px 4px 1px}.dot{display:inline-block;width:8px;height:8px;border-radius:99px;margin-right:5px}.lower{display:grid;grid-template-columns:1.15fr .85fr;gap:16px}.insight,.events{padding:18px 19px}.insight h2,.events h2{font-size:13px;letter-spacing:.12em;text-transform:uppercase;color:#b4c4d9;margin:0 0 12px}.insight p{color:#c1cede;margin:0 0 11px;font-size:13px}.insight p:last-child{margin:0}.insight b{color:var(--text)}.eventlist{display:grid;gap:8px;max-height:240px;overflow:auto}.event{display:grid;grid-template-columns:52px 12px 1fr;gap:7px;align-items:start;font-size:11px;color:#b5c4d6}.time{color:#8297b0;font-variant-numeric:tabular-nums}.event i{width:8px;height:8px;border-radius:50%;background:var(--cyan);margin-top:4px}.event.drop i{background:var(--red)}.event.back i{background:var(--orange)}.event p{margin:0}.foot{margin-top:18px;color:#8294aa;font-size:11px;display:flex;justify-content:space-between;gap:12px;flex-wrap:wrap}.foot b{color:#adbed2}.sr{position:absolute;left:-9999px} @media(max-width:950px){.layout{grid-template-columns:1fr}.controls{position:static}.hero{grid-template-columns:1fr}.hero-note{max-width:660px}}@media(max-width:650px){main{padding:22px 14px 38px}.metrics{grid-template-columns:repeat(2,1fr)}.lower{grid-template-columns:1fr}.metric{min-height:95px}.metric .v{font-size:24px}.top{margin-bottom:22px}}
</style>
</head>
<body><main>
<header class="top"><div class="brand"><div class="mark">∿</div> SYSTEMS ENGINEERING LAB</div><div class="tag">Deterministic model · no services</div></header>
<section class="hero"><div><div class="eyebrow">Streaming systems · interactive simulator</div><h1>Stream Pressure Lab</h1><p class="lead">Explore how arrival rate, service capacity and buffer limits shape queue growth, latency and loss under overload.</p></div><aside class="hero-note"><b>One useful question:</b> when incoming work outruns consumers, should the system queue, slow producers, or shed load? Tune the model and inspect the trade-offs.</aside></section>
<div class="layout"><aside class="panel controls"><div class="panel-head">01 / Configure the stream</div><div class="presets"><button class="preset active" data-preset="steady">Steady state</button><button class="preset" data-preset="burst">Traffic burst</button><button class="preset" data-preset="overload">Sustained overload</button></div>
<div class="field"><label for="arrival">Incoming events <span class="value"><span id="arrivalV">70</span> /s</span></label><input class="range" id="arrival" type="range" min="10" max="200" value="70"><div class="help">Average producer rate (events per second)</div></div>
<div class="field"><label for="service">Consumer capacity <span class="value"><span id="serviceV">90</span> /s</span></label><input class="range" id="service" type="range" min="10" max="200" value="90"><div class="help">Aggregate processing rate across workers</div></div>
<div class="field"><label for="buffer">Buffer capacity <span class="value"><span id="bufferV">120</span> events</span></label><input class="range" id="buffer" type="range" min="20" max="500" step="10" value="120"><div class="help">Maximum queued events before the selected policy applies</div></div>
<div class="field"><label for="policy">Overload policy</label><select id="policy"><option value="queue">Bounded queue · reject overflow</option><option value="backpressure">Backpressure · throttle producer</option><option value="shed">Load shedding · drop excess</option></select><div class="help">Illustrative policy behavior, not a broker implementation</div></div>
<button id="run" class="run">Run 60-second simulation</button><button id="reset" class="reset">Reset to steady state</button></aside>
<div class="stage"><section class="metrics"><article class="panel metric"><div class="k">Processed</div><div class="v accent" id="processed">4,200</div><div class="sub">events in 60 s</div></article><article class="panel metric"><div class="k">Dropped</div><div class="v good" id="dropped">0</div><div class="sub">rejected or shed events</div></article><article class="panel metric"><div class="k">Peak queue</div><div class="v" id="peak">0</div><div class="sub">events waiting</div></article><article class="panel metric"><div class="k">Estimated p95 wait</div><div class="v" id="latency">0 ms</div><div class="sub">queue ÷ service rate</div></article></section>
<section class="panel chart"><div class="charttitle"><strong>Queue depth over time</strong><span id="chartState">Steady state · 60 seconds</span></div><canvas id="chart" aria-label="Queue depth simulation chart" role="img"></canvas><div class="legend"><span><i class="dot" style="background:#55d9d2"></i>queue depth</span><span><i class="dot" style="background:#ff7b83"></i>buffer capacity</span></div></section>
<div class="lower"><section class="panel insight"><h2>02 / Read the result</h2><div id="insights"><p><b>Capacity headroom:</b> consumers can process 20 more events/s than producers send.</p><p><b>Expected outcome:</b> queue stays near zero and all generated work is processed.</p><p><b>Design note:</b> average rates hide bursts. Test bursty arrivals and recovery time before choosing a buffer.</p></div></section><section class="panel events"><h2>03 / Simulation trace</h2><div class="eventlist" id="eventlist"></div></section></div>
</div></div>
<footer class="foot"><span><b>Model:</b> 1-second discrete steps; deterministic rates; 60-second window.</span><span>Teaching aid · synthetic events · no network calls or real workloads</span></footer>
</main>
<script>
(()=>{'use strict';
const $=id=>document.getElementById(id),arrival=$('arrival'),service=$('service'),buffer=$('buffer'),policy=$('policy'),canvas=$('chart');
let result=null;
function fmt(n){return Math.round(n).toLocaleString('en-US')}
function sim(a,s,b,p){let q=0,peak=0,processed=0,dropped=0,accepted=0,series=[0],trace=[];for(let t=0;t<60;t++){let incoming=a;if(p==='backpressure')incoming=Math.min(a,Math.max(0,Math.min(b*.85-q+s,b-q)));let offered=incoming;let space=Math.max(0,b-q);let admitted=Math.min(offered,space);let lost=offered-admitted;q+=admitted;let done=Math.min(q,s);q-=done;processed+=done;accepted+=admitted;dropped+=lost;peak=Math.max(peak,q);series.push(q);if((t+1)%10===0)trace.push({t:t+1,q,processed,dropped,mode:p});}let p95=peak===0?0:Math.round((peak/s)*1000);return{a,s,b,p,processed,dropped,accepted,peak,p95,series,trace}}
function draw(){if(!result)return;let dpr=window.devicePixelRatio||1,rect=canvas.getBoundingClientRect();canvas.width=rect.width*dpr;canvas.height=rect.height*dpr;let c=canvas.getContext('2d');c.scale(dpr,dpr);let w=rect.width,h=rect.height,pad={l:40,r:12,t:12,b:26},cw=w-pad.l-pad.r,ch=h-pad.t-pad.b;c.clearRect(0,0,w,h);c.font='10px system-ui';c.fillStyle='#8396ad';c.strokeStyle='#26384f';c.lineWidth=1;for(let i=0;i<=4;i++){let y=pad.t+ch*i/4;c.beginPath();c.moveTo(pad.l,y);c.lineTo(w-pad.r,y);c.stroke();let val=Math.round(result.b*(1-i/4));c.fillText(String(val),3,y+3)}for(let i=0;i<=6;i++){let x=pad.l+cw*i/6;c.fillText(String(i*10)+'s',x-8,h-5)}let max=Math.max(result.b,...result.series,1);let limitY=pad.t+ch*(1-result.b/max);c.strokeStyle='#ff7b83';c.setLineDash([5,5]);c.beginPath();c.moveTo(pad.l,limitY);c.lineTo(w-pad.r,limitY);c.stroke();c.setLineDash([]);let grad=c.createLinearGradient(0,pad.t,0,h-pad.b);grad.addColorStop(0,'#55d9d255');grad.addColorStop(1,'#55d9d200');c.beginPath();result.series.forEach((v,i)=>{let x=pad.l+cw*i/60,y=pad.t+ch*(1-v/max);i?c.lineTo(x,y):c.moveTo(x,y)});c.lineTo(pad.l+cw,pad.t+ch);c.lineTo(pad.l,pad.t+ch);c.closePath();c.fillStyle=grad;c.fill();c.beginPath();result.series.forEach((v,i)=>{let x=pad.l+cw*i/60,y=pad.t+ch*(1-v/max);i?c.lineTo(x,y):c.moveTo(x,y)});c.strokeStyle='#55d9d2';c.lineWidth=2.5;c.stroke()}
function policyName(p){return p==='queue'?'Bounded queue':p==='backpressure'?'Backpressure':'Load shedding'}
function update(){ $('arrivalV').textContent=arrival.value;$('serviceV').textContent=service.value;$('bufferV').textContent=buffer.value;if(result)runSim(false)}
function runSim(animate=true){let a=+arrival.value,s=+service.value,b=+buffer.value,p=policy.value;result=sim(a,s,b,p);$('processed').textContent=fmt(result.processed);$('dropped').textContent=fmt(result.dropped);$('peak').textContent=fmt(result.peak);$('latency').textContent=result.p95+' ms';$('dropped').className='v '+(result.dropped?'bad':'good');$('peak').className='v '+(result.peak>=b*.8?'warn':'');$('chartState').textContent=policyName(p)+' · '+a+' in/s · '+s+' out/s';let headroom=s-a,parts=[];if(p==='backpressure'){parts.push(`<p><b>Producer throttling:</b> admissions are capped to keep backlog at or below an 85% buffer target while consumers drain. Dropped events: ${fmt(result.dropped)}.</p>`);parts.push(`<p><b>Trade-off:</b> backpressure protects the queue, but only works if upstream producers can slow down or retry safely.</p>`)}else if(result.dropped){parts.push(`<p><b>Overload:</b> offered rate exceeds service capacity by ${fmt(Math.max(0,a-s))} events/s; the finite buffer fills, then ${fmt(result.dropped)} events are rejected or shed.</p>`);parts.push(`<p><b>Trade-off:</b> bounded queues cap memory, but callers need an explicit retry, dead-letter or degradation strategy.</p>`)}else if(headroom>=0){parts.push(`<p><b>Capacity headroom:</b> consumers can process ${fmt(headroom)} more events/s than producers send.</p>`);parts.push(`<p><b>Expected outcome:</b> queue stays near zero and all generated work is processed.</p>`)}else{parts.push(`<p><b>Queue growth:</b> the average workload exceeds service capacity by ${fmt(-headroom)} events/s; the buffer delays overflow, it does not remove overload.</p>`);parts.push(`<p><b>Recovery:</b> once arrivals fall below capacity, drain time is backlog ÷ (service rate − arrival rate). This run keeps rates constant.</p>`)}parts.push(`<p><b>Model boundary:</b> single aggregate queue, fixed 1-second steps, no variance or network. Real systems need measurements, partitioning and failure handling.</p>`);$('insights').innerHTML=parts.join('');$('eventlist').innerHTML=result.trace.map(x=>`<div class="event ${x.dropped?'drop':''}"><span class="time">T+${String(x.t).padStart(2,'0')}s</span><i></i><p>queue ${fmt(x.q)} · processed ${fmt(x.processed)} · dropped ${fmt(x.dropped)}</p></div>`).join('');draw()}
function preset(name){let vals=name==='steady'?[70,90,120,'queue']:name==='burst'?[160,100,240,'queue']:[150,75,120,'shed'];[arrival.value,service.value,buffer.value,policy.value]=vals;$$('.preset').forEach(x=>x.classList.toggle('active',x.dataset.preset===name));update()}
function $$(s){return document.querySelectorAll(s)}
[arrival,service,buffer,policy].forEach(x=>x.addEventListener('input',update));$$('.preset').forEach(x=>x.addEventListener('click',()=>preset(x.dataset.preset)));$('run').addEventListener('click',()=>runSim(true));$('reset').addEventListener('click',()=>preset('steady'));window.addEventListener('resize',draw);runSim(false)
})();
</script></body></html>