Incident Template — Pinbox24

Szablon do dokumentowania incydentów na platformie Pinbox24 (W3/W4). Kopiuj do incident-YYYY-MM-DD-slug.md przed wypełnieniem.


Nagłówek

PoleWartość
IDINCIDENT-YYYY-MM-DD-NNN
PlatformaW3 / W4 / Wspólna
SevernośćP0 (produkcja down) / P1 (degradacja) / P2 (pojedynczy użytkownik)
StatusOPEN / RESOLVED / MONITORING
WykrytoYYYY-MM-DDTHH:MMZ
RozwiązanoYYYY-MM-DDTHH:MMZ
GH Issueradieu/p24-infra#NNN

Symptom

Co widział użytkownik lub monitoring. Dosłowny komunikat błędu.

Oś czasu

Czas (UTC)Zdarzenie
HH:MMWykrycie błędu
HH:MMPoczątek dochodzenia
HH:MMRoot cause ustalony
HH:MMHotfix wdrożony
HH:MMWeryfikacja OK

Root cause

Krótki opis co poszło nie tak i dlaczego.

Zmienione pliki / kontenery

Plik / KontenerZmianaRollback
container:/path/file.jsstary kod → nowy kodPrzywróć backup z /tmp/... lub rebuild

Weryfikacja fix

Jak potwierdzono że fix działa. Logi, HTTP status, dane w DB.

Długoterminowy fix

Co należy zrobić żeby ten problem nie wrócił. Issue numer jeśli założony.

Rollback

Jak cofnąć hotfix jeśli fix powoduje nowe problemy.

# Przykład rollback dla hotfixu kontener/plik:
docker cp /tmp/backup-controller.js container:/app/path/controller.js
docker exec container pm2 restart app-name

Lekcje

Co można było zrobić lepiej. Co monitoring powinien wykryć.