Alle Insights

Die Meldung beschreibt den Melder

Falscher API-Key, nicht verbunden, keine Mail verschickt. Drei Meldungen in diesem Monat, drei wahre Aussagen über das Falsche.

Am Abend des 25. September fiel ein großer Coding-Assistent für knapp eine Stunde aus. Web, API, Kommandozeile und Editor-Plugin antworteten alle mit demselben Fehler: 401, falscher API-Key. Über achthundert Leute haben das gemeldet. Der Key war in Ordnung. Die Authentifizierung beim Anbieter war es nicht. Jeder dieser Nutzer hat eine Meldung gelesen, die nach der eigenen Konfiguration klang und in Wahrheit den Zustand des Anbieters beschrieb. Mir ist derselbe Fehler in diesem Monat zweimal in meiner eigenen Arbeit passiert, und eine meiner eigenen Warnungen hat ihn jeden Morgen für mich gemacht.

Jede Meldung hat einen Autor

Eine Fehlermeldung wird von einem bestimmten Stück Software geschrieben, aus dessen Sicht, mit den Informationen, die es in dem Moment hatte. „Falscher API-Key" heißt: Die Komponente, die Keys prüft, hat diesen nicht akzeptiert. Sie weiß nicht, ob der Key falsch ist oder ob sie selbst kaputt ist. Sie wählt die häufigste Erklärung und formuliert sie als Tatsache.

Für einen Menschen, der mit etwas Misstrauen liest, ist das in Ordnung. Für eine Automation ist es gefährlich. Ein Watchdog, der bei einem 401 die Zugangsdaten rotiert oder jemanden alarmiert, er möge seinen Key reparieren, hätte diese Stunde damit verbracht, alles schlimmer zu machen: neue Keys ausgestellt, alte widerrufen, eine Konfigurationsänderung, die man zurückdrehen muss, sobald der Anbieter wieder läuft. Die Lösung lag einen Schritt früher. Erst die Statusseite des Anbieters prüfen, dann die eigene Seite anfassen.

Bevor du auf eine Meldung reagierst, benenne die Schicht, die sie geschrieben hat.

„Nicht verbunden" meinte das Plugin

Der zweite Fall war meiner. Auf einer Kunden-Website meldete das Dashboard des SEO-Plugins, die Search Console sei nicht verbunden, kein Token. Ich habe das gelesen, in einem Planungsdokument und später noch einmal in einem Gespräch, als: Diese Seite hat keine Search Console. Einen Teil eines Fahrplans habe ich darauf gebaut.

Als ich die Search Console schließlich direkt geöffnet habe, gab es die Property seit Jahren. Verifizierung auf Domain-Ebene, eine längst eingereichte Sitemap, die Analytics-Property verknüpft. Zwei Inhaber waren schon eingetragen, ich einer davon. Was das Plugin gemeldet hatte, stimmte: Das Plugin selbst hatte kein Token. Darüber, ob das System existiert, an das es sich anbindet, sagte es nichts. Und in der echten Console lag ein Beta-Bericht zu KI-Funktionen in der Suche mit drei Monaten Daten, der einen Teil der Lücke schloss, für die der Fahrplan hatte bezahlen wollen.

Teuer war nicht das erste Fehllesen. Teuer war, dass es aufgeschrieben worden war, und beim zweiten Mal habe ich meine eigene Notiz gelesen statt der Quelle.

Eine Warnung, die ihren Endpunkt beschrieb

Der dritte Fall war eine Warnung, die ich selbst gebaut hatte. Eine tägliche Prüfung sollte Kontakte finden, die sich angemeldet, aber die erste Mail einer Strecke nicht bekommen hatten. Jeden Morgen meldete sie alle. Alle neun, jeden Tag.

Den Kontakten ging es gut. Der Listen-Endpunkt, den die Prüfung nutzte, liefert Mitglieder ohne ihre Tags aus, also sah jeder Kontakt ungetaggt aus, also sah jeder Kontakt so aus, als hätte er die Mail verpasst. Die Warnung war eine genaue Beschreibung dessen, was dieser Endpunkt zurückgibt. Ich habe sie so umgebaut, dass sie die Quelle direkt fragt: Steht dieser Kontakt auf der Liste der Kontakte mit dem Tag, das die erste Mail als verschickt markiert. Seitdem ist sie still, und still bedeutet jetzt etwas.

Das führende System fragen

Die Regel, die ich daraus ziehe, ist kurz.

  • Für jede Meldung, die eine Aktion auslöst, aufschreiben, welche Komponente sie erzeugt und was diese Komponente tatsächlich sehen kann.
  • Vor dem Handeln einmal das führende System fragen. Die Statusseite, die Console selbst, ein direkter Abruf des einen Kontakts. Meist ist das eine einzige Anfrage.
  • Automatische Reaktionen auf Fehler brauchen eine zweite, unabhängige Quelle, bevor sie etwas Unumkehrbares tun. Ein 401 plus grüne Statusseite ist ein Key-Problem. Ein 401 plus rote Statusseite heißt warten.
  • Wenn ein Befund in eine Notiz oder einen Plan wandert, dazuschreiben, wo er gelesen wurde. „Plugin meldet nicht verbunden" und „Search Console hat keine Property" sind zwei verschiedene Befunde und sollten auf dem Papier auch verschieden aussehen.
Kern

Eine Meldung ist ein Beleg über ihren Autor. Das System, über das sie spricht, muss man getrennt fragen.

Hung Mai

Hung Mai ist selbstständiger Berater in Weilmünster (Hessen) und arbeitet meist remote. Er plant, baut und überwacht KI-Automatisierung für Marketing und Vertrieb, für Firmen ohne Digitalteam. Mehr über Hung Mai

Lass uns etwas Echtes aufbauen.

KontaktAntwort innerhalb von 24h.