Files
buryan-infra/ops/agents/LEARNING.md

36 lines
1.9 KiB
Markdown

# Обучение агента: подсказки по повторяющимся сбоям (B-21)
## Что добавлено
1. **Дедупликация причин.** Раньше в памяти копилось
`["docker state: exited", "docker state: exited", ...]` —
теперь одинаковые подряд не дублируются.
2. **Словарь решений `SOLUTIONS`.** Для типовых сбоев агент печатает
подсказку рядом с проблемой.
3. **Поле `hint` в отчёте** (`/var/lib/hub-agents/journal/<дата>-runner.json`).
## Таблица подсказок
| Причина | Подсказка |
|---|---|
| `exited` | перезапустить контейнер; если повторяется — смотреть логи и память CT |
| `restarting` | чаще всего права на том или конфликт порта |
| `no space` | `docker system prune` и ротация логов |
| `permission denied` | `chown` тома после пересоздания контейнера |
| `connection refused` | сервис не слушает порт: проверить процесс и `ss -ltn` |
| `не в статусе` | нет `/health`: проверить nginx-прокси и порт |
| `cert` | `certbot renew` и копирование в `/etc/nginx/certs` |
## Пример вывода
```
✗ freshrss (CT111, сбоев 3): docker state: exited
→ перезапустить контейнер: healthcheck в CT делает это сам;
если повторяется — смотреть docker logs и память CT
```
## Что дальше
- Копить статистику: какая подсказка реально помогла (флаг `resolved_by`).
- Ограничить автоматические действия классом B (уже сделано в `actions.py`).