docs: update REPORT.md

This commit is contained in:
Dmitrii Grishko
2026-11-13 19:27:41 +03:00
parent 1b9c6eefae
commit 79624ec54e
6 changed files with 37 additions and 2 deletions
+37 -2
View File
@@ -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.
Binary file not shown.

After

Width:  |  Height:  |  Size: 306 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 403 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 423 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 418 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 427 KiB