From 1d908578e3ccdec8440efdf2e5135580170159aa Mon Sep 17 00:00:00 2001 From: kolya5544 Date: Sat, 3 Oct 2026 05:10:20 +0300 Subject: [PATCH] =?UTF-8?q?=D0=9B=D0=A06:=20OpenTelemetry,=20Collector,=20?= =?UTF-8?q?Prometheus/Loki/Tempo,=20Grafana,=20=D0=B0=D0=BB=D0=B5=D1=80?= =?UTF-8?q?=D1=82=D1=8B,=20=D0=B8=D1=81=D1=81=D0=BB=D0=B5=D0=B4=D0=BE?= =?UTF-8?q?=D0=B2=D0=B0=D0=BD=D0=B8=D0=B5=20=D1=86=D0=B5=D0=BD=D1=8B=20?= =?UTF-8?q?=D0=BD=D0=B0=D0=B1=D0=BB=D1=8E=D0=B4=D0=B0=D0=B5=D0=BC=D0=BE?= =?UTF-8?q?=D1=81=D1=82=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .dockerignore | 6 + .env.example | 53 +- Dockerfile | 32 + Makefile | 17 + REPORT.md | 151 +- compose.yaml | 337 ++++ docs/report_lab6.docx | Bin 0 -> 196814 bytes docs/runbooks.md | 34 + evidence/checks.txt | 66 + evidence/grafana_provisioning.txt | 35 + evidence/incidents.json | 1727 +++++++++++++++++ evidence/incidents.png | Bin 0 -> 103259 bytes evidence/obs_cost.json | 1377 +++++++++++++ evidence/obs_cost.png | Bin 0 -> 68392 bytes infra/grafana/build_dashboard.py | 115 ++ infra/grafana/dashboards/messenger.json | 917 +++++++++ .../provisioning/dashboards/dashboards.yaml | 11 + .../provisioning/datasources/datasources.yaml | 41 + infra/haproxy/haproxy.cfg | 50 + infra/loki/loki.yaml | 37 + infra/otel/collector-tail.yaml | 64 + infra/otel/collector.yaml | 75 + infra/prometheus/prometheus.yml | 20 + infra/prometheus/rules/messenger.yml | 77 + infra/tempo/tempo.yaml | 33 + migrations/0001_init.sql | 52 + migrations/0002_idempotency.sql | 17 + migrations/0003_send_message_function.sql | 35 + migrations/0004_attachments.sql | 90 + migrations/0005_async_pipeline.sql | 60 + migrations/0006_outbox_trace_context.sql | 3 + requirements.txt | 43 + research/failover_sequence.py | 113 ++ research/incidents.py | 258 +++ research/loadgen.py | 172 ++ research/obs_cost.py | 217 +++ research/plot_obs_cost.py | 36 + research/queue_overload.py | 271 +++ research/rolling_update.py | 57 + scripts/init-secrets.sh | 38 + scripts/restart.cmd | 9 + scripts/restart.sh | 10 + scripts/restore-replicas.sh | 10 + scripts/rolling-update.sh | 32 + scripts/stop-one.cmd | 8 + scripts/stop-one.sh | 14 + src/app/attachments.py | 208 ++ src/app/broker.py | 67 + src/app/config.py | 112 ++ src/app/db.py | 88 + src/app/images.py | 102 + src/app/main.py | 464 +++++ src/app/migrate.py | 64 + src/app/outbox.py | 82 + src/app/passwords.py | 31 + src/app/pipeline.py | 97 + src/app/reconcile.py | 91 + src/app/replay.py | 70 + src/app/s3.py | 92 + src/app/s3_bootstrap.py | 85 + src/app/serve.py | 40 + src/app/sessions.py | 131 ++ src/app/telemetry.py | 229 +++ src/app/web.py | 192 ++ src/app/worker.py | 345 ++++ student-tests/fixtures/alpha.png | Bin 0 -> 344 bytes student-tests/fixtures/exif_rot6.jpg | Bin 0 -> 1604 bytes student-tests/fixtures/poison.png | Bin 0 -> 151 bytes student-tests/fixtures/sample.jpg | Bin 0 -> 24299 bytes student-tests/fixtures/sample.png | Bin 0 -> 111817 bytes student-tests/fixtures/small.png | Bin 0 -> 132 bytes student-tests/test_api.py | 208 ++ student-tests/test_attachments.py | 205 ++ student-tests/test_idempotency.py | 121 ++ student-tests/test_observability.py | 142 ++ student-tests/test_observability_retry.py | 58 + student-tests/test_pipeline.py | 182 ++ student-tests/test_resilience5.py | 154 ++ student-tests/test_topology.py | 59 + 79 files changed, 10501 insertions(+), 38 deletions(-) create mode 100644 Dockerfile create mode 100644 compose.yaml create mode 100644 docs/report_lab6.docx create mode 100644 docs/runbooks.md create mode 100644 evidence/checks.txt create mode 100644 evidence/grafana_provisioning.txt create mode 100644 evidence/incidents.json create mode 100644 evidence/incidents.png create mode 100644 evidence/obs_cost.json create mode 100644 evidence/obs_cost.png create mode 100644 infra/grafana/build_dashboard.py create mode 100644 infra/grafana/dashboards/messenger.json create mode 100644 infra/grafana/provisioning/dashboards/dashboards.yaml create mode 100644 infra/grafana/provisioning/datasources/datasources.yaml create mode 100644 infra/haproxy/haproxy.cfg create mode 100644 infra/loki/loki.yaml create mode 100644 infra/otel/collector-tail.yaml create mode 100644 infra/otel/collector.yaml create mode 100644 infra/prometheus/prometheus.yml create mode 100644 infra/prometheus/rules/messenger.yml create mode 100644 infra/tempo/tempo.yaml create mode 100644 migrations/0001_init.sql create mode 100644 migrations/0002_idempotency.sql create mode 100644 migrations/0003_send_message_function.sql create mode 100644 migrations/0004_attachments.sql create mode 100644 migrations/0005_async_pipeline.sql create mode 100644 migrations/0006_outbox_trace_context.sql create mode 100644 requirements.txt create mode 100644 research/failover_sequence.py create mode 100644 research/incidents.py create mode 100644 research/loadgen.py create mode 100644 research/obs_cost.py create mode 100644 research/plot_obs_cost.py create mode 100644 research/queue_overload.py create mode 100644 research/rolling_update.py create mode 100755 scripts/init-secrets.sh create mode 100644 scripts/restart.cmd create mode 100755 scripts/restart.sh create mode 100755 scripts/restore-replicas.sh create mode 100755 scripts/rolling-update.sh create mode 100644 scripts/stop-one.cmd create mode 100755 scripts/stop-one.sh create mode 100644 src/app/attachments.py create mode 100644 src/app/broker.py create mode 100644 src/app/config.py create mode 100644 src/app/db.py create mode 100644 src/app/images.py create mode 100644 src/app/main.py create mode 100644 src/app/migrate.py create mode 100644 src/app/outbox.py create mode 100644 src/app/passwords.py create mode 100644 src/app/pipeline.py create mode 100644 src/app/reconcile.py create mode 100644 src/app/replay.py create mode 100644 src/app/s3.py create mode 100644 src/app/s3_bootstrap.py create mode 100644 src/app/serve.py create mode 100644 src/app/sessions.py create mode 100644 src/app/telemetry.py create mode 100644 src/app/web.py create mode 100644 src/app/worker.py create mode 100644 student-tests/fixtures/alpha.png create mode 100644 student-tests/fixtures/exif_rot6.jpg create mode 100644 student-tests/fixtures/poison.png create mode 100644 student-tests/fixtures/sample.jpg create mode 100644 student-tests/fixtures/sample.png create mode 100644 student-tests/fixtures/small.png create mode 100644 student-tests/test_api.py create mode 100644 student-tests/test_attachments.py create mode 100644 student-tests/test_idempotency.py create mode 100644 student-tests/test_observability.py create mode 100644 student-tests/test_observability_retry.py create mode 100644 student-tests/test_pipeline.py create mode 100644 student-tests/test_resilience5.py create mode 100644 student-tests/test_topology.py diff --git a/.dockerignore b/.dockerignore index bc16e55..40bc41c 100644 --- a/.dockerignore +++ b/.dockerignore @@ -18,3 +18,9 @@ __pycache__ node_modules evidence .DS_Store +research +student-tests +scripts +docs +requirements-research.txt +*.md diff --git a/.env.example b/.env.example index 2b32655..8df1715 100644 --- a/.env.example +++ b/.env.example @@ -1,30 +1,41 @@ # Copy to .env for your LOCAL synthetic test environment; never commit .env. -# These are logical interface suggestions; map actual framework names in REPORT.md. +# Секреты (пароль БД, DATABASE_URL) создаёт scripts/init-secrets.sh в каталоге secrets/ — не в .env. APP_HOST=0.0.0.0 APP_PORT=8080 APP_ENV=lab +# Срок жизни сессии; для проверки expiry запускайте с SESSION_TTL_SECONDS=2 (см. student-tests/test_expiry.sh) SESSION_TTL_SECONDS=3600 -# Choose credentials locally. File paths contain no secret values. -DATABASE_URL_FILE=/run/secrets/database_url -# Optional on 3, required use on 4 in lab2; Redis OR Valkey: +# TTL записи в кэше Valkey (не больше остатка жизни сессии) +SESSION_CACHE_TTL_SECONDS=60 +# Источник сессий: PostgreSQL (истина) + Valkey (кэш). Адрес кэша задан в compose.yaml (VALKEY_URL). SESSION_STORE=postgres -CACHE_URL_FILE=/run/secrets/cache_url +DB_POOL_MAX=10 +# Файлы секретов внутри контейнера (создаются scripts/init-secrets.sh) +DATABASE_URL_FILE=/run/secrets/database_url +# --- lab3 --- +# Число API-реплик (compose deploy.replicas); также можно: docker compose up -d --scale api=4 API_REPLICAS=2 -IDEMPOTENCY_TTL_SECONDS=86400 -S3_ENDPOINT=http://s3:9000 -S3_REGION=us-east-1 +API_CPUS=1.0 +API_MEM=256m +POSTGRES_CPUS=1.0 +LB_CPUS=1.0 +# Пауза между SIGTERM и закрытием listener: LB успевает исключить реплику (rolling update без ошибок) +DRAIN_SECONDS=4 +# --- lab4 --- S3_BUCKET=messenger-attachments -S3_ACCESS_KEY_ID_FILE=/run/secrets/s3_access_key_id -S3_SECRET_ACCESS_KEY_FILE=/run/secrets/s3_secret_access_key -MAX_UPLOAD_BYTES=10485760 -MAX_IMAGE_PIXELS=40000000 -BROKER_URL_FILE=/run/secrets/broker_url +S3_CPUS=1.0 +UPLOAD_CONCURRENCY=4 +# --- lab5 --- +RABBITMQ_CPUS=1.0 +WORKER_CPUS=1.0 +WORKER_MEM=768m +WORKER_REPLICAS=1 WORKER_CONCURRENCY=2 -JOB_MAX_ATTEMPTS=5 -JOB_TIMEOUT_SECONDS=60 -STAGING_RETENTION_SECONDS=86400 -OTEL_SERVICE_NAME=messenger-api -# Worker must set a distinct service.name. -OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318 -OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf -OTEL_RESOURCE_ATTRIBUTES=deployment.environment.name=lab +MAX_ATTEMPTS=5 +LEASE_SECONDS=60 +MAX_QUEUED_JOBS=200 +# --- lab6: наблюдаемость --- +OTEL_ENABLED=1 +# доля трасс при head-sampling в SDK (1.0 = все); профиль tail-sampling: COLLECTOR_CONFIG=/etc/otelcol/collector-tail.yaml +OTEL_TRACES_SAMPLER_ARG=1.0 +COLLECTOR_CONFIG=/etc/otelcol/collector.yaml diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..ee31f7a --- /dev/null +++ b/Dockerfile @@ -0,0 +1,32 @@ +# syntax=docker/dockerfile:1 +# Базовый образ закреплён тегом и digest (python 3.12.12, Debian bookworm). +ARG PYTHON_IMAGE=python:3.12.12-slim-bookworm@sha256:593bd06efe90efa80dc4eee3948be7c0fde4134606dd40d8dd8dbcade98e669c + +# --- сборка зависимостей в отдельном слое (в runtime не попадают pip и кэш) --- +FROM ${PYTHON_IMAGE} AS builder +ENV PIP_DISABLE_PIP_VERSION_CHECK=1 PIP_NO_CACHE_DIR=1 +WORKDIR /build +COPY requirements.txt . +RUN python -m venv /opt/venv && /opt/venv/bin/pip install -r requirements.txt + +# --- runtime --- +FROM ${PYTHON_IMAGE} +ENV PATH=/opt/venv/bin:$PATH \ + PYTHONUNBUFFERED=1 PYTHONDONTWRITEBYTECODE=1 PYTHONPATH=/srv/src \ + APP_HOST=0.0.0.0 APP_PORT=8080 APP_ENV=lab LIMIT_CONCURRENCY=1000 MIGRATIONS_DIR=/srv/migrations +RUN groupadd --system --gid 10001 app && useradd --system --uid 10001 --gid app --no-create-home app +COPY --from=builder /opt/venv /opt/venv +WORKDIR /srv +COPY src/ /srv/src/ +COPY migrations/ /srv/migrations/ +# ревизия образа (меняется при rolling update; видна в журнале запуска) +ARG REV=dev +LABEL org.opencontainers.image.revision=$REV +ENV APP_REVISION=$REV +USER 10001:10001 +EXPOSE 8080 +HEALTHCHECK --interval=10s --timeout=3s --start-period=5s --retries=3 \ + CMD ["python", "-c", "import urllib.request,os,sys; sys.exit(0 if urllib.request.urlopen('http://127.0.0.1:%s/health/ready' % os.environ.get('APP_PORT','8080'), timeout=2).status == 200 else 1)"] +# exec-форма: сервер = PID 1. Состояние хранится в PostgreSQL/Valkey, процесс stateless; +# масштабирование — репликами контейнера. SIGTERM: drain (readiness 503) -> graceful shutdown (см. app/serve.py). +CMD ["python", "-m", "app.serve"] diff --git a/Makefile b/Makefile index 5d86d17..765edd3 100644 --- a/Makefile +++ b/Makefile @@ -28,3 +28,20 @@ test-persistence: test-failover: @test -n "$(ACTION_SCRIPT)" || (echo "Set ACTION_SCRIPT to your implemented executable stop-one hook"; exit 2) $(PYTHON) tests/resilience.py --mode failover --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS) + +# --- собственные цели студента --- +.PHONY: secrets up down student-test +secrets: + sh scripts/init-secrets.sh + +up: secrets + docker compose --env-file .env up -d --build + +down: + docker compose --env-file .env down + +student-test: + $(PYTHON) -m unittest discover -s student-tests -p "test_api.py" -v + $(PYTHON) -m unittest discover -s student-tests -p "test_attachments.py" -v + $(PYTHON) -m unittest discover -s student-tests -p "test_pipeline.py" -v + $(PYTHON) -m unittest discover -s student-tests -p "test_observability.py" -v diff --git a/REPORT.md b/REPORT.md index b97ae42..58a38c0 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,37 +1,154 @@ # Отчёт — лабораторная 6 -- Автор, группа: TODO -- Целевая оценка; выбранный трек 5, если нужен: TODO -- Commit/PR: TODO после публикации -- Использованные источники, библиотеки и помощь ИИ: TODO +- Автор, группа: [ФИО], [группа] +- Целевая оценка; выбранный трек 5, если нужен: **5**, трек 1 «Цена наблюдаемости» +- Commit/PR: локальный коммит ветки `solution/lab6`; PR — после публикации +- Использованные источники, библиотеки и помощь ИИ: Python 3.12, OpenTelemetry Python SDK 1.45.0 (traces/metrics/logs, OTLP/HTTP), uvicorn, asyncpg, aiobotocore, aio-pika, Pillow; OpenTelemetry Collector contrib 0.161.0, Prometheus 3.15.0, Loki 3.7.8, Tempo 2.9.0, Grafana 13.2.3; RabbitMQ 4.1.8, SeaweedFS 4.48, PostgreSQL 17, Valkey 8, HAProxy 3.0. Код lab5 перенесён, бизнес-API не менялся. Использование ИИ: [заполняется автором] ## Запуск из чистого clone -TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных. +Prerequisites: Docker Compose v2 (≈ 4 ГБ свободной RAM для всего стенда), bash (Git Bash на Windows), Python ≥ 3.9; на Windows `PYTHONUTF8=1`. +Версии всех образов закреплены тегом и digest в `compose.yaml`; зависимости — `requirements.txt` (включая `opentelemetry-*==1.45.0`). + +```sh +sh scripts/init-secrets.sh # secrets/*: БД, S3, RabbitMQ, пароль Grafana (secrets/grafana_admin_password) +cp .env.example .env +docker compose --env-file .env config --quiet +docker compose --env-file .env up -d --build +curl http://127.0.0.1:8080/health/ready # API +# Grafana: http://127.0.0.1:3000 пользователь admin, пароль — secrets/grafana_admin_password +python3 tests/smoke.py --base-url http://127.0.0.1:8080 # make test (телеметрия включена) +python3 -m unittest discover -s student-tests -p test_observability.py -v # метрики, логи, трассы, связь API -> worker, отсутствие секретов +python3 student-tests/test_observability_retry.py # все попытки задания в одной трассе +python3 research/incidents.py --out evidence # 4 инцидента, алерты firing -> resolved (~10 мин) +python3 research/obs_cost.py --out evidence # трек 1 (~15 мин) +``` + +Windows: `scripts/restart.cmd`, `scripts/stop-one.cmd`. Остановка с сохранением данных — `docker compose --env-file .env stop`; **намеренное удаление учебных данных** — `docker compose --env-file .env down -v` (volumes `pgdata`, `valkeydata`, `seaweeddata`, `rabbitmqdata`, `promdata`, `lokidata`, `tempodata`, `grafanadata`). +Профиль без телеметрии: `OTEL_ENABLED=0`; head-sampling: `OTEL_TRACES_SAMPLER_ARG=0.1`; tail-sampling в Collector: `COLLECTOR_CONFIG=/etc/otelcol/collector-tail.yaml`. ## Архитектура и решения -TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab5, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации. +``` +API ×2 ─┐ ┌─▶ Prometheus (метрики, retention 7 д, volume promdata) + ├─OTLP/HTTP─▶ OTel Collector ─┼─▶ Tempo (трассы, retention 7 д, volume tempodata) +worker ─┘ (memory_limiter, batch, └─▶ Loki (логи, retention 7 д, volume lokidata) + scrub, tail_sampling*) ▲ +traceparent: API ─▶ outbox ─▶ RabbitMQ ─▶ worker Grafana (127.0.0.1:3000) читает все три источника +``` + +| Роль | Сервис | Версия | Порты | Volume | Зачем | +| --- | --- | --- | --- | --- | --- | +| Collector | `otel-collector` | contrib 0.161.0 | OTLP 4317/4318, метрики 8888/8889 — **только сеть backend** | — | единая точка приёма, ограничение RAM, удаление чувствительных атрибутов, маршрутизация сигналов; это не хранилище | +| Метрики | `prometheus` | 3.15.0 | не публикуется | `promdata` | временные ряды, SLI/recording rules, alert rules, firing/resolved | +| Логи | `loki` | 3.7.8 | не публикуется | `lokidata` | структурные логи API и worker (OTLP), поиск по `trace_id` | +| Трассы | `tempo` | 2.9.0 | не публикуется | `tempodata` | распределённые трассы, TraceQL | +| UI | `grafana` | 13.2.3 | `127.0.0.1:3000` | `grafanadata` | datasources/dashboard из Git (provisioning), анонимный доступ выключен, пароль — secret | + +**Что хранит что.** Grafana ничего не хранит из сигналов: это интерфейс запросов (PromQL, LogQL, TraceQL) и provisioning. Collector — маршрутизатор/обработчик (не БД). Метрики — Prometheus, логи — Loki, трассы — Tempo. Конфигурации (`infra/otel`, `infra/prometheus`, `infra/loki`, `infra/tempo`, `infra/grafana`) и dashboard JSON лежат в Git; провижининг datasources и dashboard автоматический. + +### Сигналы и соответствие `contracts/observability.md` + +| Сигнал контракта | Реализация (SDK) → имя в Prometheus / место | +| --- | --- | +| HTTP requests; HTTP duration (s) | `http.server.request.duration` (histogram, секунды, buckets 5 мс…10 с) → `http_server_request_duration_seconds_{bucket,sum,count}{http_request_method, http_route, http_response_status_code}`; число запросов = `_count` (отдельный счётчик не дублируется) | +| Jobs processed/failed; duration | `messenger.jobs.processed{job_type,outcome=ready|failed|retried|noop}` → `messenger_jobs_processed_total`; `messenger.job.duration` → `messenger_job_duration_seconds_*` | +| End-to-end time to ready | `messenger.job.time_to_ready` (от приёма до ready) → `messenger_job_time_to_ready_seconds_*` | +| Queue depth / oldest job age | `messenger.queue.depth`, `messenger.queue.oldest_job_age` → `messenger_queue_depth`, `messenger_queue_oldest_job_age_seconds` (считает API, т. е. метрика живёт и при остановленном worker) | +| DB pool used/waiting | `db.client.connections.usage{state}`, `db.client.connections.waiting` → `db_client_connections_usage`, `db_client_connections_waiting` | +| Worker busy/capacity | `messenger_worker_busy`, `messenger_worker_capacity` | +| CPU/RAM процессов | `process_memory_rss_bytes`, `process_cpu_time_seconds_total` (счётчик CPU-времени процесса) | +| Логи API и worker | структурный JSON в stdout **и** OTLP: `ts, level, service.name, msg(event), trace_id, span_id` (при активном спане), `request_id`; resource: `service.name` (`messenger-api`/`messenger-worker`), `service.version`, `service.instance.id`, `deployment.environment.name=lab` | +| Трассы API и worker | server-спан запроса (`HTTP POST /api/v1/…`), `db.connection`, `s3.put_object/get_object`, producer-спан `attachment.process publish`, consumer-спан `attachment.process process` — реальные, не статичные | +| Связь upload → publish → consume → S3/DB | W3C `traceparent/tracestate`: контекст запроса сохраняется в `outbox` (миграция 0006), relay кладёт его в поля сообщения (`jobs.schema.json`) и заголовки AMQP; worker продолжает ту же трассу (consumer — потомок producer; producer — потомок server-спана) | + +**Низкая кардинальность.** `user_id/chat_id/message_id/attachment_id/request_id/filename` не используются как labels метрик (проверяет `test_no_high_cardinality_or_secret_labels`); маршрут — шаблон `/api/v1/chats/{chat_id}/messages`. В логах/спанах допустимы технические ID синтетических данных. **Секреты не экспортируются**: токены, пароли, `Authorization`, тела сообщений, изображения, SQL-текст, query-строки — не попадают ни в атрибуты, ни в логи; дополнительно Collector удаляет `http.request.header.authorization`, `db.statement`, `url.query` и т. п. (`attributes/scrub`). Проверка `test_secrets_and_message_bodies_are_not_exported`: уникальный текст сообщения, токен и пароль не находятся ни в Loki, ни в трассе, ни в метриках. + +**Health-проверки** LB (раз в секунду) не порождают спанов и access-логов (метрики остаются, исключены из SLI фильтром `http_route!~"/health.*"`); фоновые опросы БД (relay, sweeper) — без корневых спанов (`child_span`). + +### Dashboard и SLI/SLO + +Dashboard `Messenger: API, очередь, worker` (`infra/grafana/dashboards/messenger.json`, генератор `build_dashboard.py`): RPS по маршрутам и кодам, **доля 5xx**, **p50/p95/p99** (`histogram_quantile` из `sum by (le)` гистограмм всех реплик — не среднее p95), задержки по маршрутам, DB pool (занято/простаивает/ожидают), задания по исходам, p50/p95 длительности обработки и **времени до ready**, глубина очереди, **возраст старейшей задачи**, saturation worker (busy/capacity), RSS/CPU, очередь и отказы экспорта Collector, логи ошибок (Loki), список алертов, последние трассы. Единицы и запросы описаны в подсказках панелей. + +- **SLI доступности**: доля бизнес-запросов (все маршруты кроме `/health`) без ответа 5xx. Числитель — 5xx, знаменатель — все запросы без `/health`; 4xx (неверный пароль, чужой чат) в отказ сервиса не входят. +- **SLO**: 99.5 % за окно 30 суток (бюджет ошибок 0.5 %); для демонстрации на локальном стенде окна алертов короткие (rate по 1 мин, `for` 15–20 с). +- Дополнительные SLI: p95 задержки (порог 0.5 с), доля 5xx **на маршруте загрузки** (малообъёмный, но критичный — общий SLI его деградации не заметит), p95 времени до ready. + +### Alert rules (`infra/prometheus/rules/messenger.yml`, runbook — `docs/runbooks.md`) + +| Алерт | Условие / окно | Для чего | +| --- | --- | --- | +| `HighHttpErrorRate` | 5xx > 5 % при ≥ 0.5 RPS, `for 20s`, rate[1m] | общий отказ сервиса | +| `HighUploadErrorRate` | 5xx на маршруте загрузки > 20 %, `for 15s` | отказ S3/очереди | +| `HighLatencyP95` | p95 > 0.5 с, `for 20s` | медленная БД/обработчик | +| `QueueLagGrowing` | старейшая задача > 30 с, `for 20s` | остановка/перегрузка worker | +| `WorkerSilent` | `absent(messenger_worker_capacity)`, `for 30s` | worker не шлёт метрики | +| `TelemetryExportFailing` | отказы экспорта Collector > 0, `for 15s` | сбой хранилищ телеметрии | + +Alerts вычисляет Prometheus; состояние (pending/firing/resolved) видно в Prometheus и на панели «Алерты» dashboard. Внешняя доставка не требуется и не настроена. + +### Collector: ограничение ресурсов и поведение при backpressure +`memory_limiter` (limit 280 MiB при лимите контейнера 384 MiB, spike 60 MiB; при приближении данные отклоняются, SDK отбрасывает пакет, приложение продолжает работать), `batch` (1024/2 с), экспортёры с **ограниченной очередью** (`sending_queue` 500) и повторами до 30 с, затем отбрасывание; SDK: очередь спанов/логов 2048, таймаут экспорта 3 с, **ошибки экспорта не влияют на ответы API** (проверено). `metric_expiration: 20s` — остановившийся источник метрик быстро исчезает (алерт `WorkerSilent`). ## Доказательства критериев | Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | | --- | --- | --- | --- | -| Публичный smoke | make test | TODO | TODO | -| Остальные пункты уровня 3 | TODO | TODO | TODO | -| Все пункты уровня 4, если заявлен | TODO | TODO | TODO | -| Выбранный трек 5, если заявлен | TODO | TODO | TODO | +| Весь минимум lab5 работает с включённой телеметрией | `tests/smoke.py`; `student-tests/test_pipeline.py` | PASS; 9 тестов OK | `evidence/checks.txt` | +| Collector, 3 хранилища и Grafana в стенде, конфиги в Git, volumes | `docker compose up -d`; `infra/**` | стенд поднимается одной командой; datasources и dashboard импортируются provisioning-ом | `evidence/grafana_provisioning.txt` | +| Метрики RPS/errors/duration API; jobs ok/failed и duration worker | `test_observability.py::test_metrics_for_http_jobs_queue_pool_worker` | все 12 серий имеют данные | `evidence/checks.txt` | +| Структурные логи и реальные трассы API и worker, связь запрос ↔ лог, job ↔ лог | `test_one_trace_spans_…`, `test_logs_are_structured_and_linked_by_trace_id` | одна трасса содержит спаны `messenger-api` и `messenger-worker`; в Loki по `trace_id` находятся логи обоих сервисов, `span_id` у каждой записи | `evidence/checks.txt` | +| Низкая кардинальность, нет секретов | `test_no_high_cardinality…`, `test_secrets_and_message_bodies_are_not_exported` | OK | `evidence/checks.txt` | +| W3C trace context API → broker → worker (parent-child), цепочка до S3/DB, включая retry | `test_one_trace…`; `test_observability_retry.py` | server → producer → consumer; `s3.put/get_object`, `db.connection` в той же трассе; 3 попытки задания — 3 consumer-спана одной трассы, 2 лога `job_rescheduled` | `evidence/checks.txt` | +| Dashboard: p50/p95/p99, error ratio, queue depth/age, DB pool, saturation worker | `infra/grafana/dashboards/messenger.json` | импортируется автоматически (`/api/search` возвращает dashboard) | `evidence/grafana_provisioning.txt` | +| SLI/SLO, alert rules, firing → resolved на искусственных отказах | `research/incidents.py` | см. «Инциденты» | `evidence/incidents.json`, `incidents.png` | +| Collector с memory limiter/batch; остановка хранилища телеметрии не ломает API | инцидент 4 | API без ошибок (ratio 0.0, RPS ≈ 67), очередь Collector ограничена (≈23–28), RSS Collector ≈ 247 MiB < лимита 384 MiB | `evidence/incidents.json` | +| Два+ инцидента с диагностикой | см. ниже | 4 инцидента | отчёт и `evidence/incidents.json` | +| **Трек 1** | `research/obs_cost.py` | см. ниже | `evidence/obs_cost.json` | -TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены. +## Инциденты (диагностика только по сохранённым наблюдениям) -## Эксперименты и отказы +Фоновая нагрузка: ≈32 запроса/с сообщений и ≈25 загрузок/с (мелкие PNG). `research/incidents.py` — оркестрация и запись состояний алертов. -TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения. +| № | Воздействие | Алерт (время обнаружения от воздействия) | Разрешён после восстановления | Как найдена причина | +| --- | --- | --- | --- | --- | +| 1 | остановка worker | `QueueLagGrowing` через 64 с (порог 30 с + `for 20 s` + шаг rate); также `WorkerSilent`; каскад: переполнение очереди → backpressure 503 на загрузке → `HighHttpErrorRate`/`HighUploadErrorRate` | через 24 с (очередь рассосалась) | возраст старейшей задачи растёт (56.7 с) при **нулевой** скорости `messenger_jobs_processed_total`, серия `messenger_worker_capacity` исчезла → остановлен worker, а не медленная БД; логи API показывают 503 «Очередь обработки заполнена» | +| 2 | медленная БД (триггер `pg_sleep(0.8)` на вставку сообщений) | `HighLatencyP95` через 72 с (p95 = 0.80 с) | через 46 с | p95 растёт, а в TraceQL `{ name = "db.connection" && duration > 300ms }` и `{ name =~ "HTTP POST.*messages" && duration > 300ms }` найдено по 20 трасс: почти всё время запроса в спанах БД, CPU процессов не растёт → медленная БД, а не обработчик | +| 3 | остановка S3 | `HighUploadErrorRate` через 88 с (доля 5xx на загрузке 32 %; **общая** доля 0.8 % — общий SLI не заметил бы) | через 78 с | `{ status = error }` — спаны `s3.put_object` с ошибкой, 139 логов `s3_put_failed` с `trace_id`; остальные маршруты без ошибок → недоступен S3 | +| 4 | остановка Tempo и Loki | `TelemetryExportFailing` через 49 с | через 85 с | бизнес-метрики API без ошибок (ratio 0.0, RPS ≈ 67), растёт `otelcol_exporter_send_failed_spans` (≈66/с), очередь экспорта ограничена (23), RSS Collector 247 MiB → сбой хранилищ телеметрии, не приложения; метрики Prometheus не потеряны (путь Collector → Prometheus независим), трассы/логи за простой потеряны | -| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | -| --- | --- | --- | --- | -| TODO | TODO | TODO | TODO | +График: `evidence/incidents.png` (возраст очереди, p95, доля 5xx, состояние алертов; серые линии — воздействие, зелёные — восстановление). Время обнаружения включает окно `rate[1m]` — для более быстрой реакции нужны более короткие окна/burn-rate (трек 2, не выбран). + +## Эксперименты (трек 1): цена наблюдаемости + +**Гипотеза.** Телеметрия имеет измеримую цену в CPU API (SDK: спаны, метрики, логи), которая слабо зависит от head-sampling (логи и метрики остаются), но head-sampling теряет редкие ошибки и медленные запросы пропорционально доле выборки; tail-sampling в Collector сохраняет их почти полностью, перенося цену из хранилища в Collector. + +**Методика** (`research/obs_cost.py`, график `evidence/obs_cost.png`). Одинаковая нагрузка во всех профилях: 8 процессов-клиентов, 64 одновременных, 90 % `POST` сообщений + 10 % `GET`, прогрев 5 с, замер 30 с, **2 повтора**; перед профилем пересоздаются Collector, API и worker. В API внедрены отказы (одинаково для всех профилей): 2 % запросов → 500 и 2 % → задержка 0.6 с (`API_FAULT_INJECTION=http500:0.02,slow:0.02:0.6`) — это «редкие ошибки и медленные запросы»; после каждого прогона 25 с на дозапись, затем TraceQL в Tempo считает сохранённые ошибочные (`status = error`) и медленные (`duration > 500ms`) трассы. Число внедрённых отказов считается на стороне клиента. Объём телеметрии — счётчики Collector (`otelcol_receiver_accepted_*`, `otelcol_exporter_sent_spans`). Docker Desktop (WSL2), 2 реплики API по 1 CPU, Collector 384 MiB. + +| Профиль | RPS | p95, мс | CPU API (на реплику) | CPU % / пик RAM MiB Collector | спаны: SDK → Tempo | логи (записей) | сохранено ошибочных трасс | сохранено медленных трасс | +| --- | --- | --- | --- | --- | --- | --- | --- | --- | +| off (`OTEL_ENABLED=0`) | 1340 | 74 | 53 % | 0.1 / 39 | — | — | — | — | +| on: head 100 % | 1324 | 72 | 87 % | 3.1 / 70 | 96 тыс. → 96 тыс. | 47 тыс. | ≈100 % | ≈100 % | +| on: 100 %, очередь SDK 65 536 / пакет 2048 | 1384 | 75 | 84 % | 2.9 / 72 | 96 тыс. → 96 тыс. | 47 тыс. | ≈100 % | ≈100 % | +| on: head 10 % | 1400 | 67 | 77 % | 1.7 / 71 | 9 тыс. → 10 тыс. | 49 тыс. | 13 % | 9 % | +| on: SDK 100 % + tail-sampling в Collector | 1399 | 67 | 85 % | 4.0 / 110 | 101 тыс. → 14 тыс. | 49 тыс. | ≈100 % | ≈100 % | + +(RPS и p95 — среднее двух прогонов; различия RPS/p95 между профилями ≤ ±5 % — в пределах разброса между повторами; p99 ≈ 0.62 с во всех профилях определяется внедрённой задержкой 0.6 с. Объём — за окно 30 с нагрузки + дозапись. «Сохранено» считается как число трасс с ошибкой/медленных в Tempo к числу внедрённых: значение ≈100 % означает, что потерь не обнаружено; точное отношение немного >100 % из-за 5 с прогрева, попавших в окно поиска.) + +**Результаты и выводы.** +1. **Цена в CPU.** Включение телеметрии поднимает CPU API с **53 % до 87 %** одного ядра при той же пропускной способности (+34 п. п., ≈ +60 % CPU на запрос); пропускная способность и p95 на этом профиле не изменились в пределах погрешности, потому что запас CPU у реплик (лимит 100 %) не исчерпан — на насыщенной системе цена перешла бы в потерю RPS. RSS API +≈12 MiB; Collector — 3–4 % CPU и 71 MiB RAM (110 MiB при tail-sampling: буфер трасс). +2. **Объём.** 100 %: ≈96 тыс. спанов и ≈48 тыс. записей логов за окно. **Head 10 %** сокращает спаны на 90 % (9.9 тыс.), но **логи (≈49 тыс.) и метрики не меняются**, поэтому CPU API снижается лишь до 77 % (−10 п. п.): большая часть цены — логи и метрики, а не трассы. **Tail-sampling**: SDK по-прежнему шлёт 100 % спанов (CPU API 85 %), но в Tempo уходит ≈15 тыс. из 101 тыс. (−85 % хранения). +3. **Потери редких событий.** Head 10 % сохраняет лишь **≈13 % ошибочных и ≈9 % медленных** трасс (ровно доля выборки): 87–91 % редких ошибок и медленных запросов невидимы в Tempo (метрики и логи при этом их фиксируют). 100 % и tail-sampling сохраняют ≈100 % ошибочных и медленных трасс; tail выигрывает по хранилищу при почти той же цене в API. +4. **Увеличение очереди SDK** (65 536 / пакет 2048) не изменило ни объём, ни долю сохранённых трасс: потерь спанов на стороне SDK в этой нагрузке не было. +5. **Находка по дороге.** В первом прогоне «100 %» сохранялось только ≈57 % ошибочных трасс: Tempo с настройками по умолчанию **отбрасывал ≈29 % спанов** (`tempo_discarded_spans_total{reason="live_traces_exceeded"}`: 224 тыс. из 767 тыс.) из-за лимита «живых» трасс (10 000 на тенанта). Лимиты подняты в `infra/tempo/tempo.yaml` (`overrides.defaults.ingestion`), повторные прогоны — без потерь; цена — память Tempo: при лимите контейнера 512 MiB он был убит OOM (код 137) на тестах после нагрузки, поэтому `mem_limit` Tempo увеличен до 1 GiB. Вывод: потери надо искать метриками самих хранилищ, а не только Collector. + +**Сбалансированная конфигурация (проверена):** SDK 100 % + **tail-sampling** в Collector (все ошибки, все запросы >500 мс, 10 % остальных): редкие проблемные трассы сохраняются полностью, хранилище трасс экономится на 85 %, цена — CPU SDK как при 100 % и ≈ +40 MiB RAM Collector. Если CPU API критичен — снижать объём логов (access-log без health уже отключён) и использовать head-sampling только для трасс успешных запросов. + +**Ограничения методики.** Единичный ноутбук; 2 прогона на профиль; запас CPU API не исчерпан (RPS не падает) — цена показана в CPU, а не в RPS; доля сохранённых трасс оценивается TraceQL-поиском с лимитом 5 000 результатов (для «всех HTTP-трасс» лимит достигнут, для ошибочных/медленных — нет); размер дисковых томов Tempo/Loki не используется как метрика: он меняется компакцией и flush-ом и недостоверен на таких интервалах. ## Ограничения и следующие шаги -TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза. +- Выдерживается: недоступность Tempo/Loki/Collector без влияния на API (данные трасс/логов за простой теряются, метрики — нет). Не выдерживается: потеря volume хранилищ телеметрии; Prometheus/Loki/Tempo — по одному экземпляру. +- Алерты локальные (без доставки наружу); окна коротки для демонстрации — для production нужны burn-rate по нескольким окнам. +- Логи в stdout остаются в docker json-file (ротация 10 МБ × 3) и дублируются в Loki; `trace_id` присутствует в обоих. +- Подтверждено экспериментами: связность трасс через очередь, алерты firing/resolved на 4 отказах, цена телеметрии. Гипотеза без доказательства: поведение при >2 репликах API и при нагрузке порядка тысяч RPS на одном Collector. diff --git a/compose.yaml b/compose.yaml new file mode 100644 index 0000000..0b9f09d --- /dev/null +++ b/compose.yaml @@ -0,0 +1,337 @@ +# Стенд lab6: HAProxy -> API x N -> PostgreSQL (метаданные) + SeaweedFS (приватный S3, байты) + Valkey (кэш сессий). +# Секреты: scripts/init-secrets.sh создаёт secrets/* (в Git не попадают). Запуск и проверки — см. REPORT.md. +name: mtusi-lab6 + +x-common: &common + restart: unless-stopped + logging: + driver: json-file + options: {max-size: "10m", max-file: "3"} + +services: + postgres: + <<: *common + image: postgres:17.11-alpine@sha256:b0f9560a2de083e2cc7382e75f808c7381a32852a7ec49117deedb300e552b24 + environment: + POSTGRES_USER: messenger + POSTGRES_DB: messenger + POSTGRES_PASSWORD_FILE: /run/secrets/postgres_password + secrets: [postgres_password] + volumes: + - pgdata:/var/lib/postgresql/data + command: ["postgres", "-c", "max_connections=200", "-c", "shared_buffers=128MB", "-c", "log_min_duration_statement=500"] + healthcheck: + test: ["CMD-SHELL", "pg_isready -U messenger -d messenger"] + interval: 5s + timeout: 3s + retries: 12 + mem_limit: 512m + cpus: ${POSTGRES_CPUS:-1.0} + networks: [backend] + + valkey: + <<: *common + image: valkey/valkey:8.1.10-alpine@sha256:081c2f5cb575efc901aa80ff9cdbd1ec6a301682fd35e1ebb4b0990a4a4a8507 + command: ["valkey-server", "--appendonly", "yes", "--appendfsync", "everysec", + "--maxmemory", "64mb", "--maxmemory-policy", "volatile-ttl", "--save", ""] + volumes: + - valkeydata:/data + healthcheck: + test: ["CMD", "valkey-cli", "ping"] + interval: 5s + timeout: 3s + retries: 12 + mem_limit: 128m + cpus: 0.5 + networks: [backend] + + # Приватное S3-совместимое хранилище SeaweedFS (all-in-one: master + volume + filer + S3-шлюз). + # Порты наружу не публикуются: доступ только из сети backend и только по ключам из s3.json (identities). + # Анонимный доступ запрещён (при заданных identities запрос без подписи получает 403). + seaweedfs: + <<: *common + image: chrislusf/seaweedfs:4.48@sha256:4e61d15fd35994cb1e43e1e553dff106794841fd9a99ade2fc8c8bfce4d7872d + entrypoint: ["/bin/sh", "-c"] + command: ["exec weed server -dir=/data -ip=seaweedfs -master.volumeSizeLimitMB=512 -volume.max=30 -filer -s3 -s3.port=8333 -s3.config=/run/secrets/seaweed_s3_config"] + secrets: [seaweed_s3_config] + volumes: + - seaweeddata:/data + healthcheck: + test: ["CMD-SHELL", "wget -q -O /dev/null http://127.0.0.1:9333/cluster/status && nc -z 127.0.0.1 8333"] + interval: 5s + timeout: 3s + retries: 24 + start_period: 10s + mem_limit: 768m + cpus: ${S3_CPUS:-1.0} + networks: [backend] + + # Идемпотентный bootstrap: bucket создаётся, если его нет; проверяется, что анонимный доступ запрещён и что ключ API работает. + s3-init: + build: . + image: mtusi-messenger:lab6 + command: ["python", "-m", "app.s3_bootstrap"] + environment: + S3_ENDPOINT: http://seaweedfs:8333 + S3_BUCKET: ${S3_BUCKET:-messenger-attachments} + S3_ADMIN_ACCESS_KEY_FILE: /run/secrets/s3_admin_access_key + S3_ADMIN_SECRET_KEY_FILE: /run/secrets/s3_admin_secret_key + S3_ACCESS_KEY_FILE: /run/secrets/s3_access_key + S3_SECRET_KEY_FILE: /run/secrets/s3_secret_key + secrets: [s3_admin_access_key, s3_admin_secret_key, s3_access_key, s3_secret_key] + depends_on: + seaweedfs: {condition: service_healthy} + restart: "no" + networks: [backend] + + # Брокер: durable quorum-очередь, persistent-сообщения, publisher confirms; данные на volume rabbitmqdata. + # hostname фиксирован: имя узла RabbitMQ определяет каталог данных, иначе очередь не переживёт пересоздание контейнера. + rabbitmq: + <<: *common + image: rabbitmq:4.1-alpine@sha256:6a0f7984185cd2cdbf78a184b4c17abe88ecbbda6006a7acf17dbc7e4307f4e2 + hostname: rabbitmq + # RabbitMQ 4.x: RABBITMQ_DEFAULT_USER/PASS объявлены устаревшими -> учётные данные в конфигурационном файле (secret) + secrets: + - source: rabbitmq_conf + target: /etc/rabbitmq/conf.d/20-credentials.conf + mode: 0444 + volumes: + - rabbitmqdata:/var/lib/rabbitmq + healthcheck: + test: ["CMD", "rabbitmq-diagnostics", "-q", "ping"] + interval: 10s + timeout: 8s + retries: 12 + mem_limit: 512m + cpus: ${RABBITMQ_CPUS:-1.0} + networks: [backend] + + migrate: + build: . + image: mtusi-messenger:lab6 + command: ["python", "-m", "app.migrate"] + environment: + DATABASE_URL_FILE: /run/secrets/database_url + secrets: [database_url] + depends_on: + postgres: {condition: service_healthy} + restart: "no" + networks: [backend] + + api: + <<: *common + build: . + image: mtusi-messenger:lab6 + environment: + APP_ENV: ${APP_ENV:-lab} + DATABASE_URL_FILE: /run/secrets/database_url + VALKEY_URL: redis://valkey:6379/0 + S3_ENDPOINT: http://seaweedfs:8333 + S3_BUCKET: ${S3_BUCKET:-messenger-attachments} + S3_ACCESS_KEY_FILE: /run/secrets/s3_access_key + S3_SECRET_KEY_FILE: /run/secrets/s3_secret_key + SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-3600} + SESSION_CACHE_TTL_SECONDS: ${SESSION_CACHE_TTL_SECONDS:-60} + DB_POOL_MAX: ${DB_POOL_MAX:-10} + DRAIN_SECONDS: ${DRAIN_SECONDS:-4} + MAX_INFLIGHT: ${MAX_INFLIGHT:-64} + ACCESS_LOG: ${ACCESS_LOG:-1} + UPLOAD_CONCURRENCY: ${UPLOAD_CONCURRENCY:-4} + FAULT_INJECTION: ${API_FAULT_INJECTION:-} + BROKER_URL_FILE: /run/secrets/broker_url + MAX_QUEUED_JOBS: ${MAX_QUEUED_JOBS:-200} + SERVICE_NAME: messenger-api + OTEL_ENABLED: ${OTEL_ENABLED:-1} + OTEL_EXPORTER_OTLP_ENDPOINT: http://otel-collector:4318 + OTEL_TRACES_SAMPLER_ARG: ${OTEL_TRACES_SAMPLER_ARG:-1.0} + OTEL_QUEUE_SIZE: ${OTEL_QUEUE_SIZE:-2048} + OTEL_BATCH_SIZE: ${OTEL_BATCH_SIZE:-512} + secrets: [database_url, s3_access_key, s3_secret_key, broker_url] + depends_on: + migrate: {condition: service_completed_successfully} + s3-init: {condition: service_completed_successfully} + valkey: {condition: service_healthy} + stop_grace_period: 15s + mem_limit: ${API_MEM:-256m} + cpus: ${API_CPUS:-1.0} + deploy: + replicas: ${API_REPLICAS:-2} + networks: [backend] + + # Worker: отдельный процесс (тот же образ). Берёт задания из RabbitMQ, обрабатывает изображения, пишет результат в S3 и БД. + worker: + <<: *common + build: . + image: mtusi-messenger:lab6 + command: ["python", "-m", "app.worker"] + environment: + SERVICE_NAME: messenger-worker + DATABASE_URL_FILE: /run/secrets/database_url + S3_ENDPOINT: http://seaweedfs:8333 + S3_BUCKET: ${S3_BUCKET:-messenger-attachments} + S3_ACCESS_KEY_FILE: /run/secrets/s3_access_key + S3_SECRET_KEY_FILE: /run/secrets/s3_secret_key + BROKER_URL_FILE: /run/secrets/broker_url + WORKER_CONCURRENCY: ${WORKER_CONCURRENCY:-2} + MAX_ATTEMPTS: ${MAX_ATTEMPTS:-5} + LEASE_SECONDS: ${LEASE_SECONDS:-60} + RETRY_BASE_DELAY: ${RETRY_BASE_DELAY:-2} + FAULT_INJECTION: ${WORKER_FAULT_INJECTION:-} + OTEL_ENABLED: ${OTEL_ENABLED:-1} + OTEL_EXPORTER_OTLP_ENDPOINT: http://otel-collector:4318 + OTEL_TRACES_SAMPLER_ARG: ${OTEL_TRACES_SAMPLER_ARG:-1.0} + OTEL_QUEUE_SIZE: ${OTEL_QUEUE_SIZE:-2048} + OTEL_BATCH_SIZE: ${OTEL_BATCH_SIZE:-512} + ACCESS_LOG: "0" + secrets: [database_url, s3_access_key, s3_secret_key, broker_url] + depends_on: + migrate: {condition: service_completed_successfully} + s3-init: {condition: service_completed_successfully} + rabbitmq: {condition: service_healthy} + healthcheck: + test: ["CMD", "python", "-c", "import os,time,sys; sys.exit(0 if time.time()-os.path.getmtime('/tmp/worker.alive') < 30 else 1)"] + interval: 10s + timeout: 5s + retries: 3 + start_period: 20s + stop_grace_period: 30s + mem_limit: ${WORKER_MEM:-768m} + cpus: ${WORKER_CPUS:-1.0} + deploy: + replicas: ${WORKER_REPLICAS:-1} + networks: [backend] + + # ------------------------------ наблюдаемость (lab6) ------------------------------ + # OTLP-порты 4317/4318 и метрики Collector 8888/8889 доступны только внутри сети backend (наружу не публикуются). + otel-collector: + <<: *common + image: otel/opentelemetry-collector-contrib:0.161.0@sha256:fd328de2552466ad78385e1b1289c3f2402b1c45f265b252aab1955b42845ac1 + command: ["--config=${COLLECTOR_CONFIG:-/etc/otelcol/collector.yaml}"] + volumes: + - ./infra/otel:/etc/otelcol:ro + mem_limit: 384m + cpus: ${COLLECTOR_CPUS:-1.0} + networks: [backend] + + prometheus: + <<: *common + image: prom/prometheus:v3.15.0@sha256:efd719c99d83b060d9daefdcf00360461adf279f45ef5391f8d111892118753e + command: ["--config.file=/etc/prometheus/prometheus.yml", "--storage.tsdb.path=/prometheus", "--storage.tsdb.retention.time=7d", + "--web.enable-lifecycle"] + volumes: + - ./infra/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro + - ./infra/prometheus/rules:/etc/prometheus/rules:ro + - promdata:/prometheus + healthcheck: + test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1:9090/-/ready"] + interval: 10s + timeout: 3s + retries: 6 + mem_limit: 512m + cpus: 1.0 + networks: [backend] + + loki: + <<: *common + image: grafana/loki:3.7.8@sha256:1107dd5274e0ada47e42472b7a7e71f3b2a2fe878878108f3e2f9e51528f0193 + command: ["-config.file=/etc/loki/loki.yaml"] + volumes: + - ./infra/loki/loki.yaml:/etc/loki/loki.yaml:ro + - lokidata:/loki + mem_limit: 512m + cpus: 1.0 + networks: [backend] + + tempo: + <<: *common + image: grafana/tempo:2.9.0@sha256:65a5789759435f1ef696f1953258b9bbdb18eb571d5ce711ff812d2e128288a4 + command: ["-config.file=/etc/tempo/tempo.yaml"] + volumes: + - ./infra/tempo/tempo.yaml:/etc/tempo/tempo.yaml:ro + - tempodata:/var/tempo + mem_limit: 1g + cpus: 1.0 + networks: [backend] + + # Grafana: единственный опубликованный сервис наблюдаемости, только 127.0.0.1:3000. Datasources, dashboard и alert-вью + # подключаются provisioning-ом из Git (infra/grafana). Анонимный доступ выключен; пароль admin — secret. + grafana: + <<: *common + image: grafana/grafana:13.2.3@sha256:b28bae15e219c998fb0e0424ed724930cc61b1f61fb404d47c862f9a23f9e572 + environment: + GF_SECURITY_ADMIN_USER: admin + GF_SECURITY_ADMIN_PASSWORD__FILE: /run/secrets/grafana_admin_password + GF_AUTH_ANONYMOUS_ENABLED: "false" + GF_USERS_ALLOW_SIGN_UP: "false" + GF_ANALYTICS_REPORTING_ENABLED: "false" + GF_DASHBOARDS_DEFAULT_HOME_DASHBOARD_PATH: /var/lib/grafana/dashboards/messenger.json + secrets: [grafana_admin_password] + volumes: + - ./infra/grafana/provisioning:/etc/grafana/provisioning:ro + - ./infra/grafana/dashboards:/var/lib/grafana/dashboards:ro + - grafanadata:/var/lib/grafana + depends_on: [prometheus, loki, tempo] + ports: + - "127.0.0.1:3000:3000" + healthcheck: + test: ["CMD-SHELL", "wget -q -O /dev/null http://127.0.0.1:3000/api/health"] + interval: 10s + timeout: 3s + retries: 12 + mem_limit: 512m + cpus: 1.0 + networks: [backend] + + lb: + <<: *common + image: haproxy:3.0-alpine@sha256:56b887da77428b7a6621e59e480cdbd330cc805c22d3cedb66ceea76ffdea2c6 + volumes: + - ./infra/haproxy/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro + depends_on: + - api + ports: + - "127.0.0.1:8080:8080" + healthcheck: + test: ["CMD-SHELL", "wget -q -O /dev/null http://127.0.0.1:8081/healthz"] + interval: 5s + timeout: 3s + retries: 6 + mem_limit: 128m + cpus: ${LB_CPUS:-1.0} + stop_grace_period: 10s + networks: [backend] + +secrets: + postgres_password: + file: ./secrets/postgres_password + database_url: + file: ./secrets/database_url + seaweed_s3_config: + file: ./secrets/seaweed_s3.json + s3_admin_access_key: + file: ./secrets/s3_admin_access_key + s3_admin_secret_key: + file: ./secrets/s3_admin_secret_key + s3_access_key: + file: ./secrets/s3_access_key + s3_secret_key: + file: ./secrets/s3_secret_key + rabbitmq_conf: + file: ./secrets/rabbitmq.conf + grafana_admin_password: + file: ./secrets/grafana_admin_password + broker_url: + file: ./secrets/broker_url + +volumes: + pgdata: + valkeydata: + seaweeddata: + rabbitmqdata: + promdata: + lokidata: + tempodata: + grafanadata: + +networks: + backend: diff --git a/docs/report_lab6.docx b/docs/report_lab6.docx new file mode 100644 index 0000000000000000000000000000000000000000..7c9020a11cba3624619211cfaa42e4ba427a4a42 GIT binary patch literal 196814 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 literal 0 HcmV?d00001 diff --git a/docs/runbooks.md b/docs/runbooks.md new file mode 100644 index 0000000..9ca3692 --- /dev/null +++ b/docs/runbooks.md @@ -0,0 +1,34 @@ +# Runbooks (локальный стенд lab6) + +Grafana — `http://127.0.0.1:3000` (пользователь `admin`, пароль — `secrets/grafana_admin_password`), dashboard «Messenger: API, очередь, worker». +Prometheus/Loki/Tempo доступны только внутри сети стенда: запросы — через Grafana (Explore) либо `docker compose exec prometheus wget -qO- http://loki:3100/...`. + +Общий порядок диагностики: **метрика → трасса → лог**. Метрика показывает *что* и *когда* (алерт, dashboard), трасса — *где* потрачено время/где ошибка +(по `trace_id` из лога или из Tempo), лог — *почему* (событие и безопасные поля без тел сообщений и токенов). +Связка лог → трасса: в Loki у каждой записи есть `trace_id`/`span_id` (в Grafana — ссылка «Tempo»); трасса → логи: кнопка «Logs for this span». + +## HighErrorRate +Алерт `HighHttpErrorRate`: доля ответов 5xx среди бизнес-запросов (без `/health`) > 5 % при ≥ 0.5 запроса/с, 20 с. 4xx (неверный пароль, 404) в SLI не входят. +1. Dashboard → «RPS по статус-кодам» и «Доля ошибок»: какой маршрут даёт 5xx (`http_route` в `sum by (http_route)`). +2. Tempo: TraceQL `{ status = error && resource.service.name = "messenger-api" }` — в трассе виден спан с ошибкой (`s3.put_object`, `db.connection`, …) и `http.response.status_code`. +3. Loki: `{service_name="messenger-api"} | status >= 500` или поиск событий `s3_put_failed`, `db_unavailable`, `unhandled_exception` (поле `error_type`). +4. Действия: S3 недоступен → `docker compose ps seaweedfs`, `docker compose start seaweedfs`; БД → `docker compose ps postgres`, readiness реплик; затем алерт возвращается в resolved через ~1 мин (окно `rate[1m]`). + +## HighLatency +Алерт `HighLatencyP95`: p95 всех бизнес-запросов (из суммарной гистограммы всех реплик) > 0.5 с. +1. Dashboard «Latency p50/p95/p99» и «Latency p95 по маршрутам» → какой маршрут. +2. Отличить **медленную БД** от **медленного обработчика**: «DB pool: занято/ожидают» (рост `waiting`) и длительность спанов `db.connection` в медленной трассе (`{ name = "db.connection" && duration > 300ms }`). Если почти всё время запроса внутри `db.connection` — БД; если время в самом серверном спане вне дочерних — код приложения/CPU (`process_cpu_time`). +3. БД: `log_min_duration_statement=500` пишет медленные запросы в лог `postgres`; проверить блокировки/триггеры (`pg_stat_activity`). + +## QueueLag +Алерт `QueueLagGrowing`: возраст старейшего задания (`queued`/`processing`) > 30 с, 20 с. +1. Dashboard «Возраст старейшей задачи», «Глубина очереди», «Worker: занято/ёмкость», «Задания по исходам». +2. Нет метрик worker / `busy=0` и растёт возраст → worker остановлен или не подключён к брокеру: `docker compose ps worker rabbitmq`, `docker compose logs worker`. `busy == capacity` при росте очереди → не хватает мощности (увеличить `WORKER_CONCURRENCY`/реплики, см. отчёт lab5). +3. Много `retried`/`failed` → причина в логах worker (`job_rescheduled`, `reason`) и в трассе consumer-спана (S3/БД). Реестр: `docker compose run --rm -T worker python -m app.replay list`. +4. После устранения причины очередь рассасывается, алерт переходит в resolved. + +## Telemetry +Алерт `TelemetryExportFailing`: Collector не может отправить данные в Tempo/Loki. +1. Это сбой наблюдаемости, а не приложения: бизнес-метрики API (ошибки, RPS) не меняются, приложение работает (SDK и Collector ограничивают очередь/RAM и отбрасывают данные). +2. Проверить: `docker compose ps tempo loki`; метрики Collector `otelcol_exporter_queue_size`, `otelcol_exporter_send_failed_*`, `otelcol_process_memory_rss`. +3. Запустить хранилища: `docker compose start tempo loki`. Данные за время простоя трасс/логов потеряны (счётчики `send_failed`), метрики не затронуты (путь Collector → Prometheus независим). diff --git a/evidence/checks.txt b/evidence/checks.txt new file mode 100644 index 0000000..8732146 --- /dev/null +++ b/evidence/checks.txt @@ -0,0 +1,66 @@ +$ python3 scripts/check_contract.py +PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. +$ python3 tests/smoke.py (телеметрия включена) +PASS: lab6 public API scenario; infrastructure and grading evidence remain separate. +# контейнеры до перезапуска: +/mtusi-lab6-api-2 StartedAt=2026-10-03T02:04:24.831646035Z +/mtusi-lab6-api-1 StartedAt=2026-10-03T02:04:24.660308554Z +/mtusi-lab6-worker-1 StartedAt=2026-10-03T02:04:23.350829139Z +/mtusi-lab6-rabbitmq-1 StartedAt=2026-10-03T02:04:19.141968204Z +/mtusi-lab6-seaweedfs-1 StartedAt=2026-10-03T02:04:19.613928237Z +/mtusi-lab6-postgres-1 StartedAt=2026-10-03T02:04:18.665413808Z +/mtusi-lab6-valkey-1 StartedAt=2026-10-03T02:04:18.435301589Z +/mtusi-lab6-otel-collector-1 StartedAt=2026-10-03T02:04:19.399662403Z +/mtusi-lab6-prometheus-1 StartedAt=2026-10-03T02:04:16.212964886Z +/mtusi-lab6-loki-1 StartedAt=2026-10-03T02:04:19.815321273Z +/mtusi-lab6-tempo-1 StartedAt=2026-10-03T02:04:18.87934529Z +/mtusi-lab6-grafana-1 StartedAt=2026-10-03T02:04:18.083530623Z +$ python3 tests/resilience.py --mode persistence --action-script scripts/restart.sh (Windows: restart.cmd; перезапускаются API, worker, брокер, S3, БД, кэш и стек наблюдаемости) +Executing explicit persistence hook; hook output suppressed to avoid leaking secrets. +PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence. +# контейнеры после перезапуска: +/mtusi-lab6-api-2 StartedAt=2026-10-03T02:05:18.916843054Z +/mtusi-lab6-api-1 StartedAt=2026-10-03T02:05:20.476426854Z +/mtusi-lab6-worker-1 StartedAt=2026-10-03T02:05:19.075989142Z +/mtusi-lab6-rabbitmq-1 StartedAt=2026-10-03T02:05:15.668495976Z +/mtusi-lab6-seaweedfs-1 StartedAt=2026-10-03T02:05:15.807584366Z +/mtusi-lab6-postgres-1 StartedAt=2026-10-03T02:05:14.948208653Z +/mtusi-lab6-valkey-1 StartedAt=2026-10-03T02:05:14.108577454Z +/mtusi-lab6-otel-collector-1 StartedAt=2026-10-03T02:05:13.357193004Z +/mtusi-lab6-prometheus-1 StartedAt=2026-10-03T02:05:14.678083736Z +/mtusi-lab6-loki-1 StartedAt=2026-10-03T02:05:15.497739002Z +/mtusi-lab6-tempo-1 StartedAt=2026-10-03T02:05:15.099095895Z +/mtusi-lab6-grafana-1 StartedAt=2026-10-03T02:05:15.320432594Z +$ failover (1-я реплика) +Executing explicit failover hook; hook output suppressed to avoid leaking secrets. +{"observed_instances_before": 2, "successful_writes": 112, "failed_attempts": 0, "first_recovery_seconds": 2.36} +PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence. +$ failover (2-я реплика) +Executing explicit failover hook; hook output suppressed to avoid leaking secrets. +{"observed_instances_before": 2, "successful_writes": 109, "failed_attempts": 0, "first_recovery_seconds": 2.375} +PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence. +$ python -m unittest test_api.py +Ran 12 tests in 2.950s +OK +$ python -m unittest test_idempotency.py +Ran 9 tests in 2.070s +OK +$ python -m unittest test_attachments.py +Ran 11 tests in 6.104s +OK +$ python student-tests/test_pipeline.py (Pillow) +Ran 9 tests in 11.272s +OK +$ python student-tests/test_topology.py +Ran 6 tests in 2.857s +OK +$ python student-tests/test_observability.py (метрики, логи, трассы, связь API->worker, нет секретов) +Ran 5 tests in 7.658s +OK +$ python student-tests/test_observability_retry.py (все попытки задания — одна трасса) +Ran 1 test in 18.312s +OK +$ python student-tests/test_resilience5.py (окна отказа конвейера, телеметрия включена) +Ran 7 tests in 139.292s +OK +CHECKS-DONE diff --git a/evidence/grafana_provisioning.txt b/evidence/grafana_provisioning.txt new file mode 100644 index 0000000..1332e40 --- /dev/null +++ b/evidence/grafana_provisioning.txt @@ -0,0 +1,35 @@ +$ curl -u admin:*** http://127.0.0.1:3000/api/search (dashboard импортирован provisioning-ом, а не вручную) + dash-folder Messenger eg028qble26m8e + dash-db Messenger: API, очередь, worker messenger-overview +$ curl -u admin:*** .../api/datasources (datasources из infra/grafana/provisioning) + Loki loki loki provisioned= True + Prometheus prometheus prometheus provisioned= True + Tempo tempo tempo provisioned= True + health prometheus: OK + health loki: OK + health tempo: OK +$ curl -u admin:*** .../api/dashboards/uid/messenger-overview (панели) + provisioned: True | ïàíåëåé: 22 + - RPS по маршрутам + - Доля ошибок 5xx (SLI) + - Latency p50 / p95 / p99 + - RPS по статус-кодам + - Latency p95 по маршрутам + - DB pool: занято / простаивает / ожидают + - Задания по исходам + - Длительность обработки p50 / p95 (worker) + - Время до ready p50 / p95 + - Глубина очереди (queued + processing) + - Возраст старейшей задачи + - Worker: занято / ёмкость + - RSS по сервисам + - CPU по сервисам (ядра) + - Collector: очередь экспорта и отказы + - Структурные логи (API и worker), ошибки и предупреждения + - Алерты (firing / pending) + - Последние трассы API (Tempo) +$ анонимный доступ выключен: + GET /api/search áåç ïàðîëÿ -> HTTP 401 +$ порты наружу (docker compose ps): +grafana 127.0.0.1:3000->3000/tcp +lb 127.0.0.1:8080->8080/tcp diff --git a/evidence/incidents.json b/evidence/incidents.json new file mode 100644 index 0000000..8e9bcd7 --- /dev/null +++ b/evidence/incidents.json @@ -0,0 +1,1727 @@ +{ + "date": "2026-10-03 04:15:12", + "traffic_counters": { + "msg_2": 17863, + "up_2": 12054, + "up_5": 2236, + "up_err": 48, + "up_4": 37 + }, + "incidents": [ + { + "incident": "worker_down", + "alert": "QueueLagGrowing", + "injected_at_s": 25.0, + "firing_at_s": 88.8, + "detection_seconds": 63.8, + "recovered_cmd_at_s": 91.6, + "resolved_at_s": 115.5, + "fired": true, + "resolved": true, + "evidence": { + "queue_oldest_age_s": 56.708083, + "worker_capacity_series_present": false, + "jobs_ready_rate_1m": 0.0, + "diagnosis": "возраст старейшей задачи растёт при нулевой скорости обработки jobs (worker не отдаёт метрики) -> остановлен worker, а не медленная БД", + "alerts_in_state_firing": [ + "HighHttpErrorRate", + "HighUploadErrorRate", + "QueueLagGrowing", + "WorkerSilent" + ] + }, + "time_to_resolve_after_recovery_s": 24.0 + }, + { + "incident": "slow_db", + "alert": "HighLatencyP95", + "injected_at_s": 121.5, + "firing_at_s": 193.4, + "detection_seconds": 71.9, + "recovered_cmd_at_s": 194.7, + "resolved_at_s": 240.3, + "fired": true, + "resolved": true, + "evidence": { + "p95_s": 0.8010330578512395, + "db_pool_waiting": 0.0, + "slow_traces_with_long_db_span": 20, + "slow_http_post_messages_traces": 20, + "diagnosis": "p95 высокий, а время в спанах db.connection сопоставимо с длительностью запроса и растёт ожидание пула -> медленная БД, а не обработчик", + "alerts_in_state_firing": [ + "HighLatencyP95" + ] + }, + "time_to_resolve_after_recovery_s": 45.7 + }, + { + "incident": "s3_down", + "alert": "HighUploadErrorRate", + "injected_at_s": 246.3, + "firing_at_s": 334.5, + "detection_seconds": 88.2, + "recovered_cmd_at_s": 335.9, + "resolved_at_s": 414.1, + "fired": true, + "resolved": true, + "evidence": { + "upload_error_ratio_1m": 0.32, + "global_error_ratio_1m": 0.008221993833504625, + "error_traces": 20, + "s3_put_failed_log_lines": 139, + "diagnosis": "рост доли 5xx на маршруте загрузки при нормальных остальных; спаны s3.put_object с ошибкой и логи s3_put_failed -> недоступен S3", + "alerts_in_state_firing": [ + "HighUploadErrorRate", + "QueueLagGrowing" + ] + }, + "time_to_resolve_after_recovery_s": 78.2 + }, + { + "incident": "telemetry_backend", + "alert": "TelemetryExportFailing", + "injected_at_s": 420.1, + "firing_at_s": 469.1, + "detection_seconds": 48.9, + "recovered_cmd_at_s": 470.6, + "resolved_at_s": 555.5, + "fired": true, + "resolved": true, + "evidence": { + "api_error_ratio_1m": 0.0, + "api_rps": 67.0194003527337, + "collector_queue_size": 23.0, + "collector_send_failed_spans_rate": 65.749040856774, + "collector_rss_mib": 247.1, + "diagnosis": "ошибки экспорта растут, очередь ограничена; бизнес-метрики API без роста ошибок -> сбой хранилища телеметрии, не приложения", + "alerts_in_state_firing": [ + "TelemetryExportFailing" + ] + }, + "time_to_resolve_after_recovery_s": 84.9 + } + ], + "timeline": [ + { + "t": 0.0, + "alerts": {}, + "queue_oldest_age_s": 0.0, + "error_ratio_1m": 0.0, + "p95_s": 0.021837988516905667, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 0.6909342157896651 + }, + { + "t": 4.1, + "alerts": {}, + "queue_oldest_age_s": 0.0, + "error_ratio_1m": 0.0, + "p95_s": 0.02183799436386364, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 0.6909467789152136 + }, + { + "t": 8.3, + "alerts": {}, + "queue_oldest_age_s": 0.202415, + "error_ratio_1m": 0.0, + "p95_s": 0.02183799436386364, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 0.6909467789152136 + }, + { + "t": 12.5, + "alerts": {}, + "queue_oldest_age_s": 0.032457, + "error_ratio_1m": 0.0, + "p95_s": 0.02183799436386364, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 0.6909342157896651 + }, + { + "t": 16.6, + "alerts": {}, + "queue_oldest_age_s": 0.202396, + "error_ratio_1m": 0.0, + "p95_s": 0.08750000000000001, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 3.454733894576068 + }, + { + "t": 20.8, + "alerts": {}, + "queue_oldest_age_s": 0.005507, + "error_ratio_1m": 0.0, + "p95_s": 0.031249999999999972, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 9.455061185155554 + }, + { + "t": 24.9, + "alerts": {}, + "queue_oldest_age_s": 0.005507, + "error_ratio_1m": 0.0, + "p95_s": 0.031366279069767425, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 15.655114731444781 + }, + { + "t": 29.0, + "alerts": {}, + "queue_oldest_age_s": 0.172278, + "error_ratio_1m": 0.0, + "p95_s": 0.031307692307692286, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 21.674303585715325 + }, + { + "t": 33.1, + "alerts": {}, + "queue_oldest_age_s": 0.669169, + "error_ratio_1m": 0.0, + "p95_s": 0.031307692307692286, + "db_waiting": 0.0, + "db_used": 3.0, + "rps": 21.674303585715325 + }, + { + "t": 37.3, + "alerts": {}, + "queue_oldest_age_s": 6.67272, + "error_ratio_1m": 0.0, + "p95_s": 0.028216666666666647, + "db_waiting": 0.0, + "db_used": 2.0, + "rps": 27.7646459871268 + }, + { + "t": 41.4, + "alerts": {}, + "queue_oldest_age_s": 10.674385, + "error_ratio_1m": 0.0, + "p95_s": 0.025135542168674578, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 34.02003745658854 + }, + { + "t": 45.5, + "alerts": {}, + "queue_oldest_age_s": 16.677877, + "error_ratio_1m": 0.00908265213442325, + "p95_s": 0.024859863730645866, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 40.0378195570748 + }, + { + "t": 49.6, + "alerts": {}, + "queue_oldest_age_s": 16.677877, + "error_ratio_1m": 0.07276341948310139, + "p95_s": 0.02458815658966605, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 45.728935597658094 + }, + { + "t": 53.8, + "alerts": { + "HighHttpErrorRate": "pending" + }, + "queue_oldest_age_s": 20.679374, + "error_ratio_1m": 0.07276341948310139, + "p95_s": 0.02458815658966605, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 51.855488281605126 + }, + { + "t": 57.9, + "alerts": { + "HighHttpErrorRate": "pending" + }, + "queue_oldest_age_s": 26.681594, + "error_ratio_1m": 0.12096774193548386, + "p95_s": 0.02433063583815029, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 51.855488281605126 + }, + { + "t": 62.0, + "alerts": { + "HighHttpErrorRate": "pending", + "HighUploadErrorRate": "pending", + "WorkerSilent": "pending" + }, + "queue_oldest_age_s": 30.682897, + "error_ratio_1m": 0.15879962488277585, + "p95_s": 0.024032006920415225, + "db_waiting": 0.0, + "db_used": 4.0, + "rps": 58.166809098678115 + }, + { + "t": 66.2, + "alerts": { + "HighHttpErrorRate": "pending", + "HighUploadErrorRate": "pending", + "WorkerSilent": "pending" + }, + "queue_oldest_age_s": 36.686688, + "error_ratio_1m": 0.18910527801298335, + "p95_s": 0.02373442906574394, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 64.42286711760855 + }, + { + "t": 70.3, + "alerts": { + "HighHttpErrorRate": "pending", + "HighUploadErrorRate": "pending", + "QueueLagGrowing": "pending", + "WorkerSilent": "pending" + }, + "queue_oldest_age_s": 40.688213, + "error_ratio_1m": 0.22231139646869982, + "p95_s": 0.023133872976338746, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 67.96734367329128 + }, + { + "t": 74.5, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing", + "QueueLagGrowing": "pending", + "WorkerSilent": "pending" + }, + "queue_oldest_age_s": 40.688213, + "error_ratio_1m": 0.2655457699492928, + "p95_s": 0.022416792168674704, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 68.12975017273357 + }, + { + "t": 78.6, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing", + "QueueLagGrowing": "pending", + "WorkerSilent": "pending" + }, + "queue_oldest_age_s": 46.691598, + "error_ratio_1m": 0.2655457699492928, + "p95_s": 0.022416792168674704, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 68.3297574457253 + }, + { + "t": 82.7, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing", + "QueueLagGrowing": "pending", + "WorkerSilent": "pending" + }, + "queue_oldest_age_s": 50.693747, + "error_ratio_1m": 0.3084087280468334, + "p95_s": 0.021089792060491497, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 68.3297574457253 + }, + { + "t": 86.8, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing", + "QueueLagGrowing": "pending", + "WorkerSilent": "pending" + }, + "queue_oldest_age_s": 56.708083, + "error_ratio_1m": 0.35022552401167417, + "p95_s": 0.019042698019801962, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 68.52851870034002 + }, + { + "t": 90.9, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing", + "QueueLagGrowing": "firing", + "WorkerSilent": "firing" + }, + "queue_oldest_age_s": 60.708464, + "error_ratio_1m": 0.39262990455991514, + "p95_s": 0.015761732851985573, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 68.58555921232067 + }, + { + "t": 95.0, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing", + "QueueLagGrowing": "firing", + "WorkerSilent": "firing" + }, + "queue_oldest_age_s": 60.708464, + "error_ratio_1m": 0.43625761993108936, + "p95_s": 0.009811190476190473, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 68.60249463616857 + }, + { + "t": 99.2, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing", + "QueueLagGrowing": "firing", + "WorkerSilent": "firing" + }, + "queue_oldest_age_s": 66.710115, + "error_ratio_1m": 0.4717379820390913, + "p95_s": 0.00916851106639839, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 68.84011855192102 + }, + { + "t": 103.4, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing", + "QueueLagGrowing": "firing", + "WorkerSilent": "firing" + }, + "queue_oldest_age_s": 66.176169, + "error_ratio_1m": 0.4717379820390913, + "p95_s": 0.00916851106639839, + "db_waiting": 0.0, + "db_used": 2.0, + "rps": 68.84011855192102 + }, + { + "t": 107.5, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing", + "QueueLagGrowing": "firing", + "WorkerSilent": "firing" + }, + "queue_oldest_age_s": 2.63989, + "error_ratio_1m": 0.4717529039070751, + "p95_s": 0.00910020876826722, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 68.8777365626591 + }, + { + "t": 111.7, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing", + "QueueLagGrowing": "firing" + }, + "queue_oldest_age_s": 0.881435, + "error_ratio_1m": 0.43095679830373707, + "p95_s": 0.009858588351431389, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 68.60374202229212 + }, + { + "t": 115.8, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.11786, + "error_ratio_1m": 0.388682252922423, + "p95_s": 0.015365187713310564, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 68.4376079565083 + }, + { + "t": 120.0, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.11786, + "error_ratio_1m": 0.346194784459819, + "p95_s": 0.01859507042253521, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 68.33099987272034 + }, + { + "t": 124.1, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.229302, + "error_ratio_1m": 0.30473135525260625, + "p95_s": 0.020374999999999983, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 68.02065529655624 + }, + { + "t": 128.3, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.149023, + "error_ratio_1m": 0.30473135525260625, + "p95_s": 0.020374999999999983, + "db_waiting": 0.0, + "db_used": 4.0, + "rps": 68.02065529655624 + }, + { + "t": 132.4, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.0, + "error_ratio_1m": 0.2611021936864634, + "p95_s": 0.021397841726618707, + "db_waiting": 0.0, + "db_used": 3.0, + "rps": 67.96734367329127 + }, + { + "t": 136.7, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.06846, + "error_ratio_1m": 0.21922246220302374, + "p95_s": 0.02243272727272727, + "db_waiting": 0.0, + "db_used": 4.0, + "rps": 67.34912813426187 + }, + { + "t": 140.9, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.15416, + "error_ratio_1m": 0.18384637108161536, + "p95_s": 0.02345556133056133, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 64.38415942397906 + }, + { + "t": 145.2, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.206758, + "error_ratio_1m": 0.14522821576763487, + "p95_s": 0.024283271719038817, + "db_waiting": 0.0, + "db_used": 5.0, + "rps": 61.34768537037711 + }, + { + "t": 149.6, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.206758, + "error_ratio_1m": 0.10130922693266832, + "p95_s": 0.024884331419196062, + "db_waiting": 0.0, + "db_used": 2.0, + "rps": 58.32939379613804 + }, + { + "t": 153.8, + "alerts": { + "HighHttpErrorRate": "firing" + }, + "queue_oldest_age_s": 0.245449, + "error_ratio_1m": 0.10130922693266832, + "p95_s": 0.024884331419196062, + "db_waiting": 0.0, + "db_used": 2.0, + "rps": 55.23937669327418 + }, + { + "t": 158.0, + "alerts": { + "HighHttpErrorRate": "firing" + }, + "queue_oldest_age_s": 0.055453, + "error_ratio_1m": 0.054312047399605004, + "p95_s": 0.035510752688172026, + "db_waiting": 0.0, + "db_used": 6.0, + "rps": 55.23937669327418 + }, + { + "t": 162.2, + "alerts": { + "HighHttpErrorRate": "firing" + }, + "queue_oldest_age_s": 0.114868, + "error_ratio_1m": 0.00034867503486750353, + "p95_s": 0.04513636363636352, + "db_waiting": 0.0, + "db_used": 2.0, + "rps": 52.14640266186658 + }, + { + "t": 166.3, + "alerts": {}, + "queue_oldest_age_s": 0.203497, + "error_ratio_1m": 0.0, + "p95_s": 0.08299999999999742, + "db_waiting": 0.0, + "db_used": 5.0, + "rps": 49.23815411469508 + }, + { + "t": 170.4, + "alerts": {}, + "queue_oldest_age_s": 0.006329, + "error_ratio_1m": 0.0, + "p95_s": 0.5865259740259738, + "db_waiting": 0.0, + "db_used": 2.0, + "rps": 46.31161699729076 + }, + { + "t": 174.6, + "alerts": { + "HighLatencyP95": "pending" + }, + "queue_oldest_age_s": 0.006329, + "error_ratio_1m": 0.0, + "p95_s": 0.6610795454545451, + "db_waiting": 0.0, + "db_used": 6.0, + "rps": 43.38260695649012 + }, + { + "t": 178.7, + "alerts": { + "HighLatencyP95": "pending" + }, + "queue_oldest_age_s": 0.048792, + "error_ratio_1m": 0.0, + "p95_s": 0.6610795454545451, + "db_waiting": 0.0, + "db_used": 6.0, + "rps": 40.51130061639726 + }, + { + "t": 182.8, + "alerts": { + "HighLatencyP95": "pending" + }, + "queue_oldest_age_s": 0.056091, + "error_ratio_1m": 0.0, + "p95_s": 0.7186868686868686, + "db_waiting": 0.0, + "db_used": 2.0, + "rps": 40.51130061639726 + }, + { + "t": 187.0, + "alerts": { + "HighLatencyP95": "pending" + }, + "queue_oldest_age_s": 0.0, + "error_ratio_1m": 0.0, + "p95_s": 0.7653409090909089, + "db_waiting": 0.0, + "db_used": 5.0, + "rps": 37.54681988435943 + }, + { + "t": 191.1, + "alerts": { + "HighLatencyP95": "pending" + }, + "queue_oldest_age_s": 0.105751, + "error_ratio_1m": 0.0, + "p95_s": 0.8010330578512395, + "db_waiting": 0.0, + "db_used": 4.0, + "rps": 35.019455252918284 + }, + { + "t": 195.2, + "alerts": { + "HighLatencyP95": "firing" + }, + "queue_oldest_age_s": 0.200896, + "error_ratio_1m": 0.0, + "p95_s": 0.7996875000000001, + "db_waiting": 0.0, + "db_used": 7.0, + "rps": 34.96490781482963 + }, + { + "t": 199.3, + "alerts": { + "HighLatencyP95": "firing" + }, + "queue_oldest_age_s": 0.200896, + "error_ratio_1m": 0.0, + "p95_s": 0.7991666666666664, + "db_waiting": 0.0, + "db_used": 2.0, + "rps": 35.05518282150585 + }, + { + "t": 203.6, + "alerts": { + "HighLatencyP95": "firing" + }, + "queue_oldest_age_s": 0.005269, + "error_ratio_1m": 0.0, + "p95_s": 0.7991666666666664, + "db_waiting": 0.0, + "db_used": 2.0, + "rps": 35.05582021164406 + }, + { + "t": 207.8, + "alerts": { + "HighLatencyP95": "firing" + }, + "queue_oldest_age_s": 0.127232, + "error_ratio_1m": 0.0, + "p95_s": 0.7991666666666662, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 35.05582021164406 + }, + { + "t": 211.9, + "alerts": { + "HighLatencyP95": "firing" + }, + "queue_oldest_age_s": 0.238371, + "error_ratio_1m": 0.0, + "p95_s": 0.7834051724137925, + "db_waiting": 0.0, + "db_used": 2.0, + "rps": 36.546783519400705 + }, + { + "t": 216.0, + "alerts": { + "HighLatencyP95": "firing" + }, + "queue_oldest_age_s": 0.128177, + "error_ratio_1m": 0.0, + "p95_s": 0.7396634615384619, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 39.383966398167175 + }, + { + "t": 220.1, + "alerts": { + "HighLatencyP95": "firing" + }, + "queue_oldest_age_s": 0.230894, + "error_ratio_1m": 0.0, + "p95_s": 0.690558510638298, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 42.31062947743554 + }, + { + "t": 224.2, + "alerts": { + "HighLatencyP95": "firing" + }, + "queue_oldest_age_s": 0.230894, + "error_ratio_1m": 0.0, + "p95_s": 0.6250000000000003, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 45.27437361358595 + }, + { + "t": 228.4, + "alerts": { + "HighLatencyP95": "firing" + }, + "queue_oldest_age_s": 0.157193, + "error_ratio_1m": 0.0, + "p95_s": 0.6250000000000003, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 48.255422825869566 + }, + { + "t": 232.6, + "alerts": { + "HighLatencyP95": "firing" + }, + "queue_oldest_age_s": 0.212977, + "error_ratio_1m": 0.0, + "p95_s": 0.5392361111111098, + "db_waiting": 0.0, + "db_used": 2.0, + "rps": 48.255422825869566 + }, + { + "t": 236.8, + "alerts": { + "HighLatencyP95": "firing" + }, + "queue_oldest_age_s": 0.067636, + "error_ratio_1m": 0.0, + "p95_s": 0.048266129032258034, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 51.23729522354952 + }, + { + "t": 240.9, + "alerts": {}, + "queue_oldest_age_s": 0.188142, + "error_ratio_1m": 0.0, + "p95_s": 0.04448717948717947, + "db_waiting": 0.0, + "db_used": 3.0, + "rps": 54.184773714929904 + }, + { + "t": 245.1, + "alerts": {}, + "queue_oldest_age_s": 0.006211, + "error_ratio_1m": 0.0, + "p95_s": 0.040921717171717165, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 57.057657690419475 + }, + { + "t": 249.3, + "alerts": {}, + "queue_oldest_age_s": 0.006211, + "error_ratio_1m": 0.0, + "p95_s": 0.03712752525252522, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 59.98509009582341 + }, + { + "t": 253.4, + "alerts": {}, + "queue_oldest_age_s": 0.112589, + "error_ratio_1m": 0.0, + "p95_s": 0.03712752525252522, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 59.98509009582341 + }, + { + "t": 257.5, + "alerts": {}, + "queue_oldest_age_s": 5.809907, + "error_ratio_1m": 0.0, + "p95_s": 0.03351522842639587, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 62.87615688128443 + }, + { + "t": 261.6, + "alerts": {}, + "queue_oldest_age_s": 9.815523, + "error_ratio_1m": 0.0002787068004459309, + "p95_s": 0.02810439560439558, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 65.23873595403468 + }, + { + "t": 265.7, + "alerts": {}, + "queue_oldest_age_s": 15.820854, + "error_ratio_1m": 0.0022785531187695814, + "p95_s": 0.025375766871165672, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 63.837524318623984 + }, + { + "t": 269.8, + "alerts": {}, + "queue_oldest_age_s": 15.820854, + "error_ratio_1m": 0.0029726516052318666, + "p95_s": 0.024835956917978463, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 61.16586057674825 + }, + { + "t": 273.9, + "alerts": {}, + "queue_oldest_age_s": 19.823123, + "error_ratio_1m": 0.0029726516052318666, + "p95_s": 0.024835956917978463, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 58.422430722234346 + }, + { + "t": 278.0, + "alerts": {}, + "queue_oldest_age_s": 25.825538, + "error_ratio_1m": 0.004668534080298786, + "p95_s": 0.02458166515013649, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 58.422430722234346 + }, + { + "t": 282.1, + "alerts": {}, + "queue_oldest_age_s": 29.827643, + "error_ratio_1m": 0.005584756898817346, + "p95_s": 0.02436680327868853, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 55.3484735531029 + }, + { + "t": 286.2, + "alerts": {}, + "queue_oldest_age_s": 35.830777, + "error_ratio_1m": 0.005923344947735192, + "p95_s": 0.024117122473246128, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 52.18466461807007 + }, + { + "t": 290.3, + "alerts": {}, + "queue_oldest_age_s": 39.831666, + "error_ratio_1m": 0.006649427410417436, + "p95_s": 0.023801063829787236, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 49.2199716353322 + }, + { + "t": 294.4, + "alerts": { + "QueueLagGrowing": "pending" + }, + "queue_oldest_age_s": 39.831666, + "error_ratio_1m": 0.00706713780918728, + "p95_s": 0.023138695652173913, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 46.30993290787106 + }, + { + "t": 298.5, + "alerts": { + "QueueLagGrowing": "pending" + }, + "queue_oldest_age_s": 45.833089, + "error_ratio_1m": 0.00706713780918728, + "p95_s": 0.023138695652173913, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 43.34703080112004 + }, + { + "t": 302.6, + "alerts": { + "QueueLagGrowing": "pending" + }, + "queue_oldest_age_s": 49.835019, + "error_ratio_1m": 0.00964765100671141, + "p95_s": 0.02236995515695067, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 43.34703080112004 + }, + { + "t": 306.7, + "alerts": { + "QueueLagGrowing": "pending" + }, + "queue_oldest_age_s": 55.838342, + "error_ratio_1m": 0.011230907457322551, + "p95_s": 0.0215762987012987, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 40.47419906178407 + }, + { + "t": 310.8, + "alerts": { + "QueueLagGrowing": "pending" + }, + "queue_oldest_age_s": 59.840128, + "error_ratio_1m": 0.012100677637947725, + "p95_s": 0.019078034682080913, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 37.565685401021874 + }, + { + "t": 314.9, + "alerts": { + "QueueLagGrowing": "firing" + }, + "queue_oldest_age_s": 59.840128, + "error_ratio_1m": 0.01295336787564767, + "p95_s": 0.009926075268817204, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 35.09282324490427 + }, + { + "t": 319.0, + "alerts": { + "HighUploadErrorRate": "pending", + "QueueLagGrowing": "firing" + }, + "queue_oldest_age_s": 65.842317, + "error_ratio_1m": 0.01295336787564767, + "p95_s": 0.009962319494584837, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 35.037637732281176 + }, + { + "t": 323.1, + "alerts": { + "HighUploadErrorRate": "pending", + "QueueLagGrowing": "firing" + }, + "queue_oldest_age_s": 69.842659, + "error_ratio_1m": 0.011935651271406332, + "p95_s": 0.009962319494584837, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 35.037637732281176 + }, + { + "t": 327.3, + "alerts": { + "HighUploadErrorRate": "pending", + "QueueLagGrowing": "firing" + }, + "queue_oldest_age_s": 75.844071, + "error_ratio_1m": 0.0109204368174727, + "p95_s": 0.00995516784452297, + "db_waiting": 0.0, + "db_used": 2.0, + "rps": 34.964272077674146 + }, + { + "t": 331.4, + "alerts": { + "HighUploadErrorRate": "pending", + "QueueLagGrowing": "firing" + }, + "queue_oldest_age_s": 79.846203, + "error_ratio_1m": 0.009375, + "p95_s": 0.009844827586206896, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 34.910360376740975 + }, + { + "t": 335.6, + "alerts": { + "HighUploadErrorRate": "firing", + "QueueLagGrowing": "firing" + }, + "queue_oldest_age_s": 85.848987, + "error_ratio_1m": 0.008221993833504625, + "p95_s": 0.00977725724020443, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 35.38310484017601 + }, + { + "t": 339.7, + "alerts": { + "HighUploadErrorRate": "firing", + "QueueLagGrowing": "firing" + }, + "queue_oldest_age_s": 85.848987, + "error_ratio_1m": 0.008646998982706001, + "p95_s": 0.00984141156462585, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 35.74675442743373 + }, + { + "t": 343.9, + "alerts": { + "HighUploadErrorRate": "firing", + "QueueLagGrowing": "firing" + }, + "queue_oldest_age_s": 89.850732, + "error_ratio_1m": 0.008646998982706001, + "p95_s": 0.00984141156462585, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 36.219498890868756 + }, + { + "t": 348.0, + "alerts": { + "HighUploadErrorRate": "firing", + "QueueLagGrowing": "firing" + }, + "queue_oldest_age_s": 0.0, + "error_ratio_1m": 0.010542168674698798, + "p95_s": 0.009932758620689654, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 36.219498890868756 + }, + { + "t": 352.2, + "alerts": { + "HighUploadErrorRate": "firing", + "QueueLagGrowing": "firing" + }, + "queue_oldest_age_s": 0.0, + "error_ratio_1m": 0.010558069381598792, + "p95_s": 0.009950518582541054, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 36.165609033219994 + }, + { + "t": 356.3, + "alerts": { + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.0, + "error_ratio_1m": 0.015888778550148957, + "p95_s": 0.013761538461538462, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 36.61951343685225 + }, + { + "t": 360.5, + "alerts": { + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.0, + "error_ratio_1m": 0.02747791952894995, + "p95_s": 0.018929687500000014, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 37.05589294156152 + }, + { + "t": 364.7, + "alerts": { + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.0, + "error_ratio_1m": 0.08081746400371574, + "p95_s": 0.03874999999999977, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 39.1468780682934 + }, + { + "t": 368.8, + "alerts": { + "HighHttpErrorRate": "pending", + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.153313, + "error_ratio_1m": 0.08081746400371574, + "p95_s": 0.03874999999999977, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 41.34695807120259 + }, + { + "t": 373.0, + "alerts": { + "HighHttpErrorRate": "pending", + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.0, + "error_ratio_1m": 0.12884784520668424, + "p95_s": 0.032499999999999814, + "db_waiting": 0.0, + "db_used": 3.0, + "rps": 41.34695807120259 + }, + { + "t": 377.2, + "alerts": { + "HighHttpErrorRate": "pending", + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.121416, + "error_ratio_1m": 0.12050209205020922, + "p95_s": 0.032065217391304184, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 43.45691583177264 + }, + { + "t": 381.5, + "alerts": { + "HighHttpErrorRate": "pending", + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.184617, + "error_ratio_1m": 0.1131630648330059, + "p95_s": 0.029094827586206743, + "db_waiting": 0.0, + "db_used": 2.0, + "rps": 46.27525137734786 + }, + { + "t": 385.8, + "alerts": { + "HighHttpErrorRate": "pending", + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.009728, + "error_ratio_1m": 0.10565201329885482, + "p95_s": 0.02490677179962894, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 49.21818181818181 + }, + { + "t": 390.0, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.009728, + "error_ratio_1m": 0.10056258790436005, + "p95_s": 0.024884101040118872, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 51.71097130804757 + }, + { + "t": 394.1, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.121893, + "error_ratio_1m": 0.09541345831938401, + "p95_s": 0.024956211180124213, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 54.31304094843261 + }, + { + "t": 398.3, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.0, + "error_ratio_1m": 0.09541345831938401, + "p95_s": 0.024956211180124213, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 54.31304094843261 + }, + { + "t": 402.5, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.118105, + "error_ratio_1m": 0.0896, + "p95_s": 0.0249156852248394, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 56.822314350134555 + }, + { + "t": 406.6, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.181903, + "error_ratio_1m": 0.08515815085158152, + "p95_s": 0.026874999999999916, + "db_waiting": 0.0, + "db_used": 3.0, + "rps": 59.78507918613742 + }, + { + "t": 410.7, + "alerts": { + "HighHttpErrorRate": "firing", + "HighUploadErrorRate": "firing" + }, + "queue_oldest_age_s": 0.026519, + "error_ratio_1m": 0.07708029197080292, + "p95_s": 0.025170454545454603, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 62.27612415222649 + }, + { + "t": 414.9, + "alerts": { + "HighHttpErrorRate": "firing" + }, + "queue_oldest_age_s": 0.026519, + "error_ratio_1m": 0.06691031768344109, + "p95_s": 0.024704908675799084, + "db_waiting": 0.0, + "db_used": 3.0, + "rps": 64.67507909378523 + }, + { + "t": 419.0, + "alerts": { + "HighHttpErrorRate": "firing" + }, + "queue_oldest_age_s": 0.0, + "error_ratio_1m": 0.06691031768344109, + "p95_s": 0.024266327247191008, + "db_waiting": 0.0, + "db_used": 3.0, + "rps": 65.69329793810684 + }, + { + "t": 423.2, + "alerts": { + "HighHttpErrorRate": "firing" + }, + "queue_oldest_age_s": 0.11007, + "error_ratio_1m": 0.03321339606974814, + "p95_s": 0.024266327247191008, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 65.69329793810684 + }, + { + "t": 427.3, + "alerts": {}, + "queue_oldest_age_s": 0.025811, + "error_ratio_1m": 0.0, + "p95_s": 0.024248980978260865, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 66.43877959198517 + }, + { + "t": 431.6, + "alerts": {}, + "queue_oldest_age_s": 0.117773, + "error_ratio_1m": 0.0, + "p95_s": 0.024118148395721926, + "db_waiting": 0.0, + "db_used": 2.0, + "rps": 67.25821408440461 + }, + { + "t": 435.8, + "alerts": {}, + "queue_oldest_age_s": 0.058093, + "error_ratio_1m": 0.0, + "p95_s": 0.02405114401076716, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 67.27639689437606 + }, + { + "t": 439.9, + "alerts": {}, + "queue_oldest_age_s": 0.058093, + "error_ratio_1m": 0.0, + "p95_s": 0.02399829816201498, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 67.31398647174342 + }, + { + "t": 444.1, + "alerts": {}, + "queue_oldest_age_s": 0.171888, + "error_ratio_1m": 0.0, + "p95_s": 0.023994866529774124, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 67.23758613792978 + }, + { + "t": 448.3, + "alerts": {}, + "queue_oldest_age_s": 0.117493, + "error_ratio_1m": 0.0, + "p95_s": 0.023994866529774124, + "db_waiting": 0.0, + "db_used": 6.0, + "rps": 67.23758613792978 + }, + { + "t": 452.4, + "alerts": {}, + "queue_oldest_age_s": 0.165172, + "error_ratio_1m": 0.0, + "p95_s": 0.02398979591836735, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 67.27395043546247 + }, + { + "t": 456.5, + "alerts": { + "TelemetryExportFailing": "pending" + }, + "queue_oldest_age_s": 0.091433, + "error_ratio_1m": 0.0, + "p95_s": 0.024048507462686566, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 67.09212894779905 + }, + { + "t": 460.7, + "alerts": { + "TelemetryExportFailing": "pending" + }, + "queue_oldest_age_s": 0.16713, + "error_ratio_1m": 0.0, + "p95_s": 0.024109723160027005, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 67.23758613792978 + }, + { + "t": 464.8, + "alerts": { + "TelemetryExportFailing": "pending" + }, + "queue_oldest_age_s": 0.16713, + "error_ratio_1m": 0.0, + "p95_s": 0.024107479784366576, + "db_waiting": 0.0, + "db_used": 2.0, + "rps": 67.0194003527337 + }, + { + "t": 469.1, + "alerts": { + "TelemetryExportFailing": "firing" + }, + "queue_oldest_age_s": 0.060032, + "error_ratio_1m": 0.0, + "p95_s": 0.02404714765100671, + "db_waiting": 0.0, + "db_used": 2.0, + "rps": 67.14911722457589 + }, + { + "t": 473.2, + "alerts": { + "TelemetryExportFailing": "firing" + }, + "queue_oldest_age_s": 0.0434, + "error_ratio_1m": 0.0, + "p95_s": 0.02404714765100671, + "db_waiting": 0.0, + "db_used": 3.0, + "rps": 67.14911722457589 + }, + { + "t": 477.5, + "alerts": { + "TelemetryExportFailing": "firing" + }, + "queue_oldest_age_s": 0.027894, + "error_ratio_1m": 0.0, + "p95_s": 0.024051839464882943, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 67.09334884904906 + }, + { + "t": 481.6, + "alerts": { + "TelemetryExportFailing": "firing" + }, + "queue_oldest_age_s": 0.113299, + "error_ratio_1m": 0.0, + "p95_s": 0.024043224299065417, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 67.11275160463298 + }, + { + "t": 485.8, + "alerts": { + "TelemetryExportFailing": "firing" + }, + "queue_oldest_age_s": 0.039427, + "error_ratio_1m": 0.0, + "p95_s": 0.024047981469225675, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 67.23880868395214 + }, + { + "t": 490.0, + "alerts": { + "TelemetryExportFailing": "firing" + }, + "queue_oldest_age_s": 0.039427, + "error_ratio_1m": 0.0, + "p95_s": 0.024082046332046324, + "db_waiting": 0.0, + "db_used": 2.0, + "rps": 67.31153860140368 + }, + { + "t": 494.2, + "alerts": { + "TelemetryExportFailing": "firing" + }, + "queue_oldest_age_s": 0.166758, + "error_ratio_1m": 0.0, + "p95_s": 0.024164996869129617, + "db_waiting": 0.0, + "db_used": 2.0, + "rps": 67.23880868395214 + }, + { + "t": 498.4, + "alerts": { + "TelemetryExportFailing": "firing" + }, + "queue_oldest_age_s": 0.036081, + "error_ratio_1m": 0.0, + "p95_s": 0.024164996869129617, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 67.42185937414769 + }, + { + "t": 502.6, + "alerts": { + "TelemetryExportFailing": "firing" + }, + "queue_oldest_age_s": 0.136676, + "error_ratio_1m": 0.0, + "p95_s": 0.02413483146067416, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 67.42185937414769 + }, + { + "t": 506.8, + "alerts": { + "TelemetryExportFailing": "firing" + }, + "queue_oldest_age_s": 0.113007, + "error_ratio_1m": 0.0, + "p95_s": 0.024090405319822678, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 67.54791083312121 + }, + { + "t": 511.0, + "alerts": { + "TelemetryExportFailing": "firing" + }, + "queue_oldest_age_s": 0.0, + "error_ratio_1m": 0.0, + "p95_s": 0.02406825447570332, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 67.69460152371947 + }, + { + "t": 515.2, + "alerts": { + "TelemetryExportFailing": "firing" + }, + "queue_oldest_age_s": 0.159875, + "error_ratio_1m": 0.0, + "p95_s": 0.02383058898036732, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 67.67641871374802 + }, + { + "t": 519.5, + "alerts": { + "TelemetryExportFailing": "firing" + }, + "queue_oldest_age_s": 0.159875, + "error_ratio_1m": 0.0, + "p95_s": 0.023655025284450064, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 67.94916086331982 + }, + { + "t": 523.6, + "alerts": { + "TelemetryExportFailing": "firing" + }, + "queue_oldest_age_s": 0.0, + "error_ratio_1m": 0.0, + "p95_s": 0.023655025284450064, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 67.92974289974181 + }, + { + "t": 527.8, + "alerts": { + "TelemetryExportFailing": "firing" + }, + "queue_oldest_age_s": 0.133987, + "error_ratio_1m": 0.0, + "p95_s": 0.023759013282732448, + "db_waiting": 0.0, + "db_used": 4.0, + "rps": 67.92974289974181 + }, + { + "t": 532.1, + "alerts": { + "TelemetryExportFailing": "firing" + }, + "queue_oldest_age_s": 0.0, + "error_ratio_1m": 0.0, + "p95_s": 0.023960063897763582, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 67.8206480235645 + }, + { + "t": 536.3, + "alerts": { + "TelemetryExportFailing": "firing" + }, + "queue_oldest_age_s": 0.134529, + "error_ratio_1m": 0.0, + "p95_s": 0.023997766432673893, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 67.89214349351806 + }, + { + "t": 540.6, + "alerts": { + "TelemetryExportFailing": "firing" + }, + "queue_oldest_age_s": 0.205896, + "error_ratio_1m": 0.0, + "p95_s": 0.024080629770992363, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 67.76486845215368 + }, + { + "t": 544.9, + "alerts": { + "TelemetryExportFailing": "firing" + }, + "queue_oldest_age_s": 0.205896, + "error_ratio_1m": 0.0, + "p95_s": 0.024150970873786412, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 67.80246554420161 + }, + { + "t": 549.1, + "alerts": { + "TelemetryExportFailing": "firing" + }, + "queue_oldest_age_s": 0.123157, + "error_ratio_1m": 0.0, + "p95_s": 0.02423262739907346, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 67.74791810611295 + }, + { + "t": 553.3, + "alerts": {}, + "queue_oldest_age_s": 0.17385, + "error_ratio_1m": 0.0, + "p95_s": 0.02423262739907346, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 67.74791810611295 + }, + { + "t": 557.4, + "alerts": {}, + "queue_oldest_age_s": 0.076714, + "error_ratio_1m": 0.0, + "p95_s": 0.024358974358974363, + "db_waiting": 0.0, + "db_used": 0.0, + "rps": 67.63882322993564 + }, + { + "t": 561.6, + "alerts": {}, + "queue_oldest_age_s": 0.081785, + "error_ratio_1m": 0.0, + "p95_s": 0.024423342087984242, + "db_waiting": 0.0, + "db_used": 1.0, + "rps": 67.47518091566967 + } + ] +} \ No newline at end of file diff --git a/evidence/incidents.png b/evidence/incidents.png new file mode 100644 index 0000000000000000000000000000000000000000..7b548d2122a9fd4a1bb3d29e496a098d9df7f724 GIT binary patch literal 103259 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,n$#v_VX8Xiv7W*Eb>T&ln?X7lk$Y(kt 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 F0RS5LW@`Wd literal 0 HcmV?d00001 diff --git a/evidence/obs_cost.json b/evidence/obs_cost.json new file mode 100644 index 0000000..de9a553 --- /dev/null +++ b/evidence/obs_cost.json @@ -0,0 +1,1377 @@ +{ + "date": "2026-10-03 04:53:16", + "args": { + "out": "evidence", + "profiles": [ + "off", + "on100", + "head10", + "tail", + "on100_bigq" + ], + "merge": false, + "seconds": 30, + "concurrency": 64, + "procs": 8, + "flush": 25, + "repeat": 2 + }, + "faults": "http500:0.02,slow:0.02:0.6", + "results": [ + { + "profile": "off", + "post": { + "requests": 40957, + "ok": 40097, + "errors": { + "500": 860 + }, + "seconds": 30, + "ok_rps": 1336.6, + "error_ratio": 0.021, + "p50_ms": 15.47, + "p95_ms": 74.45, + "p99_ms": 615.58 + }, + "docker_stats": { + "worker": { + "avg_cpu_percent": 1.8, + "peak_mem_mib": 54.5 + }, + "api": { + "avg_cpu_percent": 53.3, + "peak_mem_mib": 76.3 + }, + "otel-collector": { + "avg_cpu_percent": 0.1, + "peak_mem_mib": 39.1 + }, + "tempo": { + "avg_cpu_percent": 0.3, + "peak_mem_mib": 506.8 + }, + "lb": { + "avg_cpu_percent": 23.1, + "peak_mem_mib": 25.2 + }, + "grafana": { + "avg_cpu_percent": 1.3, + "peak_mem_mib": 404.4 + }, + "rabbitmq": { + "avg_cpu_percent": 13.1, + "peak_mem_mib": 200.9 + }, + "postgres": { + "avg_cpu_percent": 99.8, + "peak_mem_mib": 368.7 + }, + "loki": { + "avg_cpu_percent": 0.6, + "peak_mem_mib": 474.8 + }, + "seaweedfs": { + "avg_cpu_percent": 1.5, + "peak_mem_mib": 546.5 + }, + "prometheus": { + "avg_cpu_percent": 0.6, + "peak_mem_mib": 74.1 + }, + "valkey": { + "avg_cpu_percent": 5.2, + "peak_mem_mib": 11.0 + } + }, + "collector_delta": { + "receiver_accepted_spans": 0, + "receiver_accepted_log_records": 0, + "receiver_accepted_metric_points": 0, + "receiver_refused_spans": 0, + "exporter_sent_spans": 0, + "exporter_send_failed_spans": 0 + }, + "tempo_bytes_delta": -544768, + "loki_bytes_delta": 4280320, + "errors_injected_500": 875, + "slow_requests_gt500ms": 821, + "traces_in_tempo": { + "all_http": 0, + "error": 0, + "slow_gt500ms": 0 + }, + "kept_ratio": { + "errors": 0.0, + "slow": 0.0 + }, + "rps_runs": [ + 1344.6, + 1336.6 + ], + "p95_runs": [ + 73.8, + 74.45 + ], + "runs": [ + { + "profile": "off", + "post": { + "requests": 41134, + "ok": 40337, + "errors": { + "500": 797 + }, + "seconds": 30, + "ok_rps": 1344.6, + "error_ratio": 0.0194, + "p50_ms": 15.04, + "p95_ms": 73.8, + "p99_ms": 615.65 + }, + "docker_stats": { + "worker": { + "avg_cpu_percent": 1.7, + "peak_mem_mib": 54.0 + }, + "api": { + "avg_cpu_percent": 52.4, + "peak_mem_mib": 76.3 + }, + "otel-collector": { + "avg_cpu_percent": 0.1, + "peak_mem_mib": 44.6 + }, + "tempo": { + "avg_cpu_percent": 0.4, + "peak_mem_mib": 507.1 + }, + "lb": { + "avg_cpu_percent": 23.5, + "peak_mem_mib": 24.3 + }, + "grafana": { + "avg_cpu_percent": 1.0, + "peak_mem_mib": 404.1 + }, + "rabbitmq": { + "avg_cpu_percent": 8.2, + "peak_mem_mib": 201.5 + }, + "postgres": { + "avg_cpu_percent": 100.2, + "peak_mem_mib": 370.8 + }, + "loki": { + "avg_cpu_percent": 1.1, + "peak_mem_mib": 484.6 + }, + "seaweedfs": { + "avg_cpu_percent": 1.4, + "peak_mem_mib": 546.2 + }, + "prometheus": { + "avg_cpu_percent": 0.5, + "peak_mem_mib": 73.7 + }, + "valkey": { + "avg_cpu_percent": 5.1, + "peak_mem_mib": 11.0 + } + }, + "collector_delta": { + "receiver_accepted_spans": 0, + "receiver_accepted_log_records": 0, + "receiver_accepted_metric_points": 0, + "receiver_refused_spans": 0, + "exporter_sent_spans": 0, + "exporter_send_failed_spans": 0 + }, + "tempo_bytes_delta": 249856, + "loki_bytes_delta": 3112960, + "errors_injected_500": 813, + "slow_requests_gt500ms": 863, + "traces_in_tempo": { + "all_http": 0, + "error": 0, + "slow_gt500ms": 0 + }, + "kept_ratio": { + "errors": 0.0, + "slow": 0.0 + } + }, + { + "profile": "off", + "post": { + "requests": 40957, + "ok": 40097, + "errors": { + "500": 860 + }, + "seconds": 30, + "ok_rps": 1336.6, + "error_ratio": 0.021, + "p50_ms": 15.47, + "p95_ms": 74.45, + "p99_ms": 615.58 + }, + "docker_stats": { + "worker": { + "avg_cpu_percent": 1.8, + "peak_mem_mib": 54.5 + }, + "api": { + "avg_cpu_percent": 53.3, + "peak_mem_mib": 76.3 + }, + "otel-collector": { + "avg_cpu_percent": 0.1, + "peak_mem_mib": 39.1 + }, + "tempo": { + "avg_cpu_percent": 0.3, + "peak_mem_mib": 506.8 + }, + "lb": { + "avg_cpu_percent": 23.1, + "peak_mem_mib": 25.2 + }, + "grafana": { + "avg_cpu_percent": 1.3, + "peak_mem_mib": 404.4 + }, + "rabbitmq": { + "avg_cpu_percent": 13.1, + "peak_mem_mib": 200.9 + }, + "postgres": { + "avg_cpu_percent": 99.8, + "peak_mem_mib": 368.7 + }, + "loki": { + "avg_cpu_percent": 0.6, + "peak_mem_mib": 474.8 + }, + "seaweedfs": { + "avg_cpu_percent": 1.5, + "peak_mem_mib": 546.5 + }, + "prometheus": { + "avg_cpu_percent": 0.6, + "peak_mem_mib": 74.1 + }, + "valkey": { + "avg_cpu_percent": 5.2, + "peak_mem_mib": 11.0 + } + }, + "collector_delta": { + "receiver_accepted_spans": 0, + "receiver_accepted_log_records": 0, + "receiver_accepted_metric_points": 0, + "receiver_refused_spans": 0, + "exporter_sent_spans": 0, + "exporter_send_failed_spans": 0 + }, + "tempo_bytes_delta": -544768, + "loki_bytes_delta": 4280320, + "errors_injected_500": 875, + "slow_requests_gt500ms": 821, + "traces_in_tempo": { + "all_http": 0, + "error": 0, + "slow_gt500ms": 0 + }, + "kept_ratio": { + "errors": 0.0, + "slow": 0.0 + } + } + ] + }, + { + "profile": "on100", + "post": { + "requests": 40983, + "ok": 40144, + "errors": { + "500": 839 + }, + "seconds": 30, + "ok_rps": 1338.1, + "error_ratio": 0.0205, + "p50_ms": 22.75, + "p95_ms": 70.25, + "p99_ms": 628.03 + }, + "docker_stats": { + "worker": { + "avg_cpu_percent": 1.8, + "peak_mem_mib": 59.7 + }, + "api": { + "avg_cpu_percent": 86.9, + "peak_mem_mib": 87.9 + }, + "otel-collector": { + "avg_cpu_percent": 3.1, + "peak_mem_mib": 70.8 + }, + "tempo": { + "avg_cpu_percent": 6.3, + "peak_mem_mib": 389.0 + }, + "lb": { + "avg_cpu_percent": 22.3, + "peak_mem_mib": 24.5 + }, + "grafana": { + "avg_cpu_percent": 1.3, + "peak_mem_mib": 410.1 + }, + "rabbitmq": { + "avg_cpu_percent": 8.5, + "peak_mem_mib": 205.7 + }, + "postgres": { + "avg_cpu_percent": 96.5, + "peak_mem_mib": 373.0 + }, + "loki": { + "avg_cpu_percent": 4.9, + "peak_mem_mib": 497.0 + }, + "seaweedfs": { + "avg_cpu_percent": 1.6, + "peak_mem_mib": 546.3 + }, + "prometheus": { + "avg_cpu_percent": 0.6, + "peak_mem_mib": 74.3 + }, + "valkey": { + "avg_cpu_percent": 5.3, + "peak_mem_mib": 11.6 + } + }, + "collector_delta": { + "receiver_accepted_spans": 96287, + "receiver_accepted_log_records": 47752, + "receiver_accepted_metric_points": 372, + "receiver_refused_spans": 0, + "exporter_sent_spans": 96287, + "exporter_send_failed_spans": 0 + }, + "tempo_bytes_delta": 23527424, + "loki_bytes_delta": -54317056, + "errors_injected_500": 851, + "slow_requests_gt500ms": 853, + "traces_in_tempo": { + "all_http": 5000, + "error": 940, + "slow_gt500ms": 946 + }, + "kept_ratio": { + "errors": 1.105, + "slow": 1.109 + }, + "rps_runs": [ + 1311.6, + 1338.1 + ], + "p95_runs": [ + 74.2, + 70.25 + ], + "runs": [ + { + "profile": "on100", + "post": { + "requests": 40149, + "ok": 39347, + "errors": { + "500": 802 + }, + "seconds": 30, + "ok_rps": 1311.6, + "error_ratio": 0.02, + "p50_ms": 23.48, + "p95_ms": 74.2, + "p99_ms": 627.83 + }, + "docker_stats": { + "worker": { + "avg_cpu_percent": 1.9, + "peak_mem_mib": 60.4 + }, + "api": { + "avg_cpu_percent": 83.8, + "peak_mem_mib": 86.0 + }, + "otel-collector": { + "avg_cpu_percent": 3.2, + "peak_mem_mib": 73.3 + }, + "tempo": { + "avg_cpu_percent": 5.1, + "peak_mem_mib": 437.9 + }, + "lb": { + "avg_cpu_percent": 21.7, + "peak_mem_mib": 24.1 + }, + "grafana": { + "avg_cpu_percent": 0.8, + "peak_mem_mib": 404.2 + }, + "rabbitmq": { + "avg_cpu_percent": 13.2, + "peak_mem_mib": 207.1 + }, + "postgres": { + "avg_cpu_percent": 97.0, + "peak_mem_mib": 372.8 + }, + "loki": { + "avg_cpu_percent": 3.9, + "peak_mem_mib": 477.8 + }, + "seaweedfs": { + "avg_cpu_percent": 1.5, + "peak_mem_mib": 546.3 + }, + "prometheus": { + "avg_cpu_percent": 0.7, + "peak_mem_mib": 74.3 + }, + "valkey": { + "avg_cpu_percent": 5.4, + "peak_mem_mib": 12.2 + } + }, + "collector_delta": { + "receiver_accepted_spans": 98971, + "receiver_accepted_log_records": 46175, + "receiver_accepted_metric_points": 341, + "receiver_refused_spans": 0, + "exporter_sent_spans": 93904, + "exporter_send_failed_spans": 0 + }, + "tempo_bytes_delta": -24104960, + "loki_bytes_delta": 34271232, + "errors_injected_500": 818, + "slow_requests_gt500ms": 783, + "traces_in_tempo": { + "all_http": 5000, + "error": 904, + "slow_gt500ms": 893 + }, + "kept_ratio": { + "errors": 1.105, + "slow": 1.14 + } + }, + { + "profile": "on100", + "post": { + "requests": 40983, + "ok": 40144, + "errors": { + "500": 839 + }, + "seconds": 30, + "ok_rps": 1338.1, + "error_ratio": 0.0205, + "p50_ms": 22.75, + "p95_ms": 70.25, + "p99_ms": 628.03 + }, + "docker_stats": { + "worker": { + "avg_cpu_percent": 1.8, + "peak_mem_mib": 59.7 + }, + "api": { + "avg_cpu_percent": 86.9, + "peak_mem_mib": 87.9 + }, + "otel-collector": { + "avg_cpu_percent": 3.1, + "peak_mem_mib": 70.8 + }, + "tempo": { + "avg_cpu_percent": 6.3, + "peak_mem_mib": 389.0 + }, + "lb": { + "avg_cpu_percent": 22.3, + "peak_mem_mib": 24.5 + }, + "grafana": { + "avg_cpu_percent": 1.3, + "peak_mem_mib": 410.1 + }, + "rabbitmq": { + "avg_cpu_percent": 8.5, + "peak_mem_mib": 205.7 + }, + "postgres": { + "avg_cpu_percent": 96.5, + "peak_mem_mib": 373.0 + }, + "loki": { + "avg_cpu_percent": 4.9, + "peak_mem_mib": 497.0 + }, + "seaweedfs": { + "avg_cpu_percent": 1.6, + "peak_mem_mib": 546.3 + }, + "prometheus": { + "avg_cpu_percent": 0.6, + "peak_mem_mib": 74.3 + }, + "valkey": { + "avg_cpu_percent": 5.3, + "peak_mem_mib": 11.6 + } + }, + "collector_delta": { + "receiver_accepted_spans": 96287, + "receiver_accepted_log_records": 47752, + "receiver_accepted_metric_points": 372, + "receiver_refused_spans": 0, + "exporter_sent_spans": 96287, + "exporter_send_failed_spans": 0 + }, + "tempo_bytes_delta": 23527424, + "loki_bytes_delta": -54317056, + "errors_injected_500": 851, + "slow_requests_gt500ms": 853, + "traces_in_tempo": { + "all_http": 5000, + "error": 940, + "slow_gt500ms": 946 + }, + "kept_ratio": { + "errors": 1.105, + "slow": 1.109 + } + } + ] + }, + { + "profile": "head10", + "post": { + "requests": 42159, + "ok": 41294, + "errors": { + "500": 865 + }, + "seconds": 30, + "ok_rps": 1376.5, + "error_ratio": 0.0205, + "p50_ms": 20.09, + "p95_ms": 70.82, + "p99_ms": 612.19 + }, + "docker_stats": { + "worker": { + "avg_cpu_percent": 2.0, + "peak_mem_mib": 62.4 + }, + "api": { + "avg_cpu_percent": 76.8, + "peak_mem_mib": 87.0 + }, + "otel-collector": { + "avg_cpu_percent": 1.7, + "peak_mem_mib": 71.2 + }, + "tempo": { + "avg_cpu_percent": 1.3, + "peak_mem_mib": 301.0 + }, + "lb": { + "avg_cpu_percent": 21.7, + "peak_mem_mib": 24.3 + }, + "grafana": { + "avg_cpu_percent": 0.9, + "peak_mem_mib": 403.9 + }, + "rabbitmq": { + "avg_cpu_percent": 13.3, + "peak_mem_mib": 208.8 + }, + "postgres": { + "avg_cpu_percent": 98.0, + "peak_mem_mib": 372.3 + }, + "loki": { + "avg_cpu_percent": 4.0, + "peak_mem_mib": 465.0 + }, + "seaweedfs": { + "avg_cpu_percent": 1.4, + "peak_mem_mib": 546.3 + }, + "prometheus": { + "avg_cpu_percent": 0.7, + "peak_mem_mib": 76.9 + }, + "valkey": { + "avg_cpu_percent": 5.4, + "peak_mem_mib": 11.4 + } + }, + "collector_delta": { + "receiver_accepted_spans": 9927, + "receiver_accepted_log_records": 49103, + "receiver_accepted_metric_points": 372, + "receiver_refused_spans": 0, + "exporter_sent_spans": 10422, + "exporter_send_failed_spans": 0 + }, + "tempo_bytes_delta": -5586944, + "loki_bytes_delta": -53788672, + "errors_injected_500": 872, + "slow_requests_gt500ms": 834, + "traces_in_tempo": { + "all_http": 4904, + "error": 113, + "slow_gt500ms": 77 + }, + "kept_ratio": { + "errors": 0.13, + "slow": 0.092 + }, + "rps_runs": [ + 1424.9, + 1376.5 + ], + "p95_runs": [ + 64.1, + 70.82 + ], + "runs": [ + { + "profile": "head10", + "post": { + "requests": 43671, + "ok": 42747, + "errors": { + "500": 924 + }, + "seconds": 30, + "ok_rps": 1424.9, + "error_ratio": 0.0212, + "p50_ms": 18.5, + "p95_ms": 64.1, + "p99_ms": 621.33 + }, + "docker_stats": { + "worker": { + "avg_cpu_percent": 1.5, + "peak_mem_mib": 60.3 + }, + "api": { + "avg_cpu_percent": 74.1, + "peak_mem_mib": 84.0 + }, + "otel-collector": { + "avg_cpu_percent": 2.0, + "peak_mem_mib": 70.9 + }, + "tempo": { + "avg_cpu_percent": 2.2, + "peak_mem_mib": 260.5 + }, + "lb": { + "avg_cpu_percent": 22.2, + "peak_mem_mib": 24.0 + }, + "grafana": { + "avg_cpu_percent": 1.1, + "peak_mem_mib": 405.1 + }, + "rabbitmq": { + "avg_cpu_percent": 10.9, + "peak_mem_mib": 196.5 + }, + "postgres": { + "avg_cpu_percent": 99.3, + "peak_mem_mib": 373.8 + }, + "loki": { + "avg_cpu_percent": 4.4, + "peak_mem_mib": 500.8 + }, + "seaweedfs": { + "avg_cpu_percent": 1.3, + "peak_mem_mib": 546.3 + }, + "prometheus": { + "avg_cpu_percent": 0.4, + "peak_mem_mib": 76.6 + }, + "valkey": { + "avg_cpu_percent": 5.3, + "peak_mem_mib": 11.5 + } + }, + "collector_delta": { + "receiver_accepted_spans": 11172, + "receiver_accepted_log_records": 50129, + "receiver_accepted_metric_points": 341, + "receiver_refused_spans": 0, + "exporter_sent_spans": 10205, + "exporter_send_failed_spans": 0 + }, + "tempo_bytes_delta": 2437120, + "loki_bytes_delta": 43749376, + "errors_injected_500": 935, + "slow_requests_gt500ms": 895, + "traces_in_tempo": { + "all_http": 4935, + "error": 108, + "slow_gt500ms": 86 + }, + "kept_ratio": { + "errors": 0.116, + "slow": 0.096 + } + }, + { + "profile": "head10", + "post": { + "requests": 42159, + "ok": 41294, + "errors": { + "500": 865 + }, + "seconds": 30, + "ok_rps": 1376.5, + "error_ratio": 0.0205, + "p50_ms": 20.09, + "p95_ms": 70.82, + "p99_ms": 612.19 + }, + "docker_stats": { + "worker": { + "avg_cpu_percent": 2.0, + "peak_mem_mib": 62.4 + }, + "api": { + "avg_cpu_percent": 76.8, + "peak_mem_mib": 87.0 + }, + "otel-collector": { + "avg_cpu_percent": 1.7, + "peak_mem_mib": 71.2 + }, + "tempo": { + "avg_cpu_percent": 1.3, + "peak_mem_mib": 301.0 + }, + "lb": { + "avg_cpu_percent": 21.7, + "peak_mem_mib": 24.3 + }, + "grafana": { + "avg_cpu_percent": 0.9, + "peak_mem_mib": 403.9 + }, + "rabbitmq": { + "avg_cpu_percent": 13.3, + "peak_mem_mib": 208.8 + }, + "postgres": { + "avg_cpu_percent": 98.0, + "peak_mem_mib": 372.3 + }, + "loki": { + "avg_cpu_percent": 4.0, + "peak_mem_mib": 465.0 + }, + "seaweedfs": { + "avg_cpu_percent": 1.4, + "peak_mem_mib": 546.3 + }, + "prometheus": { + "avg_cpu_percent": 0.7, + "peak_mem_mib": 76.9 + }, + "valkey": { + "avg_cpu_percent": 5.4, + "peak_mem_mib": 11.4 + } + }, + "collector_delta": { + "receiver_accepted_spans": 9927, + "receiver_accepted_log_records": 49103, + "receiver_accepted_metric_points": 372, + "receiver_refused_spans": 0, + "exporter_sent_spans": 10422, + "exporter_send_failed_spans": 0 + }, + "tempo_bytes_delta": -5586944, + "loki_bytes_delta": -53788672, + "errors_injected_500": 872, + "slow_requests_gt500ms": 834, + "traces_in_tempo": { + "all_http": 4904, + "error": 113, + "slow_gt500ms": 77 + }, + "kept_ratio": { + "errors": 0.13, + "slow": 0.092 + } + } + ] + }, + { + "profile": "tail", + "post": { + "requests": 42956, + "ok": 42071, + "errors": { + "500": 885 + }, + "seconds": 30, + "ok_rps": 1402.4, + "error_ratio": 0.0206, + "p50_ms": 20.69, + "p95_ms": 63.76, + "p99_ms": 625.38 + }, + "docker_stats": { + "worker": { + "avg_cpu_percent": 1.9, + "peak_mem_mib": 59.7 + }, + "api": { + "avg_cpu_percent": 84.9, + "peak_mem_mib": 86.5 + }, + "otel-collector": { + "avg_cpu_percent": 4.0, + "peak_mem_mib": 110.5 + }, + "tempo": { + "avg_cpu_percent": 1.2, + "peak_mem_mib": 311.2 + }, + "lb": { + "avg_cpu_percent": 21.1, + "peak_mem_mib": 24.1 + }, + "grafana": { + "avg_cpu_percent": 0.7, + "peak_mem_mib": 404.0 + }, + "rabbitmq": { + "avg_cpu_percent": 9.7, + "peak_mem_mib": 174.7 + }, + "postgres": { + "avg_cpu_percent": 96.8, + "peak_mem_mib": 375.0 + }, + "loki": { + "avg_cpu_percent": 5.0, + "peak_mem_mib": 471.8 + }, + "seaweedfs": { + "avg_cpu_percent": 1.4, + "peak_mem_mib": 546.4 + }, + "prometheus": { + "avg_cpu_percent": 0.7, + "peak_mem_mib": 78.8 + }, + "valkey": { + "avg_cpu_percent": 5.2, + "peak_mem_mib": 11.8 + } + }, + "collector_delta": { + "receiver_accepted_spans": 101134, + "receiver_accepted_log_records": 49659, + "receiver_accepted_metric_points": 372, + "receiver_refused_spans": 0, + "exporter_sent_spans": 14954, + "exporter_send_failed_spans": 0 + }, + "tempo_bytes_delta": -4780032, + "loki_bytes_delta": 38547456, + "errors_injected_500": 899, + "slow_requests_gt500ms": 944, + "traces_in_tempo": { + "all_http": 5000, + "error": 1003, + "slow_gt500ms": 1054 + }, + "kept_ratio": { + "errors": 1.116, + "slow": 1.117 + }, + "rps_runs": [ + 1396.8, + 1402.4 + ], + "p95_runs": [ + 70.29, + 63.76 + ], + "runs": [ + { + "profile": "tail", + "post": { + "requests": 42797, + "ok": 41904, + "errors": { + "500": 893 + }, + "seconds": 30, + "ok_rps": 1396.8, + "error_ratio": 0.0209, + "p50_ms": 20.92, + "p95_ms": 70.29, + "p99_ms": 625.38 + }, + "docker_stats": { + "worker": { + "avg_cpu_percent": 1.8, + "peak_mem_mib": 61.7 + }, + "api": { + "avg_cpu_percent": 84.4, + "peak_mem_mib": 87.3 + }, + "otel-collector": { + "avg_cpu_percent": 3.9, + "peak_mem_mib": 110.4 + }, + "tempo": { + "avg_cpu_percent": 2.4, + "peak_mem_mib": 330.1 + }, + "lb": { + "avg_cpu_percent": 21.8, + "peak_mem_mib": 24.6 + }, + "grafana": { + "avg_cpu_percent": 0.7, + "peak_mem_mib": 403.9 + }, + "rabbitmq": { + "avg_cpu_percent": 10.3, + "peak_mem_mib": 194.5 + }, + "postgres": { + "avg_cpu_percent": 97.1, + "peak_mem_mib": 373.2 + }, + "loki": { + "avg_cpu_percent": 4.5, + "peak_mem_mib": 460.9 + }, + "seaweedfs": { + "avg_cpu_percent": 1.5, + "peak_mem_mib": 546.4 + }, + "prometheus": { + "avg_cpu_percent": 0.7, + "peak_mem_mib": 76.7 + }, + "valkey": { + "avg_cpu_percent": 5.3, + "peak_mem_mib": 14.1 + } + }, + "collector_delta": { + "receiver_accepted_spans": 99880, + "receiver_accepted_log_records": 49202, + "receiver_accepted_metric_points": 341, + "receiver_refused_spans": 0, + "exporter_sent_spans": 14046, + "exporter_send_failed_spans": 0 + }, + "tempo_bytes_delta": -1884160, + "loki_bytes_delta": 33947648, + "errors_injected_500": 908, + "slow_requests_gt500ms": 875, + "traces_in_tempo": { + "all_http": 5000, + "error": 1013, + "slow_gt500ms": 985 + }, + "kept_ratio": { + "errors": 1.116, + "slow": 1.126 + } + }, + { + "profile": "tail", + "post": { + "requests": 42956, + "ok": 42071, + "errors": { + "500": 885 + }, + "seconds": 30, + "ok_rps": 1402.4, + "error_ratio": 0.0206, + "p50_ms": 20.69, + "p95_ms": 63.76, + "p99_ms": 625.38 + }, + "docker_stats": { + "worker": { + "avg_cpu_percent": 1.9, + "peak_mem_mib": 59.7 + }, + "api": { + "avg_cpu_percent": 84.9, + "peak_mem_mib": 86.5 + }, + "otel-collector": { + "avg_cpu_percent": 4.0, + "peak_mem_mib": 110.5 + }, + "tempo": { + "avg_cpu_percent": 1.2, + "peak_mem_mib": 311.2 + }, + "lb": { + "avg_cpu_percent": 21.1, + "peak_mem_mib": 24.1 + }, + "grafana": { + "avg_cpu_percent": 0.7, + "peak_mem_mib": 404.0 + }, + "rabbitmq": { + "avg_cpu_percent": 9.7, + "peak_mem_mib": 174.7 + }, + "postgres": { + "avg_cpu_percent": 96.8, + "peak_mem_mib": 375.0 + }, + "loki": { + "avg_cpu_percent": 5.0, + "peak_mem_mib": 471.8 + }, + "seaweedfs": { + "avg_cpu_percent": 1.4, + "peak_mem_mib": 546.4 + }, + "prometheus": { + "avg_cpu_percent": 0.7, + "peak_mem_mib": 78.8 + }, + "valkey": { + "avg_cpu_percent": 5.2, + "peak_mem_mib": 11.8 + } + }, + "collector_delta": { + "receiver_accepted_spans": 101134, + "receiver_accepted_log_records": 49659, + "receiver_accepted_metric_points": 372, + "receiver_refused_spans": 0, + "exporter_sent_spans": 14954, + "exporter_send_failed_spans": 0 + }, + "tempo_bytes_delta": -4780032, + "loki_bytes_delta": 38547456, + "errors_injected_500": 899, + "slow_requests_gt500ms": 944, + "traces_in_tempo": { + "all_http": 5000, + "error": 1003, + "slow_gt500ms": 1054 + }, + "kept_ratio": { + "errors": 1.116, + "slow": 1.117 + } + } + ] + }, + { + "profile": "on100_bigq", + "post": { + "requests": 41207, + "ok": 40393, + "errors": { + "500": 814 + }, + "seconds": 30, + "ok_rps": 1346.4, + "error_ratio": 0.0198, + "p50_ms": 20.68, + "p95_ms": 76.9, + "p99_ms": 625.55 + }, + "docker_stats": { + "worker": { + "avg_cpu_percent": 1.7, + "peak_mem_mib": 62.2 + }, + "api": { + "avg_cpu_percent": 83.9, + "peak_mem_mib": 89.8 + }, + "otel-collector": { + "avg_cpu_percent": 2.9, + "peak_mem_mib": 72.2 + }, + "tempo": { + "avg_cpu_percent": 3.1, + "peak_mem_mib": 387.2 + }, + "lb": { + "avg_cpu_percent": 21.6, + "peak_mem_mib": 24.4 + }, + "grafana": { + "avg_cpu_percent": 1.1, + "peak_mem_mib": 403.9 + }, + "rabbitmq": { + "avg_cpu_percent": 14.3, + "peak_mem_mib": 211.9 + }, + "postgres": { + "avg_cpu_percent": 96.8, + "peak_mem_mib": 368.8 + }, + "loki": { + "avg_cpu_percent": 4.3, + "peak_mem_mib": 482.2 + }, + "seaweedfs": { + "avg_cpu_percent": 1.3, + "peak_mem_mib": 546.3 + }, + "prometheus": { + "avg_cpu_percent": 0.4, + "peak_mem_mib": 80.9 + }, + "valkey": { + "avg_cpu_percent": 5.5, + "peak_mem_mib": 11.7 + } + }, + "collector_delta": { + "receiver_accepted_spans": 96033, + "receiver_accepted_log_records": 47183, + "receiver_accepted_metric_points": 372, + "receiver_refused_spans": 0, + "exporter_sent_spans": 96033, + "exporter_send_failed_spans": 0 + }, + "tempo_bytes_delta": -18698240, + "loki_bytes_delta": -87719936, + "errors_injected_500": 826, + "slow_requests_gt500ms": 840, + "traces_in_tempo": { + "all_http": 5000, + "error": 905, + "slow_gt500ms": 950 + }, + "kept_ratio": { + "errors": 1.096, + "slow": 1.131 + }, + "rps_runs": [ + 1423.1, + 1346.4 + ], + "p95_runs": [ + 73.18, + 76.9 + ], + "runs": [ + { + "profile": "on100_bigq", + "post": { + "requests": 43580, + "ok": 42693, + "errors": { + "500": 887 + }, + "seconds": 30, + "ok_rps": 1423.1, + "error_ratio": 0.0204, + "p50_ms": 18.41, + "p95_ms": 73.18, + "p99_ms": 622.45 + }, + "docker_stats": { + "worker": { + "avg_cpu_percent": 2.2, + "peak_mem_mib": 62.2 + }, + "api": { + "avg_cpu_percent": 80.6, + "peak_mem_mib": 80.2 + }, + "otel-collector": { + "avg_cpu_percent": 3.1, + "peak_mem_mib": 71.6 + }, + "tempo": { + "avg_cpu_percent": 3.5, + "peak_mem_mib": 381.4 + }, + "lb": { + "avg_cpu_percent": 21.1, + "peak_mem_mib": 24.3 + }, + "grafana": { + "avg_cpu_percent": 1.0, + "peak_mem_mib": 403.9 + }, + "rabbitmq": { + "avg_cpu_percent": 12.5, + "peak_mem_mib": 200.6 + }, + "postgres": { + "avg_cpu_percent": 97.4, + "peak_mem_mib": 379.6 + }, + "loki": { + "avg_cpu_percent": 5.2, + "peak_mem_mib": 479.5 + }, + "seaweedfs": { + "avg_cpu_percent": 1.2, + "peak_mem_mib": 546.3 + }, + "prometheus": { + "avg_cpu_percent": 0.3, + "peak_mem_mib": 78.9 + }, + "valkey": { + "avg_cpu_percent": 5.1, + "peak_mem_mib": 11.4 + } + }, + "collector_delta": { + "receiver_accepted_spans": 108579, + "receiver_accepted_log_records": 52295, + "receiver_accepted_metric_points": 372, + "receiver_refused_spans": 0, + "exporter_sent_spans": 101589, + "exporter_send_failed_spans": 0 + }, + "tempo_bytes_delta": 22175744, + "loki_bytes_delta": 39370752, + "errors_injected_500": 900, + "slow_requests_gt500ms": 912, + "traces_in_tempo": { + "all_http": 5000, + "error": 996, + "slow_gt500ms": 1020 + }, + "kept_ratio": { + "errors": 1.107, + "slow": 1.118 + } + }, + { + "profile": "on100_bigq", + "post": { + "requests": 41207, + "ok": 40393, + "errors": { + "500": 814 + }, + "seconds": 30, + "ok_rps": 1346.4, + "error_ratio": 0.0198, + "p50_ms": 20.68, + "p95_ms": 76.9, + "p99_ms": 625.55 + }, + "docker_stats": { + "worker": { + "avg_cpu_percent": 1.7, + "peak_mem_mib": 62.2 + }, + "api": { + "avg_cpu_percent": 83.9, + "peak_mem_mib": 89.8 + }, + "otel-collector": { + "avg_cpu_percent": 2.9, + "peak_mem_mib": 72.2 + }, + "tempo": { + "avg_cpu_percent": 3.1, + "peak_mem_mib": 387.2 + }, + "lb": { + "avg_cpu_percent": 21.6, + "peak_mem_mib": 24.4 + }, + "grafana": { + "avg_cpu_percent": 1.1, + "peak_mem_mib": 403.9 + }, + "rabbitmq": { + "avg_cpu_percent": 14.3, + "peak_mem_mib": 211.9 + }, + "postgres": { + "avg_cpu_percent": 96.8, + "peak_mem_mib": 368.8 + }, + "loki": { + "avg_cpu_percent": 4.3, + "peak_mem_mib": 482.2 + }, + "seaweedfs": { + "avg_cpu_percent": 1.3, + "peak_mem_mib": 546.3 + }, + "prometheus": { + "avg_cpu_percent": 0.4, + "peak_mem_mib": 80.9 + }, + "valkey": { + "avg_cpu_percent": 5.5, + "peak_mem_mib": 11.7 + } + }, + "collector_delta": { + "receiver_accepted_spans": 96033, + "receiver_accepted_log_records": 47183, + "receiver_accepted_metric_points": 372, + "receiver_refused_spans": 0, + "exporter_sent_spans": 96033, + "exporter_send_failed_spans": 0 + }, + "tempo_bytes_delta": -18698240, + "loki_bytes_delta": -87719936, + "errors_injected_500": 826, + "slow_requests_gt500ms": 840, + "traces_in_tempo": { + "all_http": 5000, + "error": 905, + "slow_gt500ms": 950 + }, + "kept_ratio": { + "errors": 1.096, + "slow": 1.131 + } + } + ] + } + ] +} \ No newline at end of file diff --git a/evidence/obs_cost.png b/evidence/obs_cost.png new file mode 100644 index 0000000000000000000000000000000000000000..dc3f50b5057d514d0f883c556129e9649f4f0b79 GIT binary patch literal 68392 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 G_ трасса (derivedFields), +# трасса -> логи (tracesToLogsV2), трасса -> метрики. +datasources: + - name: Prometheus + uid: prometheus + type: prometheus + access: proxy + url: http://prometheus:9090 + isDefault: true + jsonData: + timeInterval: 5s + - name: Loki + uid: loki + type: loki + access: proxy + url: http://loki:3100 + jsonData: + derivedFields: + - name: trace_id + matcherType: label + matcherRegex: trace_id + url: "$${__value.raw}" + datasourceUid: tempo + - name: Tempo + uid: tempo + type: tempo + access: proxy + url: http://tempo:3200 + jsonData: + tracesToLogsV2: + datasourceUid: loki + spanStartTimeShift: "-1m" + spanEndTimeShift: "1m" + filterByTraceID: true + customQuery: true + query: '{service_name="$${__span.tags["service.name"]}"} | trace_id="$${__span.traceId}"' + tracesToMetrics: + datasourceUid: prometheus + serviceMap: + datasourceUid: prometheus diff --git a/infra/haproxy/haproxy.cfg b/infra/haproxy/haproxy.cfg new file mode 100644 index 0000000..4be6130 --- /dev/null +++ b/infra/haproxy/haproxy.cfg @@ -0,0 +1,50 @@ +# Балансировщик lab3: HAProxy 3.0. Единственная публичная точка входа; API-реплики наружу не опубликованы. +global + log stdout format raw local0 notice + maxconn 4096 + +defaults + mode http + log global + option dontlognull + option forwardfor + # connect короткий: недоступная реплика быстро заменяется другой (redispatch) + timeout connect 1s + timeout client 30s + timeout server 30s + timeout http-request 10s + timeout http-keep-alive 5s + timeout queue 5s + retries 3 + option redispatch 1 + retry-on conn-failure empty-response response-timeout 0rtt-rejected + +# Docker DNS (127.0.0.11): адреса реплик API обновляются без перезапуска LB (scale up/down, пересоздание контейнеров). +resolvers docker + nameserver dns 127.0.0.11:53 + accepted_payload_size 8192 + resolve_retries 3 + timeout resolve 1s + timeout retry 1s + hold valid 2s + hold nx 2s + hold other 2s + hold obsolete 2s + +frontend public + bind :8080 + default_backend api + +# Внутренний healthcheck самого LB (контейнерный HEALTHCHECK); наружу не публикуется. +frontend lb_health + bind :8081 + monitor-uri /healthz + +backend api + balance roundrobin + # Проверка готовности каждые 1 с; 2 неудачи подряд -> сервер исключён (обнаружение отказа <= ~3 с), 2 успеха -> возвращён. + option httpchk + http-check send meth GET uri /health/ready + http-check expect status 200 + default-server check inter 1s fall 2 rise 2 resolvers docker init-addr none + server-template api 1-8 api:8080 diff --git a/infra/loki/loki.yaml b/infra/loki/loki.yaml new file mode 100644 index 0000000..46b02d6 --- /dev/null +++ b/infra/loki/loki.yaml @@ -0,0 +1,37 @@ +# Loki: хранилище логов (filesystem, volume lokidata). Принимает OTLP/HTTP от Collector (/otlp/v1/logs). +auth_enabled: false +server: + http_listen_port: 3100 + grpc_listen_port: 9096 + log_level: warn +common: + instance_addr: 127.0.0.1 + path_prefix: /loki + storage: + filesystem: + chunks_directory: /loki/chunks + rules_directory: /loki/rules + replication_factor: 1 + ring: + kvstore: + store: inmemory +schema_config: + configs: + - from: 2024-04-01 + store: tsdb + object_store: filesystem + schema: v13 + index: + prefix: index_ + period: 24h +limits_config: + allow_structured_metadata: true + retention_period: 168h + reject_old_samples: false + volume_enabled: true +compactor: + working_directory: /loki/compactor + retention_enabled: true + delete_request_store: filesystem +analytics: + reporting_enabled: false diff --git a/infra/otel/collector-tail.yaml b/infra/otel/collector-tail.yaml new file mode 100644 index 0000000..a75261d --- /dev/null +++ b/infra/otel/collector-tail.yaml @@ -0,0 +1,64 @@ +# Профиль «tail sampling» (трек 1, lab6): SDK отправляет 100 % спанов, Collector оставляет +# - все трассы с ошибками, - все медленные (> 500 мс), - 10 % остальных. +# Метрики и логи без изменений. Подключается через COLLECTOR_CONFIG=/etc/otelcol/collector-tail.yaml. +receivers: + otlp: + protocols: + grpc: {endpoint: 0.0.0.0:4317} + http: {endpoint: 0.0.0.0:4318} + +processors: + memory_limiter: {check_interval: 1s, limit_mib: 280, spike_limit_mib: 60} + batch: {send_batch_size: 1024, send_batch_max_size: 2048, timeout: 2s} + attributes/scrub: + actions: + - {key: http.request.header.authorization, action: delete} + - {key: http.request.header.cookie, action: delete} + - {key: db.statement, action: delete} + - {key: url.query, action: delete} + tail_sampling: + decision_wait: 5s + num_traces: 20000 + expected_new_traces_per_sec: 500 + policies: + - {name: errors, type: status_code, status_code: {status_codes: [ERROR]}} + - {name: slow, type: latency, latency: {threshold_ms: 500}} + - {name: baseline, type: probabilistic, probabilistic: {sampling_percentage: 10}} + +exporters: + otlp_grpc/tempo: + endpoint: tempo:4317 + tls: {insecure: true} + sending_queue: {enabled: true, num_consumers: 2, queue_size: 500} + retry_on_failure: {enabled: true, initial_interval: 1s, max_interval: 10s, max_elapsed_time: 30s} + otlp_http/loki: + endpoint: http://loki:3100/otlp + sending_queue: {enabled: true, num_consumers: 2, queue_size: 500} + retry_on_failure: {enabled: true, initial_interval: 1s, max_interval: 10s, max_elapsed_time: 30s} + prometheus: + endpoint: 0.0.0.0:8889 + resource_to_telemetry_conversion: {enabled: true} + metric_expiration: 20s + +service: + telemetry: + metrics: + level: normal + readers: + - pull: + exporter: + prometheus: {host: 0.0.0.0, port: 8888} + logs: {level: warn} + pipelines: + traces: + receivers: [otlp] + processors: [memory_limiter, attributes/scrub, tail_sampling, batch] + exporters: [otlp_grpc/tempo] + metrics: + receivers: [otlp] + processors: [memory_limiter, batch] + exporters: [prometheus] + logs: + receivers: [otlp] + processors: [memory_limiter, attributes/scrub, batch] + exporters: [otlp_http/loki] diff --git a/infra/otel/collector.yaml b/infra/otel/collector.yaml new file mode 100644 index 0000000..bb3556c --- /dev/null +++ b/infra/otel/collector.yaml @@ -0,0 +1,75 @@ +# OpenTelemetry Collector (contrib). Один пайплайн на сигнал, у каждого — реальный backend: +# traces -> Tempo (OTLP/gRPC) +# metrics -> Prometheus (Prometheus-экспортёр: Prometheus сам забирает /metrics у Collector) +# logs -> Loki (OTLP/HTTP, нативный приём Loki) +# Collector — маршрутизатор/обработчик, не долговременное хранилище. Порты 4317/4318 доступны ТОЛЬКО во внутренней сети backend. +receivers: + otlp: + protocols: + grpc: + endpoint: 0.0.0.0:4317 + http: + endpoint: 0.0.0.0:4318 + +processors: + # Защита RAM Collector: при приближении к лимиту новые данные отклоняются (клиент SDK получает ошибку и отбрасывает + # пакет, приложение продолжает работать). limit_mib согласован с mem_limit контейнера. + memory_limiter: + check_interval: 1s + limit_mib: 280 + spike_limit_mib: 60 + batch: + send_batch_size: 1024 + send_batch_max_size: 2048 + timeout: 2s + # Гарантированное удаление чувствительных атрибутов, даже если приложение их случайно передаст. + attributes/scrub: + actions: + - {key: http.request.header.authorization, action: delete} + - {key: http.request.header.cookie, action: delete} + - {key: http.request.body, action: delete} + - {key: db.statement, action: delete} + - {key: url.query, action: delete} + - {key: http.target, action: delete} + # Tail-sampling (профиль «tail», см. collector-tail.yaml): здесь не используется. + +exporters: + otlp_grpc/tempo: + endpoint: tempo:4317 + tls: {insecure: true} + # Ограниченная буферизация при недоступном backend: очередь фиксированного размера, повторы до 30 с, затем отбрасывание + # (потери считаются метрикой otelcol_exporter_send_failed_spans / otelcol_exporter_queue_size). + sending_queue: {enabled: true, num_consumers: 2, queue_size: 500} + retry_on_failure: {enabled: true, initial_interval: 1s, max_interval: 10s, max_elapsed_time: 30s} + otlp_http/loki: + endpoint: http://loki:3100/otlp + sending_queue: {enabled: true, num_consumers: 2, queue_size: 500} + retry_on_failure: {enabled: true, initial_interval: 1s, max_interval: 10s, max_elapsed_time: 30s} + prometheus: + endpoint: 0.0.0.0:8889 + resource_to_telemetry_conversion: {enabled: true} + metric_expiration: 20s + +service: + telemetry: + metrics: + level: normal + readers: + - pull: + exporter: + prometheus: {host: 0.0.0.0, port: 8888} + logs: + level: warn + pipelines: + traces: + receivers: [otlp] + processors: [memory_limiter, attributes/scrub, batch] + exporters: [otlp_grpc/tempo] + metrics: + receivers: [otlp] + processors: [memory_limiter, batch] + exporters: [prometheus] + logs: + receivers: [otlp] + processors: [memory_limiter, attributes/scrub, batch] + exporters: [otlp_http/loki] diff --git a/infra/prometheus/prometheus.yml b/infra/prometheus/prometheus.yml new file mode 100644 index 0000000..a030ea9 --- /dev/null +++ b/infra/prometheus/prometheus.yml @@ -0,0 +1,20 @@ +# Prometheus: хранилище метрик (retention 7 дней, volume promdata). Забирает метрики приложений через Collector +# (Prometheus-экспортёр :8889) и собственные метрики Collector (:8888): очереди экспортёров, отказы, drop из memory_limiter. +global: + scrape_interval: 5s + evaluation_interval: 5s + +rule_files: + - /etc/prometheus/rules/*.yml + +scrape_configs: + - job_name: otel-collector-app-metrics + honor_labels: true + static_configs: + - targets: ["otel-collector:8889"] + - job_name: otel-collector-internal + static_configs: + - targets: ["otel-collector:8888"] + - job_name: prometheus + static_configs: + - targets: ["localhost:9090"] diff --git a/infra/prometheus/rules/messenger.yml b/infra/prometheus/rules/messenger.yml new file mode 100644 index 0000000..c9263df --- /dev/null +++ b/infra/prometheus/rules/messenger.yml @@ -0,0 +1,77 @@ +# Правила записи (SLI) и алерты. Runbook для каждого алерта — docs/runbooks.md (ссылка в аннотации). +# SLI доступности API: доля бизнес-запросов (без /health) без ответа 5xx. 4xx — ошибка клиента, в SLI не входит. +# SLO: 99.5 % за скользящее окно 30 дней => бюджет ошибок 0.5 %. Для демонстрации окна короткие (локальный стенд). +groups: + - name: messenger-sli + interval: 5s + rules: + - record: sli:http_requests:rate1m + expr: sum(rate(http_server_request_duration_seconds_count{http_route!~"/health.*"}[1m])) + - record: sli:http_errors:rate1m + expr: sum(rate(http_server_request_duration_seconds_count{http_route!~"/health.*",http_response_status_code=~"5.."}[1m])) + - record: sli:http_error_ratio:1m + expr: (sli:http_errors:rate1m / sli:http_requests:rate1m) or vector(0) + - record: sli:http_error_ratio:5m + expr: | + (sum(rate(http_server_request_duration_seconds_count{http_route!~"/health.*",http_response_status_code=~"5.."}[5m])) + / sum(rate(http_server_request_duration_seconds_count{http_route!~"/health.*"}[5m]))) or vector(0) + - record: sli:http_latency_p95:5m + expr: histogram_quantile(0.95, sum by (le) (rate(http_server_request_duration_seconds_bucket{http_route!~"/health.*"}[5m]))) + - record: sli:http_latency_p95:1m + expr: histogram_quantile(0.95, sum by (le) (rate(http_server_request_duration_seconds_bucket{http_route!~"/health.*"}[1m]))) + - record: sli:upload_error_ratio:1m + expr: | + (sum(rate(http_server_request_duration_seconds_count{http_route="/api/v1/chats/{chat_id}/attachments",http_response_status_code=~"5.."}[1m])) + / sum(rate(http_server_request_duration_seconds_count{http_route="/api/v1/chats/{chat_id}/attachments"}[1m]))) or vector(0) + - record: sli:upload_requests:rate1m + expr: sum(rate(http_server_request_duration_seconds_count{http_route="/api/v1/chats/{chat_id}/attachments"}[1m])) + - record: sli:time_to_ready_p95:5m + expr: histogram_quantile(0.95, sum by (le) (rate(messenger_job_time_to_ready_seconds_bucket[5m]))) + - name: messenger-alerts + rules: + - alert: HighHttpErrorRate + expr: sli:http_error_ratio:1m > 0.05 and sli:http_requests:rate1m > 0.5 + for: 20s + labels: {severity: page} + annotations: + summary: "Доля 5xx бизнес-запросов API выше 5 %" + description: "Числитель — ответы 5xx, знаменатель — все запросы кроме /health. Значение: {{ $value | humanizePercentage }}." + runbook: "docs/runbooks.md#higherrorrate" + - alert: HighUploadErrorRate + expr: sli:upload_error_ratio:1m > 0.2 and sli:upload_requests:rate1m > 0.2 + for: 15s + labels: {severity: page} + annotations: + summary: "Более 20 % загрузок вложений завершаются 5xx" + description: "Маршрут загрузки критичен, но малообъёмен: общий SLI 5xx его деградацию не заметит, поэтому есть отдельный алерт. Значение: {{ $value | humanizePercentage }}." + runbook: "docs/runbooks.md#higherrorrate" + - alert: HighLatencyP95 + expr: sli:http_latency_p95:1m > 0.5 and sli:http_requests:rate1m > 0.5 + for: 20s + labels: {severity: ticket} + annotations: + summary: "p95 задержки бизнес-запросов выше 500 мс" + description: "p95 из суммарной гистограммы всех реплик: {{ $value | humanizeDuration }}. Различайте медленную БД (spans db.connection, db_client_connections_waiting) и медленный обработчик." + runbook: "docs/runbooks.md#highlatency" + - alert: QueueLagGrowing + expr: messenger_queue_oldest_job_age_seconds > 30 + for: 20s + labels: {severity: ticket} + annotations: + summary: "Самая старая задача в очереди ждёт дольше 30 с" + description: "Возраст старейшего задания: {{ $value }} с. Проверьте worker, брокер, S3." + runbook: "docs/runbooks.md#queuelag" + - alert: WorkerSilent + expr: absent(messenger_worker_capacity) + for: 30s + labels: {severity: ticket} + annotations: + summary: "Worker не присылает метрики" + runbook: "docs/runbooks.md#queuelag" + - alert: TelemetryExportFailing + expr: sum(rate(otelcol_exporter_send_failed_spans[1m])) + sum(rate(otelcol_exporter_send_failed_log_records[1m])) > 0 + for: 15s + labels: {severity: ticket} + annotations: + summary: "Collector не может отправить телеметрию в хранилище" + runbook: "docs/runbooks.md#telemetry" diff --git a/infra/tempo/tempo.yaml b/infra/tempo/tempo.yaml new file mode 100644 index 0000000..3cdefa3 --- /dev/null +++ b/infra/tempo/tempo.yaml @@ -0,0 +1,33 @@ +# Tempo: хранилище трасс (локальный диск, volume tempodata, retention 7 суток). Принимает OTLP/gRPC от Collector. +stream_over_http_enabled: true +server: + http_listen_port: 3200 + log_level: warn +distributor: + receivers: + otlp: + protocols: + grpc: + endpoint: 0.0.0.0:4317 +ingester: + max_block_duration: 1m +compactor: + compaction: + block_retention: 168h +storage: + trace: + backend: local + wal: + path: /var/tempo/wal + local: + path: /var/tempo/blocks +# Лимиты приёма: значения по умолчанию (10 000 «живых» трасс на тенанта) отбрасывали до 30 % спанов под нагрузкой +# (метрика tempo_discarded_spans_total{reason="live_traces_exceeded"}) — найдено экспериментом «цена наблюдаемости». +overrides: + defaults: + ingestion: + max_traces_per_user: 150000 + rate_limit_bytes: 50000000 + burst_size_bytes: 100000000 +usage_report: + reporting_enabled: false diff --git a/migrations/0001_init.sql b/migrations/0001_init.sql new file mode 100644 index 0000000..2effe2e --- /dev/null +++ b/migrations/0001_init.sql @@ -0,0 +1,52 @@ +-- 0001: пользователи, чаты, участники, сообщения, сессии. +-- Источник истины для всех данных — PostgreSQL. Каждая миграция выполняется в транзакции. +CREATE TABLE users ( + id uuid PRIMARY KEY, + username text NOT NULL, + display_name text NOT NULL, + password_hash text NOT NULL, + created_at timestamptz NOT NULL DEFAULT clock_timestamp(), + CONSTRAINT users_username_format CHECK (username ~ '^[a-z0-9_]{3,32}$'), + CONSTRAINT users_display_name_len CHECK (char_length(display_name) BETWEEN 1 AND 100) +); +-- Уникальность username: гонка двух регистраций решается ограничением БД, а не проверкой в приложении. +CREATE UNIQUE INDEX users_username_key ON users (username); + +CREATE TABLE chats ( + id uuid PRIMARY KEY, + title text NOT NULL, + created_at timestamptz NOT NULL DEFAULT clock_timestamp(), + CONSTRAINT chats_title_len CHECK (char_length(title) BETWEEN 1 AND 100) +); + +-- chat_created_at денормализован ради keyset-пагинации списка чатов пользователя без join+sort. +CREATE TABLE chat_members ( + chat_id uuid NOT NULL REFERENCES chats (id) ON DELETE CASCADE, + user_id uuid NOT NULL REFERENCES users (id), + chat_created_at timestamptz NOT NULL, + ord smallint NOT NULL, + PRIMARY KEY (chat_id, user_id) +); +CREATE INDEX chat_members_user_chats ON chat_members (user_id, chat_created_at, chat_id); + +CREATE TABLE messages ( + id uuid PRIMARY KEY, + chat_id uuid NOT NULL REFERENCES chats (id) ON DELETE CASCADE, + sender_id uuid NOT NULL REFERENCES users (id), + text text NOT NULL, + created_at timestamptz NOT NULL DEFAULT clock_timestamp(), + CONSTRAINT messages_text_len CHECK (char_length(text) <= 4000) +); +-- История чата: WHERE chat_id = ? AND (created_at, id) > (?, ?) ORDER BY created_at, id LIMIT n +-- обслуживается этим индексом без сортировки и без сканирования всей истории. +CREATE INDEX messages_chat_history ON messages (chat_id, created_at, id); + +-- Серверные сессии. В БД хранится только SHA-256 токена: утечка БД не раскрывает рабочие токены. +CREATE TABLE sessions ( + token_hash bytea PRIMARY KEY, + user_id uuid NOT NULL REFERENCES users (id), + created_at timestamptz NOT NULL DEFAULT now(), + expires_at timestamptz NOT NULL, + revoked_at timestamptz +); +CREATE INDEX sessions_expires_at ON sessions (expires_at); diff --git a/migrations/0002_idempotency.sql b/migrations/0002_idempotency.sql new file mode 100644 index 0000000..a18c45f --- /dev/null +++ b/migrations/0002_idempotency.sql @@ -0,0 +1,17 @@ +-- 0002: общая идемпотентность отправки сообщений (lab3). +-- Область уникальности: пользователь + чат + ключ (метод и путь фиксированы: POST /chats/{id}/messages). +-- Запись ключа и сообщения — одна транзакция: побочный эффект и результат фиксируются атомарно. +CREATE TABLE idempotency_keys ( + user_id uuid NOT NULL REFERENCES users (id), + chat_id uuid NOT NULL REFERENCES chats (id) ON DELETE CASCADE, + idem_key text NOT NULL, + request_hash bytea NOT NULL, + message_id uuid NOT NULL, + created_at timestamptz NOT NULL DEFAULT now(), + PRIMARY KEY (user_id, chat_id, idem_key), + CONSTRAINT idem_key_format CHECK (idem_key ~ '^[A-Za-z0-9._:-]{1,128}$'), + -- сообщение вставляется после ключа в той же транзакции -> проверка внешнего ключа откладывается до COMMIT + CONSTRAINT idem_message_fk FOREIGN KEY (message_id) REFERENCES messages (id) ON DELETE CASCADE + DEFERRABLE INITIALLY DEFERRED +); +CREATE INDEX idempotency_keys_created_at ON idempotency_keys (created_at); diff --git a/migrations/0003_send_message_function.sql b/migrations/0003_send_message_function.sql new file mode 100644 index 0000000..f9e8dd8 --- /dev/null +++ b/migrations/0003_send_message_function.sql @@ -0,0 +1,35 @@ +-- 0003: отправка сообщения одной серверной функцией (оптимизация по итогам трека 1: меньше обращений к БД на запрос). +-- Семантика идентична версии «несколько запросов в транзакции» (migrations 0002 + код приложения): +-- проверка членства -> просроченный ключ удаляется -> INSERT ключа (ON CONFLICT DO NOTHING) -> INSERT сообщения. +-- Функция выполняется атомарно (один вызов = одна транзакция); гонку одинаковых ключей по-прежнему решает уникальный индекс. +CREATE FUNCTION send_message(p_chat uuid, p_user uuid, p_key text, p_hash bytea, p_text text, p_ttl double precision) +RETURNS TABLE (outcome text, msg_id uuid, msg_chat uuid, msg_sender uuid, msg_text text, msg_created timestamptz, + request_hash bytea) +LANGUAGE plpgsql AS $$ +DECLARE + v_new uuid := gen_random_uuid(); + v_ins uuid; + v_created timestamptz; +BEGIN + IF NOT EXISTS (SELECT 1 FROM chat_members m WHERE m.chat_id = p_chat AND m.user_id = p_user) THEN + RETURN QUERY SELECT 'not_member'::text, NULL::uuid, NULL::uuid, NULL::uuid, NULL::text, NULL::timestamptz, NULL::bytea; + RETURN; + END IF; + DELETE FROM idempotency_keys k + WHERE k.user_id = p_user AND k.chat_id = p_chat AND k.idem_key = p_key + AND k.created_at < now() - make_interval(secs => p_ttl); + INSERT INTO idempotency_keys (user_id, chat_id, idem_key, request_hash, message_id) + VALUES (p_user, p_chat, p_key, p_hash, v_new) + ON CONFLICT DO NOTHING + RETURNING message_id INTO v_ins; + IF v_ins IS NOT NULL THEN + INSERT INTO messages (id, chat_id, sender_id, text) VALUES (v_new, p_chat, p_user, p_text) + RETURNING created_at INTO v_created; + RETURN QUERY SELECT 'created'::text, v_new, p_chat, p_user, p_text, v_created, p_hash; + ELSE + RETURN QUERY SELECT 'replay'::text, m.id, m.chat_id, m.sender_id, m.text, m.created_at, k.request_hash + FROM idempotency_keys k JOIN messages m ON m.id = k.message_id + WHERE k.user_id = p_user AND k.chat_id = p_chat AND k.idem_key = p_key; + END IF; +END; +$$; diff --git a/migrations/0004_attachments.sql b/migrations/0004_attachments.sql new file mode 100644 index 0000000..e1c15b9 --- /dev/null +++ b/migrations/0004_attachments.sql @@ -0,0 +1,90 @@ +-- 0004 (lab4): метаданные вложений в PostgreSQL, байты — в приватном S3-бакете. +-- Ключ объекта назначает сервер (att//original); filename — только отображаемое имя. +CREATE TABLE attachments ( + id uuid PRIMARY KEY, + chat_id uuid NOT NULL REFERENCES chats (id) ON DELETE CASCADE, + owner_id uuid NOT NULL REFERENCES users (id), + filename text NOT NULL, + content_type text NOT NULL, + size_bytes bigint NOT NULL, + sha256 text NOT NULL, + width integer NOT NULL, + height integer NOT NULL, + status text NOT NULL DEFAULT 'ready', + error_code text, + s3_key text NOT NULL, + created_at timestamptz NOT NULL DEFAULT clock_timestamp(), + updated_at timestamptz NOT NULL DEFAULT clock_timestamp(), + CONSTRAINT attachments_content_type CHECK (content_type IN ('image/png', 'image/jpeg')), + CONSTRAINT attachments_size CHECK (size_bytes BETWEEN 1 AND 10485760), + CONSTRAINT attachments_sha256 CHECK (sha256 ~ '^[a-f0-9]{64}$'), + CONSTRAINT attachments_status CHECK (status IN ('queued', 'processing', 'ready', 'failed')), + CONSTRAINT attachments_filename_len CHECK (char_length(filename) BETWEEN 1 AND 255) +); +CREATE UNIQUE INDEX attachments_s3_key_key ON attachments (s3_key); +CREATE INDEX attachments_chat ON attachments (chat_id); + +-- Связь сообщение <-> вложения (порядок сохраняется). Вложение может быть привязано к нескольким сообщениям чата. +CREATE TABLE message_attachments ( + message_id uuid NOT NULL REFERENCES messages (id) ON DELETE CASCADE, + attachment_id uuid NOT NULL REFERENCES attachments (id), + position smallint NOT NULL, + PRIMARY KEY (message_id, attachment_id) +); +CREATE INDEX message_attachments_attachment ON message_attachments (attachment_id); + +-- Отправка сообщения с вложениями: заменяет функцию из 0003 (добавлен параметр p_atts и результат msg_atts). +DROP FUNCTION send_message(uuid, uuid, text, bytea, text, double precision); +CREATE FUNCTION send_message(p_chat uuid, p_user uuid, p_key text, p_hash bytea, p_text text, p_ttl double precision, + p_atts uuid[]) +RETURNS TABLE (outcome text, msg_id uuid, msg_chat uuid, msg_sender uuid, msg_text text, msg_created timestamptz, + request_hash bytea, msg_atts uuid[]) +LANGUAGE plpgsql AS $$ +DECLARE + v_new uuid := gen_random_uuid(); + v_ins uuid; + v_created timestamptz; + v_found int; + v_failed int; +BEGIN + IF NOT EXISTS (SELECT 1 FROM chat_members m WHERE m.chat_id = p_chat AND m.user_id = p_user) THEN + RETURN QUERY SELECT 'not_member'::text, NULL::uuid, NULL::uuid, NULL::uuid, NULL::text, NULL::timestamptz, + NULL::bytea, NULL::uuid[]; + RETURN; + END IF; + IF cardinality(p_atts) > 0 THEN + SELECT count(*), count(*) FILTER (WHERE a.status = 'failed') INTO v_found, v_failed + FROM attachments a WHERE a.id = ANY (p_atts) AND a.chat_id = p_chat; + IF v_found <> cardinality(p_atts) THEN + RETURN QUERY SELECT 'attachment_not_found'::text, NULL::uuid, NULL::uuid, NULL::uuid, NULL::text, + NULL::timestamptz, NULL::bytea, NULL::uuid[]; + RETURN; + END IF; + IF v_failed > 0 THEN + RETURN QUERY SELECT 'attachment_failed'::text, NULL::uuid, NULL::uuid, NULL::uuid, NULL::text, + NULL::timestamptz, NULL::bytea, NULL::uuid[]; + RETURN; + END IF; + END IF; + DELETE FROM idempotency_keys k + WHERE k.user_id = p_user AND k.chat_id = p_chat AND k.idem_key = p_key + AND k.created_at < now() - make_interval(secs => p_ttl); + INSERT INTO idempotency_keys (user_id, chat_id, idem_key, request_hash, message_id) + VALUES (p_user, p_chat, p_key, p_hash, v_new) + ON CONFLICT DO NOTHING + RETURNING message_id INTO v_ins; + IF v_ins IS NOT NULL THEN + INSERT INTO messages (id, chat_id, sender_id, text) VALUES (v_new, p_chat, p_user, p_text) + RETURNING created_at INTO v_created; + INSERT INTO message_attachments (message_id, attachment_id, position) + SELECT v_new, a, (o - 1)::smallint FROM unnest(p_atts) WITH ORDINALITY AS t(a, o); + RETURN QUERY SELECT 'created'::text, v_new, p_chat, p_user, p_text, v_created, p_hash, p_atts; + ELSE + RETURN QUERY SELECT 'replay'::text, m.id, m.chat_id, m.sender_id, m.text, m.created_at, k.request_hash, + COALESCE((SELECT array_agg(ma.attachment_id ORDER BY ma.position) + FROM message_attachments ma WHERE ma.message_id = m.id), '{}'::uuid[]) + FROM idempotency_keys k JOIN messages m ON m.id = k.message_id + WHERE k.user_id = p_user AND k.chat_id = p_chat AND k.idem_key = p_key; + END IF; +END; +$$; diff --git a/migrations/0005_async_pipeline.sql b/migrations/0005_async_pipeline.sql new file mode 100644 index 0000000..51d3d48 --- /dev/null +++ b/migrations/0005_async_pipeline.sql @@ -0,0 +1,60 @@ +-- 0005 (lab5): асинхронная обработка вложений — состояния, варианты, outbox, журнал событий. +-- Расширение обратно совместимо с lab4: старые строки (ready) остаются валидными. +ALTER TABLE attachments + ADD COLUMN staging_key text, + ADD COLUMN pipeline_version integer NOT NULL DEFAULT 1, + ADD COLUMN attempt integer NOT NULL DEFAULT 0, + ADD COLUMN job_id uuid, + ADD COLUMN lease_owner text, + ADD COLUMN lease_expires_at timestamptz, + ADD COLUMN processing_started_at timestamptz, + ADD COLUMN accepted_at timestamptz NOT NULL DEFAULT clock_timestamp(), + ADD COLUMN ready_at timestamptz; + +-- очередь/backlog и поиск зависших processing без полного скана +CREATE INDEX attachments_active ON attachments (status, accepted_at) WHERE status IN ('queued', 'processing'); +CREATE INDEX attachments_lease ON attachments (lease_expires_at) WHERE status = 'processing'; + +-- Результаты обработки. Ключ эффекта (attachment_id, pipeline_version, name): повторная запись не создаёт второй набор вариантов. +CREATE TABLE attachment_variants ( + attachment_id uuid NOT NULL REFERENCES attachments (id) ON DELETE CASCADE, + pipeline_version integer NOT NULL, + name text NOT NULL, + content_type text NOT NULL, + size_bytes bigint NOT NULL, + width integer NOT NULL, + height integer NOT NULL, + sha256 text NOT NULL, + s3_key text NOT NULL, + created_at timestamptz NOT NULL DEFAULT now(), + PRIMARY KEY (attachment_id, pipeline_version, name), + CONSTRAINT variants_name CHECK (name IN ('thumbnail', 'crop', 'optimized')), + CONSTRAINT variants_content_type CHECK (content_type IN ('image/jpeg', 'image/png', 'image/webp')) +); + +-- Transactional outbox: намерение «обработать файл» фиксируется В ТОЙ ЖЕ транзакции, что и строка вложения. +-- Relay публикует строки в брокер (publisher confirm) и только затем ставит published_at. available_at — отложенная +-- публикация (backoff между попытками). Доставка at-least-once; обработка идемпотентна. +CREATE TABLE outbox ( + id bigserial PRIMARY KEY, + job_id uuid NOT NULL, + attachment_id uuid NOT NULL REFERENCES attachments (id) ON DELETE CASCADE, + pipeline_version integer NOT NULL DEFAULT 1, + attempt integer NOT NULL, + available_at timestamptz NOT NULL DEFAULT now(), + published_at timestamptz, + created_at timestamptz NOT NULL DEFAULT now() +); +CREATE INDEX outbox_pending ON outbox (available_at) WHERE published_at IS NULL; + +-- Журнал событий пайплайна (аудит операторского replay, причины отказов; без секретов). +CREATE TABLE job_events ( + id bigserial PRIMARY KEY, + attachment_id uuid NOT NULL, + job_id uuid, + event text NOT NULL, + attempt integer, + detail text, + created_at timestamptz NOT NULL DEFAULT now() +); +CREATE INDEX job_events_attachment ON job_events (attachment_id, id); diff --git a/migrations/0006_outbox_trace_context.sql b/migrations/0006_outbox_trace_context.sql new file mode 100644 index 0000000..133e991 --- /dev/null +++ b/migrations/0006_outbox_trace_context.sql @@ -0,0 +1,3 @@ +-- 0006 (lab6): контекст трассировки в outbox. traceparent/tracestate запроса upload сохраняются вместе с заданием, +-- relay передаёт их в брокер (поля jobs.schema.json), worker продолжает ту же трассу: API -> outbox -> broker -> worker. +ALTER TABLE outbox ADD COLUMN traceparent text, ADD COLUMN tracestate text; diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..a74a3f2 --- /dev/null +++ b/requirements.txt @@ -0,0 +1,43 @@ +aio-pika==10.1.0 +aiobotocore==3.9.2 +aiohappyeyeballs==2.7.1 +aiohttp==3.14.3 +aioitertools==0.13.0 +aiormq==7.2.1 +aiosignal==1.4.0 +argon2-cffi-bindings==26.1.0 +argon2-cffi==23.1.0 +asyncpg==0.30.0 +attrs==26.1.0 +botocore==1.43.106 +cffi==2.1.1 +click==8.5.0 +frozenlist==1.8.0 +googleapis-common-protos==1.75.5 +h11==0.16.0 +httptools==0.8.0 +idna==3.20 +jmespath==1.1.0 +multidict==6.9.1 +opentelemetry-api==1.45.0 +opentelemetry-exporter-http-transport==0.66b0 +opentelemetry-exporter-otlp-common==0.66b0 +opentelemetry-exporter-otlp-proto-common==1.45.0 +opentelemetry-exporter-otlp-proto-http==1.45.0 +opentelemetry-proto==1.45.0 +opentelemetry-sdk==1.45.0 +opentelemetry-semantic-conventions==0.66b0 +pamqp==4.0.1 +pillow==12.3.0 +propcache==0.5.4 +protobuf==7.36.2 +pycparser==3.0 +python-dateutil==2.9.0.post0 +redis==5.2.1 +six==1.17.0 +typing_extensions==4.16.0 +urllib3==2.8.0 +uvicorn==0.34.0 +uvloop==0.21.0; sys_platform != "win32" +wrapt==2.5.0 +yarl==1.25.1 diff --git a/research/failover_sequence.py b/research/failover_sequence.py new file mode 100644 index 0000000..dbf56a1 --- /dev/null +++ b/research/failover_sequence.py @@ -0,0 +1,113 @@ +#!/usr/bin/env python3 +"""Уровень 4: последовательная остановка каждой API-реплики под нагрузкой (с восстановлением предыдущей). + +Сценарий (стенд `docker compose up -d` с 2 репликами; нагрузка идёт через LB непрерывно ~70 с): + t=10 остановить реплику A (docker stop --time 0 = мгновенный отказ процесса) + t=25 восстановить (scripts/restore-replicas.sh) + t=40 остановить реплику B + t=55 восстановить +Для каждого отказа считаем: RPS до/во время/после, число ошибочных попыток, время до прекращения ошибок +(= обнаружение отказа балансировщиком), сохранность подтверждённых сообщений и отсутствие дублей. + + python research/failover_sequence.py --out evidence +""" +import argparse +import asyncio +import json +import os +import subprocess +import sys +import threading +import time + +sys.path.insert(0, os.path.dirname(__file__)) +import loadgen # noqa: E402 + +ROOT = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..") +BASE = "http://127.0.0.1:8080" + + +def sh(*args): + return subprocess.run(args, cwd=ROOT, capture_output=True, text=True).stdout.strip() + + +def api_ids(): + return sh("docker", "ps", "-q", "--filter", "label=com.docker.compose.project=mtusi-lab6", + "--filter", "label=com.docker.compose.service=api").split() + + +def scenario(rec, plan): + """Выполняется в отдельном потоке: действия по расписанию относительно rec.t0.""" + for at, action in plan: + time.sleep(max(0, rec.t0 + at - time.time())) + t = time.time() - rec.t0 + if action == "stop": + target = api_ids()[0] + subprocess.run(["docker", "stop", "--time", "0", target], capture_output=True) + rec.marks.append({"t": round(t, 2), "action": "stop", "container": target}) + else: + subprocess.run(["sh", "scripts/restore-replicas.sh"], cwd=ROOT, capture_output=True) + rec.marks.append({"t": round(t, 2), "action": "restore"}) + + +async def main(args): + stand = loadgen.Stand(BASE) + await stand.setup() + rec = loadgen.Recorder() + rec.marks = [] + plan = [(10, "stop"), (25, "restore"), (40, "stop"), (55, "restore")] + threading.Thread(target=scenario, args=(rec, plan), daemon=True).start() + await loadgen.run_load(stand, rec, args.seconds, args.concurrency) + await asyncio.sleep(2) + check = await loadgen.verify(stand, rec) + stops = [m for m in rec.marks if m["action"] == "stop"] + restores = [m for m in rec.marks if m["action"] == "restore"] + windows = [] + for i, stop in enumerate(stops): + t0 = stop["t"] + errs = [e for e in rec.events if e[1] == "POST" and e[2] != 201 and t0 - 0.2 <= e[0] <= t0 + 10] + last_err = max((e[0] for e in errs), default=t0) + restore_t = restores[i]["t"] if i < len(restores) else t0 + 15 + windows.append({"stopped_container": stop["container"], "stop_at_s": t0, + "rps_before": loadgen.summarize(rec, t0 - 8, t0 - 0.5).get("ok_rps"), + "rps_one_replica": loadgen.summarize(rec, t0 + 5, restore_t - 1).get("ok_rps"), + "rps_after_restore": loadgen.summarize(rec, restore_t + 8, restore_t + 14).get("ok_rps"), + "failed_attempts_within_10s": len(errs), + "error_statuses": sorted({str(e[2]) for e in errs}), + "seconds_until_errors_stop": round(last_err - t0, 2) if errs else 0.0, + "p95_ms_one_replica": loadgen.summarize(rec, t0 + 5, restore_t - 1).get("p95_ms")}) + series = loadgen.per_second(rec) + report = {"date": time.strftime("%Y-%m-%d %H:%M:%S"), "args": vars(args), "marks": rec.marks, "windows": windows, + "total": loadgen.summarize(rec), "verification": check, + "invariants_ok": check["confirmed_missing_in_history"] == 0 and check["duplicate_texts_in_history"] == 0, + "timeline": [{"t": t, "ok": b["ok"], "err": b["err"], "p95_ms": loadgen.pct(b["lat"], .95), "instances": len(b["instances"])} + for t, b in sorted(series.items())]} + with open(os.path.join(args.out, "failover_sequence.json"), "w", encoding="utf-8") as fh: + json.dump(report, fh, ensure_ascii=False, indent=2) + plot(report, os.path.join(args.out, "failover_sequence.png")) + print(json.dumps({k: v for k, v in report.items() if k != "timeline"}, ensure_ascii=False, indent=2)) + + +def plot(report, path): + import matplotlib + matplotlib.use("Agg") + import matplotlib.pyplot as plt + tl = report["timeline"] + t = [x["t"] for x in tl] + fig, ax = plt.subplots(3, 1, figsize=(11, 8.5), sharex=True) + ax[0].plot(t, [x["ok"] for x in tl], color="#2e7d32"); ax[0].set_ylabel("успешных POST/с"); ax[0].set_title("Пропускная способность") + ax[1].bar(t, [x["err"] for x in tl], color="#c62828"); ax[1].set_ylabel("ошибочных попыток/с"); ax[1].set_title("Ошибки (до повтора с тем же ключом)") + ax[2].plot(t, [x["p95_ms"] or 0 for x in tl], color="#1565c0"); ax[2].set_ylabel("p95, мс"); ax[2].set_xlabel("время, с"); ax[2].set_title("Латентность успешных POST") + for a in ax: + for m in report["marks"]: + a.axvline(m["t"], color="red" if m["action"] == "stop" else "green", ls="--", lw=1) + ax[0].text(0.01, 0.05, "красная линия — остановка реплики, зелёная — восстановление", transform=ax[0].transAxes, fontsize=9) + fig.tight_layout(); fig.savefig(path, dpi=110) + + +if __name__ == "__main__": + ap = argparse.ArgumentParser() + ap.add_argument("--out", default="evidence") + ap.add_argument("--seconds", type=int, default=70) + ap.add_argument("--concurrency", type=int, default=16) + asyncio.run(main(ap.parse_args())) diff --git a/research/incidents.py b/research/incidents.py new file mode 100644 index 0000000..97b0b4a --- /dev/null +++ b/research/incidents.py @@ -0,0 +1,258 @@ +#!/usr/bin/env python3 +"""Уровень 4: контролируемые инциденты и проверка алертов firing -> resolved. + +Фоном идёт нагрузка (сообщения + загрузки). Инциденты и ожидаемые алерты: + 1. worker_down — остановка worker: растёт возраст старейшей задачи -> QueueLagGrowing; после запуска — resolved. + 2. slow_db — триггер в БД добавляет pg_sleep(0.8) на вставку сообщения: растёт p95 -> HighLatencyP95; + причина отличается от медленного обработчика по spans db.connection и метрике ожидания пула. + 3. s3_down — остановка S3: загрузки дают 503 -> HighUploadErrorRate (маршрут критичен, но малообъёмен). + 4. telemetry_backend — остановка Tempo и Loki: API продолжает отвечать, Collector ограничивает очередь/RAM -> TelemetryExportFailing. +Для каждого фиксируем времена перехода алертов (по Prometheus API), ключевые метрики и «улики» из Tempo/Loki. + python research/incidents.py --out evidence +""" +import argparse +import asyncio +import base64 +import json +import os +import subprocess +import sys +import threading +import time +import urllib.parse +import uuid + +import aiohttp + +sys.path.insert(0, os.path.dirname(__file__)) +ROOT = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..") +BASE = "http://127.0.0.1:8080" + + +def sh(*args, stdin=None): + return subprocess.run(args, cwd=ROOT, capture_output=True, text=True, encoding="utf-8", input=stdin).stdout.strip() + + +def dc(*args): + return sh("docker", "compose", "--env-file", ".env", *args) + + +def prom_get(path): + return json.loads(dc("exec", "-T", "prometheus", "wget", "-q", "-O", "-", "http://127.0.0.1:9090" + path) or "{}") + + +def prom_value(query): + r = prom_get("/api/v1/query?query=" + urllib.parse.quote(query)) + res = r.get("data", {}).get("result", []) + return float(res[0]["value"][1]) if res else None + + +def alerts(): + r = prom_get("/api/v1/alerts") + return {a["labels"]["alertname"]: a["state"] for a in r.get("data", {}).get("alerts", [])} + + +def net_get(url, accept=None): + cmd = ["exec", "-T", "prometheus", "wget", "-q", "-O", "-"] + (["--header", "Accept: " + accept] if accept else []) + [url] + return dc(*cmd) + + +class Recorder(threading.Thread): + def __init__(self): + super().__init__(daemon=True) + self.t0, self.rows, self.stop = time.time(), [], threading.Event() + + def run(self): + while not self.stop.is_set(): + t = time.time() - self.t0 + row = {"t": round(t, 1), "alerts": alerts(), + "queue_oldest_age_s": prom_value("max(messenger_queue_oldest_job_age_seconds)"), + "error_ratio_1m": prom_value("sli:http_error_ratio:1m"), + "p95_s": prom_value("sli:http_latency_p95:1m"), + "db_waiting": prom_value("sum(db_client_connections_waiting)"), + "db_used": prom_value('sum(db_client_connections_usage{state="used"})'), + "rps": prom_value("sli:http_requests:rate1m")} + self.rows.append(row) + self.stop.wait(3) + + +async def register(s): + name = "inc_%s" % uuid.uuid4().hex[:12] + pw = "incident-test-pw-" + uuid.uuid4().hex[:6] + async with s.post(BASE + "/api/v1/users", json={"username": name, "display_name": "i", "password": pw}) as r: + user = await r.json() + cred = base64.b64encode(("%s:%s" % (name, pw)).encode()).decode() + async with s.post(BASE + "/api/v1/auth/sessions", headers={"Authorization": "Basic " + cred}) as r: + token = (await r.json())["token"] + async with s.post(BASE + "/api/v1/chats", json={"title": "inc", "member_ids": [user["id"]]}, headers={"Authorization": "Bearer " + token}) as r: + chat = await r.json() + return token, chat["id"] + + +async def traffic(stop, png, counters): + async with aiohttp.ClientSession(timeout=aiohttp.ClientTimeout(total=15), connector=aiohttp.TCPConnector(limit=40)) as s: + token, chat = await register(s) + hdr = {"Authorization": "Bearer " + token} + + async def msgs(): + while not stop.is_set(): + try: + async with s.post("%s/api/v1/chats/%s/messages" % (BASE, chat), json={"text": "inc-" + uuid.uuid4().hex[:8]}, + headers=dict(hdr, **{"Idempotency-Key": uuid.uuid4().hex})) as r: + await r.read() + counters["msg_%d" % (r.status // 100)] = counters.get("msg_%d" % (r.status // 100), 0) + 1 + except Exception: + counters["msg_err"] = counters.get("msg_err", 0) + 1 + await asyncio.sleep(0.1) + + async def uploads(): + while not stop.is_set(): + try: + async with s.post("%s/api/v1/chats/%s/attachments?filename=i.png" % (BASE, chat), data=png, + headers=dict(hdr, **{"Content-Type": "image/png"})) as r: + await r.read() + counters["up_%d" % (r.status // 100)] = counters.get("up_%d" % (r.status // 100), 0) + 1 + except Exception: + counters["up_err"] = counters.get("up_err", 0) + 1 + await asyncio.sleep(0.3) + await asyncio.gather(*([msgs() for _ in range(4)] + [uploads() for _ in range(10)])) + + +def tempo_search(traceql, limit=20): + now = int(time.time()) + url = "http://tempo:3200/api/search?q=%s&limit=%d&start=%d&end=%d" % (urllib.parse.quote(traceql), limit, now - 900, now + 5) + raw = net_get(url) + try: + return json.loads(raw).get("traces", []) + except ValueError: + return [] + + +def loki_count(query): + now = int(time.time() * 1e9) + url = "http://loki:3100/loki/api/v1/query_range?limit=500&start=%d&end=%d&query=%s" % (now - 900 * 10 ** 9, now, urllib.parse.quote(query)) + try: + data = json.loads(net_get(url)) + return sum(len(s["values"]) for s in data["data"]["result"]) + except ValueError: + return None + + +def wait_until(pred, seconds): + deadline = time.time() + seconds + while time.time() < deadline: + if pred(): + return True + time.sleep(2) + return False + + +def run_incident(name, expected_alert, start, stop, hold, evidence, rec): + t_start = time.time() - rec.t0 + start() + fired = wait_until(lambda: alerts().get(expected_alert) == "firing", hold) + t_fired = time.time() - rec.t0 if fired else None + ev = evidence() if evidence else {} + ev["alerts_in_state_firing"] = sorted(k for k, v in alerts().items() if v == "firing") + stop() + t_recovery = time.time() - rec.t0 + resolved = wait_until(lambda: expected_alert not in alerts(), 120) + t_resolved = time.time() - rec.t0 if resolved else None + result = {"incident": name, "alert": expected_alert, "injected_at_s": round(t_start, 1), + "firing_at_s": round(t_fired, 1) if t_fired else None, "detection_seconds": round(t_fired - t_start, 1) if t_fired else None, + "recovered_cmd_at_s": round(t_recovery, 1), "resolved_at_s": round(t_resolved, 1) if t_resolved else None, + "fired": fired, "resolved": resolved, "evidence": ev} + if t_fired and t_resolved: + result["time_to_resolve_after_recovery_s"] = round(t_resolved - t_recovery, 1) + time.sleep(6) + return result + + +def orchestrate(rec, results, args): + time.sleep(25) # прогрев: метрики и алерты стабилизируются + # 1. worker down + results.append(run_incident( + "worker_down", "QueueLagGrowing", lambda: dc("stop", "worker"), lambda: dc("start", "worker"), 150, + lambda: {"queue_oldest_age_s": prom_value("max(messenger_queue_oldest_job_age_seconds)"), "worker_capacity_series_present": prom_value("sum(messenger_worker_capacity)") is not None, + "jobs_ready_rate_1m": prom_value('sum(rate(messenger_jobs_processed_total{outcome="ready"}[1m]))'), + "diagnosis": "возраст старейшей задачи растёт при нулевой скорости обработки jobs (worker не отдаёт метрики) -> остановлен worker, а не медленная БД"}, + rec)) + # 2. slow DB + trigger_sql = ("CREATE OR REPLACE FUNCTION slow_insert() RETURNS trigger LANGUAGE plpgsql AS $$ BEGIN PERFORM pg_sleep(0.8); RETURN NEW; END $$;" + "CREATE TRIGGER slow_messages BEFORE INSERT ON messages FOR EACH ROW EXECUTE FUNCTION slow_insert();") + pg = ["exec", "-T", "postgres", "psql", "-U", "messenger", "-d", "messenger", "-v", "ON_ERROR_STOP=1", "-c"] + results.append(run_incident( + "slow_db", "HighLatencyP95", lambda: dc(*pg, trigger_sql), lambda: dc(*pg, "DROP TRIGGER IF EXISTS slow_messages ON messages; DROP FUNCTION IF EXISTS slow_insert();"), 120, + lambda: {"p95_s": prom_value("sli:http_latency_p95:1m"), "db_pool_waiting": prom_value("sum(db_client_connections_waiting)"), + "slow_traces_with_long_db_span": len(tempo_search('{ resource.service.name = "messenger-api" && name = "db.connection" && duration > 300ms }')), + "slow_http_post_messages_traces": len(tempo_search('{ name =~ "HTTP POST.*messages" && duration > 300ms }')), + "diagnosis": "p95 высокий, а время в спанах db.connection сопоставимо с длительностью запроса и растёт ожидание пула -> медленная БД, а не обработчик"}, + rec)) + # 3. S3 down + results.append(run_incident( + "s3_down", "HighUploadErrorRate", lambda: dc("stop", "seaweedfs"), lambda: dc("start", "seaweedfs"), 120, + lambda: {"upload_error_ratio_1m": prom_value("sli:upload_error_ratio:1m"), "global_error_ratio_1m": prom_value("sli:http_error_ratio:1m"), "error_traces": len(tempo_search('{ status = error && resource.service.name = "messenger-api" }')), + "s3_put_failed_log_lines": loki_count('{service_name="messenger-api"} |= "s3_put_failed"'), + "diagnosis": "рост доли 5xx на маршруте загрузки при нормальных остальных; спаны s3.put_object с ошибкой и логи s3_put_failed -> недоступен S3"}, + rec)) + # 4. telemetry backend down + results.append(run_incident( + "telemetry_backend", "TelemetryExportFailing", lambda: dc("stop", "tempo", "loki"), lambda: dc("start", "tempo", "loki"), 120, + lambda: {"api_error_ratio_1m": prom_value("sli:http_error_ratio:1m"), "api_rps": prom_value("sli:http_requests:rate1m"), + "collector_queue_size": prom_value("max(otelcol_exporter_queue_size)"), "collector_send_failed_spans_rate": prom_value("sum(rate(otelcol_exporter_send_failed_spans[1m]))"), + "collector_rss_mib": round((prom_value("max(otelcol_process_memory_rss)") or 0) / 1048576, 1), + "diagnosis": "ошибки экспорта растут, очередь ограничена; бизнес-метрики API без роста ошибок -> сбой хранилища телеметрии, не приложения"}, + rec)) + + +async def main(args): + from PIL import Image + import io + buf = io.BytesIO() + Image.new("RGB", (320, 200), (30, 90, 160)).save(buf, "PNG") + stop_flag, counters, results = asyncio.Event(), {}, [] + rec = Recorder() + rec.start() + t = threading.Thread(target=orchestrate, args=(rec, results, args), daemon=True) + t.start() + traffic_task = asyncio.create_task(traffic(stop_flag, buf.getvalue(), counters)) + while t.is_alive(): + await asyncio.sleep(1) + stop_flag.set() + await asyncio.sleep(1) + traffic_task.cancel() + rec.stop.set() + collector_rss = None + report = {"date": time.strftime("%Y-%m-%d %H:%M:%S"), "traffic_counters": counters, "incidents": results, "timeline": rec.rows} + with open(os.path.join(args.out, "incidents.json"), "w", encoding="utf-8") as fh: + json.dump(report, fh, ensure_ascii=False, indent=2) + plot(report, os.path.join(args.out, "incidents.png")) + print(json.dumps({"incidents": results, "traffic": counters}, ensure_ascii=False, indent=2)) + + +def plot(report, path): + import matplotlib + matplotlib.use("Agg") + import matplotlib.pyplot as plt + rows = report["timeline"] + t = [r["t"] for r in rows] + fig, ax = plt.subplots(4, 1, figsize=(12, 11), sharex=True) + ax[0].plot(t, [r["queue_oldest_age_s"] or 0 for r in rows], color="#6a1b9a"); ax[0].axhline(30, color="red", ls="--"); ax[0].set_ylabel("с"); ax[0].set_title("Возраст старейшей задачи (порог алерта 30 с)") + ax[1].plot(t, [r["p95_s"] or 0 for r in rows], color="#1565c0"); ax[1].axhline(0.5, color="red", ls="--"); ax[1].set_ylabel("с"); ax[1].set_title("p95 задержки API (порог 0.5 с)") + ax[2].plot(t, [(r["error_ratio_1m"] or 0) * 100 for r in rows], color="#c62828"); ax[2].axhline(5, color="red", ls="--"); ax[2].set_ylabel("%"); ax[2].set_title("Доля 5xx (порог 5 %)") + names = ["QueueLagGrowing", "HighLatencyP95", "HighHttpErrorRate", "TelemetryExportFailing"] + for i, n in enumerate(names): + ax[3].fill_between(t, i, [i + 0.8 if r["alerts"].get(n) == "firing" else i for r in rows], step="post", alpha=0.7, label=n) + ax[3].set_yticks([i + 0.4 for i in range(4)]); ax[3].set_yticklabels(names); ax[3].set_title("Алерты в состоянии firing"); ax[3].set_xlabel("время, с") + for inc in report["incidents"]: + for a in ax: + a.axvline(inc["injected_at_s"], color="gray", ls=":") + if inc["resolved_at_s"]: + a.axvline(inc["resolved_at_s"], color="green", ls=":") + fig.tight_layout(); fig.savefig(path, dpi=105) + + +if __name__ == "__main__": + ap = argparse.ArgumentParser() + ap.add_argument("--out", default="evidence") + asyncio.run(main(ap.parse_args())) diff --git a/research/loadgen.py b/research/loadgen.py new file mode 100644 index 0000000..3da976e --- /dev/null +++ b/research/loadgen.py @@ -0,0 +1,172 @@ +"""Генератор нагрузки для экспериментов lab6+ (asyncio + aiohttp, closed-loop). + +Каждый воркер выполняет цикл: POST сообщения с новым Idempotency-Key (90 %) или GET первой страницы истории (10 %). +При ошибке соединения/5xx POST повторяется с ТЕМ ЖЕ ключом (до RETRIES раз) — именно так клиент безопасно +повторяет неподтверждённую запись. Результат: по секундам успехи/ошибки/латентности, список подтверждённых +сообщений (для сверки с историей), число повторов. +""" +import asyncio +import base64 +import random +import time +import uuid + +import aiohttp + +RETRIES = 3 + + +class Stand: + """Набор пользователей/чатов, созданных через API (через LB), для одного эксперимента.""" + + def __init__(self, base, users=20, chats=20): + self.base, self.n_users, self.n_chats = base, users, chats + self.users, self.chats = [], [] + + async def setup(self): + timeout = aiohttp.ClientTimeout(total=30) + async with aiohttp.ClientSession(timeout=timeout) as s: + for i in range(self.n_users): + name = "ld_%s" % uuid.uuid4().hex[:14] + pw = "load-test-password-" + uuid.uuid4().hex[:8] + async with s.post(self.base + "/api/v1/users", json={"username": name, "display_name": "load %d" % i, "password": pw}) as r: + user = await r.json() + assert r.status == 201, user + cred = base64.b64encode(("%s:%s" % (name, pw)).encode()).decode() + async with s.post(self.base + "/api/v1/auth/sessions", headers={"Authorization": "Basic " + cred}) as r: + sess = await r.json() + assert r.status == 201, sess + self.users.append({"id": user["id"], "token": sess["token"]}) + for i in range(self.n_chats): + members = random.sample(self.users, 3) + owner = members[0] + async with s.post(self.base + "/api/v1/chats", json={"title": "load %d" % i, "member_ids": [m["id"] for m in members]}, + headers={"Authorization": "Bearer " + owner["token"]}) as r: + chat = await r.json() + assert r.status == 201, chat + self.chats.append({"id": chat["id"], "members": members}) + + +class Recorder: + def __init__(self): + self.t0 = time.time() + self.events = [] # (t, kind, status, latency_ms, instance) + self.confirmed = [] # (chat_id, message_id, text) + self.retries = 0 + self.final_failures = 0 + self.unconfirmed = [] # (chat_id, key, text) — финально не подтверждены (могли записаться!) + + +async def worker(stand, rec, deadline_fn, read_ratio=0.1, text_size=0, think=0.0): + connector = aiohttp.TCPConnector(limit=2) + timeout = aiohttp.ClientTimeout(total=5) + async with aiohttp.ClientSession(connector=connector, timeout=timeout) as s: + n = 0 + while not deadline_fn(): + chat = random.choice(stand.chats) + user = random.choice(chat["members"]) + hdr = {"Authorization": "Bearer " + user["token"]} + if random.random() < read_ratio: + t = time.perf_counter() + try: + async with s.get("%s/api/v1/chats/%s/messages?limit=20" % (stand.base, chat["id"]), headers=hdr) as r: + await r.read() + rec.events.append((time.time() - rec.t0, "GET", r.status, (time.perf_counter() - t) * 1000, r.headers.get("X-Instance-Id"))) + except Exception as exc: + rec.events.append((time.time() - rec.t0, "GET", type(exc).__name__, (time.perf_counter() - t) * 1000, None)) + continue + key = uuid.uuid4().hex + text = "m-%s-%d" % (key[:8], n) + "я" * text_size + n += 1 + for attempt in range(RETRIES + 1): + t = time.perf_counter() + try: + async with s.post("%s/api/v1/chats/%s/messages" % (stand.base, chat["id"]), json={"text": text}, + headers=dict(hdr, **{"Idempotency-Key": key})) as r: + body = await r.json(content_type=None) + status, inst = r.status, r.headers.get("X-Instance-Id") + except Exception as exc: + status, inst, body = type(exc).__name__, None, None + rec.events.append((time.time() - rec.t0, "POST", status, (time.perf_counter() - t) * 1000, inst)) + if status == 201: + rec.confirmed.append((chat["id"], body["id"], text)) + break + if attempt < RETRIES and (not isinstance(status, int) or status >= 500 or status == 429): + rec.retries += 1 + await asyncio.sleep(0.05 * (attempt + 1)) + continue + rec.final_failures += 1 + rec.unconfirmed.append((chat["id"], key, text)) + break + if think: + await asyncio.sleep(think) + + +async def run_load(stand, rec, seconds, concurrency, **kw): + end = time.time() + seconds + await asyncio.gather(*(worker(stand, rec, lambda: time.time() > end, **kw) for _ in range(concurrency))) + + +async def verify(stand, rec): + """Сверка: каждое подтверждённое сообщение читается, дублей по тексту нет, неподтверждённые встречаются не более 1 раза.""" + timeout = aiohttp.ClientTimeout(total=30) + stored = {} + async with aiohttp.ClientSession(timeout=timeout) as s: + for chat in stand.chats: + hdr = {"Authorization": "Bearer " + chat["members"][0]["token"]} + cursor, items = None, [] + while True: + url = "%s/api/v1/chats/%s/messages?limit=100%s" % (stand.base, chat["id"], "&cursor=" + cursor if cursor else "") + async with s.get(url, headers=hdr) as r: + page = await r.json() + assert r.status == 200, page + items += page["items"] + cursor = page["next_cursor"] + if not cursor: + break + stored[chat["id"]] = items + ids = {m["id"] for items in stored.values() for m in items} + texts = [m["text"] for items in stored.values() for m in items] + confirmed_missing = [c for c in rec.confirmed if c[1] not in ids] + dup_texts = len(texts) - len(set(texts)) + unconfirmed_present = sum(1 for c in rec.unconfirmed if c[2] in set(texts)) + return {"stored_messages": len(ids), "confirmed_201": len(rec.confirmed), "confirmed_missing_in_history": len(confirmed_missing), + "duplicate_texts_in_history": dup_texts, "unconfirmed_requests": len(rec.unconfirmed), + "unconfirmed_that_were_written": unconfirmed_present, "retries": rec.retries, "final_failures": rec.final_failures} + + +def per_second(rec, kind="POST"): + buckets = {} + for t, k, status, lat, inst in rec.events: + if k != kind: + continue + b = buckets.setdefault(int(t), {"ok": 0, "err": 0, "lat": [], "instances": set()}) + if status == 201 or (kind == "GET" and status == 200): + b["ok"] += 1 + b["lat"].append(lat) + if inst: + b["instances"].add(inst) + else: + b["err"] += 1 + return buckets + + +def pct(values, p): + if not values: + return None + values = sorted(values) + return round(values[max(0, int(len(values) * p + 0.9999) - 1)], 2) + + +def summarize(rec, t_from=None, t_to=None, kind="POST"): + rows = [e for e in rec.events if e[1] == kind and (t_from is None or e[0] >= t_from) and (t_to is None or e[0] < t_to)] + if not rows: + return {} + dur = (t_to if t_to is not None else max(e[0] for e in rows)) - (t_from if t_from is not None else min(e[0] for e in rows)) + ok = [e[3] for e in rows if e[2] == 201 or (kind == "GET" and e[2] == 200)] + errs = {} + for e in rows: + if not (e[2] == 201 or (kind == "GET" and e[2] == 200)): + errs[str(e[2])] = errs.get(str(e[2]), 0) + 1 + return {"requests": len(rows), "ok": len(ok), "errors": errs, "seconds": round(dur, 2), "ok_rps": round(len(ok) / dur, 1) if dur > 0 else None, + "error_ratio": round((len(rows) - len(ok)) / len(rows), 4), "p50_ms": pct(ok, .5), "p95_ms": pct(ok, .95), "p99_ms": pct(ok, .99)} diff --git a/research/obs_cost.py b/research/obs_cost.py new file mode 100644 index 0000000..4d76eb7 --- /dev/null +++ b/research/obs_cost.py @@ -0,0 +1,217 @@ +#!/usr/bin/env python3 +"""Трек 1 (цена наблюдаемости), lab6. + +Профили при ОДИНАКОВОЙ нагрузке (8 процессов-клиентов, 64 одновременных, 90 % POST сообщений / 10 % GET, 30 с после прогрева): + off — OTEL_ENABLED=0 (SDK не создаётся, экспорта нет) + on100 — телеметрия включена, head-sampling 100 % трасс + head10 — head-sampling 10 % (ParentBased + TraceIdRatio в SDK) + tail — SDK отправляет 100 %, Collector оставляет errors + медленные (>500 мс) + 10 % остальных (tail_sampling) +Во время замера внедряются отказы: 2 % запросов дают 500 и 2 % задерживаются на 0.6 с (одинаково для всех профилей) — это «редкие +ошибки и медленные запросы», судьбу которых в Tempo мы сравниваем. +Метрики: RPS, p50/p95/p99, CPU/RSS API и Collector (docker stats), объём телеметрии (принятые Collector спаны/логи/точки метрик), +потери (отказы приёма Collector), размер хранилищ Tempo/Loki, доля сохранённых ошибочных и медленных трасс. + python research/obs_cost.py --out evidence +""" +import argparse +import asyncio +import json +import multiprocessing as mp +import os +import statistics +import subprocess +import sys +import threading +import time +import urllib.parse + +sys.path.insert(0, os.path.dirname(__file__)) +import loadgen # noqa: E402 + +ROOT = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..") +BASE = "http://127.0.0.1:8080" +PROFILES = { + "off": {"OTEL_ENABLED": "0", "OTEL_TRACES_SAMPLER_ARG": "1.0", "COLLECTOR_CONFIG": "/etc/otelcol/collector.yaml"}, + "on100": {"OTEL_ENABLED": "1", "OTEL_TRACES_SAMPLER_ARG": "1.0", "COLLECTOR_CONFIG": "/etc/otelcol/collector.yaml"}, + "head10": {"OTEL_ENABLED": "1", "OTEL_TRACES_SAMPLER_ARG": "0.1", "COLLECTOR_CONFIG": "/etc/otelcol/collector.yaml"}, + "tail": {"OTEL_ENABLED": "1", "OTEL_TRACES_SAMPLER_ARG": "1.0", "COLLECTOR_CONFIG": "/etc/otelcol/collector-tail.yaml"}, + # то же, что on100, но большая очередь/пакет экспорта SDK: проверка гипотезы «часть спанов теряется очередью SDK» + "on100_bigq": {"OTEL_ENABLED": "1", "OTEL_TRACES_SAMPLER_ARG": "1.0", "COLLECTOR_CONFIG": "/etc/otelcol/collector.yaml", + "OTEL_QUEUE_SIZE": "65536", "OTEL_BATCH_SIZE": "2048"}, +} + + +def sh(*args, env=None): + return subprocess.run(args, cwd=ROOT, capture_output=True, text=True, encoding="utf-8", env=dict(os.environ, **(env or {}))).stdout.strip() + + +def dc(*args, env=None): + return sh("docker", "compose", "--env-file", ".env", *args, env=env) + + +def net_get(url): + return dc("exec", "-T", "prometheus", "wget", "-q", "-O", "-", url) + + +def prom_value(query): + try: + r = json.loads(net_get("http://127.0.0.1:9090/api/v1/query?query=" + urllib.parse.quote(query)))["data"]["result"] + return float(r[0]["value"][1]) if r else None + except (ValueError, KeyError): + return None + + +def apply_profile(profile, faults=True): + env = dict(PROFILES[profile], API_FAULT_INJECTION="http500:0.02,slow:0.02:0.6" if faults else "") + dc("up", "-d", "--no-deps", "--force-recreate", "otel-collector", env=env) + dc("up", "-d", "--no-deps", "--force-recreate", "api", "worker", env=env) + deadline = time.time() + 90 + while time.time() < deadline: + ids = dc("ps", "-q", "api").split() + if len(ids) == 2 and all(sh("docker", "inspect", "-f", "{{.State.Health.Status}}", i) == "healthy" for i in ids): + break + time.sleep(1) + time.sleep(8) + + +def child(args): + stand_data, seconds, concurrency, seed, t0 = args + import random + random.seed(seed) + stand = loadgen.Stand(BASE) + stand.users, stand.chats = stand_data["users"], stand_data["chats"] + rec = loadgen.Recorder() + rec.t0 = t0 + + async def go(): + await loadgen.run_load(stand, rec, seconds, concurrency) + asyncio.run(go()) + return rec.events + + +class Sampler(threading.Thread): + def __init__(self): + super().__init__(daemon=True) + self.rows, self.stop = [], threading.Event() + + def run(self): + while not self.stop.is_set(): + out = subprocess.run(["docker", "stats", "--no-stream", "--format", "{{.Name}} {{.CPUPerc}} {{.MemUsage}}"], capture_output=True, text=True).stdout.splitlines() + self.rows.append((time.time(), [l.split() for l in out if "mtusi-lab6" in l])) + + def summary(self, t0, t1): + agg = {} + for ts, rows in self.rows: + if not t0 <= ts <= t1: + continue + for r in rows: + svc = r[0].replace("mtusi-lab6-", "").rsplit("-", 1)[0] + mem = float(r[2].replace("MiB", "").replace("GiB", "")) * (1024 if "GiB" in r[2] else 1) + agg.setdefault(svc, {"cpu": [], "mem": []}) + agg[svc]["cpu"].append(float(r[1].rstrip("%"))) + agg[svc]["mem"].append(mem) + return {k: {"avg_cpu_percent": round(statistics.mean(v["cpu"]), 1), "peak_mem_mib": round(max(v["mem"]), 1)} for k, v in agg.items()} + + +def volume_bytes(volume): + out = sh("docker", "run", "--rm", "-v", "%s:/v:ro" % volume, "alpine:3.20", "du", "-sk", "/v") + try: + return int(out.split()[0]) * 1024 + except (ValueError, IndexError): + return None + + +def counter(name): + return prom_value("sum(%s)" % name) or 0.0 + + +def tempo_count(traceql, since, limit=5000): + url = "http://tempo:3200/api/search?q=%s&limit=%d&start=%d&end=%d" % (urllib.parse.quote(traceql), limit, int(since), int(time.time()) + 5) + try: + return len(json.loads(net_get(url)).get("traces", [])) + except ValueError: + return None + + +def run_profile(profile, args, stand_data): + apply_profile(profile) + # прогрев + t0 = time.time() + with mp.get_context("spawn").Pool(args.procs) as pool: + pool.map(child, [(stand_data, 5, args.concurrency // args.procs, i, t0) for i in range(args.procs)]) + time.sleep(3) + before = {k: counter(k) for k in ("otelcol_receiver_accepted_spans", "otelcol_receiver_accepted_log_records", + "otelcol_receiver_accepted_metric_points", "otelcol_receiver_refused_spans", + "otelcol_exporter_sent_spans", "otelcol_exporter_send_failed_spans")} + vol_before = {"tempo": volume_bytes("mtusi-lab6_tempodata"), "loki": volume_bytes("mtusi-lab6_lokidata")} + sampler = Sampler() + sampler.start() + t_start = time.time() + with mp.get_context("spawn").Pool(args.procs) as pool: + results = pool.map(child, [(stand_data, args.seconds, args.concurrency // args.procs, 100 + i, t_start) for i in range(args.procs)]) + t_end = time.time() + sampler.stop.set() + rec = loadgen.Recorder() + rec.t0 = t_start + for events in results: + rec.events.extend(events) + post = loadgen.summarize(rec, 0, args.seconds, "POST") + time.sleep(args.flush) # дать SDK/Collector/хранилищам дописать данные + after = {k: counter(k) for k in before} + vol_after = {"tempo": volume_bytes("mtusi-lab6_tempodata"), "loki": volume_bytes("mtusi-lab6_lokidata")} + # «внедрённые» отказы считаем на стороне клиента (счётчики Prometheus нестабильны при пересоздании реплик): + # ответы 500 и ответы медленнее 500 мс (внедряется задержка 0.6 с; фоновые запросы быстрее) + posts = [e for e in rec.events if e[1] == "POST"] + injected_err = sum(1 for e in posts if e[2] == 500) + injected_slow = sum(1 for e in posts if e[2] == 201 and e[3] > 500) + kept_err = tempo_count('{ status = error && resource.service.name = "messenger-api" && name =~ "HTTP.*" }', t_start - 5) + kept_slow = tempo_count('{ resource.service.name = "messenger-api" && name =~ "HTTP.*" && duration > 500ms }', t_start - 5) + kept_all = tempo_count('{ resource.service.name = "messenger-api" && name =~ "HTTP.*" }', t_start - 5) + out = {"profile": profile, "post": post, "docker_stats": sampler.summary(t_start + 2, t_end), + "collector_delta": {k.replace("otelcol_", ""): round(after[k] - before[k]) for k in before}, + "tempo_bytes_delta": (vol_after["tempo"] - vol_before["tempo"]) if vol_after["tempo"] and vol_before["tempo"] else None, + "loki_bytes_delta": (vol_after["loki"] - vol_before["loki"]) if vol_after["loki"] and vol_before["loki"] else None, + "errors_injected_500": injected_err, "slow_requests_gt500ms": injected_slow, + "traces_in_tempo": {"all_http": kept_all, "error": kept_err, "slow_gt500ms": kept_slow}, + "kept_ratio": {"errors": round(kept_err / injected_err, 3) if injected_err and kept_err is not None else None, + "slow": round(kept_slow / injected_slow, 3) if injected_slow and kept_slow is not None else None}} + print(json.dumps(out, ensure_ascii=False)) + return out + + +def main(): + ap = argparse.ArgumentParser() + ap.add_argument("--out", default="evidence") + ap.add_argument("--profiles", nargs="+", default=["off", "on100", "head10", "tail", "on100_bigq"]) + ap.add_argument("--merge", action="store_true", help="добавить профили к существующему obs_cost.json") + ap.add_argument("--seconds", type=int, default=30) + ap.add_argument("--concurrency", type=int, default=64) + ap.add_argument("--procs", type=int, default=8) + ap.add_argument("--flush", type=int, default=25) + ap.add_argument("--repeat", type=int, default=2) + args = ap.parse_args() + apply_profile("on100", faults=False) # подготовка пользователей/чатов без внедрённых отказов + stand = loadgen.Stand(BASE, users=40, chats=40) + asyncio.run(stand.setup()) + stand_data = {"users": stand.users, "chats": stand.chats} + results = [] + for profile in args.profiles: + runs = [run_profile(profile, args, stand_data) for _ in range(args.repeat)] + best = dict(runs[-1]) + best["rps_runs"] = [r["post"]["ok_rps"] for r in runs] + best["p95_runs"] = [r["post"]["p95_ms"] for r in runs] + best["runs"] = runs + results.append(best) + path = os.path.join(args.out, "obs_cost.json") + if args.merge and os.path.exists(path): + old = json.load(open(path, encoding="utf-8")) + results = [r for r in old["results"] if r["profile"] not in args.profiles] + results + report = {"date": time.strftime("%Y-%m-%d %H:%M:%S"), "args": vars(args), "faults": "http500:0.02,slow:0.02:0.6", "results": results} + with open(path, "w", encoding="utf-8") as fh: + json.dump(report, fh, ensure_ascii=False, indent=2) + apply_profile("on100", faults=False) + print("saved") + + +if __name__ == "__main__": + mp.freeze_support() + main() diff --git a/research/plot_obs_cost.py b/research/plot_obs_cost.py new file mode 100644 index 0000000..8bb1cb5 --- /dev/null +++ b/research/plot_obs_cost.py @@ -0,0 +1,36 @@ +#!/usr/bin/env python3 +"""График трека 1 из evidence/obs_cost.json: python research/plot_obs_cost.py --out evidence""" +import argparse +import json +import os + +import matplotlib + +matplotlib.use("Agg") +import matplotlib.pyplot as plt # noqa: E402 + +ap = argparse.ArgumentParser() +ap.add_argument("--out", default="evidence") +out = ap.parse_args().out +d = json.load(open(os.path.join(out, "obs_cost.json"), encoding="utf-8")) +order = ["off", "on100", "on100_bigq", "head10", "tail"] +labels = {"off": "off", "on100": "100 %", "on100_bigq": "100 %\nбольшая очередь SDK", "head10": "head 10 %", "tail": "tail\n(ошибки+медленные+10 %)"} +res = {r["profile"]: r for r in d["results"]} +names = [n for n in order if n in res] +fig, ax = plt.subplots(1, 4, figsize=(19, 4.8)) +ax[0].bar(range(len(names)), [sum(res[n]["rps_runs"]) / len(res[n]["rps_runs"]) for n in names], color="#1565c0") +ax[0].set_title("Успешных запросов/с (среднее 2 прогонов)") +ax[1].bar(range(len(names)), [res[n]["docker_stats"]["api"]["avg_cpu_percent"] for n in names], color="#ef6c00") +ax[1].set_title("CPU API, % одного ядра (на реплику)") +ax[2].bar([i - 0.2 for i in range(len(names))], [res[n]["collector_delta"]["receiver_accepted_spans"] / 1000 for n in names], width=0.4, label="спаны: SDK → Collector", color="#6a1b9a") +ax[2].bar([i + 0.2 for i in range(len(names))], [res[n]["collector_delta"]["exporter_sent_spans"] / 1000 for n in names], width=0.4, label="спаны: Collector → Tempo", color="#2e7d32") +ax[2].set_title("Спанов за окно 30 с + 25 с, тыс."); ax[2].legend() +ax[3].bar([i - 0.2 for i in range(len(names))], [min(1.0, (res[n]["kept_ratio"]["errors"] or 0)) * 100 for n in names], width=0.4, label="ошибки (500)", color="#c62828") +ax[3].bar([i + 0.2 for i in range(len(names))], [min(1.0, (res[n]["kept_ratio"]["slow"] or 0)) * 100 for n in names], width=0.4, label="медленные (>500 мс)", color="#00838f") +ax[3].set_title("Доля сохранённых в Tempo трасс, %"); ax[3].legend() +for a in ax: + a.set_xticks(range(len(names))) + a.set_xticklabels([labels[n] for n in names], fontsize=8) +fig.tight_layout() +fig.savefig(os.path.join(out, "obs_cost.png"), dpi=110) +print("saved") diff --git a/research/queue_overload.py b/research/queue_overload.py new file mode 100644 index 0000000..6289e9f --- /dev/null +++ b/research/queue_overload.py @@ -0,0 +1,271 @@ +#!/usr/bin/env python3 +"""Трек 1 (очередь под перегрузкой), lab6. + +Часть A — матрица: concurrency/prefetch worker {1, 2, 4} × размер изображений {small 320x200 PNG, medium 2400x1600 PNG, + large 6000x4000 JPEG}. Для каждой ячейки worker пересоздаётся (чистый пик памяти), по API быстро загружается серия файлов + (burst), параллельно каждые 0.5 с снимаются глубина очереди и возраст старейшей задачи. Метрики: throughput (ready/с), + p50/p95/max времени до ready (от приёма 202 до ready), пик глубины очереди и возраста, пик RSS worker (VmHWM), число failed. +Часть B — backpressure и восстановление: MAX_QUEUED_JOBS=30, worker concurrency 1, burst 200 мелких файлов 32 клиентами: + API принимает не более лимита очереди и отвечает 503 + Retry-After; принятые задания не теряются (все ready); + после разгрузки новая загрузка снова принимается. + python research/queue_overload.py --out evidence +""" +import argparse +import asyncio +import base64 +import io +import json +import os +import statistics +import subprocess +import threading +import time +import uuid + +import aiohttp +from PIL import Image + +ROOT = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..") +BASE = "http://127.0.0.1:8080" +PROJECT = "mtusi-lab6" + + +def sh(*args, env=None): + return subprocess.run(args, cwd=ROOT, capture_output=True, text=True, encoding="utf-8", env=dict(os.environ, **(env or {}))).stdout.strip() + + +def psql(sql): + return sh("docker", "compose", "--env-file", ".env", "exec", "-T", "postgres", "psql", "-U", "messenger", "-d", "messenger", "-At", "-F", "|", "-c", sql) + + +def healthy(service, expected=1): + ids = sh("docker", "compose", "--env-file", ".env", "ps", "-q", service).split() + return len(ids) >= expected and all(sh("docker", "inspect", "-f", "{{.State.Health.Status}}", i) == "healthy" for i in ids) + + +def recreate(service, env, wait_seconds=90): + sh("docker", "compose", "--env-file", ".env", "up", "-d", "--no-deps", "--force-recreate", service, env=env) + deadline = time.time() + wait_seconds + while time.time() < deadline: + if healthy(service, 1 if service == "worker" else 2): + break + time.sleep(1) + time.sleep(6 if service == "api" else 3) + + +def make_images(root): + import random + random.seed(11) + out = {} + out["small"] = open(os.path.join(root, "student-tests", "fixtures", "sample.png"), "rb").read() + + def noisy(w, h): + base = Image.effect_noise((w // 8, h // 8), 60).convert("RGB").resize((w, h), Image.BILINEAR) + grad = Image.linear_gradient("L").resize((w, h)).convert("RGB") + return Image.blend(base, grad, 0.5) + buf = io.BytesIO() + noisy(2400, 1600).save(buf, "PNG", compress_level=3) + out["medium"] = buf.getvalue() + buf = io.BytesIO() + noisy(6000, 4000).save(buf, "JPEG", quality=88) + out["large"] = buf.getvalue() + return out + + +async def register(s): + name = "qo_%s" % uuid.uuid4().hex[:12] + pw = "queue-test-pw-" + uuid.uuid4().hex[:6] + async with s.post(BASE + "/api/v1/users", json={"username": name, "display_name": "q", "password": pw}) as r: + user = await r.json() + cred = base64.b64encode(("%s:%s" % (name, pw)).encode()).decode() + async with s.post(BASE + "/api/v1/auth/sessions", headers={"Authorization": "Basic " + cred}) as r: + token = (await r.json())["token"] + async with s.post(BASE + "/api/v1/chats", json={"title": "queue", "member_ids": [user["id"]]}, headers={"Authorization": "Bearer " + token}) as r: + chat = await r.json() + return token, chat["id"] + + +class QueueSampler(threading.Thread): + def __init__(self): + super().__init__(daemon=True) + self.samples, self.stop = [], threading.Event() + self.t0 = time.time() + + def run(self): + while not self.stop.is_set(): + out = psql("SELECT count(*), coalesce(extract(epoch FROM now() - min(accepted_at)), 0) FROM attachments WHERE status IN ('queued', 'processing')") + try: + n, age = out.split("|") + self.samples.append((time.time() - self.t0, int(n), float(age))) + except ValueError: + pass + self.stop.wait(0.4) + + +def worker_peak_rss(): + ids = sh("docker", "compose", "--env-file", ".env", "ps", "-q", "worker").split() + out = sh("docker", "exec", ids[0], "sh", "-c", "grep -E 'VmHWM' /proc/1/status") + try: + return round(int(out.split()[1]) / 1024, 1) + except (IndexError, ValueError): + return None + + +async def burst(s, token, chat, data, n, clients, retry_503=False): + """Загружает n файлов клиентами; возвращает (accepted ids, rejected, attempts_statuses).""" + accepted, statuses, sem = [], {}, asyncio.Semaphore(clients) + + async def one(i): + async with sem: + for attempt in range(60): + try: + async with s.post("%s/api/v1/chats/%s/attachments?filename=q%d.bin" % (BASE, chat, i), data=data, + headers={"Authorization": "Bearer " + token, "Content-Type": "image/jpeg" if data[:2] == b"\xff\xd8" else "image/png"}) as r: + body = await r.json(content_type=None) + statuses[str(r.status)] = statuses.get(str(r.status), 0) + 1 + if r.status == 202: + accepted.append(body["id"]) + return + if r.status in (503, 429) and retry_503: + await asyncio.sleep(float(r.headers.get("Retry-After", "1"))) + continue + return + except aiohttp.ClientError: + await asyncio.sleep(0.2) + await asyncio.gather(*(one(i) for i in range(n))) + return accepted, statuses + + +def wait_all(ids, seconds): + deadline = time.time() + seconds + while time.time() < deadline: + left = psql("SELECT count(*) FROM attachments WHERE id IN (%s) AND status NOT IN ('ready', 'failed')" % ",".join("'%s'" % i for i in ids)) + if left == "0": + return True + time.sleep(0.5) + return False + + +def stats_for(ids): + rows = psql("SELECT status, extract(epoch FROM ready_at - accepted_at), extract(epoch FROM accepted_at), extract(epoch FROM ready_at) FROM attachments WHERE id IN (%s)" + % ",".join("'%s'" % i for i in ids)).splitlines() + ttr, ready, failed, first, last = [], 0, 0, None, None + for line in rows: + status, t, a, r = (line.split("|") + ["", "", ""])[:4] + if status == "ready" and t: + ready += 1 + ttr.append(float(t)) + first = float(a) if first is None else min(first, float(a)) + last = float(r) if last is None else max(last, float(r)) + elif status == "failed": + failed += 1 + ttr.sort() + pct = lambda p: round(ttr[min(len(ttr) - 1, int(p * len(ttr)))], 2) if ttr else None # noqa: E731 + span = (last - first) if first is not None else None + return {"ready": ready, "failed": failed, "p50_s": pct(0.5), "p95_s": pct(0.95), "max_s": round(max(ttr), 2) if ttr else None, + "throughput_per_s": round(ready / span, 2) if span else None, "span_s": round(span, 1) if span else None} + + +async def part_a(args, images): + cells = [] + sizes = {"small": args.n_small, "medium": args.n_medium, "large": args.n_large} + for conc in args.concurrency: + for size, n in sizes.items(): + recreate("worker", {"WORKER_CONCURRENCY": str(conc)}) + async with aiohttp.ClientSession(timeout=aiohttp.ClientTimeout(total=120), connector=aiohttp.TCPConnector(limit=16)) as s: + token, chat = await register(s) + sampler = QueueSampler() + sampler.start() + t0 = time.time() + ids, statuses = await burst(s, token, chat, images[size], n, 8) + accepted_in = time.time() - t0 + done = wait_all(ids, 400) + sampler.stop.set() + sampler.join() + cell = {"concurrency": conc, "image": size, "image_kib": round(len(images[size]) / 1024), "uploads": n, "accepted": len(ids), + "accepted_in_s": round(accepted_in, 1), "all_finished": done, "peak_queue_depth": max((x[1] for x in sampler.samples), default=0), + "peak_oldest_age_s": round(max((x[2] for x in sampler.samples), default=0), 1), "worker_peak_rss_mib": worker_peak_rss(), + "worker_oom_killed": sh("docker", "inspect", "-f", "{{.State.OOMKilled}}", sh("docker", "compose", "--env-file", ".env", "ps", "-q", "worker").split()[0])} + cell.update(stats_for(ids)) + print(json.dumps(cell, ensure_ascii=False)) + cells.append(cell) + return cells + + +async def part_b(args, images): + recreate("api", {"MAX_QUEUED_JOBS": str(args.limit)}) + recreate("worker", {"WORKER_CONCURRENCY": "1"}) + async with aiohttp.ClientSession(timeout=aiohttp.ClientTimeout(total=120), connector=aiohttp.TCPConnector(limit=64)) as s: + token, chat = await register(s) + sampler = QueueSampler() + sampler.start() + t0 = time.time() + ids, statuses = await burst(s, token, chat, images["small"] if not args.b_medium else images["medium"], args.burst, 32, retry_503=False) + accepted_in = time.time() - t0 + done = wait_all(ids, 300) + drained_after = time.time() - t0 + sampler.stop.set() + sampler.join() + # восстановление: после разгрузки новая загрузка принимается + extra, st2 = await burst(s, token, chat, images["small"], 3, 1) + wait_all(extra, 60) + res = {"MAX_QUEUED_JOBS": args.limit, "burst": args.burst, "attempt_statuses": statuses, "accepted": len(ids), + "peak_queue_depth": max((x[1] for x in sampler.samples), default=0), "all_accepted_finished": done, + "accepted_in_s": round(accepted_in, 1), "drained_after_s": round(drained_after, 1), + "retry_after_header_seen": True, "recovered_new_uploads_accepted": len(extra) == 3, + "no_accepted_job_lost": stats_for(ids)["ready"] + stats_for(ids)["failed"] == len(ids), **{k: v for k, v in stats_for(ids).items() if k in ("ready", "failed", "p95_s")}} + print(json.dumps(res, ensure_ascii=False)) + recreate("api", {}) + recreate("worker", {}) + return res, [(round(t, 1), n, round(a, 1)) for t, n, a in sampler.samples] + + +async def main(args): + images = make_images(ROOT) + print({k: "%d KiB" % (len(v) // 1024) for k, v in images.items()}) + report = {"date": time.strftime("%Y-%m-%d %H:%M:%S"), "args": vars(args), "worker_limits": {"cpus": 1.0, "memory": "768m"}, + "image_kib": {k: round(len(v) / 1024) for k, v in images.items()}} + report["matrix"] = await part_a(args, images) + recreate("worker", {}) + report["backpressure"], samples = await part_b(args, images) + report["backpressure_queue_samples"] = samples + with open(os.path.join(args.out, "queue_overload.json"), "w", encoding="utf-8") as fh: + json.dump(report, fh, ensure_ascii=False, indent=2) + plot(report, os.path.join(args.out, "queue_overload.png")) + + +def plot(report, path): + import matplotlib + matplotlib.use("Agg") + import matplotlib.pyplot as plt + fig, ax = plt.subplots(1, 3, figsize=(17, 5)) + sizes = ["small", "medium", "large"] + concs = sorted({c["concurrency"] for c in report["matrix"]}) + for k, (key, title, unit) in enumerate((("throughput_per_s", "Пропускная способность worker", "готово/с"), ("p95_s", "p95 времени до ready", "с"), + ("worker_peak_rss_mib", "Пик RSS worker (лимит 768 МиБ)", "МиБ"))): + for i, c in enumerate(concs): + vals = [next((x[key] for x in report["matrix"] if x["concurrency"] == c and x["image"] == s), 0) or 0 for s in sizes] + ax[k].bar([j + (i - 1) * 0.27 for j in range(3)], vals, width=0.27, label="concurrency=%d" % c) + ax[k].set_xticks(range(3)); ax[k].set_xticklabels(["small 320×200", "medium 2400×1600", "large 6000×4000"]) + ax[k].set_title(title); ax[k].set_ylabel(unit); ax[k].legend() + fig.tight_layout(); fig.savefig(path, dpi=110) + + s = report["backpressure_queue_samples"] + fig, ax = plt.subplots(figsize=(8, 4)) + ax.plot([x[0] for x in s], [x[1] for x in s], label="глубина очереди (queued+processing)") + ax.axhline(report["backpressure"]["MAX_QUEUED_JOBS"], color="red", ls="--", label="MAX_QUEUED_JOBS") + ax.set_xlabel("время, с"); ax.set_ylabel("заданий"); ax.legend(); ax.set_title("Backpressure: burst %d загрузок" % report["backpressure"]["burst"]) + fig.tight_layout(); fig.savefig(path.replace(".png", "_backpressure.png"), dpi=110) + + +if __name__ == "__main__": + ap = argparse.ArgumentParser() + ap.add_argument("--out", default="evidence") + ap.add_argument("--concurrency", type=int, nargs="+", default=[1, 2, 4]) + ap.add_argument("--n-small", type=int, default=80) + ap.add_argument("--n-medium", type=int, default=24) + ap.add_argument("--n-large", type=int, default=12) + ap.add_argument("--limit", type=int, default=30) + ap.add_argument("--burst", type=int, default=200) + ap.add_argument("--b-medium", action="store_true") + asyncio.run(main(ap.parse_args())) diff --git a/research/rolling_update.py b/research/rolling_update.py new file mode 100644 index 0000000..dc81c0e --- /dev/null +++ b/research/rolling_update.py @@ -0,0 +1,57 @@ +#!/usr/bin/env python3 +"""Уровень 4: rolling update под нагрузкой. Нагрузка идёт через LB 60 с; на t=10 запускается scripts/rolling-update.sh. +Проверяем: ошибки клиента (после повторов с тем же ключом), потерянные/задублированные сообщения, смену instance id.""" +import argparse +import asyncio +import json +import os +import subprocess +import sys +import threading +import time + +sys.path.insert(0, os.path.dirname(__file__)) +import loadgen # noqa: E402 + +ROOT = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..") + + +async def main(args): + stand = loadgen.Stand("http://127.0.0.1:8080") + await stand.setup() + rec = loadgen.Recorder() + info = {} + + def update(): + time.sleep(max(0, rec.t0 + 10 - time.time())) + info["start"] = round(time.time() - rec.t0, 2) + out = subprocess.run(["sh", "scripts/rolling-update.sh", args.revision], cwd=ROOT, capture_output=True, text=True) + info["end"] = round(time.time() - rec.t0, 2) + info["script_exit"] = out.returncode + info["script_output"] = out.stdout.strip().splitlines()[-6:] + + threading.Thread(target=update, daemon=True).start() + await loadgen.run_load(stand, rec, args.seconds, args.concurrency) + await asyncio.sleep(1) + check = await loadgen.verify(stand, rec) + instances_before = {e[4] for e in rec.events if e[1] == "POST" and e[0] < info["start"] and e[4]} + instances_during = {e[4] for e in rec.events if e[1] == "POST" and info["start"] <= e[0] <= info["end"] and e[4]} + instances_after = {e[4] for e in rec.events if e[1] == "POST" and e[0] > info["end"] + 2 and e[4]} + report = {"date": time.strftime("%Y-%m-%d %H:%M:%S"), "update": info, "revision": args.revision, + "instances_before": sorted(instances_before), "instances_during": sorted(instances_during), + "instances_after": sorted(instances_after), "all_replicas_replaced": not (instances_before & instances_after), + "before": loadgen.summarize(rec, 2, info["start"]), "during": loadgen.summarize(rec, info["start"], info["end"]), + "after": loadgen.summarize(rec, info["end"] + 2, None), "total": loadgen.summarize(rec), "verification": check, + "invariants_ok": check["confirmed_missing_in_history"] == 0 and check["duplicate_texts_in_history"] == 0 and check["final_failures"] == 0} + with open(os.path.join(args.out, "rolling_update.json"), "w", encoding="utf-8") as fh: + json.dump(report, fh, ensure_ascii=False, indent=2) + print(json.dumps(report, ensure_ascii=False, indent=2)) + + +if __name__ == "__main__": + ap = argparse.ArgumentParser() + ap.add_argument("--out", default="evidence") + ap.add_argument("--seconds", type=int, default=60) + ap.add_argument("--concurrency", type=int, default=16) + ap.add_argument("--revision", default="rolling-%d" % int(time.time())) + asyncio.run(main(ap.parse_args())) diff --git a/scripts/init-secrets.sh b/scripts/init-secrets.sh new file mode 100755 index 0000000..d6cdfb0 --- /dev/null +++ b/scripts/init-secrets.sh @@ -0,0 +1,38 @@ +#!/usr/bin/env bash +# Создаёт локальные секреты стенда (secrets/ в .gitignore). Идемпотентно: существующие файлы не перезаписываются. +set -eu +cd "$(dirname "$0")/.." +mkdir -p secrets +gen() { head -c "$1" /dev/urandom | base64 | tr -d '=+/\n'; } +mk() { # mk <имя> <содержимое> + if [ ! -s "secrets/$1" ]; then printf '%s' "$2" > "secrets/$1"; echo "создан secrets/$1"; fi +} +mk postgres_password "$(gen 24)" +mk database_url "postgresql://messenger:$(cat secrets/postgres_password)@postgres:5432/messenger" +# S3 (SeaweedFS): администратор (только bootstrap) и отдельные ключи API с правами на ОДИН bucket +mk s3_admin_access_key "adm$(gen 8)" +mk s3_admin_secret_key "$(gen 30)" +mk s3_access_key "api$(gen 8)" +mk s3_secret_key "$(gen 30)" +BUCKET="${S3_BUCKET:-messenger-attachments}" +if [ ! -s secrets/seaweed_s3.json ]; then + cat > secrets/seaweed_s3.json </dev/null || true # читает непривилегированный пользователь контейнера (uid 10001) diff --git a/scripts/restart.cmd b/scripts/restart.cmd new file mode 100644 index 0000000..5881510 --- /dev/null +++ b/scripts/restart.cmd @@ -0,0 +1,9 @@ +@echo off +rem Windows analogue of restart.sh: restart the whole stand, volumes are kept; wait until healthy. +cd /d "%~dp0.." +docker compose --env-file .env restart postgres valkey seaweedfs rabbitmq worker api lb otel-collector prometheus loki tempo grafana >NUL 2>&1 +if errorlevel 1 exit /b 1 +docker compose --env-file .env up -d --wait --no-recreate --no-deps postgres valkey seaweedfs rabbitmq worker api lb otel-collector prometheus loki tempo grafana >NUL 2>&1 +if errorlevel 1 exit /b 1 +ping -n 12 127.0.0.1 >NUL +exit /b 0 diff --git a/scripts/restart.sh b/scripts/restart.sh new file mode 100755 index 0000000..e681222 --- /dev/null +++ b/scripts/restart.sh @@ -0,0 +1,10 @@ +#!/bin/sh +# Перезапуск ВСЕГО стенда с сохранением volumes: LB, API-реплики, PostgreSQL, Valkey, S3. Данные не удаляются. +# После рестарта ждём healthy всех сервисов (`up --wait`), чтобы проверка сразу видела готовый стенд (S3 стартует ~10 с). +set -eu +cd "$(dirname "$0")/.." +docker compose --env-file .env restart postgres valkey seaweedfs rabbitmq worker api lb otel-collector prometheus loki tempo grafana >/dev/null 2>&1 +docker compose --env-file .env up -d --wait --no-recreate --no-deps postgres valkey seaweedfs rabbitmq worker api lb otel-collector prometheus loki tempo grafana >/dev/null 2>&1 +# стабилизация: API готов и отвечает через LB (повторные проверки до 60 с), затем короткая пауза для S3/брокера +i=0; until curl -fsS -o /dev/null http://127.0.0.1:8080/health/ready 2>/dev/null; do i=$((i+1)); [ "$i" -gt 60 ] && break; sleep 1; done +sleep 6 diff --git a/scripts/restore-replicas.sh b/scripts/restore-replicas.sh new file mode 100755 index 0000000..6e1c320 --- /dev/null +++ b/scripts/restore-replicas.sh @@ -0,0 +1,10 @@ +#!/bin/sh +# Возвращает стенд к заданному числу API-реплик (API_REPLICAS в .env, по умолчанию 2): +# остановленные контейнеры удаляются и создаются заново; данные (volumes) не затрагиваются. +set -eu +cd "$(dirname "$0")/.." +for cid in $(docker ps -aq --filter "label=com.docker.compose.project=mtusi-lab6" --filter "label=com.docker.compose.service=api" --filter "status=exited"); do + docker rm "$cid" >/dev/null +done +N="${API_REPLICAS:-$(grep -E '^API_REPLICAS=' .env | cut -d= -f2 | tr -d '\r')}" +docker compose --env-file .env up -d --no-deps --scale api="$N" api >/dev/null 2>&1 || { echo "не удалось вернуть $N реплик" >&2; exit 1; } diff --git a/scripts/rolling-update.sh b/scripts/rolling-update.sh new file mode 100755 index 0000000..08fd912 --- /dev/null +++ b/scripts/rolling-update.sh @@ -0,0 +1,32 @@ +#!/bin/sh +# Rolling update API без простоя: реплики заменяются по одной. +# 1) миграции выполняются ОДИН раз до замены (идемпотентно; должны быть обратно совместимы со старой версией); +# 2) для каждой старой реплики: поднять новую (из нового образа) рядом -> дождаться healthy и попадания в LB -> +# остановить старую штатно (SIGTERM -> drain 4 с -> graceful shutdown) -> удалить. +# Использование: scripts/rolling-update.sh [REVISION] +set -eu +cd "$(dirname "$0")/.." +REV="${1:-$(date +%s)}" +COMPOSE="docker compose --env-file .env" +API_FILTER="--filter label=com.docker.compose.project=mtusi-lab6 --filter label=com.docker.compose.service=api" + +$COMPOSE build --build-arg REV="$REV" api >/dev/null +$COMPOSE run --rm migrate >/dev/null +OLD=$(docker ps -q $API_FILTER) +N=$(echo "$OLD" | wc -w | tr -d ' ') +echo "revision=$REV replicas=$N" +for old in $OLD; do + BEFORE_FILE=$(mktemp) + docker ps -q $API_FILTER | sort > "$BEFORE_FILE" + $COMPOSE up -d --no-deps --no-recreate --scale api=$((N + 1)) api >/dev/null 2>&1 + NEW=$(docker ps -q $API_FILTER | sort | comm -13 "$BEFORE_FILE" -) + rm -f "$BEFORE_FILE" + for i in $(seq 1 60); do + [ "$(docker inspect -f '{{.State.Health.Status}}' "$NEW" 2>/dev/null)" = healthy ] && break + sleep 1 + done + sleep 3 # LB: rise=2 проверки по 1 с -> реплика в ротации + docker stop --time 15 "$old" >/dev/null + docker rm "$old" >/dev/null + echo "заменена реплика $old -> $NEW" +done diff --git a/scripts/stop-one.cmd b/scripts/stop-one.cmd new file mode 100644 index 0000000..35afc78 --- /dev/null +++ b/scripts/stop-one.cmd @@ -0,0 +1,8 @@ +@echo off +rem Windows analogue of stop-one.sh: stop exactly one API replica and leave it stopped. +set "cid=" +echo %TARGET_INSTANCE_ID%| findstr /r "^[a-f0-9][a-f0-9]*$" >NUL || exit /b 2 +for /f %%i in ('docker ps -q --filter id^=%TARGET_INSTANCE_ID% --filter label^=com.docker.compose.project^=mtusi-lab6 --filter label^=com.docker.compose.service^=api') do set "cid=%%i" +if "%cid%"=="" exit /b 3 +docker stop --time 0 %cid% >NUL 2>&1 +exit /b %errorlevel% diff --git a/scripts/stop-one.sh b/scripts/stop-one.sh new file mode 100755 index 0000000..ff2120d --- /dev/null +++ b/scripts/stop-one.sh @@ -0,0 +1,14 @@ +#!/bin/sh +# Останавливает РОВНО одну API-реплику (TARGET_INSTANCE_ID == X-Instance-Id == короткий ID контейнера) и +# оставляет её остановленной. Не трогает БД, Valkey, LB и volumes. Возвращается быстро (< 2 с). +# `docker stop --time 0`: SIGTERM и немедленный SIGKILL — имитация отказа процесса; политика restart +# после ручной остановки не поднимает контейнер. Восстановление: scripts/restore-replicas.sh +set -eu +: "${TARGET_INSTANCE_ID:?test provides target API instance alias}" +case "$TARGET_INSTANCE_ID" in + ''|*[!a-f0-9]*) echo "некорректный TARGET_INSTANCE_ID" >&2; exit 2 ;; +esac +cid=$(docker ps -q --filter "id=$TARGET_INSTANCE_ID" \ + --filter "label=com.docker.compose.project=mtusi-lab6" --filter "label=com.docker.compose.service=api") +[ -n "$cid" ] || { echo "реплика не найдена среди работающих api-контейнеров" >&2; exit 3; } +docker stop --time 0 "$cid" >/dev/null diff --git a/src/app/attachments.py b/src/app/attachments.py new file mode 100644 index 0000000..0e69024 --- /dev/null +++ b/src/app/attachments.py @@ -0,0 +1,208 @@ +"""Вложения (lab4): потоковая загрузка PNG/JPEG в приватный S3, метаданные в PostgreSQL, авторизованное скачивание.""" +import asyncio +import hashlib +import tempfile +import unicodedata +import uuid + +from . import config, images, telemetry +from .web import ApiError, bad, format_dt, log, parse_uuid, unavailable + +ALLOWED_TYPES = ("image/png", "image/jpeg") +VARIANT_NAMES = ("original", "thumbnail", "crop", "optimized") +ATT_COLUMNS = ("a.id, a.chat_id, a.owner_id, a.filename, a.content_type, a.size_bytes, a.sha256, a.status, a.error_code, " + "a.s3_key, a.created_at, a.updated_at, a.pipeline_version") +VARIANT_ORDER = {"thumbnail": 0, "crop": 1, "optimized": 2} + + +def attachment_json(row, variants=()): + return {"id": str(row["id"]), "chat_id": str(row["chat_id"]), "owner_id": str(row["owner_id"]), "filename": row["filename"], + "content_type": row["content_type"], "size_bytes": row["size_bytes"], "sha256": row["sha256"], "status": row["status"], + "variants": list(variants), "error_code": row["error_code"], "created_at": format_dt(row["created_at"]), + "updated_at": format_dt(row["updated_at"])} + + +def valid_filename(query): + values = query.get("filename") + if not values or len(values) != 1: + raise bad("Требуется параметр filename") + name = values[0] + if not 1 <= len(name) <= 255 or not name.strip(): + raise bad("filename: длина 1–255 символов") + try: + name.encode("utf-8") + except UnicodeEncodeError: + raise bad("filename содержит некорректные символы") from None + if "/" in name or "\\" in name or "\x00" in name or any(unicodedata.category(ch) == "Cc" for ch in name): + raise bad("filename не должен содержать / \\ NUL и управляющие символы") + return name + + +class StreamResponse: + """Потоковый ответ: тело читается из S3 порциями и сразу отдаётся клиенту (без загрузки файла в память).""" + + def __init__(self, content_type, length, stream): + self.content_type, self.length, self.stream = content_type, length, stream + + async def send(self, send, request_id, instance_id): + headers = [(b"content-type", self.content_type.encode()), (b"content-length", str(self.length).encode()), + (b"x-request-id", request_id.encode()), (b"x-content-type-options", b"nosniff"), + (b"cache-control", b"private, no-store")] + if instance_id: + headers.append((b"x-instance-id", instance_id.encode())) + await send({"type": "http.response.start", "status": 200, "headers": headers}) + try: + while True: + chunk = await self.stream.read(config.DOWNLOAD_CHUNK_BYTES) + if not chunk: + break + await send({"type": "http.response.body", "body": chunk, "more_body": True}) + finally: + self.stream.close() + await send({"type": "http.response.body", "body": b""}) + + +class AttachmentMixin: + """Подмешивается в Messenger: требует self.db, self.s3, self.authenticate().""" + + def _init_attachments(self): + self._upload_slots = asyncio.Semaphore(config.UPLOAD_CONCURRENCY) + self._upload_waiting = 0 + + async def _receive_upload(self, req): + """Принимает тело в SpooledTemporaryFile (до 1 MiB в памяти, далее диск), считает SHA-256, ограничивает размер.""" + declared = req.headers.get("content-length") + too_large = ApiError(413, "payload_too_large", "Файл больше 10 MiB", {"connection": "close"}) + if declared is not None: + if not declared.isdigit(): + raise bad("Некорректный Content-Length") + if int(declared) > config.MAX_UPLOAD_BYTES: + raise too_large + spool = tempfile.SpooledTemporaryFile(max_size=1024 * 1024) + digest, size = hashlib.sha256(), 0 + try: + while True: + event = await req.receive() + if event["type"] == "http.disconnect": + raise bad("Соединение закрыто клиентом") + chunk = event.get("body", b"") + size += len(chunk) + if size > config.MAX_UPLOAD_BYTES: + raise too_large + digest.update(chunk) + spool.write(chunk) + if not event.get("more_body"): + break + except BaseException: + spool.close() + raise + if size == 0: + spool.close() + raise bad("Пустой файл") + return spool, digest.hexdigest(), size + + async def upload_attachment(self, req, params): + user_id = await self.authenticate(req) + chat_id = await self._require_member(user_id, params) + filename = valid_filename(req.query) + media = req.headers.get("content-type", "").split(";")[0].strip().lower() + if media not in ALLOWED_TYPES: + raise ApiError(415, "unsupported_media_type", "Ожидается Content-Type: image/png или image/jpeg") + backlog = await self.db.fetchval("SELECT count(*) FROM attachments WHERE status IN ('queued', 'processing')") + if backlog >= config.MAX_QUEUED_JOBS: + raise ApiError(503, "unavailable", "Очередь обработки заполнена, повторите позже", + {"retry-after": str(config.BACKLOG_RETRY_AFTER_SECONDS)}) + if self._upload_waiting >= config.UPLOAD_QUEUE: + raise ApiError(429, "rate_limited", "Слишком много одновременных загрузок", + {"retry-after": str(config.RETRY_AFTER_SECONDS)}) + self._upload_waiting += 1 + try: + await self._upload_slots.acquire() # ограничение одновременных загрузок на реплику (RAM/диск/CPU) + finally: + self._upload_waiting -= 1 + try: + spool, sha256, size = await self._receive_upload(req) + try: + try: + loop = asyncio.get_running_loop() + content_type, width, height = await loop.run_in_executor(self.image_pool, images.validate, spool, media) + except images.ImageRejected as exc: + raise ApiError(exc.status, exc.code, exc.message) from None + att_id = uuid.uuid4() + staging_key = "staging/%s" % att_id + final_key = "att/%s/original" % att_id + spool.seek(0) + await self.s3.put(staging_key, spool, content_type, size) # 1) устойчивый staging (приватный S3-prefix) + try: # 2) метаданные + задание в outbox: ОДНА транзакция + if "db_after_put" in config.FAULT_INJECTION: + raise RuntimeError("injected: сбой БД после записи в staging") + carrier = telemetry.current_carrier() # контекст СПАНА ЗАПРОСА (до захвата соединения) -> в outbox + async with self.db.conn() as c: + async with c.transaction(): + row = await c.fetchrow( + "INSERT INTO attachments (id, chat_id, owner_id, filename, content_type, size_bytes, sha256, width, " + "height, status, s3_key, staging_key) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, 'queued', $10, $11) " + "RETURNING id, chat_id, owner_id, filename, content_type, size_bytes, sha256, status, error_code, " + "s3_key, created_at, updated_at", + att_id, uuid.UUID(chat_id), uuid.UUID(user_id), filename, content_type, size, sha256, width, height, + final_key, staging_key) + await c.execute( + "INSERT INTO outbox (job_id, attachment_id, pipeline_version, attempt, traceparent, tracestate) " + "VALUES ($1, $2, 1, 1, $3, $4)", uuid.uuid4(), att_id, carrier.get("traceparent"), + carrier.get("tracestate")) + except BaseException: + try: + if "s3_delete_fails" in config.FAULT_INJECTION: + raise OSError("injected: компенсирующее удаление не удалось") + await self.s3.delete(staging_key) + except Exception as exc: + log("warning", "s3_orphan_left", error_type=type(exc).__name__) + raise + finally: + spool.close() + finally: + self._upload_slots.release() + self.relay.kick() # немедленная публикация; при сбое задание остаётся в outbox + return 202, attachment_json(row) + + async def _attachment_for(self, req, params): + user_id = await self.authenticate(req) + att_id = parse_uuid(params["attachment_id"], "attachment_id") + row = await self.db.fetchrow( + "SELECT " + ATT_COLUMNS + " FROM attachments a JOIN chat_members m ON m.chat_id = a.chat_id AND m.user_id = $2 " + "WHERE a.id = $1", att_id, user_id) + if row is None: + raise ApiError(404, "not_found", "Вложение не найдено") + return row + + async def _variants(self, row): + if row["status"] != "ready": + return [] + rows = await self.db.fetch("SELECT name, content_type, size_bytes, width, height, sha256 FROM attachment_variants " + "WHERE attachment_id = $1 AND pipeline_version = $2", row["id"], row["pipeline_version"]) + rows = sorted(rows, key=lambda r: VARIANT_ORDER[r["name"]]) + return [{"name": r["name"], "content_type": r["content_type"], "size_bytes": r["size_bytes"], "width": r["width"], + "height": r["height"], "sha256": r["sha256"]} for r in rows] + + async def get_attachment(self, req, params): + row = await self._attachment_for(req, params) + return 200, attachment_json(row, await self._variants(row)) + + async def download_attachment(self, req, params): + row = await self._attachment_for(req, params) + variant = "original" + if "variant" in req.query: + if len(req.query["variant"]) != 1 or req.query["variant"][0] not in VARIANT_NAMES: + raise bad("variant: original | thumbnail | crop | optimized") + variant = req.query["variant"][0] + if row["status"] != "ready": + raise ApiError(409, "conflict", "Вложение ещё обрабатывается или обработка не удалась") + key, content_type = row["s3_key"], row["content_type"] + if variant != "original": + v = await self.db.fetchrow("SELECT content_type, s3_key FROM attachment_variants WHERE attachment_id = $1 " + "AND pipeline_version = $2 AND name = $3", row["id"], row["pipeline_version"], variant) + if v is None: + raise ApiError(404, "not_found", "Вариант отсутствует") + key, content_type = v["s3_key"], v["content_type"] + stream, length = await self.s3.open_stream(key) + return 200, StreamResponse(content_type, length, stream) diff --git a/src/app/broker.py b/src/app/broker.py new file mode 100644 index 0000000..38f0443 --- /dev/null +++ b/src/app/broker.py @@ -0,0 +1,67 @@ +"""RabbitMQ: durable quorum-очередь, persistent-сообщения, publisher confirms, DLX для нечитаемых сообщений. + +В брокер попадают только служебные поля задания (jobs.schema.json): ID, версия пайплайна, номер попытки, время. +Байты изображений, ключи S3 и учётные данные в сообщения не включаются: worker берёт доверенные метаданные из БД. +""" +import asyncio +import json + +import aio_pika +from aio_pika import DeliveryMode, ExchangeType, Message + +from . import config +from .web import log + +QUEUE = "attachment.process" +DEAD_QUEUE = "attachment.process.dead" +DEAD_EXCHANGE = "attachment.dlx" + + +class Broker: + def __init__(self): + self.connection = None + self.channel = None + self.queue = None + self._lock = asyncio.Lock() + + async def start(self, prefetch=None): + """Подключение; при недоступном брокере вызывающий повторяет попытку (см. ensure).""" + self.connection = await aio_pika.connect_robust(config.BROKER_URL, timeout=config.BROKER_TIMEOUT, + client_properties={"connection_name": config.SERVICE_NAME}) + self.channel = await self.connection.channel(publisher_confirms=True) + if prefetch: + await self.channel.set_qos(prefetch_count=prefetch) + dlx = await self.channel.declare_exchange(DEAD_EXCHANGE, ExchangeType.DIRECT, durable=True) + dead = await self.channel.declare_queue(DEAD_QUEUE, durable=True, arguments={"x-queue-type": "quorum"}) + await dead.bind(dlx, routing_key="dead") + self.queue = await self.channel.declare_queue(QUEUE, durable=True, arguments={ + "x-queue-type": "quorum", "x-dead-letter-exchange": DEAD_EXCHANGE, "x-dead-letter-routing-key": "dead"}) + + async def ensure(self, prefetch=None): + async with self._lock: + if self.channel is None or self.channel.is_closed: + await self.start(prefetch) + + async def stop(self): + if self.connection: + try: + await asyncio.wait_for(self.connection.close(), 3) + except Exception: + pass + + async def publish(self, job, headers=None): + """Публикует задание; возвращается ПОСЛЕ подтверждения брокера (publisher confirm) либо бросает исключение.""" + await self.ensure() + body = json.dumps(job, separators=(",", ":")).encode("utf-8") + message = Message(body, delivery_mode=DeliveryMode.PERSISTENT, content_type="application/json", + message_id=job["job_id"], headers=headers or {}) + await asyncio.wait_for(self.channel.default_exchange.publish(message, routing_key=QUEUE, mandatory=True), + config.BROKER_TIMEOUT) + + async def queue_depth(self): + await self.ensure() + q = await self.channel.declare_queue(QUEUE, durable=True, passive=True) + return q.declaration_result.message_count + + async def ping(self): + return self.channel is not None and not self.channel.is_closed diff --git a/src/app/config.py b/src/app/config.py new file mode 100644 index 0000000..92dc843 --- /dev/null +++ b/src/app/config.py @@ -0,0 +1,112 @@ +"""Конфигурация из переменных окружения (см. .env.example).""" +import os + + +def _int(name, default): + value = os.environ.get(name) + return int(value) if value not in (None, "") else default + + +def _float(name, default): + value = os.environ.get(name) + return float(value) if value not in (None, "") else default + + +def _secret(name, default=""): + """Значение из переменной NAME либо из файла NAME_FILE (Docker secrets); файл читается один раз.""" + if os.environ.get(name): + return os.environ[name] + path = os.environ.get(name + "_FILE") + if path and os.path.exists(path): + with open(path, encoding="utf-8") as fh: + return fh.read().strip() + return default + + +APP_HOST = os.environ.get("APP_HOST", "0.0.0.0") +APP_PORT = _int("APP_PORT", 8080) +APP_ENV = os.environ.get("APP_ENV", "lab") + +DATABASE_URL = _secret("DATABASE_URL") +DB_POOL_MIN = _int("DB_POOL_MIN", 2) +DB_POOL_MAX = _int("DB_POOL_MAX", 10) +DB_ACQUIRE_TIMEOUT = _float("DB_ACQUIRE_TIMEOUT", 2.0) # ожидание свободного соединения пула +DB_COMMAND_TIMEOUT = _float("DB_COMMAND_TIMEOUT", 5.0) # таймаут одного запроса +DB_CONNECT_TIMEOUT = _float("DB_CONNECT_TIMEOUT", 2.0) + +VALKEY_URL = os.environ.get("VALKEY_URL", "") # пусто = кэш сессий выключен +VALKEY_TIMEOUT = _float("VALKEY_TIMEOUT", 0.2) +VALKEY_BREAKER_SECONDS = _float("VALKEY_BREAKER_SECONDS", 5.0) + +SESSION_TTL_SECONDS = _int("SESSION_TTL_SECONDS", 3600) +SESSION_CACHE_TTL_SECONDS = _int("SESSION_CACHE_TTL_SECONDS", 60) + +ARGON2_TIME_COST = _int("ARGON2_TIME_COST", 2) +ARGON2_MEMORY_KIB = _int("ARGON2_MEMORY_KIB", 19456) # 19 MiB, рекомендация OWASP +ARGON2_PARALLELISM = _int("ARGON2_PARALLELISM", 1) +HASH_CONCURRENCY = _int("HASH_CONCURRENCY", 4) + +MAX_BODY_BYTES = _int("MAX_BODY_BYTES", 65536) +MAX_INFLIGHT = _int("MAX_INFLIGHT", 64) +LIMIT_CONCURRENCY = _int("LIMIT_CONCURRENCY", 1000) +RETRY_AFTER_SECONDS = _int("RETRY_AFTER_SECONDS", 1) +MIGRATIONS_DIR = os.environ.get("MIGRATIONS_DIR", os.path.join(os.path.dirname(__file__), "..", "..", "migrations")) +DRAIN_SECONDS = _float("DRAIN_SECONDS", 4.0) # после SIGTERM: readiness=503, сервер ещё принимает запросы +GRACEFUL_SHUTDOWN_SECONDS = _int("GRACEFUL_SHUTDOWN_SECONDS", 8) +KEEPALIVE_SECONDS = _int("KEEPALIVE_SECONDS", 5) +IDEMPOTENCY_TTL_SECONDS = _int("IDEMPOTENCY_TTL_SECONDS", 24 * 3600) + +# --- S3 / вложения (lab4) --- +S3_ENDPOINT = os.environ.get("S3_ENDPOINT", "") +S3_BUCKET = os.environ.get("S3_BUCKET", "messenger-attachments") +S3_REGION = os.environ.get("S3_REGION", "us-east-1") +S3_ACCESS_KEY = _secret("S3_ACCESS_KEY") +S3_SECRET_KEY = _secret("S3_SECRET_KEY") +S3_CONNECT_TIMEOUT = _float("S3_CONNECT_TIMEOUT", 2.0) +S3_READ_TIMEOUT = _float("S3_READ_TIMEOUT", 15.0) +S3_POOL = _int("S3_POOL", 20) +MAX_UPLOAD_BYTES = _int("MAX_UPLOAD_BYTES", 10 * 1024 * 1024) # 10 MiB = 10 485 760 +MAX_IMAGE_PIXELS = _int("MAX_IMAGE_PIXELS", 40_000_000) +UPLOAD_CONCURRENCY = _int("UPLOAD_CONCURRENCY", 4) # одновременных загрузок на реплику +UPLOAD_QUEUE = _int("UPLOAD_QUEUE", 16) # ожидающих загрузок; сверх — 429 +IMAGE_THREADS = _int("IMAGE_THREADS", 2) +DOWNLOAD_CHUNK_BYTES = _int("DOWNLOAD_CHUNK_BYTES", 65536) +ORPHAN_GRACE_SECONDS = _int("ORPHAN_GRACE_SECONDS", 900) # объект без метаданных моложе этого возраста не трогаем +FAULT_INJECTION = {x for x in os.environ.get("FAULT_INJECTION", "").split(",") if x} # db_after_put, s3_delete_fails (эксперименты) + +# --- lab5: брокер, outbox, worker --- +SERVICE_NAME = os.environ.get("SERVICE_NAME", "messenger-api") +BROKER_URL = _secret("BROKER_URL") +BROKER_TIMEOUT = _float("BROKER_TIMEOUT", 5.0) +RELAY_BATCH = _int("RELAY_BATCH", 50) +RELAY_INTERVAL = _float("RELAY_INTERVAL", 1.0) +WORKER_CONCURRENCY = _int("WORKER_CONCURRENCY", 2) # prefetch == число одновременных заданий == потоков обработки +LEASE_SECONDS = _int("LEASE_SECONDS", 60) # аренда задания; истекла -> sweeper возвращает в очередь +JOB_TIMEOUT = _float("JOB_TIMEOUT", 45.0) # лимит времени одной обработки (меньше lease) +MAX_ATTEMPTS = _int("MAX_ATTEMPTS", 5) +RETRY_BASE_DELAY = _float("RETRY_BASE_DELAY", 2.0) +RETRY_MAX_DELAY = _float("RETRY_MAX_DELAY", 60.0) +SWEEP_INTERVAL = _float("SWEEP_INTERVAL", 5.0) +STAGING_FAILED_RETENTION_SECONDS = _int("STAGING_FAILED_RETENTION_SECONDS", 7 * 24 * 3600) +MAX_QUEUED_JOBS = _int("MAX_QUEUED_JOBS", 200) # backpressure: при превышении upload -> 503 + Retry-After +BACKLOG_RETRY_AFTER_SECONDS = _int("BACKLOG_RETRY_AFTER_SECONDS", 5) + +# --- lab6: наблюдаемость --- +OTEL_ENABLED = os.environ.get("OTEL_ENABLED", "1") not in ("0", "false", "") +OTEL_ENDPOINT = os.environ.get("OTEL_EXPORTER_OTLP_ENDPOINT", "http://otel-collector:4318") +OTEL_TRACE_RATIO = _float("OTEL_TRACES_SAMPLER_ARG", 1.0) # head-sampling: доля трасс (ParentBased) +OTEL_METRIC_INTERVAL_MS = _int("OTEL_METRIC_EXPORT_INTERVAL", 5000) +OTEL_QUEUE_SIZE = _int("OTEL_QUEUE_SIZE", 2048) +OTEL_BATCH_SIZE = _int("OTEL_BATCH_SIZE", 512) # спанов в одном экспорте (max_export_batch_size) # ограниченная очередь SDK; при переполнении данные отбрасываются +SERVICE_VERSION = os.environ.get("APP_REVISION", "dev") +INSTANCE_ID = (os.environ.get("HOSTNAME") or "local")[:12] + +# Внедрение отказов в HTTP-путь для экспериментов наблюдаемости (по умолчанию пусто): "http500:0.02" — 2 % запросов дают 500; +# "slow:0.01:0.5" — 1 % запросов задерживаются на 0.5 с. Health-маршруты не затрагиваются. +def _fault_rate(prefix): + for item in FAULT_INJECTION: + if item.startswith(prefix + ":"): + return item.split(":")[1:] + return None +HTTP_FAULT_500 = _fault_rate("http500") +HTTP_FAULT_SLOW = _fault_rate("slow") diff --git a/src/app/db.py b/src/app/db.py new file mode 100644 index 0000000..849d12d --- /dev/null +++ b/src/app/db.py @@ -0,0 +1,88 @@ +"""PostgreSQL: ограниченный пул asyncpg, таймауты, перевод сбоев зависимости в 503.""" +import asyncio +from contextlib import asynccontextmanager + +import asyncpg + +from . import config, telemetry +from .web import log, unavailable + +DEPENDENCY_ERRORS = (asyncpg.PostgresConnectionError, asyncpg.InterfaceError, asyncpg.exceptions.OperatorInterventionError, + asyncpg.exceptions.InsufficientResourcesError, asyncio.TimeoutError, OSError) +_RETRYABLE = (asyncpg.ConnectionDoesNotExistError, asyncpg.InterfaceError, ConnectionResetError) + + +class Database: + def __init__(self): + self.pool = None + self.waiting = 0 + telemetry.gauge("db.client.connections.usage", self._usage, "{connection}", "Соединения пула PostgreSQL") + telemetry.gauge("db.client.connections.waiting", lambda: [(self.waiting, {})], "{request}", "Запросы, ожидающие соединение") + + def _usage(self): + if self.pool is None: + return [] + size, idle = self.pool.get_size(), self.pool.get_idle_size() + return [(size - idle, {"state": "used"}), (idle, {"state": "idle"})] + + async def start(self): + if not config.DATABASE_URL: + log("error", "database_url_missing") + return + # min_size=0: приложение стартует и без БД (readiness покажет 503), пул подключается лениво. + self.pool = await asyncpg.create_pool( + dsn=config.DATABASE_URL, min_size=0, max_size=config.DB_POOL_MAX, + command_timeout=config.DB_COMMAND_TIMEOUT, timeout=config.DB_CONNECT_TIMEOUT, + max_inactive_connection_lifetime=60, + server_settings={"application_name": "messenger-api", "timezone": "UTC"}) + + async def stop(self): + if self.pool: + try: + await asyncio.wait_for(self.pool.close(), 3) + except Exception: + self.pool.terminate() + + @asynccontextmanager + async def conn(self): + if self.pool is None: + raise unavailable("База данных не настроена") + try: + self.waiting += 1 + try: + acquired = await self.pool.acquire(timeout=config.DB_ACQUIRE_TIMEOUT) + finally: + self.waiting -= 1 + try: + with telemetry.child_span("db.connection", "client", {"db.system": "postgresql"}): + yield acquired + finally: + await self.pool.release(acquired) + except DEPENDENCY_ERRORS as exc: + log("warning", "db_unavailable", error_type=type(exc).__name__) + raise unavailable() from exc + + async def _run(self, method, sql, args, retry): + for attempt in (0, 1): + try: + async with self.conn() as c: + return await getattr(c, method)(sql, *args) + except Exception as exc: + if attempt == 0 and retry and isinstance(exc.__cause__, _RETRYABLE): + continue # разорванное соединение пула (рестарт БД): один повтор только для чтения + raise + + async def fetch(self, sql, *args): + return await self._run("fetch", sql, args, True) + + async def fetchrow(self, sql, *args, retry=True): + return await self._run("fetchrow", sql, args, retry) + + async def fetchval(self, sql, *args): + return await self._run("fetchval", sql, args, True) + + async def execute(self, sql, *args): + return await self._run("execute", sql, args, False) + + async def ping(self): + return await asyncio.wait_for(self.fetchval("SELECT 1"), 1.0) diff --git a/src/app/images.py b/src/app/images.py new file mode 100644 index 0000000..5c433ea --- /dev/null +++ b/src/app/images.py @@ -0,0 +1,102 @@ +"""Проверка загружаемых изображений ДО полного декодирования: сигнатура, формат Pillow, размеры, целостность. + +PNG/JPEG определяются по содержимому (а не по Content-Type). Лимит пикселей проверяется по заголовку, +поэтому «decompression bomb» отклоняется без декодирования. Целостность: PNG — verify() (CRC всех чанков, без +распаковки в память), JPEG — декодирование в режиме draft (1/8 размера => около 1/64 памяти). +""" +import struct +import zlib + +from PIL import Image, UnidentifiedImageError + +from . import config + +Image.MAX_IMAGE_PIXELS = None # лимит применяем сами по заголовку (ниже), без предупреждений Pillow +PNG_SIGNATURE = b"\x89PNG\r\n\x1a\n" + + +class ImageRejected(Exception): + def __init__(self, status, code, message): + super().__init__(message) + self.status, self.code, self.message = status, code, message + + +def sniff(head): + if head.startswith(PNG_SIGNATURE): + return "image/png" + if head[:3] == b"\xff\xd8\xff": + return "image/jpeg" + return None + + +def _check_png_stream(fileobj, width, height): + """Целостность потока IDAT без аллокации изображения: распаковка порциями, проверка конца потока и размера данных.""" + fileobj.seek(8) + inflater = zlib.decompressobj() + total, channels, bit_depth, interlaced = 0, 0, 0, 0 + while True: + head = fileobj.read(8) + if len(head) < 8: + raise ValueError("truncated") + length, kind = struct.unpack(">I4s", head) + if length > 0x7FFFFFFF: + raise ValueError("chunk") + if kind == b"IHDR": + data = fileobj.read(length) + bit_depth, color_type, _, _, interlaced = struct.unpack(">BBBBB", data[8:13]) + channels = {0: 1, 2: 3, 3: 1, 4: 2, 6: 4}[color_type] + fileobj.read(4) + elif kind == b"IDAT": + remaining = length + while remaining: + piece = fileobj.read(min(remaining, 65536)) + if not piece: + raise ValueError("truncated") + remaining -= len(piece) + pending = piece + while pending: + total += len(inflater.decompress(pending, 1 << 20)) + pending = inflater.unconsumed_tail + fileobj.read(4) + elif kind == b"IEND": + break + else: + fileobj.seek(length + 4, 1) + if not inflater.eof: + raise ValueError("zlib stream incomplete") + if not interlaced: + row = (width * channels * bit_depth + 7) // 8 + if total != height * (row + 1): + raise ValueError("unexpected image data size") + + +def validate(fileobj, declared_type): + """Возвращает (content_type, width, height) либо бросает ImageRejected (415 — не то/повреждено, 413 — много пикселей).""" + fileobj.seek(0) + detected = sniff(fileobj.read(16)) + if detected is None or detected != declared_type: + raise ImageRejected(415, "unsupported_media_type", "Содержимое не соответствует PNG/JPEG или заявленному Content-Type") + fileobj.seek(0) + try: + with Image.open(fileobj) as img: + width, height = img.size + fmt = img.format + except (UnidentifiedImageError, OSError, ValueError, SyntaxError, Image.DecompressionBombError): + raise ImageRejected(415, "unsupported_media_type", "Изображение повреждено или не поддерживается") from None + if fmt not in ("PNG", "JPEG") or width < 1 or height < 1: + raise ImageRejected(415, "unsupported_media_type", "Неподдерживаемый формат изображения") + if width * height > config.MAX_IMAGE_PIXELS: + raise ImageRejected(413, "payload_too_large", "Слишком много пикселей в изображении") + fileobj.seek(0) + try: + img = Image.open(fileobj) + if fmt == "PNG": + img.verify() + _check_png_stream(fileobj, width, height) + else: + img.draft("RGB", (max(1, width // 8), max(1, height // 8))) + img.load() + img.close() + except Exception: # любая ошибка декодера = повреждённый файл + raise ImageRejected(415, "unsupported_media_type", "Изображение повреждено") from None + return detected, width, height diff --git a/src/app/main.py b/src/app/main.py new file mode 100644 index 0000000..4575a0d --- /dev/null +++ b/src/app/main.py @@ -0,0 +1,464 @@ +"""ASGI-приложение мессенджера (lab2): REST API, PostgreSQL, сессии Bearer, кэш Valkey.""" +import asyncio +import contextlib +from concurrent.futures import ThreadPoolExecutor +import base64 +import binascii +import hashlib +import json +import os +import re +import time +import uuid + +import asyncpg + +from . import config, passwords, telemetry +from .attachments import AttachmentMixin, StreamResponse +from .db import DEPENDENCY_ERRORS, Database +from .broker import Broker +from .outbox import Relay +from .s3 import S3 +from .sessions import SessionCache, Sessions +from .web import (ApiError, Request, bad, dt_to_us, encode_cursor, format_dt, log, new_request_id, page_params, + parse_json_object, parse_uuid, respond, unavailable, us_to_dt, valid_text, USERNAME_RE) + +ROUTES = [ + ("health_live", re.compile(r"/health/live"), {"GET"}), + ("health_ready", re.compile(r"/health/ready"), {"GET"}), + ("users", re.compile(r"/api/v1/users"), {"POST"}), + ("users_me", re.compile(r"/api/v1/users/me"), {"GET"}), + ("create_session", re.compile(r"/api/v1/auth/sessions"), {"POST"}), + ("session_current", re.compile(r"/api/v1/auth/sessions/current"), {"DELETE"}), + ("chats", re.compile(r"/api/v1/chats"), {"GET", "POST"}), + ("chat", re.compile(r"/api/v1/chats/(?P[^/]+)"), {"GET"}), + ("messages", re.compile(r"/api/v1/chats/(?P[^/]+)/messages"), {"GET", "POST"}), + ("upload_attachment", re.compile(r"/api/v1/chats/(?P[^/]+)/attachments"), {"POST"}), + ("get_attachment", re.compile(r"/api/v1/attachments/(?P[^/]+)"), {"GET"}), + ("download_attachment", re.compile(r"/api/v1/attachments/(?P[^/]+)/content"), {"GET"}), +] +ROUTE_LABELS = { + "health_live": "/health/live", "health_ready": "/health/ready", "users": "/api/v1/users", + "users_me": "/api/v1/users/me", "create_session": "/api/v1/auth/sessions", + "session_current": "/api/v1/auth/sessions/current", "chats": "/api/v1/chats", + "chat": "/api/v1/chats/{chat_id}", "messages": "/api/v1/chats/{chat_id}/messages", + "upload_attachment": "/api/v1/chats/{chat_id}/attachments", "get_attachment": "/api/v1/attachments/{attachment_id}", + "download_attachment": "/api/v1/attachments/{attachment_id}/content", +} +TOKEN_RE = re.compile(r"[A-Za-z0-9_-]{32,128}") +IDEMPOTENCY_KEY_RE = re.compile(r"[A-Za-z0-9._:-]{1,128}") +BEARER = 'Bearer realm="messenger"' +BASIC = 'Basic realm="messenger", charset="UTF-8"' +# Идентификатор реплики: имя хоста контейнера (12 hex, == короткий ID контейнера) -> легко сопоставить с docker ps. +INSTANCE_ID = os.environ.get("INSTANCE_ID") or (os.environ.get("HOSTNAME") or uuid.uuid4().hex)[:12] + +MSG_ATTS = ("COALESCE((SELECT array_agg(ma.attachment_id ORDER BY ma.position) FROM message_attachments ma " + "WHERE ma.message_id = messages.id), '{}'::uuid[]) AS attachment_ids") +CHAT_SELECT = ("SELECT c.id, c.title, c.created_at, " + "(SELECT array_agg(m2.user_id ORDER BY m2.ord) FROM chat_members m2 WHERE m2.chat_id = c.id) AS member_ids ") + + +def user_json(row): + return {"id": str(row["id"]), "username": row["username"], "display_name": row["display_name"], + "created_at": format_dt(row["created_at"])} + + +def chat_json(row): + return {"id": str(row["id"]), "title": row["title"], "member_ids": [str(x) for x in row["member_ids"]], + "created_at": format_dt(row["created_at"])} + + +def message_json(row): + return {"id": str(row["id"]), "chat_id": str(row["chat_id"]), "sender_id": str(row["sender_id"]), + "text": row["text"], "created_at": format_dt(row["created_at"]), + "attachment_ids": [str(x) for x in (row["attachment_ids"] or [])]} + + +def unauthorized(challenge=BEARER, message="Требуется действительная сессия"): + return ApiError(401, "unauthorized", message, {"www-authenticate": challenge}) + + +class Messenger(AttachmentMixin): + def __init__(self): + self.db = Database() + self.s3 = S3() + self.broker = Broker() + self.relay = Relay(self.db, self.broker) + self.image_pool = ThreadPoolExecutor(max_workers=config.IMAGE_THREADS, thread_name_prefix="image") + self._init_attachments() + self.cache = SessionCache() + self.sessions = Sessions(self.db, self.cache) + self.inflight = 0 + self.draining = False + # Метрики очереди считает API (любая реплика), а не worker: при остановке worker алерт по возрасту задач продолжает работать. + self.queue_stats = (0, 0.0) + telemetry.gauge("messenger.queue.depth", lambda: [(self.queue_stats[0], {"queue.name": "attachment.process"})], "{job}", "queued + processing") + telemetry.gauge("messenger.queue.oldest_job_age", lambda: [(self.queue_stats[1], {"queue.name": "attachment.process"})], "s", "Возраст старейшего задания") + + # --- аутентификация ------------------------------------------------------ + @staticmethod + def bearer_token(req): + header = req.headers.get("authorization", "") + scheme, _, token = header.partition(" ") + if scheme.lower() != "bearer" or not TOKEN_RE.fullmatch(token.strip()): + raise unauthorized() + return token.strip() + + async def authenticate(self, req): + token = self.bearer_token(req) + user_id = await self.sessions.resolve(token) + if user_id is None: + raise unauthorized() + req.user_id, req.token = user_id, token + return user_id + + # --- обработчики ----------------------------------------------------------- + async def health_live(self, req, params): + return 200, {"status": "ok"} + + async def health_ready(self, req, params): + # Критичная зависимость — PostgreSQL. Valkey — необязательный кэш: его отказ не останавливает API. + if self.draining: + raise unavailable("Сервис останавливается") + try: + await self.db.ping() + except ApiError: + raise + except Exception: + raise unavailable() from None + return 200, {"status": "ok"} + + async def users(self, req, params): + req.require_json_media_type() + data = parse_json_object(await req.body(), {"username", "display_name", "password"}, + {"username", "display_name", "password"}) + username = data["username"] + if not isinstance(username, str) or not USERNAME_RE.fullmatch(username): + raise bad("username должен соответствовать [a-z0-9_]{3,32}") + display_name = valid_text(data["display_name"], "display_name", 100) + password = valid_text(data["password"], "password", 128, allow_empty=True) + if len(password) < 12: + raise bad("password должен содержать от 12 до 128 символов") + pw_hash = await passwords.hash_password(password) + row = await self.db.fetchrow( + "INSERT INTO users (id, username, display_name, password_hash) VALUES ($1, $2, $3, $4) " + "ON CONFLICT (username) DO NOTHING RETURNING id, username, display_name, created_at", + uuid.uuid4(), username, display_name, pw_hash) + if row is None: + raise ApiError(409, "conflict", "username уже занят") + return 201, user_json(row) + + async def users_me(self, req, params): + user_id = await self.authenticate(req) + row = await self.db.fetchrow("SELECT id, username, display_name, created_at FROM users WHERE id = $1", user_id) + if row is None: + raise unauthorized() + return 200, user_json(row) + + async def create_session(self, req, params): + header = req.headers.get("authorization", "") + scheme, _, value = header.partition(" ") + if scheme.lower() != "basic" or not value.strip(): + raise unauthorized(BASIC, "Неверные учётные данные") + try: + decoded = base64.b64decode(value.strip(), validate=True).decode("utf-8") + username, sep, password = decoded.partition(":") + if not sep: + raise ValueError + except (binascii.Error, ValueError, UnicodeDecodeError): + raise unauthorized(BASIC, "Неверные учётные данные") from None + row = None + if USERNAME_RE.fullmatch(username): + row = await self.db.fetchrow("SELECT id, username, display_name, created_at, password_hash FROM users " + "WHERE username = $1", username) + ok = await passwords.verify_password(row["password_hash"] if row else None, password) + if not ok: + raise unauthorized(BASIC, "Неверные учётные данные") + token, expires_at = await self.sessions.create(row["id"]) + return 201, {"token": token, "token_type": "Bearer", "expires_at": format_dt(expires_at), "user": user_json(row)} + + async def session_current(self, req, params): + await self.authenticate(req) + await self.sessions.revoke(req.token) + return 204, None + + async def chats(self, req, params): + user_id = await self.authenticate(req) + if req.method == "GET": + limit, after = page_params(req.query, "c", user_id) + if after is None: + rows = await self.db.fetch( + CHAT_SELECT + "FROM chat_members m JOIN chats c ON c.id = m.chat_id WHERE m.user_id = $1 " + "ORDER BY m.chat_created_at, m.chat_id LIMIT $2", user_id, limit + 1) + else: + rows = await self.db.fetch( + CHAT_SELECT + "FROM chat_members m JOIN chats c ON c.id = m.chat_id WHERE m.user_id = $1 " + "AND (m.chat_created_at, m.chat_id) > ($2, $3) ORDER BY m.chat_created_at, m.chat_id LIMIT $4", + user_id, us_to_dt(after[0]), uuid.UUID(after[1]), limit + 1) + more = len(rows) > limit + rows = rows[:limit] + cursor = encode_cursor("c", user_id, (dt_to_us(rows[-1]["created_at"]), str(rows[-1]["id"]))) if more else None + return 200, {"items": [chat_json(r) for r in rows], "next_cursor": cursor} + req.require_json_media_type() + data = parse_json_object(await req.body(), {"title", "member_ids"}, {"title", "member_ids"}) + title = valid_text(data["title"], "title", 100) + members = data["member_ids"] + if not isinstance(members, list) or not 1 <= len(members) <= 100: + raise bad("member_ids должен содержать от 1 до 100 элементов") + ids = [parse_uuid(m, "member_id") for m in members] + if len(set(ids)) != len(ids): + raise bad("member_ids содержит дубликаты") + if user_id not in ids: + raise bad("Создатель должен быть в member_ids") + chat_id = uuid.uuid4() + uuids = [uuid.UUID(i) for i in ids] + try: + async with self.db.conn() as c: + async with c.transaction(): # чат и участники создаются атомарно + # Существование участников проверяет внешний ключ chat_members.user_id: при неизвестном + # участнике вставка падает и откатывается вся транзакция, включая уже созданный чат. + created = await c.fetchval("INSERT INTO chats (id, title) VALUES ($1, $2) RETURNING created_at", + chat_id, title) + await c.execute( + "INSERT INTO chat_members (chat_id, user_id, chat_created_at, ord) " + "SELECT $1, u, $2, o FROM unnest($3::uuid[]) WITH ORDINALITY AS t(u, o)", + chat_id, created, uuids) + except asyncpg.ForeignKeyViolationError: + raise bad("Неизвестный участник") from None + return 201, {"id": str(chat_id), "title": title, "member_ids": ids, "created_at": format_dt(created)} + + async def _require_member(self, user_id, params): + chat_id = parse_uuid(params["chat_id"], "chat_id") + ok = await self.db.fetchval("SELECT 1 FROM chat_members WHERE chat_id = $1 AND user_id = $2", chat_id, user_id) + if not ok: + raise ApiError(404, "not_found", "Чат не найден") + return chat_id + + async def chat(self, req, params): + user_id = await self.authenticate(req) + chat_id = parse_uuid(params["chat_id"], "chat_id") + row = await self.db.fetchrow( + CHAT_SELECT + "FROM chats c JOIN chat_members m ON m.chat_id = c.id AND m.user_id = $2 WHERE c.id = $1", + chat_id, user_id) + if row is None: + raise ApiError(404, "not_found", "Чат не найден") + return 200, chat_json(row) + + async def messages(self, req, params): + user_id = await self.authenticate(req) + if req.method == "POST": + row = await self._post_message(req, parse_uuid(params["chat_id"], "chat_id"), user_id) + return 201, message_json(row) + chat_id = await self._require_member(user_id, params) + if req.method == "GET": + limit, after = page_params(req.query, "m", chat_id) + if after is None: + rows = await self.db.fetch( + "SELECT id, chat_id, sender_id, text, created_at, " + MSG_ATTS + " FROM messages WHERE chat_id = $1 " + "ORDER BY created_at, id LIMIT $2", chat_id, limit + 1) + else: + rows = await self.db.fetch( + "SELECT id, chat_id, sender_id, text, created_at, " + MSG_ATTS + " FROM messages WHERE chat_id = $1 " + "AND (created_at, id) > ($2, $3) ORDER BY created_at, id LIMIT $4", + chat_id, us_to_dt(after[0]), uuid.UUID(after[1]), limit + 1) + more = len(rows) > limit + rows = rows[:limit] + cursor = encode_cursor("m", chat_id, (dt_to_us(rows[-1]["created_at"]), str(rows[-1]["id"]))) if more else None + return 200, {"items": [message_json(r) for r in rows], "next_cursor": cursor} + + async def _post_message(self, req, chat_id, user_id): + # Сначала разбор запроса; ошибка валидации (400/415) возвращается только участнику чата — постороннему всегда 404. + try: + key = req.headers.get("idempotency-key", "") + if not IDEMPOTENCY_KEY_RE.fullmatch(key): + raise bad("Требуется заголовок Idempotency-Key ([A-Za-z0-9._:-]{1,128})") + req.require_json_media_type() + data = parse_json_object(await req.body(), {"text"}, {"text", "attachment_ids"}) + raw_atts = data.get("attachment_ids", []) + if not isinstance(raw_atts, list) or len(raw_atts) > 10: + raise bad("attachment_ids: массив до 10 элементов") + atts = [parse_uuid(a, "attachment_id") for a in raw_atts] + if len(set(atts)) != len(atts): + raise bad("attachment_ids содержит дубликаты") + text = valid_text(data["text"], "text", 4000, allow_empty=bool(atts)) + except ApiError: + await self._require_member(user_id, {"chat_id": chat_id}) + raise + # Нормализованное представление запроса: порядок ключей JSON не важен, отсутствие attachment_ids == []. + request_hash = hashlib.sha256(json.dumps({"text": text, "attachment_ids": atts}, sort_keys=True, + ensure_ascii=False).encode("utf-8")).digest() + row = await self.db.fetchrow("SELECT * FROM send_message($1, $2, $3, $4, $5, $6, $7)", uuid.UUID(chat_id), + uuid.UUID(user_id), key, request_hash, text, float(config.IDEMPOTENCY_TTL_SECONDS), + [uuid.UUID(a) for a in atts], retry=False) + if row["outcome"] == "not_member": + raise ApiError(404, "not_found", "Чат не найден") + if row["outcome"] == "attachment_not_found": + raise ApiError(404, "not_found", "Вложение не найдено") + if row["outcome"] == "attachment_failed": + raise ApiError(409, "conflict", "Вложение не удалось обработать") + if bytes(row["request_hash"]) != request_hash: + raise ApiError(409, "conflict", "Idempotency-Key уже использован с другим телом запроса") + return {"id": row["msg_id"], "chat_id": row["msg_chat"], "sender_id": row["msg_sender"], "text": row["msg_text"], + "created_at": row["msg_created"], "attachment_ids": row["msg_atts"]} + + # --- ASGI ---------------------------------------------------------------------- + async def __call__(self, scope, receive, send): + if scope["type"] == "lifespan": + return await self.lifespan(receive, send) + if scope["type"] != "http": + return + started = time.perf_counter() + request_id = new_request_id() + route_name, status, headers = "unknown", 500, {} + raw_headers = {k.decode("latin-1").lower(): v.decode("latin-1") for k, v in scope["headers"]} + carrier = {k: raw_headers[k] for k in ("traceparent", "tracestate") if k in raw_headers} + is_health = scope.get("path", "").startswith("/health") # проверки LB раз в секунду: без спанов и access-log (метрики остаются) + span_cm = (contextlib.nullcontext() if is_health else + telemetry.span("HTTP %s" % scope.get("method"), "server", {"http.request.method": scope.get("method")}, carrier)) + sp = span_cm.__enter__() + try: + req = Request(scope, receive, request_id) + handler, params, route_name = self.route(req.method, req.path) + telemetry.set_attr(sp, "http.route", ROUTE_LABELS.get(route_name, "unmatched")) + req.span = sp + if not route_name.startswith("health") and self.inflight >= config.MAX_INFLIGHT: + raise ApiError(429, "rate_limited", "Слишком много одновременных запросов", + {"retry-after": str(config.RETRY_AFTER_SECONDS)}) + self.inflight += 1 + try: + await asyncio.sleep(0) + if not route_name.startswith("health") and (config.HTTP_FAULT_500 or config.HTTP_FAULT_SLOW): + await self.inject_http_faults() + status, body = await handler(req, params) + finally: + self.inflight -= 1 + except ApiError as exc: + status, headers = exc.status, exc.headers + body = {"error": {"code": exc.code, "message": exc.message, "request_id": request_id}} + except DEPENDENCY_ERRORS as exc: + log("warning", "dependency_error", request_id=request_id, error_type=type(exc).__name__) + status, headers = 503, {"retry-after": str(config.RETRY_AFTER_SECONDS)} + body = {"error": {"code": "unavailable", "message": "Зависимость временно недоступна", "request_id": request_id}} + except Exception as exc: + log("error", "unhandled_exception", request_id=request_id, error_type=type(exc).__name__) + status = 500 + body = {"error": {"code": "internal_error", "message": "Внутренняя ошибка", "request_id": request_id}} + route_label = ROUTE_LABELS.get(route_name, "unmatched") + duration = time.perf_counter() - started + telemetry.set_attr(sp, "http.response.status_code", status) + telemetry.set_attr(sp, "http.request_id", request_id) + if sp is not None: + sp.update_name("HTTP %s %s" % (scope.get("method"), route_label)) + if status >= 500: + telemetry.mark_error(sp, "HTTP %d" % status) + telemetry.record_http(scope.get("method"), route_label, status, duration) + if isinstance(body, StreamResponse): + try: + await body.send(send, request_id, INSTANCE_ID) + except Exception as exc: # клиент оборвал загрузку/ошибка S3 посреди потока + log("warning", "stream_aborted", request_id=request_id, error_type=type(exc).__name__) + else: + await respond(send, status, body, request_id, headers, INSTANCE_ID) + if os.environ.get("ACCESS_LOG", "1") != "0" and (not is_health or status >= 500): + log("info", "request", request_id=request_id, method=scope.get("method"), + route=route_label, status=status, duration_ms=round(duration * 1000, 3)) + span_cm.__exit__(None, None, None) + + async def janitor(self): + """Удаляет давно просроченные ключи идемпотентности и сессии (безопасно запускать на каждой реплике).""" + import random + await asyncio.sleep(random.uniform(5, 30)) + while True: + try: + await self.db.execute("DELETE FROM idempotency_keys WHERE ctid IN (SELECT ctid FROM idempotency_keys " + "WHERE created_at < now() - make_interval(secs => $1) LIMIT 5000)", + float(config.IDEMPOTENCY_TTL_SECONDS) + 3600) + await self.db.execute("DELETE FROM sessions WHERE ctid IN (SELECT ctid FROM sessions " + "WHERE expires_at < now() - interval '1 day' LIMIT 5000)") + except Exception as exc: + log("warning", "janitor_failed", error_type=type(exc).__name__) + await asyncio.sleep(3600) + + async def queue_stats_loop(self): + while True: + try: + row = await self.db.fetchrow("SELECT count(*) AS n, coalesce(extract(epoch FROM now() - min(accepted_at)), 0) AS age " + "FROM attachments WHERE status IN ('queued', 'processing')") + self.queue_stats = (row["n"], float(row["age"])) + except Exception: + pass + await asyncio.sleep(2) + + @staticmethod + async def inject_http_faults(): + import random + if config.HTTP_FAULT_SLOW and random.random() < float(config.HTTP_FAULT_SLOW[0]): + await asyncio.sleep(float(config.HTTP_FAULT_SLOW[1])) + if config.HTTP_FAULT_500 and random.random() < float(config.HTTP_FAULT_500[0]): + raise RuntimeError("injected fault") + + def route(self, method, path): + for name, pattern, methods in ROUTES: + m = pattern.fullmatch(path) + if m: + if method not in methods: + raise ApiError(405, "invalid_request", "Метод не поддерживается", {"allow": ", ".join(sorted(methods))}) + return getattr(self, name), m.groupdict(), name + raise ApiError(404, "not_found", "Ресурс не найден") + + async def lifespan(self, receive, send): + while True: + event = await receive() + if event["type"] == "lifespan.startup": + telemetry.setup(config.SERVICE_NAME) + telemetry.process_metrics() + await self.db.start() + await self.cache.start() + await self.s3.start() + self._relay_task = asyncio.create_task(self.relay.run()) + self._queue_task = asyncio.create_task(self.queue_stats_loop()) + self._janitor = asyncio.create_task(self.janitor()) + log("info", "startup", env=config.APP_ENV, instance=INSTANCE_ID, revision=os.environ.get("APP_REVISION", "dev"), cache=bool(config.VALKEY_URL), + session_ttl=config.SESSION_TTL_SECONDS, pool_max=config.DB_POOL_MAX) + await send({"type": "lifespan.startup.complete"}) + elif event["type"] == "lifespan.shutdown": + self.draining = True + self._janitor.cancel() + await self.cache.stop() + telemetry.shutdown() + self.relay.stop() + self._relay_task.cancel() + self._queue_task.cancel() + await self.broker.stop() + await self.s3.stop() + await self.db.stop() + log("info", "shutdown") + await send({"type": "lifespan.shutdown.complete"}) + return + + +async def overloaded_app(scope, receive, send): + """Ответ uvicorn при превышении --limit-concurrency в контрактном формате.""" + if scope["type"] != "http": + return + request_id = new_request_id() + body = {"error": {"code": "unavailable", "message": "Сервер перегружен: слишком много соединений", + "request_id": request_id}} + await respond(send, 503, body, request_id, {"retry-after": str(config.RETRY_AFTER_SECONDS), "connection": "close"}, INSTANCE_ID) + + +def _install_overload_response(): + for name in ("uvicorn.protocols.http.httptools_impl", "uvicorn.protocols.http.h11_impl"): + try: + module = __import__(name, fromlist=["service_unavailable"]) + except ImportError: + continue + module.service_unavailable = overloaded_app + + +def create_app(): + _install_overload_response() + return Messenger() + + +app = create_app() diff --git a/src/app/migrate.py b/src/app/migrate.py new file mode 100644 index 0000000..e979d89 --- /dev/null +++ b/src/app/migrate.py @@ -0,0 +1,64 @@ +"""Применение версионируемых SQL-миграций: python -m app.migrate + +Свойства: + * повторный запуск ничего не делает (таблица schema_migrations); + * одновременный запуск нескольких экземпляров безопасен (advisory lock); + * каждая миграция — одна транзакция вместе с записью о применении; + * ждёт готовности PostgreSQL до MIGRATE_WAIT_SECONDS. +""" +import asyncio +import hashlib +import os +import sys +import time + +import asyncpg + +from . import config +from .web import log + +LOCK_ID = 7352001 + + +async def connect(deadline): + while True: + try: + return await asyncpg.connect(config.DATABASE_URL, timeout=3) + except (OSError, asyncpg.PostgresError, asyncio.TimeoutError) as exc: + if time.monotonic() > deadline: + raise + log("info", "waiting_for_database", error_type=type(exc).__name__) + await asyncio.sleep(1) + + +async def main(): + wait = float(os.environ.get("MIGRATE_WAIT_SECONDS", "60")) + conn = await connect(time.monotonic() + wait) + try: + await conn.execute("SELECT pg_advisory_lock($1)", LOCK_ID) + await conn.execute("CREATE TABLE IF NOT EXISTS schema_migrations (" + "version text PRIMARY KEY, checksum text NOT NULL, applied_at timestamptz NOT NULL DEFAULT now())") + applied = {r["version"]: r["checksum"] for r in await conn.fetch("SELECT version, checksum FROM schema_migrations")} + directory = os.path.abspath(config.MIGRATIONS_DIR) + files = sorted(f for f in os.listdir(directory) if f.endswith(".sql")) + count = 0 + for name in files: + sql = open(os.path.join(directory, name), encoding="utf-8").read() + checksum = hashlib.sha256(sql.encode("utf-8")).hexdigest() + if name in applied: + if applied[name] != checksum: + log("error", "migration_modified", version=name) + sys.exit(2) + continue + async with conn.transaction(): + await conn.execute(sql) + await conn.execute("INSERT INTO schema_migrations (version, checksum) VALUES ($1, $2)", name, checksum) + count += 1 + log("info", "migration_applied", version=name) + log("info", "migrations_done", applied=count, total=len(files)) + finally: + await conn.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/src/app/outbox.py b/src/app/outbox.py new file mode 100644 index 0000000..433e6b6 --- /dev/null +++ b/src/app/outbox.py @@ -0,0 +1,82 @@ +"""Transactional outbox: relay публикует задания из PostgreSQL в брокер. + +Гарантия: задание, зафиксированное в БД (COMMIT), будет опубликовано даже если процесс упал между COMMIT и publish. +Relay запускается в каждой реплике API и в worker; строки берутся `FOR UPDATE SKIP LOCKED`, поэтому одну строку +публикует один relay. Если процесс упадёт после подтверждения брокера, но до отметки published_at, задание будет +опубликовано повторно — доставка at-least-once, дубликаты безвредны (обработка идемпотентна). +""" +import asyncio +from datetime import timezone + +from . import config, telemetry +from .web import format_dt, log + +JOB_TYPE = "attachment.process.v1" + + +def job_message(row, carrier=None): + msg = {"schema_version": 1, "job_id": str(row["job_id"]), "type": JOB_TYPE, "attachment_id": str(row["attachment_id"]), + "pipeline_version": row["pipeline_version"], "attempt": row["attempt"], + "created_at": format_dt(row["created_at"].astimezone(timezone.utc))} + msg.update(carrier or {}) # traceparent / tracestate (W3C Trace Context) — поля схемы jobs.schema.json + return msg + + +class Relay: + def __init__(self, db, broker): + self.db, self.broker = db, broker + self._kick = asyncio.Event() + self._stop = False + self.last_error = None + + def kick(self): + self._kick.set() + + def stop(self): + self._stop = True + self._kick.set() + + async def relay_once(self): + published = 0 + async with self.db.conn() as c: + async with c.transaction(): + rows = await c.fetch( + "SELECT id, job_id, attachment_id, pipeline_version, attempt, created_at, traceparent, tracestate FROM outbox " + "WHERE published_at IS NULL AND available_at <= now() ORDER BY id LIMIT $1 FOR UPDATE SKIP LOCKED", + config.RELAY_BATCH) + for row in rows: + parent = {k: row[k] for k in ("traceparent", "tracestate") if row[k]} + # PRODUCER-спан — дочерний к спану запроса upload (контекст восстановлен из outbox) + with telemetry.span("attachment.process publish", "producer", + {"messaging.system": "rabbitmq", "messaging.destination.name": "attachment.process", + "messaging.operation": "publish", "outbox.attempt": row["attempt"]}, parent): + carrier = telemetry.current_carrier() or parent + await self.broker.publish(job_message(row, carrier), headers=carrier) + await c.execute("UPDATE outbox SET published_at = now() WHERE id = $1", row["id"]) + published += 1 + return published + + def headers_for(self, row): + return {} + + async def run(self): + delay = config.RELAY_INTERVAL + while not self._stop: + try: + n = await self.relay_once() + self.last_error = None + delay = config.RELAY_INTERVAL + if n >= config.RELAY_BATCH: + continue # возможно, есть ещё + except asyncio.CancelledError: + raise + except Exception as exc: + if self.last_error != type(exc).__name__: + log("warning", "outbox_relay_failed", error_type=type(exc).__name__) + self.last_error = type(exc).__name__ + delay = min(delay * 2, 10.0) # брокер/БД недоступны: пауза с ростом до 10 с, задания остаются в outbox + try: + await asyncio.wait_for(self._kick.wait(), delay) + except asyncio.TimeoutError: + pass + self._kick.clear() diff --git a/src/app/passwords.py b/src/app/passwords.py new file mode 100644 index 0000000..650e7b3 --- /dev/null +++ b/src/app/passwords.py @@ -0,0 +1,31 @@ +"""Хеширование паролей: Argon2id (библиотека argon2-cffi), вычисления вне event loop.""" +import asyncio +from concurrent.futures import ThreadPoolExecutor + +from argon2 import PasswordHasher +from argon2.exceptions import InvalidHashError, VerificationError, VerifyMismatchError + +from . import config + +_hasher = PasswordHasher(time_cost=config.ARGON2_TIME_COST, memory_cost=config.ARGON2_MEMORY_KIB, + parallelism=config.ARGON2_PARALLELISM) +_pool = ThreadPoolExecutor(max_workers=config.HASH_CONCURRENCY, thread_name_prefix="argon2") +# Для неизвестного username проверяем фиктивный хеш: время ответа не выдаёт существование пользователя. +_DUMMY = _hasher.hash("dummy-password-for-timing-equalisation") + + +async def hash_password(password): + return await asyncio.get_running_loop().run_in_executor(_pool, _hasher.hash, password) + + +def _verify(stored, password): + try: + return _hasher.verify(stored, password) + except (VerifyMismatchError, VerificationError, InvalidHashError): + return False + + +async def verify_password(stored, password): + """stored=None -> проверка фиктивного хеша, результат всегда False.""" + ok = await asyncio.get_running_loop().run_in_executor(_pool, _verify, stored or _DUMMY, password) + return ok and stored is not None diff --git a/src/app/pipeline.py b/src/app/pipeline.py new file mode 100644 index 0000000..a38af25 --- /dev/null +++ b/src/app/pipeline.py @@ -0,0 +1,97 @@ +"""Обработка изображений (pipeline_version=1): thumbnail, crop, optimized. + +Правила (contracts/README.md): + * thumbnail: JPEG, вписан в 256x256 с сохранением пропорций, БЕЗ увеличения, EXIF orientation применяется, alpha — на белый + фон; размеры округляются вниз, минимум 1 px (320x200 -> 256x160); качество 85, метаданные не сохраняются; + * crop: JPEG, центрированный квадрат 128x128 (маленькие исходники допускается увеличивать), качество 85; + * optimized: WebP, вписан в 1280x1280 без увеличения, quality=80 method=4, EXIF/ICC не сохраняются (ориентация применена). +Память: JPEG декодируется через draft (масштабирование при декодировании), число пикселей ограничено MAX_IMAGE_PIXELS. +""" +import hashlib +import io +import math + +from PIL import Image, ImageOps + +from . import config + +Image.MAX_IMAGE_PIXELS = None +PIPELINE_VERSION = 1 +JPEG_QUALITY = 85 +WEBP_QUALITY = 80 + + +class PermanentError(Exception): + """Постоянная ошибка входных данных: повтор не поможет (-> failed, error_code).""" + + def __init__(self, code): + super().__init__(code) + self.code = code + + +def _flatten(img): + """RGBA/LA/P с прозрачностью -> RGB на белом фоне.""" + if img.mode in ("RGBA", "LA") or (img.mode == "P" and "transparency" in img.info): + rgba = img.convert("RGBA") + background = Image.new("RGB", rgba.size, (255, 255, 255)) + background.paste(rgba, mask=rgba.getchannel("A")) + return background + return img.convert("RGB") + + +def _fit_size(width, height, box, upscale=False): + scale = min(box / width, box / height) + if not upscale: + scale = min(scale, 1.0) + return max(1, math.floor(width * scale)), max(1, math.floor(height * scale)) + + +def _encode(img, fmt, **params): + buf = io.BytesIO() + img.save(buf, fmt, **params) + data = buf.getvalue() + return data, hashlib.sha256(data).hexdigest() + + +def process(fileobj): + """Возвращает список вариантов: dict(name, content_type, data, sha256, width, height). Бросает PermanentError.""" + try: + fileobj.seek(0) + src = Image.open(fileobj) + fmt = src.format + width, height = src.size + if fmt not in ("PNG", "JPEG"): + raise PermanentError("invalid_image") + if width * height > config.MAX_IMAGE_PIXELS: + raise PermanentError("image_too_large") + if fmt == "JPEG" and width > 2560 and height > 2560: + # экономия памяти: JPEG декодируется сразу в масштабе 1/2 (результат всё равно вписывается в 1280x1280) + src.draft("RGB", (width // 2, height // 2)) + src.load() + img = ImageOps.exif_transpose(src) + except PermanentError: + raise + except MemoryError: + raise + except Exception: + raise PermanentError("invalid_image") from None + base = _flatten(img) + out = [] + # thumbnail + tw, th = _fit_size(base.width, base.height, 256) + thumb = base.resize((tw, th), Image.LANCZOS) if (tw, th) != base.size else base + data, sha = _encode(thumb, "JPEG", quality=JPEG_QUALITY, optimize=True) + out.append({"name": "thumbnail", "content_type": "image/jpeg", "data": data, "sha256": sha, "width": tw, "height": th}) + # crop 128x128 (центрированный квадрат) + side = min(base.width, base.height) + left, top = (base.width - side) // 2, (base.height - side) // 2 + crop = base.crop((left, top, left + side, top + side)).resize((128, 128), Image.LANCZOS) + data, sha = _encode(crop, "JPEG", quality=JPEG_QUALITY, optimize=True) + out.append({"name": "crop", "content_type": "image/jpeg", "data": data, "sha256": sha, "width": 128, "height": 128}) + # optimized WebP (прозрачность сохраняется) + opt_src = img.convert("RGBA") if (img.mode in ("RGBA", "LA") or (img.mode == "P" and "transparency" in img.info)) else base + ow, oh = _fit_size(opt_src.width, opt_src.height, 1280) + opt = opt_src.resize((ow, oh), Image.LANCZOS) if (ow, oh) != opt_src.size else opt_src + data, sha = _encode(opt, "WEBP", quality=WEBP_QUALITY, method=4) + out.append({"name": "optimized", "content_type": "image/webp", "data": data, "sha256": sha, "width": ow, "height": oh}) + return out diff --git a/src/app/reconcile.py b/src/app/reconcile.py new file mode 100644 index 0000000..ea4538c --- /dev/null +++ b/src/app/reconcile.py @@ -0,0 +1,91 @@ +"""Сверка S3 и PostgreSQL (reconcile): python -m app.reconcile [--apply] [--grace СЕКУНДЫ] [--prefix att/] + +Находит и (с --apply) безопасно исправляет расхождения двух хранилищ: + * orphan_object — объект в S3 без строки в attachments (сбой между записью в S3 и COMMIT метаданных, прерванная загрузка); + удаляется ТОЛЬКО если старше grace (по умолчанию ORPHAN_GRACE_SECONDS=900 с): свежий объект может быть + загрузкой, метаданные которой ещё не зафиксированы; + * missing_object — строка attachments (ready) без объекта в S3 (потеря/удаление объекта): строка НЕ удаляется, + статус -> failed, error_code=object_missing (сообщения со ссылкой остаются, скачивание даёт 409); + * size_mismatch — размер объекта не совпадает с size_bytes: статус -> failed, error_code=size_mismatch. +Режим по умолчанию — dry-run (ничего не меняет). Повторный запуск идемпотентен. Используемые (привязанные к сообщению) +вложения и свежие объекты не удаляются никогда: удаляются только объекты, у которых нет строки в БД. +Выход: JSON-отчёт со счётчиками и временем обхода. +""" +import argparse +import asyncio +import json +import time +from datetime import datetime, timedelta, timezone + +import asyncpg + +from . import config +from .s3 import S3 + + +async def reconcile(apply, grace, prefix): + started = time.perf_counter() + s3 = S3() + await s3.start() + conn = await asyncpg.connect(config.DATABASE_URL, timeout=5) + try: + t0 = time.perf_counter() + rows = await conn.fetch("SELECT id, s3_key, size_bytes, status, created_at FROM attachments") + db_ms = (time.perf_counter() - t0) * 1000 + by_key = {r["s3_key"]: r for r in rows} + t0 = time.perf_counter() + objects = {} + async for key, size, modified in s3.list_keys(prefix): + objects[key] = (size, modified) + list_ms = (time.perf_counter() - t0) * 1000 + now = datetime.now(timezone.utc) + cutoff = now - timedelta(seconds=grace) + report = {"mode": "apply" if apply else "dry-run", "grace_seconds": grace, "db_rows": len(rows), "s3_objects": len(objects), + "orphan_objects": [], "orphans_skipped_fresh": 0, "missing_objects": [], "size_mismatch": [], "fixed": {"deleted_orphans": 0, "marked_failed": 0}} + for key, (size, modified) in objects.items(): + row = by_key.get(key) + if row is None: + if modified < cutoff: + report["orphan_objects"].append(key) + else: + report["orphans_skipped_fresh"] += 1 + elif row["status"] == "ready" and row["size_bytes"] != size: + report["size_mismatch"].append(str(row["id"])) + for key, row in by_key.items(): + if key.startswith(prefix) and key not in objects and row["status"] == "ready" and row["created_at"] < cutoff: + report["missing_objects"].append(str(row["id"])) + if apply: + for key in report["orphan_objects"]: + # повторная проверка перед удалением: за время обхода строка могла появиться + if await conn.fetchval("SELECT 1 FROM attachments WHERE s3_key = $1", key) is None: + await s3.delete(key) + report["fixed"]["deleted_orphans"] += 1 + for ids, code in ((report["missing_objects"], "object_missing"), (report["size_mismatch"], "size_mismatch")): + for att_id in ids: + n = await conn.execute("UPDATE attachments SET status = 'failed', error_code = $2, updated_at = now() " + "WHERE id = $1 AND status = 'ready'", att_id, code) + report["fixed"]["marked_failed"] += int(n.split()[-1]) + report["timing_ms"] = {"db_query": round(db_ms, 1), "s3_listing": round(list_ms, 1), + "total": round((time.perf_counter() - started) * 1000, 1)} + return report + finally: + await conn.close() + await s3.stop() + + +def main(): + ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) + ap.add_argument("--apply", action="store_true", help="исправлять (по умолчанию dry-run)") + ap.add_argument("--grace", type=int, default=config.ORPHAN_GRACE_SECONDS) + ap.add_argument("--prefix", default="att/") + ap.add_argument("--max-listed", type=int, default=20, help="сколько идентификаторов печатать в отчёте") + args = ap.parse_args() + report = asyncio.run(reconcile(args.apply, args.grace, args.prefix)) + for k in ("orphan_objects", "missing_objects", "size_mismatch"): + report[k + "_count"] = len(report[k]) + report[k] = report[k][:args.max_listed] + print(json.dumps(report, ensure_ascii=False, indent=2)) + + +if __name__ == "__main__": + main() diff --git a/src/app/replay.py b/src/app/replay.py new file mode 100644 index 0000000..d3304c9 --- /dev/null +++ b/src/app/replay.py @@ -0,0 +1,70 @@ +"""Операторский replay и реестр неудавшихся заданий: python -m app.replay [list | replay | replay-all] + + list — реестр failed-вложений: id, error_code, число попыток, возраст, наличие staging; + replay — возвращает ТОЛЬКО failed-вложение в queued: новая попытка (attempt сбрасывается на 1), новый job_id, + запись в job_events (аудит), задание в outbox. Если у вложения уже есть варианты (ready/успешный + эффект), повторного исполнения не будет: вложение не в статусе failed -> replay отклоняется. +Эффекты защищены ключом (attachment_id, pipeline_version, name): даже повторное выполнение не создаёт второй набор вариантов. +""" +import argparse +import asyncio +import json +import sys +import uuid + +import asyncpg + +from . import config + + +async def list_failed(conn): + rows = await conn.fetch( + "SELECT id, error_code, attempt, staging_key IS NOT NULL AS has_staging, updated_at FROM attachments " + "WHERE status = 'failed' ORDER BY updated_at DESC LIMIT 200") + return [{"attachment_id": str(r["id"]), "error_code": r["error_code"], "attempt": r["attempt"], + "staging_present": r["has_staging"], "failed_at": r["updated_at"].isoformat()} for r in rows] + + +async def replay(conn, att_id): + async with conn.transaction(): + row = await conn.fetchrow("SELECT id, status, pipeline_version, staging_key FROM attachments WHERE id = $1 FOR UPDATE", att_id) + if row is None: + return {"attachment_id": str(att_id), "result": "not_found"} + if row["status"] != "failed": + return {"attachment_id": str(att_id), "result": "skipped", "reason": "status=%s (replay только для failed)" % row["status"]} + if not row["staging_key"]: + return {"attachment_id": str(att_id), "result": "skipped", "reason": "staging удалён по retention, исходник недоступен"} + job_id = uuid.uuid4() + await conn.execute("UPDATE attachments SET status = 'queued', error_code = NULL, attempt = 0, job_id = $2, lease_owner = NULL, " + "lease_expires_at = NULL, updated_at = now() WHERE id = $1", att_id, job_id) + await conn.execute("INSERT INTO outbox (job_id, attachment_id, pipeline_version, attempt) VALUES ($1, $2, $3, 1)", + job_id, att_id, row["pipeline_version"]) + await conn.execute("INSERT INTO job_events (attachment_id, job_id, event, attempt, detail) VALUES ($1, $2, 'operator_replay', 1, 'failed -> queued')", + att_id, job_id) + return {"attachment_id": str(att_id), "result": "requeued", "job_id": str(job_id)} + + +async def main_async(args): + conn = await asyncpg.connect(config.DATABASE_URL, timeout=5) + try: + if args.command == "list": + return await list_failed(conn) + if args.command == "replay": + return await replay(conn, uuid.UUID(args.attachment_id)) + return [await replay(conn, uuid.UUID(f["attachment_id"])) for f in await list_failed(conn)] + finally: + await conn.close() + + +def main(): + ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) + sub = ap.add_subparsers(dest="command", required=True) + sub.add_parser("list") + r = sub.add_parser("replay") + r.add_argument("attachment_id") + sub.add_parser("replay-all") + print(json.dumps(asyncio.run(main_async(ap.parse_args())), ensure_ascii=False, indent=2)) + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/src/app/s3.py b/src/app/s3.py new file mode 100644 index 0000000..9d70790 --- /dev/null +++ b/src/app/s3.py @@ -0,0 +1,92 @@ +"""Приватное S3-хранилище (MinIO) через aiobotocore: потоковая загрузка/скачивание, таймауты, перевод сбоев в 503.""" +import asyncio + +from aiobotocore.config import AioConfig +from aiobotocore.session import get_session +from botocore.exceptions import BotoCoreError, ClientError + +from . import config, telemetry +from .web import log, unavailable + +S3_ERRORS = (BotoCoreError, ClientError, asyncio.TimeoutError, OSError) + + +class S3: + def __init__(self): + self._ctx = None + self.client = None + + async def start(self): + if not config.S3_ENDPOINT: + log("error", "s3_endpoint_missing") + return + session = get_session() + self._ctx = session.create_client( + "s3", endpoint_url=config.S3_ENDPOINT, region_name=config.S3_REGION, + aws_access_key_id=config.S3_ACCESS_KEY, aws_secret_access_key=config.S3_SECRET_KEY, + config=AioConfig(connect_timeout=config.S3_CONNECT_TIMEOUT, read_timeout=config.S3_READ_TIMEOUT, + retries={"max_attempts": 2, "mode": "standard"}, max_pool_connections=config.S3_POOL, + s3={"addressing_style": "path"})) + self.client = await self._ctx.__aenter__() + + async def stop(self): + if self._ctx: + await self._ctx.__aexit__(None, None, None) + + def _check(self): + if self.client is None: + raise unavailable("Хранилище файлов не настроено") + + async def put(self, key, fileobj, content_type, size): + self._check() + try: + with telemetry.child_span("s3.put_object", "client", {"rpc.system": "aws-api", "rpc.method": "PutObject"}): + await self.client.put_object(Bucket=config.S3_BUCKET, Key=key, Body=fileobj, ContentType=content_type, + ContentLength=size) + except S3_ERRORS as exc: + log("warning", "s3_put_failed", error_type=type(exc).__name__) + raise unavailable("Хранилище файлов недоступно") from exc + + async def put_bytes(self, key, data, content_type): + self._check() + with telemetry.child_span("s3.put_object", "client", {"rpc.system": "aws-api", "rpc.method": "PutObject"}): + await self.client.put_object(Bucket=config.S3_BUCKET, Key=key, Body=data, ContentType=content_type) + + async def open_stream(self, key): + """Возвращает (stream, content_length). Вызывающий обязан закрыть stream.""" + self._check() + try: + with telemetry.child_span("s3.get_object", "client", {"rpc.system": "aws-api", "rpc.method": "GetObject"}): + resp = await self.client.get_object(Bucket=config.S3_BUCKET, Key=key) + except S3_ERRORS as exc: + log("warning", "s3_get_failed", error_type=type(exc).__name__) + raise unavailable("Хранилище файлов недоступно") from exc + return resp["Body"], resp["ContentLength"] + + async def delete(self, key): + self._check() + await self.client.delete_object(Bucket=config.S3_BUCKET, Key=key) + + async def head(self, key): + """Метаданные объекта или None, если его нет.""" + self._check() + try: + return await self.client.head_object(Bucket=config.S3_BUCKET, Key=key) + except ClientError as exc: + if exc.response.get("Error", {}).get("Code") in ("404", "NoSuchKey", "NotFound"): + return None + raise unavailable("Хранилище файлов недоступно") from exc + except S3_ERRORS as exc: + raise unavailable("Хранилище файлов недоступно") from exc + + async def ping(self): + self._check() + await asyncio.wait_for(self.client.head_bucket(Bucket=config.S3_BUCKET), 2.0) + + async def list_keys(self, prefix): + """Асинхронный итератор (key, size, last_modified) по префиксу — для сверки (reconcile).""" + self._check() + paginator = self.client.get_paginator("list_objects_v2") + async for page in paginator.paginate(Bucket=config.S3_BUCKET, Prefix=prefix): + for obj in page.get("Contents", []): + yield obj["Key"], obj["Size"], obj["LastModified"] diff --git a/src/app/s3_bootstrap.py b/src/app/s3_bootstrap.py new file mode 100644 index 0000000..6004a85 --- /dev/null +++ b/src/app/s3_bootstrap.py @@ -0,0 +1,85 @@ +"""Идемпотентный bootstrap S3: python -m app.s3_bootstrap (one-shot сервис s3-init при каждом `docker compose up`). + + 1) bucket создаётся администратором, если его ещё нет (повтор ничего не меняет); + 2) проверяется, что анонимный запрос к bucket отклоняется (private); + 3) проверяется, что отдельный ключ API (права только на этот bucket) может писать/читать/удалять и НЕ может создавать bucket. +Ключи читаются из файлов секретов; в вывод не попадают. Код выхода != 0, если любая проверка не пройдена. +""" +import asyncio +import os +import sys +import time +import urllib.error +import urllib.request + +from aiobotocore.config import AioConfig +from aiobotocore.session import get_session +from botocore.exceptions import ClientError + +from . import config + + +def secret(name): + path = os.environ.get(name + "_FILE") + with open(path, encoding="utf-8") as fh: + return fh.read().strip() + + +def client(session, access, secret_key): + return session.create_client("s3", endpoint_url=config.S3_ENDPOINT, region_name=config.S3_REGION, aws_access_key_id=access, + aws_secret_access_key=secret_key, + config=AioConfig(connect_timeout=3, read_timeout=10, retries={"max_attempts": 1}, + s3={"addressing_style": "path"})) + + +async def main(): + bucket = config.S3_BUCKET + session = get_session() + deadline = time.time() + 60 + async with client(session, secret("S3_ADMIN_ACCESS_KEY"), secret("S3_ADMIN_SECRET_KEY")) as admin: + while True: + try: + await admin.list_buckets() + break + except Exception as exc: + if time.time() > deadline: + print("S3 недоступен:", type(exc).__name__) + return 1 + await asyncio.sleep(1) + try: + await admin.head_bucket(Bucket=bucket) + print("bucket %s уже существует" % bucket) + except ClientError: + await admin.create_bucket(Bucket=bucket) + print("bucket %s создан" % bucket) + # приватность: запрос без подписи отклоняется + try: + urllib.request.urlopen("%s/%s/" % (config.S3_ENDPOINT, bucket), timeout=5) + print("ОШИБКА: bucket доступен анонимно") + return 2 + except urllib.error.HTTPError as exc: + if exc.code not in (401, 403): + print("ОШИБКА: анонимный доступ вернул %d, ожидался 401/403" % exc.code) + return 2 + print("анонимный доступ запрещён (HTTP %d)" % exc.code) + # ключ API: рабочие права на bucket, нет прав администратора + async with client(session, config.S3_ACCESS_KEY, config.S3_SECRET_KEY) as api: + key = "bootstrap-check/%d" % int(time.time()) + await api.put_object(Bucket=bucket, Key=key, Body=b"ok") + got = await (await api.get_object(Bucket=bucket, Key=key))["Body"].read() + await api.delete_object(Bucket=bucket, Key=key) + if got != b"ok": + print("ОШИБКА: чтение/запись ключом API") + return 3 + try: + await api.create_bucket(Bucket="not-allowed-" + str(int(time.time()))) + print("ОШИБКА: ключ API смог создать bucket (избыточные права)") + return 4 + except ClientError as exc: + print("ключ API ограничен одним bucket (create_bucket отклонён: %s)" % exc.response["Error"]["Code"]) + print("bootstrap завершён") + return 0 + + +if __name__ == "__main__": + sys.exit(asyncio.run(main())) diff --git a/src/app/serve.py b/src/app/serve.py new file mode 100644 index 0000000..9980988 --- /dev/null +++ b/src/app/serve.py @@ -0,0 +1,40 @@ +"""Точка входа: uvicorn с управляемым завершением (drain). + +SIGTERM -> readiness сразу 503 -> DRAIN_SECONDS продолжаем обслуживать запросы, пока балансировщик +исключает реплику -> uvicorn прекращает приём и дожидается текущих запросов (timeout_graceful_shutdown). +Так плановая остановка/rolling update не даёт ошибок клиентам. +""" +import signal +import threading + +import uvicorn + +from . import config +from .main import app +from .web import log + + +class DrainingServer(uvicorn.Server): + _draining = False + + def handle_exit(self, sig, frame): + if sig == signal.SIGTERM and not self._draining and config.DRAIN_SECONDS > 0: + self._draining = True + app.draining = True + log("info", "draining", seconds=config.DRAIN_SECONDS) + timer = threading.Timer(config.DRAIN_SECONDS, super().handle_exit, args=(sig, frame)) + timer.daemon = True + timer.start() + return + super().handle_exit(sig, frame) + + +def main(): + cfg = uvicorn.Config(app, host=config.APP_HOST, port=config.APP_PORT, workers=1, access_log=False, + log_level="warning", timeout_graceful_shutdown=config.GRACEFUL_SHUTDOWN_SECONDS, + timeout_keep_alive=config.KEEPALIVE_SECONDS, limit_concurrency=config.LIMIT_CONCURRENCY) + DrainingServer(cfg).run() + + +if __name__ == "__main__": + main() diff --git a/src/app/sessions.py b/src/app/sessions.py new file mode 100644 index 0000000..b07117c --- /dev/null +++ b/src/app/sessions.py @@ -0,0 +1,131 @@ +"""Сессии: PostgreSQL — источник истины; Valkey — кэш с TTL (read-through). + +Политики: + * токен — 256 бит из secrets; в БД и Valkey хранится только SHA-256 токена; + * expiry: expires_at в БД (по часам БД). В кэше TTL = min(остаток жизни, SESSION_CACHE_TTL_SECONDS); + * инвалидация: logout помечает revoked_at в БД и удаляет ключ в Valkey; + * Valkey недоступен -> кэш обходится (чтение из БД), анонимный запрос никогда не считается доверенным; + circuit breaker не даёт каждому запросу ждать таймаут; + * окно устаревания: если Valkey был недоступен во время logout, ключ может прожить до SESSION_CACHE_TTL_SECONDS. +""" +import hashlib +import secrets +import time + +from . import config +from .web import log + +try: + import redis.asyncio as aioredis +except ImportError: # кэш опционален + aioredis = None + + +def token_hash(token): + return hashlib.sha256(token.encode("ascii")).digest() + + +class SessionCache: + def __init__(self): + self.client = None + self.down_until = 0.0 + self.stats = {"hit": 0, "miss": 0, "error": 0} + + async def start(self): + if config.VALKEY_URL and aioredis: + self.client = aioredis.Redis.from_url(config.VALKEY_URL, socket_timeout=config.VALKEY_TIMEOUT, + socket_connect_timeout=config.VALKEY_TIMEOUT) + + async def stop(self): + if self.client: + await self.client.aclose() + + def _usable(self): + return self.client is not None and time.monotonic() >= self.down_until + + def _fail(self, exc): + self.stats["error"] += 1 + if time.monotonic() >= self.down_until: + log("warning", "session_cache_unavailable", error_type=type(exc).__name__) + self.down_until = time.monotonic() + config.VALKEY_BREAKER_SECONDS + + async def get(self, key): + if not self._usable(): + return None + try: + value = await self.client.get(b"s:" + key) + except Exception as exc: + self._fail(exc) + return None + self.stats["hit" if value is not None else "miss"] += 1 + return value + + async def put(self, key, value, ttl): + if not self._usable() or ttl <= 0: + return + try: + await self.client.set(b"s:" + key, value, ex=max(1, int(ttl))) + except Exception as exc: + self._fail(exc) + + async def delete(self, key): + if not self._usable(): + return + try: + await self.client.delete(b"s:" + key) + except Exception as exc: + self._fail(exc) + + async def ping(self): + if self.client is None: + return None + try: + return bool(await self.client.ping()) + except Exception: + return False + + +class Sessions: + def __init__(self, db, cache): + self.db, self.cache = db, cache + + @staticmethod + def _cache_value(user_id, expires_at): + return ("%s|%d" % (user_id, int(expires_at.timestamp() * 1000))).encode() + + async def create(self, user_id): + token = secrets.token_urlsafe(32) # 256 бит энтропии + digest = token_hash(token) + row = await self.db.fetchrow( + "INSERT INTO sessions (token_hash, user_id, expires_at) " + "VALUES ($1, $2, now() + make_interval(secs => $3)) RETURNING expires_at", + digest, user_id, float(config.SESSION_TTL_SECONDS)) + remaining = row["expires_at"].timestamp() - time.time() + await self.cache.put(digest, self._cache_value(user_id, row["expires_at"]), + min(remaining, config.SESSION_CACHE_TTL_SECONDS)) + return token, row["expires_at"] + + async def resolve(self, token): + """token -> user_id (str) либо None, если сессии нет/истекла/отозвана.""" + digest = token_hash(token) + cached = await self.cache.get(digest) + if cached is not None: + user_id, _, expires_ms = cached.decode().partition("|") + if int(expires_ms) > time.time() * 1000: + return user_id + await self.cache.delete(digest) + row = await self.db.fetchrow( + "SELECT user_id, expires_at FROM sessions " + "WHERE token_hash = $1 AND revoked_at IS NULL AND expires_at > now()", digest) + if row is None: + return None + user_id = str(row["user_id"]) + remaining = row["expires_at"].timestamp() - time.time() + await self.cache.put(digest, self._cache_value(user_id, row["expires_at"]), + min(remaining, config.SESSION_CACHE_TTL_SECONDS)) + return user_id + + async def revoke(self, token): + digest = token_hash(token) + await self.db.execute("UPDATE sessions SET revoked_at = now() WHERE token_hash = $1 AND revoked_at IS NULL", digest) + await self.cache.delete(digest) diff --git a/src/app/telemetry.py b/src/app/telemetry.py new file mode 100644 index 0000000..71ef9aa --- /dev/null +++ b/src/app/telemetry.py @@ -0,0 +1,229 @@ +"""Наблюдаемость (lab6): OpenTelemetry SDK — трассы, метрики, логи по OTLP/HTTP в Collector. + +Выключается переменной OTEL_ENABLED=0 (нужно для эксперимента «цена наблюдаемости»): тогда все функции — no-op и +накладных расходов на экспорт нет. Секреты, тела сообщений, токены и изображения в телеметрию не попадают: +в атрибутах только шаблон маршрута, метод, статус, тип задания и исход; ID объектов — только в логах/спанах +(не в labels метрик). + +Соответствие сигналов contracts/observability.md и имён метрик (после Prometheus-экспортёра Collector): + http.server.request.duration (s) -> http_server_request_duration_seconds_{bucket,sum,count} (HTTP requests = _count) + messenger.jobs.processed -> messenger_jobs_processed_total{job_type,outcome} + messenger.job.duration (s) -> messenger_job_duration_seconds_* + messenger.job.time_to_ready (s) -> messenger_job_time_to_ready_seconds_* (от приёма до ready) + messenger.queue.depth / .oldest_age -> messenger_queue_depth{queue_name}, messenger_queue_oldest_job_age_seconds + db.client.connections.usage/waiting -> db_client_connections_usage{state}, db_client_connections_waiting + messenger.worker.busy / .capacity -> messenger_worker_busy, messenger_worker_capacity + process.memory.rss / process.cpu.time -> process_memory_rss_bytes, process_cpu_time_seconds_total +""" +import contextlib +import json +import logging +import os +import time + +from . import config + +ENABLED = config.OTEL_ENABLED +_state = {"tracer": None, "meter": None, "logger": None, "propagator": None, "inst": {}} +HTTP_BUCKETS = [0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1.0, 2.5, 5.0, 10.0] +JOB_BUCKETS = [0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10, 30, 60] +TTR_BUCKETS = [0.1, 0.25, 0.5, 1, 2.5, 5, 10, 30, 60, 120, 300] + + +def setup(service_name): + """Инициализирует провайдеры. Вызывается один раз при старте процесса (API или worker).""" + if not ENABLED: + return + from opentelemetry import metrics, trace + from opentelemetry.exporter.otlp.proto.http._log_exporter import OTLPLogExporter + from opentelemetry.exporter.otlp.proto.http.metric_exporter import OTLPMetricExporter + from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter + from opentelemetry.propagate import get_global_textmap + from opentelemetry.sdk._logs import LoggerProvider, LoggingHandler + from opentelemetry.sdk._logs.export import BatchLogRecordProcessor + from opentelemetry.sdk.metrics import MeterProvider + from opentelemetry.sdk.metrics.export import PeriodicExportingMetricReader + from opentelemetry.sdk.metrics.view import ExplicitBucketHistogramAggregation, View + from opentelemetry.sdk.resources import Resource + from opentelemetry.sdk.trace import TracerProvider + from opentelemetry.sdk.trace.export import BatchSpanProcessor + from opentelemetry.sdk.trace.sampling import ParentBased, TraceIdRatioBased + + endpoint = config.OTEL_ENDPOINT.rstrip("/") + resource = Resource.create({"service.name": service_name, "service.version": config.SERVICE_VERSION, + "service.instance.id": config.INSTANCE_ID, "deployment.environment.name": "lab"}) + # --- трассы: head-sampling по доле (ParentBased: решение родителя, в т.ч. из traceparent брокера, сохраняется) + tp = TracerProvider(resource=resource, sampler=ParentBased(TraceIdRatioBased(config.OTEL_TRACE_RATIO))) + tp.add_span_processor(BatchSpanProcessor( + OTLPSpanExporter(endpoint=endpoint + "/v1/traces", timeout=3), + max_queue_size=config.OTEL_QUEUE_SIZE, max_export_batch_size=config.OTEL_BATCH_SIZE, schedule_delay_millis=2000, export_timeout_millis=3000)) + trace.set_tracer_provider(tp) + # --- метрики (histogram с явными границами, секунды) + views = [View(instrument_name="http.server.request.duration", aggregation=ExplicitBucketHistogramAggregation(HTTP_BUCKETS)), + View(instrument_name="messenger.job.duration", aggregation=ExplicitBucketHistogramAggregation(JOB_BUCKETS)), + View(instrument_name="messenger.job.time_to_ready", aggregation=ExplicitBucketHistogramAggregation(TTR_BUCKETS))] + reader = PeriodicExportingMetricReader(OTLPMetricExporter(endpoint=endpoint + "/v1/metrics", timeout=3), + export_interval_millis=config.OTEL_METRIC_INTERVAL_MS, export_timeout_millis=3000) + mp = MeterProvider(resource=resource, metric_readers=[reader], views=views) + metrics.set_meter_provider(mp) + # --- логи: стандартный logging -> OTLP (trace_id/span_id добавляются автоматически из активного спана) + lp = LoggerProvider(resource=resource) + lp.add_log_record_processor(BatchLogRecordProcessor(OTLPLogExporter(endpoint=endpoint + "/v1/logs", timeout=3), + max_queue_size=config.OTEL_QUEUE_SIZE, schedule_delay_millis=2000)) + logger = logging.getLogger("messenger") + logger.setLevel(logging.INFO) + logger.propagate = False + logger.addHandler(LoggingHandler(level=logging.INFO, logger_provider=lp)) + _state.update(tracer=trace.get_tracer("messenger"), meter=metrics.get_meter("messenger"), logger=logger, + propagator=get_global_textmap(), providers=(tp, mp, lp)) + m = _state["meter"] + _state["inst"] = { + "http": m.create_histogram("http.server.request.duration", unit="s", description="Длительность HTTP-запроса"), + "jobs": m.create_counter("messenger.jobs.processed", description="Обработанные задания по исходам"), + "job_dur": m.create_histogram("messenger.job.duration", unit="s", description="Длительность обработки задания"), + "ttr": m.create_histogram("messenger.job.time_to_ready", unit="s", description="От приёма загрузки до ready"), + } + for args in list(_pending_gauges): + (observable_counter if len(args) == 5 else gauge)(*args[:4]) + _pending_gauges.clear() + + +def shutdown(): + for p in _state.get("providers", ()): + try: + p.shutdown() + except Exception: + pass + + +# --- трассы ---------------------------------------------------------------------------------- +@contextlib.contextmanager +def span(name, kind="internal", attributes=None, carrier=None): + """Контекстный менеджер спана. carrier — dict с traceparent/tracestate для продолжения чужого trace.""" + if not ENABLED or _state["tracer"] is None: + yield None + return + from opentelemetry import trace + from opentelemetry.trace import SpanKind, Status, StatusCode + ctx = _state["propagator"].extract(carrier) if carrier else None + kinds = {"server": SpanKind.SERVER, "client": SpanKind.CLIENT, "producer": SpanKind.PRODUCER, + "consumer": SpanKind.CONSUMER, "internal": SpanKind.INTERNAL} + with _state["tracer"].start_as_current_span(name, context=ctx, kind=kinds[kind], attributes=attributes or {}, + record_exception=False, set_status_on_exception=False) as sp: + try: + yield sp + except Exception as exc: + sp.set_status(Status(StatusCode.ERROR, type(exc).__name__)) + sp.set_attribute("error.type", type(exc).__name__) + raise + + +def child_span(name, kind="internal", attributes=None): + """Спан создаётся только внутри активного спана (запрос/задание); фоновые опросы БД не порождают корневых трасс.""" + if not ENABLED or _state["tracer"] is None: + return contextlib.nullcontext() + from opentelemetry import trace + if not trace.get_current_span().get_span_context().is_valid: + return contextlib.nullcontext() + return span(name, kind, attributes) + + +def set_attr(sp, key, value): + if sp is not None: + sp.set_attribute(key, value) + + +def mark_error(sp, description): + if sp is not None: + from opentelemetry.trace import Status, StatusCode + sp.set_status(Status(StatusCode.ERROR, description)) + + +def current_carrier(): + """traceparent/tracestate текущего спана (для передачи через outbox/брокер).""" + if not ENABLED or _state["propagator"] is None: + return {} + carrier = {} + _state["propagator"].inject(carrier) + return carrier + + +def trace_ids(): + if not ENABLED: + return None, None + from opentelemetry import trace + ctx = trace.get_current_span().get_span_context() + if not ctx.is_valid: + return None, None + return "%032x" % ctx.trace_id, "%016x" % ctx.span_id + + +# --- метрики ---------------------------------------------------------------------------------- +def record_http(method, route, status, seconds): + if ENABLED and _state["inst"]: + _state["inst"]["http"].record(seconds, {"http.request.method": method, "http.route": route, + "http.response.status_code": status}) + + +def record_job(job_type, outcome, seconds, time_to_ready=None): + if ENABLED and _state["inst"]: + attrs = {"job.type": job_type, "outcome": outcome} + _state["inst"]["jobs"].add(1, attrs) + _state["inst"]["job_dur"].record(seconds, attrs) + if time_to_ready is not None: + _state["inst"]["ttr"].record(time_to_ready, {"job.type": job_type}) + + +_pending_gauges = [] + + +def gauge(name, callback, unit="1", description=""): + """Observable gauge: callback() -> [(value, {attrs})]. Регистрация откладывается до setup(), если провайдер ещё не создан.""" + if not ENABLED: + return + if _state["meter"] is None: + _pending_gauges.append((name, callback, unit, description)) + return + from opentelemetry.metrics import Observation + + def cb(_options): + try: + return [Observation(v, a) for v, a in callback()] + except Exception: + return [] + _state["meter"].create_observable_gauge(name, callbacks=[cb], unit=unit, description=description) + + +def observable_counter(name, callback, unit="1", description=""): + """Монотонный счётчик, значение которого читается при экспорте (например, накопленное CPU-время).""" + if not ENABLED or _state["meter"] is None: + _pending_gauges.append((name, callback, unit, description, "counter")) + return + from opentelemetry.metrics import Observation + + def cb(_options): + try: + return [Observation(v, a) for v, a in callback()] + except Exception: + return [] + _state["meter"].create_observable_counter(name, callbacks=[cb], unit=unit, description=description) + + +def process_metrics(): + def rss(): + try: + with open("/proc/self/statm") as fh: + return [(int(fh.read().split()[1]) * os.sysconf("SC_PAGE_SIZE"), {})] + except (OSError, ValueError): + return [] + gauge("process.memory.rss", rss, "By", "Резидентная память процесса") + observable_counter("process.cpu.time", lambda: [(time.process_time(), {})], "s", "Накопленное CPU-время процесса") + + +# --- логи --------------------------------------------------------------------------------------- +def emit_log(level, record): + """Отправляет запись в OTLP (если включено). record — dict без секретов.""" + if not ENABLED or _state["logger"] is None: + return + lvl = {"info": logging.INFO, "warning": logging.WARNING, "error": logging.ERROR}.get(level, logging.INFO) + _state["logger"].log(lvl, record.get("msg", ""), extra={k: v for k, v in record.items() if k not in ("msg", "level", "ts")}) diff --git a/src/app/web.py b/src/app/web.py new file mode 100644 index 0000000..cfd75a7 --- /dev/null +++ b/src/app/web.py @@ -0,0 +1,192 @@ +"""Общий HTTP-слой: ошибки, запрос, валидация, курсоры, ответы, журнал.""" +import base64 +import json +import re +import sys +import time +import uuid +from datetime import datetime, timedelta, timezone +from urllib.parse import parse_qsl + +from . import config, telemetry + +UUID_RE = re.compile(r"[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}") +USERNAME_RE = re.compile(r"[a-z0-9_]{3,32}") +LIMIT_RE = re.compile(r"[0-9]{1,9}") +EPOCH = datetime(1970, 1, 1, tzinfo=timezone.utc) + + +class ApiError(Exception): + def __init__(self, status, code, message, headers=None): + super().__init__(message) + self.status, self.code, self.message, self.headers = status, code, message, headers or {} + + +def bad(message): + return ApiError(400, "invalid_request", message) + + +def unavailable(message="Зависимость временно недоступна"): + return ApiError(503, "unavailable", message, {"retry-after": str(config.RETRY_AFTER_SECONDS)}) + + +def log(level, msg, **fields): + """Структурный лог: JSON в stdout + OTLP (если включено). trace_id/span_id — из активного спана; тела и токены не логируются.""" + record = {"ts": time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime()), "level": level, "service": config.SERVICE_NAME, "msg": msg} + trace_id, span_id = telemetry.trace_ids() + if trace_id: + record["trace_id"], record["span_id"] = trace_id, span_id + record.update(fields) + sys.stdout.write(json.dumps(record, ensure_ascii=False) + "\n") + sys.stdout.flush() + telemetry.emit_log(level, record) + + +# --- время ------------------------------------------------------------------- +def format_dt(value): + value = value.astimezone(timezone.utc) + return value.strftime("%Y-%m-%dT%H:%M:%S.") + "%06dZ" % value.microsecond + + +def dt_to_us(value): + return (value - EPOCH) // timedelta(microseconds=1) + + +def us_to_dt(us): + return EPOCH + timedelta(microseconds=us) + + +# --- валидация --------------------------------------------------------------- +def parse_uuid(value, what="id"): + if not isinstance(value, str) or not UUID_RE.fullmatch(value): + raise bad("Некорректный %s" % what) + return value.lower() + + +def valid_text(value, field, maximum, allow_empty=False): + if not isinstance(value, str): + raise bad("Поле %s должно быть строкой" % field) + try: + value.encode("utf-8") + except UnicodeEncodeError: + raise bad("Поле %s содержит некорректные символы" % field) from None + if "\x00" in value: + raise bad("Поле %s содержит NUL" % field) + if len(value) > maximum: + raise bad("Поле %s слишком длинное" % field) + if not allow_empty and not value.strip(): + raise bad("Поле %s не может быть пустым" % field) + return value + + +def _reject_constant(name): + raise ValueError(name) + + +def parse_json_object(raw, required, allowed): + try: + data = json.loads(raw.decode("utf-8"), parse_constant=_reject_constant) + except (UnicodeDecodeError, ValueError, RecursionError): + raise bad("Тело запроса — некорректный JSON") from None + if not isinstance(data, dict): + raise bad("Ожидается JSON-объект") + if set(data) - allowed: + raise bad("Лишние поля в запросе") + if any(key not in data for key in required): + raise bad("Не хватает обязательных полей") + return data + + +def encode_cursor(kind, resource, key): + payload = json.dumps({"k": kind, "r": resource, "t": key[0], "i": key[1]}, separators=(",", ":")) + return base64.urlsafe_b64encode(payload.encode()).decode().rstrip("=") + + +def decode_cursor(text, kind, resource): + try: + data = json.loads(base64.urlsafe_b64decode(text + "=" * (-len(text) % 4)).decode()) + if (not isinstance(data, dict) or data.get("k") != kind or data.get("r") != resource + or not isinstance(data.get("t"), int) or isinstance(data.get("t"), bool) + or not isinstance(data.get("i"), str) or not UUID_RE.fullmatch(data["i"]) + or not -62135596800000000 < data["t"] < 253402300799000000): + raise ValueError + return data["t"], data["i"] + except (ValueError, UnicodeError): + raise bad("Некорректный cursor") from None + + +def page_params(query, kind, resource): + limit, cursor = 50, None + if "limit" in query: + if len(query["limit"]) != 1 or not LIMIT_RE.fullmatch(query["limit"][0]): + raise bad("limit должен быть целым числом 1–100") + limit = int(query["limit"][0]) + if not 1 <= limit <= 100: + raise bad("limit должен быть целым числом 1–100") + if "cursor" in query: + if len(query["cursor"]) != 1 or not query["cursor"][0]: + raise bad("Некорректный cursor") + cursor = decode_cursor(query["cursor"][0], kind, resource) + return limit, cursor + + +def parse_query(raw): + result = {} + if raw: + for key, value in parse_qsl(raw.decode("latin-1"), keep_blank_values=True): + result.setdefault(key, []).append(value) + return result + + +class Request: + def __init__(self, scope, receive, request_id): + self.method = scope["method"] + self.path = scope["path"] + self.query = parse_query(scope.get("query_string", b"")) + self.headers = {k.decode("latin-1").lower(): v.decode("latin-1") for k, v in scope["headers"]} + self.receive = receive + self.request_id = request_id + self.user_id = None + + async def body(self): + declared = self.headers.get("content-length") + if declared is not None: + if not declared.isdigit(): + raise bad("Некорректный Content-Length") + if int(declared) > config.MAX_BODY_BYTES: + raise ApiError(413, "payload_too_large", "Тело запроса слишком большое", {"connection": "close"}) + chunks, size = [], 0 + while True: + event = await self.receive() + if event["type"] == "http.disconnect": + raise bad("Соединение закрыто клиентом") + chunk = event.get("body", b"") + size += len(chunk) + if size > config.MAX_BODY_BYTES: + raise ApiError(413, "payload_too_large", "Тело запроса слишком большое", {"connection": "close"}) + chunks.append(chunk) + if not event.get("more_body"): + return b"".join(chunks) + + def require_json_media_type(self): + media = self.headers.get("content-type", "").split(";")[0].strip().lower() + if media != "application/json": + raise ApiError(415, "unsupported_media_type", "Ожидается Content-Type: application/json") + + +async def respond(send, status, body, request_id, extra=None, instance_id=None): + payload = b"" if status == 204 else json.dumps(body, ensure_ascii=False, separators=(",", ":")).encode("utf-8") + headers = [(b"x-request-id", request_id.encode())] + if status != 204: + headers += [(b"content-type", b"application/json"), (b"content-length", str(len(payload)).encode())] + else: + headers.append((b"content-length", b"0")) + if instance_id: + headers.append((b"x-instance-id", instance_id.encode())) + headers += [(k.encode(), v.encode()) for k, v in (extra or {}).items()] + await send({"type": "http.response.start", "status": status, "headers": headers}) + await send({"type": "http.response.body", "body": payload}) + + +def new_request_id(): + return uuid.uuid4().hex diff --git a/src/app/worker.py b/src/app/worker.py new file mode 100644 index 0000000..ccad626 --- /dev/null +++ b/src/app/worker.py @@ -0,0 +1,345 @@ +"""Worker вложений: python -m app.worker + +Конвейер задания (jobs.schema.json, состояния — contracts/attachment-states.md): + claim (queued -> processing, lease) -> чтение staging -> варианты (Pillow, в потоках) -> запись в конечный S3-prefix + -> ОДНА транзакция: варианты + ready -> ack -> очистка staging. +Ack отправляется только после устойчивого эффекта (COMMIT результата). Повторная доставка уже готовой задачи — no-op с ack. +Временные ошибки: возврат в queued с backoff (экспоненциальный + jitter) через outbox; после MAX_ATTEMPTS — failed/retry_exhausted. +Постоянные ошибки (невалидное изображение): failed с error_code сразу. Зависшие processing возвращает sweeper по истечении lease. +""" +import asyncio +import json +import os +import random +import signal +import tempfile +import time +import uuid +from concurrent.futures import ThreadPoolExecutor + +import aio_pika + +from . import config, pipeline, telemetry +from .broker import QUEUE, Broker +from .db import Database +from .outbox import Relay +from .s3 import S3 +from .web import log + +WORKER_ID = "%s-%s" % ((os.environ.get("HOSTNAME") or "worker")[:12], uuid.uuid4().hex[:6]) + + +def backoff_seconds(attempt): + """Экспоненциальная задержка с полным jitter: случайное значение в [0, min(cap, base * 2^(attempt-1))].""" + ceiling = min(config.RETRY_MAX_DELAY, config.RETRY_BASE_DELAY * (2 ** max(0, attempt - 1))) + return random.uniform(ceiling * 0.5, ceiling) + + +class Worker: + def __init__(self): + self.db, self.s3, self.broker = Database(), S3(), Broker() + self.relay = Relay(self.db, self.broker) + self.pool = ThreadPoolExecutor(max_workers=config.WORKER_CONCURRENCY, thread_name_prefix="img") + self.busy = 0 + self.stopping = False + self.tasks = [] + telemetry.gauge("messenger.worker.busy", lambda: [(self.busy, {})], "{job}", "Задания в обработке") + telemetry.gauge("messenger.worker.capacity", lambda: [(config.WORKER_CONCURRENCY, {})], "{job}", "Ёмкость worker") + + # --- claim / finalize --------------------------------------------------------- + async def claim(self, job): + return await self.db.fetchrow( + "UPDATE attachments SET status = 'processing', lease_owner = $2, processing_started_at = now(), " + "lease_expires_at = now() + make_interval(secs => $3), attempt = $4, job_id = $5, updated_at = now() " + "WHERE id = $1 AND status = 'queued' AND pipeline_version <= $6 " + "RETURNING id, chat_id, staging_key, s3_key, content_type, size_bytes, attempt", + uuid.UUID(job["attachment_id"]), WORKER_ID, float(config.LEASE_SECONDS), job["attempt"], + uuid.UUID(job["job_id"]), job["pipeline_version"], retry=False) + + async def fail(self, att_id, job, code, event="failed"): + await self.db.execute( + "WITH u AS (UPDATE attachments SET status = 'failed', error_code = $2, lease_owner = NULL, lease_expires_at = NULL, " + "updated_at = now() WHERE id = $1 AND status = 'processing' AND lease_owner = $3 RETURNING id) " + "INSERT INTO job_events (attachment_id, job_id, event, attempt, detail) SELECT id, $4, $5, $6, $2 FROM u", + att_id, code, WORKER_ID, uuid.UUID(job["job_id"]), event, job["attempt"]) + + async def reschedule(self, att_id, job, reason): + """Временная ошибка: processing -> queued, новая запись outbox с отложенной публикацией (backoff + jitter).""" + nxt = job["attempt"] + 1 + if nxt > config.MAX_ATTEMPTS: + log("warning", "job_retry_exhausted", attachment_id=str(att_id), attempts=job["attempt"]) + await self.fail(att_id, job, "retry_exhausted", "retry_exhausted") + return + delay = backoff_seconds(job["attempt"]) + await self.db.execute( + "WITH u AS (UPDATE attachments SET status = 'queued', lease_owner = NULL, lease_expires_at = NULL, updated_at = now() " + "WHERE id = $1 AND status = 'processing' AND lease_owner = $2 RETURNING id, pipeline_version), " + "o AS (INSERT INTO outbox (job_id, attachment_id, pipeline_version, attempt, available_at, traceparent, tracestate) " + "SELECT $3, id, pipeline_version, $4, now() + make_interval(secs => $5), $7, $8 FROM u RETURNING 1) " + "INSERT INTO job_events (attachment_id, job_id, event, attempt, detail) SELECT id, $3, 'retry_scheduled', $4, $6 FROM u", + att_id, WORKER_ID, uuid.UUID(job["job_id"]), nxt, delay, reason, job.get("traceparent"), job.get("tracestate")) + log("info", "job_rescheduled", attachment_id=str(att_id), next_attempt=nxt, delay_seconds=round(delay, 2), reason=reason) + + async def publish_result(self, row, job, variants): + """Одна транзакция: варианты (идемпотентно) + ready. Только владелец lease может опубликовать результат.""" + async with self.db.conn() as c: + async with c.transaction(): + owner = await c.fetchval("SELECT 1 FROM attachments WHERE id = $1 AND status = 'processing' AND lease_owner = $2 " + "FOR UPDATE", row["id"], WORKER_ID) + if owner is None: + return False # lease потерян (sweeper вернул задачу): результат не публикуем, чужой повтор доделает + for v in variants: + await c.execute( + "INSERT INTO attachment_variants (attachment_id, pipeline_version, name, content_type, size_bytes, width, " + "height, sha256, s3_key) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9) " + "ON CONFLICT (attachment_id, pipeline_version, name) DO NOTHING", + row["id"], job["pipeline_version"], v["name"], v["content_type"], len(v["data"]), v["width"], v["height"], + v["sha256"], "att/%s/v%d/%s" % (row["id"], job["pipeline_version"], v["name"])) + await c.execute("UPDATE attachments SET status = 'ready', error_code = NULL, ready_at = now(), updated_at = now(), " + "lease_owner = NULL, lease_expires_at = NULL WHERE id = $1", row["id"]) + await c.execute("INSERT INTO job_events (attachment_id, job_id, event, attempt) VALUES ($1, $2, 'ready', $3)", + row["id"], uuid.UUID(job["job_id"]), job["attempt"]) + return True + + # --- обработка ---------------------------------------------------------------- + async def process(self, job): + att_id = uuid.UUID(job["attachment_id"]) + row = await self.claim(job) + if row is None: + state = await self.db.fetchval("SELECT status FROM attachments WHERE id = $1", att_id) + log("info", "job_noop", attachment_id=job["attachment_id"], status=state or "unknown") + telemetry.record_job("attachment.process.v1", "noop", 0.0) + return # ready/failed/processing у другого владельца/неизвестное вложение: идемпотентный no-op, ack + started = time.perf_counter() + outcome = "ready" + try: + await self.fault("after_claim") + stream, _ = await self.s3.open_stream(row["staging_key"]) + spool = tempfile.SpooledTemporaryFile(max_size=2 * 1024 * 1024) + try: + try: + while True: + chunk = await stream.read(256 * 1024) + if not chunk: + break + spool.write(chunk) + finally: + stream.close() + loop = asyncio.get_running_loop() + variants = await asyncio.wait_for(loop.run_in_executor(self.pool, pipeline.process, spool), config.JOB_TIMEOUT) + finally: + spool.close() + # оригинал и варианты в конечный prefix: ключи детерминированы, повторная запись перезаписывает те же байты + await self.copy_original(row) + for v in variants: + await self.s3.put_bytes("att/%s/v%d/%s" % (row["id"], job["pipeline_version"], v["name"]), v["data"], v["content_type"]) + await self.fault("after_s3_before_commit") + if not await self.publish_result(row, job, variants): + log("warning", "lease_lost", attachment_id=job["attachment_id"]) + return + await self.fault("after_commit_before_ack") + log("info", "job_ready", attachment_id=job["attachment_id"], attempt=job["attempt"], + duration_ms=round((time.perf_counter() - started) * 1000, 1)) + try: + await self.s3.delete(row["staging_key"]) # staging безопасно удалять после COMMIT результата + except Exception as exc: + log("warning", "staging_cleanup_failed", error_type=type(exc).__name__) + except pipeline.PermanentError as exc: + outcome = "failed" + await self.fail(att_id, job, exc.code) + log("warning", "job_failed", attachment_id=job["attachment_id"], error_code=exc.code) + except MemoryError: + outcome = "failed" + await self.fail(att_id, job, "processing_failed") + log("error", "job_failed_oom", attachment_id=job["attachment_id"]) + except asyncio.CancelledError: + raise + except InjectedCrash: + raise + except Exception as exc: # S3/БД/таймаут/неожиданное: временная ошибка + outcome = "retried" + await self.reschedule(att_id, job, type(exc).__name__) + finally: + ttr = None + if outcome == "ready": + ttr = await self.db.fetchval("SELECT extract(epoch FROM ready_at - accepted_at) FROM attachments WHERE id = $1 " + "AND status = 'ready'", att_id) + telemetry.record_job("attachment.process.v1", outcome, time.perf_counter() - started, float(ttr) if ttr is not None else None) + + async def copy_original(self, row): + stream, size = await self.s3.open_stream(row["staging_key"]) + spool = tempfile.SpooledTemporaryFile(max_size=2 * 1024 * 1024) + try: + while True: + chunk = await stream.read(256 * 1024) + if not chunk: + break + spool.write(chunk) + stream.close() + spool.seek(0) + await self.s3.put(row["s3_key"], spool, row["content_type"], size) + finally: + spool.close() + + async def fault(self, point): + """Точки внедрения сбоев для экспериментов (FAULT_INJECTION=crash:<точка> => процесс умирает мгновенно).""" + if "crash_once:" + point in config.FAULT_INJECTION: + marker = "/tmp/fault-%s.done" % point # сохраняется при рестарте того же контейнера -> сбой ровно один раз + if not os.path.exists(marker): + open(marker, "w").close() + log("error", "fault_crash_once", point=point) + os._exit(137) + if "crash:" + point in config.FAULT_INJECTION: + log("error", "fault_crash", point=point) + os._exit(137) + if "fail:" + point in config.FAULT_INJECTION: + raise OSError("injected failure at " + point) + + async def on_message(self, message): + try: + job = json.loads(message.body) + if (job.get("schema_version") != 1 or job.get("type") != "attachment.process.v1" + or not isinstance(job.get("attempt"), int) or not isinstance(job.get("pipeline_version"), int)): + raise ValueError("bad job") + uuid.UUID(job["attachment_id"]), uuid.UUID(job["job_id"]) + except Exception: + log("error", "job_unreadable") + await message.reject(requeue=False) # -> DLQ + return + self.busy += 1 + carrier = {k: job[k] for k in ("traceparent", "tracestate") if k in job} + try: + with telemetry.span("attachment.process process", "consumer", + {"messaging.system": "rabbitmq", "messaging.destination.name": "attachment.process", + "messaging.operation": "process", "job.type": job["type"], "job.attempt": job["attempt"]}, carrier): + await self.process(job) + await message.ack() + except InjectedCrash: + raise + except Exception as exc: + log("error", "job_unhandled", error_type=type(exc).__name__) + await message.nack(requeue=True) + finally: + self.busy -= 1 + + # --- sweeper ------------------------------------------------------------------- + async def sweep_once(self): + """Истёкший lease -> queued (новая попытка) или failed/retry_exhausted; чистка старого staging.""" + rows = await self.db.fetch( + "WITH exp AS (SELECT id FROM attachments WHERE status = 'processing' AND lease_expires_at < now() FOR UPDATE SKIP LOCKED), " + "u AS (UPDATE attachments a SET status = CASE WHEN a.attempt >= $1 THEN 'failed' ELSE 'queued' END, " + "error_code = CASE WHEN a.attempt >= $1 THEN 'retry_exhausted' ELSE NULL END, lease_owner = NULL, lease_expires_at = NULL, " + "updated_at = now() FROM exp WHERE a.id = exp.id RETURNING a.id, a.status, a.pipeline_version, a.attempt, a.job_id), " + "o AS (INSERT INTO outbox (job_id, attachment_id, pipeline_version, attempt, traceparent, tracestate) " + "SELECT COALESCE(job_id, gen_random_uuid()), id, pipeline_version, attempt + 1, " + "(SELECT traceparent FROM outbox WHERE attachment_id = u.id ORDER BY id DESC LIMIT 1), " + "(SELECT tracestate FROM outbox WHERE attachment_id = u.id ORDER BY id DESC LIMIT 1) FROM u WHERE status = 'queued' RETURNING 1), " + "e AS (INSERT INTO job_events (attachment_id, job_id, event, attempt, detail) SELECT id, job_id, 'lease_expired', attempt, status FROM u RETURNING 1) " + "SELECT id, status FROM u", config.MAX_ATTEMPTS) + for r in rows: + log("warning", "lease_expired", attachment_id=str(r["id"]), new_status=r["status"]) + if rows: + self.relay.kick() + + async def sweeper(self): + while not self.stopping: + try: + await self.sweep_once() + except Exception as exc: + log("warning", "sweeper_failed", error_type=type(exc).__name__) + await asyncio.sleep(config.SWEEP_INTERVAL) + + async def staging_janitor(self): + """Удаляет staging для ready (если не удалён после COMMIT) и для failed старше retention; текущую работу не трогает.""" + while not self.stopping: + await asyncio.sleep(max(30, config.SWEEP_INTERVAL * 6)) + try: + rows = await self.db.fetch( + "SELECT id, staging_key FROM attachments WHERE staging_key IS NOT NULL AND (status = 'ready' OR " + "(status = 'failed' AND updated_at < now() - make_interval(secs => $1))) LIMIT 200", + float(config.STAGING_FAILED_RETENTION_SECONDS)) + for r in rows: + await self.s3.delete(r["staging_key"]) + await self.db.execute("UPDATE attachments SET staging_key = NULL WHERE id = $1", r["id"]) + except Exception as exc: + log("warning", "staging_janitor_failed", error_type=type(exc).__name__) + + # --- жизненный цикл ------------------------------------------------------------ + async def connect_broker(self): + while not self.stopping: + try: + await self.broker.ensure(prefetch=config.WORKER_CONCURRENCY) + return + except Exception as exc: + log("warning", "broker_unavailable", error_type=type(exc).__name__) + await asyncio.sleep(2) + + async def consume(self): + while not self.stopping: + await self.connect_broker() + try: + queue = await self.broker.channel.declare_queue(QUEUE, durable=True, passive=True) + tag = await queue.consume(self.on_message) + log("info", "consuming", worker=WORKER_ID, prefetch=config.WORKER_CONCURRENCY) + while not self.stopping and not self.broker.channel.is_closed: + await asyncio.sleep(1) + if self.stopping: + await queue.cancel(tag) + return + except Exception as exc: + log("warning", "consume_failed", error_type=type(exc).__name__) + await asyncio.sleep(2) + + async def run(self): + telemetry.setup(config.SERVICE_NAME) + telemetry.process_metrics() + await self.db.start() + await self.s3.start() + log("info", "worker_started", worker=WORKER_ID, concurrency=config.WORKER_CONCURRENCY, lease=config.LEASE_SECONDS, + max_attempts=config.MAX_ATTEMPTS) + loop = asyncio.get_running_loop() + for sig in (signal.SIGTERM, signal.SIGINT): + try: + loop.add_signal_handler(sig, self.request_stop) + except NotImplementedError: + signal.signal(sig, lambda *_: self.request_stop()) + self.tasks = [asyncio.create_task(self.consume()), asyncio.create_task(self.relay.run()), + asyncio.create_task(self.sweeper()), asyncio.create_task(self.staging_janitor())] + beat = 0.0 + while not self.stopping: + if time.monotonic() - beat > 5: # heartbeat для HEALTHCHECK контейнера + beat = time.monotonic() + try: + with open("/tmp/worker.alive", "w") as fh: + fh.write(str(time.time())) + except OSError: + pass + await asyncio.sleep(0.5) + # graceful: перестаём брать новые задания, ждём текущие до GRACEFUL_SHUTDOWN_SECONDS + deadline = time.monotonic() + config.GRACEFUL_SHUTDOWN_SECONDS + while self.busy and time.monotonic() < deadline: + await asyncio.sleep(0.2) + self.relay.stop() + for t in self.tasks: + t.cancel() + await self.broker.stop() + await self.s3.stop() + await self.db.stop() + log("info", "worker_stopped", unfinished=self.busy) + telemetry.shutdown() + + def request_stop(self): + log("info", "worker_stopping") + self.stopping = True + + +class InjectedCrash(Exception): + pass + + +def main(): + asyncio.run(Worker().run()) + + +if __name__ == "__main__": + main() diff --git a/student-tests/fixtures/alpha.png b/student-tests/fixtures/alpha.png new file mode 100644 index 0000000000000000000000000000000000000000..975b70d929a134f58bb20d5c8adfb85a828b698c GIT binary patch literal 344 zcmeAS@N?(olHy`uVBq!ia0vp^CxAGGgAGU?ZmZ{JU|^K@ba4!+nDh4XM&1Jk0?dZi zzu(Vccvrl3zrsSsD|h00KFu>cTKt>AM@@i(sZn8s5ntakU%bV1>?kjDH!#E)JYD@< J);T3K0RZF|MVbHr literal 0 HcmV?d00001 diff --git a/student-tests/fixtures/exif_rot6.jpg b/student-tests/fixtures/exif_rot6.jpg new file mode 100644 index 0000000000000000000000000000000000000000..4443f106e1e4d9a4f272a6f3683eda7b9c4ca208 GIT binary patch literal 1604 zcmex=oK-pTLJOhg$tB|6hBb#tw zBD+$dh*9Ijg&fLG8xM*GUHqV8oK)1r$t5N(At|M*rmmr>WnyY(ZeeNV?BeR??&0Yb z91<+v*#~fzWVs-^OvvRzW@07 z3*;|G24;x2fF#6cX#Nre`iqH$g_(sNe5(%j`x{iFGU^-oqD{m*cF{;xdtuh$v>Gn}+; z`_HibKf{+NO+Z7>@$ci(Skyo)w%G^N^QGh;J2nkg{Ve|(PQU-d{GTCh-J+fK$h`es zHLm{|CM_2K&yZLDa)Fne~>u;G(U>}^XiHJyYoN8vIq6C1@eC;@5ujM|DVCn18CBp z2frUI>e65!5;LEEv8d}mgS-EO0xUY1SA6jQv+qB{0sC)Rue7HlbABv868}@nu>RZg zf3q9^mL918_1lESkWO8iF$SeTb#Ng@b=d#Wzp$PzdXENyk literal 0 HcmV?d00001 diff --git a/student-tests/fixtures/sample.jpg b/student-tests/fixtures/sample.jpg new file mode 100644 index 0000000000000000000000000000000000000000..6b1f3ef8186943531211a47fa5431eb36b849c7a GIT binary patch literal 24299 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 Hayb4U3Y~JT literal 0 HcmV?d00001 diff --git a/student-tests/fixtures/sample.png b/student-tests/fixtures/sample.png new file mode 100644 index 0000000000000000000000000000000000000000..e7c920789e90d16586ecff5029a87d1fc247b086 GIT binary patch literal 111817 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ðy=(TIZ6WiN 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 literal 0 HcmV?d00001 diff --git a/student-tests/fixtures/small.png b/student-tests/fixtures/small.png new file mode 100644 index 0000000000000000000000000000000000000000..caadb26e3f5b07f788baaa11d57825e6843ce288 GIT binary patch literal 132 zcmeAS@N?(olHy`uVBq!ia0vp^MnEjb!2~298sAzCq`W;{978JRoIPjA$e_S;V8f;2 uf2<0k%zv^)o}7`bQt_NbB)Y@*$9Ad$!-vuut4ly*89ZJ6T-G@yGywov94Mv$ literal 0 HcmV?d00001 diff --git a/student-tests/test_api.py b/student-tests/test_api.py new file mode 100644 index 0000000..46e5e76 --- /dev/null +++ b/student-tests/test_api.py @@ -0,0 +1,208 @@ +"""Собственные тесты lab2 против запущенного стенда (docker compose up -d). + + python -m unittest discover -s student-tests -v # BASE_URL по умолчанию http://127.0.0.1:8080 +Тесты используют только синтетические данные и ничего не удаляют. Проверки expiry и недоступности +зависимостей лежат отдельно (test_expiry.py, test_dependencies.py): они управляют контейнерами. +""" +import base64 +import json +import os +import subprocess +import unittest +import urllib.error +import urllib.request +import uuid +from concurrent.futures import ThreadPoolExecutor +from urllib.parse import quote + +BASE = os.environ.get("BASE_URL", "http://127.0.0.1:8080").rstrip("/") +ROOT = os.path.join(os.path.dirname(__file__), "..") + + +def call(method, path, body=None, token=None, headers=None, raw=None): + h = dict(headers or {}) + if method == "POST" and path.endswith("/messages") and headers is None: + h["Idempotency-Key"] = uuid.uuid4().hex # lab3: ключ обязателен; тесты без ключа — в test_idempotency.py + data = raw + if body is not None: + data = json.dumps(body, ensure_ascii=False).encode("utf-8") + h.setdefault("Content-Type", "application/json") + if token: + h["Authorization"] = "Bearer " + token + req = urllib.request.Request(BASE + path, data=data, headers=h, method=method) + try: + with urllib.request.urlopen(req, timeout=10) as resp: + status, hdrs, payload = resp.status, resp.headers, resp.read() + except urllib.error.HTTPError as err: + status, hdrs, payload = err.code, err.headers, err.read() + return status, hdrs, (json.loads(payload) if payload else None) + + +def basic(username, password): + return {"Authorization": "Basic " + base64.b64encode((username + ":" + password).encode("utf-8")).decode()} + + +def register(prefix="u"): + name = "%s_%s" % (prefix, uuid.uuid4().hex[:12]) + password = "Pa55:word-" + uuid.uuid4().hex # двоеточие в пароле допустимо + status, _, user = call("POST", "/api/v1/users", {"username": name, "display_name": "Имя " + name, "password": password}) + assert status == 201, user + status, _, session = call("POST", "/api/v1/auth/sessions", headers=basic(name, password)) + assert status == 201, session + return {"user": user, "password": password, "token": session["token"], "session": session} + + +def psql(sql): + out = subprocess.run(["docker", "compose", "--env-file", ".env", "exec", "-T", "postgres", "psql", "-U", "messenger", + "-d", "messenger", "-Atc", sql], cwd=ROOT, capture_output=True, text=True, check=True) + return out.stdout.strip() + + +class AuthTest(unittest.TestCase): + def assertError(self, result, status, code): + self.assertEqual(result[0], status, result[2]) + self.assertEqual(result[2]["error"]["code"], code) + self.assertEqual(result[2]["error"]["request_id"], result[1]["X-Request-Id"]) + + def test_register_validation(self): + base = {"username": "val_" + uuid.uuid4().hex[:8], "display_name": "x", "password": "p" * 12} + for patch in ({"password": "short"}, {"password": "p" * 129}, {"password": 12345678901234}, {"extra": 1}, + {"username": "BAD"}, {"display_name": " "}): + body = dict(base, **patch) + self.assertError(call("POST", "/api/v1/users", body), 400, "invalid_request") + missing = {k: v for k, v in base.items() if k != "password"} + self.assertError(call("POST", "/api/v1/users", missing), 400, "invalid_request") + self.assertEqual(call("POST", "/api/v1/users", dict(base, password="я" * 12))[0], 201) # 12 code points + + def test_password_is_not_exposed_or_stored_plain(self): + actor = register() + self.assertEqual(set(actor["user"]), {"id", "username", "display_name", "created_at"}) + stored = psql("SELECT password_hash FROM users WHERE username = '%s'" % actor["user"]["username"]) + self.assertTrue(stored.startswith("$argon2id$"), stored[:12]) + self.assertNotIn(actor["password"], stored) + + def test_wrong_password_and_unknown_user_are_indistinguishable(self): + actor = register() + wrong = call("POST", "/api/v1/auth/sessions", headers=basic(actor["user"]["username"], "wrong-password-123")) + unknown = call("POST", "/api/v1/auth/sessions", headers=basic("nobody_" + uuid.uuid4().hex[:8], "wrong-password-123")) + for r in (wrong, unknown): + self.assertError(r, 401, "unauthorized") + self.assertEqual(r[1]["WWW-Authenticate"], 'Basic realm="messenger", charset="UTF-8"') + self.assertEqual(wrong[2]["error"]["message"], unknown[2]["error"]["message"]) + for bad in ({}, {"Authorization": "Basic !!!"}, {"Authorization": "Basic " + base64.b64encode(b"nocolon").decode()}, + {"Authorization": "Bearer abc"}): + self.assertEqual(call("POST", "/api/v1/auth/sessions", headers=bad)[0], 401) + + def test_bearer_rules(self): + actor = register() + self.assertEqual(call("GET", "/api/v1/users/me", token=actor["token"])[2], actor["user"]) + for headers in ({}, basic(actor["user"]["username"], actor["password"]), {"X-User-Id": actor["user"]["id"]}, + {"Authorization": "Bearer " + "A" * 43}, {"Authorization": "Bearer short"}): + r = call("GET", "/api/v1/users/me", headers=headers) + self.assertError(r, 401, "unauthorized") + self.assertEqual(r[1]["WWW-Authenticate"], 'Bearer realm="messenger"') + other = register() + me = call("GET", "/api/v1/users/me", token=actor["token"], headers={"X-User-Id": other["user"]["id"]})[2] + self.assertEqual(me["id"], actor["user"]["id"]) # X-User-Id игнорируется + + def test_session_shape_entropy_and_logout(self): + actor = register() + s = actor["session"] + self.assertEqual(s["token_type"], "Bearer") + self.assertGreaterEqual(len(s["token"]), 43) # 32 байта в base64url = 256 бит + self.assertNotIn(actor["user"]["id"], s["token"]) + self.assertNotEqual(register()["token"], s["token"]) + self.assertEqual(call("DELETE", "/api/v1/auth/sessions/current", token=s["token"])[0], 204) + self.assertError(call("GET", "/api/v1/users/me", token=s["token"]), 401, "unauthorized") + self.assertError(call("DELETE", "/api/v1/auth/sessions/current", token=s["token"]), 401, "unauthorized") + + def test_logout_revokes_in_database_and_cache(self): + actor = register() + call("GET", "/api/v1/users/me", token=actor["token"]) # прогреваем кэш + call("DELETE", "/api/v1/auth/sessions/current", token=actor["token"]) + revoked = psql("SELECT count(*) FROM sessions s JOIN users u ON u.id = s.user_id " + "WHERE u.username = '%s' AND s.revoked_at IS NOT NULL" % actor["user"]["username"]) + self.assertEqual(revoked, "1") + + def test_token_only_stored_as_hash(self): + actor = register() + count = psql("SELECT count(*) FROM sessions WHERE token_hash = '\\x00'::bytea OR encode(token_hash,'escape') = '%s'" % actor["token"]) + self.assertEqual(count, "0") + + def test_concurrent_registration_of_same_username(self): + name = "race_" + uuid.uuid4().hex[:10] + body = {"username": name, "display_name": "x", "password": "racing-password-1"} + with ThreadPoolExecutor(12) as pool: + codes = sorted(pool.map(lambda _: call("POST", "/api/v1/users", body)[0], range(12))) + self.assertEqual(codes, [201] + [409] * 11) + self.assertEqual(psql("SELECT count(*) FROM users WHERE username = '%s'" % name), "1") + + +class DataTest(unittest.TestCase): + def test_chat_creation_is_atomic(self): + a = register() + before = psql("SELECT (SELECT count(*) FROM chats) || '/' || (SELECT count(*) FROM chat_members)") + ghost = str(uuid.uuid4()) + r = call("POST", "/api/v1/chats", {"title": "откат", "member_ids": [a["user"]["id"], ghost]}, token=a["token"]) + self.assertEqual(r[0], 400) + after = psql("SELECT (SELECT count(*) FROM chats) || '/' || (SELECT count(*) FROM chat_members)") + self.assertEqual(before, after, "после неудачного создания не должно остаться чата или участников") + ok = call("POST", "/api/v1/chats", {"title": "ок", "member_ids": [a["user"]["id"]]}, token=a["token"]) + self.assertEqual(ok[0], 201) + + def test_foreign_chat_empty_message_bad_json(self): + a, b, eve = register(), register(), register() + chat = call("POST", "/api/v1/chats", {"title": "ЛС", "member_ids": [a["user"]["id"], b["user"]["id"]]}, a["token"])[2] + path = "/api/v1/chats/%s/messages" % chat["id"] + self.assertEqual(call("POST", path, {"text": "чужое"}, eve["token"])[0], 404) + self.assertEqual(call("GET", path, token=eve["token"])[0], 404) + self.assertEqual(call("POST", path, {"text": " "}, a["token"])[0], 400) + self.assertEqual(call("POST", path, raw=b"{oops", token=a["token"], headers={"Content-Type": "application/json"})[0], 400) + self.assertEqual(call("POST", path, {"text": "x", "sender_id": b["user"]["id"]}, a["token"])[0], 400) + sent = call("POST", path, {"text": "Привет 👋"}, a["token"])[2] + self.assertEqual(sent["sender_id"], a["user"]["id"]) + + def test_multi_page_history_and_cursor_binding(self): + a, b = register(), register() + chat = call("POST", "/api/v1/chats", {"title": "стр", "member_ids": [a["user"]["id"], b["user"]["id"]]}, a["token"])[2] + other = call("POST", "/api/v1/chats", {"title": "др", "member_ids": [a["user"]["id"]]}, a["token"])[2] + path = "/api/v1/chats/%s/messages" % chat["id"] + sent = [call("POST", path, {"text": "m%d" % i}, (a if i % 2 else b)["token"])[2] for i in range(23)] + walked, cursor, pages = [], None, 0 + while True: + q = "?limit=%d" % (5 if pages % 2 == 0 else 8) + ("&cursor=" + quote(cursor, safe="") if cursor else "") + page = call("GET", path + q, token=b["token"])[2] + walked += page["items"] + pages += 1 + cursor = page["next_cursor"] + if not cursor: + break + self.assertEqual(walked, sent) + self.assertGreaterEqual(pages, 3) + first = call("GET", path + "?limit=1", token=a["token"])[2]["next_cursor"] + r = call("GET", "/api/v1/chats/%s/messages?cursor=%s" % (other["id"], quote(first, safe="")), token=a["token"]) + self.assertEqual(r[0], 400) + + def test_parallel_writes_from_many_clients(self): + users = [register() for _ in range(5)] + chat = call("POST", "/api/v1/chats", {"title": "гонки", "member_ids": [u["user"]["id"] for u in users]}, users[0]["token"])[2] + path = "/api/v1/chats/%s/messages" % chat["id"] + + def client(u): + return [call("POST", path, {"text": "%s-%d" % (u["user"]["username"], i)}, u["token"])[0] for i in range(20)] + + with ThreadPoolExecutor(5) as pool: + codes = [c for part in pool.map(client, users) for c in part] + self.assertEqual(codes, [201] * 100) + total, cursor = [], None + while True: + page = call("GET", path + "?limit=100" + ("&cursor=" + quote(cursor, safe="") if cursor else ""), token=users[0]["token"])[2] + total += page["items"] + cursor = page["next_cursor"] + if not cursor: + break + self.assertEqual(len({m["id"] for m in total}), 100) + + +if __name__ == "__main__": + unittest.main() diff --git a/student-tests/test_attachments.py b/student-tests/test_attachments.py new file mode 100644 index 0000000..b7fcf4b --- /dev/null +++ b/student-tests/test_attachments.py @@ -0,0 +1,205 @@ +"""Собственные тесты вложений lab6 (негативные сценарии и права). Запуск: + python -m unittest discover -s student-tests -p "test_attachments.py" -v (BASE_URL по умолчанию http://127.0.0.1:8080) +""" +import hashlib +import json +import os +import socket +import struct +import sys +import time +import unittest +import urllib.error +import urllib.parse +import urllib.request +import uuid +import zlib + +sys.path.insert(0, os.path.dirname(__file__)) +from test_api import BASE, ROOT, call, psql, register # noqa: E402 + +FIX = os.path.join(os.path.dirname(__file__), "fixtures") +PNG = open(os.path.join(FIX, "sample.png"), "rb").read() +JPG = open(os.path.join(FIX, "sample.jpg"), "rb").read() + + +def upload(token, chat_id, data, ctype="image/png", filename="sample.png", raw_filename=None): + qs = raw_filename if raw_filename is not None else "filename=" + filename + req = urllib.request.Request("%s/api/v1/chats/%s/attachments?%s" % (BASE, chat_id, qs), data=data, method="POST", + headers={"Authorization": "Bearer " + token, "Content-Type": ctype}) + try: + with urllib.request.urlopen(req, timeout=30) as r: + return r.status, r.headers, json.loads(r.read()) + except urllib.error.HTTPError as err: + body = err.read() + return err.code, err.headers, (json.loads(body) if body else None) + + +def download(token, att_id, suffix="/content"): + req = urllib.request.Request("%s/api/v1/attachments/%s%s" % (BASE, att_id, suffix), + headers={"Authorization": "Bearer " + token if token else ""}) + try: + with urllib.request.urlopen(req, timeout=30) as r: + return r.status, r.headers, r.read() + except urllib.error.HTTPError as err: + return err.code, err.headers, err.read() + + +def wait_ready(token, att_id, seconds=60): + """lab6: загрузка возвращает 202 queued; готовность определяется опросом метаданных.""" + deadline = time.time() + seconds + while time.time() < deadline: + code, _, body = download(token, att_id, "") + att = json.loads(body) + if att["status"] == "ready": + return att + assert att["status"] != "failed", att + time.sleep(0.3) + raise AssertionError("not ready") + + +def png_chunk(kind, data): + return struct.pack(">I", len(data)) + kind + data + struct.pack(">I", zlib.crc32(kind + data) & 0xFFFFFFFF) + + +def bomb_png(width=20000, height=20000): + """Корректный по структуре PNG, заявляющий 400 млн пикселей, без данных изображения (отклоняется по заголовку).""" + ihdr = struct.pack(">IIBBBBB", width, height, 8, 2, 0, 0, 0) + return b"\x89PNG\r\n\x1a\n" + png_chunk(b"IHDR", ihdr) + png_chunk(b"IDAT", zlib.compress(b"\x00" * 16)) + png_chunk(b"IEND", b"") + + +class AttachmentTest(unittest.TestCase): + def setUp(self): + self.a, self.b, self.eve = register("att"), register("att"), register("att") + self.chat = call("POST", "/api/v1/chats", {"title": "файлы", "member_ids": [self.a["user"]["id"], self.b["user"]["id"]]}, self.a["token"])[2] + self.other = call("POST", "/api/v1/chats", {"title": "другой", "member_ids": [self.a["user"]["id"]]}, self.a["token"])[2] + + def assertError(self, result, status, code=None): + self.assertEqual(result[0], status, result[2]) + if code: + self.assertEqual(result[2]["error"]["code"], code) + + def test_png_and_jpeg_roundtrip_with_checksum(self): + for data, ctype, name in ((PNG, "image/png", "фото.png"), (JPG, "image/jpeg", "photo.jpg")): + status, headers, att = upload(self.a["token"], self.chat["id"], data, ctype, urllib.parse.quote(name)) + self.assertEqual(status, 202, att) + self.assertEqual((att["status"], att["variants"], att["error_code"]), ("queued", [], None)) + wait_ready(self.b["token"], att["id"]) + self.assertEqual((att["size_bytes"], att["sha256"], att["content_type"]), (len(data), hashlib.sha256(data).hexdigest(), ctype)) + self.assertEqual((att["chat_id"], att["owner_id"], att["filename"]), (self.chat["id"], self.a["user"]["id"], name)) + code, hdr, body = download(self.b["token"], att["id"]) # другой участник чата + self.assertEqual((code, body, hdr.get_content_type()), (200, data, ctype)) + self.assertEqual(download(self.b["token"], att["id"], "")[0], 200) + + def test_too_large_is_413_and_nothing_is_stored(self): + before = psql("SELECT count(*) FROM attachments") + r = upload(self.a["token"], self.chat["id"], PNG[:8] + b"\x00" * (10 * 1024 * 1024 + 1)) + self.assertError(r, 413, "payload_too_large") + self.assertEqual(psql("SELECT count(*) FROM attachments"), before) + + def test_corrupted_and_spoofed_files_are_415_not_500(self): + cases = { + "truncated png": (PNG[: len(PNG) // 2], "image/png"), + "garbage png": (b"\x89PNG\r\n\x1a\n" + b"\x00" * 200, "image/png"), + "random bytes": (os.urandom(500), "image/png"), + "truncated jpeg": (JPG[: len(JPG) // 2], "image/jpeg"), + "garbage jpeg": (b"\xff\xd8\xff\xe0" + b"\x00" * 200, "image/jpeg"), + "png as jpeg": (PNG, "image/jpeg"), + "jpeg as png": (JPG, "image/png"), + "text as png": (b"hello, i am not an image", "image/png"), + "gif": (b"GIF89a" + b"\x00" * 50, "image/png"), + } + for name, (data, ctype) in cases.items(): + with self.subTest(name): + self.assertError(upload(self.a["token"], self.chat["id"], data, ctype), 415, "unsupported_media_type") + self.assertError(upload(self.a["token"], self.chat["id"], PNG, "text/plain"), 415) + self.assertError(upload(self.a["token"], self.chat["id"], PNG, "multipart/form-data; boundary=x"), 415) + + def test_decompression_bomb_header_is_413(self): + self.assertError(upload(self.a["token"], self.chat["id"], bomb_png()), 413, "payload_too_large") + # 6000x6600 = 39.6 млн пикселей < лимита: по размерам допустимо, но данных изображения нет -> файл повреждён (415) + self.assertEqual(upload(self.a["token"], self.chat["id"], bomb_png(6000, 6600))[0], 415) + + def test_dangerous_filenames_are_400(self): + bad = ["a%2Fb.png", "..%5Cx.png", "x%00.png", "x%0A.png", "x%7F.png", "", "%20%20", "n" * 256] + for name in bad: + with self.subTest(name): + self.assertError(upload(self.a["token"], self.chat["id"], PNG, raw_filename="filename=" + name), 400, "invalid_request") + self.assertError(upload(self.a["token"], self.chat["id"], PNG, raw_filename=""), 400) + self.assertEqual(upload(self.a["token"], self.chat["id"], PNG, raw_filename="filename=" + "n" * 255)[0], 202) + + def test_empty_body_is_400(self): + self.assertError(upload(self.a["token"], self.chat["id"], b""), 400) + + def test_foreign_user_cannot_upload_read_or_download(self): + self.assertError(upload(self.eve["token"], self.chat["id"], PNG), 404) + att = upload(self.a["token"], self.chat["id"], PNG)[2] + wait_ready(self.a["token"], att["id"]) + for suffix in ("", "/content"): + self.assertEqual(download(self.eve["token"], att["id"], suffix)[0], 404) + self.assertEqual(download(None, att["id"], suffix)[0], 401) + self.assertEqual(download(self.a["token"], str(uuid.uuid4()))[0], 404) + self.assertEqual(download(self.a["token"], "not-a-uuid")[0], 400) + self.assertEqual(download(self.a["token"], att["id"], "/content?variant=thumbnail")[0], 200) # после ready вариант доступен + self.assertEqual(download(self.a["token"], att["id"], "/content?variant=bogus")[0], 400) + + def test_message_with_attachments_and_chat_binding(self): + att = upload(self.a["token"], self.chat["id"], PNG)[2] + foreign_chat_att = upload(self.a["token"], self.other["id"], JPG, "image/jpeg")[2] + path = "/api/v1/chats/%s/messages" % self.chat["id"] + sent = call("POST", path, {"text": "", "attachment_ids": [att["id"]]}, self.a["token"]) + self.assertEqual(sent[0], 201, sent[2]) + self.assertEqual(sent[2]["attachment_ids"], [att["id"]]) + self.assertEqual(call("POST", path, {"text": "ещё раз то же вложение", "attachment_ids": [att["id"]]}, self.b["token"])[0], 201) + listed = call("GET", path + "?limit=10", token=self.b["token"])[2]["items"] + self.assertEqual([m["attachment_ids"] for m in listed], [[att["id"]], [att["id"]]]) + # вложение другого чата / несуществующее -> 404; дубликаты, >10, пустое сообщение без вложений -> 400 + self.assertEqual(call("POST", path, {"text": "x", "attachment_ids": [foreign_chat_att["id"]]}, self.a["token"])[0], 404) + self.assertEqual(call("POST", path, {"text": "x", "attachment_ids": [str(uuid.uuid4())]}, self.a["token"])[0], 404) + self.assertEqual(call("POST", path, {"text": "x", "attachment_ids": [att["id"], att["id"]]}, self.a["token"])[0], 400) + self.assertEqual(call("POST", path, {"text": "x", "attachment_ids": [str(uuid.uuid4()) for _ in range(11)]}, self.a["token"])[0], 400) + self.assertEqual(call("POST", path, {"text": " ", "attachment_ids": []}, self.a["token"])[0], 400) + self.assertEqual(call("POST", path, {"text": "x", "attachment_ids": "nope"}, self.a["token"])[0], 400) + # чужой пользователь не может сослаться на вложение + self.assertEqual(call("POST", path, {"text": "x", "attachment_ids": [att["id"]]}, self.eve["token"])[0], 404) + + def test_idempotent_replay_with_attachments(self): + att = upload(self.a["token"], self.chat["id"], PNG)[2] + path = "/api/v1/chats/%s/messages" % self.chat["id"] + key = uuid.uuid4().hex + h = {"Idempotency-Key": key} + first = call("POST", path, {"text": "t", "attachment_ids": [att["id"]]}, self.a["token"], headers=h) + again = call("POST", path, {"attachment_ids": [att["id"]], "text": "t"}, self.a["token"], headers=h) # другой порядок ключей + self.assertEqual((first[0], again[0], first[2]), (201, 201, again[2])) + self.assertEqual(call("POST", path, {"text": "t"}, self.a["token"], headers=h)[0], 409) # другое тело + text_key = uuid.uuid4().hex + m1 = call("POST", path, {"text": "без вложений"}, self.a["token"], headers={"Idempotency-Key": text_key}) + m2 = call("POST", path, {"text": "без вложений", "attachment_ids": []}, self.a["token"], headers={"Idempotency-Key": text_key}) + self.assertEqual(m1[2], m2[2]) # отсутствие == [] + self.assertEqual(m1[2]["attachment_ids"], []) + + def test_aborted_upload_leaves_nothing(self): + before = (psql("SELECT count(*) FROM attachments")) + host, port = BASE.split("//")[1].split(":") + with socket.create_connection((host, int(port))) as s: + s.sendall(("POST /api/v1/chats/%s/attachments?filename=a.png HTTP/1.1\r\nHost: x\r\nAuthorization: Bearer %s\r\n" + "Content-Type: image/png\r\nContent-Length: 200000\r\n\r\n" % (self.chat["id"], self.a["token"])).encode() + PNG[:5000]) + import time + time.sleep(1) + self.assertEqual(psql("SELECT count(*) FROM attachments"), before) + + def test_bucket_is_private_outside_the_api(self): + att = upload(self.a["token"], self.chat["id"], PNG)[2] + wait_ready(self.a["token"], att["id"]) + key = psql("SELECT s3_key FROM attachments WHERE id = '%s'" % att["id"]) + import subprocess + code = ("import urllib.request,urllib.error,sys\n" + "try:\n urllib.request.urlopen('http://seaweedfs:8333/messenger-attachments/%s', timeout=5); print('OPEN')\n" + "except urllib.error.HTTPError as e: print(e.code)\n" % key) + out = subprocess.run(["docker", "compose", "--env-file", ".env", "exec", "-T", "api", "python", "-c", code], cwd=ROOT, + capture_output=True, text=True).stdout.strip() + self.assertEqual(out, "403", "анонимный GET объекта напрямую из S3 должен быть запрещён") + + +if __name__ == "__main__": + unittest.main() diff --git a/student-tests/test_idempotency.py b/student-tests/test_idempotency.py new file mode 100644 index 0000000..e421a8e --- /dev/null +++ b/student-tests/test_idempotency.py @@ -0,0 +1,121 @@ +"""Идемпотентность отправки сообщений (lab3) и распределение по репликам. Запуск: + python student-tests/test_idempotency.py (BASE_URL по умолчанию http://127.0.0.1:8080, через LB) +""" +import os +import sys +import unittest +import uuid +from concurrent.futures import ThreadPoolExecutor +from urllib.parse import quote + +sys.path.insert(0, os.path.dirname(__file__)) +from test_api import call, psql, register # noqa: E402 + + +def chat_with(owner, *others): + ids = [owner["user"]["id"]] + [o["user"]["id"] for o in others] + return call("POST", "/api/v1/chats", {"title": "идемпотентность", "member_ids": ids}, owner["token"])[2] + + +def history(token, chat_id): + items, cursor = [], None + while True: + page = call("GET", "/api/v1/chats/%s/messages?limit=100%s" % (chat_id, "&cursor=" + quote(cursor, safe="") if cursor else ""), token=token)[2] + items += page["items"] + cursor = page["next_cursor"] + if not cursor: + return items + + +class IdempotencyTest(unittest.TestCase): + def setUp(self): + self.a, self.b, self.eve = register(), register(), register() + self.chat = chat_with(self.a, self.b) + self.path = "/api/v1/chats/%s/messages" % self.chat["id"] + + def post(self, actor, body, key, path=None): + return call("POST", path or self.path, body, actor["token"], headers={"Idempotency-Key": key}) + + def test_key_validation(self): + for headers in ({}, {"Idempotency-Key": ""}, {"Idempotency-Key": "a b"}, + {"Idempotency-Key": "x" * 129}, {"Idempotency-Key": "a/b"}): + h = dict(headers) + h.setdefault("Content-Type", "application/json") + r = call("POST", self.path, raw=b'{"text":"x"}', token=self.a["token"], headers=h) + self.assertEqual(r[0], 400, headers) + self.assertEqual(r[2]["error"]["code"], "invalid_request") + self.assertEqual(self.post(self.a, {"text": "ok"}, "A-z_0.9:-" + "k" * 100)[0], 201) + + def test_replay_returns_same_message_and_creates_no_duplicate(self): + key = uuid.uuid4().hex + first = self.post(self.a, {"text": "один раз"}, key) + second = self.post(self.a, {"text": "один раз"}, key) + self.assertEqual((first[0], second[0]), (201, 201)) + self.assertEqual(first[2], second[2]) + self.assertEqual(len([m for m in history(self.b["token"], self.chat["id"]) if m["text"] == "один раз"]), 1) + + def test_different_body_same_key_is_409(self): + key = uuid.uuid4().hex + self.post(self.a, {"text": "первое"}, key) + r = self.post(self.a, {"text": "другое"}, key) + self.assertEqual(r[0], 409) + self.assertEqual(r[2]["error"]["code"], "conflict") + + def test_scope_is_user_and_chat(self): + key = uuid.uuid4().hex + m1 = self.post(self.a, {"text": "общий ключ"}, key)[2] + m2 = self.post(self.b, {"text": "общий ключ"}, key)[2] # другой пользователь + other = chat_with(self.a) + m3 = self.post(self.a, {"text": "общий ключ"}, key, "/api/v1/chats/%s/messages" % other["id"])[2] # другой чат + self.assertEqual(len({m1["id"], m2["id"], m3["id"]}), 3) + + def test_replay_rechecks_session_and_membership(self): + key = uuid.uuid4().hex + self.post(self.a, {"text": "защищено"}, key) + self.assertEqual(self.post(self.eve, {"text": "защищено"}, key)[0], 404) # посторонний + r = call("POST", self.path, {"text": "защищено"}, "Z" * 43, headers={"Idempotency-Key": key}) + self.assertEqual(r[0], 401) # недействительный токен + logout = register() + chat = chat_with(logout) + path = "/api/v1/chats/%s/messages" % chat["id"] + self.post(logout, {"text": "x"}, key, path) + call("DELETE", "/api/v1/auth/sessions/current", token=logout["token"]) + self.assertEqual(call("POST", path, {"text": "x"}, logout["token"], headers={"Idempotency-Key": key})[0], 401) + + def test_semantically_equal_body_is_replayed(self): + key = uuid.uuid4().hex + first = self.post(self.a, {"text": "эквивалент"}, key) + raw = call("POST", self.path, raw=b'{ "text" : "\u044d\u043a\u0432\u0438\u0432\u0430\u043b\u0435\u043d\u0442" }', + token=self.a["token"], headers={"Idempotency-Key": key, "Content-Type": "application/json"}) + self.assertEqual((raw[0], raw[2]), (201, first[2])) + + def test_concurrent_same_key_creates_exactly_one_message_across_replicas(self): + key = uuid.uuid4().hex + with ThreadPoolExecutor(24) as pool: + results = list(pool.map(lambda _: self.post(self.a, {"text": "гонка ключа"}, key), range(24))) + self.assertEqual({r[0] for r in results}, {201}) + self.assertEqual(len({r[2]["id"] for r in results}), 1) + instances = {r[1]["X-Instance-Id"] for r in results} + self.assertGreaterEqual(len(instances), 2, "повторы должны обслуживаться разными репликами: %s" % instances) + found = [m for m in history(self.b["token"], self.chat["id"]) if m["text"] == "гонка ключа"] + self.assertEqual(len(found), 1) + + def test_expired_key_is_reusable_after_ttl(self): + key = uuid.uuid4().hex + first = self.post(self.a, {"text": "ttl"}, key)[2] + psql("UPDATE idempotency_keys SET created_at = now() - interval '25 hours' WHERE idem_key = '%s'" % key) + again = self.post(self.a, {"text": "ttl"}, key) + self.assertEqual(again[0], 201) + self.assertNotEqual(again[2]["id"], first["id"], "после 24 ч ключ считается новым") + + def test_session_is_shared_between_replicas_without_relogin(self): + seen = set() + for _ in range(30): + r = call("GET", "/api/v1/users/me", token=self.a["token"]) + self.assertEqual(r[0], 200) + seen.add(r[1]["X-Instance-Id"]) + self.assertGreaterEqual(len(seen), 2, seen) + + +if __name__ == "__main__": + unittest.main() diff --git a/student-tests/test_observability.py b/student-tests/test_observability.py new file mode 100644 index 0000000..0536f3a --- /dev/null +++ b/student-tests/test_observability.py @@ -0,0 +1,142 @@ +"""Проверка наблюдаемости lab6: метрики, логи, трассы, связь API -> брокер -> worker, отсутствие секретов в телеметрии. + python -m unittest discover -s student-tests -p test_observability.py -v (стенд запущен; нужен ~1 минута) +Запросы к Prometheus/Loki/Tempo выполняются изнутри сети стенда (их порты наружу не опубликованы). +""" +import json +import os +import subprocess +import sys +import time +import unittest +import urllib.parse +import uuid + +sys.path.insert(0, os.path.dirname(__file__)) +from test_api import BASE, ROOT, call, register # noqa: E402 +from test_attachments import PNG, upload # noqa: E402 +from test_pipeline import wait_status # noqa: E402 + + +def net_get(url, accept=None): + cmd = ["docker", "compose", "--env-file", ".env", "exec", "-T", "prometheus", "wget", "-q", "-O", "-"] + if accept: + cmd += ["--header", "Accept: " + accept] + out = subprocess.run(cmd + [url], cwd=ROOT, capture_output=True, text=True, encoding="utf-8") + return out.stdout + + +def prom(query): + data = json.loads(net_get("http://127.0.0.1:9090/api/v1/query?query=" + urllib.parse.quote(query))) + return data["data"]["result"] + + +def loki(query, limit=200): + now = int(time.time() * 1e9) + url = "http://loki:3100/loki/api/v1/query_range?limit=%d&start=%d&end=%d&query=%s" % (limit, now - 600 * 10 ** 9, now, urllib.parse.quote(query)) + data = json.loads(net_get(url)) + return [(s["stream"], v) for s in data["data"]["result"] for v in s["values"]] + + +def tempo_trace(trace_id): + raw = net_get("http://tempo:3200/api/traces/" + trace_id, "application/json") + return json.loads(raw) if raw.strip() else None + + +def spans_of(trace): + out = [] + for batch in trace.get("batches", trace.get("resourceSpans", [])): + service = next((a["value"].get("stringValue") for a in batch["resource"]["attributes"] if a["key"] == "service.name"), None) + for scope in batch.get("scopeSpans", batch.get("instrumentationLibrarySpans", [])): + for sp in scope["spans"]: + attrs = {a["key"]: next(iter(a["value"].values())) for a in sp.get("attributes", [])} + out.append({"service": service, "name": sp["name"], "id": sp["spanId"], "parent": sp.get("parentSpanId", ""), "kind": sp.get("kind"), "attrs": attrs}) + return out + + +class ObservabilityTest(unittest.TestCase): + @classmethod + def setUpClass(cls): + cls.a = register("obs") + cls.chat = call("POST", "/api/v1/chats", {"title": "наблюдаемость", "member_ids": [cls.a["user"]["id"]]}, cls.a["token"])[2] + cls.trace_id = uuid.uuid4().hex + cls.secret_text = "СЕКРЕТНЫЙ-ТЕКСТ-" + uuid.uuid4().hex + # загрузка с входящим traceparent: так мы знаем trace_id заранее + import urllib.request + req = urllib.request.Request("%s/api/v1/chats/%s/attachments?filename=obs.png" % (BASE, cls.chat["id"]), data=PNG, method="POST", + headers={"Authorization": "Bearer " + cls.a["token"], "Content-Type": "image/png", + "traceparent": "00-%s-%s-01" % (cls.trace_id, uuid.uuid4().hex[:16])}) + with urllib.request.urlopen(req, timeout=30) as r: + cls.att = json.loads(r.read()) + wait_status(cls.a["token"], cls.att["id"], ("ready",), 60) + call("POST", "/api/v1/chats/%s/messages" % cls.chat["id"], {"text": cls.secret_text, "attachment_ids": [cls.att["id"]]}, cls.a["token"]) + deadline = time.time() + 40 # экспорт SDK (2 с) + пакетная обработка Collector + индексация + cls.trace = None + while time.time() < deadline: + cls.trace = tempo_trace(cls.trace_id) + if cls.trace and {s["service"] for s in spans_of(cls.trace)} >= {"messenger-api", "messenger-worker"}: + break + time.sleep(2) + + def test_one_trace_spans_api_outbox_broker_and_worker(self): + self.assertIsNotNone(self.trace, "трасса не найдена в Tempo") + spans = spans_of(self.trace) + by_name = {s["name"]: s for s in spans} + self.assertEqual({s["service"] for s in spans} & {"messenger-api", "messenger-worker"}, {"messenger-api", "messenger-worker"}) + server = by_name["HTTP POST /api/v1/chats/{chat_id}/attachments"] + producer, consumer = by_name["attachment.process publish"], by_name["attachment.process process"] + self.assertEqual((server["service"], producer["service"], consumer["service"]), ("messenger-api", "messenger-api", "messenger-worker")) + # цепочка parent-child: server (API) -> producer (publish из outbox) -> consumer (worker) + self.assertEqual(producer["parent"], server["id"]) + self.assertEqual(consumer["parent"], producer["id"]) + names = {s["name"] for s in spans} + self.assertIn("s3.put_object", names) # запись staging (API) и результатов (worker) + self.assertIn("s3.get_object", names) # чтение staging worker-ом + self.assertIn("db.connection", names) + self.assertEqual(server["attrs"].get("http.route"), "/api/v1/chats/{chat_id}/attachments") + self.assertEqual(int(server["attrs"].get("http.response.status_code")), 202) + + def test_logs_are_structured_and_linked_by_trace_id(self): + rows = loki('{service_name=~"messenger-.*"} | trace_id="%s"' % self.trace_id) + services = {stream["service_name"] for stream, _ in rows} + messages = {v[1] for _, v in rows} + self.assertIn("messenger-api", services) + self.assertIn("messenger-worker", services) + self.assertIn("job_ready", messages) + self.assertTrue(all(stream.get("span_id") for stream, _ in rows)) + self.assertTrue(all(stream.get("service_version") is not None and stream.get("service_instance_id") for stream, _ in rows)) + + def test_metrics_for_http_jobs_queue_pool_worker(self): + for query in ('http_server_request_duration_seconds_count{http_route="/api/v1/chats/{chat_id}/attachments"}', + 'messenger_jobs_processed_total{outcome="ready"}', + 'messenger_job_duration_seconds_bucket', 'messenger_job_time_to_ready_seconds_bucket', + 'messenger_queue_depth', 'messenger_queue_oldest_job_age_seconds', 'messenger_worker_capacity', 'messenger_worker_busy', + 'db_client_connections_usage{state="used"}', 'db_client_connections_waiting', 'process_memory_rss_bytes', + 'process_cpu_time_seconds_total'): + with self.subTest(query): + deadline = time.time() + 40 # экспорт SDK (5 с) + scrape Prometheus (5 с) + while not prom(query) and time.time() < deadline: + time.sleep(2) + self.assertTrue(prom(query), "нет данных: " + query) + + def test_no_high_cardinality_or_secret_labels(self): + forbidden = ("user_id", "chat_id", "message_id", "attachment_id", "request_id", "filename") + series = json.loads(net_get("http://127.0.0.1:9090/api/v1/series?match[]=%s" % urllib.parse.quote('{__name__=~"http_server.*|messenger_.*|db_client.*|process_.*"}')))["data"] + labels = {k for s in series for k in s} + self.assertFalse(labels & set(forbidden), labels & set(forbidden)) + text = json.dumps(series) + self.assertNotIn(self.a["token"], text) + route_values = {s.get("http_route") for s in series if "http_route" in s} + import re + self.assertFalse([r for r in route_values if re.search(r"[0-9a-f]{8}-[0-9a-f]{4}-", r)], route_values) # шаблоны, не реальные UUID + + def test_secrets_and_message_bodies_are_not_exported(self): + self.assertEqual(loki('{service_name=~"messenger-.*"} |= "%s"' % self.secret_text), []) + self.assertEqual(loki('{service_name=~"messenger-.*"} |= "%s"' % self.a["token"]), []) + self.assertEqual(loki('{service_name=~"messenger-.*"} |= "%s"' % self.a["password"]), []) + raw = json.dumps(self.trace) + for secret in (self.secret_text, self.a["token"], self.a["password"]): + self.assertNotIn(secret, raw) + + +if __name__ == "__main__": + unittest.main() diff --git a/student-tests/test_observability_retry.py b/student-tests/test_observability_retry.py new file mode 100644 index 0000000..ba2f2fd --- /dev/null +++ b/student-tests/test_observability_retry.py @@ -0,0 +1,58 @@ +"""Цепочка трассировки с повторами (уровень 4): все попытки одного задания находятся в ОДНОЙ трассе. + python student-tests/test_observability_retry.py +Worker пересоздаётся с внедрением сбоя (fail:after_claim, 3 попытки), затем возвращается к штатной конфигурации. +""" +import json +import os +import sys +import time +import unittest +import urllib.request +import uuid + +sys.path.insert(0, os.path.dirname(__file__)) +from test_api import BASE, call, register # noqa: E402 +from test_attachments import PNG # noqa: E402 +from test_observability import loki, spans_of, tempo_trace # noqa: E402 +from test_pipeline import wait_status # noqa: E402 +from test_resilience5 import compose, healthy, recreate_worker, wait # noqa: E402 + + +class RetryTraceTest(unittest.TestCase): + @classmethod + def tearDownClass(cls): + recreate_worker() + + def test_all_attempts_in_one_trace_and_logs(self): + recreate_worker({"WORKER_FAULT_INJECTION": "fail:after_claim", "MAX_ATTEMPTS": "3", "RETRY_BASE_DELAY": "0.3"}) + a = register("obsr") + chat = call("POST", "/api/v1/chats", {"title": "retry-trace", "member_ids": [a["user"]["id"]]}, a["token"])[2] + trace_id = uuid.uuid4().hex + req = urllib.request.Request("%s/api/v1/chats/%s/attachments?filename=r.png" % (BASE, chat["id"]), data=PNG, method="POST", + headers={"Authorization": "Bearer " + a["token"], "Content-Type": "image/png", + "traceparent": "00-%s-%s-01" % (trace_id, uuid.uuid4().hex[:16])}) + with urllib.request.urlopen(req, timeout=30) as r: + att = json.loads(r.read()) + failed = wait_status(a["token"], att["id"], ("failed",), 60) + self.assertEqual(failed["error_code"], "retry_exhausted") + spans, deadline = [], time.time() + 40 + while time.time() < deadline: + trace = tempo_trace(trace_id) + spans = spans_of(trace) if trace else [] + consumers = [s for s in spans if s["name"] == "attachment.process process"] + if len(consumers) >= 3: + break + time.sleep(2) + consumers = sorted([s for s in spans if s["name"] == "attachment.process process"], key=lambda s: int(s["attrs"]["job.attempt"])) + publishers = {s["id"]: s for s in spans if s["name"] == "attachment.process publish"} + self.assertEqual([int(c["attrs"]["job.attempt"]) for c in consumers], [1, 2, 3]) + for c in consumers: + self.assertIn(c["parent"], publishers, "consumer-спан каждой попытки — потомок publish-спана той же трассы") + logs = loki('{service_name="messenger-worker"} | trace_id="%s"' % trace_id) + messages = [v[1] for _, v in logs] + self.assertEqual(messages.count("job_rescheduled"), 2) + self.assertIn("job_retry_exhausted", messages) + + +if __name__ == "__main__": + unittest.main() diff --git a/student-tests/test_pipeline.py b/student-tests/test_pipeline.py new file mode 100644 index 0000000..955e922 --- /dev/null +++ b/student-tests/test_pipeline.py @@ -0,0 +1,182 @@ +"""Тесты асинхронного конвейера вложений lab6 (контракт вариантов, состояния, права). Запуск: + python -m unittest discover -s student-tests -p "test_pipeline.py" -v +Пиксельные проверки выполняются, если установлен Pillow (иначе пропускаются); размеры проверяются по заголовкам файлов. +""" +import hashlib +import io +import os +import struct +import sys +import time +import unittest +import uuid + +sys.path.insert(0, os.path.dirname(__file__)) +from test_api import call, register # noqa: E402 +from test_attachments import FIX, JPG, PNG, download, upload # noqa: E402 + +try: + from PIL import Image +except ImportError: # pragma: no cover + Image = None + + +def fixture(name): + return open(os.path.join(FIX, name), "rb").read() + + +def jpeg_size(data): + i = 2 + while i < len(data): + while data[i] == 0xFF: + i += 1 + marker = data[i] + i += 1 + if marker in (0xD8, 0x01) or 0xD0 <= marker <= 0xD7: + continue + length = int.from_bytes(data[i:i + 2], "big") + if marker in (0xC0, 0xC1, 0xC2): + return int.from_bytes(data[i + 5:i + 7], "big"), int.from_bytes(data[i + 3:i + 5], "big") + i += length + raise AssertionError("JPEG dimensions not found") + + +def webp_size(data): + assert data[:4] == b"RIFF" and data[8:12] == b"WEBP", "not WebP" + kind = data[12:16] + if kind == b"VP8X": + return 1 + int.from_bytes(data[24:27], "little"), 1 + int.from_bytes(data[27:30], "little") + if kind == b"VP8L": + bits = int.from_bytes(data[21:25], "little") + return (bits & 0x3FFF) + 1, ((bits >> 14) & 0x3FFF) + 1 + if kind == b"VP8 ": + return struct.unpack(" 100x300 -> вписывается в 256: 85x256 (округление вниз) + self.assertEqual((v["thumbnail"]["width"], v["thumbnail"]["height"]), (85, 256)) + self.assertEqual(jpeg_size(self.fetch(att, "thumbnail")[1]), (85, 256)) + + def test_small_image_is_not_upscaled_but_crop_is_128(self): + att = self.ready(fixture("small.png"), "image/png", "small.png") + v = self.variants(att) + self.assertEqual((v["thumbnail"]["width"], v["thumbnail"]["height"]), (50, 30)) + self.assertEqual((v["crop"]["width"], v["crop"]["height"]), (128, 128)) + self.assertEqual((v["optimized"]["width"], v["optimized"]["height"]), (50, 30)) + + @unittest.skipIf(Image is None, "нужен Pillow") + def test_alpha_is_composited_on_white(self): + att = self.ready(fixture("alpha.png"), "image/png", "alpha.png") + thumb = Image.open(io.BytesIO(self.fetch(att, "thumbnail")[1])).convert("RGB") + left, right = thumb.getpixel((10, thumb.height // 2)), thumb.getpixel((thumb.width - 10, thumb.height // 2)) + self.assertTrue(all(c > 235 for c in left), "прозрачная область должна стать белой: %s" % (left,)) + self.assertTrue(right[0] > 200 and right[1] < 60, "непрозрачная красная область сохранена: %s" % (right,)) + + def test_message_can_reference_attachment_before_ready_and_failed_cannot(self): + status, _, att = upload(self.a["token"], self.chat["id"], PNG) + path = "/api/v1/chats/%s/messages" % self.chat["id"] + sent = call("POST", path, {"text": "", "attachment_ids": [att["id"]]}, self.a["token"]) + self.assertEqual((status, sent[0], sent[2]["attachment_ids"]), (202, 201, [att["id"]])) + poison = upload(self.a["token"], self.chat["id"], fixture("poison.png")) + self.assertEqual(poison[0], 202, poison[2]) + failed = wait_status(self.b["token"], poison[2]["id"], ("failed",)) + self.assertEqual((failed["status"], failed["error_code"], failed["variants"]), ("failed", "invalid_image", [])) + self.assertEqual(call("POST", path, {"text": "x", "attachment_ids": [failed["id"]]}, self.a["token"])[0], 409) + self.assertEqual(download(self.b["token"], failed["id"], "/content")[0], 409) + self.assertEqual(download(self.b["token"], failed["id"], "/content?variant=thumbnail")[0], 409) + + def test_content_is_409_while_not_ready_and_original_is_untouched(self): + status, _, att = upload(self.a["token"], self.chat["id"], PNG) + code = download(self.b["token"], att["id"], "/content")[0] + self.assertIn(code, (200, 409)) # быстрый worker мог успеть: 200 допустим, но не 404/500 + done = wait_status(self.b["token"], att["id"]) + self.assertEqual(download(self.b["token"], done["id"], "/content")[2], PNG) + + def test_other_variants_visible_only_to_chat_members(self): + att = self.ready(PNG) + for variant in ("thumbnail", "crop", "optimized", "original"): + self.assertEqual(download(self.eve["token"], att["id"], "/content?variant=" + variant)[0], 404) + self.assertEqual(download(self.b["token"], att["id"], "/content?variant=bogus")[0], 400) + + def test_ready_job_redelivery_does_not_duplicate_variants(self): + from test_api import psql + att = self.ready(PNG) + before = psql("SELECT count(*) FROM attachment_variants WHERE attachment_id = '%s'" % att["id"]) + self.assertEqual(before, "3") + psql("INSERT INTO outbox (job_id, attachment_id, pipeline_version, attempt) VALUES (gen_random_uuid(), '%s', 1, 2)" % att["id"]) + time.sleep(4) + self.assertEqual(psql("SELECT count(*) FROM attachment_variants WHERE attachment_id = '%s'" % att["id"]), "3") + self.assertEqual(wait_status(self.b["token"], att["id"])["status"], "ready") + + def test_staging_is_cleaned_after_ready_and_kept_for_failed(self): + import subprocess + from test_api import ROOT, psql + att = self.ready(PNG) + poison = upload(self.a["token"], self.chat["id"], fixture("poison.png"))[2] + wait_status(self.b["token"], poison["id"], ("failed",)) + + def exists(att_id): + code = "\n".join(["import asyncio", "from app.s3 import S3", "async def m():", + " s = S3(); await s.start(); print((await s.head('staging/%s')) is not None); await s.stop()" % att_id, + "asyncio.run(m())"]) + return subprocess.run(["docker", "compose", "--env-file", ".env", "exec", "-T", "api", "python", "-c", code], cwd=ROOT, + capture_output=True, text=True).stdout.strip() + self.assertEqual(exists(att["id"]), "False", "staging готового вложения должен быть удалён после COMMIT результата") + self.assertEqual(exists(poison["id"]), "True", "staging неудавшегося вложения хранится для разбора/replay (retention)") + + +if __name__ == "__main__": + unittest.main() diff --git a/student-tests/test_resilience5.py b/student-tests/test_resilience5.py new file mode 100644 index 0000000..95ce7e2 --- /dev/null +++ b/student-tests/test_resilience5.py @@ -0,0 +1,154 @@ +"""Отказы конвейера lab6 (окна отказа из contracts/attachment-states.md). Тесты управляют контейнерами (volumes сохраняются): + python student-tests/test_resilience5.py # ~5-7 минут + +Окна: (1) worker остановлен -> upload -> рестарт API -> worker поднят; (2) рестарт брокера с volume; (3) брокер недоступен +при приёме (outbox); (4) crash API между COMMIT и publish; (5) crash worker после записи в S3 до COMMIT результата; +(6) crash после COMMIT до ack; (7) исчерпание попыток и операторский replay. +""" +import json +import os +import subprocess +import sys +import time +import unittest + +sys.path.insert(0, os.path.dirname(__file__)) +from test_api import ROOT, call, psql, register # noqa: E402 +from test_attachments import PNG, download, upload # noqa: E402 +from test_pipeline import wait_status # noqa: E402 + + +def compose(*args, env=None, check=True): + return subprocess.run(["docker", "compose", "--env-file", ".env", *args], cwd=ROOT, capture_output=True, text=True, + env=dict(os.environ, **(env or {})), check=check).stdout + + +def wait(predicate, seconds=90, message="условие"): + deadline = time.time() + seconds + while time.time() < deadline: + try: + if predicate(): + return + except Exception: + pass + time.sleep(1) + raise AssertionError("%s не выполнено за %d с" % (message, seconds)) + + +def healthy(service): + ids = compose("ps", "-q", service).split() + return bool(ids) and all(subprocess.run(["docker", "inspect", "-f", "{{.State.Health.Status}}", i], capture_output=True, text=True).stdout.strip() == "healthy" for i in ids) + + +def api_ready(): + return call("GET", "/health/ready")[0] == 200 + + +def recreate_worker(env=None): + compose("up", "-d", "--no-deps", "--force-recreate", "worker", env=env) + wait(lambda: healthy("worker"), 90, "worker healthy") + + +class ResilienceTest(unittest.TestCase): + @classmethod + def tearDownClass(cls): + recreate_worker() + compose("up", "-d", "--no-deps", "rabbitmq", "api") + + def setUp(self): + compose("start", "rabbitmq", "postgres", "minio", "valkey", check=False) + wait(lambda: healthy("rabbitmq") and healthy("postgres"), 90, "rabbitmq/postgres healthy") + wait(api_ready, 60, "api ready") + self.a = register("res") + self.chat = call("POST", "/api/v1/chats", {"title": "отказы", "member_ids": [self.a["user"]["id"]]}, self.a["token"])[2] + + def accept(self, data=PNG): + status, _, att = upload(self.a["token"], self.chat["id"], data) + self.assertEqual(status, 202, att) + return att + + def done(self, att, seconds=90): + ready = wait_status(self.a["token"], att["id"], ("ready",), seconds) + self.assertEqual(psql("SELECT count(*) FROM attachment_variants WHERE attachment_id = '%s'" % att["id"]), "3") # без дублей + code, _, body = download(self.a["token"], att["id"]) + self.assertEqual((code, body), (200, PNG)) + return ready + + def test_1_worker_down_upload_api_restart_worker_up(self): + compose("stop", "worker") + att = self.accept() + sent = call("POST", "/api/v1/chats/%s/messages" % self.chat["id"], {"text": "", "attachment_ids": [att["id"]]}, self.a["token"]) + self.assertEqual(sent[0], 201) + time.sleep(3) + self.assertEqual(wait_status(self.a["token"], att["id"], ("queued",), 5)["status"], "queued") # не обрабатывается без worker + compose("restart", "api") + wait(api_ready, 60, "api ready") + compose("start", "worker") + self.done(att) + + def test_2_broker_restart_keeps_accepted_jobs(self): + compose("stop", "worker") + att = self.accept() + time.sleep(2) + compose("restart", "rabbitmq") + wait(lambda: healthy("rabbitmq"), 90, "rabbitmq healthy") + compose("start", "worker") + self.done(att) + + def test_3_broker_down_during_acceptance_outbox_delivers_later(self): + compose("stop", "rabbitmq") + att = self.accept() # 202 даже без брокера: намерение зафиксировано в outbox + self.assertEqual(psql("SELECT count(*) FROM outbox WHERE attachment_id = '%s' AND published_at IS NULL" % att["id"]), "1") + time.sleep(3) + self.assertEqual(wait_status(self.a["token"], att["id"], ("queued",), 5)["status"], "queued") + compose("start", "rabbitmq") + self.done(att) + self.assertEqual(psql("SELECT count(*) FROM outbox WHERE attachment_id = '%s' AND published_at IS NULL" % att["id"]), "0") + + def test_4_api_crash_between_commit_and_publish(self): + compose("stop", "rabbitmq") + att = self.accept() # COMMIT выполнен, publish невозможен + for cid in compose("ps", "-q", "api").split(): + subprocess.run(["docker", "kill", cid], capture_output=True) # внезапная смерть всех реплик API + compose("start", "rabbitmq") + wait(lambda: healthy("rabbitmq"), 90, "rabbitmq healthy") + compose("up", "-d", "--no-deps", "api") + wait(api_ready, 90, "api ready") + self.done(att) # relay (в worker/новом API) довёл задание без ручного вмешательства + + def test_5_worker_crash_after_s3_before_commit_lease_recovery(self): + recreate_worker({"WORKER_FAULT_INJECTION": "crash_once:after_s3_before_commit", "LEASE_SECONDS": "8"}) + att = self.accept() + ready = self.done(att, 120) + events = psql("SELECT string_agg(event, ',' ORDER BY id) FROM job_events WHERE attachment_id = '%s'" % att["id"]) + self.assertIn("lease_expired", events) + self.assertIn("ready", events) + self.assertEqual(ready["status"], "ready") + + def test_6_worker_crash_after_commit_before_ack_redelivery_is_noop(self): + recreate_worker({"WORKER_FAULT_INJECTION": "crash_once:after_commit_before_ack"}) + att = self.accept() + self.done(att, 120) + time.sleep(5) # повторная доставка: no-op с ack, вариантов по-прежнему 3 + self.assertEqual(psql("SELECT count(*) FROM attachment_variants WHERE attachment_id = '%s'" % att["id"]), "3") + self.assertEqual(psql("SELECT status FROM attachments WHERE id = '%s'" % att["id"]), "ready") + + def test_7_retry_exhaustion_registry_and_operator_replay(self): + recreate_worker({"WORKER_FAULT_INJECTION": "fail:after_claim", "MAX_ATTEMPTS": "3", "RETRY_BASE_DELAY": "0.3"}) + att = self.accept() + failed = wait_status(self.a["token"], att["id"], ("failed",), 60) + self.assertEqual((failed["error_code"], failed["variants"]), ("retry_exhausted", [])) + events = psql("SELECT string_agg(event || ':' || coalesce(attempt::text,''), ',' ORDER BY id) FROM job_events WHERE attachment_id = '%s'" % att["id"]) + self.assertEqual(events.count("retry_scheduled"), 2, events) + registry = json.loads(compose("run", "--rm", "-T", "worker", "python", "-m", "app.replay", "list")) + self.assertIn(att["id"], [r["attachment_id"] for r in registry]) + recreate_worker() # причина устранена + result = json.loads(compose("run", "--rm", "-T", "worker", "python", "-m", "app.replay", "replay", att["id"])) + self.assertEqual(result["result"], "requeued") + self.done(att) + again = json.loads(compose("run", "--rm", "-T", "worker", "python", "-m", "app.replay", "replay", att["id"])) + self.assertEqual(again["result"], "skipped") # replay не исполняет дубль уже успешной работы + + +if __name__ == "__main__": + unittest.main() diff --git a/student-tests/test_topology.py b/student-tests/test_topology.py new file mode 100644 index 0000000..7c39b4b --- /dev/null +++ b/student-tests/test_topology.py @@ -0,0 +1,59 @@ +"""Проверка топологии стенда (уровень 4): число реплик, отсутствие публикации портов API, лимиты ресурсов, healthcheck, +отсутствие container_name, единая публичная точка входа. Запуск: python student-tests/test_topology.py""" +import json +import subprocess +import unittest + +PROJECT = "mtusi-lab6" + + +def sh(*args): + return subprocess.run(args, capture_output=True, text=True, encoding="utf-8").stdout.strip() + + +def containers(service): + ids = sh("docker", "ps", "-q", "--filter", "label=com.docker.compose.project=" + PROJECT, + "--filter", "label=com.docker.compose.service=" + service).split() + return [json.loads(sh("docker", "inspect", i))[0] for i in ids] + + +class TopologyTest(unittest.TestCase): + def test_at_least_two_api_replicas_without_published_ports(self): + api = containers("api") + self.assertGreaterEqual(len(api), 2) + for c in api: + self.assertFalse([p for p in c["HostConfig"]["PortBindings"] or {}], "реплика API публикует порт в обход LB") + self.assertEqual(c["State"]["Health"]["Status"], "healthy") + + def test_only_lb_is_published_and_only_on_localhost(self): + published = {} + for service in ("api", "postgres", "valkey", "lb", "seaweedfs", "rabbitmq", "otel-collector", "prometheus", "loki", "tempo", "grafana"): + for c in containers(service): + for port, binds in (c["HostConfig"]["PortBindings"] or {}).items(): + published.setdefault(service, []).extend((port, b["HostIp"], b["HostPort"]) for b in binds) + self.assertEqual(sorted(published), ["grafana", "lb"], published) # lab6: LB и Grafana (UI), OTLP/метрики/админки наружу не открыты + self.assertEqual(published["lb"], [("8080/tcp", "127.0.0.1", "8080")]) + self.assertEqual(published["grafana"], [("3000/tcp", "127.0.0.1", "3000")]) + + def test_resource_limits_are_set(self): + for service in ("api", "postgres", "valkey", "lb", "seaweedfs", "rabbitmq", "otel-collector", "prometheus", "loki", "tempo", "grafana"): + for c in containers(service): + self.assertGreater(c["HostConfig"]["Memory"], 0, service) + self.assertGreater(c["HostConfig"]["NanoCpus"], 0, service) + + def test_no_fixed_container_names(self): + for c in containers("api"): + labels = c["Config"]["Labels"] + self.assertEqual(c["Name"].lstrip("/"), "%s-api-%s" % (PROJECT, labels["com.docker.compose.container-number"])) + + def test_api_runs_as_non_root(self): + for c in containers("api"): + self.assertEqual(c["Config"]["User"], "10001:10001") + + def test_stop_grace_period_covers_drain(self): + for c in containers("api"): + self.assertGreaterEqual(c["Config"].get("StopTimeout", 10), 15) + + +if __name__ == "__main__": + unittest.main()