49 lines
1.9 KiB
Markdown
49 lines
1.9 KiB
Markdown
---
|
||
title: On‑Call Cheat Sheet
|
||
sidebar_label: On‑Call Spickzettel
|
||
---
|
||
|
||
Dieser Spickzettel ist für On‑Call‑Personen gedacht, die im Incident schnell handeln müssen. Er konzentriert sich bewusst auf die wichtigsten Kommandos, Dashboards und Checks.
|
||
|
||
## 1. Top‑10 Kommandos
|
||
|
||
- App‑Container Logs (Laravel / Horizon):
|
||
- `docker compose logs -f app`
|
||
- `docker compose logs -f horizon`
|
||
- Queue‑Status:
|
||
- `php artisan queue:failed`
|
||
- `php artisan horizon:status`
|
||
- Storage‑Health:
|
||
- `php artisan storage:monitor`
|
||
- `php artisan storage:check-upload-queues`
|
||
- Datenbank‑Checks (Beispiele):
|
||
- `php artisan tinker` → gezielte Queries zu `events`, `event_media_assets`, `checkout_sessions`.
|
||
|
||
## 2. Erstdiagnose bei „Nichts geht mehr“
|
||
|
||
- Statusseite / Monitoring prüfen (HTTP‑Status, Fehler‑Rate, Queue‑Länge).
|
||
- `docker compose ps` → welche Services sind „unhealthy“ oder down?
|
||
- Logs der auffälligen Services anschauen (App, Queue, DB, Nginx).
|
||
- Kurz festhalten:
|
||
- Wann trat das Problem auf?
|
||
- Betrifft es **alle** Tenants oder einzelne?
|
||
- Nur Guest‑PWA, nur Tenant‑Admin oder beides?
|
||
|
||
## 3. Wichtigste Dashboards (Beispiele)
|
||
|
||
- API‑Fehler‑Rate (5xx, 4xx für Public API).
|
||
- Queue‑Backlog (`default`, `media-storage`, `media-security`, `notifications`).
|
||
- Response‑Time Guest‑/Tenant‑PWA.
|
||
- Paddle‑Webhook‑Fehler (falls im Monitoring abgebildet).
|
||
|
||
> Ergänze hier konkrete Links zu euren Grafana/Datadog‑Dashboards, sobald diese stabil sind.
|
||
|
||
## 4. Wann eskalieren?
|
||
|
||
- SEV‑1: Plattform weitgehend nicht nutzbar (> 15 Minuten Ausfall, viele Tenants betroffen).
|
||
- SEV‑2: Kritische Kernfunktion (Uploads, Logins, Zahlungen) länger als 30 Minuten gestört.
|
||
- SEV‑3: Einzelne Tenants oder Funktionen, Workaround vorhanden.
|
||
|
||
Siehe auch `docs/ops/incidents-major.md` für detaillierte SEV‑Definitionen und Kommunikationsregeln.
|
||
|