This commit is contained in:
Vladislav Kunetskiy
2026-10-21 21:22:42 +03:00
parent f4bd361f12
commit 464db7fdd6
238 changed files with 13332 additions and 704 deletions
+43
View File
@@ -1,13 +1,29 @@
# Copy to .env for your LOCAL synthetic test environment; never commit .env.
# Values below are the variables this implementation actually reads
# (viper: section.name -> SECTION_NAME, see internal/config/config.go).
#
# Mapping to the logical names suggested by the skeleton:
# APP_HOST / APP_PORT -> SERVER_HOST / SERVER_PORT
# SESSION_STORE=postgres -> server-side sessions live in PostgreSQL (SESSION_TTL_SECONDS)
# DATABASE_URL_FILE -> unused: POSTGRES_* below pass no secret files
# CACHE_URL_FILE -> unused: REDIS_* below pass no secret files
# API_REPLICAS -> number of API replicas of the stand (compose.yaml)
#
# APP_ENV selects config/<env>/config.yaml; the implementation supports only `dev`.
APP_ENV=dev
SERVER_HOST=0.0.0.0
SERVER_PORT=8080
SERVER_READ_HEADER_TIMEOUT=10s
SERVER_SHUTDOWN_TIMEOUT=10s
# Предел размера тела запроса (байт): защищает реплику от чтения огромного тела
# до валидации. Для вложений LAB4 (до 10 MiB) значение нужно поднять.
SERVER_MAX_BODY_BYTES=262144
LOG_LEVEL=info
LOG_FORMAT=json
# Synthetic credentials for the local stand only; override in .env for anything else.
POSTGRES_HOST=localhost
POSTGRES_PORT=5432
POSTGRES_DATABASE=messenger
@@ -39,3 +55,30 @@ CACHE_LOCK_TTL=10s
CACHE_LOCK_WAIT_TIMEOUT=2s
SESSION_TTL_SECONDS=3600
# Retention of a message Idempotency-Key in the shared store; contract 1.3.0
# requires at least 24 h.
IDEMPOTENCY_TTL_SECONDS=86400
# Lab3 stand (compose.yaml): number of API replicas behind the LB and per-replica
# CPU/RAM limits. Track 1 varies them to compare 1/2/4 replicas at a fixed total
# budget, e.g. API_REPLICAS=4 API_CPU_LIMIT=0.25 API_MEM_LIMIT=192M.
API_REPLICAS=2
API_CPU_LIMIT=0.50
API_MEM_LIMIT=256M
# Connections of ONE API replica to PostgreSQL; the total is replicas × value.
# Track 1 checks whether the shared connection budget becomes the saturation
# point: at 4 replicas the default 10 means 40 connections against one database.
POSTGRES_MAX_CONNS=10
# CPU quota of the shared database. Track 1 shows it is the stand's saturation
# point: the API uses a fraction of its budget while PostgreSQL sits at its own.
POSTGRES_CPU_LIMIT=0.50
# Memory quota of the shared database. The track 1 series r/g/pool were measured
# with 512M, the db1cpu control — with 384M (see evidence/track1/profile-*.json).
POSTGRES_MEM_LIMIT=384M
# Loopback port of the HAProxy operator page (UP/DOWN of every replica).
LB_STATS_PORT=8404
+1 -1
View File
@@ -1,4 +1,4 @@
## Лабораторная 2
## Лабораторная 3
Автор / группа: TODO
Целевая оценка (3/4/5): TODO
+30
View File
@@ -45,3 +45,33 @@ jobs:
context: .
push: false
tags: mtusi-messenger:ci
stand:
name: Lab3 stand scenario
needs: build
runs-on: ubuntu-latest
timeout-minutes: 20
steps:
- uses: actions/checkout@v4
- run: cp .env.example .env
- run: docker compose --env-file .env config --quiet
- run: docker compose --env-file .env up -d --build
- name: Wait for readiness through the load balancer
run: |
for attempt in $(seq 1 60); do
if curl -fsS -o /dev/null http://localhost:8080/health/ready; then exit 0; fi
sleep 2
done
docker compose --env-file .env ps
exit 1
- name: Public smoke through the LB
run: make test
- name: Parallel idempotency through the LB
run: python3 student-tests/idempotency_parallel.py --base-url http://localhost:8080
- name: Stop one API replica and keep writing
run: make test-failover ACTION_SCRIPT=scripts/stop-one.sh
- name: Logs on failure
if: failure()
run: docker compose --env-file .env logs --tail 100
- if: always()
run: docker compose --env-file .env down -v
+14 -2
View File
@@ -4,8 +4,14 @@ ARG GO_VERSION=1.27.1
ARG ALPINE_VERSION=3.22
FROM golang:${GO_VERSION}-alpine AS build
ARG TARGETOS=linux
ARG TARGETARCH=amd64
# Platform of the produced binaries. Left empty on purpose: the classic builder
# does not supply these args, and the previous hardcoded `amd64` default silently
# produced x86-64 binaries inside an arm64 image. Those ran under emulation and
# the Go runtime crashed under load (fatals like "found pointer to free object").
# Empty means "build for the builder's own platform"; cross-compile explicitly:
# docker build --build-arg TARGETARCH=amd64 ...
ARG TARGETOS
ARG TARGETARCH
ARG VERSION=dev
ENV GOTOOLCHAIN=local
WORKDIR /opt
@@ -13,6 +19,12 @@ WORKDIR /opt
COPY go.mod go.sum ./
RUN go mod download
# The Go compiler spikes well above 1 GiB per package on large dependencies, so
# an unbounded parallel build OOMs small Docker VMs and CI runners. Cap
# parallelism; override with --build-arg GOFLAGS=-p=$(nproc) on a bigger host.
ARG GOFLAGS="-p=2"
ENV GOFLAGS=$GOFLAGS
COPY . .
RUN CGO_ENABLED=0 GOOS=${TARGETOS} GOARCH=${TARGETARCH} \
go build -trimpath -buildvcs=false -tags timetzdata \
+1 -1
View File
@@ -1,4 +1,4 @@
# Памятка преподавателю — лабораторная 2
# Памятка преподавателю — лабораторная 3
## Что подготовлено
+36 -4
View File
@@ -5,10 +5,11 @@ ACTION_SCRIPT ?=
TLS_ARGS = $(if $(CA_FILE),--ca-file "$(CA_FILE)",)
PYTHON_LOCAL = env -u HTTP_PROXY -u HTTPS_PROXY -u ALL_PROXY -u http_proxy -u https_proxy -u all_proxy NO_PROXY=localhost,127.0.0.1,::1 no_proxy=localhost,127.0.0.1,::1 $(PYTHON)
.PHONY: help check validate test load test-persistence smoke-local load-local
.PHONY: help check validate test load test-persistence test-failover smoke-local load-local test-idempotency test-lb-readiness up down ps logs
help:
@echo "check: offline structure; validate: full OpenAPI (requirements-dev.txt); test: running API; load: synthetic writes"
@echo "up/down/ps/logs: lab3 stand from compose.yaml (LB + API_REPLICAS replicas + stores)"
check:
$(PYTHON) scripts/check_contract.py
@@ -17,21 +18,52 @@ validate:
$(PYTHON) scripts/validate_openapi.py
test:
$(PYTHON) tests/smoke.py --base-url "$(BASE_URL)" $(TLS_ARGS)
$(PYTHON_LOCAL) tests/smoke.py --base-url "$(BASE_URL)" $(TLS_ARGS)
load:
$(PYTHON) tests/load.py --base-url "$(BASE_URL)" $(TLS_ARGS)
$(PYTHON_LOCAL) tests/load.py --base-url "$(BASE_URL)" $(TLS_ARGS)
test-persistence:
@test -n "$(ACTION_SCRIPT)" || (echo "Set ACTION_SCRIPT to your implemented executable restart hook"; exit 2)
$(PYTHON) tests/resilience.py --mode persistence --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS)
$(PYTHON_LOCAL) tests/resilience.py --mode persistence --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS)
test-failover:
@test -n "$(ACTION_SCRIPT)" || (echo "Set ACTION_SCRIPT to your implemented executable stop-one hook"; exit 2)
$(PYTHON_LOCAL) tests/resilience.py --mode failover --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS)
# Локальный запуск без прокси: в окружении автора HTTP(S)_PROXY ломает localhost.
smoke-local:
$(PYTHON_LOCAL) tests/smoke.py --base-url "$(BASE_URL)" $(TLS_ARGS)
load-local:
$(PYTHON_LOCAL) tests/load.py --base-url "$(BASE_URL)" $(TLS_ARGS)
# Собственная проверка уровня 4: параллельные повторы одного Idempotency-Key
# через LB обязаны создать ровно одно сообщение.
test-idempotency:
$(PYTHON_LOCAL) student-tests/idempotency_parallel.py --base-url "$(BASE_URL)" $(TLS_ARGS)
# Собственная проверка уровня 4: LB обязан убрать из ротации реплику, которая
# осталась доступной, но потеряла БД (readiness 503).
test-lb-readiness:
scripts/lb_readiness_check.sh
COMPOSE_BIN ?= docker compose
COMPOSE_FILE ?= compose.yaml
ENV_FILE ?= .env
up:
$(COMPOSE_BIN) --env-file $(ENV_FILE) -f $(COMPOSE_FILE) up -d --build
down:
$(COMPOSE_BIN) --env-file $(ENV_FILE) -f $(COMPOSE_FILE) down
ps:
$(COMPOSE_BIN) --env-file $(ENV_FILE) -f $(COMPOSE_FILE) ps
logs:
$(COMPOSE_BIN) --env-file $(ENV_FILE) -f $(COMPOSE_FILE) logs -f --tail 100
.DEFAULT_GOAL := help
GO ?= go
APP_NAME ?= messenger
+32 -33
View File
@@ -1,6 +1,6 @@
# Лабораторная 2. PostgreSQL, сессии и Redis/Valkey
# Лабораторная 3. Балансировка и отказ API-реплики
Перенести состояние в постоянное хранилище и связать запросы с аутентифицированным пользователем. Подтверждённые сообщения и действующие сессии переживают перезапуск.
Запустить несколько взаимозаменяемых экземпляров API за единой точкой входа и сохранить корректность при остановке одного из них.
Это **skeleton**, а не готовый сервер. Здесь есть задание, контракт и публичные проверки. Реализацию приложения, Dockerfile и требуемую инфраструктуру пишет студент. Язык и framework свободные; UI не обязателен.
@@ -8,41 +8,42 @@
## Откуда начинаем
Перенесите собственный минимум lab1. Изменения API: password при регистрации, Basic для создания сессии, Bearer вместо X-User-Id для бизнес-запросов.
Нужен минимум lab2: PostgreSQL, общие действующие сессии, миграции. Добавляются X-Instance-Id и обязательный Idempotency-Key при отправке сообщения.
**Архитектура:** Клиент → API → PostgreSQL; на 4 появляется Redis ИЛИ Valkey для сессий/кэша.
**Архитектура:** Клиент → LB → API × 2+ → общие PostgreSQL и хранилище сессий. Compose или Swarm — на выбор.
## Что сделать
1. Опишите таблицы, ограничения, индексы и транзакционные границы до написания запросов. Добавьте версионируемые миграции.
2. Перенесите пользователей, чаты, членство и сообщения в PostgreSQL. Не используйте SQLite как замену PostgreSQL в принимаемом стенде.
3. Реализуйте регистрацию с password KDF, вход через Basic, opaque Bearer-сессию, expiry и logout. Действующие сессии тоже должны сохраняться.
4. Подготовьте единый локальный запуск API и БД (Compose рекомендуется уже здесь), подключите именованные volumes.
5. Пройдите smoke и тест полного перезапуска. На 4 добавьте Redis/Valkey с конкретной ролью и повторите эксперимент отказа.
1. Выберите Compose + Nginx/HAProxy/Traefik либо Docker Swarm. Для выбранного варианта дайте одну последовательность запуска.
2. Уберите локальные сессии/другие данные, от которых зависит корректность, из API. Миграции выполняйте отдельно и согласованно, а не гонкой всех реплик.
3. Настройте балансировщик, проверки готовности, DNS/обновление backend-адресов и graceful shutdown. Не закрепляйте клиента sticky session как способ исправить раздельное состояние.
4. Реализуйте общую идемпотентность отправки сообщения. Проверьте одинаковый ключ одновременно через разные реплики.
5. Подготовьте явный action script, останавливающий одну выбранную API-реплику, и продемонстрируйте чтение/запись во время отказа.
## Оценка «3»: работающий минимум
- Минимум lab1 сохранён с объявленным переходом на новую аутентификацию. Все обязательные данные и ещё действующие сессии переживают рестарт API и хранилищ без удаления volumes.
- PostgreSQL содержит пользователей, чаты, участников и сообщения. Есть первичные/внешние ключи, уникальность username и миграции с нуля. Составная операция создания чата выполняется атомарно.
- Basic применяется только на POST /auth/sessions, остальные endpoint требуют Bearer. Есть срок жизни сессии и отзыв; X-User-Id не даёт доступ. Пароли уже хешируются password KDF.
- make test и make test-persistence ACTION_SCRIPT=scripts/restart.sh проходят. Миграции повторно запускаются без дублирования данных. Secrets/volumes не попадают в Git.
- Весь стенд описан в compose.yaml или stack.yaml, запускается документированной командой. Не менее двух API-реплик, одна публичная точка входа, одна общая БД и общее хранилище сессий.
- Разные запросы одного пользователя обслуживаются разными репликами без повторного входа. Это видно по X-Instance-Id. Доступ через LB — основной проверяемый маршрут.
- Можно остановить любую одну API-реплику при работающей другой: не позднее 10 секунд продолжаются новые чтения/записи, подтверждённые сообщения доступны. Краткие ошибки/оборванные запросы во время обнаружения отказа измеряются и допустимы.
- Повтор POST сообщения с тем же Idempotency-Key не создаёт дубль, включая конкурентный повтор и переключение реплики. Неподтверждённую запись клиент может безопасно повторить с тем же ключом.
- make test, persistence и failover-сценарий проходят; для failover проверяется наличие ≥2 наблюдаемых реплик. Для Swarm сборка образа и его доступность узлам описаны отдельно.
## Оценка «4»: уровень стажёра/джуна
Весь уровень 3 **и все** пункты ниже:
- Redis ИЛИ Valkey реально используется для сессий с TTL либо осмысленного кэша. Опишите источник истины, политику expiry и инвалидации. Если это единственное хранилище сессий, включите persistence, выдерживающее проверяемый рестарт; один TTL не сохраняет данные.
- Используются параметризованные запросы/безопасный ORM, ограниченный connection pool и таймауты. Проверены гонка регистрации одинакового username и rollback составной операции.
- Индекс истории обоснован запросом и EXPLAIN (ANALYZE, BUFFERS) на ≥10 000 сообщениях; пагинация не использует полный scan всей истории на каждую страницу.
- Есть автоматическая проверка expiry при коротком SESSION_TTL_SECONDS, logout, неверного пароля и недоступности Redis/БД. При потере сервиса приложение возвращает ограниченную ошибку/корректно обходит кэш, не принимает запрос от анонимного пользователя как доверенный.
- Health/readiness, timeouts и прекращение приёма при SIGTERM настроены согласованно; LB исключает недоступный backend. Укажите период проверок и максимальное время обнаружения отказа.
- Последовательно остановите каждую API-реплику (восстанавливая предыдущую); соберите RPS, ошибки и время восстановления. Общая идемпотентность проверяется параллельными запросами с одним ключом.
- Контейнеры имеют CPU/RAM-лимиты, API не публикуют порты наружу в обход LB; секреты и хранилища общие только там, где нужно. Нет container_name, мешающего масштабированию одного Compose-service.
- Rolling update или эквивалентная поочерёдная замена проверена под нагрузкой. Миграции запускаются однократно и совместимы с работающей версией либо ограничение честно описано.
## Оценка «5»: исследование и доказанный результат
Весь уровень 4 **и один законченный трек на выбор**. Приведите гипотезу, повторяемую методику, результаты и ограничения.
**Трек 1. Согласованность кэша.** Покажите на конкурентном сценарии stale read или cache stampede, реализуйте защиту и измерьте число SQL-запросов/latency до и после. Докажите read-after-write из контракта и восстановление после рестарта кэша; одной установки Redis недостаточно.
**Трек 1. Цена масштабирования.** При фиксированном суммарном CPU/RAM сравните 1/2/4 API-реплики на одном профиле нагрузки; затем проведите серию с ростом ресурсов. Найдите saturation point БД/LB/пула и покажите, почему рост реплик перестаёт помогать. Дайте исходные данные, графики и одно подтверждённое улучшение.
**Трек 2. План запроса и восстановление.** Исследуйте ≥100 000 сообщений с неравномерными размерами чатов, сравните ≥2 индекса/запроса и стоимость записи. Сделайте backup → восстановление в новое хранилище → сверку количества и выбранных сообщений. Обсудите время восстановления и границы потери данных.
**Трек 2. Отказ узла.** Расширьте стенд до нескольких узлов, покажите перенос API при потере узла и разберите оставшиеся SPOF (LB, DB, storage). Для заявленной защищённой зависимости покажите реальный failover и сохранность данных. Если DB не реплицирована, не заявляйте выживание её узла.
## Как начать и проверить
@@ -78,28 +79,26 @@ Smoke не выставляет оценку автоматически. Про
## Сценарий защиты
1. Применить миграции к пустому volume, создать пользователей, войти, отправить сообщение.
2. Запустить persistence-сценарий: он держит токен только в памяти тестового процесса; action script перезапускает API и все используемые хранилища, сохраняя volumes.
3. После готовности тот же токен читает те же данные; после logout — 401. Повторить с отдельным коротким TTL для проверки expiry.
4. Для 4: показать роль Redis/Valkey, план SQL и ошибку зависимости. Для 5: выполнить выбранный эксперимент.
1. Запустить стенд и показать ≥2 разных X-Instance-Id через LB с одной сессией.
2. Запустить make test-failover ACTION_SCRIPT=scripts/stop-one.sh. Скрипт теста выполняет запросы во время action, учитывает ошибки и повторяет сообщения с исходным ключом.
3. Показать, какой контейнер действительно остановлен; заголовок сам по себе не доказательство разных процессов. Повторить для второй реплики после восстановления первой.
4. Проверить restart всего стенда с сохранением volumes и неизменным токеном. Для 4/5 — соответствующие эксперименты.
## Что должно быть в PR
Исходники, Dockerfile, миграции, compose.yaml либо эквивалентный воспроизводимый запуск, scripts/restart.sh, собственные тесты и отчёт.
compose.yaml или stack.yaml, конфигурация LB, scripts/restart.sh, scripts/stop-one.sh, Dockerfile, миграции, результаты отказов.
Заполните `REPORT.md` и [шаблон PR](.github/pull_request_template.md), укажите целевую оценку/трек. Не меняйте обязательный контракт и публичные tests ради зелёного результата. Сохраняйте возможности предыдущих лабораторных в пределах [объявленных переходов](COURSE.md).
## Вопросы на защите
- Что подтверждает COMMIT и какие гарантии зависят от настройки durability?
- Где хранятся сессии и что будет после flush/restart Redis?
- Чем аутентификация отличается от доступа к конкретному чату?
- Почему hash пароля и быстрый checksum имеют разные задачи?
- Чем отказ процесса отличается от отказа узла?
- Почему depends_on/healthcheck сами по себе не являются балансировщиком?
- Какие POST можно повторять после timeout и что защищает Idempotency-Key?
- Что сломается при увеличении числа API, если сессии находятся в локальной памяти?
## Первичные материалы
- [PostgreSQL transactions](https://www.postgresql.org/docs/current/tutorial-transactions.html)
- [PostgreSQL EXPLAIN](https://www.postgresql.org/docs/current/using-explain.html)
- [Valkey persistence](https://valkey.io/topics/persistence/)
- [Redis persistence](https://redis.io/docs/latest/operate/oss_and_stack/management/persistence/)
- [Basic authentication](https://www.rfc-editor.org/info/rfc7617/)
- [Compose services](https://docs.docker.com/reference/compose-file/services/)
- [Swarm routing mesh](https://docs.docker.com/engine/swarm/ingress/)
- [Swarm services](https://docs.docker.com/engine/swarm/services/)
+204 -188
View File
@@ -1,222 +1,238 @@
# Отчёт — лабораторная 2
# Отчёт — лабораторная 3
- Автор, группа: Владислав Кунецкий, БВT2303
- Целевая оценка: 5
- Выбранный трек 5: трек 1 — согласованность кэша (распределённая защита от stampede)
- Commit/PR: solution/bvt2303-kunetsky
- Использованные библиотеки: ogen - генерация транспортного слова из openapi спеки, testify, mockery/v3 - тесты, zap обернутый в slog - логгирование.
- Помощь ИИ использовалась для обсуждения архитектуры, ревью и подготовки кода; решение проверено и изменено автором.
- Целевая оценка; выбранный трек 5, если нужен: 5; трек 1 «Цена масштабирования»
- Commit/PR: solution/bvt2303-kunetsky (fork репозитория лабораторной 3)
- Использованные источники, библиотеки и помощь ИИ: ogen (HTTP-транспорт из `contracts/openapi.json`), sqlc (SQL-слой), goose (миграции), pgx/v5, go-redis/v9, viper + validator (конфигурация), mockery/v3 + testify (тесты), zap через `log/slog`. Помощь ИИ использовалась для обсуждения архитектуры, ревью и подготовки кода; решение проверено и изменено автором. База перенесена из лабораторной 2.
## Запуск из чистого clone
Требования: make, Go 1.27+ / Docker
Требования: Docker Engine с Compose v2 (`docker compose`), `make`; Python 3.9+ (только стандартная библиотека) для проверок; Go 1.27 — для локальной сборки и unit/integration-тестов.
запуск через go
Проверено на: macOS 25.5.0, Apple M5 Pro, 48 GiB RAM, Docker Engine 29.5.2 (Colima, macOS Virtualization.framework), Docker Compose 5.5.1, Go 1.27.1. Docker VM: **2 vCPU и ≈1.9 GiB RAM** — лимиты контейнеров в `compose.yaml` подобраны под этот бюджет (API 0.5 CPU / 256 MiB на реплику, PostgreSQL 0.5 CPU / 384 MiB, Redis 0.25 / 192 MiB, LB 0.25 / 64 MiB), суммарно меньше доступного. Образы зафиксированы по версии: `haproxy:3.2-alpine`, `redis:7.4-alpine`, `postgres:18-alpine@sha256:77f585114c32fbca283dc835b0596f4e52b51b4c6662d7810b2f4084f60a1873`; приложение собирается из `Dockerfile` (`golang:1.27.1-alpine` → `alpine:3.22`), сборка ограничена `GOFLAGS=-p=2`, чтобы компилятор Go не выбил память небольшой VM.
```sh
make run
cp .env.example .env # синтетические креды локального стенда, реальных секретов нет
make up # docker compose --env-file .env up -d --build
make ps # контейнеры и health
curl -fsS http://localhost:8080/health/ready
make test # публичный smoke (профиль lab3) через LB
make test-idempotency # параллельные повторы одного Idempotency-Key
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
python3 student-tests/replica_failover.py --action-script scripts/stop-one.sh
make test-lb-readiness # LB и реплика, потерявшая БД (readiness 503)
scripts/rolling_update.sh # поочерёдная замена реплик под нагрузкой
make down # остановка стенда; named volumes остаются
```
запуск через docker
Намеренное удаление учебных данных (удаляет volumes и сессии):
```sh
cp .env.example .env
docker build -t mtusi-messenger:lab1 .
docker run --rm --name mtusi-messenger-lab1 \
-p 127.0.0.1:8080:8080 --env-file .env mtusi-messenger:lab1
docker compose --env-file .env down -v
```
Оператору достаточно `cp .env.example .env` и `make up`: миграции выполняет отдельный сервис `migrate` (`goose up`), он завершается успешно до старта API-реплик (`depends_on: service_completed_successfully`), поэтому реплики не гоняют схему наперегонки. Приложение принимает SIGTERM и дренирует сервер в пределах `SERVER_SHUTDOWN_TIMEOUT=10s`; у контейнера API `stop_grace_period: 15s`, чтобы Docker не убил запрос в полёте.
В другом терминале:
### Соответствие переменных `.env.example` реальной конфигурации
```sh
make check
make unit-test
make test
```
Контейнер останавливается через `Ctrl-C` или `docker stop mtusi-messenger-lab1`; приложение принимает SIGTERM и завершает HTTP-сервер с timeout 10 секунд. Состояние хранится только в памяти процесса. Удаление контейнера намеренно удаляет все учебные данные:
```sh
docker rm -f mtusi-messenger-lab1
```
| Логическое имя из задания | Реальная переменная | Смысл |
| --- | --- | --- |
| `APP_HOST` / `APP_PORT` | `SERVER_HOST` / `SERVER_PORT` | адрес и порт HTTP-сервера API |
| `APP_ENV` | `APP_ENV` | выбор `config/<env>/config.yaml`; реализован только `dev` |
| `SESSION_STORE=postgres` | — | сессии лежат в PostgreSQL (`sessions.token_hash`), параметр не нужен |
| `DATABASE_URL_FILE` | `POSTGRES_*` | параметры подключения к общей БД без файлов секретов |
| `CACHE_URL_FILE` | `REDIS_*`, `CACHE_*` | общий кэш списка чатов и его блокировки |
| `IDEMPOTENCY_TTL_SECONDS` | `IDEMPOTENCY_TTL_SECONDS` | срок хранения записи идемпотентности (по умолчанию 86400 с) |
| `API_REPLICAS` | `API_REPLICAS` | число API-реплик стенда (`deploy.replicas`) |
| — | `API_CPU_LIMIT` / `API_MEM_LIMIT` | лимиты CPU/RAM одной реплики (для профилей трека 1) |
| — | `POSTGRES_CPU_LIMIT` / `POSTGRES_MEM_LIMIT` / `POSTGRES_MAX_CONNS` | бюджет общего PostgreSQL и пул соединений одной реплики (трек 1) |
| — | `SERVER_MAX_BODY_BYTES` | предел размера тела запроса (413 при превышении) |
| — | `LB_STATS_PORT` | loopback-порт страницы оператора HAProxy |
## Архитектура и решения
Клиент → ogen-generated HTTP transport → REST adapter → user/chat/message services → единый in-memory Store. Store реализован на mutex; создание чата вместе с проверкой участников выполняется атомарно. ID и `created_at` назначаются in-memory storage. После перезапуска процесса данные исчезают. Store реализован таким образом, чтобы в будущем изменить его на реальную базу данных, без изменения сигнатур и кода в сервисах
Схема: клиент → LB (HAProxy с активными проверками `/health/ready`) → 2+ API-реплики → общие PostgreSQL и Redis. Единая точка входа — только LB: `127.0.0.1:8080`; порты API и хранилищ наружу не публикуются.
| Роль | Сервис в compose | Образ / версия | Проверка готовности | Сеть и порт | Данные |
| --- | --- | --- | --- | --- | --- |
| Единая точка входа | `lb` | `haproxy:3.2-alpine` | активный `httpchk GET /health/ready`, период 2 с, `fall 2 rise 2` | публикует `127.0.0.1:8080`; страница оператора `127.0.0.1:8404` | — |
| API-реплики | `api`, `deploy.replicas=${API_REPLICAS:-2}` | сборка из `Dockerfile` → `mtusi-messenger:lab3` | Docker healthcheck `/health/ready`, интервал 10 с | только внутренняя сеть, alias `api-replica` | — |
| Миграции схемы | `migrate` | тот же образ, one-shot `goose up` | завершение с кодом 0 до старта реплик | только внутренняя сеть | — |
| Источник истины | `postgres` | `postgres:18-alpine@sha256:77f5…1873` | `pg_isready`, 5 с | только внутренняя сеть | volume `postgres18-data` |
| Кэш и блокировки | `redis` | `redis:7.4-alpine` (AOF everysec) | `redis-cli ping`, 5 с | только внутренняя сеть | volume `redis7-data` |
| Credentials | — | — | — | `.env` (вне git, синтетические значения для локального стенда), в контейнеры передаются явными переменными | — |
- **Источник истины — PostgreSQL**: пользователи, чаты, участники, сообщения, серверные сессии (`sha256(token)`), записи идемпотентности. Транзакционные границы: создание чата вместе с участниками; отправка сообщения вместе с записью идемпотентности.
- **Redis/Valkey** — кэш списка чатов с распределённой блокировкой от stampede и версиями (`user_chat_versions`); не хранит ничего, что нужно для корректности ответа.
- **Общие сессии**: сессия создаётся одной репликой, любые другие её читают из БД, поэтому логин не привязан к реплике (sticky-сессии не используются).
- **`X-Instance-Id`**: значение стабильно в пределах процесса (`INSTANCE_ID` или hostname = короткий ID контейнера) и проставляется middleware на **каждый** ответ, включая ошибки 400/404/405, которые формирует транспорт, а не handler.
- **Идемпотентность отправки** (`Idempotency-Key` обязателен, `[A-Za-z0-9._:-]{1,128}`):
- таблица `message_idempotency (actor_id, chat_id, key, request_hash, message_id, expires_at)`, PK `(actor_id, chat_id, key)` — область уникальности «пользователь + чат + ключ»;
- claim — один `INSERT ... ON CONFLICT (actor_id, chat_id, key) DO UPDATE ... WHERE expires_at <= now() RETURNING`: живая запись не перезаписывается, истёкшая занимается заново;
- вставка сообщения и запись `message_id` идут в **одной транзакции с claim**, поэтому не бывает ключа без сообщения и наоборот; при откате (например, отправитель не участник) ключ не занимается;
- конкурентный повтор через разные реплики блокируется на строке и после коммита победителя возвращает его сообщение → ровно один INSERT в `messages`;
- повтор с тем же ключом и другим payload — `409`, для этого хранится `request_hash` (sha256 канонического payload `{"text":...}`; порядок ключей и пробелы в JSON не влияют).
- **LB**: HAProxy 3.2 (образ зафиксирован), `server-template api 4 api-replica:8080` + `resolvers docker` (Docker DNS 127.0.0.11, `hold valid 5s`) — адреса берутся из общего сетевого alias, выданного всем репликам, и переразрешаются каждые 5 с, поэтому масштабирование (1/2/4), замена контейнеров и смена IP не требуют правки конфига. Балансировка `leastconn`. Aктивные проверки готовности: `option httpchk GET /health/ready` + `http-check expect status 200`, `inter 2s fall 2 rise 2` — неготовая реплика исключается из ротации за ≤4 с и возвращается за ≤4 с. Это принципиально: пассивные проверки (nginx OSS, прежний вариант) не умели убирать реплику, которая остаётся доступной по сети, но теряет БД — она продолжала получать трафик и отвечать 503 (зафиксировано в ревью: 20 из 40 запросов `/health/live`). После перехода на активные проверки такая реплика получает **0 из 40** запросов, её статус `DOWN` (`evidence/lb-readiness.txt`), а запись через LB не прерывается (1 247 RPS, ноль ошибок в том же сценарии).
- **Повторы и идемпотентность**: HAProxy настроен на `retry-on conn-failure` + `retries 2` — повтор происходит только когда соединение не установилось и запрос не ушёл. Уже отправленный POST не повторяется, поэтому прозрачного дублирования создания чата нет (прежний вариант с `proxy_next_upstream ... non_idempotent` этим страдал). Неопределённый результат повтора остаётся за клиентом, а отправка сообщения защищена обязательным `Idempotency-Key`.
- **Страница оператора**: `127.0.0.1:8404/stats` (только loopback) показывает, какие реплики `UP`/`DOWN` и почему — именно по ней сняты доказательства выше.
- **Предел размера тела**: `SERVER_MAX_BODY_BYTES` (по умолчанию 256 КиБ). Тело больше лимита отклоняется с `413` до чтения и декодирования, поэтому публичный `POST /api/v1/users` не может выбить память реплики (раньше JSON-декодер читал тело целиком до любой валидации и до аутентификации). Для вложений ЛР4 (до 10 MiB) значение поднимается явно — это объявленный переход.
- **Логи**: заголовочные параметры (в том числе `Idempotency-Key`) попадают в лог как `redacted`, тела запросов — только своим размером; пароли, токены и содержимое сообщений не логируются.
- **Миграции**: одна последовательность для всего стенда (`migrate`), совместимость с работающей версией — новая таблица добавляется отдельной миграцией, старый код её не читает. Новая миграция пронумерована `00003`, а не `00002`: в базе, перенесённой из ЛР2, goose уже содержит применённую версию 2 (другая миграция того же репозитория), и совпадающий номер был бы молча пропущен при обновлении существующего стенда — это проверено на dev-базе (`goose: no migrations to run. current version: 2` при отсутствующей таблице).
### Что перенесено из lab2
Перенос: ветки `lab1` + `lab2` репозитория `mtusi-messenger`, перенесены только исходники, миграции, собственные тесты, Dockerfile и конфигурации (по правилам CONTRIBUTING.md; README/COURSE/contracts/публичные tests остались от skeleton ЛР3).
- Транспорт: HTTP-слой, сгенерированный ogen из `contracts/openapi.json`, REST-адаптер поверх него, middleware X-Request-Id и структурного логирования.
- Домен и сервисы: user / chat / message / session с валидацией и keyset-пагинацией.
- PostgreSQL — источник истины: pgx + sqlc, миграции goose, транзакции на создание чата.
- Сессии: Basic только при создании сессии, далее Bearer; в БД `sha256(token)`, TTL, переживают перезапуск процесса.
- Redis/Valkey: кэш списка чатов с распределённой блокировкой от stampede (`user_chat_versions`).
- Наблюдаемость: `/health/live`, `/health/ready`, структурированные логи (log/slog + zap).
- Инструменты: multi-stage `Dockerfile`, `docker-compose.local.yaml` для локального запуска, Makefile-таргеты, `.github/workflows/app.yml`.
### Изменения в этой работе (лаб. 3)
- Контракт 1.3.0: транспорт перегенерирован, `X-Instance-Id` во всех ответах, обязательный `Idempotency-Key` для отправки сообщения.
- Общая идемпотентность в PostgreSQL (миграция `00003_message_idempotency.sql`, sqlc-запросы, транзакция в `MessageRepository.Create`), 409 на конфликт payload.
- `IDEMPOTENCY_TTL_SECONDS` в конфиге (по умолчанию 24 ч), `.env.example` приведён к реальным переменным.
- Стенд ЛР3: `compose.yaml` (LB + `API_REPLICAS` реплик + PostgreSQL + Redis + одноразовый `migrate`), конфигурация LB `infra/lb/haproxy.cfg` (активные проверки готовности, ограниченные повторы, страница оператора), action-скрипты `scripts/stop-one.sh` и `scripts/restart.sh`, Makefile-таргеты `up/down/ps/logs`.
- Собственные проверки: `make test-idempotency` (параллельные повторы через LB), `student-tests/replica_failover.py` (поочерёдная остановка каждой реплики с метриками), `scripts/lb_readiness_check.sh` (неготовая реплика и LB), `scripts/rolling_update.sh`, эксперименты трека 1.
- Исправления по итогам аудита: отправка в несуществующий чат больше не даёт `500` из-за нарушения внешнего ключа от claim'а ключа идемпотентности (`23503` → `404`); добавлен предел размера тела (`413`, см. выше); заголовочные параметры не пишутся в лог; у проверок LB задан `timeout check 1s`, чтобы «залипшая» реплика исключалась за ограниченное время; у собственного сценария rolling update появился настоящий «наплыв» (новая реплика поднимается до снятия старой) и корректный счётчик 5xx (в HAProxy статус в логе печатается без кавычки, прежний шаблон молча давал нули).
- `Dockerfile`: убран жёстко заданный `TARGETARCH=amd64` — на Apple Silicon он давал x86-64 бинарник внутри arm64-образа, тот исполнялся через эмуляцию и падал по runtime-фаталам под нагрузкой (см. «Ограничения»); сборка ограничена `GOFLAGS=-p=2`, чтобы компилятор не выбил память небольшой Colima VM.
- Удалён осиротевший `scripts/track1_benchmark.py` (бенчмарк in-memory хранилища ЛР1: сам in-memory store удалён ещё в ЛР2, скрипт ссылался на несуществующий файл).
## Доказательства критериев
Артефакты ЛР1/ЛР2 перенесены в `evidence/lab1-2/` (там же пояснение, почему они не относятся к этой работе); в `evidence/` — только доказательства ЛР3.
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
| --- | --- | --- | --- |
| Публичный smoke | `make test` | `PASS: lab1 public API scenario` | `evidence/smoke.txt` |
| Контракт и структура | `make check` | `PASS` | `evidence/check.txt` |
| Unit, vet, race, lint | `make unit-test`, `go vet ./...`, `make lint` | PASS | `evidence/quality.txt` |
| Docker build/run/health | `docker build`, `curl /health/live` | image built, `{"status":"ok"}` | `evidence/docker.txt` |
| Сброс in-memory состояния | restart container, old `X-User-Id` | old user receives 401 | `evidence/restart.txt` |
| 100 concurrent messages | 10 clients × 10 messages | 100 unique messages | `evidence/concurrency.txt` |
| SIGTERM | `kill -TERM <pid>` | graceful stop under 10 seconds | `evidence/sigterm.txt` |
| Трек 1 benchmark | `go test -run '^$' -bench '^BenchmarkMessageCreate$' -benchmem -count=5 ./internal/storage/memory` и baseline через Go overlay; `scripts/track1_benchmark.py --mode ... --requests 100000` | изолированная вставка 1k/10k/50k и E2E с ровно 100 000 запросами на комбинацию, concurrency 1/4/16/32: RPS/p95/p99/RSS | `evidence/track1/` |
| Memory exhaustion point | `python3 scripts/memory_experiment.py --image mtusi2026lab1-messenger:arm64 --memory 64m --max-messages 20000 --output evidence/memory-experiment.json --plot evidence/memory-experiment.png` | container OOMKilled, exit 137, 8997 successful messages | `evidence/memory-experiment.json`, `evidence/memory-experiment.png` |
| Публичный smoke | `make test` | `PASS: lab3 public API scenario` через LB с двумя репликами | `evidence/smoke.txt` |
| Разные запросы одного пользователя обслуживают разные реплики | 40× `GET /users/me` через LB одной сессией (и 40× `/health/live`) | два разных `X-Instance-Id`, распределение видно по репликам | `evidence/failover/sequential.txt` (одна сессия), `evidence/lb-readiness.txt` (счётчики по репликам) |
| Идемпотентность: повтор, конкурентный повтор, смена реплики | `make test-idempotency` | 12 параллельных повторов одного ключа → одно сообщение; 12 разных payload → один 201 и одиннадцать 409; без ключа и с недопустимым ключом → 400 | `evidence/idempotency.txt` |
| Остановка одной реплики при работающей другой | `make test-failover ACTION_SCRIPT=scripts/stop-one.sh` (два прогона) | 127 и 100 подтверждённых записей, 0 ошибок, первое восстановление 0.21 с и 2.24 с | `evidence/failover/run1.txt`, `evidence/failover/run2.txt` |
| Последовательно остановлена каждая реплика, с измерениями (RPS, ошибки, время) | `python3 student-tests/replica_failover.py --action-script scripts/stop-one.sh` | реплика A: 91 запись (6.06 RPS), 0 ошибок, восстановление 1.66 с; реплика B: 100 записей (6.66 RPS), 0 ошибок, 1.66 с; после отказа обслуживает только вторая реплика; восстановление обеих 0.18–0.20 с; дублей нет (191 сообщение) | `evidence/failover/sequential.txt` |
| LB исключает неготовую реплику | `scripts/lb_readiness_check.sh` | реплика с потерянной БД (осталась доступной, readiness 503): **0 из 40** запросов, статус `DOWN` **через 2 с** (проверка `inter 2s fall 2 timeout check 1s`), при этом запись через LB не прервалась (1 163 RPS, 0 ошибок) | `evidence/lb-readiness.txt` |
| Предел размера тела | `python3`-проверка публичного `POST /api/v1/users` | тело 400 КиБ (сверх лимита 256 КиБ) → `413`, тело 100 КиБ → `400` (схема); реплика не выбита | `evidence/body-limit.txt` |
| Отказ БД не превращается в 500 | `python3`-проверка: `POST` сообщения напрямую в реплику (в обход LB) при остановленном PostgreSQL | напрямую к реплике — `503`, через LB — `503` с `X-Instance-Id` (ответ приложения), после возврата БД — `201` | `evidence/db-outage.txt` |
| Сохранность при перезапуске API и хранилищ | `make test-persistence ACTION_SCRIPT=scripts/restart.sh` | `PASS`: подтверждённые сообщения и прежний токен после перезапуска, volumes не удалялись | `evidence/persistence.txt` |
| Лимиты CPU/RAM, отсутствие публичных портов API, отсутствие `container_name` | `docker compose --env-file .env config`, `docker ps` | лимиты у каждого сервиса, публикуется только `127.0.0.1:8080` (LB) | `evidence/stand.txt` |
| Поочерёдная замена реплик под нагрузкой | `scripts/rolling_update.sh` (60 с, 8 клиентов; наплыв по одной реплике) | 97 359 подтверждённых записей, 3 переходные ошибки (0.003 %), **3 ответа 5xx от LB** за окно обновления, `restarts=0`; каждый шаг подтверждён сменой образа новых реплик и числом UP-слотов | `evidence/rolling-update/after/` |
| Контроль: тот же код вне Docker | `student-tests/rolling_update_load.py` против нативного процесса (90 с, 32 клиента) | 220 781 запрос, 0 ошибок, 2 452 RPS, p50 12.5 мс, p95 17.5 мс, p99 22.4 мс | `evidence/native-load.txt` |
| Проверки качества | `make check`, `make validate`, `make unit-test` (`-race`), `make integration-test` | все PASS, включая интеграционный тест «отправка в несуществующий чат → 404» | `evidence/quality.txt` |
| Трек 1: цена масштабирования | `scripts/track1_series.sh` + `scripts/track1_controls.sh` + `scripts/track1_report.py` | потолок ≈1 300–1 550 RPS: 1/2/4 реплики → −3 %/−5 %; бюджет API ×3, бюджет БД ×2 и бюджет LB ×4 не меняют RPS (перемежающий контроль: ±0.05 %), пул соединений не исчерпан; дрейф серии измерен | `evidence/track1/summary.md`, `evidence/track1/scaling-*.png` |
`make check`, `make validate` (полная OpenAPI-валидация в venv) и `make unit-test` (`-race`) проходят; интеграционные тесты PostgreSQL (`-tags=integration`, включая конкурентный повтор одного ключа) — тоже.
## Эксперименты и отказы
В рамках трека оптимизировано добавление новых сообщений в конец отсортированной истории. Если ключ нового сообщения больше ключа последнего сообщения, используется прямой `append`; бинарный поиск и упорядоченная вставка остаются fallback-путём для сообщений, пришедших не по порядку. Изолированный Go benchmark выполнялся на Apple M5 Pro, darwin/arm64, Go 1.27.1, пять раз для историй 1 000, 10 000 и 50 000. Baseline собран через Go overlay с удалённым fast path, optimized — текущая версия. Полные сырые результаты: `evidence/track1/baseline-storage-benchmark.txt` и `optimized-storage-benchmark.txt`.
Отдельно выполнен end-to-end benchmark через `go run` без Docker: истории 1 000, 10 000 и 50 000; конкуренция 1, 4, 16 и 32; ровно 100 000 нагрузочных POST-запросов на каждую комбинацию и 100 warm-up запросов; RSS дочернего исполняемого процесса сэмплировался каждые 100 мс. Baseline запускается через `go run -overlay`, optimized — обычный `go run`. Результаты: `evidence/track1/go-baseline/results.json`, `go-optimized/results.json`, `go-comparison.json`.
Оптимизация уменьшила стоимость операции добавления сообщения: медиана составляет 308.2 / 241.8 ns/op для истории 1 000, 335.9 / 242.2 ns/op для 10 000 и 349.8 / 242.5 ns/op для 50 000 (baseline / optimized). Это соответствует ускорению примерно в 1.27×, 1.39× и 1.44× соответственно. Число аллокаций одинаковое: 1 alloc/op, 16 B/op. Вставка в середину по-прежнему использует бинарный поиск и `slices.Insert`; оптимизирован только наиболее частый сценарий последовательного добавления в конец.
На полном HTTP-пути это ускорение не переносится напрямую в RPS: там дополнительно присутствуют HTTP, JSON, маршрутизация и общий mutex `Store`. В новом эксперименте число запросов фиксировано, поэтому сравниваются одинаковые объёмы работы, а не разные числа запросов за заданное время. При увеличении объёма до 100 000 запросов результаты стали стабильнее: optimized выигрывает по RPS в 5 из 12 комбинаций, прежде всего при concurrency 4/16; на concurrency 32 система упирается в конкуренцию за общий mutex, поэтому дополнительное увеличение параллелизма не даёт ускорения. Разница остаётся умеренной, поскольку fast path оптимизирует только часть полного HTTP-запроса.
### Точка отказа по памяти
Эксперимент запускался с лимитом контейнера `64m`, swap отключён (`--memory-swap 64m`). В каждое сообщение записывалось 4000 Unicode-символов. Контейнер завершился после 8997 подтверждённых сообщений с `OOMKilled=true` и `ExitCode=137`. На графике `evidence/memory-experiment.png` показан рост памяти контейнера до лимита и число подтверждённых сообщений. Причина отказа — in-memory Store удерживает все сообщения и их строки; после достижения cgroup memory limit ядро завершает процесс OOM killer. Это ожидаемая граница выбранной архитектуры: сервер не вводит лимиты количества сообщений и не выполняет controlled degradation.
| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных |
| --- | --- | --- | --- |
| Перезапуск контейнера | in-memory данные исчезают | старый пользователь получает 401 | данные теряются намеренно при restart |
| SIGTERM | сервер прекращает приём и завершает работу | остановка менее 10 секунд | подтверждённые данные не сохраняются |
| 10 клиентов × 10 сообщений | ровно 100 уникальных сообщений | 100 уникальных сообщений | нет потери в рамках процесса |
| `docker stop` одной API-реплики (прогон 1) | записи продолжаются, остановленная реплика исчезает из ответов | 127 успешных записей, 0 ошибок | 0.21 с |
| `docker stop` другой API-реплики (прогон 2) | то же | 100 записей, 0 ошибок | 2.24 с |
| Поочерёдно остановлены обе реплики (свой скрипт) | после каждой остановки пишет только вторая реплика, дублей нет | 91 и 100 записей (6.06 и 6.66 RPS), 0 ошибок, повторы с тем же ключом дубля не создали | 1.66 с и 1.66 с |
| Одной реплике закрыт доступ к БД (она остаётся доступной, readiness 503) | LB исключает её из ротации | 0 из 40 запросов ей, статус `DOWN` через 2 с, запись через LB не прервалась | — |
| Поочерёдная замена каждой реплики под нагрузкой (наплыв) | потери только на время остановки, дублей нет | 97 359 записей, 3 переходные ошибки, 3 ответа 5xx от LB, `restarts=0`, смена образа подтверждена по шагам | окно замены 5–6 с на реплику |
| Перезапуск API и всех хранилищ с сохранением volumes | сессия и данные живут | `PASS`, прежний токен работает | потери нет |
| Эмуляция x86-64 бинарника в arm64-образе (`--build-arg TARGETARCH=amd64`) | реплики замедляются и падают | в контроле (45 с, 8 клиентов) падений **не воспроизведено**: 89 560 запросов, 0 ошибок, 0 ответов 5xx; crash-loop наблюдались в других условиях | эффект не измерен (`evidence/rolling-update/emulated/`) |
| Удвоенный CPU БД, четырёхкратный CPU LB, пул 5 вместо 10, 32 клиента | пропускная способность вырастет, если узкое место — БД, LB или пул | бюджеты БД и LB не меняют RPS (перемежающий контроль: +0.04 % и −0.02 % при лимитах, проверенных по `docker inspect`); меньший пул хуже (−7 %); 32 клиента снижают RPS до 1 284 и растят p95 до 52.8 мс | `evidence/track1/summary.md`, `evidence/load-32clients.txt` |
### Трек 1: baseline / optimized
## Трек 1. Цена масштабирования
| History | Concurrency | Requests before/after | RPS before | RPS after | p95 before/after ms | p99 before/after ms | RSS max before/after KiB |
| ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: |
| 1000 | 1 | 100000 / 100000 | 7334.409 | 7184.594 | 0.146 / 0.150 | 0.186 / 0.231 | 32560 / 32272 |
| 1000 | 4 | 100000 / 100000 | 8823.924 | 8996.523 | 0.654 / 0.632 | 0.869 / 0.867 | 35520 / 35504 |
| 1000 | 16 | 100000 / 100000 | 7336.995 | 7482.719 | 3.514 / 3.445 | 4.631 / 4.577 | 35808 / 35680 |
| 1000 | 32 | 100000 / 100000 | 7386.656 | 7381.500 | 7.026 / 7.058 | 8.953 / 9.054 | 36336 / 36208 |
| 10000 | 1 | 100000 / 100000 | 7138.887 | 7150.931 | 0.149 / 0.146 | 0.210 / 0.187 | 36208 / 36224 |
| 10000 | 4 | 100000 / 100000 | 9043.732 | 9052.965 | 0.626 / 0.628 | 0.841 / 0.859 | 38496 / 38384 |
| 10000 | 16 | 100000 / 100000 | 7442.895 | 7440.817 | 3.485 / 3.468 | 4.703 / 4.701 | 38384 / 38624 |
| 10000 | 32 | 100000 / 100000 | 7382.485 | 7419.326 | 7.051 / 7.049 | 9.096 / 9.096 | 38384 / 38400 |
| 50000 | 1 | 100000 / 100000 | 7158.653 | 7213.610 | 0.149 / 0.145 | 0.211 / 0.191 | 52416 / 52304 |
| 50000 | 4 | 100000 / 100000 | 9079.212 | 9036.335 | 0.623 / 0.630 | 0.823 / 0.842 | 53152 / 53008 |
| 50000 | 16 | 100000 / 100000 | 7419.068 | 7453.530 | 3.471 / 3.455 | 4.694 / 4.688 | 53536 / 53216 |
| 50000 | 32 | 100000 / 100000 | 7427.333 | 7384.536 | 7.049 / 7.084 | 9.007 / 9.203 | 53760 / 53776 |
Методика: один и тот же профиль `tests/load.py` (closed loop, `concurrency=8`, `duration=60` с, прогрев 15 с) против стенда на 1, 2 и 4 API-репликах при **фиксированном суммарном бюджете** 1.0 CPU / 768 MiB на API; затем серия с ростом бюджета — 2 реплики и суммарно 0.5, 1.0 и 1.5 CPU. Бюджеты общих хранилищ между профилями не меняются: PostgreSQL 0.50 CPU / 384 MiB, Redis 0.25 / 192, LB 0.25 / 64. В контрольных профилях меняется ровно одна ручка: пул соединений реплики 10 → 5, бюджет CPU PostgreSQL 0.50 → 1.00, бюджет CPU балансировщика 0.25 → 1.00.
Бюджеты хранилищ compose применяет при **создании** контейнера, поэтому скрипт пересоздаёт PostgreSQL и LB, когда бюджет профиля отличается от действующего, и проверяет применение по `docker inspect`: в `profile-*.json` и в строке `=== applied … ===` сводки попадают значения, снятые с работающих контейнеров, а не переменные запуска. Без этой проверки профиль описывал бы намерение, а измерение шло бы на прежнем лимите — на этом и провалился первый контроль удвоения CPU БД; тот прогон вместе с прогоном, где нагрузку подавал клиент хоста, лежит в `evidence/track1/superseded/`. Генератор работает **внутри VM** (`CLIENT=vm`, контейнер в сети стенда): клиент на хосте через проброс порта под шквалом новых соединений получает отказы самого проброса, не относящиеся к стенду (разбор — `evidence/path-overhead/`). Вся серия снимается одной командой `scripts/track1_series.sh` (~15 минут); профили с уже снятыми артефактами при повторном запуске пропускаются.
Бюджеты выбраны под Colima VM (2 vCPU, ≈1.9 GiB), чтобы измерения шли в её пределах, а не за счёт хоста. Ресурсы реплик считаются суммированием по одному timestamp: в первой версии сводки несколько реплик усреднялись как одна выборка, что занижало CPU и память вдвое — исправлено, сырые CSV не менялись. Сводка учитывает только контейнеры своего проекта (`--prefix`): параллельно поднятый стенд другой лаборатории иначе попадал в те же колонки (`…-lab2-postgres-1` → `postgres`). Сырые артефакты — `evidence/track1/` (`load-*.json`, `stats-*.csv`, `profile-*.json`), сводка — `evidence/track1/summary.md`, графики — `scaling-fixed-budget.png` и `scaling-growth.png`.
### Профили и результаты
Серия 1 — фиксированный суммарный бюджет 1.0 CPU / 768 MiB на API (PostgreSQL 0.50 CPU / 384 MiB, Redis 0.25, LB 0.25), нагрузка `tests/load.py` (closed loop, 8 клиентов, 60 с, прогрев 15 с, клиент внутри VM):
| реплик | CPU на реплику | успешный RPS | p50, мс | p95, мс | p99, мс | ошибки | API CPU (сумма) | PG CPU | LB CPU | строк в `messages` |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 1 | 1.00 | 1 542.9 | 5.05 | 8.01 | 10.24 | 0 | 0.24 | 0.39 | 0.10 | 3.60 млн |
| 2 | 0.50 | 1 491.3 | 5.25 | 8.23 | 10.30 | 0 | 0.28 | 0.36 | 0.10 | 3.71 млн |
| 4 | 0.25 | 1 415.7 | 5.54 | 8.61 | 10.75 | 0 | 0.31 | 0.35 | 0.10 | 3.82 млн |
Серия 2 — рост бюджета API при 2 репликах:
| суммарный CPU API | CPU на реплику | успешный RPS | p95, мс | ошибки | API CPU (сумма) | PG CPU |
| --- | --- | --- | --- | --- | --- | --- |
| 0.5 | 0.25 | 1 489.9 | 8.25 | 0 | 0.28 | 0.36 |
| 1.0 | 0.50 | 1 496.3 | 8.22 | 0 | 0.27 | 0.37 |
| 1.5 | 0.75 | 1 491.3 | 8.18 | 0 | 0.27 | 0.36 |
Трехкратный бюджет API не сдвигает пропускную способность (1 490 → 1 496 → 1 491), а лишние реплики при неизменном суммарном бюджете её снижают: каждая реплика — ещё один процесс, соединения и копия кэша, а суммарный CPU фиксирован.
Отказов в чистой серии почти нет: 13 профилей из 15 без единого отказа, в двух профилях `pool` — по 4 обрыва в момент пересоздания реплики. Прежние прогоны показывали до 26 % отказов, но это были отказы соединений **у клиента на хосте**, а не у стенда: в контроле `evidence/path-overhead/` балансировщик отдал все запросы без 5xx, логи API не содержат ошибок, а клиент внутри VM не отказал ни разу. Подтверждённых записей не потеряно: повтор с тем же ключом дубля не создаёт (см. проверку идемпотентности).
Контроль снят попарно с эталоном, чтобы дрейф серии не выдавался за эффект бюджета (`scripts/track1_controls.sh`; лимиты применены к контейнерам и проверены по `docker inspect`):
| профиль | что изменено | успешный RPS | отличие от соседнего эталона |
| --- | --- | --- | --- |
| `ctl1base` / `ctl3base` | эталон (2 реплики, PostgreSQL 0.50, LB 0.25) | 1 391.1 / 1 360.1 | −2.2 % за два профиля — масштаб дрейфа |
| `ctl2pg` | бюджет CPU PostgreSQL 0.50 → 1.00 | 1 391.6 | **+0.04 %** |
| `ctl4lb` | бюджет CPU балансировщика 0.25 → 1.00 | 1 359.8 | **−0.02 %** |
| `pool10` / `pool5` | пул соединений реплики 10 → 5 (4 реплики) | 1 399.0 / 1 299.6 | −7 % (меньший пул хуже) |
| 32 клиента вместо 8 | — | 1 284 | p95 52.8 мс вместо ≈8-9 мс (`evidence/load-32clients.txt`) |
Профили серии `db1cpu` (PostgreSQL 1.00) и `lb1cpu` (LB 1.00) показывают на 15 % и 8 % меньше, чем `r2`, но сняты позже, и разница объясняется дрейфом: тот же профиль `r2`, повторённый в конце серии (`d2`), даёт 1 389 RPS вместо 1 491 (−6.9 %). Поэтому вопрос «помогает ли бюджет БД» решают именно перемежающие профили, а не сравнение через полчаса.
Стенд дрейфует по ходу серии: таблица `messages` растёт (≈95 тыс. строк на профиль, 3.6 → 5.1 млн за серию), и эталон `r2`, снятый в начале и в конце, даёт 1 491 и 1 389 RPS (−6.9 %, ≈0.9 % на профиль); независимая оценка дрейфа по двум эталонам перемежающего контроля — 2.2 % за два профиля. Повторы одной конфигурации внутри сессии расходятся до ~2 %. Поэтому профили сравнимы только внутри одной серии и рядом по времени, а влияние каждой ручки проверяется попарно с эталоном. Качественный вывод устойчив: **три независимые серии** дали одно и то же — рост числа реплик при фиксированном бюджете не помогает (первая: +3 % на двух, −9 % на четырёх; вторая: −7 % и −8 %; третья, чистая: −3.3 % и −5.1 %).
### Где насыщение
Потолок закрытого цикла на этой машине — **≈1 300–1 550 RPS подтверждённых записей**, и ни одна ручка стенда его не двигает:
| что меняли | как проверено | результат |
| --- | --- | --- |
| число API-реплик 1 → 2 → 4 при неизменном суммарном бюджете | серия 1 | −3.3 % и −5.1 % |
| суммарный бюджет API 0.5 → 1.0 → 1.5 CPU | серия 2 | +0.1 % (плоско) |
| бюджет CPU PostgreSQL 0.50 → 1.00 | перемежающий контроль | +0.04 % |
| бюджет CPU балансировщика 0.25 → 1.00 | перемежающий контроль | −0.02 % |
| пул соединений реплики 10 → 5 | пара профилей при 4 репликах | −7 % (хуже) |
| клиент на хосте вместо клиента внутри VM | `evidence/path-overhead/` | тот же RPS (1 539 против 1 475) |
| 32 клиента вместо 8 | `evidence/load-32clients.txt` | 1 284 RPS, p95 растёт до 52.8 мс |
Измерениями исключены: **клиент** (тот же закрытый цикл по тривиальному серверу на хосте даёт 4 469 RPS без отказов), **путь «хост → проброс порта → VM»** (клиент внутри VM даёт ту же пропускную способность), **квоты CPU PostgreSQL и LB** (перемежающий контроль: ±0.05 % при лимитах, проверенных по `docker inspect`), **размер пула** (19–22 соединения из 100; меньший пул только вредит). Сами сервисы при этом недогружены: реплики вместе берут 0.24–0.31 ядра из бюджета 1.0, PostgreSQL — 0.35–0.39 из 0.50, LB — 0.10 из 0.25 (в `docker stats` 100 % = одно ядро, проверено отдельным экспериментом: `evidence/quota-semantics.txt`).
Значит упор не в бюджет и не в число процессов, а в стоимость одной записи: сообщение — это транзакция из трёх обращений к БД (claim ключа идемпотентности, вставка сообщения, запись `message_id`), плюс проверка участников чата и работа с кэшем списка чатов, и всё это на 2 vCPU. Гипотеза следующего шага: сократить путь записи до двух обращений (вставка сообщения и upsert ключа в одной транзакции, конфликт — откат и повторное чтение) и перемерить перемежающим контролем. Числа сняты на одной конфигурации одиночными прогонами закрытого цикла, поэтому это не «предельная ёмкость системы»: на другом Docker-host потолок будет иным (см. «Ограничения»).
### Подтверждённое улучшение и проверенные гипотезы
**Подтверждено (измерено до/после):** балансировщик перестал отправлять трафик неготовой реплике. `scripts/lb_readiness_check.sh` поднимает рядом с рабочими репликами третью с тем же сетевым alias, но её доступ к БД идёт через временный TCP-прокси; после остановки прокси реплика остаётся доступной по сети, её `/health/ready` отвечает 503.
| Вариант LB | запросов неготовой реплике из 40 | статус в LB | запись через LB |
| --- | --- | --- | --- |
| пассивные проверки (nginx OSS, до правки) | 20 из 40 `/health/live` и бизнес-запросы (зафиксировано в ревью) | продолжает обслуживать | 503 и 200 вперемешку |
| активные проверки (HAProxy, `httpchk /health/ready`, `inter 2s fall 2 rise 2`, `timeout check 1s`) | **0 из 40** | `DOWN` **через 2 с** (измерено) | 1 163 RPS, 0 ошибок (`evidence/lb-readiness.txt`) |
Вместе с этим убраны две связанные проблемы: прозрачный повтор POST (`proxy_next_upstream ... non_idempotent` мог повторить создание чата) заменён на `retry-on conn-failure`, а недоступная реплика убирается из ротации полностью, а не «на 3 секунды». Сценарий rolling update проходит под нагрузкой: 97 359 подтверждённых записей, 3 переходные ошибки (0.003 %), `restarts=0` (`evidence/rolling-update/after/`, где каждый шаг подтверждён сменой образа новой реплики и числом UP-слотов).
**Дефект доказан, эффект его устранения — нет.** Архитектурная ошибка унаследованного `Dockerfile` (`ARG TARGETARCH=amd64`, а классический builder платформу не подставляет → x86-64 бинарник в arm64-образе) подтверждена ELF-заголовками (`evidence/arch.txt`): `e_machine=0x3e` против `0xb7`. Но контролируемое сравнение **не подтвердило**, что именно она вызывала прежние runtime-фаталы: прогон rolling update на эмулируемом образе завершился без ошибок — 89 560 успешных запросов за 45 с, 0 ошибок, 0 ответов 5xx (`evidence/rolling-update/emulated/load.json`). Падения (`fatal error: found pointer to free object`, `sync: inconsistent mutex state`, crash-loop реплик) наблюдались в других условиях и в приложенный A/B не попали. Корректная формулировка: эмуляция x86-64 на arm64 — доказанный дефект сборки, который устранён, но его вклад в те падения не измерен.
**Проверено измерениями (перемежающий контроль, лимиты подтверждены по `docker inspect`):** ни бюджет CPU PostgreSQL (0.50 → 1.00), ни бюджет CPU балансировщика (0.25 → 1.00) не меняют пропускную способность (+0.04 % и −0.02 %), поэтому потолок закрытого цикла на этой машине задаёт не нехватка ресурсов у БД или LB. Пул соединений 10 → 5 при четырёх репликах оказался хуже на 7 % — меньший пул не улучшение, а потеря.
**Следующий шаг для измерения:** сократить число обращений к БД на одно сообщение — сейчас их три (claim ключа, вставка сообщения, запись `message_id`), нужно два (вставка сообщения + upsert ключа в той же транзакции, конфликт — через откат и повторное чтение). Гипотеза: меньше round-trip и меньше версий строк. Эффект измеряется тем же способом, что и бюджеты, — перемежающим контролем (`scripts/track1_controls.sh`: эталон → изменение → эталон), потому что собственный дрейф серии сопоставим с ожидаемым выигрышем.
## Ограничения и следующие шаги
Решение выдерживает конкурентные запросы внутри одного процесса и корректный SIGTERM. Оно не сохраняет состояние после перезапуска и не рассчитано на несколько API-процессов. Авторизация через `X-User-Id` является учебным механизмом lab1 и не является безопасной аутентификацией. Persistence, внешняя база и горизонтальное масштабирование не реализованы.
## Кэш Redis (lab2, оценка 4 и трек 1 оценки 5)
### Источник истины и роли Redis
PostgreSQL — источник истины для пользователей, чатов, членства, сообщений и сессий. Сессии хранятся только в PostgreSQL: `Resolve` по `token_hash` — это дешёвый lookup по первичному ключу, поэтому отдельный кэш сессий не используется, а отзыв всегда авторитетен (нет рассогласования кэша и БД). Redis 7.4 используется для двух задач:
1. **Кэш первой страницы списка чатов** (read-through + stampede protection): кэшируется только `ListVisible(after == nil)`; более глубокие страницы обслуживаются напрямую из PostgreSQL.
2. **Распределённая координация загрузки** (distributed lock), чтобы при нескольких репликах холодный ключ грузила только одна.
Реализация — декоратор `internal/storage/redis/chat_repository.go` над интерфейсом `chat.Repository`.
### Конфигурация и отключение
- `REDIS_ENABLED=false` — Redis не подключается; список чатов обслуживается напрямую из PostgreSQL.
- `CACHE_ENABLED=false` — кэш списка чатов выключен. `CACHE_ENABLED=true` при `REDIS_ENABLED=false` даёт ошибку конфигурации.
- `CACHE_CHAT_LIST_TTL` (по умолчанию `5m`) — TTL записей списка чатов.
- `CACHE_LOCK_TTL` (по умолчанию `10s`) и `CACHE_LOCK_WAIT_TIMEOUT` (по умолчанию `2s`) — TTL распределённой блокировки и бюджет ожидания лидера.
- `REDIS_DIAL_TIMEOUT` (по умолчанию `300ms`), `REDIS_READ_TIMEOUT`/`REDIS_WRITE_TIMEOUT` (по умолчанию `200ms`), `REDIS_MAX_RETRIES` (по умолчанию `-1`). Короткие таймауты и отсутствие ретраев (`-1`, а не `0` — у go-redis `0` включает дефолтные 3 ретрая) не дают «замороженному» Redis подвешивать API.
- Бюджет кэш-фазы `500ms` (константа декоратора) ограничивает ожидание вызывающего; по истечении — fallback в PostgreSQL.
- `SESSION_TTL_SECONDS` (по умолчанию `3600`) — TTL серверной сессии; контрактное имя переменной, читается напрямую.
- Redis настроен с `--appendonly yes --appendfsync everysec --save 60 1` и named volume, поэтому переживает рестарт хранилища.
- Переменные окружения без префикса (`SERVER_*`, `LOG_*`, `POSTGRES_*`, `REDIS_*`, `CACHE_*`, `SESSION_TTL_SECONDS`), что соответствует 12-factor.
### Инвалидация
Версия списка чатов хранится в **PostgreSQL** (`user_chat_versions`) и увеличивается в **той же транзакции**, что и вставка чата и участников. Ключ кэша — `chat_list:<user>:<version>:<limit>`, где версия читается из источника перед обращением к кэшу (`ListVersion`). Сигнал об устаревании больше не живёт в Redis, поэтому его потеря невозможна: даже если Redis недоступен в момент создания чата, версия в PostgreSQL уже увеличена, и следующий `ListVisible` читает новый ключ (промах → свежий список). Старые записи под прежней версией становятся недостижимыми и истекают по TTL; персистентность Redis на корректность не влияет.
Порядок «сначала версия, потом данные»: данные под ключом версии v загружаются после чтения v, поэтому могут быть свежее v, но не старше. Гонка даёт лишний промах на следующем запросе, но не устаревшую выдачу.
Для защиты от deadlock вход `BumpChatListVersions` сортируется (`ORDER BY m` и Go-сортировка) и дедуплицируется (`DISTINCT`/`slices.Compact`): параллельные транзакции с пересекающимися участниками берут эксклюзивные блокировки строк `user_chat_versions` в одном порядке. В `AddChatMembers` передаётся исходный список участников, поэтому дубликаты по-прежнему дают `409 conflict`, как и раньше.
### Деградация при потере Redis
- `ChatRepository.ListVisible`: ошибка **кэша** (Redis недоступен, таймаут ожидания, битая запись) → прямой запрос в PostgreSQL; 503 от кэша не возвращается.
- Ошибка **источника** (PostgreSQL) пробрасывается клиенту без повторного запроса — декоратор различает ошибку источника и ошибку кэша, поэтому упавшая БД не получает удвоенную нагрузку.
- `GET /health/ready` проверяет PostgreSQL через агрегатор `internal/health`. Redis не является критичной зависимостью: при его потере кэш обходится через PostgreSQL, а readiness остаётся успешным.
- Сессии и авторизация не зависят от Redis: `Resolve` всегда читает PostgreSQL, поэтому отозванный, истёкший или анонимный токен даёт `401` независимо от состояния Redis.
**Проверка деградации** (`scripts/redis_outage_check.sh` → `evidence/cache/redis-outage.txt`): скрипт останавливает и «замораживает» (`docker pause`) Redis, проверяет бюджет по времени и статусы, создаёт чат во время `pause` и подтверждает, что после `unpause` список содержит новый чат. Результат прогона: baseline 6 ms; после `docker stop` 476 ms; 30 параллельных `GET /chats` при `docker pause` — max 215 ms, p95 214 ms (бюджет 2000 ms); создание чата при `pause` = 201; после восстановления новый чат виден за 5 ms; зависших `lock:*` без TTL нет.
### Трек 1: согласованность кэша
**Гипотеза.** При холодном кэше N одновременных чтений первой страницы вызывают N SQL-запросов к PostgreSQL (cache stampede).
**Решение.** Два уровня координации, работающие при любом числе реплик:
1. **Внутри процесса** — `singleflight.Group.DoChan` по ключу кэша. Все горутины пода, промахнувшиеся по одному ключу, объединяются в одну операцию; результат клонируется перед возвратом, потому что слайс общий. Это убирает сотни лишних походов в Redis на горячем ключе и раздаёт ошибку `loader` всем ожидающим, не усиливая нагрузку на упавшую БД внутри пода. Контекст загрузки не отменяется при отмене вызывающего (`context.WithoutCancel` + общий таймаут `lock_ttl + lock_wait_timeout`).
2. **Между процессами** — распределённая блокировка Redis `SET NX EX` (ключ `lock:<cache-key>`) с уникальным токеном на каждый захват (TTL `cache.lock_ttl`, по умолчанию 10s). Победитель делает double-check, грузит данные и снимает лок атомарным Lua compare-and-delete; удалить можно только свой захват.
**Дедлайн загрузки.** `loader` выполняется с дедлайном `lock_ttl − 1s`; `ReleaseLock` возвращает признак «лок был наш», поэтому если загрузка превысила TTL, в лог пишется предупреждение `lock expired before release: loader slower than lock ttl`. Конструктор отвергает конфигурацию с `lock_ttl ≤ 1s` и `wait_timeout > lock_ttl`.
**Ожидание и таймаут.** Проигравшие сначала проверяют кэш без сна, затем опрашивают его с экспоненциальным backoff и jitter (50, 100, 200, 400, 500 ms, cap 500). Исход ожидания явный: `waitHit`, `waitRetry` (лок исчез без значения → повторить захват), `waitDegraded` (Redis недоступен → прямая загрузка), `waitTimeout` (держатель держит лок дольше `cache.lock_wait_timeout`). И `waitDegraded`, и `waitTimeout` ведут к прямой загрузке из источника: кэш не должен ронять чтение, когда источник истины доступен.
Параметры координации задаются через конфиг (`cache.lock_ttl`, `cache.lock_wait_timeout`) и env `CACHE_LOCK_TTL`, `CACHE_LOCK_WAIT_TIMEOUT`, что соответствует 12-factor.
Реализация: `internal/platform/cache/distributed.go` (`DistributedCache`), примитивы блокировки — `AcquireLock`/`ReleaseLock`/`LockHeld` в `RedisCache` (`internal/platform/cache/redis.go`).
**Методика.** Интеграционный тест `internal/storage/redis/chat_repository_test.go` использует реальный Redis и сгенерированный мок источника; ожидания мока фиксируют, что источник вызван ровно один раз.
**Результат** (`evidence/cache/consistency.txt`):
| Сценарий | Нагрузка | Обращений к источнику |
| --- | ---: | ---: |
| Наивный cache-aside без координации | 100 одновременных холодных чтений | 96–100 |
| `DistributedCache` (один инстанс) | 100 одновременных холодных чтений | 1 |
| `DistributedCache` (3 экземпляра, общий Redis) | 3 × 30 одновременных холодных чтений | 1 |
Строка с тремя экземплярами — доказательство координации через Redis: три независимых объекта `DistributedCache` (каждый со своим токеном блокировки) работают с общим Redis и дают ровно одну загрузку из PostgreSQL. Это тест нескольких логических инстансов в одном процессе; координация вынесена в Redis, поэтому она не зависит от локальной памяти процесса и работает для реальных реплик. Отдельный cross-process сценарий с несколькими контейнерами API не запускался.
**Read-after-write.** `TestCreateInvalidatesMemberCaches` (декоратор) и `TestCreateBumpsMemberListVersions` (Postgres): после `POST /chats` версия списка увеличивается у создателя и всех участников в той же транзакции, поэтому следующий `GET /chats` у обоих сразу видит новый чат — и на прогретом кэше, и после недоступности Redis.
**Восстановление после сброса кэша.** `TestEvictedCacheEntryReloadsFromSource` в `chat_repository_test.go`: после удаления записи из Redis следующее чтение перезагружает данные из PostgreSQL. `TestResolveRejectsExpiredToken` (postgres) подтверждает, что истёкшая сессия отклоняется.
**Persistence.** `make test-persistence ACTION_SCRIPT=scripts/restart.sh` проходит: API и все хранилища (PostgreSQL, Redis) перезапускаются с сохранением volumes, подтверждённые данные и действующая сессия сохраняются.
### Эксперимент на уровне репозитория: SQL-запросы и latency
Команда: `./scripts/cache_performance_experiment.sh`. Сырые результаты: `evidence/cache/performance.txt`.
`TestCachePerformanceExperiment` работает на реальных PostgreSQL и Redis: 150 чатов, concurrency 50, по 10 000 запросов на режим. Baseline выполняет 10 000 SQL-запросов, `DistributedCache` на холодном кэше делает ровно 1 загрузку, горячий кэш — 0.
| Режим | SQL-запросов | RPS | p50 | p95 | p99 |
| --- | ---: | ---: | ---: | ---: | ---: |
| Baseline (no cache) | 10,000 | 6,742 | 7.23ms | 9.14ms | 11.26ms |
| Redis cache (cold) | 1 | 11,886 | 4.07ms | 5.67ms | 6.56ms |
| Redis cache (hot) | 0 | 12,600 | 3.87ms | 5.02ms | 5.84ms |
Таблица показывает арифметические средние метрик трёх прогонов из `performance.txt`; средние p95/p99 не являются процентилями объединённой выборки.
### API-эксперимент: Redis-кэш под нагрузкой
Команда: `./scripts/api_cache_performance.sh`. Сырые результаты: `evidence/cache/api-performance.txt`.
Создаются 4 пользователя и 60 чатов: каждый пользователь владеет 15 чатами и входит ещё в чаты соседнего пользователя. Для каждого режима выполняется 1000 GET-запросов `GET /api/v1/chats?limit=50` с 8 конкурентными worker'ами. Перед запросами пользователи проходят регистрацию и Basic → Bearer-аутентификацию. API пересоздаётся с `CACHE_ENABLED=false` и `CACHE_ENABLED=true`; PostgreSQL, Redis и volumes сохраняются. Выполнено два последовательных прогона каждого режима.
| Прогон | Режим | Requests | Workers | RPS | p50 | p95 | p99 |
| --- | --- | ---: | ---: | ---: | ---: | ---: | ---: |
| 1 | Cache disabled | 1000 | 8 | 2,193 | 3.34ms | 5.24ms | 7.38ms |
| 1 | Redis cache | 1000 | 8 | 2,353 | 3.08ms | 5.36ms | 6.62ms |
| 2 | Cache disabled | 1000 | 8 | 1,971 | 3.68ms | 6.22ms | 8.55ms |
| 2 | Redis cache | 1000 | 8 | 2,430 | 2.92ms | 5.48ms | 7.25ms |
Среднее: RPS вырос с **2,082 до 2,391 (+15%)**; p50 снизился с **3.51 до 3.00ms (-15%)**; p95 — с **5.73 до 5.42ms (-5%)**; p99 — с **7.97 до 6.93ms (-13%)**. Это black-box измерение полного HTTP-пути: маршрутизация, Bearer-аутентификация, PostgreSQL/Redis, сериализация JSON и сеть. Прирост меньше, чем в repo-эксперименте, потому что кэшированный путь теперь делает один дополнительный indexed-read версии списка в PostgreSQL на запрос. Сессии в обоих режимах хранятся в PostgreSQL; переключается только кэш списка чатов.
### Ограничения
- `cache.lock_wait_timeout` — бюджет ожидания для одного вызова. Перед polling выполняется немедленная проверка кэша; если значение ещё не появилось, следующий опрос происходит через 50 ms со случайным jitter.
- Бюджет кэш-фазы `500ms` ограничивает ожидание вызывающего в `GetOrLoad`; по истечении клиент уходит в PostgreSQL, а фоновая загрузка (`context.WithoutCancel`) всё равно дорабатывает и заполняет кэш. Цена: при обрыве бюджета возможен второй запрос в PostgreSQL (дублирование). Бюджет заметно больше типичной латентности загрузки (<100 ms), поэтому на штатном пути не срабатывает.
- Хвост `fill` после получения данных (синхронные `Set` ≤200 ms + `ReleaseLock` ≤300 ms) при blackhole может удерживать ответ до 500 ms; горутины для отложенного релиза не вводятся, чтобы не усложнять остановку сервиса.
- Худший случай Redis-таймаутов на один запрос при частичной деградации — порядка `Get + AcquireLock + fill Get + Set + Release` (≈1.4 s); при полном blackhole первый же `Get` упирается в `read_timeout` (200 ms) и уходит в PostgreSQL.
- Ошибки кэша (недоступный Redis, таймаут ожидания, битая запись) деградируют в прямой запрос к PostgreSQL; 503 от кэша не возвращается. Ошибка самого PostgreSQL пробрасывается клиенту без повторного запроса, чтобы не удваивать нагрузку на упавшую БД.
- Битая запись кэша удаляется сразу при `Unmarshal`-ошибке, чтобы не гонять мусор до истечения TTL.
- Ошибки источника не кэшируются. Внутри пода их раздаёт `singleflight`, поэтому усиление ограничено одним обращением на под; между подами распределённая блокировка не заменяет circuit breaker, и при недоступности БД возможно дополнительное обращение на реплику.
- Каждый `ListVisible(after == nil)` читает версию списка из PostgreSQL (один indexed-read); это цена согласованности кэша с источником истины.
- Кэшируется только первая страница списка чатов; это осознанный компромисс (основная доля чтений).
- Ключ включает `limit`, поэтому разные `limit` не переиспользуют запись.
- Дедупликация загрузок (`DistributedCache`) не зависит от локальной памяти процесса: координация вынесена в Redis. При недоступности Redis она теряется: каждый под загружает данные самостоятельно (stampede возвращается), но запросы продолжают обслуживаться — осознанный graceful degradation.
- Если загрузка лидера превышает `cache.lock_ttl`, блокировка истекает и другая реплика может начать параллельную загрузку. Продление блокировки (watchdog) и fencing не реализованы; `loader` ограничен дедлайном `lock_ttl − 1s`, и превышение фиксируется предупреждением `lock expired before release`.
- Сессии хранятся только в PostgreSQL и не кэшируются: `Resolve` по `token_hash` — дешёвый lookup по первичному ключу, а отзыв всегда авторитетен (нет рассогласования кэша и БД).
- Ключи старой схемы `chat_gen:*` (писались без TTL) больше не читаются; их можно удалить разово. Все актуальные ключи (`chat_list:*`, `lock:*`) создаются с TTL и самоочищаются.
- **Архитектура образа (главная находка этапа отладки).** Унаследованный `Dockerfile` содержал `ARG TARGETARCH=amd64`, а классический builder платформу не подставляет — в arm64-образ попадал x86-64 бинарник (`e_machine=0x3e` против `0xb7` у busybox базового образа; в стеке паники видно `runtime/asm_amd64.s`). Пока нагрузка была низкой, эмуляция справлялась; под нагрузкой Go runtime падал с `fatal error: found pointer to free object`, `sync: inconsistent mutex state`, `bad pointer in Go heap`, `runtime: name offset base pointer out of range` — и это выглядело как проблема приложения. Контрольный эксперимент снял подозрения с кода: тот же исходник, собранный нативно (вне Docker, против локальной БД), выдержал 90 с при 32 клиентах — 220 781 запрос, 0 ошибок, p50 12.5 мс, p95 17.5 мс, p99 22.4 мс, 2 452 успешных RPS (`evidence/native-load.txt`), тогда как контейнерный стенд через LB даёт ≈1 300–1 700 RPS. После исправления (`ARG TARGETARCH` без значения по умолчанию, кросс-сборка — явным `--build-arg`) стенд стабилен, однако строгий A/B связь с прежними падениями не подтвердил (см. «Подтверждённое улучшение»). Если вы собираете под другую платформу, задавайте `TARGETOS`/`TARGETARCH` явно.
- **Ресурсы VM.** Colima (macOS Virtualization.framework) даёт 2 vCPU и ≈1.9 GiB RAM: сборка образа была один раз убита OOM, поэтому компилятор ограничен `GOFLAGS=-p=2`, а бюджеты экспериментов трека 1 подобраны под VM (1.0 CPU суммарно на API), иначе измеряется не масштабирование, а нехватка ресурсов.
- **Измерения трека 1 не переносятся на другую машину.** Все числа получены на одной конфигурации (Docker VM: 2 vCPU, ≈1.9 GiB; хост: 18 ядер) одиночными прогонами закрытого цикла, поэтому это не «пропускная способность системы», а точки одного профиля на конкретном стенде: на другом Docker-host и потолок, и точка насыщения будут иными, а сравнивать между собой можно только профили одной серии.
- **Что означает CPU% в `docker stats`.** Проверено экспериментом: контейнер, упёртый в `--cpus 0.5` (`cpu.max = 50000 100000`), показывает 49.49 %, то есть процент считается от одного ядра и 50 % = полная квота 0.5 CPU (`evidence/quota-semantics.txt`). Прежняя оговорка отчёта о «заниженных» значениях снята: колонки читаются однозначно.
- **Проброс порта хоста не выдерживает нагрузку генератора.** `tests/load.py` ходит без keep-alive (новое TCP-соединение на запрос). Клиент на хосте получает отказы соединения от проброса порта: в контроле `evidence/path-overhead/` тот же профиль дал 26 % отказов при клиенте на хосте и 0 % при клиенте внутри VM и тот же RPS. Точечный пробник из 40 000 быстрых подключений подряд получил 38 706 `ECONNREFUSED`, а прогон на ~4 500 соединений/с оставил проброс порта (вместе с доступом к Docker-эндпоинту Colima) неработоспособным до `colima restart`. Стенд при этом не падал: в прогонах с клиентскими отказами балансировщик отдал все запросы без 5xx, а логи API не содержат ни одной ошибки (сценарии отказа, персистентности и rolling update снимались клиентом на хосте раньше и прошли с 0-3 отказами — там темп новых соединений был ниже, чем в серии трека 1). Поэтому серия трека 1 снимается клиентом внутри VM.
- **«Потолок задаёт проброс порта» — опровергнуто измерением.** Прежняя формулировка объясняла потолок ≈1 500 RPS виртуализацией и пробросом порта. Контроль с клиентом внутри VM даёт ту же пропускную способность (1 475 против 1 539 RPS, различия в пределах разброса) вообще без проброса, значит этот путь потолок не задаёт; клиент тоже не потолок — тот же закрытый цикл по тривиальному локальному серверу даёт 4 469 RPS. Нативная оценка 2 452 RPS снята другим генератором, на хосте с 18 ядрами и против локальной БД, поэтому она не изолирует причину: отличается и доступный CPU, и способ подачи нагрузки. Корректная формулировка: узкое место — внутри стенда (путь записи сообщения), а не в виртуализации.
- **Окно обнаружения отказа.** Готовность проверяется активно (`httpchk /health/ready`, период 2 с, `fall 2`, `timeout check 1s`) — измеренное время перехода реплики в `DOWN` после потери БД: **2 с** (`evidence/lb-readiness.txt`); теоретическая верхняя граница ~4 с. Между фактическим отказом и первой неудачной проверкой реплика ещё получает трафик, поэтому клиент может увидеть 503 от неё или ошибку соединения — в измеренных сценариях это единичные переходные ошибки (0–2 %), они учтены в таблицах отказа.
- **Строгая проверка «до/после» по архитектуре не удалась.** Исходный дефект сборки доказан (ELF-заголовки), но воспроизвести падения в контролируемом A/B не удалось: эмулируемый образ в коротком прогоне тоже прошёл без ошибок. Считать эффект устранения измеренным нельзя.
- **Переходные ошибки при смене состава реплик.** HAProxy не повторяет уже отправленный POST (осознанно: прозрачный повтор неидемпотентной операции запрещён контрактом), а переиспользуемые соединения к снятому контейнеру рвутся — поэтому в момент замены или масштабирования клиент может увидеть единичный 502: ≤0.25 % в сериях трека 1 и 0.003 % в rolling update. Неопределённый результат клиент повторяет сам, и для сообщений это безопасно благодаря `Idempotency-Key`.
- Один Docker-host: эксперименты показывают отказ **процесса** API, но не отказ узла. Потеря хоста, а также LB, PostgreSQL и Redis остаются единичными точками отказа; выживание узла БД не заявлено.
- PostgreSQL не реплицирована, Redis не кластеризован — при их отказе стенд недоступен, это честное учебное упрощение.
- Генератор нагрузки `tests/load.py` — closed-loop: он ограничен клиентом и страдает coordinated omission, поэтому измеренный RPS — это пропускная способность HTTP-подтверждений, а не предельная ёмкость системы. Для серьёзных выводов нужен k6/Locust или свой open-loop генератор.
- **Принятые риски (осознанно, вне объёма ЛР3).** Пароли хешируются Argon2id с 64 МиБ памяти на хеш, а ограничителя частоты нет: 4–5 одновременных регистраций на реплику с бюджетом 256 МиБ могут её выбить, а перебор паролей не throttled. Контракт делает `429` факультативным, защита вынесена в ЛР7 по карте курса; предел размера тела при этом закрыт (см. выше). Страница оператора HAProxy доступна без аутентификации, но только на loopback. `docker-compose.local.yaml` (локальная разработка из ЛР2) публикует PostgreSQL и Redis на 127.0.0.1 с синтетическим паролем — для стенда ЛР3 не используется. `X-Request-ID` принимается от клиента как есть: это нужно для сквозной корреляции, подделка значения искажает только аудит, инъекция в лог невозможна (Go запрещает переводы строк в заголовках, лог пишется JSON). `Makefile` экспортирует `-include .env` в окружение рецептов — при синтетических значениях это безопасно.
- Записи идемпотентности не удаляются фоновым процессом: истёкшие строки занимаются лениво при повторном использовании ключа, остальные ждут будущей уборки (индекс `expires_at` уже есть).
+2 -1
View File
@@ -50,7 +50,7 @@ func run(cfg config.Config, log *slog.Logger) error {
ctx, stop := signal.NotifyContext(context.Background(), syscall.SIGINT, syscall.SIGTERM)
defer stop()
store, err := postgres.New(ctx, cfg.Postgres)
store, err := postgres.New(ctx, cfg.Postgres, time.Duration(cfg.Idempotency.TTLSeconds)*time.Second)
if err != nil {
return fmt.Errorf("connect database: %w", err)
}
@@ -103,6 +103,7 @@ func run(cfg config.Config, log *slog.Logger) error {
),
rest.NewSecurityHandler(sessionService),
log,
cfg.Server.MaxBodyBytes,
)
if err != nil {
return fmt.Errorf("build router: %w", err)
+2 -1
View File
@@ -1,10 +1,11 @@
# Topology worksheet, deliberately NOT a runnable stack (no application supplied).
# Implement compose.yaml or stack.yaml; do not submit this empty file as deployment.
# Service names below are logical roles, not imposed container names.
x-lab-number: 2
x-lab-number: 3
x-required-roles:
- api
- postgres
- load_balancer
# TODO: implement real images/builds, network wiring, volumes, healthchecks,
# credentials and bootstrap. Details: contracts/infrastructure.json and README.md.
services: {}
+173
View File
@@ -0,0 +1,173 @@
# Lab3 stand: two API replicas behind a HAProxy load balancer.
#
# cp -n .env.example .env
# docker compose --env-file .env up -d --build
# curl http://localhost:8080/health/ready
#
# Only the load balancer is published (127.0.0.1). Stores and API replicas are
# reachable from the host via `docker compose exec` / `docker compose logs`.
# No container_name anywhere: replica hostnames stay the short container IDs,
# which the application reports back as X-Instance-Id.
name: mtusi-messenger-lab3
x-app: &app
build:
context: .
dockerfile: Dockerfile
image: mtusi-messenger:lab3
services:
postgres:
image: postgres:18-alpine@sha256:77f585114c32fbca283dc835b0596f4e52b51b4c6662d7810b2f4084f60a1873
environment:
POSTGRES_USER: ${POSTGRES_USER:-messenger}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-messenger}
POSTGRES_DB: ${POSTGRES_DB:-messenger}
volumes:
- postgres18-data:/var/lib/postgresql
healthcheck:
test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
interval: 5s
timeout: 5s
retries: 10
start_period: 5s
deploy:
resources:
limits:
# Saturation point of the stand (see REPORT.md, track 1): the database
# runs at its quota while API replicas idle. Raise this knob to give the
# shared dependency more of the host CPU.
cpus: "${POSTGRES_CPU_LIMIT:-0.50}"
memory: ${POSTGRES_MEM_LIMIT:-384M}
restart: unless-stopped
redis:
image: redis:7.4-alpine
command:
- redis-server
- --appendonly
- "yes"
- --appendfsync
- everysec
- --save
- "60"
- "1"
volumes:
- redis7-data:/data
healthcheck:
test: ["CMD", "redis-cli", "ping"]
interval: 5s
timeout: 3s
retries: 10
start_period: 3s
deploy:
resources:
limits:
cpus: "0.25"
memory: 192M
restart: unless-stopped
# One-shot schema bootstrap; runs once to completion before any API replica.
migrate:
<<: *app
entrypoint: ["/usr/local/bin/migrate"]
command: ["up"]
environment:
APP_CONFIG: /etc/messenger/dev/config.yaml
POSTGRES_HOST: postgres
POSTGRES_PORT: "5432"
POSTGRES_DATABASE: ${POSTGRES_DB:-messenger}
POSTGRES_USER: ${POSTGRES_USER:-messenger}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-messenger}
POSTGRES_SSL_MODE: disable
depends_on:
postgres:
condition: service_healthy
deploy:
resources:
limits:
cpus: "0.50"
memory: 256M
# One-shot: healthcheck из образа (проверка /health/live) для него бессмыслен.
healthcheck:
disable: true
restart: "no"
api:
<<: *app
# Общий сетевой alias: LB резолвит одно имя в адреса всех реплик, поэтому
# масштабирование и замена контейнеров не зависят от их номеров/ID.
networks:
default:
aliases:
- api-replica
env_file:
- path: .env
required: false
# Explicit values win over localhost defaults coming from .env (see .env.example).
environment:
APP_CONFIG: /etc/messenger/dev/config.yaml
POSTGRES_HOST: postgres
POSTGRES_PORT: "5432"
POSTGRES_DATABASE: ${POSTGRES_DB:-messenger}
POSTGRES_USER: ${POSTGRES_USER:-messenger}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-messenger}
POSTGRES_SSL_MODE: disable
REDIS_ENABLED: "true"
REDIS_HOST: redis
REDIS_PORT: "6379"
CACHE_ENABLED: "true"
# Размер пула соединений ОДНОЙ реплики; общий расход = реплики × значение.
# Это один из общих ресурсов, который масштабирование расходует первым.
POSTGRES_MAX_CONNS: "${POSTGRES_MAX_CONNS:-10}"
deploy:
replicas: ${API_REPLICAS:-2}
resources:
limits:
cpus: "${API_CPU_LIMIT:-0.50}"
memory: ${API_MEM_LIMIT:-256M}
# The app drains on SIGTERM within SERVER_SHUTDOWN_TIMEOUT; keep the grace
# period above it so Docker does not SIGKILL an in-flight request.
stop_grace_period: 15s
depends_on:
postgres:
condition: service_healthy
redis:
condition: service_healthy
migrate:
condition: service_completed_successfully
healthcheck:
test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1:8080/health/ready"]
interval: 10s
# Готовность проверяет PostgreSQL (критичную зависимость; кэш деградирует
# безопасно): под насыщающей нагрузкой ответ может подойти к секундам, и
# слишком строгий таймаут помечает занятую, но работающую реплику как
# unhealthy.
timeout: 5s
retries: 6
start_period: 5s
restart: unless-stopped
# Public entry point. Active /health/ready probes remove a not-ready replica from
# rotation entirely; infra/lb/haproxy.cfg holds the upstream, checks and retries.
lb:
image: haproxy:3.2-alpine
volumes:
- ./infra/lb/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro
ports:
- "127.0.0.1:${SERVER_PORT:-8080}:80"
# Operator-only stats page on loopback: shows which replica is UP/DOWN and why.
- "127.0.0.1:${LB_STATS_PORT:-8404}:8404"
depends_on:
api:
condition: service_healthy
deploy:
resources:
limits:
cpus: "${LB_CPU_LIMIT:-0.25}"
memory: 64M
restart: unless-stopped
volumes:
postgres18-data:
redis7-data:
+7
View File
@@ -5,6 +5,9 @@ server:
port: 8080
read_header_timeout: 10s
shutdown_timeout: 10s
# Предел размера тела запроса; JSON API ЛР3 укладывается в сотни килобайт,
# а загрузка вложений ЛР4 (до 10 MiB) поднимает это значение явно.
max_body_bytes: 262144
log:
level: info
@@ -45,3 +48,7 @@ cache:
session:
ttl_seconds: 3600
# Retention of a message Idempotency-Key; contract 1.3.0 requires ≥ 24 h.
idempotency:
ttl_seconds: 86400
+7 -2
View File
@@ -1,10 +1,10 @@
{
"lab": 2,
"lab": 3,
"kind": "requirements, not runnable deployment",
"required_for_grade_3": [
{
"role": "api",
"count_min": 1,
"count_min": 2,
"student_implements": true,
"persistent_local_state": false
},
@@ -12,6 +12,11 @@
"role": "postgres",
"purpose": "users/chats/membership/messages/metadata",
"persistent_volume": true
},
{
"role": "load_balancer",
"public_entrypoint": true,
"backend_readiness": true
}
],
"optional_components": [
+504 -2
View File
@@ -1,8 +1,8 @@
{
"openapi": "3.1.0",
"info": {
"title": "MTUSI Messenger — лабораторная 2",
"version": "1.2.0",
"title": "MTUSI Messenger — лабораторная 3",
"version": "1.3.0",
"description": "Нормативный минимум на 3. Семантика: contracts/README.md. Расширения на 4/5 не должны менять этот API. Наличие кода ошибки в схеме не требует реализовать факультативную причину его выдачи."
},
"servers": [
@@ -31,6 +31,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -50,6 +57,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -78,6 +92,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -97,6 +118,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -116,6 +144,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -144,6 +179,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -163,6 +205,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -182,6 +231,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -202,6 +258,13 @@
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
},
"Retry-After": {
"description": "Положительное число секунд.",
"schema": {
@@ -227,6 +290,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -246,6 +316,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -284,6 +361,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -303,6 +387,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -323,6 +414,13 @@
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
},
"WWW-Authenticate": {
"description": "Basic realm=\"messenger\", charset=\"UTF-8\" для входа; Bearer realm=\"messenger\" для защищённого API lab2+.",
"schema": {
@@ -347,6 +445,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -366,6 +471,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -386,6 +498,13 @@
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
},
"Retry-After": {
"description": "Положительное число секунд.",
"schema": {
@@ -411,6 +530,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -430,6 +556,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -457,6 +590,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -476,6 +616,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -496,6 +643,13 @@
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
},
"WWW-Authenticate": {
"description": "Basic realm=\"messenger\", charset=\"UTF-8\" для входа; Bearer realm=\"messenger\" для защищённого API lab2+.",
"schema": {
@@ -520,6 +674,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -539,6 +700,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -559,6 +727,13 @@
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
},
"Retry-After": {
"description": "Положительное число секунд.",
"schema": {
@@ -584,6 +759,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -603,6 +785,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -638,6 +827,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -657,6 +853,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -677,6 +880,13 @@
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
},
"WWW-Authenticate": {
"description": "Basic realm=\"messenger\", charset=\"UTF-8\" для входа; Bearer realm=\"messenger\" для защищённого API lab2+.",
"schema": {
@@ -701,6 +911,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -720,6 +937,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -740,6 +964,13 @@
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
},
"Retry-After": {
"description": "Положительное число секунд.",
"schema": {
@@ -765,6 +996,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -784,6 +1022,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -831,6 +1076,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -850,6 +1102,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -870,6 +1129,13 @@
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
},
"WWW-Authenticate": {
"description": "Basic realm=\"messenger\", charset=\"UTF-8\" для входа; Bearer realm=\"messenger\" для защищённого API lab2+.",
"schema": {
@@ -894,6 +1160,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -913,6 +1186,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -933,6 +1213,13 @@
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
},
"Retry-After": {
"description": "Положительное число секунд.",
"schema": {
@@ -958,6 +1245,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -977,6 +1271,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -1015,6 +1316,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -1034,6 +1342,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -1054,6 +1369,13 @@
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
},
"WWW-Authenticate": {
"description": "Basic realm=\"messenger\", charset=\"UTF-8\" для входа; Bearer realm=\"messenger\" для защищённого API lab2+.",
"schema": {
@@ -1078,6 +1400,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -1097,6 +1426,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -1117,6 +1453,13 @@
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
},
"Retry-After": {
"description": "Положительное число секунд.",
"schema": {
@@ -1142,6 +1485,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -1161,6 +1511,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -1181,6 +1538,18 @@
"type": "string",
"format": "uuid"
}
},
{
"name": "Idempotency-Key",
"in": "header",
"required": true,
"schema": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._:-]+$"
},
"description": "Обязателен с lab3. Область: пользователь + метод + путь + ключ; хранить результат не менее 24 ч. Повтор того же JSON возвращает исходный 201 и то же сообщение, другой JSON — 409."
}
],
"requestBody": {
@@ -1207,6 +1576,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -1226,6 +1602,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -1246,6 +1629,13 @@
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
},
"WWW-Authenticate": {
"description": "Basic realm=\"messenger\", charset=\"UTF-8\" для входа; Bearer realm=\"messenger\" для защищённого API lab2+.",
"schema": {
@@ -1270,6 +1660,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -1289,6 +1686,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -1309,6 +1713,13 @@
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
},
"Retry-After": {
"description": "Положительное число секунд.",
"schema": {
@@ -1334,6 +1745,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -1353,6 +1771,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -1409,6 +1834,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -1428,6 +1860,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -1448,6 +1887,13 @@
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
},
"WWW-Authenticate": {
"description": "Basic realm=\"messenger\", charset=\"UTF-8\" для входа; Bearer realm=\"messenger\" для защищённого API lab2+.",
"schema": {
@@ -1473,6 +1919,13 @@
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
},
"Retry-After": {
"description": "Положительное число секунд.",
"schema": {
@@ -1498,6 +1951,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -1517,6 +1977,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -1549,6 +2016,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
}
},
@@ -1562,6 +2036,13 @@
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
},
"WWW-Authenticate": {
"description": "Basic realm=\"messenger\", charset=\"UTF-8\" для входа; Bearer realm=\"messenger\" для защищённого API lab2+.",
"schema": {
@@ -1587,6 +2068,13 @@
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
},
"Retry-After": {
"description": "Положительное число секунд.",
"schema": {
@@ -1612,6 +2100,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
@@ -1631,6 +2126,13 @@
"type": "string",
"minLength": 1
}
},
"X-Instance-Id": {
"description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.",
"schema": {
"type": "string",
"minLength": 1
}
}
},
"content": {
+7
View File
@@ -0,0 +1,7 @@
# Architecture of the app binary inside the image
# generated: 2026-10-15T19:03:01Z
## emulated build (--build-arg TARGETARCH=amd64): e_machine 3e = x86-64
02 00 3e 00
## fixed build (no TARGETARCH default): e_machine b7 = aarch64
02 00 b7 00
+3
View File
@@ -0,0 +1,3 @@
# body limit check — 2026-10-16T14:02:25Z (limit 256 KiB from SERVER_MAX_BODY_BYTES)
тело 400 КиБ (сверх лимита): 413
тело 100 КиБ (в пределах): в„– 400
+7
View File
@@ -0,0 +1,7 @@
# Отказ PostgreSQL на пути отправки сообщения — 2026-10-16T14:10:06Z
до остановки БД, через LB : 201 (instance=828f6451261b)
до остановки БД, напрямую : 201
при остановленной БД, напрямую (ожидается 503): 503
при остановленной БД, через LB : 503 (instance=828f6451261b)
готовность после возврата БД: True
после возврата БД, через LB : 201 (instance=828f6451261b)
+5
View File
@@ -0,0 +1,5 @@
# make test-failover (прогон 1) — 2026-10-16T13:59:43Z
env -u HTTP_PROXY -u HTTPS_PROXY -u ALL_PROXY -u http_proxy -u https_proxy -u all_proxy NO_PROXY=localhost,127.0.0.1,::1 no_proxy=localhost,127.0.0.1,::1 python3 tests/resilience.py --mode failover --action-script "scripts/stop-one.sh" --base-url "http://localhost:8080"
Executing explicit failover hook; hook output suppressed to avoid leaking secrets.
{"observed_instances_before": 2, "successful_writes": 127, "failed_attempts": 0, "first_recovery_seconds": 0.214}
PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence.
+5
View File
@@ -0,0 +1,5 @@
# make test-failover (прогон 2) — 2026-10-16T13:59:43Z
env -u HTTP_PROXY -u HTTPS_PROXY -u ALL_PROXY -u http_proxy -u https_proxy -u all_proxy NO_PROXY=localhost,127.0.0.1,::1 no_proxy=localhost,127.0.0.1,::1 python3 tests/resilience.py --mode failover --action-script "scripts/stop-one.sh" --base-url "http://localhost:8080"
Executing explicit failover hook; hook output suppressed to avoid leaking secrets.
{"observed_instances_before": 2, "successful_writes": 100, "failed_attempts": 0, "first_recovery_seconds": 2.237}
PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence.
+54
View File
@@ -0,0 +1,54 @@
# student-tests/replica_failover.py — 2026-10-16T13:59:43Z
{
"before": {
"instances": [
"52861386fddb",
"8587b4251b72"
]
},
"replicas": [
{
"stopped": "52861386fddb",
"stopped_container": "stop-one.sh: stopped api replica(s): mtusi-messenger-lab3-api-5",
"hook_returncode": 0,
"hook_seconds": 0.151,
"hook_error": "",
"successful_writes": 91,
"successful_rps": 6.06,
"failed_attempts": 0,
"uncertain_retries": 0,
"first_recovery_seconds": 1.659,
"instances_after_recovery": [
"8587b4251b72"
],
"messages_in_history": 91,
"restored_seconds": 0.201,
"instances_restored": [
"52861386fddb",
"8587b4251b72"
]
},
{
"stopped": "8587b4251b72",
"stopped_container": "stop-one.sh: stopped api replica(s): mtusi-messenger-lab3-api-6",
"hook_returncode": 0,
"hook_seconds": 0.154,
"hook_error": "",
"successful_writes": 100,
"successful_rps": 6.66,
"failed_attempts": 0,
"uncertain_retries": 0,
"first_recovery_seconds": 1.656,
"instances_after_recovery": [
"52861386fddb"
],
"messages_in_history": 191,
"restored_seconds": 0.182,
"instances_restored": [
"52861386fddb",
"8587b4251b72"
]
}
]
}
PASS: каждая реплика остановлена по очереди; записи продолжились, дублей и потерь нет
+4
View File
@@ -0,0 +1,4 @@
# make test-idempotency — 2026-10-16T13:59:43Z
env -u HTTP_PROXY -u HTTPS_PROXY -u ALL_PROXY -u http_proxy -u https_proxy -u all_proxy NO_PROXY=localhost,127.0.0.1,::1 no_proxy=localhost,127.0.0.1,::1 python3 student-tests/idempotency_parallel.py --base-url "http://localhost:8080"
{"replay": {"workers": 12, "instances": ["52861386fddb", "8587b4251b72"], "message_id": "01a14502-f747-7fa8-bbad-84fa27f0ce80"}, "conflict": {"workers": 12, "accepted": 1, "conflicts": 11}, "stable_body": {"message_id": "01a14502-f771-7ea3-a03a-4d559e466ac8"}, "key_required": {"status": 400}}
PASS: параллельный повтор с одним Idempotency-Key создаёт ровно одно сообщение
+17
View File
@@ -0,0 +1,17 @@
# Артефакты предыдущих лабораторных (ЛР1 и ЛР2)
Файлы перенесены сюда из `evidence/`, потому что относятся к **прежним** конфигурациям
стенда и не являются доказательствами ЛР3: они сняты в ЛР1/ЛР2 в репозитории
`mtusi-messenger` и попали сюда вместе с переносом кода. Часть из них ссылается на
образ `mtusi2026lab1-messenger` и на in-memory хранилище, которое удалено ещё в ЛР2,
поэтому их нельзя читать как проверки текущего решения.
- `check.txt`, `quality.txt`, `concurrency.txt`, `docker.txt`, `health.txt`, `restart.txt`, `sigterm.txt` — ЛР1: офлайн-проверка структуры, линт и тесты, конкурентные чтения, запуск контейнера и обработка SIGTERM.
- `memory-experiment.*` — ЛР1: сравнение in-memory хранилища и PostgreSQL.
- `track1-benchmark/` — ЛР1, трек 1: бенчмарк append-оптимизации in-memory хранилища (скрипт `scripts/track1_benchmark.py` удалён в ЛР3 как осиротевший: он ссылался на удалённый файл хранилища).
- `cache/` — ЛР2: эксперименты с кэшем списка чатов, согласованность и поведение при отказе Redis.
- `postgres/explain-analyze.txt` — ЛР2: план запроса истории сообщений.
Доказательства ЛР3 лежат рядом, в `evidence/` (`smoke.txt`, `idempotency.txt`,
`persistence.txt`, `failover/`, `lb-readiness.txt`, `rolling-update/`,
`stand.txt`, `arch.txt`, `track1/`), и собраны в `REPORT.md`.

Before

Width:  |  Height:  |  Size: 102 KiB

After

Width:  |  Height:  |  Size: 102 KiB

+43
View File
@@ -0,0 +1,43 @@
$ make check
env -u HTTP_PROXY -u HTTPS_PROXY -u ALL_PROXY -u http_proxy -u https_proxy -u all_proxy NO_PROXY=localhost,127.0.0.1,::1 no_proxy=localhost,127.0.0.1,::1 python3 scripts/check_contract.py
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.
$ go vet ./...
$ make lint
/Users/vladislav/Projects/mtusi2026lab1-fork/bin/golangci-lint run -v
level=info msg="golangci-lint has version 2.13.2 built with go1.27.0 from (unknown, modified: ?, mod sum: \"h1:bCyq3E4vo9qwzifjpzJqYndEt7Ncva80qkk8G2B4TXU=\") on (unknown)"
level=info msg="[config_reader] Config search paths: [./ /Users/vladislav/Projects/mtusi2026lab1-fork /Users/vladislav/Projects /Users/vladislav /Users /]"
level=info msg="[config_reader] Used config file .golangci.yml"
level=info msg="[config_reader] Module name \"mtusi-messenger\""
level=info msg="[goenv] Read go env for 5.97475ms: map[string]string{\"GOCACHE\":\"/Users/vladislav/Library/Caches/go-build\", \"GOROOT\":\"/opt/homebrew/Cellar/go/1.27.1/libexec\"}"
level=info msg="[lintersdb] Active 50 linters: [asasalint bodyclose canonicalheader containedctx contextcheck copyloopvar depguard durationcheck errcheck errname errorlint exhaustive exptostd fatcontext forbidigo forcetypeassert gocheckcompilerdirectives gocritic gofumpt goimports gomoddirectives gosec govet ineffassign intrange makezero misspell musttag nilerr nilnil noctx nolintlint perfsprint prealloc reassign recvcheck revive rowserrcheck sloglint sqlclosecheck staticcheck testifylint thelper tparallel unconvert unparam unused usestdlibvars usetesting wastedassign]"
level=info msg="[loader] Using build tags: [integration]"
level=info msg="[loader] Go packages loading at mode 8767 (compiled_files|files|name|types_sizes|deps|exports_file|imports) took 122.006042ms"
level=info msg="[runner/filename_unadjuster] Pre-built 0 adjustments in 4.792166ms"
level=info msg="[linters_context/goanalysis] analyzers took 0s with no stages"
level=info msg="[runner/exclusion_rules] Skipped 2 issues by rules: [Path: \"_test\\\\.go\", Linters: \"gosec, prealloc, forcetypeassert, unparam\"]"
level=info msg="[runner] Issues before processing: 280, after processing: 0"
level=info msg="[runner] Processors filtering stat (in/out): exclusion_paths: 280/280, invalid_issue: 280/280, path_absoluter: 280/280, filename_unadjuster: 280/280, generated_file_filter: 280/100, exclusion_rules: 100/0, cgo: 280/280, path_relativity: 280/280"
level=info msg="[runner] processing took 607.916µs with stages: generated_file_filter: 420.959µs, exclusion_rules: 86.124µs, path_relativity: 83.917µs, sort_results: 4.458µs, invalid_issue: 4.292µs, cgo: 3.959µs, path_absoluter: 1.417µs, filename_unadjuster: 792ns, max_same_issues: 582ns, nolint_filter: 457ns, fixer: 292ns, exclusion_paths: 167ns, path_prettifier: 125ns, source_code: 125ns, path_shortener: 124ns, uniq_by_line: 42ns, severity-rules: 42ns, max_per_file_from_linter: 42ns, max_from_linter: 0s, diff: 0s"
level=info msg="[runner] linters took 422.737625ms with stages: goanalysis_metalinter: 422.101875ms"
0 issues.
level=info msg="File cache stats: 0 entries of total size 0B"
level=info msg="Memory: 7 samples, avg is 87.0MB, max is 111.2MB"
level=info msg="Execution took 555.972916ms"
$ make unit-test
go test -race -shuffle=on -count=1 -timeout=5m ./...
? mtusi-messenger/cmd/messenger [no test files]
ok mtusi-messenger/internal/config 1.838s
ok mtusi-messenger/internal/domain 1.498s
ok mtusi-messenger/internal/logger 2.150s
ok mtusi-messenger/internal/service/chat 2.470s
? mtusi-messenger/internal/service/chat/mocks [no test files]
ok mtusi-messenger/internal/service/message 2.797s
? mtusi-messenger/internal/service/message/mocks [no test files]
ok mtusi-messenger/internal/service/user 3.474s
? mtusi-messenger/internal/service/user/mocks [no test files]
ok mtusi-messenger/internal/storage/memory 3.159s
ok mtusi-messenger/internal/transport/rest 3.863s
? mtusi-messenger/internal/transport/rest/oas [no test files]
+31
View File
@@ -0,0 +1,31 @@
# LB excludes a not-ready but reachable replica (lab3)
# generated: 2026-10-16T14:02:26Z
# lb: haproxy:3.2-alpine
## 1. baseline: requests through LB by replica
18 52861386fddb
22 8587b4251b72
stats: api1=UP api2=UP api3=MAINT (resolution) api4=MAINT (resolution) api5=MAINT (resolution) api6=MAINT (resolution) api7=MAINT (resolution) api8=MAINT (resolution) BACKEND=UP
## 2. start a temporary TCP proxy to postgres and a candidate replica behind the same network alias
instance-id: 9e9e905440d3, readiness while its database is reachable: 200
load balancer slot for the candidate: api3, stats: api1=UP api2=UP api3=UP api4=MAINT (resolution) api5=MAINT (resolution) api6=MAINT (resolution) api7=MAINT (resolution) api8=MAINT (resolution) BACKEND=UP
## 3. cut the candidate's database access (stop only the TCP proxy)
candidate is still running: running, readiness: 503
waiting for the load balancer to mark api3 DOWN
api3 went DOWN 2s after its database was cut (check: inter 2s fall 2)
stats after failure: api1=UP api2=UP api3=DOWN api4=MAINT (resolution) api5=MAINT (resolution) api6=MAINT (resolution) api7=MAINT (resolution) api8=MAINT (resolution) BACKEND=UP
## 4. 40 requests through LB while the candidate is not ready
18 52861386fddb
22 8587b4251b72
(the candidate must not appear above)
## 5. business writes through LB during the exclusion
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 1163.529,
## 6. cleanup
stats after cleanup: api1=UP api2=UP api3=MAINT (resolution) api4=MAINT (resolution) api5=MAINT (resolution) api6=MAINT (resolution) api7=MAINT (resolution) api8=MAINT (resolution) BACKEND=UP
+17
View File
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 30.0,
"elapsed_seconds": 30.031,
"concurrency": 32,
"successful_requests": 38549,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 1283.644,
"successful_latency_ms": {
"p50": 19.177,
"p95": 52.823,
"p99": 60.246
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+18
View File
@@ -0,0 +1,18 @@
# контейнерный стенд через LB, 32 клиента, 30 с — 2026-10-16T14:26:39Z
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 30.0,
"elapsed_seconds": 30.031,
"concurrency": 32,
"successful_requests": 38549,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 1283.644,
"successful_latency_ms": {
"p50": 19.177,
"p95": 52.823,
"p99": 60.246
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+22
View File
@@ -0,0 +1,22 @@
{
"lab": 3,
"workload": "closed-loop POST messages; failures counted, not raised",
"requested_duration_seconds": 90.0,
"elapsed_seconds": 90.033,
"concurrency": 32,
"successful_requests": 220781,
"failed_requests": 0,
"error_ratio": 0.0,
"errors_by_kind": {},
"successful_rps": 2452.222,
"successful_latency_ms": {
"p50": 12.541,
"p95": 17.549,
"p99": 22.396
},
"instances": {
"Vladislavs-MacBook-Pro.local": 220781
},
"bootstrap_attempts": 1,
"note": "Percentiles cover successful writes only; transitional errors are expected during a rolling update."
}
+23
View File
@@ -0,0 +1,23 @@
# нативный процесс вне Docker, 32 клиента, 90 с — 2026-10-16T14:26:39Z
{
"lab": 3,
"workload": "closed-loop POST messages; failures counted, not raised",
"requested_duration_seconds": 90.0,
"elapsed_seconds": 90.033,
"concurrency": 32,
"successful_requests": 220781,
"failed_requests": 0,
"error_ratio": 0.0,
"errors_by_kind": {},
"successful_rps": 2452.222,
"successful_latency_ms": {
"p50": 12.541,
"p95": 17.549,
"p99": 22.396
},
"instances": {
"Vladislavs-MacBook-Pro.local": 220781
},
"bootstrap_attempts": 1,
"note": "Percentiles cover successful writes only; transitional errors are expected during a rolling update."
}
+40
View File
@@ -0,0 +1,40 @@
# Контроль пути «хост -> Colima VM -> LB»
Один и тот же генератор (`tests/load.py`), один и тот же профиль (закрытый цикл,
8 клиентов, 15 с прогрева, 60 с замера) и один и тот же стенд. Меняется только
место клиента: на хосте (через опубликованный порт) или в контейнере внутри VM
(напрямую в балансировщик по docker-сети). Воспроизведение:
`scripts/path_overhead_check.sh`.
| клиент | успешных | отказов | ошибки | RPS | p50, мс | p95, мс |
| --- | --- | --- | --- | --- | --- | --- |
| на хосте, `http://127.0.0.1:8080` | 92 378 | 32 575 | 26.1 % | 1 539 | 3.79 | 7.16 |
| в VM, `http://lb` | 88 596 | **0** | 0 % | 1 475 | 5.29 | 8.42 |
## Что это показывает
1. **Пропускная способность одна и та же** (1 539 против 1 475, разница в пределах
разброса; клиент в VM даже немного медленнее, потому что делит с стендом те же
2 vCPU). Значит путь «хост -> проброс порта -> VM» **не задаёт потолок**: его
исключение из маршрута ничего не прибавляет.
2. **Отказы целиком клиентские.** Тот же стенд под той же нагрузкой не отказал ни
разу для клиента внутри VM. При этом за прогон с 26 % клиентских отказов
балансировщик отдал все запросы без 5xx (`hrsp_5xx=0` в статистике HAProxy), а
в логах API нет ни одной записи уровня выше `info`.
3. Причина — сам проброс порта: генератор ходит без keep-alive (новое TCP-соединение
на запрос), и под шквалом соединений forwarder хоста начинает их отклонять.
Наблюдения: в момент замера на хосте было **19 556 сокетов в `TIME_WAIT`** при
диапазоне эфемерных портов 49 152-65 535 (16 384), а точечный пробник из 40 000
быстрых подключений подряд получил 1 294 успеха и 38 706 `ECONNREFUSED`.
4. Предел этой хрупкости тоже измерен: прогон на ~4 500 соединений/с по тривиальному
`/health/live` дал 100 % отказов, после чего проброс порта (и доступ к Docker-эндпоинту
Colima) перестал отвечать до `colima restart`. Стенд при этом не падал — недоступным
был именно хостовый путь; серия трека 1 поэтому снимается клиентом внутри VM
(`CLIENT=vm`), где отказов нет.
Клиент на хосте способен на большее: тот же закрытый цикл по тривиальному серверу,
поднятому на самом хосте (без Docker), дал 4 469 RPS без отказов — то есть ~1 500 RPS
не являются потолком генератора.
Артефакты: `outside.txt`, `inside.txt`, `load-outside.json`, `load-inside.json`,
`summary.txt`.
+17
View File
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.073,
"concurrency": 8,
"successful_requests": 88596,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 1474.795,
"successful_latency_ms": {
"p50": 5.292,
"p95": 8.415,
"p99": 10.433
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+17
View File
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.073,
"concurrency": 8,
"successful_requests": 88596,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 1474.795,
"successful_latency_ms": {
"p50": 5.292,
"p95": 8.415,
"p99": 10.433
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+17
View File
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.026,
"concurrency": 8,
"successful_requests": 92378,
"failed_requests": 32575,
"error_ratio": 0.260698,
"successful_rps": 1538.959,
"successful_latency_ms": {
"p50": 3.793,
"p95": 7.159,
"p99": 21.756
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+17
View File
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.026,
"concurrency": 8,
"successful_requests": 92378,
"failed_requests": 32575,
"error_ratio": 0.260698,
"successful_rps": 1538.959,
"successful_latency_ms": {
"p50": 3.793,
"p95": 7.159,
"p99": 21.756
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+9
View File
@@ -0,0 +1,9 @@
# Контроль пути к балансировщику
# generated: 2026-10-16T18:17:21Z
# profile: tests/load.py duration=60 concurrency=8 warmup=15
# docker network: mtusi-messenger-lab3_default
# клиент в VM: python:3.12-alpine
=== извне: клиент на хосте, http://127.0.0.1:8080 ===
=== изнутри: клиент в VM, http://lb ===
+4
View File
@@ -0,0 +1,4 @@
# make test-persistence — 2026-10-16T13:59:43Z
env -u HTTP_PROXY -u HTTPS_PROXY -u ALL_PROXY -u http_proxy -u https_proxy -u all_proxy NO_PROXY=localhost,127.0.0.1,::1 no_proxy=localhost,127.0.0.1,::1 python3 tests/resilience.py --mode persistence --action-script "scripts/restart.sh" --base-url "http://localhost:8080"
Executing explicit persistence hook; hook output suppressed to avoid leaking secrets.
PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence.
+30 -38
View File
@@ -1,43 +1,35 @@
$ make check
env -u HTTP_PROXY -u HTTPS_PROXY -u ALL_PROXY -u http_proxy -u https_proxy -u all_proxy NO_PROXY=localhost,127.0.0.1,::1 no_proxy=localhost,127.0.0.1,::1 python3 scripts/check_contract.py
# quality checks — 2026-10-16T14:30:53Z
python3 scripts/check_contract.py
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.
$ go vet ./...
$ make lint
/Users/vladislav/Projects/mtusi2026lab1-fork/bin/golangci-lint run -v
level=info msg="golangci-lint has version 2.13.2 built with go1.27.0 from (unknown, modified: ?, mod sum: \"h1:bCyq3E4vo9qwzifjpzJqYndEt7Ncva80qkk8G2B4TXU=\") on (unknown)"
level=info msg="[config_reader] Config search paths: [./ /Users/vladislav/Projects/mtusi2026lab1-fork /Users/vladislav/Projects /Users/vladislav /Users /]"
level=info msg="[config_reader] Used config file .golangci.yml"
level=info msg="[config_reader] Module name \"mtusi-messenger\""
level=info msg="[goenv] Read go env for 5.97475ms: map[string]string{\"GOCACHE\":\"/Users/vladislav/Library/Caches/go-build\", \"GOROOT\":\"/opt/homebrew/Cellar/go/1.27.1/libexec\"}"
level=info msg="[lintersdb] Active 50 linters: [asasalint bodyclose canonicalheader containedctx contextcheck copyloopvar depguard durationcheck errcheck errname errorlint exhaustive exptostd fatcontext forbidigo forcetypeassert gocheckcompilerdirectives gocritic gofumpt goimports gomoddirectives gosec govet ineffassign intrange makezero misspell musttag nilerr nilnil noctx nolintlint perfsprint prealloc reassign recvcheck revive rowserrcheck sloglint sqlclosecheck staticcheck testifylint thelper tparallel unconvert unparam unused usestdlibvars usetesting wastedassign]"
level=info msg="[loader] Using build tags: [integration]"
level=info msg="[loader] Go packages loading at mode 8767 (compiled_files|files|name|types_sizes|deps|exports_file|imports) took 122.006042ms"
level=info msg="[runner/filename_unadjuster] Pre-built 0 adjustments in 4.792166ms"
level=info msg="[linters_context/goanalysis] analyzers took 0s with no stages"
level=info msg="[runner/exclusion_rules] Skipped 2 issues by rules: [Path: \"_test\\\\.go\", Linters: \"gosec, prealloc, forcetypeassert, unparam\"]"
level=info msg="[runner] Issues before processing: 280, after processing: 0"
level=info msg="[runner] Processors filtering stat (in/out): exclusion_paths: 280/280, invalid_issue: 280/280, path_absoluter: 280/280, filename_unadjuster: 280/280, generated_file_filter: 280/100, exclusion_rules: 100/0, cgo: 280/280, path_relativity: 280/280"
level=info msg="[runner] processing took 607.916µs with stages: generated_file_filter: 420.959µs, exclusion_rules: 86.124µs, path_relativity: 83.917µs, sort_results: 4.458µs, invalid_issue: 4.292µs, cgo: 3.959µs, path_absoluter: 1.417µs, filename_unadjuster: 792ns, max_same_issues: 582ns, nolint_filter: 457ns, fixer: 292ns, exclusion_paths: 167ns, path_prettifier: 125ns, source_code: 125ns, path_shortener: 124ns, uniq_by_line: 42ns, severity-rules: 42ns, max_per_file_from_linter: 42ns, max_from_linter: 0s, diff: 0s"
level=info msg="[runner] linters took 422.737625ms with stages: goanalysis_metalinter: 422.101875ms"
0 issues.
level=info msg="File cache stats: 0 entries of total size 0B"
level=info msg="Memory: 7 samples, avg is 87.0MB, max is 111.2MB"
level=info msg="Execution took 555.972916ms"
$ make unit-test
go test -race -shuffle=on -count=1 -timeout=5m ./...
.venv/bin/python scripts/validate_openapi.py
PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested.
env -u APP_ENV -u SERVER_HOST -u SERVER_PORT -u SERVER_READ_HEADER_TIMEOUT -u SERVER_SHUTDOWN_TIMEOUT -u LOG_LEVEL -u LOG_FORMAT -u POSTGRES_HOST -u POSTGRES_PORT -u POSTGRES_DATABASE -u POSTGRES_USER -u POSTGRES_PASSWORD -u POSTGRES_SSL_MODE -u POSTGRES_MAX_CONNS -u POSTGRES_MIN_CONNS -u POSTGRES_MAX_CONN_LIFETIME -u POSTGRES_MAX_CONN_IDLE_TIME -u POSTGRES_CONNECT_TIMEOUT -u POSTGRES_QUERY_TIMEOUT -u REDIS_ENABLED -u REDIS_HOST -u REDIS_PORT -u REDIS_PASSWORD -u REDIS_DB -u REDIS_MAX_RETRIES -u REDIS_DIAL_TIMEOUT -u REDIS_READ_TIMEOUT -u REDIS_WRITE_TIMEOUT -u REDIS_POOL_SIZE -u CACHE_ENABLED -u CACHE_CHAT_LIST_TTL -u CACHE_LOCK_TTL -u CACHE_LOCK_WAIT_TIMEOUT -u SESSION_TTL_SECONDS -u IDEMPOTENCY_TTL_SECONDS -u API_REPLICAS -u API_CPU_LIMIT -u API_MEM_LIMIT go test -race -shuffle=on -count=1 -timeout=5m ./...
? mtusi-messenger/cmd/messenger [no test files]
ok mtusi-messenger/internal/config 1.838s
ok mtusi-messenger/internal/domain 1.498s
ok mtusi-messenger/internal/logger 2.150s
ok mtusi-messenger/internal/service/chat 2.470s
? mtusi-messenger/cmd/migrate [no test files]
ok mtusi-messenger/internal/config 1.633s
ok mtusi-messenger/internal/domain 1.222s
ok mtusi-messenger/internal/health 1.397s
ok mtusi-messenger/internal/logger 1.803s
ok mtusi-messenger/internal/platform/cache 2.104s
? mtusi-messenger/internal/platform/cache/mocks [no test files]
ok mtusi-messenger/internal/platform/password 2.659s
ok mtusi-messenger/internal/platform/token 2.147s
ok mtusi-messenger/internal/service/chat 2.733s
? mtusi-messenger/internal/service/chat/mocks [no test files]
ok mtusi-messenger/internal/service/message 2.797s
ok mtusi-messenger/internal/service/message 2.527s
? mtusi-messenger/internal/service/message/mocks [no test files]
ok mtusi-messenger/internal/service/user 3.474s
ok mtusi-messenger/internal/service/session 3.204s
? mtusi-messenger/internal/service/session/mocks [no test files]
ok mtusi-messenger/internal/service/user 3.505s
? mtusi-messenger/internal/service/user/mocks [no test files]
ok mtusi-messenger/internal/storage/memory 3.159s
ok mtusi-messenger/internal/transport/rest 3.863s
? mtusi-messenger/internal/transport/rest/oas [no test files]
ok mtusi-messenger/internal/storage/postgres 3.147s
? mtusi-messenger/internal/storage/postgres/internal/sqlcgen [no test files]
? mtusi-messenger/internal/storage/postgres/migrations [no test files]
? mtusi-messenger/internal/storage/redis [no test files]
? mtusi-messenger/internal/storage/redis/mocks [no test files]
ok mtusi-messenger/internal/transport/rest 3.609s
? mtusi-messenger/internal/transport/rest/internal/oas [no test files]
? mtusi-messenger/internal/transport/rest/mocks [no test files]
go test -tags=integration -p 1 -count=1 -timeout=15m ./internal/storage/postgres ./internal/storage/redis
ok mtusi-messenger/internal/storage/postgres 7.210s
ok mtusi-messenger/internal/storage/redis 1.192s
+33
View File
@@ -0,0 +1,33 @@
# Что означает CPU% в `docker stats` на этом стенде
Колонка `cpu_percent` в `stats-*.csv` снимается через `docker stats`. Чтобы не
толковать её наугад, поведение проверено прямым экспериментом на том же Docker-host
(Colima, 2 vCPU).
```sh
docker run -d --name lab3-quota-probe --cpus 0.5 alpine:3.20 sh -c 'while :; do :; done'
sleep 12
docker stats --no-stream --format '{{.Name}} CPU={{.CPUPerc}}' lab3-quota-probe
docker exec lab3-quota-probe cat /sys/fs/cgroup/cpu.max
```
```
lab3-quota-probe CPU=49.49% MEM=344KiB / 1.913GiB
50000 100000
```
Контейнер упёрт в свою квоту (`cpu.max = 50000 100000` — это 0.5 CPU) и показывает
**49.49 %**. Значит в этом окружении `docker stats` печатает процент от **одного
ядра**: 100 % = 1 ядро, квота 0.5 CPU = ~50 %, квота 0.25 = ~25 %.
Как это читать в артефактах:
| сервис | квота | наблюдение в профилях | вывод |
| --- | --- | --- | --- |
| `postgres` | 0.50 | 45-50.5 % | 0.45-0.5 ядра, то есть **у самой квоты** |
| `api` (2 реплики) | 0.50 каждая | ~20 % каждая | 0.2 ядра, квота не выбрана |
| `lb` | 0.25 | 11-14 % | 0.11-0.14 ядра, квота не выбрана |
Отсюда же следует, что разница между профилем `r2` (PostgreSQL 0.50) и `db1cpu`
(PostgreSQL 1.00) читается корректно: в `db1cpu` загрузка БД падала до ~46 %, то есть
удвоенная квота не была использована — БД не была зажата квотой.
+26
View File
@@ -0,0 +1,26 @@
{
"lab": 3,
"workload": "closed-loop POST messages; failures counted, not raised",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.013,
"concurrency": 8,
"successful_requests": 97359,
"failed_requests": 3,
"error_ratio": 3.1e-05,
"errors_by_kind": {
"http_error": 3
},
"successful_rps": 1622.308,
"successful_latency_ms": {
"p50": 4.011,
"p95": 8.688,
"p99": 23.718
},
"instances": {
"f00a99f95855": 594,
"8782633d0431": 48162,
"4248067e3f04": 48603
},
"bootstrap_attempts": 1,
"note": "Percentiles cover successful writes only; transitional errors are expected during a rolling update."
}
+26
View File
@@ -0,0 +1,26 @@
{
"lab": 3,
"workload": "closed-loop POST messages; failures counted, not raised",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.013,
"concurrency": 8,
"successful_requests": 97359,
"failed_requests": 3,
"error_ratio": 3.1e-05,
"errors_by_kind": {
"http_error": 3
},
"successful_rps": 1622.308,
"successful_latency_ms": {
"p50": 4.011,
"p95": 8.688,
"p99": 23.718
},
"instances": {
"f00a99f95855": 594,
"8782633d0431": 48162,
"4248067e3f04": 48603
},
"bootstrap_attempts": 1,
"note": "Percentiles cover successful writes only; transitional errors are expected during a rolling update."
}
@@ -0,0 +1,136 @@
# Rolling update under load (surge, one replica at a time)
# generated: 2026-10-16T14:26:39Z
# load: tolerant loader, duration=60s concurrency=8
# проверки готовности LB: httpchk /health/ready, inter 2s fall 2 rise 2, timeout check 1s
time="2026-10-16T17:26:40+03:00" level=warning msg="buildx Docker CLI plugin not found: falling back to the classic builder. BuildKit-only build features (multi-arch, secrets, ssh, additional contexts, ...) will not be available"
Image mtusi-messenger:lab3 Building
Image mtusi-messenger:lab3 Building
Sending build context to Docker daemon 238kB␍
Step 1/25 : ARG GO_VERSION=1.27.1
Step 2/25 : ARG ALPINE_VERSION=3.22
Step 3/25 : FROM golang:${GO_VERSION}-alpine AS build
---> 8a5910f31396
Step 4/25 : ARG TARGETOS
---> Using cache
---> d5f2c47ea7a5
Step 5/25 : ARG TARGETARCH
---> Using cache
---> 047ee34b445c
Step 6/25 : ARG VERSION=dev
---> Using cache
---> a529d045efeb
Step 7/25 : ENV GOTOOLCHAIN=local
---> Using cache
---> 428f1b16b5c5
Step 8/25 : WORKDIR /opt
---> Using cache
---> f37febf8b423
Step 9/25 : COPY go.mod go.sum ./
---> Using cache
---> c4015f597b99
Step 10/25 : RUN go mod download
---> Using cache
---> 34ef6a6167b0
Step 11/25 : ARG GOFLAGS="-p=2"
---> Using cache
---> deb54a0ce57a
Step 12/25 : ENV GOFLAGS=$GOFLAGS
---> Using cache
---> 3da36569422d
Step 13/25 : COPY . .
---> 198f052f6cce
Step 14/25 : RUN CGO_ENABLED=0 GOOS=${TARGETOS} GOARCH=${TARGETARCH} go build -trimpath -buildvcs=false -tags timetzdata -ldflags="-s -w -X main.version=${VERSION}" -o /out/messenger ./cmd/messenger && CGO_ENABLED=0 GOOS=${TARGETOS} GOARCH=${TARGETARCH} go build -trimpath -buildvcs=false -tags timetzdata -ldflags="-s -w -X main.version=${VERSION}" -o /out/migrate ./cmd/migrate
---> Running in 658437823eb9
---> Removed intermediate container 658437823eb9
---> 10a89d0bb592
Step 15/25 : FROM alpine:${ALPINE_VERSION} AS runtime
---> 5291449c3df7
Step 16/25 : RUN apk add --no-cache ca-certificates wget && addgroup -S -g 10001 app && adduser -S -D -H -u 10001 -G app app
---> Using cache
---> f47b074d9bd5
Step 17/25 : COPY --from=build --chown=10001:10001 /out/messenger /usr/local/bin/messenger
---> Using cache
---> 703f8f10d2cc
Step 18/25 : COPY --from=build --chown=10001:10001 /out/migrate /usr/local/bin/migrate
---> Using cache
---> c9121622dae2
Step 19/25 : COPY --chown=10001:10001 config/dev/config.yaml /etc/messenger/dev/config.yaml
---> Using cache
---> 0379076307ea
Step 20/25 : USER 10001:10001
---> Using cache
---> 2ff943b7d2e0
Step 21/25 : EXPOSE 8080
---> Using cache
---> 01674ab574a6
Step 22/25 : STOPSIGNAL SIGTERM
---> Using cache
---> 6c30af2a102c
Step 23/25 : HEALTHCHECK --interval=10s --timeout=3s --start-period=5s --retries=3 CMD wget -q -O /dev/null "http://127.0.0.1:${SERVER_PORT:-8080}/health/live" || exit 1
---> Using cache
---> 76379f8db08d
Step 24/25 : ENTRYPOINT ["/usr/local/bin/messenger"]
---> Using cache
---> 778babec5020
Step 25/25 : LABEL com.docker.compose.image.builder=classic
---> Using cache
---> 9e7e0224c87c
Successfully built 9e7e0224c87c
Successfully tagged mtusi-messenger:lab3
Image mtusi-messenger:lab3 Built
Image mtusi-messenger:lab3 Built
реплик до обновления: 2
образ старых реплик: sha256:9e7e0224c87cee0ccfa05d5799ec8e2a84b836e51fbda6f1dc3d175d5c0d4640
образ новой ревизии: sha256:9e7e0224c87cee0ccfa05d5799ec8e2a84b836e51fbda6f1dc3d175d5c0d4640
ревизия меняется: нет (образ не изменился)
слотов UP до: 3; restarts до: mtusi-messenger-lab3-api-1=0 mtusi-messenger-lab3-api-2=0
step 1: lb-rollout-1 обслуживает (образ 9e7e0224c87cee0ccfa05d5799ec8e2a84b836e51fbda6f1dc3d175d5c0d4640, instance 8782633d0431), старый контейнер 2ed432da6dd1 (2ed432da6dd1) снят; UP-слотов 3; 5xx накоплено 416; старт шага 2026-10-16T14:27:22Z
step 2: lb-rollout-2 обслуживает (образ 9e7e0224c87cee0ccfa05d5799ec8e2a84b836e51fbda6f1dc3d175d5c0d4640, instance 4248067e3f04), старый контейнер f00a99f95855 (f00a99f95855) снят; UP-слотов 4; 5xx накоплено 419; старт шага 2026-10-16T14:27:22Z
load summary (tolerant generator):
{
"lab": 3,
"workload": "closed-loop POST messages; failures counted, not raised",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.013,
"concurrency": 8,
"successful_requests": 97359,
"failed_requests": 3,
"error_ratio": 3.1e-05,
"errors_by_kind": {
"http_error": 3
},
"successful_rps": 1622.308,
"successful_latency_ms": {
"p50": 4.011,
"p95": 8.688,
"p99": 23.718
},
"instances": {
"f00a99f95855": 594,
"8782633d0431": 48162,
"4248067e3f04": 48603
},
"bootstrap_attempts": 1,
"note": "Percentiles cover successful writes only; transitional errors are expected during a rolling update."
}
5xx от LB за время обновления (hrsp_5xx frontend): 3
restarts после: lb-rollout-2=0 lb-rollout-1=0
возврат стенда под управление compose:
Container mtusi-messenger-lab3-api-2 Creating
Container mtusi-messenger-lab3-api-1 Creating
Container mtusi-messenger-lab3-api-1 Created
Container mtusi-messenger-lab3-api-2 Created
Container mtusi-messenger-lab3-api-1 Starting
Container mtusi-messenger-lab3-api-1 Started
Container mtusi-messenger-lab3-api-2 Starting
Container mtusi-messenger-lab3-api-2 Started
снято временных контейнеров наплыва: проверено
UP-слотов после: 3; restarts в конце: mtusi-messenger-lab3-api-1=0 mtusi-messenger-lab3-api-2=0
API containers после обновления:
mtusi-messenger-lab3-api-1 Up Less than a second (health: starting)
mtusi-messenger-lab3-api-2 Up Less than a second (health: starting)
@@ -0,0 +1,23 @@
{
"lab": 3,
"workload": "closed-loop POST messages; failures counted, not raised",
"requested_duration_seconds": 45.0,
"elapsed_seconds": 45.014,
"concurrency": 8,
"successful_requests": 89560,
"failed_requests": 0,
"error_ratio": 0.0,
"errors_by_kind": {},
"successful_rps": 1989.584,
"successful_latency_ms": {
"p50": 3.905,
"p95": 6.02,
"p99": 7.984
},
"instances": {
"388ebcb74200": 7524,
"73d07d7d76db": 45354,
"cc6274635bd6": 36682
},
"note": "Percentiles cover successful writes only; transitional errors are expected during a rolling update."
}
+23
View File
@@ -0,0 +1,23 @@
{
"lab": 3,
"workload": "closed-loop POST messages; failures counted, not raised",
"requested_duration_seconds": 45.0,
"elapsed_seconds": 45.014,
"concurrency": 8,
"successful_requests": 89560,
"failed_requests": 0,
"error_ratio": 0.0,
"errors_by_kind": {},
"successful_rps": 1989.584,
"successful_latency_ms": {
"p50": 3.905,
"p95": 6.02,
"p99": 7.984
},
"instances": {
"388ebcb74200": 7524,
"73d07d7d76db": 45354,
"cc6274635bd6": 36682
},
"note": "Percentiles cover successful writes only; transitional errors are expected during a rolling update."
}
@@ -0,0 +1,134 @@
# Rolling update under load
# generated: 2026-10-15T19:03:13Z
# load: tests/load.py duration=45s concurrency=8 (closed loop)
# steps: delete one replica, recreate it from the freshly built image, wait for health + LB
time="2026-10-15T22:03:13+03:00" level=warning msg="buildx Docker CLI plugin not found: falling back to the classic builder. BuildKit-only build features (multi-arch, secrets, ssh, additional contexts, ...) will not be available"
Image mtusi-messenger:lab3 Building
Image mtusi-messenger:lab3 Building
Sending build context to Docker daemon 213.7kB␍
Step 1/25 : ARG GO_VERSION=1.27.1
Step 2/25 : ARG ALPINE_VERSION=3.22
Step 3/25 : FROM golang:${GO_VERSION}-alpine AS build
---> 8a5910f31396
Step 4/25 : ARG TARGETOS
---> Using cache
---> d5f2c47ea7a5
Step 5/25 : ARG TARGETARCH
---> Using cache
---> 047ee34b445c
Step 6/25 : ARG VERSION=dev
---> Using cache
---> a529d045efeb
Step 7/25 : ENV GOTOOLCHAIN=local
---> Using cache
---> 428f1b16b5c5
Step 8/25 : WORKDIR /opt
---> Using cache
---> f37febf8b423
Step 9/25 : COPY go.mod go.sum ./
---> Using cache
---> c4015f597b99
Step 10/25 : RUN go mod download
---> Using cache
---> 34ef6a6167b0
Step 11/25 : ARG GOFLAGS="-p=2"
---> Using cache
---> deb54a0ce57a
Step 12/25 : ENV GOFLAGS=$GOFLAGS
---> Using cache
---> 3da36569422d
Step 13/25 : COPY . .
---> Using cache
---> 596dc1ab02d1
Step 14/25 : RUN CGO_ENABLED=0 GOOS=${TARGETOS} GOARCH=${TARGETARCH} go build -trimpath -buildvcs=false -tags timetzdata -ldflags="-s -w -X main.version=${VERSION}" -o /out/messenger ./cmd/messenger && CGO_ENABLED=0 GOOS=${TARGETOS} GOARCH=${TARGETARCH} go build -trimpath -buildvcs=false -tags timetzdata -ldflags="-s -w -X main.version=${VERSION}" -o /out/migrate ./cmd/migrate
---> Using cache
---> 01aa8bc6200d
Step 15/25 : FROM alpine:${ALPINE_VERSION} AS runtime
---> 5291449c3df7
Step 16/25 : RUN apk add --no-cache ca-certificates wget && addgroup -S -g 10001 app && adduser -S -D -H -u 10001 -G app app
---> Using cache
---> f47b074d9bd5
Step 17/25 : COPY --from=build --chown=10001:10001 /out/messenger /usr/local/bin/messenger
---> Using cache
---> 50fc6abe3b04
Step 18/25 : COPY --from=build --chown=10001:10001 /out/migrate /usr/local/bin/migrate
---> Using cache
---> 9bf6afe0256d
Step 19/25 : COPY --chown=10001:10001 config/dev/config.yaml /etc/messenger/dev/config.yaml
---> Using cache
---> 0d1870a325ec
Step 20/25 : USER 10001:10001
---> Using cache
---> 1991f2ae06cc
Step 21/25 : EXPOSE 8080
---> Using cache
---> 762d1bfb7606
Step 22/25 : STOPSIGNAL SIGTERM
---> Using cache
---> 8a9d8f4f7101
Step 23/25 : HEALTHCHECK --interval=10s --timeout=3s --start-period=5s --retries=3 CMD wget -q -O /dev/null "http://127.0.0.1:${SERVER_PORT:-8080}/health/live" || exit 1
---> Using cache
---> 65dea502a3f3
Step 24/25 : ENTRYPOINT ["/usr/local/bin/messenger"]
---> Using cache
---> 83bbee72905e
Step 25/25 : LABEL com.docker.compose.image.builder=classic
---> Using cache
---> 037f969d5ea1
Successfully built 037f969d5ea1
Successfully tagged mtusi-messenger:lab3
Image mtusi-messenger:lab3 Built
Image mtusi-messenger:lab3 Built
Container mtusi-messenger-lab3-api-13 Recreate
Container mtusi-messenger-lab3-api-14 Recreate
Container mtusi-messenger-lab3-api-13 Recreated
Container mtusi-messenger-lab3-api-14 Recreated
Container mtusi-messenger-lab3-api-14 Starting
Container mtusi-messenger-lab3-api-14 Started
Container mtusi-messenger-lab3-api-13 Starting
Container mtusi-messenger-lab3-api-13 Started
replicas before: 2; instances seen through LB: 2
Container mtusi-messenger-lab3-api-13 Running
Container mtusi-messenger-lab3-api-14 Creating
Container mtusi-messenger-lab3-api-14 Created
Container mtusi-messenger-lab3-api-14 Starting
Container mtusi-messenger-lab3-api-14 Started
step 1: removed 54a7e7888b5f at 2026-10-15T19:03:20Z, 2 healthy replicas served again at 2026-10-15T19:03:26Z
Container mtusi-messenger-lab3-api-14 Running
Container mtusi-messenger-lab3-api-15 Creating
Container mtusi-messenger-lab3-api-15 Created
Container mtusi-messenger-lab3-api-15 Starting
Container mtusi-messenger-lab3-api-15 Started
step 2: removed 388ebcb74200 at 2026-10-15T19:03:26Z, 2 healthy replicas served again at 2026-10-15T19:03:31Z
load summary (tolerant generator):
{
"lab": 3,
"workload": "closed-loop POST messages; failures counted, not raised",
"requested_duration_seconds": 45.0,
"elapsed_seconds": 45.014,
"concurrency": 8,
"successful_requests": 89560,
"failed_requests": 0,
"error_ratio": 0.0,
"errors_by_kind": {},
"successful_rps": 1989.584,
"successful_latency_ms": {
"p50": 3.905,
"p95": 6.02,
"p99": 7.984
},
"instances": {
"388ebcb74200": 7524,
"73d07d7d76db": 45354,
"cc6274635bd6": 36682
},
"note": "Percentiles cover successful writes only; transitional errors are expected during a rolling update."
}
LB responses with 5xx during the update: 0
API containers after the update:
mtusi-messenger-lab3-api-15 Up 41 seconds (healthy)
mtusi-messenger-lab3-api-14 Up 46 seconds (healthy)
+3 -2
View File
@@ -1,2 +1,3 @@
env -u HTTP_PROXY -u HTTPS_PROXY -u ALL_PROXY -u http_proxy -u https_proxy -u all_proxy NO_PROXY=localhost,127.0.0.1,::1 no_proxy=localhost,127.0.0.1,::1 python3 tests/smoke.py --base-url "http://127.0.0.1:8080"
PASS: lab1 public API scenario; infrastructure and grading evidence remain separate.
# make test — 2026-10-16T14:07:37Z (final image)
env -u HTTP_PROXY -u HTTPS_PROXY -u ALL_PROXY -u http_proxy -u https_proxy -u all_proxy NO_PROXY=localhost,127.0.0.1,::1 no_proxy=localhost,127.0.0.1,::1 python3 tests/smoke.py --base-url "http://localhost:8080"
PASS: lab3 public API scenario; infrastructure and grading evidence remain separate.
+34
View File
@@ -0,0 +1,34 @@
# Lab3 stand evidence
# generated: 2026-10-16T13:38:19Z
## docker ps (ports)
mtusi-messenger-lab3-api-6 | 8080/tcp
mtusi-messenger-lab3-api-5 | 8080/tcp
mtusi-messenger-lab3-lb-1 | 127.0.0.1:8404->8404/tcp, 127.0.0.1:8080->80/tcp
mtusi-messenger-lab3-postgres-1 | 5432/tcp
mtusi-messenger-lab3-redis-1 | 6379/tcp
## compose config: limits/replicas/published
api:
replicas: 2
cpus: 0.5
memory: "268435456"
lb:
cpus: 0.25
memory: "67108864"
published: "8080"
published: "8404"
migrate:
cpus: 0.5
memory: "268435456"
postgres:
cpus: 0.5
memory: "402653184"
redis:
cpus: 0.25
memory: "201326592"
default:
build:
image: mtusi-messenger:lab3
container_name: absent
+17
View File
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.082,
"concurrency": 8,
"successful_requests": 83581,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 1391.108,
"successful_latency_ms": {
"p50": 5.571,
"p95": 9.03,
"p99": 11.692
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+17
View File
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.072,
"concurrency": 8,
"successful_requests": 83599,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 1391.647,
"successful_latency_ms": {
"p50": 5.575,
"p95": 8.994,
"p99": 11.512
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+17
View File
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.078,
"concurrency": 8,
"successful_requests": 81711,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 1360.087,
"successful_latency_ms": {
"p50": 5.664,
"p95": 9.482,
"p99": 12.322
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+17
View File
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.074,
"concurrency": 8,
"successful_requests": 81688,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 1359.794,
"successful_latency_ms": {
"p50": 5.688,
"p95": 9.37,
"p99": 12.032
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+17
View File
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.068,
"concurrency": 8,
"successful_requests": 83445,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 1389.179,
"successful_latency_ms": {
"p50": 5.585,
"p95": 9.054,
"p99": 11.711
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+17
View File
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.077,
"concurrency": 8,
"successful_requests": 76301,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 1270.045,
"successful_latency_ms": {
"p50": 6.057,
"p95": 10.141,
"p99": 13.724
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+17
View File
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.064,
"concurrency": 8,
"successful_requests": 89486,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 1489.856,
"successful_latency_ms": {
"p50": 5.238,
"p95": 8.245,
"p99": 10.54
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+17
View File
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.071,
"concurrency": 8,
"successful_requests": 89886,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 1496.325,
"successful_latency_ms": {
"p50": 5.207,
"p95": 8.221,
"p99": 10.508
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+17
View File
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.061,
"concurrency": 8,
"successful_requests": 89566,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 1491.252,
"successful_latency_ms": {
"p50": 5.251,
"p95": 8.176,
"p99": 10.209
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+17
View File
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.071,
"concurrency": 8,
"successful_requests": 82138,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 1367.357,
"successful_latency_ms": {
"p50": 5.67,
"p95": 9.26,
"p99": 12.055
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+17
View File
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.074,
"concurrency": 8,
"successful_requests": 84040,
"failed_requests": 4,
"error_ratio": 4.8e-05,
"successful_rps": 1398.951,
"successful_latency_ms": {
"p50": 5.556,
"p95": 8.741,
"p99": 11.048
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+17
View File
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.078,
"concurrency": 8,
"successful_requests": 78078,
"failed_requests": 4,
"error_ratio": 5.1e-05,
"successful_rps": 1299.617,
"successful_latency_ms": {
"p50": 5.957,
"p95": 9.594,
"p99": 12.386
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+17
View File
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.075,
"concurrency": 8,
"successful_requests": 92690,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 1542.892,
"successful_latency_ms": {
"p50": 5.047,
"p95": 8.006,
"p99": 10.239
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+17
View File
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.073,
"concurrency": 8,
"successful_requests": 89588,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 1491.325,
"successful_latency_ms": {
"p50": 5.245,
"p95": 8.225,
"p99": 10.303
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+17
View File
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 60.0,
"elapsed_seconds": 60.069,
"concurrency": 8,
"successful_requests": 85041,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 1415.713,
"successful_latency_ms": {
"p50": 5.538,
"p95": 8.614,
"p99": 10.749
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+1
View File
@@ -0,0 +1 @@
{"label":"ctl1base","replicas":2,"total_cpu":1.0,"total_mem_mb":768,"duration":60,"concurrency":8,"warmup":15,"postgres_cpu_limit":"0.50","postgres_mem_limit":"384M","postgres_max_conns":10,"lb_cpu_limit":"0.25","client":"vm"}
+1
View File
@@ -0,0 +1 @@
{"label":"ctl2pg","replicas":2,"total_cpu":1.0,"total_mem_mb":768,"duration":60,"concurrency":8,"warmup":15,"postgres_cpu_limit":"1.00","postgres_mem_limit":"384M","postgres_max_conns":10,"lb_cpu_limit":"0.25","client":"vm"}
+1
View File
@@ -0,0 +1 @@
{"label":"ctl3base","replicas":2,"total_cpu":1.0,"total_mem_mb":768,"duration":60,"concurrency":8,"warmup":15,"postgres_cpu_limit":"0.50","postgres_mem_limit":"384M","postgres_max_conns":10,"lb_cpu_limit":"0.25","client":"vm"}
+1
View File
@@ -0,0 +1 @@
{"label":"ctl4lb","replicas":2,"total_cpu":1.0,"total_mem_mb":768,"duration":60,"concurrency":8,"warmup":15,"postgres_cpu_limit":"0.50","postgres_mem_limit":"384M","postgres_max_conns":10,"lb_cpu_limit":"1.00","client":"vm"}
+1
View File
@@ -0,0 +1 @@
{"label":"d2","replicas":2,"total_cpu":1.0,"total_mem_mb":768,"duration":60,"concurrency":8,"warmup":15,"postgres_cpu_limit":"0.50","postgres_mem_limit":"384M","postgres_max_conns":10,"lb_cpu_limit":"0.25","client":"vm"}
+1
View File
@@ -0,0 +1 @@
{"label":"db1cpu","replicas":2,"total_cpu":1.0,"total_mem_mb":768,"duration":60,"concurrency":8,"warmup":15,"postgres_cpu_limit":"1.00","postgres_mem_limit":"384M","postgres_max_conns":10,"lb_cpu_limit":"0.25","client":"vm"}
+1
View File
@@ -0,0 +1 @@
{"label":"g05","replicas":2,"total_cpu":0.5,"total_mem_mb":768,"duration":60,"concurrency":8,"warmup":15,"postgres_cpu_limit":"0.50","postgres_mem_limit":"384M","postgres_max_conns":10,"lb_cpu_limit":"0.25","client":"vm"}
+1
View File
@@ -0,0 +1 @@
{"label":"g10","replicas":2,"total_cpu":1.0,"total_mem_mb":768,"duration":60,"concurrency":8,"warmup":15,"postgres_cpu_limit":"0.50","postgres_mem_limit":"384M","postgres_max_conns":10,"lb_cpu_limit":"0.25","client":"vm"}
+1
View File
@@ -0,0 +1 @@
{"label":"g15","replicas":2,"total_cpu":1.5,"total_mem_mb":768,"duration":60,"concurrency":8,"warmup":15,"postgres_cpu_limit":"0.50","postgres_mem_limit":"384M","postgres_max_conns":10,"lb_cpu_limit":"0.25","client":"vm"}
+1
View File
@@ -0,0 +1 @@
{"label":"lb1cpu","replicas":2,"total_cpu":1.0,"total_mem_mb":768,"duration":60,"concurrency":8,"warmup":15,"postgres_cpu_limit":"0.50","postgres_mem_limit":"384M","postgres_max_conns":10,"lb_cpu_limit":"1.00","client":"vm"}
+1
View File
@@ -0,0 +1 @@
{"label":"pool10","replicas":4,"total_cpu":1.0,"total_mem_mb":768,"duration":60,"concurrency":8,"warmup":15,"postgres_cpu_limit":"0.50","postgres_mem_limit":"384M","postgres_max_conns":10,"lb_cpu_limit":"0.25","client":"vm"}
+1
View File
@@ -0,0 +1 @@
{"label":"pool5","replicas":4,"total_cpu":1.0,"total_mem_mb":768,"duration":60,"concurrency":8,"warmup":15,"postgres_cpu_limit":"0.50","postgres_mem_limit":"384M","postgres_max_conns":5,"lb_cpu_limit":"0.25","client":"vm"}
+1
View File
@@ -0,0 +1 @@
{"label":"r1","replicas":1,"total_cpu":1.0,"total_mem_mb":768,"duration":60,"concurrency":8,"warmup":15,"postgres_cpu_limit":"0.50","postgres_mem_limit":"384M","postgres_max_conns":10,"lb_cpu_limit":"0.25","client":"vm"}
+1
View File
@@ -0,0 +1 @@
{"label":"r2","replicas":2,"total_cpu":1.0,"total_mem_mb":768,"duration":60,"concurrency":8,"warmup":15,"postgres_cpu_limit":"0.50","postgres_mem_limit":"384M","postgres_max_conns":10,"lb_cpu_limit":"0.25","client":"vm"}
+1
View File
@@ -0,0 +1 @@
{"label":"r4","replicas":4,"total_cpu":1.0,"total_mem_mb":768,"duration":60,"concurrency":8,"warmup":15,"postgres_cpu_limit":"0.50","postgres_mem_limit":"384M","postgres_max_conns":10,"lb_cpu_limit":"0.25","client":"vm"}
Binary file not shown.

After

Width:  |  Height:  |  Size: 55 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 62 KiB

Some files were not shown because too many files have changed in this diff Show More