Zum Inhalt springen
TypFreigeschaltetPhaseQuick WinSchwierigkeitEinfachAufgabeService überwachenFürDev TeamsFürDevOps & InfraServicesPipeWarum HoodyHTTP-nativWarum HoodyMultiplayer von Haus aus
TypFreigeschaltetPhaseQuick WinSchwierigkeitEinfachAufgabeService überwachenFürDev TeamsFürDevOps & InfraServicesPipeWarum HoodyHTTP-nativWarum HoodyMultiplayer von Haus aus
TypFreigeschaltetPhaseQuick WinSchwierigkeitEinfachAufgabeService überwachenFürDev TeamsFürDevOps & InfraServicesPipeWarum HoodyHTTP-nativWarum HoodyMultiplayer von Haus aus
TypFreigeschaltetPhaseQuick WinSchwierigkeitEinfachAufgabeService überwachenFürDev TeamsFürDevOps & InfraServicesPipeWarum HoodyHTTP-nativWarum HoodyMultiplayer von Haus aus
Zurück zu Use Cases
use-cases / a-progress-bar-your-boss-can-spectate / hero
PIPE · ?PROGRESS · SSE

Ein Fortschrittsbalken, dem dein Chef zusehen kann, ohne mitzumachen

Du fährst eine achtstündige Migration. Fünf Leute wollen einen Status, ohne einen Receiver-Slot zu belegen oder den Stream zu unterbrechen. Hänge ?progress an die Pipe-URL. Wer sie öffnet, bekommt ein Live-HTML-Dashboard — übertragene Bytes, aktuelle Geschwindigkeit, ETA, Statusübergänge. Die Migration läuft mit voller Geschwindigkeit, egal wie viele zuschauen.

Pipe-Progress-Docs lesen
use-cases / a-progress-bar-your-boss-can-spectate / mechanism

Wie der Chef zusieht, ohne den Stream zu berühren

?progress ist ein Side-Channel-Read. Er belegt nie einen Receiver-Slot, erzeugt nie Backpressure, berührt nie die Bytes. Die Migration läuft mit voller Bandbreite, egal wie viele zuschauen.

SPECTATOR TIMELINEZERO RECEIVER-SLOTS
T+0 min
CHEF ÖFFNET URL

Sie pastet die Pipe-URL mit ?progress in ihren Phone-Browser. Das HTML-Dashboard erscheint sofort — state: waiting, 0% — keine Installation, kein Login, kein Receiver-Slot verbraucht.

T+22 min
STREAM IST LIVE

SSE schickt ein state: streaming Event. Der Fortschrittsbalken springt auf 22%, Bytes ticken auf, MB/s stabilisiert sich bei 118. Das Dashboard aktualisiert sich alle 250 ms ohne ein einziges Seitenladung.

T+4 h
CHEF GEHT INS BETT

Sie schließt den Tab. Ihre Spectator-Verbindung fällt weg. Die Migration merkt das nicht — sie war nie im Datenpfad. Sender und ihr one real Receiver machen weiter.

T+8 h
WACHT AUF ZUM 100%

Sie öffnet die URL wieder beim Sonnenaufgang. Das Dashboard zeigt ein done Event: 7,6 GB transferiert, 8h 2m, keine Fehler. Serverseitiger State überlebt die Aktualisierung — Spätzünder sehen immer die Final Line.

T+8h 4m
SENDET DAS ACK

Sie leitet die URL an den Team Slack weiter. Drei Engineers öffnen sie und sehen den gleichen done State. Kein Status-Thread zum Schließen, kein Grafana-Panel zum Demarkieren. Eine URL, fünf Zeugen, null Interruptions.

spectate.sh
# 1. Sender — eight-hour migration. Same as always.
tar czf - /var/lib/postgres | curl -T - "$PIPE/api/v1/pipe/migration"

# 2. Receiver — the only client that matters for backpressure.
curl "$PIPE/api/v1/pipe/migration" | tar xzf - -C /restore

# 3. Boss opens the URL on her phone. HTML dashboard. No setup.
# => https://pipe.hoody.com/api/v1/pipe/migration?progress

# 4. You want SSE for a Slack bot? Same URL, different Accept.
curl -N -H "Accept: text/event-stream" \
  "$PIPE/api/v1/pipe/migration?progress" \
  | grep -E '^event: (progress|state|done)'
# event: state    \n data: '{'"state":"streaming","receivers":1'}'
# event: progress \n data: '{'"bytes":5046464512,"mbps":118,"etaSec":840'}'
# event: done     \n data: '{'"bytes":8160000000,"durationSec":28800'}'

Drei SSE-Event-Typen. state für Übergänge (idle → waiting → streaming → complete), progress alle 250 ms während Bytes fließen (bytesTransferred, Speed, ETA), done einmal am Ende mit den finalen Stats. Bis zu fünfzig Spectators pro Pfad, jeder mit einem Fünf-Minuten-Verbindungs-Fenster.

use-cases / a-progress-bar-your-boss-can-spectate / audience

Jede Stakeholder, eine Read-Only-URL

?progress ist ein Side-Channel. Chef, Kolleg*in, externe Kund*in, On-Call — alle öffnen die gleiche URL. Keiner von ihnen berührt den Transfer. Alle sehen den gleichen Live-State.

use-cases / a-progress-bar-your-boss-can-spectate / punchline

Der Migration zuzuschauen ist eine eigene URL. Die Migration merkt nichts.

0 RECEIVER-SLOTS BELEGTBIS ZU 50 ZUSCHAUER PRO PFAD
MIGRATION1 Sender, 1 Receiver, volle Bandbreite
ZUSCHAUER12 Chef-Augen am Dashboard, 0 Backpressure
  • kein Slack-Channel zu babysitten
  • kein Grafana-Dashboard zu verkabeln
  • kein Progress-Endpoint zu schreiben
use-cases / a-progress-bar-your-boss-can-spectate / replaces

Was das ersetzt

Jedes Team hat eine Methode, 'wie weit sind wir?' zu beantworten. Die meisten dieser Methoden kosten einen Service, der laufen muss, ein Dashboard, das verkabelt werden muss, oder einen Chat-Channel, den jemand babysitten muss. Ein Query-Parameter auf der Pipe-URL kostet nichts davon.

  • Slack-#migrations-Channel-UpdatesEin Mensch tippt alle fünf Minuten Prozentsätze
  • Grafana-DashboardsEin Exporter, ein Prometheus-Scrape, ein Panel zu pflegen
  • Eigene Progress-EndpointsEigene Route, eigenes Schema, eigener Retention-Bug
  • Tmux-Share über SSHBastion-Zugang nur, um eine Zahl hochticken zu sehen
  • Datadog-Metric-PanelsPer-Host-Agent und Per-Metric-Pricing für einen Transfer
  • 'Sind wir schon da?'-PingsFünf Teammitglieder fragen dieselbe Frage in verschiedenen Threads
use-cases / a-progress-bar-your-boss-can-spectate / cta

Schick die URL. Hör auf, Updates zu schicken.

Pipe-API-Guide lesen
use-cases / a-progress-bar-your-boss-can-spectate / related

Lies die anderen