voidea/docs/runbook/03-incident.md

Runbook: Инциденты

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

# 1. Проверить что процесс жив
systemctl status voidea

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

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

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

# 5. Если не помогло — rollback
cd /opt/voidea
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 < /backups/voidea.20260511.sql

AI провайдер недоступен

• FallbackChain автоматически пробует YandexGPT → GigaChat
• Если оба недоступны — возвращается AgentResult(success=False)
• Пользователь получает уведомление, анализ не блокируется

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

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

# 2. Проверить какие endpoint'ы нагружают
tail -n 100 /var/log/voidea/access.log

# 3. Временно ограничить: увеличить число воркеров или перезапустить
systemctl restart voidea

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