Dashbox

Kapitel 7

Det skriver bara ner det som ändrades

Ett kort läses många gånger om dagen. Nästan ingen av de avläsningarna är en nyhet.

Avläsningar mot händelser i exempelmånadenTvå banor över 30 dagar. Den övre banan, avläsningar, är en tät kam av streck: omkring 2 880 avläsningar. Den undre banan, händelser, har sju markeringar: dag 14 och 17, två dag 21, och dag 22, 23 och 24.avläsningar: omkring 2 880händelser: 7dag 1dag 15dag 30
Den övre banan är varje avläsning, alldeles för många för att rita en och en. Den undre banan är det historiken behåller: sju lägesändringar.

Avläsningar kommer ofta - en API-collector hämtar var 15:e minut som standard. Om varje låg avläsning skrev en rad skulle historiken bli brus, och ingen skulle läsa den.

Därför skriver Dashbox en händelse bara när kortets läge ändras: det blev lågt, blev kritiskt eller blev normalt igen; det blev inaktuellt (dess collector har inte hört av sig på mer än dubbla intervallet), fick ett fel från sin källa eller fick data igen; det nådde sitt mål.

Ett kort som är kritiskt i tre dagar har en händelse den dag det blev kritiskt, och en till när det kommer tillbaka. Händelserna bedöms med samma regler som färgen, så historiken säger aldrig emot det kortet visade.

Ändringar i hur talet läses - namn, enhet, riktning, visning eller trigger - sparas i samma historik. Ett steg som kommer av en ny definition tas inte för en förändring i världen.

I exempelmånaden

Ett exempel, inte verkliga data.

Dag 21
API:et svarar en gång med ett fel: en händelse "fel" med källans meddelande, sedan "data igen" vid nästa lyckade hämtning.
Månaden
Omkring 2 880 avläsningar (var 15:e minut i 30 dagar) och sju händelser: mål nått dag 14 och 17, fel och data igen dag 21, blev lågt dag 22, blev kritiskt dag 23, normalt igen dag 24. Måländringen dag 28 finns i samma historik.