Seminar Ory Stack Betrieb, Observability und Troubleshooting

Dieses Seminar behandelt Betrieb, Observability und Troubleshooting über Hydra, Kratos, Keto und Oathkeeper hinweg. Der Schwerpunkt liegt auf systematischer Diagnose statt auf Bauchgefühl.

Inhaltsverzeichnis

• Zielsetzung und Einordnung
• Zielgruppe
• Voraussetzungen
• Seminarziele
• Seminarinhalte mit Schritt-für-Schritt-Anleitungen
• Praktische Übungen
• Praxisbezug im Projektalltag

Zielsetzung und Einordnung

Betriebsteams lernen, Fehlerbilder zwischen Identität, OAuth2, Berechtigung und API-Schutz zu unterscheiden. Daraus entstehen Runbooks und Prüfverfahren für stabile Plattformen.

Zielgruppe

Architekten, Entwickler, Administratoren, DevOps Engineers, Plattformteams und Security-Verantwortliche in IAM- und API-Projekten.

Voraussetzungen

Grundkenntnisse in Webarchitekturen, Linux, Containerbetrieb, HTTP, JSON, TLS und API-Sicherheit; Erfahrung mit Identity- oder Plattformprojekten ist hilfreich.

Seminarziele

• Health Checks und Betriebsmetriken je Komponente einordnen.
• Logs entlang kompletter Request-Flows auswerten.
• Fehlerursachen zwischen Client, Proxy, Identity, Token und Permission Server trennen.
• Runbooks für Standardstörungen erstellen.
• Release- und Konfigurationsänderungen betrieblich absichern.

Seminarinhalte mit Schritt-für-Schritt-Anleitungen

1. Observability-Grundlagen

Zuerst wird festgelegt, welche Signale pro Komponente wirklich relevant sind.

1. Schritt 1: Health Checks je Dienst erfassen.
2. Schritt 2: Logkategorien für Flow-, API- und Betriebsfehler bestimmen.
3. Schritt 3: Metriken für Latenz, Fehlerrate und Verfügbarkeit festlegen.
4. Schritt 4: Korrelation über Request-IDs und Zeitfenster planen.

2. Flow-orientierte Diagnose

Fehler werden entlang des tatsächlichen Benutzer- oder API-Flusses verfolgt.

1. Schritt 1: Login- und Session-Fehler in Kratos isolieren.
2. Schritt 2: OAuth2-Fehler in Hydra isolieren.
3. Schritt 3: Permission-Check-Fehler in Keto isolieren.
4. Schritt 4: Access-Rule-Fehler in Oathkeeper isolieren.

3. Runbooks und Eskalation

Standardprobleme erhalten feste Verfahren, damit nicht jedes Ticket bei Adam und Eva beginnt.

1. Schritt 1: Häufige Fehlerbilder sammeln.
2. Schritt 2: Prüfschritte je Fehlerbild definieren.
3. Schritt 3: Zuständigkeiten zwischen Entwicklung, Betrieb und Security festlegen.
4. Schritt 4: Eskalationsdaten und Mindestinformationen dokumentieren.

4. Release- und Änderungsprüfung

Konfigurationsänderungen werden vor und nach dem Rollout geprüft.

1. Schritt 1: Änderungstypen nach Komponente klassifizieren.
2. Schritt 2: Vorabtests und Smoke Tests definieren.
3. Schritt 3: Rollback-Signale und Abbruchkriterien festlegen.
4. Schritt 4: Nachkontrolle und Dokumentation durchführen.

Praktische Übungen

• Fehlerhaften Login-Flow analysieren.
• OAuth2-Client-Fehler lokalisieren.
• Permission Check mit falschem Tuple debuggen.
• Oathkeeper Rule-Mismatch finden.
• Runbook für kombinierte Störung erstellen.

Praxisbezug im Projektalltag

Das Seminar richtet sich an Teams, die den Ory Stack nicht nur installieren, sondern dauerhaft betreiben müssen. Alte Administratorenregel: Was nicht geprüft wird, fällt am Freitagabend aus.