Waarom systemen stuk gaan

Je hebt een systeem gebouwd. Het werkt. Twee weken lang loopt alles perfect, en dan, op een doodgewone dinsdagochtend, doet het plotseling niks meer. De eerste gedachte van bijna iedereen op dat moment is: ik snap hier niks van, ik ben blijkbaar niet technisch genoeg. En precies op dat moment geven de meeste mensen op, vlak voordat ze een goede builder waren geworden. Hier is het geruststellende nieuws. Bijna elke storing in een systeem valt in een klein, voorspelbaar rijtje oorzaken. Het is geen mysterie, het is een checklist. Eén: een sleutel is verlopen of ongeldig geworden. Een wachtwoord is gewijzigd, een toegangstoken is verlopen, een account is uitgelogd.

Dat zie je in de praktijk vaak terug als een melding met de tekst "niet geautoriseerd", een duidelijk signaal dat een sleutel niet meer geldig is. Bijvoorbeeld een recruitmentflow die plotseling stopt omdat het wachtwoord van de vacaturesite is veranderd. Twee: het formaat van de data is veranderd. Een tool past de manier aan waarop hij informatie aanlevert, een veld heet plotseling anders, en je systeem verwacht nog de oude naam. Bijvoorbeeld een CRM-koppeling die breekt omdat een veld "telefoonnummer" is hernoemd naar "telefoon". Drie: een limiet is bereikt. Te veel verzoeken in een korte tijd, een maandelijks quotum dat vol is. Dat herken je vaak aan een melding met de tekst "te veel verzoeken" of "limiet bereikt". Bijvoorbeeld een contentpijplijn die vastloopt omdat er te veel berichten in een uur worden verstuurd en de tool dat blokkeert. Vier: een trigger vuurt niet meer af.

Een webhook-adres is veranderd, een formulier is aangepast zonder de koppeling bij te werken. Bijvoorbeeld een leadflow die stil blijft staan omdat het formulier vervangen is door een nieuwe versie met een andere link. Vijf: een menselijke fout in de configuratie. Een verkeerd veld gekoppeld, een voorwaarde die net iets anders is ingesteld dan bedoeld. Dit is de minst spannende, maar meest voorkomende oorzaak van allemaal. De praktische conclusie: debuggen is geen geheime vaardigheid die alleen ervaren developers hebben. Het is een checklist die je elke keer afloopt. Zijn de sleutels nog geldig, is het dataformaat nog hetzelfde, loop je tegen een limiet aan, vuurt de trigger nog af, en klopt de configuratie nog. Negen van de tien keer vind je het antwoord in precies die vijf stappen, en blijkt het probleem helemaal niet zo ingewikkeld als het voelde.