Kolofon · 17 października 2026
0.14.11 — przed falą
gdy autor zapytał, czy strona przeżyje pierwszą stronę Hacker News — i okazało się, że serwer tak, ale limit planu nie

Tekst: Kolofon
Na planie Workers Free statyka jest poza limitem, ale każda strona HTML i każdy beacon telemetrii to wywołanie workera — sto tysięcy na dobę. Pierwsza strona Hacker News to dziesiątki tysięcy odwiedzających, po kilka wywołań każdy. Serwer by wytrzymał; licznik nie.
Cache brzegowy (edgeCache: { seconds: 300 }): odpowiedź HTML na żądanie GET bez ciasteczek ląduje w pamięci brzegowej Cloudflare (Cache API, osobno w każdej kolokacji) i przez TTL idzie stamtąd — worker nie budzi się wcale. Czytelnik zalogowany ma ciasteczko, więc omija cache i dostaje swój nagłówek konta. Do przeglądarki dalej idzie no-store; cache trzyma tylko kopię z s-maxage. Nagłówek x-edge-cache mówi HIT albo MISS. Nowy wpis jest widoczny najpóźniej po TTL. Roboty bez JavaScriptu są liczone także z trafień.
Próbkowanie telemetrii (telemetry.sample, 0–1): przy fali ruchu do dziennika trafia tylko część wizyt — i albo cała wizyta, albo nic, bo interesuje nas, co człowiek robi, gdy wejdzie, a nie urywki. O tym, czy wizyta jest w próbie, decyduje serwer przy pierwszym zdarzeniu strony: skrót z adresu, przeglądarki i soli dnia wobec progu. Skrót liczy się w locie i nie jest nigdzie zapisywany; w przeglądarce nic nie zostaje (przepisy o zapisie na urządzeniu nie obejmują znacznika dla naszej statystyki — 0.14.11 i 0.14.12 trzymały go w przeglądarce, 0.14.13 to zdejmuje). Serwer odpowiada nagłówkiem x-sample; wizyta poza próbą kosztuje jedno wywołanie na stronę. 0 wyłącza telemetrię, 1 to wszyscy. Liczby w /log trzeba wtedy czytać jako próbę.
Przełącznik bez wdrożenia: silnik czyta wiersz telemetry_sample z tabeli settings własnej bazy D1 (raz na minutę na izolat) i wstawia wynik do HTML jako <meta name="k-telemetry">. Pulpit autora może go ustawić dla każdej instancji z osobna — w dniu fali zbić próbkę do 10 %, nazajutrz wrócić do 100 % — bez dotykania kodu. Baza wygrywa z konfiguracją.
