Das Symptom genau beschreiben
„Die Website funktioniert nicht“ ist ein Ausgangspunkt, aber noch keine brauchbare Diagnose. Beschreiben Sie die betroffene Aktion: Eine Seite lädt nicht, die Anmeldung scheitert, eine Suche bleibt leer oder eine Übertragung wird nicht abgeschlossen. Notieren Sie Zeitpunkt, Hostname und einen reproduzierbaren Ablauf. Prüfen Sie, ob der Fehler bei verschiedenen Nutzern oder nur in einer bestimmten Situation auftritt. Ein Screenshot kann helfen, ersetzt jedoch die Beschreibung der Schritte nicht.
Trennen Sie Beobachtung und Vermutung. „Seit dem Update erscheint beim Speichern dieser Fehler“ ist eine Beobachtung. „Das Update ist die Ursache“ ist zunächst eine Vermutung. Die Unterscheidung hält die Untersuchung offen. Im Beispiel eines Shops auf Managed Server Business könnte eine fehlende Antwort sowohl lokale Verarbeitung als auch eine externe Schnittstelle betreffen. Eine gezielte Prüfung des Datenwegs hilft bei der Eingrenzung.
Einen kleinen Zeitstrahl aufbauen
Erfassen Sie den letzten bekannten erfolgreichen Vorgang, den ersten beobachteten Fehler und relevante Änderungen dazwischen. Dazu können Anwendungsupdates, neue Inhalte, Konfigurationsänderungen, DNS-Eingriffe oder externe Ausfälle gehören. Verwenden Sie eine erkennbare Zeitbasis. Verschiedene Systeme können andere Zeitzonen nutzen oder Ereignisse verzögert schreiben. Ohne diese Einordnung erscheinen zusammengehörige Meldungen möglicherweise weit voneinander entfernt.
| Eintrag | Was dokumentiert wird |
|---|---|
| Funktion | Genau betroffene Aktion |
| Zeitpunkt | Datum, Uhrzeit und Zeitbasis |
| Beobachtung | Fehlertext oder sichtbares Verhalten |
| Änderung | Tatsächlich durchgeführter Eingriff |
| Ergebnis | Was die anschließende Prüfung gezeigt hat |
Dieser Zeitstrahl muss keine große technische Dokumentation werden. Eine kurze fortlaufende Notiz kann genügen, wenn beteiligte Personen denselben Stand verwenden. Bei längeren Untersuchungen sollte eine Person die Notizen koordinieren.
Die passende Protokollart auswählen
Ein Zugriffsprotokoll zeigt andere Informationen als ein Anwendungsfehlerprotokoll. Ein geplanter Import kann ein eigenes Protokoll führen, während die externe Schnittstelle eine getrennte Rückmeldung liefert. Beginnen Sie mit der Komponente, die an der betroffenen Aktion beteiligt ist. Sammeln Sie einen passenden Zeitraum statt ungezielt alle verfügbaren Dateien weiterzugeben. Eine geeignete Vorgangsreferenz kann helfen, Ereignisse über mehrere Systeme hinweg zu verbinden.
Für WordPress beschreibt die offizielle Debugging-Dokumentation Möglichkeiten zur Fehleraufzeichnung. Solche Funktionen müssen passend zur Umgebung eingestellt werden. Fehlerdetails sollen auf einer öffentlichen Website nicht versehentlich sichtbar werden. Eine Diagnoseeinstellung braucht außerdem einen geplanten Rückweg nach Abschluss der Untersuchung. Wer sie aktiviert, dokumentiert Umfang und Zweck und kontrolliert anschließend, ob der normale Betriebszustand wiederhergestellt wurde. Der Ratgeber Deploy und Rollback unterstützt diesen Ablauf.
Protokolle als geschützte Daten behandeln
Protokolle können technische Geheimnisse, persönliche Angaben oder sensible Vorgangsdetails enthalten. Die OWASP-Empfehlungen zur Protokollierung behandeln deshalb unter anderem den Schutz und die geeignete Auswahl von Logdaten. Prüfen Sie vor einer Weitergabe, was der Empfänger für die Diagnose tatsächlich benötigt. Zugangstoken oder vollständige persönliche Inhalte sollten nicht unnötig in einer Meldung landen.
Auch die Ablage ist wichtig. Ein Diagnoseexport gehört nicht in ein öffentliches Websiteverzeichnis. Nutzen Sie einen geeigneten geschützten Austausch und begrenzen Sie die Zugriffsrechte. Die spätere Bereinigung muss ebenfalls nachvollziehbar sein. Entfernen Sie im Notfall jedoch nicht vorschnell alle Spuren, die für die Untersuchung gebraucht werden. Ein abgestimmter Umgang verbindet Betriebsbedarf mit den geltenden Anforderungen. Die konkrete Aufbewahrung ist anhand des eigenen Systems und der benötigten Zwecke zu klären; dieser Artikel nennt keine allgemeingültige rechtliche Frist.
Eine Vermutung nach der anderen prüfen
Formulieren Sie eine konkrete Hypothese und den dazu passenden Prüfschritt. Beispielsweise könnte nur eine bestimmte Funktion nach einer Änderung betroffen sein. Prüfen Sie zuerst, ob die Beobachtung zur Vermutung passt. Wenn mehrere Einstellungen gleichzeitig verändert werden, bleibt unklar, welche Änderung geholfen hat. Eine kontrollierte Untersuchung sollte deshalb Eingriff und Ergebnis verbinden. Auf dem produktiven System braucht sie einen abgestimmten Umfang.
Nach einer vorläufigen Lösung ist eine erneute fachliche Prüfung nötig. Der Fehlertext kann verschwunden sein, obwohl der Vorgang weiterhin unvollständig bleibt. Halten Sie fest, welche Funktion erfolgreich getestet wurde und was offen ist. Wiederkehrende Erkenntnisse können in das Notfallhandbuch übernommen werden. Der Wert der Diagnose liegt in einer belegten Eingrenzung und einem verständlichen Rückweg. Ein größerer Tarif oder eine pauschale Neuinstallation sollte keine unbelegte Standardantwort auf jedes Fehlerbild sein.
Beispiel: eine hilfreiche Meldung formulieren
Eine nützliche Meldung könnte erklären, dass eine bestimmte Aktion seit einer dokumentierten Uhrzeit fehlschlägt, während öffentliche Seiten weiterhin erreichbar sind. Sie nennt die Schritte zur Wiederholung, einen passenden Fehlertext und die letzte bekannte Änderung. Sie behauptet keine Ursache, solange diese nicht geprüft wurde. Persönliche Details werden auf das für die Diagnose nötige Maß begrenzt.
Ergänzen Sie, welche Prüfungen bereits erfolgt sind und welche Ergebnisse sie geliefert haben. Dadurch kann die nächste beteiligte Person die Untersuchung fortsetzen, ohne jeden Schritt erneut auszuführen. Nach einer Lösung wird dieselbe Aktion nochmals kontrolliert und das Ergebnis dem Vorgang zugeordnet.
Quellen und Prüfstand
- WordPress: Debugging — geprüft 2026-10-07
- OWASP: Logging Cheat Sheet — geprüft 2026-10-07
Produktinformationen können sich ändern. Beispielarchitekturen sind redaktionelle Modelle. Unsere Methode und Grenzen