# Runbook: Инциденты

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

```bash
# 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
```

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

```bash
# 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

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

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

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

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