Этап 5. Диагностика, метрики и оповещения
Дать оператору возможность найти запрос, понять причину ошибки, оценить состояние системы и получить своевременное оповещение. Диагностические данные должны оставаться безопасными и учитываться даже при отказе внешнего приёмника.
Что входит в этап
- Провести Request ID и Trace ID через интерфейс, API, MCP, внешние запросы и фоновые задания. Добавить поиск выполнения и переход к связанной трассировке.
- Безопасно собирать ошибки браузера и передавать трассировки и ошибки в GlitchTip. Недоставленные события сохранять в устойчивом дисковом буфере с подтверждением доставки.
- Явно учитывать потери диагностики. Подтвердить запас буфера на 30 часов для каждого получателя, восстановление после недоступности до 24 часов и установленные сроки доставки.
- Завершить технические метрики и локальные показатели использования. Имена, типы, единицы, метки и гистограммы фиксируются контрактом; пользовательские идентификаторы и произвольные значения не создают новые ряды.
- Поставить защищённый сбор Prometheus, готовые панели Grafana, правила вычисления SLO и заменяемую доставку уведомлений через адаптер Apprise. Каждое серьёзное оповещение должно вести к понятной инструкции действий.
Условия завершения
Перед закрытием проверить реальную корреляцию, доставку, восстановление буфера, точный учёт потерь и ограничение числа рядов. Для наблюдаемости подтверждаются накладные расходы ≤5% задержки p95 и ≤10% CPU. Внешняя аналитика не становится обязательной: передача за пределы установки включается явно. Начало зависит от проверки фоновых заданий 4-10; объём — задачи 5-1–5-13.
После выполнения задач провести ретроспективу: сверить результат с требованиями, проверками и фактическими изменениями, оформить подтверждённые недостатки и принять решение о закрытии этапа.
Основание плана
Подробный план и обязательные критерии. Номер исходного эпика: 5. При переносе уже завершённые задачи исключены.
Задачи этапа
- 5-1. Единые идентификаторы запросов и трассировок
- 5-2. Поиск запросов и переход к трассировке из интерфейса
- 5-3. Безопасная диагностика браузера
- 5-4. Надёжная отправка трассировок и ошибок в GlitchTip
- 5-5. Сохранение диагностических событий в дисковом буфере
- 5-6. Учёт потерь диагностики и проверка ёмкости буфера
- 5-7. Полное покрытие техническими метриками
- 5-8. Локальные показатели использования и активных пользователей
- 5-9. Защищённая интеграция с Prometheus
- 5-10. Заменяемая доставка уведомлений через Apprise
- 5-11. Готовые панели Grafana и ссылки на трассировки
- 5-12. Измерение целевых показателей надёжности
- 5-13. Доставка прикладных оповещений
- 5-Р. Итоговая ретроспектива этапа 5