From 0f7b4461cbaaa4c02300b4f9e53e535dc5fdebb8 Mon Sep 17 00:00:00 2001 From: Tutuxaaa Date: Tue, 17 Nov 2026 15:57:31 +0300 Subject: [PATCH] lab6: observability, otel, grafana, incidents and dashboard --- .env.example | 33 +- Dockerfile | 29 + REPORT.md | 79 ++- compose.yaml | 234 +++++++ evidence/load-lab6.json | 17 + evidence/screenshots/file (1).webp | Bin 0 -> 7280 bytes evidence/screenshots/file (2).webp | Bin 0 -> 47598 bytes evidence/screenshots/file (3).webp | Bin 0 -> 9010 bytes evidence/screenshots/file (4).webp | Bin 0 -> 29436 bytes evidence/screenshots/file.webp | Bin 0 -> 9180 bytes evidence/worker-incident.json | 12 + infra/generate-s3-config.py | 30 + infra/haproxy.cfg | 38 ++ infra/otel/collector.yaml | 62 ++ .../provisioning/dashboards/dashboards.yml | 10 + .../dashboards/json/dashboard.json | 481 ++++++++++++++ .../provisioning/datasources/datasources.yml | 30 + infra/otel/loki/config.yaml | 27 + infra/otel/prometheus/alerts.yml | 23 + infra/otel/prometheus/prometheus.yml | 12 + infra/otel/tempo/config.yaml | 18 + requirements.txt | 14 + scripts/check_grade4.py | 13 + scripts/experiment_uploads.py | 71 +++ scripts/incident_worker.py | 95 +++ scripts/ops.py | 112 ++++ scripts/restart.cmd | 4 + scripts/restart.sh | 4 + scripts/stop-one.cmd | 4 + scripts/stop-one.sh | 4 + src/__init__.py | 0 src/__main__.py | 24 + src/auth.py | 29 + src/db.py | 112 ++++ src/images.py | 112 ++++ src/main.py | 600 ++++++++++++++++++ src/migrate.py | 25 + src/private_check.py | 22 + src/reconcile.py | 51 ++ src/storage.py | 43 ++ src/telemetry.py | 87 +++ src/worker.py | 122 ++++ student-tests/run.py | 76 +++ student-tests/test_attachments.py | 77 +++ 44 files changed, 2792 insertions(+), 44 deletions(-) create mode 100644 Dockerfile create mode 100644 compose.yaml create mode 100644 evidence/load-lab6.json create mode 100644 evidence/screenshots/file (1).webp create mode 100644 evidence/screenshots/file (2).webp create mode 100644 evidence/screenshots/file (3).webp create mode 100644 evidence/screenshots/file (4).webp create mode 100644 evidence/screenshots/file.webp create mode 100644 evidence/worker-incident.json create mode 100644 infra/generate-s3-config.py create mode 100644 infra/haproxy.cfg create mode 100644 infra/otel/collector.yaml create mode 100644 infra/otel/grafana/provisioning/dashboards/dashboards.yml create mode 100644 infra/otel/grafana/provisioning/dashboards/json/dashboard.json create mode 100644 infra/otel/grafana/provisioning/datasources/datasources.yml create mode 100644 infra/otel/loki/config.yaml create mode 100644 infra/otel/prometheus/alerts.yml create mode 100644 infra/otel/prometheus/prometheus.yml create mode 100644 infra/otel/tempo/config.yaml create mode 100644 requirements.txt create mode 100644 scripts/check_grade4.py create mode 100644 scripts/experiment_uploads.py create mode 100644 scripts/incident_worker.py create mode 100644 scripts/ops.py create mode 100644 scripts/restart.cmd create mode 100644 scripts/restart.sh create mode 100644 scripts/stop-one.cmd create mode 100644 scripts/stop-one.sh create mode 100644 src/__init__.py create mode 100644 src/__main__.py create mode 100644 src/auth.py create mode 100644 src/db.py create mode 100644 src/images.py create mode 100644 src/main.py create mode 100644 src/migrate.py create mode 100644 src/private_check.py create mode 100644 src/reconcile.py create mode 100644 src/storage.py create mode 100644 src/telemetry.py create mode 100644 src/worker.py create mode 100644 student-tests/run.py create mode 100644 student-tests/test_attachments.py diff --git a/.env.example b/.env.example index 2b32655..3e66113 100644 --- a/.env.example +++ b/.env.example @@ -1,30 +1,11 @@ -# Copy to .env for your LOCAL synthetic test environment; never commit .env. -# These are logical interface suggestions; map actual framework names in REPORT.md. -APP_HOST=0.0.0.0 -APP_PORT=8080 -APP_ENV=lab -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: -SESSION_STORE=postgres -CACHE_URL_FILE=/run/secrets/cache_url -API_REPLICAS=2 -IDEMPOTENCY_TTL_SECONDS=86400 -S3_ENDPOINT=http://s3:9000 -S3_REGION=us-east-1 +POSTGRES_PASSWORD=lab6-local-postgres-change-me +S3_ROOT_USER=lab6root +S3_ROOT_PASSWORD=lab6-local-s3-admin-change-me +S3_ACCESS_KEY_ID=lab6api +S3_SECRET_ACCESS_KEY=lab6-local-s3-api-change-me 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 +SESSION_TTL_SECONDS=3600 MAX_UPLOAD_BYTES=10485760 MAX_IMAGE_PIXELS=40000000 -BROKER_URL_FILE=/run/secrets/broker_url -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 +GRAFANA_ADMIN_PASSWORD=lab6-local-grafana-change-me diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..2954f81 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,29 @@ +# Pinned base image. Use a digest for reproducibility if you have one available: +# FROM python:3.12.7-slim-bookworm@sha256: +FROM python:3.12.7-slim-bookworm + +ENV PYTHONDONTWRITEBYTECODE=1 \ + PYTHONUNBUFFERED=1 \ + PIP_DISABLE_PIP_VERSION_CHECK=1 \ + PIP_NO_CACHE_DIR=1 \ + APP_HOST=0.0.0.0 \ + APP_PORT=8080 + +WORKDIR /app + +COPY requirements.txt . +RUN pip install --no-cache-dir -r requirements.txt + +COPY src/ ./src/ + +RUN useradd --create-home --uid 10001 --shell /usr/sbin/nologin appuser \ + && chown -R appuser:appuser /app +USER appuser + +EXPOSE 8080 + +HEALTHCHECK --interval=2s --timeout=3s --start-period=5s --retries=2 \ + CMD python -c "import sys,urllib.request; \ +sys.exit(0 if urllib.request.urlopen('http://127.0.0.1:8080/health/ready',timeout=2).status==200 else 1)" + +CMD ["python", "-m", "src"] diff --git a/REPORT.md b/REPORT.md index b97ae42..bfaf66c 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,37 +1,80 @@ # Отчёт — лабораторная 6 -- Автор, группа: TODO -- Целевая оценка; выбранный трек 5, если нужен: TODO -- Commit/PR: TODO после публикации -- Использованные источники, библиотеки и помощь ИИ: TODO +- **Автор, группа:** Вотчицева Вероника, БВТ2302 +- **Целевая оценка:** 4 (трек на 5 не заявлялся). +- **Commit/PR:** +- **Использованные источники и ИИ:** + - Python 3.12, FastAPI, SQLAlchemy, RabbitMQ (aio-pika), SeaweedFS (boto3). + - OpenTelemetry SDK (api, sdk, exporter-otlp-proto-http). + - Стек мониторинга: OTel Collector, Prometheus, Loki, Tempo, Grafana. + - При подготовке конфигураций и кода использовался ассистент (Claude). ## Запуск из чистого clone -TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных. +**Prerequisites:** Docker Desktop с поддержкой `--wait`, Python 3.9+ для скриптов проверки. + +```powershell +# 1. Подготовка окружения +Copy-Item .env.example .env +# (Заполнить пароли POSTGRES_PASSWORD и GRAFANA_ADMIN_PASSWORD) + +# 2. Запуск всего стека (включая Grafana, Prometheus, Loki, Tempo) +docker compose up -d --build --wait --wait-timeout 180 + +# 3. Проверка API +$env:PYTHONUTF8="1" +python tests/smoke.py + +# 4. Запуск нагрузки (для появления графиков) +python tests/load.py --duration 60 --concurrency 4 --output evidence/load-lab6.json +``` + +**Остановка:** `docker compose down`. **Удаление данных (включая дашборды и базы):** `docker compose down -v`. + +Интерфейсы: +- API (Swagger): `http://localhost:8080/docs` +- Grafana: `http://localhost:3000` (admin / пароль из `.env`) +- Prometheus: `http://localhost:9090` +- Jaeger/Tempo UI: `http://localhost:16686` (если настроен порт) ## Архитектура и решения -TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab5, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации. +В систему добавлен полный стек наблюдаемости (Observability) на базе OpenTelemetry. Схема сбора данных: `API/Worker → OTLP → OTel Collector → (Prometheus, Loki, Tempo) → Grafana`. + +**Три сигнала (Three Pillars):** +1. **Метрики (Prometheus):** Собираются через OTel Collector. Настроены дашборды для RPS, p50/p95/p99, доли ошибок, глубины очереди (Queue Depth) и возраста старейшей задачи. +2. **Логи (Loki):** Отправляются напрямую через OTLP HTTP. Логи структурированные (JSON), содержат `trace_id` и `span_id` для связки с трассами. +3. **Трассы (Tempo):** Позволяют отследить путь запроса. Реализована передача контекста W3C Trace Context (`traceparent`) через RabbitMQ. API создает задачу, сохраняет контекст в Outbox, Worker извлекает его и продолжает трассу. + +**Защита от перегрузки:** +В конфигурации OTel Collector настроен `memory_limiter` (лимит 96 MiB). В SDK настроены ограниченные очереди и таймауты. Если Tempo или Loki упадут, это не заблокирует основной поток обработки API. ## Доказательства критериев | Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | | --- | --- | --- | --- | -| Публичный smoke | make test | TODO | TODO | -| Остальные пункты уровня 3 | TODO | TODO | TODO | -| Все пункты уровня 4, если заявлен | TODO | TODO | TODO | -| Выбранный трек 5, если заявлен | TODO | TODO | TODO | - -TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены. +| Публичный smoke | `python tests/smoke.py` | PASS | — | +| Импортируемый Dashboard | Grafana → MTUCI Lab 6 | Все панели отрисовываются | `dashboard.json` в Git | +| Сбор метрик | `tests/load.py` | RPS и Latency видны в Prometheus | Скриншот Grafana | +| Связь Trace → Log | Tempo → клик по Trace ID | Переход в Loki с тем же trace_id | Скриншот Tempo/Loki | +| Сквозная трассировка | Tempo: `messenger-api` → `messenger-worker` | Единый трейс от HTTP до записи в S3 | — | +| Алерт на ошибки 5xx | Остановка БД под нагрузкой | RPS падает, HAProxy отдает 503 | Скриншот Prometheus | +| Алерт на Queue Lag | `incident_worker.py --hold 80` | Загорается `MessengerQueueLagGrowing` | Скриншот Prometheus | +| Отказ телеметрии | `stop loki tempo` + `smoke.py` | API продолжает работать (PASS) | — | ## Эксперименты и отказы -TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения. +**Инцидент 1: Остановка воркера (Queue Lag).** +Скрипт `scripts/incident_worker.py --hold 80` остановил контейнер `worker` и загрузил тестовый PNG. API вернул `202 Accepted` (статус `queued`), файл застрял в очереди. Через 35 секунд в Prometheus сработал алерт `MessengerQueueLagGrowing` (возраст старейшей задачи превысил 20 секунд, удерживался >15с). В Grafana на графике «Очередь» наблюдался рост. После автоматического запуска воркера задача обработалась, статус сменился на `ready`, алерт перешел в `resolved` (Inactive). -| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | -| --- | --- | --- | --- | -| TODO | TODO | TODO | TODO | +**Инцидент 2: Отказ PostgreSQL.** +Во время нагрузочного теста я остановила базу данных (`docker compose stop db`). Эндпоинт `/health/ready` начал возвращать `503`, из-за чего **HAProxy исключил реплики API из балансировки** и начал отдавать свой `503` на уровне LB. Из-за этого ошибки 5xx не попали в метрику API (ограничение архитектуры SLI), однако в Grafana график RPS упал до нуля. После команды `docker compose start db` сервис автоматически восстановился. -## Ограничения и следующие шаги +**Инцидент 3: Отказ Telemetry Backend.** +При остановке контейнеров `loki` и `tempo` бизнес-логика приложения не пострадала. Публичный тест `smoke.py` успешно прошел (PASS). В Grafana перестали появляться новые логи и трассы, так как Collector не мог их экспортировать. Это доказывает, что падение системы мониторинга не ломает основной сервис (graceful degradation телеметрии). -TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза. +## Ограничения + +- **Single-node:** Prometheus, Loki, Tempo и Grafana запущены в одном экземпляре. При падении всего Docker-хоста данные мониторинга будут потеряны (хотя volumes сохранят историю при перезапуске). +- **Ограничение метрик HAProxy:** Так как HAProxy отсекает трафик при падении API, ошибки 5xx не всегда попадают в метрики FastAPI. Для полной картины нужен экспортер метрик самого HAProxy (например, `haproxy_exporter`). +- **Кардинальность:** В метках (labels) нет пользовательских UUID, поэтому кардинальность метрик низкая. Все детали запросов (кто именно делал) ищутся через логи и трассы. \ No newline at end of file diff --git a/compose.yaml b/compose.yaml new file mode 100644 index 0000000..6d9c724 --- /dev/null +++ b/compose.yaml @@ -0,0 +1,234 @@ +x-api: &api + build: . + image: mtusi-lab5-votchitseva-api:local + environment: &api_env + OTEL_SERVICE_NAME: messenger-api + OTEL_EXPORTER_OTLP_ENDPOINT: http://otel-collector:4318 + JOB_MAX_ATTEMPTS: ${JOB_MAX_ATTEMPTS:-5} + APP_HOST: 0.0.0.0 + APP_PORT: 8080 + DATABASE_URL: postgresql+asyncpg://user:${POSTGRES_PASSWORD:?Copy .env.example to .env}@db:5432/messenger + CACHE_URL: redis://redis:6379/0 + SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-3600} + S3_ENDPOINT: http://s3:8333 + S3_BUCKET: ${S3_BUCKET:-messenger-attachments} + S3_ACCESS_KEY_ID: ${S3_ACCESS_KEY_ID:?Set S3_ACCESS_KEY_ID in .env} + S3_SECRET_ACCESS_KEY: ${S3_SECRET_ACCESS_KEY:?Set S3_SECRET_ACCESS_KEY in .env} + MAX_UPLOAD_BYTES: ${MAX_UPLOAD_BYTES:-10485760} + MAX_IMAGE_PIXELS: ${MAX_IMAGE_PIXELS:-40000000} + BROKER_URL: amqp://guest:guest@broker:5672/ + depends_on: + migrate: + condition: service_completed_successfully + redis: + condition: service_healthy + s3: + condition: service_healthy + broker: + condition: service_healthy + networks: [front, data] + cpus: 0.5 + mem_limit: 384m + stop_grace_period: 15s + healthcheck: + test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8080/health/ready', timeout=4).close()"] + interval: 5s + timeout: 5s + retries: 16 + start_period: 35s + +services: + api1: + <<: *api + api2: + <<: *api + + worker: + <<: *api + command: ["python", "-m", "src.worker"] + environment: + <<: *api_env + OTEL_SERVICE_NAME: messenger-worker + healthcheck: + disable: true + deploy: + replicas: 1 + + broker: + image: rabbitmq:3.13-alpine + hostname: rabbitmq + entrypoint: ["/bin/sh", "-c", "rm -f /var/lib/rabbitmq/.erlang.cookie && exec /usr/local/bin/docker-entrypoint.sh rabbitmq-server"] + environment: + RABBITMQ_DEFAULT_USER: guest + RABBITMQ_DEFAULT_PASS: guest + volumes: + - broker_data:/var/lib/rabbitmq + networks: [data] + cpus: 0.5 + mem_limit: 512m + healthcheck: + test: ["CMD", "rabbitmq-diagnostics", "-q", "check_running"] + interval: 10s + timeout: 5s + retries: 10 + start_period: 30s + + s3_config: + image: python:3.12.7-slim-bookworm + command: ["python", "/bootstrap/generate-s3-config.py"] + environment: + S3_ROOT_USER: ${S3_ROOT_USER:?Set S3_ROOT_USER in .env} + S3_ROOT_PASSWORD: ${S3_ROOT_PASSWORD:?Set S3_ROOT_PASSWORD in .env} + S3_ACCESS_KEY_ID: ${S3_ACCESS_KEY_ID:?Set S3_ACCESS_KEY_ID in .env} + S3_SECRET_ACCESS_KEY: ${S3_SECRET_ACCESS_KEY:?Set S3_SECRET_ACCESS_KEY in .env} + S3_BUCKET: ${S3_BUCKET:-messenger-attachments} + volumes: + - ./infra/generate-s3-config.py:/bootstrap/generate-s3-config.py:ro + - s3_config_data:/s3-config + networks: [data] + restart: "no" + + s3: + image: chrislusf/seaweedfs:4.35 + command: ["mini", "-dir=/data", "-s3.config=/s3-config/s3.json", "-bucket=messenger-attachments"] + volumes: + - s3_data:/data + - s3_config_data:/s3-config:ro + depends_on: + s3_config: {condition: service_completed_successfully} + networks: [data] + restart: unless-stopped + healthcheck: + test: ["CMD-SHELL", "wget -qO- http://127.0.0.1:8333/status || exit 1"] + interval: 2s + timeout: 3s + retries: 15 + start_period: 10s + + migrate: + build: . + image: mtusi-lab5-votchitseva-api:local + command: ["python", "-m", "src.migrate"] + environment: + DATABASE_URL: postgresql+asyncpg://user:${POSTGRES_PASSWORD:?Copy .env.example to .env}@db:5432/messenger + depends_on: + db: + condition: service_healthy + networks: [data] + cpus: 0.5 + mem_limit: 256m + healthcheck: + disable: true + + lb: + image: haproxy:3.0.5-alpine + ports: ["127.0.0.1:8080:8080"] + volumes: + - ./infra/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro + depends_on: + api1: + condition: service_healthy + api2: + condition: service_healthy + networks: [front] + cpus: 0.25 + mem_limit: 128m + + db: + image: postgres:16.4-alpine + environment: + POSTGRES_USER: user + POSTGRES_DB: messenger + POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?Copy .env.example to .env} + volumes: [pgdata:/var/lib/postgresql/data] + networks: [data] + cpus: 1.0 + mem_limit: 512m + healthcheck: + test: ["CMD-SHELL", "pg_isready -U user -d messenger"] + interval: 2s + timeout: 2s + retries: 15 + + redis: + image: redis:7.4.1-alpine + command: ["redis-server", "--appendonly", "yes", "--appendfsync", "always"] + volumes: [redisdata:/data] + networks: [data] + cpus: 0.25 + mem_limit: 128m + healthcheck: + test: ["CMD", "redis-cli", "ping"] + interval: 2s + timeout: 2s + retries: 15 + + otel-collector: + image: otel/opentelemetry-collector-contrib:0.138.0 + command: ["--config=/etc/otelcol/config.yaml"] + volumes: + - ./infra/otel/collector.yaml:/etc/otelcol/config.yaml:ro + networks: [data] + restart: unless-stopped + mem_limit: 192m + + prometheus: + image: prom/prometheus:v3.6.0 + command: ["--config.file=/etc/prometheus/prometheus.yml", "--storage.tsdb.path=/prometheus", "--storage.tsdb.retention.time=7d", "--web.enable-lifecycle"] + volumes: + - ./infra/otel/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro + - ./infra/otel/prometheus/alerts.yml:/etc/prometheus/alerts.yml:ro + - prometheus_data:/prometheus + ports: ["127.0.0.1:9090:9090"] + networks: [data, front] + restart: unless-stopped + + loki: + image: grafana/loki:3.5.5 + user: "0" + command: ["-config.file=/etc/loki/config.yaml"] + volumes: + - ./infra/otel/loki/config.yaml:/etc/loki/config.yaml:ro + - loki_data:/loki + networks: [data] + restart: unless-stopped + + tempo: + image: grafana/tempo:2.8.2 + user: "0" + command: ["-config.file=/etc/tempo/config.yaml"] + volumes: + - ./infra/otel/tempo/config.yaml:/etc/tempo/config.yaml:ro + - tempo_data:/var/tempo + networks: [data] + restart: unless-stopped + + grafana: + image: grafana/grafana:12.2.0 + environment: + GF_SECURITY_ADMIN_USER: admin + GF_SECURITY_ADMIN_PASSWORD: ${GRAFANA_ADMIN_PASSWORD:-lab6-local-change-me} + GF_USERS_ALLOW_SIGN_UP: "false" + GF_ANALYTICS_REPORTING_ENABLED: "false" + volumes: + - grafana_data:/var/lib/grafana + - ./infra/otel/grafana/provisioning:/etc/grafana/provisioning:ro + ports: ["127.0.0.1:3000:3000"] + networks: [data, front] + restart: unless-stopped + +networks: + front: + data: + internal: true + +volumes: + pgdata: + redisdata: + s3_data: + s3_config_data: + prometheus_data: + loki_data: + tempo_data: + grafana_data: + broker_data: \ No newline at end of file diff --git a/evidence/load-lab6.json b/evidence/load-lab6.json new file mode 100644 index 0000000..0c3a916 --- /dev/null +++ b/evidence/load-lab6.json @@ -0,0 +1,17 @@ +{ + "lab": 6, + "workload": "closed-loop POST messages; no automatic retries", + "requested_duration_seconds": 30.0, + "elapsed_seconds": 31.27, + "concurrency": 4, + "successful_requests": 60, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 1.919, + "successful_latency_ms": { + "p50": 2063.889, + "p95": 2124.196, + "p99": 2185.684 + }, + "note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead." +} diff --git a/evidence/screenshots/file (1).webp b/evidence/screenshots/file (1).webp new file mode 100644 index 0000000000000000000000000000000000000000..6b0bba44128b210597dacbdcc8e535608c6ebd84 GIT binary patch literal 7280 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 Cz16w^ literal 0 HcmV?d00001 diff --git a/evidence/screenshots/file (2).webp b/evidence/screenshots/file (2).webp new file mode 100644 index 0000000000000000000000000000000000000000..bce1eaf21fe5fb2ce6d9f858678bef80ed1fddb2 GIT binary patch literal 47598 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

fK5L)SsW_12 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 GK>q`H6Giy| literal 0 HcmV?d00001 diff --git a/evidence/screenshots/file (3).webp b/evidence/screenshots/file (3).webp new file mode 100644 index 0000000000000000000000000000000000000000..290fc3a5dd8f40d2e35c779acc6fe85dbf1fe529 GIT binary patch literal 9010 zcmZ{IWl$YWw>9o?LV`nZ*Wd&@xVr~;37QaG4(<}%JwQkZuEE{i-QC^Ke0k*7_ttys z&Yzy@+TF9)+G}<9w3@7x6eAT3jJBkhik1o=Iq9Ewr*4=mSjHi^C|F@t>R4&2ygUkW zH5m~nG*lahTlbHmuaxHDr`f7;MYsdO#7F#s>|RRY7VSdFkRR9W`z*tIPl2brHwia= z&&UnPKih6V#%()fOG19&NZ=zdcT|1M^fCwKJq5RGpOOK9F-QdT;$!y$17%qN?#ufi z{NCaZ@Cy(gtkdVIm+H&2WwwnrUE$gnuiKoN^8Hn`XK^Ta8vP=68(09oLB|2(m*Ly! z1tVR^@T0${&sEzcFb8%38axqw*Yy z%IG{fl3^uC-QOtv%lO(rKjMby^3kShP?=t4PxqGticti*D`F~EVHSZ$W$?@ks_B^i zW|(B+w!fL4SlZq=xq8J_lqI(w;iaVH6VQNa;L-2R8M-X*pyY1pLPkBmkdq6sl3o_j z?$-&ai78rUCi1Qz)yAY#dD;;2MG@L2b=~Ux@{1gV_yhNMuyxZ_u+*kw5Alny<1s@U z?FJ-saufO5yiSxbnUIs2!&1k5xMCp9B!Q!gp1!s>CfVLSnc7+R0B_X#jlwu>TCO6e zNV=sz*9e?VCZAsw-z=={6G`B?1GAjvZsN!YLq@tfFISO+jl%L|T4N!n^PldDk8!1B;<6~!kV>4>8;XEL^Mk$hUxi3F9qQe0+oPqkkx-P|J%y7nr{Y4+FQhF z`>*8IK1TnWVwKguS*GVk;Uf*hIir3bF!%$S)}jn!3+E4lzVE$hFi7&py4(kOu` z^CG`lSNDQC6-i@|gR@^{h-Fjc^L&!79qqx;|5t*)b?QHGO#eVs*RD-}{~G_nrij?< zm!H}4vEPRUV(9ti@Rglb z`Ao4=AzGiB_rJ?sduCfGflcAu==c#F0mDY}k07J-|K+&~&h#Iim&Yb*PG)ifW*2(+ zDg_W*$)PHu%!EEhqcDG5jQT=|+OYA-(ay$VV`+A@ucf*$CDc(*fb^1d`~9!4og@v` z_nTHt5;Zuw^!dJjpqJQX8A?eQrS>(6`c*fCO;)5<&&me=89`$0H~#9x?)D)tRiOvz zAQCw5kIJy>Bdh(H5$Rd`A_ zd7OtB{vY=H;~eI+|1{=|90AM2q@Gk4wQmAO+JC$LA6fj>&Eh0L{I@dx(dxfd`o|i7 z3Fa^t1`4QTz}vVl2mamZ7yAZcuG!vaqJ~To#bOs7ixnN`&R}nx!%6t zk;eO#&aqlrxH75z4nlXS8$kU*W~+L@2LI%MWB7%qODrL);W!?}+0Q<)Jr8R2b3CT*U&53(YA2ufT zw$aD03*4jyNFXbL@jnf+NtjRebH~s%F}_H}W9!{gP;`78lo%VI6q_W`iHI%b{LPw^ zp`ULYB{Ls1tQ{cmCyu({#UubM0@>=dZPk6VdQeY+cfjvFSD0to@qwxSXDuM)oAKFw z7Pv)FkDqBo^+7=>aUL0lEr{6C*#Oq#=0$|xhU*!+>w^mhMC2QdDGUUAU3y>A)%dUlmw9dZGSvg! zE_;Jkq-m1s7aov@7pPkS=fbx;F!X^;$ytu?xKf9tUJ^<_49-Y#&ce{qgofv zc3u~$#TlGu!~`_B!HZwt|e)OF8KQR)d%dlAS(IYNHk_Qr-uZMUUn#T7@H2Rda} zu1*Mox0WZsVYm%7JD)1p+bzlkL_d(PWE%e-ugE7fC@q*!6M9cLWEUT*6qbL2H&m#yhicj>v zQ>=UVROdoAP+bW!P!p@GJ(^krMPs^s@x32DjC(zJw_TGM2Y`$tf_3{p?Q6n%7~6fl zxEe@RJEJPLe%~eKe;Q8xjgsJ;a51&X5X$mkfQf;~XYl5gp2U=aR`=o||F}*!<*0(a zJn`Fus;a9-@0zXtN=s}Gex?fySfp%@94fh_;&)rQd_x$Rd+#Grb2MQ0>$SaN@X(c& zyWLf6>gVi#-eWf$mv6>&w=g7=NI(msmMjb;l{> zW<}JN&qp}*yyfYz$}^5w^Y!6^7&&uYyZ1Dn$F0;99VwZksFf-PLv{;}6P*WS_oRmY zxS?I0n~7f^pN(cR6uy?hqOH~?yvhKY5;BSWJzuZg+N2}E?esH85Cz0+xec8SH6K*S zdaoriEHPXfM(T8%p*vV{-sP#(GmVw=E$KJ2#XwvmeM6C~Ugf4ve5NF8qEoYzPo~%h z4?p&oOcaOw^dan5t=Q3bNLJJ(9Tq_h5UL_})qeCF0NsrJ`dj2%-ke2-@EnuTur8o9 zc3Z_Qwi?g3OrBHnM>1XiRSME>eB3i7o9xx5ghWZ-jn>Fh;|He*7SlEx_a4nkKT-{>-JW(n4&z zl5rzZL~_YMC5O%uTzp0kUe-FLts;9u+{=X zGR=DFnL=S}JmO4WFMlgFar^l3&W?!e8NID}@PxG3w)udvvI?0w0ypre#Ff-)29a(3 ztLG1?d81+LPGzbyxND0HUY*;BwR9d8H01#CgKkl_*Kh|o9r$2m>}>EUsz^d*zZ@+j z28Y#s_xB`GV`zSIH)rzlItP2gyE&#|N7HXIcb4FMrB9PjgGnMao=!iEu5v;;w|nY# zOQ_v*KhcY(R_0MhM>m$u?0hER?nEDj8$2W;;GN~VUT&|d0e-AepwgHf9jhBqg$mhJ zSA@HTNU$2NaF?-h&xnzL4DE~+&_FZCgWHH`G-gL&jIK5x1>a6%;OgE%)}p= z!}+6dyU zfmzSj@q8#fdSd6N0(e5)ipt3m6W!BIKlQ7alBPpVC2+?#SL2b#-JwkLnQmGS`5ko z97kUnZ?TR4R`iV1G-g8IJq@-4z>^AvPc9G~HW@c(rY#_+H)u^|kE& z@aEn3iy*Ytw1-4eKFiMaD=^aB2&pOj^rLhtQ5+J+E!O(4cxr14HRhT&Qx!?Zq^om# zm%8*EEQqA5p4*^M^OX&9w&?dYANuCwjFfj`j)wFB`(Qz?9eW_zzA6-J~Vz1`~D{S^LG&2v20p~;2Yc*@R zBO00RfI)<0{Ao+PB@H!!Sf$xFGsarVOJirN2D=+1HQw11zoF6s>oi8-NrSV(RmGdE z$K$3v!%FrMbfsKdH%Kz8@@m|tVZ#2l;cDOsX2hruAZS}I=|)be(2hQuXX+>&zpxcA zRWXylr#W?FFq%imFQXE^%YE>tfj}i0`sKS);f0E!m(K-IEetJ9MDv{_ggU-2M8SI? ze2EZ&`eCeP_WZ6%#1KORQ&yDxlv2!GA>Wb|rHU41k?-RaQ!EJdKZNK2$oKg)o^;l} z{?pmR0=`7!#-bX(5)e=PmrA$L1~Qbw?(-6nsxAfx39|R|rs@PY2f0j-;u?G#+LgaBj9Qey5bNBH^t99OfMZp zC3NvILD-DO!~cPFcOjU4XD=n&(C$N}Wly%D7b)3G8z5B%eYuBw~+wa<6U*psgD;+IN@@=m@6+_7MnRBV{1l z^F(59C*hg)Oet)efq@!V?Wp|7LQ-AuogQ07X!Qx&g8b=FJQ0?r^50!2x(w9bb9?k{ z2cAlAja#8LU_ZEs;weN($#Qh$BF^tpbnQpy8_&R4m`Z1+>?aLdlgWNM*#~^?Ar+3} zVcVxGse>V1LF8&lrrO^FsbdmX1M8?xQV>rM*PcdF-E*;Pck zOW+Rwz7657lkDrOUuMDpA2&`+GIZUtA#FpK!)~?FK7SOlXs|`gU&G$5x-3hK6eNrT zL1MfXTI(Z8sJACsr`!yA+{csl@A@EKhoHm^4`=(Wf{oFP$)9|+W``wpNq)vcZVzju zIR??2I7Ql)QJul!6@2C#rS7@)I=bfI>1^!A)t7!|2y3lp#1JGk=3;2oxMdF?n z`~Ld4-#d>4WFp=du2>I`QSj4f{V-_gT9Y#R9DK;$AOfW79|Zp1j!MO~N6h15v;! z^B#O=#Rs{!1v&>kx6RsaY<9tfeS<#0{jZj}^;jsAqsu)N5V5r41GNglO)vcIhdUlj$uo+1u?@-`Vn!`W&rbM@$W&)X1Enck;KjK3(y{h)Wx~tB7KyXKqsKJOhSK`zi@?0 zL5`Y?fX&V2;isGW{*J>bIP8%DUsRBEd7^{TBWFXbaDj?_q#R66izN2l{ykPI&i5D1 zn6~%V^p`uLnZrrc(GCNw?d^FKG80ogAG9!$TWD=r!%oQeP+XZXKm@?2y(!x0^#UY#!O5;*HK+ zW1Z*dyRhd=dIU3T<2g3dLyvsnM!9fXoHw$w*1)zlKpBAb=M-Dw(T@d#0()kp2t40S z6kbCdEsR|tX-v}31OWBr1QFyRz6R0}3rH9Mo#MO<6^17Thp;ejLPAYC2}{IjPl>E4*R<4GU)q`uwtRcyREaHDA*(|Ke9Qq zmb+CjUHQ*OQ=JSqfG9DCkK-66AV_bF-EHK{R5)}eihX{2XGHas z4tTTPU}!hwh_GC51Sw;-Lb4_UR78&LOKc&z{{Ewbm?R)i^F}l5n9q|ZoigZ#k*{bx zjHP42WsvSUAx3@h`UcgeSCG4A5)rNCN#zNWt>`9;O0Zd)%uTcfeYmFB3WB3A@{lp z!}svI?^2E-dQg$KLDi&Y9RmRT1dz*JsiI{muvvF!^sJHd*Fp#MJda^8(aYYc^|d#( zS%s&5b7mS>3z%%7t>7j=h})-zM_A(u3dnEK%W;CQ*Vxc`5y@y&H#$b(5et3lXjxDV z3Vl29{6WUydtH`Dw_OL(UXmIg{efg0x+px&0^4y`K`*33m1h5K!I#Fx`yPY|_7w-h z2;W~9X=$a}-N=SJZ|9{SdtHilHbB{{{3dgV9t^1p$IN@mKk|d$A9=y6gG-ra)!&s5 zA4lA&+l#bdFCxAvp5)W=N zQ#J1dTsGRmvssstuwqG%rl0KOzj($3Hw6)?af=rAGNt{#1=K7FUWJ|GeAUXZ%Kk(O z7mqe&cQs1Yt|qE$-(-s!LHwhmd^qUwVpXD0A{2a2fpU^+HIe5+Es(q=>hsS1@G2yQ z9##;hosCc0gG^SW8NRDGytvp&mRNg9`Z>UxwQ}zn-*g&02Yyn=g@5@x&AePz`>TK8 z`iz_QJ?KJ>0 z<=jHjK&6X|v(Y7;L!G7Bc*ZLiJq;!x>4qVHz(>`Xp0uZhh;0Evf?_g``YpmattUda zb@scRoS`t(n;3&cvC@?@;@zDGZqW!0l`W|j(4HY#@4RhlOwNwWc>p+!g}v~TER z2NttsXa$m;becx(LLK>_X|tTnROdDt-MMlZ;20(cV!`as`+7gUjCY-O>PM9b`RYha z#)1$VKJ1qdpK*t6#tJ5jY4&cU6s^U8Vqa~)U$k{eF9WMZ*81n z;EUvh-6bV4r27ekp}b14FoPqYdSo; zlIOJ#kdfB6?M2^^9`DnwF4YE)n{ox*3D{ky_M2$ z_+sdpFdcat9Uq9!=RSRHClKEWOvDzyl(y9x2+9Dv}k2%ckVF+D$81ggKIcEmmvO|Hk0YG;*+}fq*SqeYnxAR zxVjcCaD*^SwD&!gp~w-%ka~xV91F_?@SI@t<(273q;Rod^Q{p0?#7w&Sx|Tjw(Z^) z%KilSZ#)J^6~k|xy+mH7;yDqI?8>I;lU^k#YmzSp?|d|c7|r#i4ax?WUQT-;9%=H| zeL9OY)}y=CndWEN1=H0zd#Unjr=BN`ybIDNs zN;U1>tL0+%NDAmh=CPgh`+^lzr>m!({;tV*puH(J?K{KeWN5xMTQg=Vo z`Dn0)Ke?$PP2Ayl5B49rHZ!i9phxnAe|^??XEb)&5Fx@o+C`u!3z!@;XeQEn%LG{O;~t{ZXg@ z_06|7-(gMOak)~w?l1OV@xxsS3`{TOwY)5m=Wvd(y11&9k$uuGCLS5Jr?*_XxL9_j zpQZW14*OH=ZtogS1!L27LRRja)d-56enNSM&t-*h#EWx~kq%1aRYe%O;AaG%5x8+B z64ddXu|!IgZ?Xy%Oy99gp*zUwj|Q&)xwNusU_%5pa>t#BU+Q}L}RV^G} z4O_`N`UWGu$ESGoCj-4e))qy}APU_;_mK&j6$ClX2$7={TxTSus$J3{6+Upk5~xSc z(RJuitIXoydC2Z%XQ3;@*)n})<2X5QCo3_PwfOv`yh_^Ut*pB%gn&Xsu367D*Ar9V z&-J}}y?G^lA+`=tmSdn8CM9`5-@5qmi0f5Jcvo4cNsuw%PAM1ikt;fKab z#%{)LMj{29=c^aG|0nnz;SaBf*iMP|pRL!7nA!cSTakV={DE KMzOcU!2CZ!GUECG literal 0 HcmV?d00001 diff --git a/evidence/screenshots/file (4).webp b/evidence/screenshots/file (4).webp new file mode 100644 index 0000000000000000000000000000000000000000..a22fbb4d064a9a3e80d20c28920351f252cb897d GIT binary patch literal 29436 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 _ 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 W_PXJwCsC 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 literal 0 HcmV?d00001 diff --git a/evidence/worker-incident.json b/evidence/worker-incident.json new file mode 100644 index 0000000..3d0b891 --- /dev/null +++ b/evidence/worker-incident.json @@ -0,0 +1,12 @@ +{ + "scenario": "stop worker -> 202 queued -> restart -> ready", + "attachment_id": "792f6182-62e6-4f06-9b9b-7c4830ff8fcf", + "status": "ready", + "variants": [ + "crop", + "optimized", + "thumbnail" + ], + "queue_alert_before_worker_start": "firing", + "passed": true +} \ No newline at end of file diff --git a/infra/generate-s3-config.py b/infra/generate-s3-config.py new file mode 100644 index 0000000..2e319f4 --- /dev/null +++ b/infra/generate-s3-config.py @@ -0,0 +1,30 @@ +"""Bootstraps a private S3 identity configuration from non-committed .env. + +The server reads it from a shared internal-only configuration volume. +""" +import json +import os +from pathlib import Path + +bucket = os.environ["S3_BUCKET"] +assert bucket == "messenger-attachments", "Fixed bucket name; change policy and config deliberately" +config = { + "identities": [ + { + "name": "lab4-admin", + "credentials": [{"accessKey": os.environ["S3_ROOT_USER"], + "secretKey": os.environ["S3_ROOT_PASSWORD"]}], + "actions": ["Admin", "Read", "Write", "List", "Tagging"], + }, + { + "name": "lab4-api", + "credentials": [{"accessKey": os.environ["S3_ACCESS_KEY_ID"], + "secretKey": os.environ["S3_SECRET_ACCESS_KEY"]}], + "actions": [f"Read:{bucket}", f"Write:{bucket}", f"List:{bucket}"], + }, + ], +} +target = Path("/s3-config/s3.json") +target.write_text(json.dumps(config, indent=2), encoding="utf-8") +target.chmod(0o644) # Only mounted into S3 service; SeaweedFS runs non-root on some images. +print("PASS: private S3 identity config generated; credentials not logged") diff --git a/infra/haproxy.cfg b/infra/haproxy.cfg new file mode 100644 index 0000000..d860347 --- /dev/null +++ b/infra/haproxy.cfg @@ -0,0 +1,38 @@ +global + log stdout format raw local0 + maxconn 512 + +defaults + mode http + log global + option httplog + timeout connect 3s + timeout client 75s + timeout server 75s + timeout check 2s + retries 1 + option redispatch + +resolvers docker + nameserver dns 127.0.0.11:53 + resolve_retries 2 + timeout resolve 1s + timeout retry 1s + hold valid 1s + hold obsolete 1s + hold nx 1s + hold refused 1s + hold timeout 1s + hold other 1s + +frontend public + bind :8080 + default_backend api + +backend api + balance roundrobin + option httpchk GET /health/ready + http-check expect status 200 + default-server check inter 1s fall 2 rise 1 resolvers docker init-addr libc,none + server api1 api1:8080 + server api2 api2:8080 diff --git a/infra/otel/collector.yaml b/infra/otel/collector.yaml new file mode 100644 index 0000000..2a99cc9 --- /dev/null +++ b/infra/otel/collector.yaml @@ -0,0 +1,62 @@ +receivers: + otlp: + protocols: + grpc: + endpoint: 0.0.0.0:4317 + http: + endpoint: 0.0.0.0:4318 +processors: + memory_limiter: + check_interval: 2s + limit_mib: 96 + spike_limit_mib: 24 + batch: + timeout: 3s + send_batch_size: 256 + send_batch_max_size: 512 +exporters: + prometheus: + endpoint: 0.0.0.0:8889 + resource_to_telemetry_conversion: + enabled: true + otlp/tempo: + endpoint: tempo:4317 + tls: + insecure: true + sending_queue: + enabled: true + num_consumers: 2 + queue_size: 128 + retry_on_failure: + enabled: true + initial_interval: 1s + max_interval: 5s + max_elapsed_time: 30s + otlphttp/loki: + endpoint: http://loki:3100/otlp + sending_queue: + enabled: true + num_consumers: 2 + queue_size: 128 + retry_on_failure: + enabled: true + initial_interval: 1s + max_interval: 5s + max_elapsed_time: 30s +service: + pipelines: + metrics: + receivers: [otlp] + processors: [memory_limiter, batch] + exporters: [prometheus] + traces: + receivers: [otlp] + processors: [memory_limiter, batch] + exporters: [otlp/tempo] + logs: + receivers: [otlp] + processors: [memory_limiter, batch] + exporters: [otlphttp/loki] + telemetry: + logs: + level: warn diff --git a/infra/otel/grafana/provisioning/dashboards/dashboards.yml b/infra/otel/grafana/provisioning/dashboards/dashboards.yml new file mode 100644 index 0000000..2221158 --- /dev/null +++ b/infra/otel/grafana/provisioning/dashboards/dashboards.yml @@ -0,0 +1,10 @@ +apiVersion: 1 +providers: + - name: Messenger Lab 6 + orgId: 1 + folder: MTUCI + type: file + disableDeletion: false + allowUiUpdates: false + options: + path: /etc/grafana/provisioning/dashboards/json diff --git a/infra/otel/grafana/provisioning/dashboards/json/dashboard.json b/infra/otel/grafana/provisioning/dashboards/json/dashboard.json new file mode 100644 index 0000000..2cda8fd --- /dev/null +++ b/infra/otel/grafana/provisioning/dashboards/json/dashboard.json @@ -0,0 +1,481 @@ +{ + "id": null, + "uid": "mtuci-votchitseva-lab6", + "title": "МТУСИ · ЛР6 · Мессенджер", + "description": "API + RabbitMQ worker, OpenTelemetry Collector, Prometheus, Loki and Tempo. All metric labels are low-cardinality.", + "tags": [ + "mtuci", + "lab6", + "observability" + ], + "timezone": "browser", + "schemaVersion": 40, + "version": 1, + "refresh": "5s", + "time": { + "from": "now-15m", + "to": "now" + }, + "panels": [ + { + "id": 1, + "type": "timeseries", + "title": "API — запросов в секунду", + "datasource": { + "type": "prometheus", + "uid": "prometheus" + }, + "targets": [ + { + "refId": "A", + "expr": "sum(rate(messenger_http_requests_total{route!=\"/health\"}[1m]))", + "legendFormat": "{{service_name}} {{outcome}}" + } + ], + "fieldConfig": { + "defaults": { + "unit": "req/s" + }, + "overrides": [] + }, + "options": { + "legend": { + "displayMode": "list", + "placement": "bottom" + }, + "tooltip": { + "mode": "multi" + } + }, + "gridPos": { + "h": 8, + "w": 12, + "x": 0, + "y": 0 + } + }, + { + "id": 2, + "type": "timeseries", + "title": "API — доля ошибок 5xx", + "datasource": { + "type": "prometheus", + "uid": "prometheus" + }, + "targets": [ + { + "refId": "A", + "expr": "sum(rate(messenger_http_requests_total{route!=\"/health\",status_class=\"5xx\"}[1m])) / clamp_min(sum(rate(messenger_http_requests_total{route!=\"/health\"}[1m])), 0.000001)", + "legendFormat": "{{service_name}} {{outcome}}" + } + ], + "fieldConfig": { + "defaults": { + "unit": "percentunit" + }, + "overrides": [] + }, + "options": { + "legend": { + "displayMode": "list", + "placement": "bottom" + }, + "tooltip": { + "mode": "multi" + } + }, + "gridPos": { + "h": 8, + "w": 12, + "x": 12, + "y": 0 + } + }, + { + "id": 3, + "type": "timeseries", + "title": "HTTP p50", + "datasource": { + "type": "prometheus", + "uid": "prometheus" + }, + "targets": [ + { + "refId": "A", + "expr": "histogram_quantile(0.50, sum by(le) (rate(messenger_http_duration_seconds_bucket{route!=\"/health\"}[5m])))", + "legendFormat": "{{service_name}} {{outcome}}" + } + ], + "fieldConfig": { + "defaults": { + "unit": "s" + }, + "overrides": [] + }, + "options": { + "legend": { + "displayMode": "list", + "placement": "bottom" + }, + "tooltip": { + "mode": "multi" + } + }, + "gridPos": { + "h": 8, + "w": 12, + "x": 0, + "y": 8 + } + }, + { + "id": 4, + "type": "timeseries", + "title": "HTTP p95", + "datasource": { + "type": "prometheus", + "uid": "prometheus" + }, + "targets": [ + { + "refId": "A", + "expr": "histogram_quantile(0.95, sum by(le) (rate(messenger_http_duration_seconds_bucket{route!=\"/health\"}[5m])))", + "legendFormat": "{{service_name}} {{outcome}}" + } + ], + "fieldConfig": { + "defaults": { + "unit": "s" + }, + "overrides": [] + }, + "options": { + "legend": { + "displayMode": "list", + "placement": "bottom" + }, + "tooltip": { + "mode": "multi" + } + }, + "gridPos": { + "h": 8, + "w": 12, + "x": 12, + "y": 8 + } + }, + { + "id": 5, + "type": "timeseries", + "title": "HTTP p99", + "datasource": { + "type": "prometheus", + "uid": "prometheus" + }, + "targets": [ + { + "refId": "A", + "expr": "histogram_quantile(0.99, sum by(le) (rate(messenger_http_duration_seconds_bucket{route!=\"/health\"}[5m])))", + "legendFormat": "{{service_name}} {{outcome}}" + } + ], + "fieldConfig": { + "defaults": { + "unit": "s" + }, + "overrides": [] + }, + "options": { + "legend": { + "displayMode": "list", + "placement": "bottom" + }, + "tooltip": { + "mode": "multi" + } + }, + "gridPos": { + "h": 8, + "w": 12, + "x": 0, + "y": 16 + } + }, + { + "id": 6, + "type": "timeseries", + "title": "Очередь — ожидают обработки", + "datasource": { + "type": "prometheus", + "uid": "prometheus" + }, + "targets": [ + { + "refId": "A", + "expr": "max(messenger_queue_depth)", + "legendFormat": "{{service_name}} {{outcome}}" + } + ], + "fieldConfig": { + "defaults": { + "unit": "short" + }, + "overrides": [] + }, + "options": { + "legend": { + "displayMode": "list", + "placement": "bottom" + }, + "tooltip": { + "mode": "multi" + } + }, + "gridPos": { + "h": 8, + "w": 12, + "x": 12, + "y": 16 + } + }, + { + "id": 7, + "type": "timeseries", + "title": "Очередь — возраст старейшей", + "datasource": { + "type": "prometheus", + "uid": "prometheus" + }, + "targets": [ + { + "refId": "A", + "expr": "max(messenger_queue_oldest_age_seconds)", + "legendFormat": "{{service_name}} {{outcome}}" + } + ], + "fieldConfig": { + "defaults": { + "unit": "s" + }, + "overrides": [] + }, + "options": { + "legend": { + "displayMode": "list", + "placement": "bottom" + }, + "tooltip": { + "mode": "multi" + } + }, + "gridPos": { + "h": 8, + "w": 12, + "x": 0, + "y": 24 + } + }, + { + "id": 8, + "type": "timeseries", + "title": "Worker — jobs/sec", + "datasource": { + "type": "prometheus", + "uid": "prometheus" + }, + "targets": [ + { + "refId": "A", + "expr": "sum by(outcome)(rate(messenger_jobs_total[1m]))", + "legendFormat": "{{service_name}} {{outcome}}" + } + ], + "fieldConfig": { + "defaults": { + "unit": "ops" + }, + "overrides": [] + }, + "options": { + "legend": { + "displayMode": "list", + "placement": "bottom" + }, + "tooltip": { + "mode": "multi" + } + }, + "gridPos": { + "h": 8, + "w": 12, + "x": 12, + "y": 24 + } + }, + { + "id": 9, + "type": "timeseries", + "title": "Worker — p95 обработки", + "datasource": { + "type": "prometheus", + "uid": "prometheus" + }, + "targets": [ + { + "refId": "A", + "expr": "histogram_quantile(0.95, sum by(le) (rate(messenger_job_duration_seconds_bucket[5m])))", + "legendFormat": "{{service_name}} {{outcome}}" + } + ], + "fieldConfig": { + "defaults": { + "unit": "s" + }, + "overrides": [] + }, + "options": { + "legend": { + "displayMode": "list", + "placement": "bottom" + }, + "tooltip": { + "mode": "multi" + } + }, + "gridPos": { + "h": 8, + "w": 12, + "x": 0, + "y": 32 + } + }, + { + "id": 10, + "type": "timeseries", + "title": "Время до ready — p95", + "datasource": { + "type": "prometheus", + "uid": "prometheus" + }, + "targets": [ + { + "refId": "A", + "expr": "histogram_quantile(0.95, sum by(le) (rate(messenger_time_to_ready_seconds_bucket[5m])))", + "legendFormat": "{{service_name}} {{outcome}}" + } + ], + "fieldConfig": { + "defaults": { + "unit": "s" + }, + "overrides": [] + }, + "options": { + "legend": { + "displayMode": "list", + "placement": "bottom" + }, + "tooltip": { + "mode": "multi" + } + }, + "gridPos": { + "h": 8, + "w": 12, + "x": 12, + "y": 32 + } + }, + { + "id": 11, + "type": "timeseries", + "title": "DB pool — занято", + "datasource": { + "type": "prometheus", + "uid": "prometheus" + }, + "targets": [ + { + "refId": "A", + "expr": "sum(messenger_db_pool_used{service_name=\"messenger-api\"})", + "legendFormat": "{{service_name}} {{outcome}}" + } + ], + "fieldConfig": { + "defaults": { + "unit": "short" + }, + "overrides": [] + }, + "options": { + "legend": { + "displayMode": "list", + "placement": "bottom" + }, + "tooltip": { + "mode": "multi" + } + }, + "gridPos": { + "h": 8, + "w": 12, + "x": 0, + "y": 40 + } + }, + { + "id": 12, + "type": "timeseries", + "title": "Worker — загрузка", + "datasource": { + "type": "prometheus", + "uid": "prometheus" + }, + "targets": [ + { + "refId": "A", + "expr": "max(messenger_worker_busy{service_name=\"messenger-worker\"}) / clamp_min(max(messenger_worker_capacity{service_name=\"messenger-worker\"}), 1)", + "legendFormat": "{{service_name}} {{outcome}}" + } + ], + "fieldConfig": { + "defaults": { + "unit": "percentunit" + }, + "overrides": [] + }, + "options": { + "legend": { + "displayMode": "list", + "placement": "bottom" + }, + "tooltip": { + "mode": "multi" + } + }, + "gridPos": { + "h": 8, + "w": 12, + "x": 12, + "y": 40 + } + } + ], + "annotations": { + "list": [ + { + "builtIn": 1, + "datasource": { + "type": "grafana", + "uid": "-- Grafana --" + }, + "enable": true, + "hide": true, + "iconColor": "rgba(0,211,255,1)", + "name": "Annotations & Alerts", + "type": "dashboard" + } + ] + } +} diff --git a/infra/otel/grafana/provisioning/datasources/datasources.yml b/infra/otel/grafana/provisioning/datasources/datasources.yml new file mode 100644 index 0000000..7ffd6ce --- /dev/null +++ b/infra/otel/grafana/provisioning/datasources/datasources.yml @@ -0,0 +1,30 @@ +apiVersion: 1 +datasources: + - name: Prometheus + uid: prometheus + type: prometheus + access: proxy + url: http://prometheus:9090 + isDefault: true + - name: Loki + uid: loki + type: loki + access: proxy + url: http://loki:3100 + jsonData: + derivedFields: + - name: TraceID + matcherRegex: 'trace_id=([0-9a-f]{32})' + datasourceUid: tempo + url: '$${__value.raw}' + - name: Tempo + uid: tempo + type: tempo + access: proxy + url: http://tempo:3200 + jsonData: + tracesToLogsV2: + datasourceUid: loki + filterByTraceID: true + tracesToMetrics: + datasourceUid: prometheus diff --git a/infra/otel/loki/config.yaml b/infra/otel/loki/config.yaml new file mode 100644 index 0000000..6b413aa --- /dev/null +++ b/infra/otel/loki/config.yaml @@ -0,0 +1,27 @@ +auth_enabled: false +server: + http_listen_port: 3100 +common: + 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-01-01 + store: tsdb + object_store: filesystem + schema: v13 + index: + prefix: index_ + period: 24h +limits_config: + allow_structured_metadata: true + retention_period: 168h +analytics: + reporting_enabled: false diff --git a/infra/otel/prometheus/alerts.yml b/infra/otel/prometheus/alerts.yml new file mode 100644 index 0000000..165110c --- /dev/null +++ b/infra/otel/prometheus/alerts.yml @@ -0,0 +1,23 @@ +groups: + - name: lab6-signals + interval: 5s + rules: + - alert: MessengerHighErrorRate + expr: | + (sum(rate(messenger_http_requests_total{route!="/health",status_class="5xx"}[1m])) + / clamp_min(sum(rate(messenger_http_requests_total{route!="/health"}[1m])), 0.000001)) > 0.10 + and sum(rate(messenger_http_requests_total{route!="/health"}[1m])) > 0.05 + for: 15s + labels: + severity: warning + annotations: + summary: '5xx responses exceed 10% of business requests' + runbook: 'Check API error rate, Loki errors, Tempo DB spans and postgres health' + - alert: MessengerQueueLagGrowing + expr: max(messenger_queue_oldest_age_seconds) > 20 + for: 15s + labels: + severity: warning + annotations: + summary: 'Oldest queued attachment is older than 20 seconds' + runbook: 'Check worker status, RabbitMQ queue and job failure spans in Tempo' diff --git a/infra/otel/prometheus/prometheus.yml b/infra/otel/prometheus/prometheus.yml new file mode 100644 index 0000000..d251ae1 --- /dev/null +++ b/infra/otel/prometheus/prometheus.yml @@ -0,0 +1,12 @@ +global: + scrape_interval: 5s + evaluation_interval: 5s +rule_files: + - /etc/prometheus/alerts.yml +scrape_configs: + - job_name: collector + static_configs: + - targets: ['otel-collector:8889'] + - job_name: prometheus + static_configs: + - targets: ['localhost:9090'] diff --git a/infra/otel/tempo/config.yaml b/infra/otel/tempo/config.yaml new file mode 100644 index 0000000..b7188a1 --- /dev/null +++ b/infra/otel/tempo/config.yaml @@ -0,0 +1,18 @@ +server: + http_listen_port: 3200 +distributor: + receivers: + otlp: + protocols: + grpc: + endpoint: 0.0.0.0:4317 +storage: + trace: + backend: local + wal: + path: /var/tempo/wal + local: + path: /var/tempo/traces +compactor: + compaction: + block_retention: 168h diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..2b8060d --- /dev/null +++ b/requirements.txt @@ -0,0 +1,14 @@ +fastapi==0.115.4 +uvicorn==0.32.0 +sqlalchemy==2.0.36 +asyncpg==0.30.0 +redis==5.2.0 +passlib[bcrypt]==1.7.4 +bcrypt==4.0.1 +python-dotenv==1.0.1 +boto3==1.40.67 +Pillow==11.3.0 +aio-pika==9.4.3 +opentelemetry-api==1.39.1 +opentelemetry-sdk==1.39.1 +opentelemetry-exporter-otlp-proto-http==1.39.1 \ No newline at end of file diff --git a/scripts/check_grade4.py b/scripts/check_grade4.py new file mode 100644 index 0000000..ec63649 --- /dev/null +++ b/scripts/check_grade4.py @@ -0,0 +1,13 @@ +"""Convenience runner. Does not fabricate evidence or control Docker itself.""" +import subprocess +import sys +from pathlib import Path +ROOT = Path(__file__).resolve().parents[1] +for command in ( + [sys.executable, str(ROOT / "tests/smoke.py")], + [sys.executable, str(ROOT / "student-tests/run.py")], + [sys.executable, str(ROOT / "student-tests/test_attachments.py")], +): + print("RUN:", " ".join(command), flush=True) + subprocess.run(command, cwd=ROOT, check=True) +print("PASS: public smoke + lab3 concurrency + grade4 negative cases; run extra resilience and memory experiment separately") diff --git a/scripts/experiment_uploads.py b/scripts/experiment_uploads.py new file mode 100644 index 0000000..1dcebb7 --- /dev/null +++ b/scripts/experiment_uploads.py @@ -0,0 +1,71 @@ +"""10 simultaneous real uploads + Docker RSS observations (NO invented metrics).""" +import concurrent.futures +import json +import subprocess +import sys +import threading +import time +from pathlib import Path +from statistics import median +ROOT = Path(__file__).resolve().parents[1] +sys.path.insert(0, str(ROOT / 'tests')) +from client import Client, check, arguments, run + + +def mib(value): + value = value.strip() + for suffix, multiplier in (("GiB",1024),("MiB",1),("KiB",1/1024),("B",1/1048576)): + if value.endswith(suffix): + return float(value[:-len(suffix)]) * multiplier + return None + + +def main(): + args = arguments('Concurrent uploads + observed API container memory') + client = Client(args.base_url, args.ca_file, timeout=30) + alice, bob, eve, chat = client.bootstrap() + file = (ROOT / 'tests/fixtures/sample.png').read_bytes() + results, memory = [], [] + stop = threading.Event() + def observe(): + while not stop.is_set(): + r = subprocess.run(['docker','stats','--no-stream','--format','{{.Name}}|{{.MemUsage}}'], + capture_output=True, text=True, timeout=10) + if r.returncode == 0: + for line in r.stdout.splitlines(): + if '|api1-' in line or '|api2-' in line: + pass + parts = line.split('|') + if len(parts)==2 and ('api1-' in parts[0] or 'api2-' in parts[0]): + amount = mib(parts[1].split('/')[0]) + if amount is not None: + memory.append({'container': parts[0], 'mem_mib': round(amount,3)}) + stop.wait(0.2) + monitor = threading.Thread(target=observe, daemon=True) + monitor.start() + try: + def worker(i): + local = Client(args.base_url,args.ca_file,timeout=30) + start=time.perf_counter() + resp=local.call('POST', f'/api/v1/chats/{chat["id"]}/attachments?filename=run{i}.png', + 202, actor=alice, raw=file, headers={'Content-Type':'image/png'}, schema='Attachment') + return {'elapsed_ms':round((time.perf_counter()-start)*1000,2), 'instance': resp['headers'].get('X-Instance-Id')} + with concurrent.futures.ThreadPoolExecutor(max_workers=10) as executor: + futures=[executor.submit(worker,i) for i in range(10)] + results=[f.result() for f in concurrent.futures.as_completed(futures)] + finally: + stop.set(); monitor.join(timeout=12) + output={'concurrency':10,'file_bytes':len(file),'completed':len(results), + 'median_latency_ms':round(median(x['elapsed_ms'] for x in results),2), + 'api_peak_mem_mib_observed':max([x['mem_mib'] for x in memory],default=None), + 'memory_samples':len(memory),'instances':sorted(set(x['instance'] for x in results))} + target=ROOT / 'evidence' / 'uploads-10.json' + target.write_text(json.dumps(output,ensure_ascii=False,indent=2),encoding='utf-8') + check(len(results)==10, 'not all uploads completed') + print('PASS: 10 parallel uploads; metrics written:',target) + print(json.dumps(output, ensure_ascii=False, indent=2)) + if not memory: + print('WARNING: no Docker memory samples; run docker stats separately for a valid grade-4 experiment') + +if __name__ == '__main__': + run(main) diff --git a/scripts/incident_worker.py b/scripts/incident_worker.py new file mode 100644 index 0000000..d18c27c --- /dev/null +++ b/scripts/incident_worker.py @@ -0,0 +1,95 @@ +import argparse +import base64 +import json +import secrets +import subprocess +import time +import urllib.error +import urllib.request +from pathlib import Path + +BASE = 'http://localhost:8080' + + +def call(method, url, body=None, headers=None): + request = urllib.request.Request(url, data=body, headers=headers or {}, method=method) + try: + with urllib.request.urlopen(request, timeout=15) as response: + raw = response.read() + return response.status, json.loads(raw) if raw else {} + except urllib.error.HTTPError as error: + raw = error.read() + return error.code, json.loads(raw) if raw else {} + + +def json_request(method, path, data, auth=None): + headers = {'Content-Type':'application/json'} + if auth: + headers['Authorization'] = 'Bearer '+auth + return call(method, BASE+path, json.dumps(data).encode(), headers) + + +def docker(*args): + subprocess.run(['docker', 'compose', *args], check=True) + + +def alerts(): + try: + code, result = call('GET', 'http://localhost:9090/api/v1/alerts') + if code == 200: + return {a['labels'].get('alertname'):a['state'] for a in result['data']['alerts']} + except Exception: + pass + return {} + + +def main(): + cli = argparse.ArgumentParser() + cli.add_argument('--hold', type=int, default=50) + opts = cli.parse_args() + username = 'obs'+secrets.token_hex(6) + password = secrets.token_urlsafe(24) + status, user = json_request('POST','/api/v1/users',{'username':username,'password':password,'display_name':'Lab6 Test'}) + assert status == 201, user + basic = base64.b64encode((username+':'+password).encode()).decode() + status, auth = call('POST',BASE+'/api/v1/auth/sessions',b'',{'Authorization':'Basic '+basic}) + assert status == 201, auth + token = auth['token'] + status, chat = json_request('POST','/api/v1/chats',{'title':'Lab6 Incident','member_ids':[user['id']]},token) + assert status == 201, chat + docker('stop','worker') + ready = False + try: + sample = Path('tests/fixtures/sample.png').read_bytes() + status, attachment = call('POST', BASE+f"/api/v1/chats/{chat['id']}/attachments?filename=sample.png", + sample, {'Content-Type':'image/png','Authorization':'Bearer '+token}) + assert status == 202 and attachment['status'] == 'queued', (status,attachment) + attachment_id = attachment['id'] + status, _ = call('GET',BASE+f'/api/v1/attachments/{attachment_id}/content',None,{'Authorization':'Bearer '+token}) + assert status == 409, status + print('202 queued; content 409; worker stopped') + time.sleep(opts.hold) + before = alerts().get('MessengerQueueLagGrowing','not_observed') + print('QueueLag alert:',before) + finally: + docker('start','worker') + deadline = time.monotonic()+100 + while time.monotonic() 202 queued -> restart -> ready', + 'attachment_id':attachment_id,'status':'ready','variants':names, + 'queue_alert_before_worker_start':before,'passed':True} + Path('evidence').mkdir(exist_ok=True) + Path('evidence/worker-incident.json').write_text(json.dumps(result,indent=2),encoding='utf-8') + print('PASS worker recovery:',json.dumps(result,ensure_ascii=False)) + + +if __name__=='__main__': + main() diff --git a/scripts/ops.py b/scripts/ops.py new file mode 100644 index 0000000..344deb1 --- /dev/null +++ b/scripts/ops.py @@ -0,0 +1,112 @@ +#!/usr/bin/env python3 +"""Operator actions for the local Compose stand; volumes are kept.""" +import argparse +import json +import os +from pathlib import Path +import subprocess +import time +import urllib.error +import urllib.request + +ROOT = Path(__file__).resolve().parents[1] +SERVICES = ("api1", "api2") +BASE_URL = os.environ.get("BASE_URL", "http://localhost:8080").rstrip("/") + + +def compose(*args, capture=False): + result = subprocess.run(["docker", "compose", *args], cwd=ROOT, check=True, + text=True, stdout=subprocess.PIPE if capture else None) + return result.stdout.strip() if capture else None + + +def state(service): + cid = compose("ps", "--all", "--quiet", service, capture=True) + if not cid: + raise RuntimeError("No container for " + service) + result = subprocess.check_output( + ["docker", "inspect", "--format", + '{{json .Config.Hostname}} {{json .State.Status}}', cid], text=True) + hostname, status = result.strip().split() + return {"service": service, "container": cid[:12], + "hostname": json.loads(hostname), "status": json.loads(status)} + + +def wait_instances(count=2, timeout=40): + deadline = time.monotonic() + timeout + seen = set() + while time.monotonic() < deadline: + try: + with urllib.request.urlopen(BASE_URL + "/health/ready", timeout=2) as r: + instance = r.headers.get("X-Instance-Id") + if instance: + seen.add(instance) + if len(seen) >= count: + return seen + except (OSError, urllib.error.URLError): + pass + time.sleep(0.2) + raise RuntimeError("Not enough ready API instances through LB") + + +def stop_one(service=None): + target = os.environ.get("TARGET_INSTANCE_ID", "").split(":", 1)[0] + if target: + service = next((s for s in SERVICES if state(s)["hostname"] == target), None) + if not service: + raise RuntimeError("TARGET_INSTANCE_ID is not an API container") + service = service or "api1" + if service not in SERVICES: + raise RuntimeError("Only API replicas may be stopped") + compose("kill", "--signal", "SIGKILL", service) + current = state(service) + if current["status"] != "exited": + raise RuntimeError("API did not stop") + print(json.dumps(current)) + + +def restore(): + compose("up", "-d", "--no-deps", "--no-build", "--wait", "--wait-timeout", "40", *SERVICES) + wait_instances() + + +def restart(): + compose("down") + compose("up", "-d", "--no-build", "--wait", "--wait-timeout", "60") + wait_instances() + + +def rolling_update(): + phases = [] + compose("build", "api1") + # This migration only adds tables and is compatible with the old API. + compose("run", "--rm", "--no-deps", "migrate") + for service in SERVICES: + before = state(service) + started = time.monotonic() + compose("up", "-d", "--no-deps", "--no-build", "--force-recreate", + "--wait", "--wait-timeout", "40", service) + after = state(service) + if before["container"] == after["container"]: + raise RuntimeError("Container was not replaced") + seen = wait_instances() + if not any(i.split(":", 1)[0] == after["hostname"] for i in seen): + raise RuntimeError("LB has not discovered the replacement") + phases.append({"service": service, "started": started, "finished": time.monotonic()}) + print(json.dumps({"replaced": service, "before": before, "after": after})) + return phases + + +def main(): + parser = argparse.ArgumentParser() + parser.add_argument("action", choices=["restart", "stop-one", "restore", "rolling-update"]) + parser.add_argument("--service", choices=SERVICES) + args = parser.parse_args() + if args.action == "stop-one": + stop_one(args.service) + else: + {"restart": restart, "restore": restore, "rolling-update": rolling_update}[args.action]() + + +if __name__ == "__main__": + main() diff --git a/scripts/restart.cmd b/scripts/restart.cmd new file mode 100644 index 0000000..921e224 --- /dev/null +++ b/scripts/restart.cmd @@ -0,0 +1,4 @@ +@echo off +cd /d "%~dp0.." +python scripts\ops.py restart +exit /b %errorlevel% diff --git a/scripts/restart.sh b/scripts/restart.sh new file mode 100644 index 0000000..da01f20 --- /dev/null +++ b/scripts/restart.sh @@ -0,0 +1,4 @@ +#!/bin/sh +set -eu +cd "$(dirname "$0")/.." +exec python3 scripts/ops.py restart diff --git a/scripts/stop-one.cmd b/scripts/stop-one.cmd new file mode 100644 index 0000000..8c3cce5 --- /dev/null +++ b/scripts/stop-one.cmd @@ -0,0 +1,4 @@ +@echo off +cd /d "%~dp0.." +python scripts\ops.py stop-one +exit /b %errorlevel% diff --git a/scripts/stop-one.sh b/scripts/stop-one.sh new file mode 100644 index 0000000..c7b8ec5 --- /dev/null +++ b/scripts/stop-one.sh @@ -0,0 +1,4 @@ +#!/bin/sh +set -eu +cd "$(dirname "$0")/.." +exec python3 scripts/ops.py stop-one diff --git a/src/__init__.py b/src/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/src/__main__.py b/src/__main__.py new file mode 100644 index 0000000..d9e021d --- /dev/null +++ b/src/__main__.py @@ -0,0 +1,24 @@ +"""Entry point: uvicorn as PID 1 with env-driven host/port and graceful shutdown.""" +import os + +import uvicorn + +from .main import app + + +def main() -> None: + host = os.environ.get("APP_HOST", "0.0.0.0") + port = int(os.environ.get("APP_PORT", "8080")) + uvicorn.run( + app, + host=host, + port=port, + log_level="info", + access_log=True, + timeout_keep_alive=2, + timeout_graceful_shutdown=5, + ) + + +if __name__ == "__main__": + main() diff --git a/src/auth.py b/src/auth.py new file mode 100644 index 0000000..b9d77a4 --- /dev/null +++ b/src/auth.py @@ -0,0 +1,29 @@ +import os +import secrets +import redis.asyncio as redis +from passlib.context import CryptContext + +# bcrypt_sha256 avoids bcrypt's 72-byte limit. Old lab2 hashes still verify. +pwd_context = CryptContext(schemes=["bcrypt_sha256", "bcrypt"], deprecated="auto") +CACHE_URL = os.environ.get("CACHE_URL", "redis://localhost:6379/0") +SESSION_TTL_SECONDS = int(os.environ.get("SESSION_TTL_SECONDS", "3600")) + +redis_client = redis.from_url(CACHE_URL, decode_responses=True, + socket_connect_timeout=1, socket_timeout=1) + +def hash_password(password: str) -> str: + return pwd_context.hash(password) + +def verify_password(plain_password: str, hashed_password: str) -> bool: + return pwd_context.verify(plain_password, hashed_password) + +async def create_session(user_id: str) -> str: + token = secrets.token_urlsafe(32) + await redis_client.setex(f"session:{token}", SESSION_TTL_SECONDS, user_id) + return token + +async def get_user_id_by_token(token: str) -> str | None: + return await redis_client.get(f"session:{token}") + +async def delete_session(token: str) -> None: + await redis_client.delete(f"session:{token}") diff --git a/src/db.py b/src/db.py new file mode 100644 index 0000000..54d7165 --- /dev/null +++ b/src/db.py @@ -0,0 +1,112 @@ +import os +from datetime import datetime, timezone +from typing import List +from uuid import UUID, uuid4 + +from sqlalchemy import String, ForeignKey, DateTime, Index, Integer, BigInteger +from sqlalchemy.dialects.postgresql import UUID as PG_UUID, JSONB +from sqlalchemy.ext.asyncio import create_async_engine, async_sessionmaker +from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column, relationship + +DATABASE_URL = os.environ.get("DATABASE_URL", "postgresql+asyncpg://user:password@localhost:5432/messenger") +engine = create_async_engine( + DATABASE_URL, echo=False, pool_pre_ping=True, pool_size=5, max_overflow=5, + pool_timeout=2, connect_args={"timeout": 1, "command_timeout": 3, + "server_settings": {"statement_timeout": "2500", "lock_timeout": "2000"}}, +) +async_session = async_sessionmaker(engine, expire_on_commit=False) + +class Base(DeclarativeBase): + pass + +class User(Base): + __tablename__ = "users" + id: Mapped[UUID] = mapped_column(PG_UUID(as_uuid=True), primary_key=True, default=uuid4) + username: Mapped[str] = mapped_column(String(32), unique=True, index=True) + display_name: Mapped[str] = mapped_column(String(100)) + password_hash: Mapped[str] = mapped_column(String(255)) + created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=lambda: datetime.now(timezone.utc)) + +class Chat(Base): + __tablename__ = "chats" + id: Mapped[UUID] = mapped_column(PG_UUID(as_uuid=True), primary_key=True, default=uuid4) + title: Mapped[str] = mapped_column(String(100)) + created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=lambda: datetime.now(timezone.utc)) + members: Mapped[List["ChatMember"]] = relationship(back_populates="chat", lazy="selectin") + +class ChatMember(Base): + __tablename__ = "chat_members" + chat_id: Mapped[UUID] = mapped_column(PG_UUID(as_uuid=True), ForeignKey("chats.id", ondelete="CASCADE"), primary_key=True) + user_id: Mapped[UUID] = mapped_column(PG_UUID(as_uuid=True), ForeignKey("users.id", ondelete="CASCADE"), primary_key=True) + chat: Mapped["Chat"] = relationship(back_populates="members") + user: Mapped["User"] = relationship() + +class Message(Base): + __tablename__ = "messages" + id: Mapped[UUID] = mapped_column(PG_UUID(as_uuid=True), primary_key=True, default=uuid4) + chat_id: Mapped[UUID] = mapped_column(PG_UUID(as_uuid=True), ForeignKey("chats.id", ondelete="CASCADE"), index=True) + sender_id: Mapped[UUID] = mapped_column(PG_UUID(as_uuid=True), ForeignKey("users.id")) + text: Mapped[str] = mapped_column(String(4000)) + created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=lambda: datetime.now(timezone.utc)) + + __table_args__ = ( + Index('ix_messages_chat_created_id', 'chat_id', 'created_at', 'id'), + ) + +class IdempotencyKey(Base): + __tablename__ = "idempotency_keys" + user_id: Mapped[UUID] = mapped_column(PG_UUID(as_uuid=True), ForeignKey("users.id"), primary_key=True) + chat_id: Mapped[UUID] = mapped_column(PG_UUID(as_uuid=True), ForeignKey("chats.id"), primary_key=True) + key: Mapped[str] = mapped_column(String(128), primary_key=True) + request_text: Mapped[str] = mapped_column(String(4000)) + response: Mapped[dict | None] = mapped_column(JSONB, nullable=True) + request_attachment_ids: Mapped[list] = mapped_column(JSONB, default=list, nullable=False) + expires_at: Mapped[datetime] = mapped_column(DateTime(timezone=True)) + +class SchemaVersion(Base): + __tablename__ = "schema_versions" + version: Mapped[int] = mapped_column(Integer, primary_key=True) + +class Attachment(Base): + __tablename__ = "attachments" + id: Mapped[UUID] = mapped_column(PG_UUID(as_uuid=True), primary_key=True, default=uuid4) + chat_id: Mapped[UUID] = mapped_column(PG_UUID(as_uuid=True), ForeignKey("chats.id"), index=True, nullable=False) + owner_id: Mapped[UUID] = mapped_column(PG_UUID(as_uuid=True), ForeignKey("users.id"), nullable=False) + filename: Mapped[str] = mapped_column(String(255), nullable=False) + object_key: Mapped[str] = mapped_column(String(250), unique=True, nullable=False) + content_type: Mapped[str] = mapped_column(String(32), nullable=False) + size_bytes: Mapped[int] = mapped_column(BigInteger, nullable=False) + sha256: Mapped[str] = mapped_column(String(64), nullable=False) + status: Mapped[str] = mapped_column(String(16), default="queued", nullable=False) + attempts: Mapped[int] = mapped_column(Integer, default=0, nullable=False) + error_code: Mapped[str | None] = mapped_column(String(64), nullable=True) + created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=lambda: datetime.now(timezone.utc), nullable=False) + updated_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=lambda: datetime.now(timezone.utc), onupdate=lambda: datetime.now(timezone.utc), nullable=False) + +class MessageAttachment(Base): + __tablename__ = "message_attachments" + message_id: Mapped[UUID] = mapped_column(PG_UUID(as_uuid=True), ForeignKey("messages.id", ondelete="CASCADE"), primary_key=True) + attachment_id: Mapped[UUID] = mapped_column(PG_UUID(as_uuid=True), ForeignKey("attachments.id"), primary_key=True) + position: Mapped[int] = mapped_column(Integer, nullable=False) + +# --- НОВЫЕ ТАБЛИЦЫ ДЛЯ 5-Й ЛАБЫ --- +class AttachmentVariant(Base): + __tablename__ = "attachment_variants" + id: Mapped[UUID] = mapped_column(PG_UUID(as_uuid=True), primary_key=True, default=uuid4) + attachment_id: Mapped[UUID] = mapped_column(PG_UUID(as_uuid=True), ForeignKey("attachments.id", ondelete="CASCADE"), index=True) + name: Mapped[str] = mapped_column(String(32), nullable=False) + object_key: Mapped[str] = mapped_column(String(250), unique=True, nullable=False) + content_type: Mapped[str] = mapped_column(String(32), nullable=False) + size_bytes: Mapped[int] = mapped_column(BigInteger, nullable=False) + width: Mapped[int] = mapped_column(Integer, nullable=False) + height: Mapped[int] = mapped_column(Integer, nullable=False) + sha256: Mapped[str] = mapped_column(String(64), nullable=False) + +class Outbox(Base): + __tablename__ = "outbox" + id: Mapped[UUID] = mapped_column(PG_UUID(as_uuid=True), primary_key=True, default=uuid4) + event_type: Mapped[str] = mapped_column(String(64), nullable=False) + payload: Mapped[dict] = mapped_column(JSONB, nullable=False) + created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=lambda: datetime.now(timezone.utc), nullable=False) + processed_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True) + available_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=lambda: datetime.now(timezone.utc), nullable=False) \ No newline at end of file diff --git a/src/images.py b/src/images.py new file mode 100644 index 0000000..a014c54 --- /dev/null +++ b/src/images.py @@ -0,0 +1,112 @@ +"""Validate compressed image bytes without trusting filename or HTTP Content-Type.""" +import os +import threading +import struct +import zlib +import io +import hashlib +from PIL import Image, ImageFile, UnidentifiedImageError, ImageOps +from .storage import MAX_IMAGE_PIXELS + +# Prevent unrestricted decompression of malicious image dimensions. +Image.MAX_IMAGE_PIXELS = MAX_IMAGE_PIXELS +ImageFile.LOAD_TRUNCATED_IMAGES = False +_IMAGE_LOCK = threading.BoundedSemaphore(1) + +class InvalidImage(Exception): + pass + +class TooManyPixels(Exception): + pass + + +def validate_image_file(file, declared_type: str) -> None: + """Проверяет, что файл является валидным PNG/JPEG и не превышает лимиты.""" + expected = {"image/png": "PNG", "image/jpeg": "JPEG"}.get(declared_type) + if not expected: + raise InvalidImage("unsupported image type") + with _IMAGE_LOCK: + try: + file.seek(0) + with Image.open(file) as probe: + if probe.format != expected: + raise InvalidImage("image MIME does not match its content") + width, height = probe.size + if width <= 0 or height <= 0: + raise InvalidImage("image dimensions are invalid") + if width * height > MAX_IMAGE_PIXELS: + raise TooManyPixels("image dimensions exceed limit") + probe.verify() # verify compressed structure + file.seek(0) + with Image.open(file) as loaded: + loaded.load() # detect damaged truncated payloads + except Image.DecompressionBombError as e: + raise TooManyPixels("image dimensions exceed limit") from e + except Image.DecompressionBombWarning as e: + raise TooManyPixels("image dimensions exceed limit") from e + except (UnidentifiedImageError, OSError, ValueError, SyntaxError, EOFError, struct.error, zlib.error) as e: + raise InvalidImage("invalid or truncated PNG/JPEG") from e + finally: + file.seek(0) + + +def make_thumbnail(file_bytes: bytes) -> tuple[bytes, int, int, str]: + """ + Создает JPEG-превью (вписанное в 256x256) из сырых байтов. + Возвращает: (байты_превью, ширина, высота, sha256_превью). + """ + with _IMAGE_LOCK: + with Image.open(io.BytesIO(file_bytes)) as img: + # 1. Применяем EXIF orientation (если картинку сфоткали на телефон боком) + img = ImageOps.exif_transpose(img) + + # 2. Компонуем прозрачность (RGBA, LA) на белый фон + if img.mode in ("RGBA", "LA") or (img.mode == "P" and "transparency" in img.info): + bg = Image.new("RGB", img.size, (255, 255, 255)) + bg.paste(img, mask=img.convert("RGBA").split()[3]) + img = bg + elif img.mode != "RGB": + # На всякий случай конвертируем все остальные режимы (например, CMYK) в RGB + img = img.convert("RGB") + + # 3. Вписываем в квадрат 256x256 (метод thumbnail сохраняет пропорции и не увеличивает маленькие картинки) + img.thumbnail((256, 256), Image.Resampling.LANCZOS) + + width, height = img.size + + # 4. Сохраняем в JPEG + out_buf = io.BytesIO() + img.save(out_buf, format="JPEG", quality=85) + data = out_buf.getvalue() + + # 5. Считаем хэш для метаданных + sha256 = hashlib.sha256(data).hexdigest() + + return data, width, height, sha256 + +def make_variants(data): + import io + import hashlib + from PIL import Image, ImageOps + thumb_bytes, tw, th, tsha = make_thumbnail(data) + outputs = [('thumbnail', thumb_bytes, 'image/jpeg', tw, th, tsha)] + with _IMAGE_LOCK: + with Image.open(io.BytesIO(data)) as original: + image = ImageOps.exif_transpose(original) + if image.mode in ('RGBA', 'LA') or (image.mode == 'P' and 'transparency' in image.info): + rgba = image.convert('RGBA') + canvas = Image.new('RGB', image.size, 'white') + canvas.paste(rgba, mask=rgba.getchannel('A')) + image = canvas + else: + image = image.convert('RGB') + crop = ImageOps.fit(image, (128, 128), Image.Resampling.LANCZOS, centering=(0.5,0.5)) + optimized = image.copy() + optimized.thumbnail((1280, 1280), Image.Resampling.LANCZOS) + for name, picture, fmt, quality in [('crop',crop,'JPEG',85), ('optimized',optimized,'WEBP',80)]: + stream = io.BytesIO() + picture.save(stream, format=fmt, quality=quality) + raw = stream.getvalue() + outputs.append((name,raw,'image/webp' if fmt=='WEBP' else 'image/jpeg', + picture.width,picture.height,hashlib.sha256(raw).hexdigest())) + return outputs diff --git a/src/main.py b/src/main.py new file mode 100644 index 0000000..722895d --- /dev/null +++ b/src/main.py @@ -0,0 +1,600 @@ +from __future__ import annotations +import base64 +import hashlib +from tempfile import SpooledTemporaryFile +from botocore.exceptions import ClientError, BotoCoreError +import asyncio +import binascii +import json +import logging +import os +import re +import socket +import uuid +from contextlib import asynccontextmanager +from datetime import datetime, timezone, timedelta +from typing import Optional + +import aio_pika +from fastapi import Depends, FastAPI, Request, Query +from fastapi.exceptions import RequestValidationError +from fastapi.responses import JSONResponse, StreamingResponse +from fastapi.security import HTTPBearer, HTTPAuthorizationCredentials +from pydantic import BaseModel, ConfigDict, Field, field_validator +from sqlalchemy import select, and_, or_, text +from sqlalchemy.dialects.postgresql import insert +from sqlalchemy.exc import IntegrityError, SQLAlchemyError +from starlette.concurrency import run_in_threadpool +from starlette.exceptions import HTTPException as StarletteHTTPException +from redis.exceptions import RedisError + +from asyncpg import PostgresError +from .db import engine, async_session, User, Chat, ChatMember, Message, IdempotencyKey, Attachment, MessageAttachment, Outbox, AttachmentVariant +from .auth import hash_password, verify_password, create_session, get_user_id_by_token, delete_session, redis_client, SESSION_TTL_SECONDS +from .storage import s3, bucket, check_storage, upload_original, delete_original, download_original, StorageFailure, MAX_UPLOAD_BYTES +from .images import validate_image_file, InvalidImage, TooManyPixels +from .telemetry import telemetry, trace, inject, extract, SpanKind, Status, StatusCode + +USERNAME_RE = re.compile(r"^[a-z0-9_]{3,32}$") +KEY_RE = re.compile(r"[A-Za-z0-9._:-]{1,128}", re.ASCII) +INSTANCE_ID = socket.gethostname() + ":" + str(os.getpid()) +BROKER_URL = os.getenv("BROKER_URL", "amqp://guest:guest@broker:5672/") +QUEUE_NAME = "attachment.process.v1" + +def now_iso(dt: datetime = None) -> str: + if not dt: + dt = datetime.now(timezone.utc) + return dt.strftime("%Y-%m-%dT%H:%M:%S.%fZ") + +def error_payload(request_id: str, code: str, message: str) -> dict: + return {"error": {"code": code, "message": message, "request_id": request_id}} + +class ApiError(Exception): + def __init__(self, status: int, code: str, message: str): + self.status = status + self.code = code + self.message = message + super().__init__(message) + +# --- Курсоры для пагинации --- +def _encode_cursor(scope: str, created_at: datetime, obj_id: uuid.UUID) -> str: + raw = f"{scope}|{created_at.isoformat()}|{obj_id}".encode("utf-8") + return base64.urlsafe_b64encode(raw).rstrip(b"=").decode("ascii") + +def _decode_cursor(cursor: str) -> tuple[str, datetime, uuid.UUID]: + try: + padded = cursor + "=" * (-len(cursor) % 4) + raw = base64.urlsafe_b64decode(padded).decode("utf-8") + scope, dt_str, obj_id_str = raw.split("|", 2) + dt = datetime.fromisoformat(dt_str) + if dt.tzinfo is None: + raise ValueError("timezone required") + return scope, dt, uuid.UUID(obj_id_str) + except Exception: + raise ApiError(400, "invalid_request", "invalid cursor") + +# --- Фоновая задача: Relayer для Outbox --- +async def observe_queue(): + while True: + try: + async with async_session() as session: + row = (await session.execute(text(""" + SELECT count(*) FILTER (WHERE status='queued') AS queued, + coalesce(extract(epoch from now() - min(created_at) + FILTER (WHERE status='queued')), 0) AS age + FROM attachments + """))).one() + telemetry.queue_depth = int(row.queued) + telemetry.queue_age = max(0.0, float(row.age)) + telemetry.db_used = int(engine.pool.checkedout()) + try: + telemetry.db_waiting = len(engine.pool._pool._queue._getters) + except AttributeError: + telemetry.db_waiting = 0 + except Exception: + telemetry.event('queue_metrics_unavailable') + await asyncio.sleep(5) + +async def outbox_relayer(): + while True: + try: + connection = await aio_pika.connect_robust(BROKER_URL) + channel = await connection.channel(publisher_confirms=True) + await channel.declare_queue(QUEUE_NAME, durable=True) + break + except Exception: + telemetry.event('broker_connection_retry') + await asyncio.sleep(5) + + try: + while True: + try: + async with async_session() as session: + records = (await session.scalars( + select(Outbox).where(Outbox.processed_at == None, Outbox.available_at <= datetime.now(timezone.utc)) + .with_for_update(skip_locked=True).limit(10) + )).all() + for record in records: + parent = extract(record.payload) + with telemetry.tracer.start_as_current_span( + 'rabbitmq publish attachment', context=parent, kind=SpanKind.PRODUCER): + carrier = {} + inject(carrier) + await channel.default_exchange.publish( + aio_pika.Message( + body=json.dumps({'attachment_id': record.payload['attachment_id']}).encode(), + headers=carrier, + delivery_mode=aio_pika.DeliveryMode.PERSISTENT), + routing_key=QUEUE_NAME, mandatory=True) + telemetry.event('job_published', job_type='attachment') + record.processed_at = datetime.now(timezone.utc) + await session.commit() + except Exception: + telemetry.event('outbox_publish_retry') + await asyncio.sleep(2) + await asyncio.sleep(0.5) + finally: + await connection.close() + +@asynccontextmanager +async def lifespan(app: FastAPI): + tasks = [asyncio.create_task(outbox_relayer()), asyncio.create_task(observe_queue())] + yield + for task in tasks: + task.cancel() + await asyncio.gather(*tasks, return_exceptions=True) + await redis_client.aclose() + await engine.dispose() + telemetry.shutdown() + +app = FastAPI(title="Messenger", version="1.6.0", lifespan=lifespan) +security_bearer = HTTPBearer(auto_error=False) + +@app.middleware("http") +async def request_id_middleware(request: Request, call_next): + request_id = request.headers.get('X-Request-Id') or str(uuid.uuid4()) + request.state.request_id = request_id + start = __import__('time').monotonic() + remote_context = extract(request.headers) + method = request.method + with telemetry.tracer.start_as_current_span( + 'HTTP ' + method, context=remote_context, kind=SpanKind.SERVER) as span: + try: + response = await call_next(request) + except Exception: + response = JSONResponse(status_code=500, content=error_payload(request_id, 'internal_error', 'internal error')) + response.headers['X-Request-Id'] = request_id + response.headers['X-Instance-Id'] = INSTANCE_ID + route_obj = request.scope.get('route') + route = getattr(route_obj, 'path', '/unmatched') + if route.startswith('/health/'): + route = '/health' + status_class = str(response.status_code // 100) + 'xx' + attrs = {'method':method,'route':route,'status_class':status_class} + span.set_attribute('http.request.method', method) + span.set_attribute('http.route', route) + span.set_attribute('http.response.status_code', response.status_code) + if response.status_code >= 500: + span.set_status(Status(StatusCode.ERROR)) + telemetry.requests.add(1, attrs) + telemetry.http_duration.record(__import__('time').monotonic()-start, attrs) + telemetry.event('http_request', method=method, route=route, + status=response.status_code, request_id=request_id) + return response + +def _rid(request: Request) -> str: + return getattr(request.state, "request_id", None) or str(uuid.uuid4()) + +# --- Обработчики ошибок --- +@app.exception_handler(ApiError) +async def api_error_handler(request: Request, exc: ApiError): + headers = {} + if exc.status == 401: + if request.url.path == "/api/v1/auth/sessions": + headers["WWW-Authenticate"] = 'Basic realm="messenger", charset="UTF-8"' + else: + headers["WWW-Authenticate"] = 'Bearer realm="messenger"' + return JSONResponse(status_code=exc.status, content=error_payload(_rid(request), exc.code, exc.message), headers=headers) + +@app.exception_handler(RequestValidationError) +async def validation_error_handler(request: Request, exc: RequestValidationError): + return JSONResponse(status_code=400, content=error_payload(_rid(request), "invalid_request", "invalid request")) + +@app.exception_handler(StarletteHTTPException) +async def http_exception_handler(request: Request, exc: StarletteHTTPException): + return JSONResponse(status_code=exc.status_code, content=error_payload(_rid(request), "not_found", str(exc.detail))) + +@app.exception_handler(InvalidImage) +async def invalid_image_handler(request: Request, exc: InvalidImage): + return JSONResponse(status_code=415, content=error_payload(_rid(request), "unsupported_media_type", str(exc))) + +@app.exception_handler(TooManyPixels) +async def too_large_image_handler(request: Request, exc: TooManyPixels): + return JSONResponse(status_code=413, content=error_payload(_rid(request), "payload_too_large", str(exc))) + +@app.exception_handler(RedisError) +@app.exception_handler(SQLAlchemyError) +@app.exception_handler(PostgresError) +@app.exception_handler(OSError) +@app.exception_handler(TimeoutError) +@app.exception_handler(ClientError) +@app.exception_handler(BotoCoreError) +@app.exception_handler(StorageFailure) +async def dependency_error_handler(request: Request, exc: Exception): + return JSONResponse(status_code=503, content=error_payload(_rid(request), "unavailable", "dependency unavailable")) + +@app.exception_handler(Exception) +async def generic_exception_handler(request: Request, exc: Exception): + return JSONResponse(status_code=500, content=error_payload(_rid(request), "internal_error", "internal error")) + +# --- Схемы --- +class CreateUser(BaseModel): + model_config = ConfigDict(extra="forbid") + username: str = Field(strict=True) + display_name: str = Field(strict=True, min_length=1, max_length=100) + password: str = Field(strict=True, min_length=12, max_length=128) + + @field_validator("display_name", "password") + @classmethod + def not_blank(cls, value): + if not value.strip(): + raise ValueError("blank value") + return value + +class CreateChat(BaseModel): + model_config = ConfigDict(extra="forbid") + title: str = Field(strict=True, min_length=1, max_length=100) + member_ids: list[uuid.UUID] = Field(min_length=1, max_length=100) + + @field_validator("title") + @classmethod + def not_blank(cls, value): + if not value.strip(): + raise ValueError("blank title") + return value + +class CreateMessage(BaseModel): + model_config = ConfigDict(extra="forbid") + text: str = Field(strict=True, max_length=4000) + attachment_ids: list[uuid.UUID] = Field(default_factory=list, max_length=10) + + @field_validator("attachment_ids") + @classmethod + def unique_attachments(cls, value): + if len(set(value)) != len(value): + raise ValueError("duplicate attachment id") + return value + +async def get_actor(credentials: HTTPAuthorizationCredentials = Depends(security_bearer)) -> dict: + if not credentials: + raise ApiError(401, "unauthorized", "missing token") + + user_id_str = await get_user_id_by_token(credentials.credentials) + if not user_id_str: + raise ApiError(401, "unauthorized", "invalid or expired token") + + async with async_session() as session: + user = await session.get(User, uuid.UUID(user_id_str)) + if not user: + raise ApiError(401, "unauthorized", "user not found") + return {"id": str(user.id), "username": user.username, "display_name": user.display_name, "created_at": now_iso(user.created_at)} + +async def require_chat_member(session, chat_id: uuid.UUID, user_id: str): + member = await session.scalar(select(ChatMember).where(and_( + ChatMember.chat_id == chat_id, ChatMember.user_id == uuid.UUID(user_id)))) + if not member: + raise ApiError(404, "not_found", "chat not found") + +@app.get("/health/live") +def liveness(): + return {"status": "ok"} + +@app.get("/health/ready") +async def readiness(): + async with asyncio.timeout(1.5): + async with async_session() as session: + version = await session.scalar(text("SELECT version FROM schema_versions WHERE version = 6")) + if version != 6: + raise ApiError(503, "unavailable", "migration required") + await redis_client.ping() + await run_in_threadpool(check_storage) + return {"status": "ok"} + +@app.post("/api/v1/users", status_code=201) +async def register_user(payload: CreateUser): + if not USERNAME_RE.fullmatch(payload.username): + raise ApiError(400, "invalid_request", "invalid username") + async with async_session() as session: + existing = await session.scalar(select(User).where(User.username == payload.username)) + if existing: + raise ApiError(409, "conflict", "username already exists") + password_hash = await run_in_threadpool(hash_password, payload.password) + user = User(username=payload.username, display_name=payload.display_name, password_hash=password_hash) + session.add(user) + try: + await session.commit() + except IntegrityError: + await session.rollback() + raise ApiError(409, "conflict", "username already exists") + return {"id": str(user.id), "username": user.username, "display_name": user.display_name, "created_at": now_iso(user.created_at)} + +@app.post("/api/v1/auth/sessions", status_code=201) +async def create_session_endpoint(request: Request): + try: + scheme, encoded = request.headers.get("Authorization", "").split(" ", 1) + if scheme.lower() != "basic": + raise ValueError("Basic required") + username, password = base64.b64decode(encoded, validate=True).decode("utf-8").split(":", 1) + except (ValueError, UnicodeError, binascii.Error): + raise ApiError(401, "unauthorized", "invalid credentials") + + async with async_session() as session: + user = await session.scalar(select(User).where(User.username == username)) + if not user or not await run_in_threadpool(verify_password, password, user.password_hash): + raise ApiError(401, "unauthorized", "invalid credentials") + token = await create_session(str(user.id)) + expires_at = datetime.now(timezone.utc) + timedelta(seconds=SESSION_TTL_SECONDS) + return { + "token": token, "token_type": "Bearer", "expires_at": now_iso(expires_at), + "user": {"id": str(user.id), "username": user.username, "display_name": user.display_name, "created_at": now_iso(user.created_at)} + } + +@app.delete("/api/v1/auth/sessions/current", status_code=204) +async def logout(credentials: HTTPAuthorizationCredentials = Depends(security_bearer)): + if not credentials: + raise ApiError(401, "unauthorized", "missing token") + user_id = await get_user_id_by_token(credentials.credentials) + if not user_id: + raise ApiError(401, "unauthorized", "invalid or expired token") + await delete_session(credentials.credentials) + +@app.get("/api/v1/users/me") +async def current_user(actor: dict = Depends(get_actor)): + return actor + +@app.post("/api/v1/chats", status_code=201) +async def create_chat(payload: CreateChat, actor: dict = Depends(get_actor)): + member_ids = [str(u) for u in payload.member_ids] + if actor["id"] not in member_ids: + raise ApiError(400, "invalid_request", "creator must be a member") + if len(set(member_ids)) != len(member_ids): + raise ApiError(400, "invalid_request", "duplicate members") + async with async_session() as session: + users = await session.scalars(select(User.id).where(User.id.in_([uuid.UUID(m) for m in member_ids]))) + if len(list(users)) != len(set(member_ids)): + raise ApiError(400, "invalid_request", "unknown member") + chat = Chat(title=payload.title) + session.add(chat) + await session.flush() + for mid in member_ids: + session.add(ChatMember(chat_id=chat.id, user_id=uuid.UUID(mid))) + await session.commit() + return {"id": str(chat.id), "title": chat.title, "member_ids": member_ids, "created_at": now_iso(chat.created_at)} + +@app.get("/api/v1/chats") +async def list_chats(limit: int = Query(50, ge=1, le=100), cursor: Optional[str] = None, actor: dict = Depends(get_actor)): + async with async_session() as session: + stmt = select(Chat).join(ChatMember).where(ChatMember.user_id == uuid.UUID(actor["id"])) + if cursor: + scope, c_dt, c_id = _decode_cursor(cursor) + if scope != "chats": + raise ApiError(400, "invalid_request", "invalid cursor scope") + stmt = stmt.where(or_(Chat.created_at > c_dt, and_(Chat.created_at == c_dt, Chat.id > c_id))) + stmt = stmt.order_by(Chat.created_at.asc(), Chat.id.asc()).limit(limit + 1) + chats = (await session.scalars(stmt)).unique().all() + has_more = len(chats) > limit + page = chats[:limit] + next_cursor = _encode_cursor("chats", page[-1].created_at, page[-1].id) if has_more and page else None + items = [{"id": str(c.id), "title": c.title, "created_at": now_iso(c.created_at), "member_ids": [str(m.user_id) for m in c.members]} for c in page] + return {"items": items, "next_cursor": next_cursor} + +@app.get("/api/v1/chats/{chat_id}") +async def get_chat(chat_id: uuid.UUID, actor: dict = Depends(get_actor)): + async with async_session() as session: + chat = await session.scalar(select(Chat).join(ChatMember).where(Chat.id == chat_id, ChatMember.user_id == uuid.UUID(actor["id"]))) + if not chat: + raise ApiError(404, "not_found", "chat not found") + return {"id": str(chat.id), "title": chat.title, "member_ids": [str(m.user_id) for m in chat.members], "created_at": now_iso(chat.created_at)} + +def attachment_json(item: Attachment, variants: list[AttachmentVariant] = None) -> dict: + return { + "id": str(item.id), "chat_id": str(item.chat_id), + "owner_id": str(item.owner_id), "filename": item.filename, + "content_type": item.content_type, "size_bytes": item.size_bytes, + "sha256": item.sha256, "status": item.status, + "variants": [{ + "name": v.name, "content_type": v.content_type, "size_bytes": v.size_bytes, + "width": v.width, "height": v.height, "sha256": v.sha256 + } for v in (variants or [])], + "error_code": item.error_code, + "created_at": now_iso(item.created_at), "updated_at": now_iso(item.updated_at), + } + +@app.post("/api/v1/chats/{chat_id}/attachments", status_code=202) +async def upload_attachment( + chat_id: uuid.UUID, request: Request, filename: str = Query(...), + actor: dict = Depends(get_actor), +): + async with async_session() as session: + await require_chat_member(session, chat_id, actor["id"]) + + if not (1 <= len(filename) <= 255) or any(c in filename for c in ("/", "\\")) or any(ord(c) < 32 or ord(c) == 127 for c in filename): + raise ApiError(400, "invalid_request", "invalid filename") + + declared_type = request.headers.get("content-type", "").split(";", 1)[0].strip().lower() + if declared_type not in ("image/png", "image/jpeg"): + raise ApiError(415, "unsupported_media_type", "only PNG and JPEG are accepted") + + hasher = hashlib.sha256() + size = 0 + with SpooledTemporaryFile(max_size=1024 * 1024, mode="w+b") as original: + async for chunk in request.stream(): + size += len(chunk) + if size > MAX_UPLOAD_BYTES: + raise ApiError(413, "payload_too_large", "image exceeds 10 MiB") + hasher.update(chunk) + original.write(chunk) + if size == 0: + raise ApiError(415, "unsupported_media_type", "empty image") + await run_in_threadpool(validate_image_file, original, declared_type) + + item_id = uuid.uuid4() + key = f"originals/{item_id.hex}/{uuid.uuid4().hex}" + with telemetry.tracer.start_as_current_span('s3 stage original', kind=SpanKind.CLIENT): + await run_in_threadpool(upload_original, original, key, size, declared_type) + try: + async with async_session() as session: + await require_chat_member(session, chat_id, actor["id"]) + item = Attachment( + id=item_id, chat_id=chat_id, owner_id=uuid.UUID(actor["id"]), + filename=filename, object_key=key, content_type=declared_type, + size_bytes=size, sha256=hasher.hexdigest(), status="queued", + ) + session.add(item) + # Добавляем задачу в Outbox + carrier = {} + inject(carrier) + payload = {'attachment_id': str(item_id), **carrier} + session.add(Outbox(event_type='attachment.process.v1', payload=payload)) + with telemetry.tracer.start_as_current_span('db commit accepted job', kind=SpanKind.CLIENT): + await session.commit() + telemetry.event('attachment_accepted', job_type='attachment') + return attachment_json(item) + except Exception: + try: + await run_in_threadpool(delete_original, key) + except Exception: + logging.getLogger(__name__).warning("S3 compensation failed; reconcile needed") + raise + +@app.get("/api/v1/attachments/{attachment_id}") +async def attachment_metadata(attachment_id: uuid.UUID, actor: dict = Depends(get_actor)): + async with async_session() as session: + item = await session.get(Attachment, attachment_id) + if item is None: + raise ApiError(404, "not_found", "attachment not found") + await require_chat_member(session, item.chat_id, actor["id"]) + + variants = (await session.scalars(select(AttachmentVariant).where(AttachmentVariant.attachment_id == item.id))).all() + return attachment_json(item, variants) + +@app.get("/api/v1/attachments/{attachment_id}/content") +async def attachment_bytes( + attachment_id: uuid.UUID, variant: str = "original", actor: dict = Depends(get_actor) +): + async with async_session() as session: + item = await session.get(Attachment, attachment_id) + if item is None: + raise ApiError(404, "not_found", "attachment not found") + await require_chat_member(session, item.chat_id, actor["id"]) + + if item.status != "ready": + raise ApiError(409, "conflict", "attachment is not ready") + + if variant == "original": + key, content_type, size = item.object_key, item.content_type, item.size_bytes + else: + var = await session.scalar(select(AttachmentVariant).where( + AttachmentVariant.attachment_id == item.id, AttachmentVariant.name == variant + )) + if not var: + raise ApiError(404, "not_found", "variant not found") + key, content_type, size = var.object_key, var.content_type, var.size_bytes + + body = await run_in_threadpool(download_original, key) + def chunks(): + try: + yield from body.iter_chunks(chunk_size=64 * 1024) + finally: + body.close() + + return StreamingResponse(chunks(), media_type=content_type, + headers={"Content-Length": str(size), "Cache-Control": "private, no-store"}) + +@app.post("/api/v1/chats/{chat_id}/messages", status_code=201) +async def post_message(chat_id: uuid.UUID, payload: CreateMessage, request: Request, actor: dict = Depends(get_actor)): + key = request.headers.get("Idempotency-Key", "") + if not KEY_RE.fullmatch(key): + raise ApiError(400, "invalid_request", "invalid Idempotency-Key") + if not payload.text.strip() and not payload.attachment_ids: + raise ApiError(400, "invalid_request", "empty message") + attachment_ids = [str(a) for a in payload.attachment_ids] + + async with async_session() as session: + await require_chat_member(session, chat_id, actor["id"]) + + if attachment_ids: + attachments = (await session.scalars(select(Attachment).where( + Attachment.id.in_(payload.attachment_ids), Attachment.chat_id == chat_id + ))).all() + if len(attachments) != len(attachment_ids): + raise ApiError(404, "not_found", "attachment not found") + # В 5-й лабе можно прикреплять файлы в статусе queued/processing, но не failed + if any(a.status == "failed" for a in attachments): + raise ApiError(409, "conflict", "attachment failed and cannot be attached") + + now = datetime.now(timezone.utc) + scope = {"user_id": uuid.UUID(actor["id"]), "chat_id": chat_id, "key": key} + await session.execute(insert(IdempotencyKey).values( + **scope, request_text=payload.text, request_attachment_ids=attachment_ids, + expires_at=now + timedelta(hours=24) + ).on_conflict_do_nothing()) + record = await session.scalar(select(IdempotencyKey).where( + IdempotencyKey.user_id == scope["user_id"], + IdempotencyKey.chat_id == chat_id, IdempotencyKey.key == key + ).with_for_update()) + + if record.response is not None and record.expires_at > now: + if record.request_text != payload.text or record.request_attachment_ids != attachment_ids: + raise ApiError(409, "conflict", "key used with another message") + return record.response + + msg = Message(chat_id=chat_id, sender_id=uuid.UUID(actor["id"]), text=payload.text) + session.add(msg) + await session.flush() + for pos, a_id in enumerate(payload.attachment_ids): + session.add(MessageAttachment(message_id=msg.id, attachment_id=a_id, position=pos)) + + result = { + "id": str(msg.id), "chat_id": str(msg.chat_id), "sender_id": str(msg.sender_id), + "text": msg.text, "created_at": now_iso(msg.created_at), + "attachment_ids": attachment_ids, + } + record.request_text = payload.text + record.request_attachment_ids = attachment_ids + record.expires_at = now + timedelta(hours=24) + record.response = result + await session.commit() + return result + +@app.get("/api/v1/chats/{chat_id}/messages") +async def get_messages(chat_id: uuid.UUID, limit: int = Query(50, ge=1, le=100), cursor: Optional[str] = None, actor: dict = Depends(get_actor)): + async with async_session() as session: + await require_chat_member(session, chat_id, actor["id"]) + stmt = select(Message).where(Message.chat_id == chat_id) + if cursor: + scope, c_dt, c_id = _decode_cursor(cursor) + if scope != str(chat_id): + raise ApiError(400, "invalid_request", "invalid cursor scope") + stmt = stmt.where(or_(Message.created_at > c_dt, and_(Message.created_at == c_dt, Message.id > c_id))) + stmt = stmt.order_by(Message.created_at.asc(), Message.id.asc()).limit(limit + 1) + messages = (await session.scalars(stmt)).all() + has_more = len(messages) > limit + page = messages[:limit] + next_cursor = _encode_cursor(str(chat_id), page[-1].created_at, page[-1].id) if has_more and page else None + + msg_ids = [m.id for m in page] + links = [] + if msg_ids: + links = (await session.execute(select(MessageAttachment).where( + MessageAttachment.message_id.in_(msg_ids) + ).order_by(MessageAttachment.message_id, MessageAttachment.position))).scalars().all() + linked: dict[uuid.UUID, list[str]] = {m.id: [] for m in page} + for link in links: + linked[link.message_id].append(str(link.attachment_id)) + items = [{ + "id": str(m.id), "chat_id": str(m.chat_id), "sender_id": str(m.sender_id), + "text": m.text, "created_at": now_iso(m.created_at), + "attachment_ids": linked[m.id], + } for m in page] + return {"items": items, "next_cursor": next_cursor} \ No newline at end of file diff --git a/src/migrate.py b/src/migrate.py new file mode 100644 index 0000000..db29dfb --- /dev/null +++ b/src/migrate.py @@ -0,0 +1,25 @@ +import asyncio + +from sqlalchemy import text +from .db import Base, engine + + +async def main(): + async with engine.begin() as conn: + await conn.execute(text("SELECT pg_advisory_xact_lock(300300)")) + await conn.run_sync(Base.metadata.create_all) + + await conn.execute(text("ALTER TABLE attachments ADD COLUMN IF NOT EXISTS error_code VARCHAR(64)")) + + await conn.execute(text("INSERT INTO schema_versions(version) VALUES (3) ON CONFLICT DO NOTHING")) + await conn.execute(text("INSERT INTO schema_versions(version) VALUES (4) ON CONFLICT DO NOTHING")) + await conn.execute(text("INSERT INTO schema_versions(version) VALUES (5) ON CONFLICT DO NOTHING")) + await conn.execute(text("ALTER TABLE attachments ADD COLUMN IF NOT EXISTS attempts INTEGER NOT NULL DEFAULT 0")) + await conn.execute(text("ALTER TABLE outbox ADD COLUMN IF NOT EXISTS available_at TIMESTAMPTZ NOT NULL DEFAULT now()")) + await conn.execute(text("INSERT INTO schema_versions(version) VALUES (6) ON CONFLICT DO NOTHING")) + await engine.dispose() + print("Migration 5 applied: outbox, variants and async processing added") + + +if __name__ == "__main__": + asyncio.run(main()) \ No newline at end of file diff --git a/src/private_check.py b/src/private_check.py new file mode 100644 index 0000000..72d04d6 --- /dev/null +++ b/src/private_check.py @@ -0,0 +1,22 @@ +"""Prove S3 is not public and API-scoped credentials cannot list other buckets.""" +import urllib.error +import urllib.request +from botocore.exceptions import ClientError +from .storage import s3, bucket +import os +import uuid + +url = os.getenv("S3_ENDPOINT", "http://s3:8333").rstrip("/") + "/" + bucket + "/random-inaccessible-key" +try: + urllib.request.urlopen(url, timeout=4) +except urllib.error.HTTPError as exc: + assert exc.code in (401, 403), f"expected S3 denied, got {exc.code}" +else: + raise AssertionError("UNSAFE: direct unsigned S3 request succeeded") +try: + s3.create_bucket(Bucket="forbidden-probe-" + uuid.uuid4().hex[:16]) +except ClientError as exc: + assert exc.response["Error"]["Code"] in ("AccessDenied", "403"), "unexpected S3 result" +else: + raise AssertionError("UNSAFE: API credentials have global create-bucket privileges") +print("PASS: S3 requires authentication; API credentials restricted to own bucket") diff --git a/src/reconcile.py b/src/reconcile.py new file mode 100644 index 0000000..a5f9e9d --- /dev/null +++ b/src/reconcile.py @@ -0,0 +1,51 @@ +"""Safe orphan S3 cleanup (dry run default). Use inside api container. + +A crash between S3 PUT and PostgreSQL COMMIT can leave an unreferenced object. +Only objects older than the grace period are candidates. No deletion if DB read fails. +""" +import argparse +import asyncio +from datetime import datetime, timezone, timedelta +from sqlalchemy import select +from .db import async_session, Attachment, engine +from .storage import s3, bucket +from starlette.concurrency import run_in_threadpool + + +def list_s3(): + keys = [] + paginator = s3.get_paginator("list_objects_v2") + for page in paginator.paginate(Bucket=bucket, Prefix="originals/"): + keys.extend((i["Key"], i["LastModified"]) for i in page.get("Contents", [])) + return keys + + +async def run(apply=False, grace_seconds=3600): + if grace_seconds < 3600: + raise ValueError("grace must be at least 3600 seconds") + # Load DB references before enumerating/deleting S3 objects. Fail closed. + async with async_session() as session: + referenced = set((await session.scalars(select(Attachment.object_key))).all()) + objects = await run_in_threadpool(list_s3) + threshold = datetime.now(timezone.utc) - timedelta(seconds=grace_seconds) + candidates = [key for key, when in objects if key not in referenced and when < threshold] + print(f"referenced={len(referenced)} objects={len(objects)} old_orphans={len(candidates)} apply={apply}") + for key in candidates: + # Avoid listing filenames/secrets: keys are random IDs, not user inputs. + if apply: + await run_in_threadpool(s3.delete_object, Bucket=bucket, Key=key) + print(("deleted " if apply else "would_delete ") + key) + return len(candidates) + + +if __name__ == "__main__": + parser = argparse.ArgumentParser() + parser.add_argument("--apply", action="store_true", help="really delete aged orphan objects") + parser.add_argument("--grace-seconds", type=int, default=3600) + args = parser.parse_args() + async def main(): + try: + await run(args.apply, args.grace_seconds) + finally: + await engine.dispose() + asyncio.run(main()) diff --git a/src/storage.py b/src/storage.py new file mode 100644 index 0000000..45ba7d8 --- /dev/null +++ b/src/storage.py @@ -0,0 +1,43 @@ +"""S3-compatible private storage. Only API-scoped credentials are available here.""" +import os +import boto3 +from botocore.config import Config +from botocore.exceptions import ClientError, BotoCoreError + +MAX_UPLOAD_BYTES = int(os.getenv("MAX_UPLOAD_BYTES", "10485760")) +MAX_IMAGE_PIXELS = int(os.getenv("MAX_IMAGE_PIXELS", "40000000")) +bucket = os.getenv("S3_BUCKET", "messenger-attachments") +s3 = boto3.client( + "s3", endpoint_url=os.getenv("S3_ENDPOINT", "http://s3:8333"), + region_name=os.getenv("S3_REGION", "us-east-1"), + aws_access_key_id=os.environ.get("S3_ACCESS_KEY_ID", "unset"), + aws_secret_access_key=os.environ.get("S3_SECRET_ACCESS_KEY", "unset"), + config=Config(s3={"addressing_style": "path"}, connect_timeout=2, read_timeout=30, + retries={"mode": "standard", "max_attempts": 2}), +) + +class StorageFailure(Exception): + pass + + +def check_storage(): + # Scoped user has ListBucket but no privileges outside this bucket. + s3.list_objects_v2(Bucket=bucket, MaxKeys=1) + + +def upload_original(file, key, size, content_type): + file.seek(0) + s3.put_object(Bucket=bucket, Key=key, Body=file, ContentLength=size, ContentType=content_type) + + +def delete_original(key): + s3.delete_object(Bucket=bucket, Key=key) + + +def download_original(key): + try: + return s3.get_object(Bucket=bucket, Key=key)["Body"] + except ClientError as exc: + if exc.response.get("Error", {}).get("Code") in ("NoSuchKey", "404"): + raise StorageFailure("Object missing") from None + raise diff --git a/src/telemetry.py b/src/telemetry.py new file mode 100644 index 0000000..6e5e7e5 --- /dev/null +++ b/src/telemetry.py @@ -0,0 +1,87 @@ +import logging +import os +import socket +import time + +from opentelemetry import metrics, trace +from opentelemetry.propagate import extract, inject +from opentelemetry.trace import SpanKind, Status, StatusCode +from opentelemetry.sdk.resources import Resource +from opentelemetry.sdk.trace import TracerProvider +from opentelemetry.sdk.trace.export import BatchSpanProcessor +from opentelemetry.sdk.metrics import MeterProvider +from opentelemetry.sdk.metrics.export import PeriodicExportingMetricReader +from opentelemetry.sdk._logs import LoggerProvider, LoggingHandler +from opentelemetry.sdk._logs.export import BatchLogRecordProcessor +from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter +from opentelemetry.exporter.otlp.proto.http.metric_exporter import OTLPMetricExporter +from opentelemetry.exporter.otlp.proto.http._log_exporter import OTLPLogExporter + +BASE = os.getenv('OTEL_EXPORTER_OTLP_ENDPOINT', 'http://otel-collector:4318').rstrip('/') +SERVICE = os.getenv('OTEL_SERVICE_NAME', 'messenger-api') + +class Telemetry: + def __init__(self): + resource = Resource.create({ + 'service.name': SERVICE, + 'service.version': '1.6.0', + 'service.instance.id': os.getenv('INSTANCE_ID', socket.gethostname()), + 'deployment.environment.name': 'lab', + }) + self.trace_provider = TracerProvider(resource=resource) + self.trace_provider.add_span_processor(BatchSpanProcessor( + OTLPSpanExporter(endpoint=BASE+'/v1/traces', timeout=2), + max_queue_size=256, max_export_batch_size=32, + schedule_delay_millis=2000, export_timeout_millis=2000)) + trace.set_tracer_provider(self.trace_provider) + reader = PeriodicExportingMetricReader( + OTLPMetricExporter(endpoint=BASE+'/v1/metrics', timeout=2), + export_interval_millis=5000, export_timeout_millis=3000) + self.metric_provider = MeterProvider(resource=resource, metric_readers=[reader]) + metrics.set_meter_provider(self.metric_provider) + self.log_provider = LoggerProvider(resource=resource) + self.log_provider.add_log_record_processor(BatchLogRecordProcessor( + OTLPLogExporter(endpoint=BASE+'/v1/logs', timeout=2), + max_queue_size=256, max_export_batch_size=32, schedule_delay_millis=2000)) + self.log = logging.getLogger('messenger.telemetry') + self.log.setLevel(logging.INFO) + self.log.propagate = False + self.log.addHandler(LoggingHandler(level=logging.INFO, logger_provider=self.log_provider)) + self.tracer = trace.get_tracer('messenger', '1.6.0') + meter = metrics.get_meter('messenger', '1.6.0') + self.requests = meter.create_counter('messenger_http_requests', unit='1') + self.http_duration = meter.create_histogram('messenger_http_duration', unit='s', explicit_bucket_boundaries_advisory=[0.005, 0.01, 0.025, 0.05, 0.1, 0.2, 0.4, 0.8, 1.5, 3.0, 6.0, 12.0]) + self.jobs = meter.create_counter('messenger_jobs', unit='1') + self.job_duration = meter.create_histogram('messenger_job_duration', unit='s', explicit_bucket_boundaries_advisory=[0.01, 0.05, 0.1, 0.25, 0.5, 1.0, 2.0, 5.0, 10.0, 30.0]) + self.time_to_ready = meter.create_histogram('messenger_time_to_ready', unit='s', explicit_bucket_boundaries_advisory=[0.1, 0.5, 1, 2, 5, 10, 20, 30, 60, 120, 300]) + self.queue_depth = 0 + self.queue_age = 0.0 + self.db_used = 0 + self.db_waiting = 0 + self.worker_busy = 0 + self.worker_capacity = 1 if SERVICE == 'messenger-worker' else 0 + self.queue_metric = meter.create_observable_gauge('messenger_queue_depth', callbacks=[lambda _: [metrics.Observation(self.queue_depth, {'queue':'attachment.process.v1'})],], unit='1') + self.age_metric = meter.create_observable_gauge('messenger_queue_oldest_age', callbacks=[lambda _: [metrics.Observation(self.queue_age, {'queue':'attachment.process.v1'})],], unit='s') + self.used_metric = meter.create_observable_gauge('messenger_db_pool_used', callbacks=[lambda _: [metrics.Observation(self.db_used)],], unit='1') + self.waiting_metric = meter.create_observable_gauge('messenger_db_pool_waiting', callbacks=[lambda _: [metrics.Observation(self.db_waiting)],], unit='1') + self.busy_metric = meter.create_observable_gauge('messenger_worker_busy', callbacks=[lambda _: [metrics.Observation(self.worker_busy)],], unit='1') + self.capacity_metric = meter.create_observable_gauge('messenger_worker_capacity', callbacks=[lambda _: [metrics.Observation(self.worker_capacity)],], unit='1') + + def event(self, name, **safe_fields): + payload = 'event=' + name + for key, value in safe_fields.items(): + if key in ('route', 'method', 'status', 'outcome', 'job_type', 'request_id'): + payload += ' ' + key + '=' + str(value).replace(' ', '_')[:100] + span_context = trace.get_current_span().get_span_context() + if span_context.is_valid: + payload += ' trace_id=%032x span_id=%016x' % (span_context.trace_id, span_context.span_id) + self.log.info(payload) + + def shutdown(self): + self.trace_provider.shutdown() + self.metric_provider.shutdown() + self.log_provider.shutdown() + +telemetry = Telemetry() + +__all__ = ['telemetry', 'trace', 'extract', 'inject', 'SpanKind', 'Status', 'StatusCode'] diff --git a/src/worker.py b/src/worker.py new file mode 100644 index 0000000..f7b8451 --- /dev/null +++ b/src/worker.py @@ -0,0 +1,122 @@ +import asyncio +import io +import json +import logging +import os +import time +import uuid +from datetime import datetime, timezone, timedelta + +import aio_pika +from PIL import Image, ImageOps +from sqlalchemy import select + +from .db import async_session, engine, Attachment, AttachmentVariant, Outbox +from .storage import upload_original, download_original +from .images import make_thumbnail, make_variants +from .telemetry import telemetry, extract, SpanKind, Status, StatusCode + +BROKER_URL = os.getenv('BROKER_URL', 'amqp://guest:guest@broker:5672/') +QUEUE_NAME = 'attachment.process.v1' +MAX_ATTEMPTS = int(os.getenv('JOB_MAX_ATTEMPTS', '5')) + +async def process_attachment(message: aio_pika.IncomingMessage): + ctx = extract(message.headers or {}) + started = time.monotonic() + telemetry.worker_busy = 1 + outcome = 'success' + try: + with telemetry.tracer.start_as_current_span( + 'attachment.process', context=ctx, kind=SpanKind.CONSUMER) as span: + async with message.process(requeue=True): + payload = json.loads(message.body.decode()) + attachment_id = uuid.UUID(payload['attachment_id']) + telemetry.event('job_started', job_type='attachment') + async with async_session() as session: + att = await session.get(Attachment, attachment_id, with_for_update=True) + if not att or att.status in ('ready', 'failed'): + telemetry.event('job_duplicate_skipped', job_type='attachment') + return + att.status = 'processing' + att.attempts = int(att.attempts or 0) + 1 + attempt = att.attempts + await session.commit() + try: + with telemetry.tracer.start_as_current_span('s3.download_original', kind=SpanKind.CLIENT): + stream = await asyncio.to_thread(download_original, att.object_key) + data = await asyncio.to_thread(stream.read) + await asyncio.to_thread(stream.close) + with telemetry.tracer.start_as_current_span('image.create_variants', kind=SpanKind.INTERNAL): + outputs = await asyncio.to_thread(make_variants, data) + with telemetry.tracer.start_as_current_span('s3.store_variants', kind=SpanKind.CLIENT): + for name, raw, mime, w, h, sha in outputs: + key = f'variants/{attachment_id.hex}/{name}' + await asyncio.to_thread(upload_original, io.BytesIO(raw), key, len(raw), mime) + with telemetry.tracer.start_as_current_span('db.commit_ready', kind=SpanKind.CLIENT): + async with async_session() as session: + locked = await session.get(Attachment, attachment_id, with_for_update=True) + if locked and locked.status != 'ready': + for name, raw, mime, w, h, sha in outputs: + previous = await session.scalar(select(AttachmentVariant).where( + AttachmentVariant.attachment_id == attachment_id, + AttachmentVariant.name == name)) + if previous is None: + previous = AttachmentVariant(attachment_id=attachment_id, name=name) + session.add(previous) + previous.object_key = f'variants/{attachment_id.hex}/{name}' + previous.content_type = mime + previous.size_bytes = len(raw) + previous.width = w + previous.height = h + previous.sha256 = sha + locked.status = 'ready' + locked.error_code = None + await session.commit() + elapsed = (datetime.now(timezone.utc) - locked.created_at).total_seconds() + telemetry.time_to_ready.record(max(0.0,elapsed), {'job_type':'attachment'}) + telemetry.event('job_ready', job_type='attachment', outcome='success') + except Exception as exc: + outcome = 'failed' + span.set_status(Status(StatusCode.ERROR)) + async with async_session() as session: + locked = await session.get(Attachment, attachment_id, with_for_update=True) + if locked and locked.status != 'ready': + if attempt >= MAX_ATTEMPTS or isinstance(exc, (ValueError, Image.DecompressionBombError)): + locked.status = 'failed' + locked.error_code = 'retry_exhausted' if attempt >= MAX_ATTEMPTS else 'invalid_image' + telemetry.event('job_failed', job_type='attachment', outcome='permanent') + else: + locked.status = 'queued' + locked.error_code = None + delay = min(60, 2 ** min(attempt, 5)) + session.add(Outbox( + event_type='attachment.process.v1', + payload={'attachment_id':str(attachment_id), **dict(message.headers or {})}, + available_at=datetime.now(timezone.utc)+timedelta(seconds=delay))) + telemetry.event('job_retry_scheduled', job_type='attachment', outcome='transient') + await session.commit() + except Exception: + outcome = 'failed' + telemetry.event('job_delivery_exception', job_type='attachment') + raise + finally: + telemetry.jobs.add(1, {'job_type':'attachment', 'outcome':outcome}) + telemetry.job_duration.record(time.monotonic()-started, {'job_type':'attachment','outcome':outcome}) + telemetry.worker_busy = 0 + +async def main(): + connection = await aio_pika.connect_robust(BROKER_URL) + channel = await connection.channel(publisher_confirms=True) + queue = await channel.declare_queue(QUEUE_NAME, durable=True) + await channel.set_qos(prefetch_count=1) + await queue.consume(process_attachment) + telemetry.event('worker_started', job_type='attachment') + try: + await asyncio.Future() + finally: + await connection.close() + await engine.dispose() + telemetry.shutdown() + +if __name__ == '__main__': + asyncio.run(main()) diff --git a/student-tests/run.py b/student-tests/run.py new file mode 100644 index 0000000..588ebe2 --- /dev/null +++ b/student-tests/run.py @@ -0,0 +1,76 @@ +#!/usr/bin/env python3 +import sys +import threading +import uuid +from concurrent.futures import ThreadPoolExecutor +from pathlib import Path + +sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "tests")) +from client import Client, arguments, check, run + + +def main(): + args = arguments("Lab3: concurrent idempotency and validation") + c = Client(args.base_url, args.ca_file) + c.call("POST", "/api/v1/users", 400, + body={"username": "valid\n", "display_name": "Test", "password": "LongPassword123"}) + registration = {"username": "race_" + uuid.uuid4().hex[:12], + "display_name": "Race", "password": "LongPassword123"} + registration_barrier = threading.Barrier(2) + + def register(_): + local = Client(args.base_url, args.ca_file) + registration_barrier.wait() + return local.call("POST", "/api/v1/users", [201, 409], + body=registration, schema="User")["status"] + + with ThreadPoolExecutor(max_workers=2) as pool: + check(sorted(pool.map(register, range(2))) == [201, 409], "registration race") + alice, bob, eve, chat = c.bootstrap() + path = "/api/v1/chats/" + chat["id"] + "/messages" + key = uuid.uuid4().hex + barrier = threading.Barrier(12) + + def send(_): + local = Client(args.base_url, args.ca_file) + barrier.wait() + return local.message(alice, chat, "Одна запись", key=key) + + with ThreadPoolExecutor(max_workers=12) as pool: + responses = list(pool.map(send, range(12))) + first = responses[0]["json"] + check(all(r["json"] == first for r in responses), "concurrent replay differs") + instances = {r["headers"]["X-Instance-Id"] for r in responses} + check(len(instances) >= 2, "same key must reach at least two replicas") + page = c.call("GET", path, actor=bob, schema="MessagePage")["json"] + check(page["items"] == [first], "concurrent retry created duplicates") + c.call("POST", path, 409, actor=alice, body={"text": "Изменённый текст"}, + headers={"Idempotency-Key": key}) + c.call("POST", path, 404, actor=eve, body={"text": "Одна запись"}, + headers={"Idempotency-Key": key}) + # The same key belongs to a different scope for Bob and for another chat. + other = c.message(bob, chat, "Другая область", key=key)["json"] + check(other["id"] != first["id"], "different users share an idempotency scope") + second_chat = c.call("POST", "/api/v1/chats", 201, actor=alice, + body={"title": "Второй", "member_ids": [alice["id"]]}, + schema="Chat")["json"] + other = c.message(alice, second_chat, "Одна запись", key=key)["json"] + check(other["id"] != first["id"], "different chats share an idempotency scope") + for bad_key in ("", "bad key", "x" * 129): + c.call("POST", path, 400, actor=alice, body={"text": "Текст"}, + headers={"Idempotency-Key": bad_key}) + for body in ({"text": " "}, {"text": 123}, {"text": "x", "sender_id": alice["id"]}): + c.call("POST", path, 400, actor=alice, body=body, + headers={"Idempotency-Key": uuid.uuid4().hex}) + c.call("POST", path, 400, actor=alice, raw=b'{"text":', + headers={"Content-Type": "application/json", "Idempotency-Key": uuid.uuid4().hex}) + c.call("DELETE", "/api/v1/auth/sessions/current", 204, actor=alice) + c.call("POST", path, 401, actor=alice, body={"text": "Одна запись"}, + headers={"Idempotency-Key": key}) + print("PASS: 12 concurrent requests across %d replicas, one message" % len(instances)) + print("PASS: conflict, key scope, validation, access and revoked session") + print("PASS: concurrent registration, exactly one 201 and one 409") + + +if __name__ == "__main__": + run(main) diff --git a/student-tests/test_attachments.py b/student-tests/test_attachments.py new file mode 100644 index 0000000..484d40f --- /dev/null +++ b/student-tests/test_attachments.py @@ -0,0 +1,77 @@ +#!/usr/bin/env python3 +"""Additional grade-4 negative and access tests. Requires running Compose stack.""" +import hashlib +import zlib +import sys +import uuid +from pathlib import Path +from concurrent.futures import ThreadPoolExecutor +sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "tests")) +from client import Client, check, arguments, run + +ROOT = Path(__file__).resolve().parents[1] + +def main(): + args = arguments("Lab5: file validation, permissions, idempotency and isolation") + c = Client(args.base_url, args.ca_file, timeout=35) + alice, bob, eve, chat = c.bootstrap() + file = (ROOT / "tests/fixtures/sample.png").read_bytes() + path = "/api/v1/chats/" + chat["id"] + upload = path + "/attachments?filename=photo.png" + + # 1. Загружаем (теперь ожидаем 202 вместо 201) + result = c.call("POST",upload,202,actor=alice,raw=file, + headers={"Content-Type":"image/png"},schema="Attachment")["json"] + obj = "/api/v1/attachments/" + result["id"] + check(result["sha256"] == hashlib.sha256(file).hexdigest(),"checksum mismatch") + + # Ждем, пока воркер обработает картинку (переведет в статус ready) + result = c.wait_ready(alice, result) + + # Теперь контент доступен + check(c.call("GET",obj+"/content",actor=bob)["bytes"] == file,"original differs") + c.call("GET",obj,404,actor=eve) + c.call("GET",obj+"/content",404,actor=eve) + c.call("GET","/api/v1/attachments/"+str(uuid.uuid4()),404,actor=bob) + + # Негативные тесты (они падают сразу на этапе валидации, до 202) + c.call("POST",upload,415,actor=alice,raw=b"not an image", + headers={"Content-Type":"image/png"}) + c.call("POST",upload,415,actor=alice,raw=file, + headers={"Content-Type":"image/jpeg"}) + c.call("POST",upload,413,actor=alice,raw=b"\0"*10485761, + headers={"Content-Type":"image/png"}) + + huge = bytearray(file) + huge[16:20] = (10000).to_bytes(4, "big") + huge[20:24] = (5000).to_bytes(4, "big") + huge[29:33] = (zlib.crc32(huge[12:29]) & 0xffffffff).to_bytes(4, "big") + c.call("POST",upload,413,actor=alice,raw=bytes(huge), + headers={"Content-Type":"image/png"}) + + c.call("POST",path+"/attachments?filename=..%2Fhidden.png",400,actor=alice, + raw=file,headers={"Content-Type":"image/png"}) + c.call("POST",path+"/attachments?filename=sample.txt",415,actor=alice, + raw=file,headers={"Content-Type":"text/plain"}) + + second = c.call("POST","/api/v1/chats",201,actor=alice, + body={"title":"Other Chat","member_ids":[alice["id"]]},schema="Chat")["json"] + c.call("POST", "/api/v1/chats/"+second["id"]+"/messages",404, + actor=alice,body={"text":"","attachment_ids":[result["id"]]}, + headers={"Idempotency-Key":uuid.uuid4().hex}) + + # В 5-й лабе можно прикреплять файлы в статусе queued/processing/ready + attached = c.message(alice,chat,"",attachments=[result["id"]])["json"] + check(attached["attachment_ids"] == [result["id"]],"message lost attachment") + + key = uuid.uuid4().hex + one = c.message(alice,chat,"Фото",key=key,attachments=[result["id"]])["json"] + check(c.message(alice,chat,"Фото",key=key,attachments=[result["id"]])["json"] == one, + "repeated idempotency response mismatch") + c.call("POST",path+"/messages",409,actor=alice, + body={"text":"Фото", "attachment_ids":[]},headers={"Idempotency-Key":key}) + + print("PASS: private downloads, MIME spoof, corrupt image, oversize, dangerous filename, foreign chat, idempotency") + +if __name__ == "__main__": + run(main) \ No newline at end of file -- 2.54.0