Self-hosted-Fehlerdiagnose und Störungsbehebung

Self-hosted-Fehlerdiagnose und Incident-Response

Self-hosted bedeutet mehr Kontrolle und auch mehr Verantwortung. Diese Seite ist ein schneller operativer Leitfaden: Was tun, wenn etwas schief geht, und wie wiederholte Fehler reduziert werden.

Zweck und Voraussetzungen

• Zweck: Betrieb stabilisieren, Ursache ermitteln, Zustand wiederherstellen und Audit-Trace erhalten.
• Voraussetzungen: Zugriff auf die Self-Hosted-Instanz, Admin-/Workspace-Owner-Rechte, Zugriff auf Laufhistorie.
• Tools: Runbook, frühere Logs, aktuelles Template, Zielzustand.

Schritt-für-Schritt bei Incident

1. Sofortmaßnahmen: keine weiteren Änderungen, Scope einschränken, Rollback-Möglichkeit prüfen.
2. Fakten sammeln: Run-ID, Workspace, Zielserver, Änderungsart, letzter stabiler Zustand.
3. Preflight und Logs prüfen: Ergebnisse des Preflights und Log-Stream analysieren.
4. Auswirkung bewerten: Verfügbarkeit prüfen und Sicherheitswirkung einschätzen.
5. Abhilfemaßnahme: Konfiguration anpassen, Run wiederholen oder Rollback nach Leitfaden.
6. Kommunikation: Team informieren und Run-Kommentar ergänzen.
7. Prävention: Checkliste ergänzen und Checks stärken.

Kontroll-Checkliste

• Ist die richtige Run-ID und das korrekte Ziel eindeutig identifiziert?
• Stehen Preflight- und Laufzeitlogs vor und nach dem Fehler zur Verfügung?
• Wurden Template-Abhängigkeiten und Variablen validiert?
• Wurden Workspace-Berechtigungen überprüft (wer darf das ausführen)?
• Handelt es sich um ein Einzelfallproblem oder eine Wiederholung?

Häufige Fehler

• Wiederholung ohne Beseitigung der Ursache.
• Retry bei fehlenden Dependencies oder falschem Ziel.
• Unvollständige Incident-Dokumentation.
• Fehlende Team-Kommunikation während der Wiederherstellung.

Nächste Schritte

• Erstes Deployment und Produktions-Checkliste vor einem erneuten Lauf.
• Runbook und Governance als verbindliche Referenz für riskante Änderungen.
• Vorlagen und Workflow zur Verbesserung von Guardrails.
• Workspaces und Zugriff, wenn Rollen angepasst werden müssen.

Cross-track-Links

Wenn Sie in den managed Modus wechseln möchten, lesen Sie den Migrationspfad oder vergleichen Sie managed vs self-hosted.

Nächster Schritt: Weiter zu erstem Deployment oder zum Runbook für den täglichen Betrieb.