diff --git a/REPORT.md b/REPORT.md index 6dc25ff..f350558 100644 --- a/REPORT.md +++ b/REPORT.md @@ -2,18 +2,31 @@ - Автор — Гришко Дмитрий Михайлович, БВТ2303. - Целевая оценка — 4. -- Ветка — `solution/Grishko-BVT2303`. Перенос — `d993866`, базовая наблюдаемость — `549edc8`, сквозная трассировка и алерты — `d753e34`. +- PR: . - Источники — [задание](README.md), [контракт наблюдаемости](contracts/observability.md), [OpenAPI](contracts/openapi.json), [OpenTelemetry Go](https://opentelemetry.io/docs/languages/go/instrumentation/), [OTLP в Loki](https://grafana.com/docs/loki/latest/send-data/otel/). Зависимости закреплены в [go.mod](src/go.mod). Помощь ИИ — OpenAI Codex, реализация, проверки и оформление. ## Запуск из чистого клона -Нужны Linux, Git, Make, Python 3.9+, Docker Engine с Compose и доступ к реестрам образов и зависимостей при первой сборке. Из каталога репозитория на ветке решения: +Нужны Linux, Git, Make, Python 3.9+, Docker Engine с Compose и доступ к реестрам образов и зависимостей при первой сборке. Склонируйте ветку решения и перейдите в каталог проекта. + +```sh +git clone --branch solution/Grishko-BVT2303 --single-branch \ + https://gitea.privcloud.tech/TAskMAster339/mtusi2026lab6-fork.git +cd mtusi2026lab6-fork +``` + +Создайте локальную конфигурацию, проверьте Compose и запустите стенд. ```sh make app-init docker compose config --quiet make app-up curl --fail http://127.0.0.1:8080/health/ready +``` + +После ответа `{"status":"ok"}` запустите проверки. + +```sh make check make test BASE_URL=http://127.0.0.1:8080 make evidence BASE_URL=http://127.0.0.1:8080 @@ -73,6 +86,28 @@ SLI — доля бизнес-запросов без 5xx, SLO ≥99% за 30 м Один короткий профиль нагрузки выполнен на AMD Ryzen 9 PRO 7940HS с 16 логическими CPU и 14 ГиБ RAM. Две API-реплики ограничены 0,5 CPU и 512 МиБ каждая. Worker ограничен 1 CPU и 512 МиБ. Профиль — 30 секунд, четыре параллельных клиента, closed-loop POST сообщений, один прогон без отдельного прогрева. В итоговом прогоне подтверждено 37 708 запросов, ошибок 0, пропускная способность 1256,75 RPS. Задержки p50/p95/p99 составили 2,828 / 4,327 / 7,211 мс. Полный вывод и снимок ресурсов после прогона сохранены в [результатах нагрузки](evidence/criteria/grade4-load.md). +### Скриншоты Grafana + +![Дашборд API во время нагрузки](evidence/grafana_load.png) + +*Рисунок 1. Во время нагрузочного прогона частота запросов выросла, а частота ответов `5xx` осталась на нуле. Панели p50, p95 и p99 показывают задержку API.* + +![Сквозная трасса загрузки с повторной обработкой](evidence/s3_fall.png) + +*Рисунок 2. В одной трассе Tempo видны HTTP-ответ `202`, публикации в RabbitMQ и спаны worker. Первая обработка завершилась ошибкой, затем worker получил задание повторно. Trace ID — `9718ad3f6a66598ef72ed8ec1cb5101f`.* + +![Глубина и возраст очереди при остановке worker](evidence/queue_fall.png) + +*Рисунок 3. При остановке worker в очереди оставалось одно незавершённое задание. Возраст старейшего задания превысил 30 секунд. После возобновления обработки оба показателя вернулись к нулю.* + +![Состояния алерта MessengerQueueLag в Prometheus](evidence/alerts.png) + +*Рисунок 4. В Grafana Explore запрос к метрике `ALERTS` показывает переход `MessengerQueueLag` из `pending` в `firing` во время роста возраста задания.* + +![Дочерний спан PostgreSQL при ответе API 503](evidence/postgres_fall.png) + +*Рисунок 5. При блокировке таблицы чатов API вернул `503`. Ошибочный дочерний спан `postgresql query` занял около пяти секунд, почти всю длительность HTTP-запроса.* + ## Ограничения и следующие шаги Стенд локальный, PostgreSQL, S3, RabbitMQ и балансировщик развёрнуты в одном экземпляре. Отказы этих компонентов могут прерывать соответствующие бизнес-операции. Снимок памяти Collector относится к короткому отказу. При переполнении очереди или исчерпании повторов возможна потеря телеметрии. Результат closed-loop прогона зависит от клиента и не оценивает предел пропускной способности. Заявленная оценка — 4. diff --git a/evidence/alerts.png b/evidence/alerts.png new file mode 100644 index 0000000..82dfe5d Binary files /dev/null and b/evidence/alerts.png differ diff --git a/evidence/grafana_load.png b/evidence/grafana_load.png new file mode 100644 index 0000000..dc2f718 Binary files /dev/null and b/evidence/grafana_load.png differ diff --git a/evidence/postgres_fall.png b/evidence/postgres_fall.png new file mode 100644 index 0000000..8888348 Binary files /dev/null and b/evidence/postgres_fall.png differ diff --git a/evidence/queue_fall.png b/evidence/queue_fall.png new file mode 100644 index 0000000..2fcb561 Binary files /dev/null and b/evidence/queue_fall.png differ diff --git a/evidence/s3_fall.png b/evidence/s3_fall.png new file mode 100644 index 0000000..84dcd63 Binary files /dev/null and b/evidence/s3_fall.png differ