voidea/template/docs/runbook/03-incident.md

Runbook: Инциденты

---

Сервис недоступен

# 1. Проверить что процесс жив
ps aux | grep uvicorn

# 2. Проверить логи
journalctl -u voidea -n 50 --no-pager

# 3. Перезапустить
systemctl restart voidea

# 4. Проверить
curl http://localhost:8020/health

# 5. Если не помогло → rollback
git checkout <previous-stable-tag>
systemctl restart voidea

База данных недоступна

# 1. Проверить PostgreSQL
systemctl status postgresql

# 2. Проверить логи
journalctl -u postgresql -n 50

# 3. Перезапустить
systemctl restart postgresql

# 4. Если повреждена → восстановить из backup
#    psql -U voidea -d voidea < backup.sql

Высокая загрузка CPU

# 1. Найти процесс
top -o %CPU

# 2. Найти endpoint
tail -n 100 /var/log/voidea/access.log

# 3. Временно отключить (если endpoint не критичен)

# 4. Разбираться после восстановления