From e636d4cc76fc2fc6bff68cca7a4f75c91b35f059 Mon Sep 17 00:00:00 2001 From: ferraronp Date: Tue, 17 Nov 2026 19:14:43 +0300 Subject: [PATCH] Implement lab6 observability with OpenTelemetry and Grafana --- .env.example | 48 +- Dockerfile | 10 + Makefile | 2 +- REPORT.md | 213 ++++- app/__init__.py | 1 + app/__main__.py | 4 + app/api.py | 193 +++++ app/attachments.py | 240 ++++++ app/auth.py | 104 +++ app/core.py | 79 ++ app/image_worker.py | 124 +++ app/jobs.py | 470 ++++++++++ app/main.py | 117 +++ app/migrate.py | 23 + app/models.py | 77 ++ app/pipeline_selftest.py | 25 + app/reconcile.py | 132 +++ app/reconcile_fault.py | 36 + app/reconcile_selftest.py | 61 ++ app/s3_bootstrap.py | 35 + app/s3_policy.py | 32 + app/s3_probe.py | 40 + app/storage.py | 67 ++ app/telemetry.py | 204 +++++ compose.yaml | 347 ++++++++ db/migrations/001_initial.sql | 33 + db/migrations/002_idempotency.sql | 12 + db/migrations/003_attachments.sql | 25 + db/migrations/004_jobs.sql | 58 ++ evidence/attachments-concurrent.json | 13 + evidence/grafana/01-api-and-jobs.png | Bin 0 -> 115639 bytes evidence/grafana/02-worker-and-queue.png | Bin 0 -> 81200 bytes evidence/grafana/03-pool-and-resources.png | Bin 0 -> 153721 bytes evidence/grafana/04-collector-alerts-slo.png | Bin 0 -> 113901 bytes evidence/lab6-backend-down.json | 16 + evidence/lab6-db-error.json | 30 + evidence/lab6-history.json | 10 + evidence/lab6-metrics.json | 532 ++++++++++++ evidence/lab6-queue-lag.json | 11 + evidence/lab6-trace-retry.json | 214 +++++ evidence/offline_validation.md | 18 + evidence/verified_results_2026-11-17.md | 90 ++ infra/filer.toml | 4 + infra/haproxy.cfg | 32 + infra/otel/collector.yaml | 71 ++ infra/otel/grafana/dashboards/messenger.json | 805 ++++++++++++++++++ .../provisioning/dashboards/dashboards.yml | 11 + .../provisioning/datasources/datasources.yml | 36 + infra/otel/loki.yaml | 32 + infra/otel/prometheus/alerts.yml | 19 + infra/otel/prometheus/prometheus.yml | 12 + infra/otel/tempo.yaml | 22 + requirements.txt | 18 + scripts/check_lab6.py | 46 + scripts/restart.cmd | 11 + scripts/restart.sh | 21 + scripts/stop-one.cmd | 10 + scripts/stop-one.sh | 8 + scripts/wait_ready.py | 14 + tests/attachments_concurrent.py | 90 ++ tests/attachments_negative.py | 48 ++ tests/idempotency_parallel.py | 38 + tests/jobs_sql_contract.py | 30 + tests/observability_live.py | 341 ++++++++ tests/own_unit.py | 42 + tests/pipeline_extended.py | 233 +++++ tests/pipeline_resilience.py | 108 +++ tests/telemetry_unit.py | 62 ++ 68 files changed, 5863 insertions(+), 47 deletions(-) create mode 100644 Dockerfile create mode 100644 app/__init__.py create mode 100644 app/__main__.py create mode 100644 app/api.py create mode 100644 app/attachments.py create mode 100644 app/auth.py create mode 100644 app/core.py create mode 100644 app/image_worker.py create mode 100644 app/jobs.py create mode 100644 app/main.py create mode 100644 app/migrate.py create mode 100644 app/models.py create mode 100644 app/pipeline_selftest.py create mode 100644 app/reconcile.py create mode 100644 app/reconcile_fault.py create mode 100644 app/reconcile_selftest.py create mode 100644 app/s3_bootstrap.py create mode 100644 app/s3_policy.py create mode 100644 app/s3_probe.py create mode 100644 app/storage.py create mode 100644 app/telemetry.py create mode 100644 compose.yaml create mode 100644 db/migrations/001_initial.sql create mode 100644 db/migrations/002_idempotency.sql create mode 100644 db/migrations/003_attachments.sql create mode 100644 db/migrations/004_jobs.sql create mode 100644 evidence/attachments-concurrent.json create mode 100644 evidence/grafana/01-api-and-jobs.png create mode 100644 evidence/grafana/02-worker-and-queue.png create mode 100644 evidence/grafana/03-pool-and-resources.png create mode 100644 evidence/grafana/04-collector-alerts-slo.png create mode 100644 evidence/lab6-backend-down.json create mode 100644 evidence/lab6-db-error.json create mode 100644 evidence/lab6-history.json create mode 100644 evidence/lab6-metrics.json create mode 100644 evidence/lab6-queue-lag.json create mode 100644 evidence/lab6-trace-retry.json create mode 100644 evidence/offline_validation.md create mode 100644 evidence/verified_results_2026-11-17.md create mode 100644 infra/filer.toml create mode 100644 infra/haproxy.cfg create mode 100644 infra/otel/collector.yaml create mode 100644 infra/otel/grafana/dashboards/messenger.json create mode 100644 infra/otel/grafana/provisioning/dashboards/dashboards.yml create mode 100644 infra/otel/grafana/provisioning/datasources/datasources.yml create mode 100644 infra/otel/loki.yaml create mode 100644 infra/otel/prometheus/alerts.yml create mode 100644 infra/otel/prometheus/prometheus.yml create mode 100644 infra/otel/tempo.yaml create mode 100644 requirements.txt create mode 100644 scripts/check_lab6.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 scripts/wait_ready.py create mode 100644 tests/attachments_concurrent.py create mode 100644 tests/attachments_negative.py create mode 100644 tests/idempotency_parallel.py create mode 100644 tests/jobs_sql_contract.py create mode 100644 tests/observability_live.py create mode 100644 tests/own_unit.py create mode 100644 tests/pipeline_extended.py create mode 100644 tests/pipeline_resilience.py create mode 100644 tests/telemetry_unit.py diff --git a/.env.example b/.env.example index 2b32655..eb0ac2c 100644 --- a/.env.example +++ b/.env.example @@ -1,30 +1,28 @@ -# 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 +# Copy to .env and REPLACE all sample secrets with random unique values. +# For local synthetic data only. Never commit .env. +POSTGRES_DB=messenger +POSTGRES_USER=lab +POSTGRES_PASSWORD=REPLACE_WITH_RANDOM_LOCAL_PASSWORD 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 +DB_POOL_MAX=8 S3_BUCKET=messenger-attachments -S3_ACCESS_KEY_ID_FILE=/run/secrets/s3_access_key_id -S3_SECRET_ACCESS_KEY_FILE=/run/secrets/s3_secret_access_key -MAX_UPLOAD_BYTES=10485760 -MAX_IMAGE_PIXELS=40000000 -BROKER_URL_FILE=/run/secrets/broker_url -WORKER_CONCURRENCY=2 +S3_ADMIN_ACCESS_KEY=adminlab4 +S3_ADMIN_SECRET_KEY=REPLACE_WITH_DIFFERENT_RANDOM_ADMIN_SECRET +S3_ACCESS_KEY=messengerapi +S3_SECRET_KEY=REPLACE_WITH_DIFFERENT_RANDOM_API_SECRET + +# RabbitMQ persistent queue (different from session Redis). +BROKER_USER=labworker +BROKER_PASSWORD=REPLACE_WITH_RANDOM_LOCAL_BROKER_PASSWORD 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 +JOB_BACKLOG_LIMIT=1000 +WORKER_PREFETCH=1 +# Only for deliberate crash experiment: once. Keep off for normal operation. +LAB5_FAULT_AFTER_S3=off + +# Observability (loopback-only Grafana / diagnostics). No public OTLP ports. +GRAFANA_ADMIN_PASSWORD=REPLACE_WITH_DIFFERENT_RANDOM_GRAFANA_PASSWORD +OTEL_ENABLED=yes +LAB6_FAULT_RETRY_ONCE=off diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..31979f1 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,10 @@ +FROM python:3.12.10-slim-bookworm +ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 +WORKDIR /srv +COPY requirements.txt . +RUN pip install --no-cache-dir -r requirements.txt && groupadd --gid 999 app && useradd -m --uid 999 --gid app app +COPY app ./app +COPY db ./db +USER app +EXPOSE 8080 +CMD ["python", "-m", "app"] diff --git a/Makefile b/Makefile index 5d86d17..07e73d2 100644 --- a/Makefile +++ b/Makefile @@ -1,4 +1,4 @@ -PYTHON ?= python3 +PYTHON ?= python BASE_URL ?= http://localhost:8080 CA_FILE ?= ACTION_SCRIPT ?= diff --git a/REPORT.md b/REPORT.md index b97ae42..c3593d8 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,37 +1,208 @@ -# Отчёт — лабораторная 6 +# Отчёт — лабораторная 6. Наблюдаемость -- Автор, группа: TODO -- Целевая оценка; выбранный трек 5, если нужен: TODO -- Commit/PR: TODO после публикации -- Использованные источники, библиотеки и помощь ИИ: TODO +- Автор / группа: Авзалов Артур Марсович / БПИ2301. +- Целевая оценка: 4; трек 5 не заявлен. +- Статус: кандидат на 4. Реализация проверена на Windows/Docker Desktop 2026-11-17: все шесть сценариев наблюдаемости, публичный smoke, ряд регрессионных тестов Lab5 и визуализация Grafana прошли. Целевая оценка 4; окончательную оценку определяет преподаватель. +- Commit/PR: указывается после публикации. +- ИИ: ChatGPT помог проектировать, реализовывать инструментацию, инфраструктуру, тесты и документацию. Результаты ниже получены при запуске именно Lab6; ChatGPT помог исправить диагностический тест backend-down. ## Запуск из чистого clone -TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных. +Docker Desktop (Linux containers, Compose V2), Python 3.9+ для публичных HTTP-тестов; Python 3.12 рекомендуется для локальных SDK/unit-проверок. Приложение использует Python 3.12.10. Желательно выделить Docker 6–8 GiB RAM с запасом. Перед запуском остановить Lab5 и другие стенды, занимающие 8080/3000/9090/3100/3200. Не удалять их volumes. -## Архитектура и решения +PowerShell (корень проекта): -TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab5, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации. +```powershell +Copy-Item .env.example .env +notepad .env +$env:PYTHONUTF8 = "1" +# Заменить ВСЕ REPLACE_WITH_... на разные случайные значения. +# Для паролей в DSN выбрать hex/URL-safe значения, не вставлять секреты в отчёт. +# OTEL_ENABLED=yes, LAB5_FAULT_AFTER_S3=off, LAB6_FAULT_RETRY_ONCE=off. +docker compose --env-file .env config --quiet +docker compose --env-file .env run --rm --no-deps otel-collector validate --config=/etc/otelcol/config.yaml +docker compose --env-file .env run --rm --no-deps --entrypoint /bin/promtool prometheus check config /etc/prometheus/prometheus.yml +docker compose --env-file .env up -d --build --wait +docker compose --env-file .env ps +python scripts/wait_ready.py +make check +make test +``` + +`--wait` для backend без healthcheck подтверждает только запущенный контейнер, не готовность ingestion. Дождаться `/-/ready` Prometheus, `/ready` Loki/Tempo, `/api/health` Grafana, `up` для Collector; расширенные тесты делают это автоматически. Grafana: http://127.0.0.1:3000, пользователь `admin`, пароль `GRAFANA_ADMIN_PASSWORD` из локального `.env` (задаётся при первом создании volume). Dashboard MTUCI → Lab6 | Messenger observability (`/d/lab6-messenger/`). Prometheus alerts: http://127.0.0.1:9090/alerts. Порты диагностики доступны только на loopback; никакого наружного OTLP или прямых API-реплик. + +Для локальных unit/SDK-проверок в отдельном Python 3.12 venv: + +```powershell +python -m pip install -r requirements.txt +python scripts/check_lab6.py +python tests/jobs_sql_contract.py +python tests/own_unit.py +python tests/telemetry_unit.py +# Необязательная полная OpenAPI-валидация (отдельный dev requirement): +python -m pip install -r requirements-dev.txt +make validate +``` + +Безопасная остановка: `docker compose --env-file .env down` (named volumes сохраняются). Только намеренный сброс СВОЕГО учебного стенда: `docker compose --env-file .env down -v` (удаляет и бизнес-данные, и историю телеметрии, не использовать для тестов). `.env`, реальные credentials и данные вне Git. Инициализация `migrate` транзакционна и идемпотентна; `s3-policy` готовит приватные credentials/policy, `s3-bootstrap` bucket, `telemetry-init` устанавливает права директорий named volumes. RabbitMQ queue создаётся приложением с durable/publisher confirms. Provisioning Grafana полностью из Git. + +## Архитектура и перенос Lab5 + +```text +HTTP -> HAProxy -> API1/API2 -> PostgreSQL + Redis + SeaweedFS + -> outbox -> dispatcher -> RabbitMQ -> worker + worker -> S3 + DB ready +API / dispatcher / worker (включая дочерний image process) + | OTLP HTTP/protobuf :4318, внутри telemetry + v + OTel Collector + | metrics /metrics :8889 <- Prometheus scrape + | logs native OTLP HTTP -> Loki + | traces OTLP gRPC -> Tempo + v + Grafana (запросы к трём независимым stores) +``` + +Бизнес-контракт Lab6 и исходные публичные тесты не изменены; добавляется необязательный диагностический response header `X-Trace-Id` на business HTTP при активной телеметрии. Метаданные, состояние job/outbox и идемпотентность живут в PostgreSQL; сессии в Redis AOF; оригиналы/варианты в S3; RabbitMQ доставляет задачи at-least-once. SDK и Collector не участвуют в транзакциях приложения. Worker сохраняет исходный timeout/lease и отдельный process для Pillow; таймаут/ошибки приводят к durable retry через Outbox. Изменения в `app/jobs.py`, `app/main.py`, `app/storage.py`, `app/attachments.py`, `app/image_worker.py` касаются инструментации, измерения backlog и обработки DB statement timeout; dispatcher обслуживает heartbeat даже в idle. Миграции 001–004 сохранены. Новых бизнес-таблиц не нужно: контракт job допускает optional `traceparent`, `tracestate`, они сохраняются в JSONB outbox. + +### Роли / версии / данные / доступ + +| Service | Версия (образ) | Данные, сеть, readiness | +| --- | --- | --- | +| api1/api2 | Python 3.12.10-slim-bookworm, FastAPI 0.115.12 | stateless, frontend/storage/telemetry; `/health/ready`, не опубликованы напрямую | +| lb | HAProxy 3.1.7-alpine | frontend, 127.0.0.1:8080; readiness upstream | +| postgres | 16.10-bookworm | postgres_data, storage, pg_isready | +| redis | 7.4.5-alpine | redis_data, storage, redis-cli ping, AOF | +| s3 | SeaweedFS 4.53 | s3_data, s3_config, storage; bootstrap + API head_bucket | +| broker | RabbitMQ 4.1.8-management-alpine | rabbitmq_data, storage, diagnostics ping | +| dispatcher/worker | Python 3.12.10, Pika 1.3.2, Pillow 11.3.0 | storage/telemetry, restart policy; live fault tests | +| otel-collector | contrib 0.123.0 | memory-only bounded batches, telemetry; scrape :8888/:8889 | +| prometheus | v3.2.1 | prometheus_data, telemetry, loopback 9090; /-/ready | +| loki | 3.4.2 | loki_data, TSDB v13 filesystem, loopback 3100; /ready | +| tempo | 2.7.2 | tempo_data, local blocks + WAL, loopback 3200; /ready | +| grafana | 11.6.0 | grafana_data + Git provisioning, loopback 3000; /api/health | +| telemetry-init | BusyBox 1.37.0 | one-shot chown только корней named volumes, сеть отсутствует | + +API 384 MiB/0.75 CPU на реплику, worker 768 MiB/1 CPU, dispatcher 192 MiB/0.5 CPU, Collector 256 MiB/0.75 CPU, Prometheus 384 MiB, Loki/Tempo 512 MiB каждый, Grafana 384 MiB. Реальные CPU/RAM замеряются на стенде; лимиты не измерения. Prometheus retention 72h/512MB, Loki и Tempo retention 72h (асинхронная очистка backend, не жёсткий disk quota). Все конфиги `infra/otel/` монтируются read-only. `.env.example` содержит логические настройки runtime, Compose отображает POSTGRES_* в DATABASE_URL, Redis URL фиксируется внутренней сетью, S3_* в credentials, BROKER_* в AMQP credentials. Локальный файл `.env` не коммитится; секреты хранятся в окружении контейнеров учебного стенда, не production secret manager. `STAGING_RETENTION_SECONDS` при отсутствии настройки приложения равен 86400. `WORKER_PREFETCH=1`, один активный job на worker. `OTEL_ENABLED=yes` включает SDK; endpoint `http://otel-collector:4318` задаётся Compose. `GRAFANA_ADMIN_PASSWORD` только для локального интерфейса. `LAB6_FAULT_RETRY_ONCE` — операторская настройка, по умолчанию off (не API). + +## Сигналы, запросы и единицы + +SDK OTel API/SDK/OTLP HTTP 1.42.1, явная инструментация `app/telemetry.py`. Стабильные локальные names и ограниченные semantic attributes вместо автоматического capture. `service.name=messenger-api|messenger-dispatcher|messenger-worker`, `service.version=1.6.0`, `service.instance.id=api1|api2|container hostname`, `deployment.environment.name=lab`; Prometheus exporter переводит точки в подчёркивания, добавляет суффиксы секунд/байт/total. Все histogram buckets одинаковы на репликах: 0.005…600 s. Health измеряется, но исключён из business SLI и трассировки (чтобы probe не загрязнял трассы). HTTP duration измеряется до получения заголовков ответа; потоковая передача content целиком не измеряется. Не именуем p99 средним. + +| Сигнал / Prometheus имя | Выражение / единица | +| --- | --- | +| HTTP throughput и 5xx | `sum(rate(lab_http_requests_total{route=~"/api/.*"}[30s]))`, фильтр `status_class="5xx"` для ошибок; req/s | +| p50/p95/p99 | `histogram_quantile(0.95,sum by(le)(rate(lab_http_duration_seconds_bucket{route=~"/api/.*"}[30s])))`, аналогично 0.5/0.99; секунды | +| Job outcomes | `sum by(outcome)(rate(lab_jobs_total[30s]))`, attempts/s; ready/retry/failed/stale/requeue; hard kill до метрики не считается завершённым attempt | +| Worker processing | `histogram_quantile(0.95,sum by(le)(rate(lab_job_duration_seconds_bucket[30s])))`, секунды claimed attempt | +| Time to ready | `histogram_quantile(0.95,sum by(le)(rate(lab_ready_duration_seconds_bucket[30s])))`, секунды от `processing_jobs.created_at` (время транзакции durable acceptance, близкое, но не точно равное моменту COMMIT) до commit ready, включает retry/backlog | +| Durable backlog | `max(lab_queue_depth)`: число jobs в статусе queued, включая неопубликованные и delayed retry | +| Broker queue | `max(lab_broker_ready)`: ready messages RabbitMQ через passive declare; `lab_broker_consumers` — число consumers; не включает unacked и не равно DB backlog | +| Oldest age | `max(lab_queue_oldest_age_seconds)`: now−created_at старейшей queued job; секунды; нет queued = 0 | +| DB pool | `lab_db_pool_used`, `lab_db_pool_waiting`, `lab_db_pool_capacity` по service_instance_id; connections/requests; used = size−available (включая reserved/создаваемые соединения) | +| Worker saturation | `sum(lab_worker_busy)/clamp_min(sum(lab_worker_capacity),1)`; ratio, active/capacity. Один job на процесс. При отсутствии worker ряд исчезает по expiration, это не доказательство idle | +| CPU/RAM | `lab_container_cpu_cores` (CPU seconds / wall seconds), `lab_container_memory_bytes` (cgroup v2 usage, fallback v1 CPU / RSS дерева процессов) | +| Collector internal | `otelcol_exporter_queue_size`, `otelcol_exporter_queue_capacity`, `otelcol_exporter_send_failed_spans[_total]`, `otelcol_exporter_send_failed_log_records[_total]`, `otelcol_process_memory_rss` / `otelcol_process_memory_rss_bytes`; учитывать текущую нормализацию выбранной версии | + +`method`, route template, `status_class`, `job_type`, `outcome`, `queue` — ограниченный набор label values, `service_instance_id` ограничен числом экземпляров за retention; нет raw URL, filename, user/chat/message/attachment/request/job ID. Метрики cumulative, Collector выставляет Prometheus exposition. `metric_expiration: 15s` ограничивает stale gauges (нет данных при недоступной БД, а не искусственный 0). Percentiles строятся по сумме histogram buckets всех реплик (не усреднение p95). При отсутствии событий rate/quantile может быть NaN: требуется свежая нагрузка, NaN не заменяем нулём искусственно. + +### Сквозная трасса и логи + +1. API создаёт реальный SERVER span на business route; `db.transaction` и `s3.upload_fileobj` видны как dependency spans. Request ID остаётся прежним; `http.completed` содержит request_id, status_code, method, route, trace/span ID, timestamp и severity. +2. Во время транзакции job/outbox `job_payload()` добавляет W3C `traceparent`/`tracestate`. Dispatcher извлекает их; создаёт PRODUCER span и внедряет **свой** context в сообщение RabbitMQ. Outbox хранит исходный контекст. На retry вызов из CONSUMER сохраняет его context; lease rescue/replay без активного span использует первый сохранённый context. +3. Worker извлекает context, CONSUMER является child producer; проверяет job/lease в БД. `image.subprocess` передаёт context дочернему процессу в env без секретов телеметрии; видны `image.transform`, `db.load_staging_metadata`, `s3.get_object`, `s3.put_object`, `s3.copy_object`, затем `db.publish_result`. Worker завершает `job.ready` или `job.retry`/`job.failed`, ack после durable результата/retry. В случае hard kill последний span может не успеть экспортироваться; retry продолжает trace. +4. В Grafana Explore → Tempo по `X-Trace-Id` / trace_id; открываем span; Loki: `{service_name="messenger-api"} | trace_id="" | request_id=""`, worker `{service_name="messenger-worker"} | trace_id=""`. Поля `trace_id`, `span_id`, `event` — OTLP structured metadata; тела записей фиксированные технические события. Технический job_id только в trace/log для конкретного учебного задания; SQL text, exception messages/stack traces, raw URLs, Authorization, passwords, session tokens, тело сообщений и файлы не передаются SDK. Отключён uvicorn access log, только отдельный безопасный logger передаётся в OTLP. Это проверкой синтетических sentinel полей подтверждено локально, не исчерпывающий security-аудит. + +### SLI / SLO и alerts + +SLI = 1−(число business HTTP 5xx / число всех завершённых business HTTP responses), health исключён, 4xx клиента не считаются отказом сервера. Окно 5 минут; **SLO >= 99%** (учебный, выбран нами, не обещание SLA). Dashboard SLI: `1 - ((sum(increase(lab_http_requests_total{route=~"/api/.*",status_class="5xx"}[5m])) or vector(0)) / sum(increase(lab_http_requests_total{route=~"/api/.*"}[5m])))`. Если нет трафика — нет измеримого SLI. SLI не учитывает отказ между клиентом и HAProxy либо ответы самого HAProxy, поскольку SDK в API; для production нужны LB/probe metrics. Время до ready отдельно измеряется histogram; успешные ready не учитывают навсегда failed, поэтому не подменяем им SLI доступности. + +Правила `infra/otel/prometheus/alerts.yml`: `LabAPIHighErrorRate` >5% business 5xx за 30 s, `for: 9s`; `LabQueueLag` age >15 s и depth>0, `for: 12s`. Это локальные diagnostic alert thresholds, не burn-rate track 5. Prometheus evaluation/scrape 3s; firing/pending/inactive (inactive после firing = resolved) в Prometheus UI/API, Grafana dashboard `ALERTS`. Проверка искусственными отказами — ниже; внешней доставки нет. + +### Backpressure и сбой телеметрии + +SDK async BatchSpan/BatchLogRecordProcessor queue 512 items/64 batch, HTTP exporter 2s timeout; metric reader 3s interval/2s export timeout. Не ждём backend для HTTP/normal commit; дочерний process ограниченно flush'ит (добавляет latency, остаётся внутри JOB_TIMEOUT), потеря телеметрии допустима. Collector memory_limiter 180 MiB (spike 40 MiB), container limit 256 MiB, GOMEMLIMIT 180MiB. Batch 128/256 items, timeout 1s; каждый Tempo/Loki exporter queue 64 batches, один consumer, request timeout 3s, retry до 10s. При переполнении/отказе telemetry может быть потеряна; нет бесконечной durable очереди и нет гарантий delivery telemetry. Prometheus scrape хранит history самостоятельно. `backend-down` проверяет успешные бизнес-записи/обработку изображения при остановленном Tempo, рост failed exports, sampled RSS и queue size, отсутствие OOM/restart и свежий trace после восстановления. Failed export counter отражает неуспешный экспорт Collector (не точное число всех потерянных spans SDK; повторные попытки и обрывы могут влиять). Измерение на коротком сценарии не доказательство бессрочной нагрузки. ## Доказательства критериев -| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | -| --- | --- | --- | --- | -| Публичный smoke | make test | TODO | TODO | -| Остальные пункты уровня 3 | TODO | TODO | TODO | -| Все пункты уровня 4, если заявлен | TODO | TODO | TODO | -| Выбранный трек 5, если заявлен | TODO | TODO | TODO | +Локальные проверки (в среде подготовки, 2026-11-17) см. [evidence/offline_validation.md](evidence/offline_validation.md). Фактические результаты Docker-прогона на Windows 2026-11-17 сведены в [evidence/verified_results_2026-11-17.md](evidence/verified_results_2026-11-17.md). JSON-файлы сформированы тестами на стенде; скриншоты Grafana — в `evidence/grafana/`. Неповторённые проверки отмечены отдельно. Скрипты добавлены отдельно, исходные `tests/smoke.py`, `client.py`, `load.py`, `resilience.py`, fixtures и OpenAPI сохранены byte-for-byte. -TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены. +| Критерий | Команда/сценарий | Результат / evidence | +| --- | --- | --- | +| Структура, SQL, SDK | `make check`, `python scripts/check_lab6.py`, `python tests/jobs_sql_contract.py`, `python tests/telemetry_unit.py`, `python tests/own_unit.py` | локально PASS; SDK wire-format test не проверяет Collector/backend | +| Основной API и регрессия Lab5 | `make test`, `attachments_negative`, `idempotency_parallel`, `own_unit`, `pipeline_resilience` (paused/outbox-crash/worker-crash) | PASS на Lab6; отдельные `resilience.py` и `pipeline_extended.py` в данном прогоне не подтверждены | +| Все три stores, dashboard/datasources, метрики + низкая кардинальность | `observability_live.py --scenario metrics` | PASS: ожидаемые ряды и отсутствие запрещённых ID labels; `evidence/lab6-metrics.json` | +| Upload/producer/consumer/retry, лог+trace, S3+DB result | `--scenario trace-retry` | PASS: API/producer/consumer/S3/DB с retry, связанные логи; `evidence/lab6-trace-retry.json` | +| Queue age / depth / SLO & alert | `--scenario queue-lag` | PASS: возраст 27.574387 s; queued=1; firing → ready → resolved; `evidence/lab6-queue-lag.json` | +| DB latency / 5xx alert | `--scenario db-error` | PASS: QueryCanceled/503, error ratio 1.0; firing → resolved; `evidence/lab6-db-error.json` | +| Collector ограничен, telemetry backend down | `--scenario backend-down` | PASS после исправления теста: 16 успешных записей, sampled max RSS 200.43 MiB / 256 MiB, queue 18/64, свежая трасса после восстановления; `evidence/lab6-backend-down.json` | +| Сохранение метрик/логов/traces при restart | `--scenario history` | PASS: сохранены метрики, логи, трассы после перезапуска backend; `evidence/lab6-history.json` | +| Нагрузка, percentiles, ресурсы | `tests/load.py`, `attachments_concurrent.py`, dashboard CPU/RAM, PromQL | PASS: 10/10 HTTP 202 → ready, по 3 варианта; acceptance 3.976 RPS, p50 2296.5 ms, max 2484.0 ms, все ready за 36.406 s; `evidence/attachments-concurrent.json`; 16 панелей Grafana показывают данные. Отдельный `tests/load.py` ещё не подтверждён | -## Эксперименты и отказы +### Команды полного прогона на Windows -TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения. +Список включает как уже выполненные, так и дополнительные регрессионные проверки. Фактический статус — в сводке доказательств; команды сами по себе не означают PASS. -| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | -| --- | --- | --- | --- | -| TODO | TODO | TODO | TODO | +```powershell +$env:PYTHONUTF8 = "1" +$env:LAB5_ALLOW_FAILURE_TEST = "yes" +$env:LAB6_ALLOW_FAILURE_TEST = "yes" +# Все fault tests строго последовательно, только на отдельном учебном стенде. +make test +python tests/attachments_negative.py +python tests/idempotency_parallel.py +python tests/own_unit.py +python tests/pipeline_resilience.py --scenario paused +python tests/pipeline_resilience.py --scenario outbox-crash +python tests/pipeline_resilience.py --scenario worker-crash +python tests/pipeline_extended.py --scenario broker-persistence +python tests/pipeline_extended.py --scenario failed-replay +python tests/pipeline_extended.py --scenario staging-cleanup +python tests/load.py --duration 30 --concurrency 4 --output evidence/load.json +python tests/attachments_concurrent.py --concurrency 10 --output evidence/attachments-concurrent.json +python tests/observability_live.py --scenario metrics +python tests/observability_live.py --scenario trace-retry +python tests/observability_live.py --scenario queue-lag +python tests/observability_live.py --scenario db-error +python tests/observability_live.py --scenario backend-down +python tests/observability_live.py --scenario history +python tests/resilience.py --mode persistence --action-script scripts/restart.cmd +python tests/resilience.py --mode failover --action-script scripts/stop-one.cmd +docker compose --env-file .env up -d --no-deps --wait api1 api2 +make test +``` + +На Linux соответствующие hooks `restart.sh`, `stop-one.sh` (executable). Не запускать сценарии одновременно. Fault scripts управляют реальными контейнерами, не удаляют volumes. `trace-retry` временно пересоздаёт worker с operator-only fault once, затем восстанавливает off. `db-error` удерживает lock не более 60s после захвата; освобождение в конце транзакции; не применять на production. `history` перезапускает telemetry stores с named volumes. При ошибке смотреть `docker compose logs --tail=80 `, не публиковать secrets. `make check` не заменяет runtime. Если Docker не стартует, не менять публичные тесты ради PASS. + +## Инциденты и runbook + +**Инцидент 1, гипотеза: остановлен worker.** `queue-lag` принимает синтетический upload при остановленном worker. Через метрики backlog/oldest age определяем растущую очередь, сравниваем broker ready/consumer count; API может продолжать отвечать 202, CPU worker отсутствует, DB pool нормальный. `LabQueueLag` firing; trace upload → publish есть, consume отсутствует. Запустить worker и дождаться ready, depth=0, alert inactive. Время обнаружения/возраст/глубина — в JSON результата. Факт (17.11): `queue-lag` PASS, age 27.574387 s, queued=1 при firing; после запуска worker задание стало ready, alert resolved. См. `evidence/lab6-queue-lag.json` и [графики очереди](evidence/grafana/02-worker-and-queue.png). + +**Инцидент 2, гипотеза: DB заблокирована, не медленный handler.** `db-error` удерживает кратковременный ACCESS EXCLUSIVE LOCK на `users` в отдельной psql транзакции, health SELECT 1 остаётся рабочим. Создаётся несколько business GET `/api/v1/users/me`, которые получают 503 после database statement timeout ~5s или pool timeout. В Grafana: HTTP errors/p95 растут, `db.transaction` занимает основное время и имеет error.type QueryCanceled, связанный http.completed лог с request_id; отличить от долгого обработчика с нормальными dependency spans. `LabAPIHighErrorRate` firing; после COMMIT lock запросы снова 200, error rate падает и alert inactive. Факт (17.11): `db-error` PASS, QueryCanceled и HTTP 503 обнаружены, error ratio=1.0 при firing, после снятия блокировки alert resolved. См. `evidence/lab6-db-error.json` и [графики API](evidence/grafana/01-api-and-jobs.png). + +**Инцидент 3: Tempo недоступна.** `backend-down` останавливает Tempo, посылает synthetic messages и image upload. Prometheus продолжает считать business telemetry; Collector failed spans/queue/RSS показывают сбой экспорта, API/worker продолжают обработку. После возврата Tempo создаётся новая трасса, старые могли потеряться. Факт (17.11): 16 успешных записей, обработка изображения сохранена; RSS Collector до отказа 197.35 MiB, наблюдаемый максимум 200.43 MiB при лимите 256 MiB; очередь выросла с 0/64 до 18/64. Ошибки экспорта наблюдались, свежая трасса после восстановления доступна. См. `evidence/lab6-backend-down.json` и [графики Collector](evidence/grafana/04-collector-alerts-slo.png). Первоначальный тест завершился на проверке RSS; исправлен только тест (поддержка варианта имени метрики с `_bytes`, строгая проверка очереди и диагностика лимитов); последующий живой прогон PASS. + +Для нагрузки фиксировать hardware/выделенные Docker CPU/RAM, прогрев после `up`, дату, commit, размер файла 111817 B, длительность 30s и concurrency 4 для POST messages, concurrency 10 для upload; сохранить `load.json`, `attachments-concurrent.json`, показатели p50/p95/p99 из dashboard, CPU/RAM через PromQL/периодические замеры `docker stats`. Closed-loop нагрузки не доказывают максимальную capacity; p95 из histogram приблизителен. В `evidence/` хранить только обезличенные summary и технические IDs синтетических trace, не raw secrets/requests. Скриншоты Grafana/alerts полезны как дополнение, не вместо stored results. + +### Визуальная проверка Grafana (17.11.2026) + +Все 16 панелей на четырёх приложенных скриншотах содержат данные реального запуска. Снимки показывают часовой интервал с тестовыми инцидентами и последующей нагрузкой; точные значения и состояния берутся из результатов сценариев, визуальные оценки округлены. + +| Доказательство | Что видно | +| --- | --- | +| [API и jobs](evidence/grafana/01-api-and-jobs.png) | Throughput, всплеск доли 5xx до 100%, p95/p99 около 10 s в момент сбоя, job outcomes | +| [Worker и очередь](evidence/grafana/02-worker-and-queue.png) | Processing duration, time to ready (с учётом очереди), backlog, пик возраста около 27 s | +| [Pool и ресурсы](evidence/grafana/03-pool-and-resources.png) | DB pool capacity 8 на реплику, worker saturation достигает 100%, CPU и sampled memory по экземплярам | +| [Collector, alerts, SLO](evidence/grafana/04-collector-alerts-slo.png) | Очередь экспорта Tempo при ограничении 64, failed exports, firing/pending, падение SLI ниже 99% и последующее восстановление | + +Для показа связи лога и трассы в Grafana Explore используйте сохранённый trace ID `4d8711b71965876a59aa5594ad0d51a0` из `trace-retry`, пока данные доступны по retention. При истечении retention повторите сценарий. PNG подтверждают визуализацию метрик; связанные логи и spans подтверждены тестом `trace-retry`, а не отдельными скриншотами Explore. ## Ограничения и следующие шаги -TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза. +Один Docker-host и одиночные PG, Redis, S3, RabbitMQ, LB, Collector и telemetry backends. При их потере не заявляем HA. Бизнес-данные и telemetry разделены, at-least-once не exactly-once. Наблюдаемость best-effort: SDK queue/Collector memory pressure, hard crash, offline backend могут приводить к пропускам traces/logs/metrics. Трассируем зависимость до заголовков/вызова S3, не каждую SQL-команду и не весь downloaded stream. No sampling research / burn-rate track. Нагрузочные и fault evidence приведены выше. Замеры ограничены коротким сценарием и 10 одновременными upload; отдельно `tests/load.py`, повторный полный persistence/failover бизнес-стенда и три сценария `pipeline_extended.py` в предоставленном выводе Lab6 отсутствуют. Параметры CPU/RAM Docker-host и полный вывод JSON не предоставлены для этой сводки. Примерные пароли использовались на локальном тестовом стенде; при новом развёртывании заменить их перед запуском, не коммитить `.env`. + +## Источники + +- [Описание задания](README.md), [контракт observability](contracts/observability.md), [схема job](contracts/jobs.schema.json), [карта курса](COURSE.md). +- [OpenTelemetry Collector configuration](https://opentelemetry.io/docs/collector/configuration/), [internal telemetry](https://opentelemetry.io/docs/collector/internal-telemetry/), [context propagation](https://opentelemetry.io/docs/concepts/context-propagation/), [W3C Trace Context](https://www.w3.org/TR/trace-context/). +- [Prometheus histograms](https://prometheus.io/docs/practices/histograms/), [Loki OTLP ingestion](https://grafana.com/docs/loki/latest/send-data/otel/), [Tempo configuration](https://grafana.com/docs/tempo/latest/configuration/), [Grafana provisioning](https://grafana.com/docs/grafana/latest/administration/provisioning/). diff --git a/app/__init__.py b/app/__init__.py new file mode 100644 index 0000000..e12a193 --- /dev/null +++ b/app/__init__.py @@ -0,0 +1 @@ +"""Lab 3 messenger API.""" diff --git a/app/__main__.py b/app/__main__.py new file mode 100644 index 0000000..9f5a6ff --- /dev/null +++ b/app/__main__.py @@ -0,0 +1,4 @@ +import os +import uvicorn +if __name__ == "__main__": + uvicorn.run("app.main:app", host="0.0.0.0", port=int(os.getenv("APP_PORT", "8080")), workers=1, access_log=False, timeout_graceful_shutdown=8) diff --git a/app/api.py b/app/api.py new file mode 100644 index 0000000..8f9ad0f --- /dev/null +++ b/app/api.py @@ -0,0 +1,193 @@ +"""Messenger HTTP handlers; state lives only in PostgreSQL/Redis.""" +import hashlib +import json +import re +import uuid + +import psycopg +from argon2 import PasswordHasher +from fastapi import APIRouter, Request + +from .auth import current_user, hasher, login, logout, public_user +from .core import APIError, invalid, iso, make_cursor, parse_limit, parse_uuid, read_cursor +from .models import CreateChat, CreateMessage, CreateUser +from .storage import db + +router = APIRouter() +KEY_RE = re.compile(r"^[A-Za-z0-9._:-]{1,128}$", re.ASCII) + + +def actor(req: Request) -> dict: + return getattr(req.state, "actor", None) or current_user(req) + + +def chat_detail(conn, chat: dict) -> dict: + members = conn.execute("SELECT user_id FROM chat_members WHERE chat_id=%s ORDER BY position", (chat["id"],)).fetchall() + return {"id": str(chat["id"]), "title": bytes(chat["title"]).decode("utf-8"), "created_at": iso(chat["created_at"]), "member_ids": [str(x["user_id"]) for x in members]} + + +def message_detail(conn, row: dict) -> dict: + linked = conn.execute("SELECT attachment_id FROM message_attachments WHERE message_id=%s ORDER BY position", (row["id"],)).fetchall() + return {"id": str(row["id"]), "chat_id": str(row["chat_id"]), "sender_id": str(row["sender_id"]), "text": bytes(row["text"]).decode("utf-8"), "created_at": iso(row["created_at"]), "attachment_ids": [str(x["attachment_id"]) for x in linked]} + + +def require_chat(conn, chat_id: str, actor_id: str) -> dict: + row = conn.execute("SELECT c.* FROM chats c JOIN chat_members cm ON cm.chat_id=c.id WHERE c.id=%s AND cm.user_id=%s", (chat_id, actor_id)).fetchone() + if row is None: + raise APIError(404, "not_found", "Object not found") + return row + + +@router.get("/health/live") +def live(): + return {"status": "ok"} + + +@router.get("/health/ready") +def ready(): + from .storage import ready as storage_ready + if not storage_ready(): + raise APIError(503, "unavailable", "Service not ready") + return {"status": "ok"} + + +@router.post("/api/v1/users", status_code=201) +def register(body: CreateUser): + hashed = hasher.hash(body.password) + ident = str(uuid.uuid4()) + try: + with db() as conn: + row = conn.execute("INSERT INTO users(id,username,display_name,password_hash) VALUES (%s,%s,%s,%s) RETURNING *", (ident, body.username, body.display_name.encode("utf-8"), hashed)).fetchone() + return public_user(row) + except psycopg.errors.UniqueViolation: + raise APIError(409, "conflict", "Username already exists") from None + + +@router.post("/api/v1/auth/sessions", status_code=201) +def sessions(req: Request): + return login(req) + + +@router.delete("/api/v1/auth/sessions/current", status_code=204) +def sessions_delete(req: Request): + logout(req) + return None + + +@router.get("/api/v1/users/me") +def users_me(req: Request): + return actor(req) + + +@router.post("/api/v1/chats", status_code=201) +def chats_create(req: Request, body: CreateChat): + ident = actor(req)["id"] + if ident not in body.member_ids: + raise invalid("Current user must belong to the chat") + chat_id = str(uuid.uuid4()) + try: + with db() as conn: + with conn.transaction(): + # Validate all members; FK constraints are the final authority for races. + found = conn.execute("SELECT id FROM users WHERE id = ANY(%s::uuid[])", (body.member_ids,)).fetchall() + if len(found) != len(body.member_ids): + raise invalid("Unknown member") + row = conn.execute("INSERT INTO chats(id,title) VALUES (%s,%s) RETURNING *", (chat_id, body.title.encode("utf-8"))).fetchone() + for pos, member in enumerate(body.member_ids): + conn.execute("INSERT INTO chat_members(chat_id,user_id,position) VALUES (%s,%s,%s)", (chat_id, member, pos)) + result = chat_detail(conn, row) + return result + except psycopg.errors.ForeignKeyViolation: + raise invalid("Unknown member") from None + + +@router.get("/api/v1/chats") +def chats_list(req: Request, limit: str | None = None, cursor: str | None = None): + who = actor(req)["id"] + n = parse_limit(limit) + mark = read_cursor(cursor, "chats", who) + with db() as conn: + if mark: + existing = conn.execute("SELECT 1 FROM chats c JOIN chat_members cm ON c.id=cm.chat_id WHERE c.id=%s AND c.created_at=%s AND cm.user_id=%s", (mark[1], mark[0], who)).fetchone() + if not existing: + raise invalid("Invalid cursor") + rows = conn.execute(""" + SELECT c.* FROM chats c JOIN chat_members cm ON cm.chat_id=c.id + WHERE cm.user_id=%s AND (%s::timestamptz IS NULL OR (c.created_at,c.id)>(%s::timestamptz,%s::uuid)) + ORDER BY c.created_at,c.id LIMIT %s + """, (who, mark[0] if mark else None, mark[0] if mark else None, mark[1] if mark else None, n+1)).fetchall() + items = [chat_detail(conn, row) for row in rows[:n]] + more = len(rows) > n + last = rows[n-1] if more else None + return {"items": items, "next_cursor": make_cursor("chats", who, last["created_at"], str(last["id"])) if last else None} + + +@router.get("/api/v1/chats/{chat_id}") +def chats_get(req: Request, chat_id: str): + who = actor(req)["id"] + ident = parse_uuid(chat_id) + with db() as conn: + row = require_chat(conn, ident, who) + return chat_detail(conn, row) + + +@router.post("/api/v1/chats/{chat_id}/messages", status_code=201) +def messages_create(req: Request, chat_id: str, body: CreateMessage): + who = actor(req)["id"] + ident = parse_uuid(chat_id) + key = req.headers.get("Idempotency-Key") + if not key or not KEY_RE.fullmatch(key): + raise invalid("Invalid Idempotency-Key") + # Lab3 has only text; canonical JSON avoids unstable formatting/field ordering. + fingerprint = hashlib.sha256(json.dumps({"text": body.text, "attachment_ids": body.attachment_ids}, ensure_ascii=False, sort_keys=True, separators=(",", ":")).encode("utf-8")).hexdigest() + lock_scope = f"{who}:POST:/api/v1/chats/{ident}/messages:{key}" + with db() as conn: + with conn.transaction(): + require_chat(conn, ident, who) + # Transaction-scoped advisory lock is GLOBAL across API replicas. + conn.execute("SELECT pg_advisory_xact_lock(hashtextextended(%s, 0))", (lock_scope,)) + previous = conn.execute(""" + SELECT idem.body_sha256, m.* FROM message_idempotency idem + JOIN messages m ON m.id=idem.message_id + WHERE idem.actor_id=%s AND idem.chat_id=%s AND idem.method='POST' AND idem.idem_key=%s + """, (who, ident, key)).fetchone() + if previous: + if previous["body_sha256"] != fingerprint: + raise APIError(409, "conflict", "Idempotency key used with another body") + return message_detail(conn, previous) + # 404 for foreign/nonexistent IDs; check BEFORE any message insert. + if body.attachment_ids: + owned = conn.execute("SELECT id,status FROM attachments WHERE chat_id=%s AND id=ANY(%s::uuid[])", (ident, body.attachment_ids)).fetchall() + if len(owned) != len(body.attachment_ids): + raise APIError(404, "not_found", "Attachment not found") + if any(item["status"] == "failed" for item in owned): + raise APIError(409, "conflict", "Failed attachment cannot be linked") + message_id = str(uuid.uuid4()) + row = conn.execute("INSERT INTO messages(id,chat_id,sender_id,text) VALUES (%s,%s,%s,%s) RETURNING *", (message_id, ident, who, body.text.encode("utf-8"))).fetchone() + for pos, attachment_id in enumerate(body.attachment_ids): + conn.execute("INSERT INTO message_attachments(message_id,attachment_id,position) VALUES (%s,%s,%s)", (message_id, attachment_id, pos)) + conn.execute("INSERT INTO message_idempotency(actor_id,chat_id,method,idem_key,body_sha256,message_id) VALUES (%s,%s,'POST',%s,%s,%s)", (who, ident, key, fingerprint, message_id)) + return message_detail(conn, row) + + +@router.get("/api/v1/chats/{chat_id}/messages") +def messages_list(req: Request, chat_id: str, limit: str | None = None, cursor: str | None = None): + who = actor(req)["id"] + ident = parse_uuid(chat_id) + n = parse_limit(limit) + mark = read_cursor(cursor, "messages", ident) + with db() as conn: + require_chat(conn, ident, who) + if mark: + existing = conn.execute("SELECT 1 FROM messages WHERE id=%s AND chat_id=%s AND created_at=%s", (mark[1], ident, mark[0])).fetchone() + if not existing: + raise invalid("Invalid cursor") + rows = conn.execute(""" + SELECT * FROM messages WHERE chat_id=%s + AND (%s::timestamptz IS NULL OR (created_at,id)>(%s::timestamptz,%s::uuid)) + ORDER BY created_at,id LIMIT %s + """, (ident, mark[0] if mark else None, mark[0] if mark else None, mark[1] if mark else None, n+1)).fetchall() + with db() as conn: + items = [message_detail(conn, row) for row in rows[:n]] + last = rows[n-1] if len(rows)>n else None + return {"items": items, "next_cursor": make_cursor("messages", ident, last["created_at"], str(last["id"])) if last else None} diff --git a/app/attachments.py b/app/attachments.py new file mode 100644 index 0000000..9c2f878 --- /dev/null +++ b/app/attachments.py @@ -0,0 +1,240 @@ +"""Lab5 attachments: synchronous durable admission, asynchronous image pipeline. + +202 means verified bytes were staged to private S3 and metadata + a job + an +outbox event were committed in ONE PostgreSQL transaction. No broker availability +is required for admission; the dispatcher replays unsent intents. +""" +import hashlib +import os +import tempfile +import threading +import uuid +from contextlib import closing + +import boto3 +from boto3.s3.transfer import TransferConfig +from botocore.config import Config +from botocore.exceptions import BotoCoreError, ClientError, EndpointConnectionError +from fastapi import APIRouter, Query, Request +from fastapi.responses import StreamingResponse +from PIL import Image, ImageFile, UnidentifiedImageError +from starlette.concurrency import run_in_threadpool + +from .auth import current_user +from .core import APIError, invalid, iso, parse_uuid +from .storage import db +from . import telemetry as ot + +router = APIRouter() +BUCKET = os.getenv("S3_BUCKET", "messenger-attachments") +MAX_BYTES = 10 * 1024 * 1024 +MAX_PIXELS = 40_000_000 +SPOOL_MEMORY_BYTES = 1024 * 1024 +S3_BUFFER_BYTES = 256 * 1024 +DECODE_LIMIT = threading.BoundedSemaphore(1) +Image.MAX_IMAGE_PIXELS = MAX_PIXELS +ImageFile.LOAD_TRUNCATED_IMAGES = False + + +def s3_client(): + return ot.S3Tracing(boto3.client( + "s3", endpoint_url=os.environ["S3_ENDPOINT"], + aws_access_key_id=os.environ["S3_ACCESS_KEY"], + aws_secret_access_key=os.environ["S3_SECRET_KEY"], + region_name="us-east-1", use_ssl=False, + config=Config(s3={"addressing_style": "path"}, connect_timeout=3, + read_timeout=10, retries={"max_attempts": 1}), + )) + + +def s3_error(exc): + return APIError(503, "unavailable", "Object storage unavailable") + + +def format_attachment(row, variants=()): + return { + "id": str(row["id"]), "chat_id": str(row["chat_id"]), + "owner_id": str(row["owner_id"]), "filename": row["filename"], + "content_type": row["content_type"], "size_bytes": row["size_bytes"], + "sha256": row["sha256"], "status": row["status"], + "variants": [{k: item[k] for k in ("name", "content_type", "size_bytes", "width", "height", "sha256")} + for item in variants] if row["status"] == "ready" else [], + "error_code": row["error_code"] if row["status"] == "failed" else None, + "created_at": iso(row["created_at"]), "updated_at": iso(row["updated_at"]), + } + + +def require_member(conn, chat_id, user_id): + if not conn.execute("SELECT 1 FROM chat_members WHERE chat_id=%s AND user_id=%s", (chat_id, user_id)).fetchone(): + raise APIError(404, "not_found", "Object not found") + + +def attachment_row(conn, attachment_id, user_id): + row = conn.execute(""" + SELECT a.* FROM attachments a + JOIN chat_members cm ON cm.chat_id=a.chat_id + WHERE a.id=%s AND cm.user_id=%s + """, (attachment_id, user_id)).fetchone() + if not row: + raise APIError(404, "not_found", "Object not found") + return row + + +def validate_filename(filename: str): + if not (1 <= len(filename) <= 255) or any(c in "/\\" or ord(c) < 32 or ord(c) == 127 for c in filename): + raise invalid("Invalid filename") + + +def validate_image(fileobj, mime: str): + """Validate MIME, magic, dimensions and complete decode; worker does the resize.""" + try: + fileobj.seek(0) + with Image.open(fileobj) as im: + if im.format not in ("PNG", "JPEG"): + raise APIError(415, "unsupported_media_type", "Unsupported image encoding") + actual = "image/png" if im.format == "PNG" else "image/jpeg" + if actual != mime: + raise APIError(415, "unsupported_media_type", "Content-Type does not match image") + if im.width * im.height > MAX_PIXELS: + raise APIError(413, "payload_too_large", "Image dimensions too large") + im.verify() + fileobj.seek(0) + with DECODE_LIMIT: + with Image.open(fileobj) as im: + im.load() + except APIError: + raise + except (Image.DecompressionBombError, Image.DecompressionBombWarning): + raise APIError(413, "payload_too_large", "Image dimensions too large") from None + except (UnidentifiedImageError, OSError, ValueError, SyntaxError): + raise APIError(415, "unsupported_media_type", "Invalid image") from None + finally: + fileobj.seek(0) + + +def _admit_upload(spool, *, attachment_id, chat_id, user_id, filename, mime, size, digest): + from .jobs import job_payload + stage_key = f"staging/{attachment_id}/original" + key = f"attachments/{attachment_id}/original" + backup = f"recovery/{attachment_id}/original" + job_id = str(uuid.uuid4()) + outbox_id = str(uuid.uuid4()) + client = s3_client() + try: + spool.seek(0) + client.upload_fileobj(spool, BUCKET, stage_key, + ExtraArgs={"ContentType": mime}, + Config=TransferConfig(use_threads=False, multipart_threshold=16*1024*1024, + io_chunksize=S3_BUFFER_BYTES)) + except (BotoCoreError, ClientError, EndpointConnectionError, OSError) as exc: + raise s3_error(exc) from exc + + # Atomic DB metadata + intent. If DB commit is ambiguous, do not delete the + # staged object: an accepted task may already exist; operator cleanup handles it. + with db() as conn: + with conn.transaction(): + require_member(conn, chat_id, user_id) + # Small educational admission bound; pre-existing queued tasks remain safe. + pending = conn.execute("SELECT count(*) AS c FROM processing_jobs WHERE status IN ('queued','processing')").fetchone()["c"] + if pending >= int(os.getenv("JOB_BACKLOG_LIMIT", "1000")): + raise APIError(429, "rate_limited", "Processing queue is full") + row = conn.execute(""" + INSERT INTO attachments(id,chat_id,owner_id,object_key,backup_key,filename, + content_type,size_bytes,sha256,status,staging_key,pipeline_version) + VALUES (%s,%s,%s,%s,%s,%s,%s,%s,%s,'queued',%s,1) RETURNING * + """, (attachment_id, chat_id, user_id, key, backup, filename, mime, size, digest, stage_key)).fetchone() + conn.execute(""" + INSERT INTO processing_jobs(id,attachment_id,pipeline_version,status,attempt) + VALUES (%s,%s,1,'queued',1) + """, (job_id, attachment_id)) + payload = job_payload(job_id, attachment_id, 1, 1) + conn.execute(""" + INSERT INTO job_outbox(id,job_id,payload) VALUES (%s,%s,%s::jsonb) + """, (outbox_id, job_id, __import__('json').dumps(payload))) + ot.event("upload.accepted", job_id=job_id) + return format_attachment(row) # snapshot = queued, even if worker is very fast + + +@router.post("/api/v1/chats/{chat_id}/attachments", status_code=202) +async def upload_attachment(req: Request, chat_id: str, filename: str = Query(...)): + from .api import actor, require_chat + who = actor(req)["id"] + chat_id = parse_uuid(chat_id) + validate_filename(filename) + mime = req.headers.get("content-type", "").split(";", 1)[0].strip().lower() + if mime not in ("image/png", "image/jpeg"): + raise APIError(415, "unsupported_media_type", "Only PNG and JPEG are supported") + with db() as conn: + require_chat(conn, chat_id, who) + announced = req.headers.get("content-length") + if announced: + try: + if int(announced) > MAX_BYTES: + raise APIError(413, "payload_too_large", "Image too large") + if int(announced) < 0: + raise invalid("Invalid Content-Length") + except ValueError: + raise invalid("Invalid Content-Length") from None + size = 0 + digest = hashlib.sha256() + with tempfile.SpooledTemporaryFile(max_size=SPOOL_MEMORY_BYTES, mode="w+b") as spool: + async for chunk in req.stream(): + size += len(chunk) + if size > MAX_BYTES: + raise APIError(413, "payload_too_large", "Image too large") + digest.update(chunk) + spool.write(chunk) + if not size: + raise APIError(415, "unsupported_media_type", "Empty image") + await run_in_threadpool(validate_image, spool, mime) + return await run_in_threadpool(_admit_upload, spool, attachment_id=str(uuid.uuid4()), + chat_id=chat_id, user_id=who, filename=filename, + mime=mime, size=size, digest=digest.hexdigest()) + + +@router.get("/api/v1/attachments/{attachment_id}") +def get_attachment(req: Request, attachment_id: str): + who = getattr(req.state, "actor", None) or current_user(req) + with db() as conn: + row = attachment_row(conn, parse_uuid(attachment_id), who["id"]) + variants = conn.execute(""" + SELECT name,content_type,size_bytes,width,height,sha256 + FROM attachment_variants WHERE attachment_id=%s AND pipeline_version=%s + ORDER BY CASE name WHEN 'thumbnail' THEN 0 WHEN 'crop' THEN 1 ELSE 2 END + """, (row["id"], row["pipeline_version"])).fetchall() if row["status"] == "ready" else [] + return format_attachment(row, variants) + + +@router.get("/api/v1/attachments/{attachment_id}/content") +def download_attachment(req: Request, attachment_id: str, variant: str = "original"): + who = getattr(req.state, "actor", None) or current_user(req) + with db() as conn: + row = attachment_row(conn, parse_uuid(attachment_id), who["id"]) + if row["status"] != "ready": + raise APIError(409, "conflict", "Attachment is not ready") + if variant == "original": + key, mime, size = row["object_key"], row["content_type"], row["size_bytes"] + else: + v = conn.execute(""" + SELECT * FROM attachment_variants + WHERE attachment_id=%s AND pipeline_version=%s AND name=%s + """, (row["id"], row["pipeline_version"], variant)).fetchone() + if not v: + raise APIError(404, "not_found", "Object not found") + key, mime, size = v["object_key"], v["content_type"], v["size_bytes"] + client = s3_client() + try: + response = client.get_object(Bucket=BUCKET, Key=key) + except ClientError as exc: + if exc.response.get("Error", {}).get("Code") in ("NoSuchKey", "404", "NotFound"): + raise APIError(503, "unavailable", "Stored object missing") from exc + raise s3_error(exc) from exc + except BotoCoreError as exc: + raise s3_error(exc) from exc + + def iterator(): + with closing(response["Body"]) as body: + while chunk := body.read(S3_BUFFER_BYTES): + yield chunk + + return StreamingResponse(iterator(), media_type=mime, headers={"Content-Length": str(size)}) diff --git a/app/auth.py b/app/auth.py new file mode 100644 index 0000000..8286fb3 --- /dev/null +++ b/app/auth.py @@ -0,0 +1,104 @@ +"""HTTP Basic only on login; bearer sessions shared by all API replicas.""" +import base64 +import binascii +import hashlib +import re +import secrets +import uuid +from datetime import datetime, timedelta, timezone + +from argon2 import PasswordHasher +from argon2.exceptions import VerifyMismatchError, VerificationError +from fastapi import Request +from redis.exceptions import RedisError + +from .core import APIError, SESSION_TTL, iso +from .storage import cache, db + +hasher = PasswordHasher(time_cost=2, memory_cost=19456, parallelism=1) +PASSWORD_RE = re.compile(r"^[a-z0-9_]{3,32}$") + + +def public_user(row: dict): + return {"id": str(row["id"]), "username": row["username"], "display_name": bytes(row["display_name"]).decode("utf-8"), "created_at": iso(row["created_at"])} + + +def unauthorized() -> APIError: + return APIError(401, "unauthorized", "Unauthorized") + + +def challenge(req: Request) -> str: + return 'Basic realm="messenger", charset="UTF-8"' if req.url.path == "/api/v1/auth/sessions" else 'Bearer realm="messenger"' + + +def bearer_token(req: Request) -> str: + value = req.headers.get("Authorization", "") + if not value.startswith("Bearer ") or len(value) <= 7 or " " in value[7:] or len(value) > 512: + raise unauthorized() + try: + value[7:].encode("ascii") + except UnicodeEncodeError: + raise unauthorized() from None + return value[7:] + + +def session_key(token: str) -> str: + return "session:" + hashlib.sha256(token.encode("ascii")).hexdigest() + + +def current_user(req: Request) -> dict: + token = bearer_token(req) + try: + raw = cache().get(session_key(token)) + except (RedisError, UnicodeError) as exc: + raise APIError(503, "unavailable", "Session store unavailable") from exc + if not raw: + raise unauthorized() + try: + ident = str(uuid.UUID(raw)) + except (ValueError, TypeError): + try: + cache().delete(session_key(token)) + except RedisError as exc: + raise APIError(503, "unavailable", "Session store unavailable") from exc + raise unauthorized() from None + with db() as conn: + row = conn.execute("SELECT * FROM users WHERE id = %s", (ident,)).fetchone() + if row is None: + raise unauthorized() + return public_user(row) + + +def login(req: Request): + auth = req.headers.get("Authorization", "") + if not auth.startswith("Basic "): + raise unauthorized() + try: + decoded = base64.b64decode(auth[6:].encode("ascii"), validate=True).decode("utf-8") + username, password = decoded.split(":", 1) + if not PASSWORD_RE.fullmatch(username): + raise ValueError() + except (ValueError, UnicodeError, binascii.Error): + raise unauthorized() from None + with db() as conn: + row = conn.execute("SELECT * FROM users WHERE username=%s", (username,)).fetchone() + if not row: + raise unauthorized() + try: + hasher.verify(row["password_hash"], password) + except (VerifyMismatchError, VerificationError): + raise unauthorized() from None + token = secrets.token_urlsafe(32) + try: + cache().set(session_key(token), str(row["id"]), ex=SESSION_TTL) + except RedisError as exc: + raise APIError(503, "unavailable", "Session store unavailable") from exc + return {"token": token, "token_type": "Bearer", "expires_at": iso(datetime.now(timezone.utc) + timedelta(seconds=SESSION_TTL)), "user": public_user(row)} + + +def logout(req: Request): + current_user(req) + try: + cache().delete(session_key(bearer_token(req))) + except RedisError as exc: + raise APIError(503, "unavailable", "Session store unavailable") from exc diff --git a/app/core.py b/app/core.py new file mode 100644 index 0000000..7a85e52 --- /dev/null +++ b/app/core.py @@ -0,0 +1,79 @@ +"""Configuration, HTTP errors and shared representation helpers.""" +import base64 +import json +import os +import uuid +from datetime import datetime, timezone + +from fastapi import Request + +INSTANCE_ID = os.getenv("API_INSTANCE_ID", uuid.uuid4().hex[:12]) +SESSION_TTL = int(os.getenv("SESSION_TTL_SECONDS", "3600")) +IDEMPOTENCY_TTL = max(86400, int(os.getenv("IDEMPOTENCY_TTL_SECONDS", "86400"))) + +class APIError(Exception): + def __init__(self, status: int, code: str, message: str): + super().__init__(message) + self.status = status + self.code = code + self.message = message + + +def iso(value: datetime) -> str: + return value.astimezone(timezone.utc).isoformat(timespec="microseconds").replace("+00:00", "Z") + + +def invalid(message: str = "Invalid request") -> APIError: + return APIError(400, "invalid_request", message) + + +def parse_uuid(value: str) -> str: + try: + return str(uuid.UUID(value)) + except (ValueError, TypeError, AttributeError): + raise invalid("Invalid UUID") from None + + +def parse_limit(raw: str | None) -> int: + if raw is None: + return 50 + try: + if not raw.isascii() or not raw.isdecimal(): + raise ValueError() + value = int(raw) + except (ValueError, AttributeError): + raise invalid("Invalid limit") from None + if not 1 <= value <= 100: + raise invalid("Invalid limit") + return value + + +def make_cursor(kind: str, scope: str, created: datetime, ident: str) -> str: + b = json.dumps({"kind": kind, "scope": scope, "created_at": iso(created), "id": ident}, separators=(",", ":")).encode() + return base64.urlsafe_b64encode(b).decode().rstrip("=") + + +def read_cursor(raw: str | None, kind: str, scope: str): + if raw is None: + return None + try: + if not raw or len(raw) > 2048 or any(ch not in "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_" for ch in raw): + raise ValueError() + data = json.loads(base64.b64decode(raw + "=" * (-len(raw) % 4), altchars=b"-_", validate=True)) + if not isinstance(data, dict) or data.get("kind") != kind or data.get("scope") != scope: + raise ValueError() + created = datetime.fromisoformat(data["created_at"].replace("Z", "+00:00")) + if created.tzinfo is None: + raise ValueError() + ident = str(uuid.UUID(data["id"])) + return created, ident + except (ValueError, TypeError, KeyError, UnicodeError, json.JSONDecodeError): + raise invalid("Invalid cursor") from None + + +def request_id(req: Request) -> str: + return getattr(req.state, "request_id", uuid.uuid4().hex) + + +def error_body(req: Request, code: str, message: str): + return {"error": {"code": code, "message": message, "request_id": request_id(req)}} diff --git a/app/image_worker.py b/app/image_worker.py new file mode 100644 index 0000000..9e3f1ee --- /dev/null +++ b/app/image_worker.py @@ -0,0 +1,124 @@ +"""Sandboxed-per-task image work. Process is killed after JOB_TIMEOUT_SECONDS. + +Outputs only JSON variant metadata. Original bytes are copied from durable staging, +never transformed. Pillow reopens/exif-transposes pixels for derivatives, stripping +metadata on re-encode. No API tokens or arbitrary user paths enter this command. +""" +import hashlib +import io +import json +import os +import sys + +from PIL import Image, ImageOps, UnidentifiedImageError +from botocore.exceptions import ClientError, BotoCoreError + +from .attachments import BUCKET, MAX_BYTES, MAX_PIXELS, s3_client +from . import telemetry as ot +from opentelemetry.trace import SpanKind + +Image.MAX_IMAGE_PIXELS = MAX_PIXELS + + +def rgb_image(src): + orient = ImageOps.exif_transpose(src) + orient.load() + if orient.width * orient.height > MAX_PIXELS: + raise ValueError("too many decoded pixels") + # Compose transparency on white, strip EXIF/ICC and do not enlarge. + rgba = orient.convert("RGBA") + white = Image.new("RGBA", rgba.size, (255, 255, 255, 255)) + white.alpha_composite(rgba) + return white.convert("RGB") + + +def transform(raw): + with Image.open(io.BytesIO(raw)) as image: + if image.format not in ("PNG", "JPEG"): + raise ValueError("invalid encoding") + rgb = rgb_image(image) + t = rgb.copy() + t.thumbnail((256, 256), resample=Image.Resampling.LANCZOS) + # Center crop fit scales up small images when needed. + crop = ImageOps.fit(rgb, (128, 128), method=Image.Resampling.LANCZOS, centering=(0.5, 0.5)) + optim = rgb.copy() + optim.thumbnail((1280, 1280), resample=Image.Resampling.LANCZOS) + return [ + ("thumbnail", t, "JPEG", "image/jpeg", {"quality": 85, "optimize": True}), + ("crop", crop, "JPEG", "image/jpeg", {"quality": 85, "optimize": True}), + ("optimized", optim, "WEBP", "image/webp", {"quality": 78, "method": 4}), + ] + + +def run(attachment_id, pipeline_version): + import psycopg + from psycopg.rows import dict_row + + with ot.span("db.load_staging_metadata", kind=SpanKind.CLIENT, attrs={"db.system.name":"postgresql"}): + with psycopg.connect(os.environ["DATABASE_URL"], row_factory=dict_row, connect_timeout=5) as conn: + row = conn.execute(""" + SELECT * FROM attachments WHERE id=%s AND pipeline_version=%s + """, (attachment_id, pipeline_version)).fetchone() + if not row or not row["staging_key"]: + raise ValueError("staging metadata not found") + + client = s3_client() + body = client.get_object(Bucket=BUCKET, Key=row["staging_key"])["Body"] + try: + raw = body.read(MAX_BYTES + 1) + finally: + body.close() + if not raw or len(raw) > MAX_BYTES or len(raw) != row["size_bytes"]: + raise ValueError("staging size mismatch") + if hashlib.sha256(raw).hexdigest() != row["sha256"]: + raise ValueError("staging checksum mismatch") + + # Recompute every result if a prior run was interrupted. Keys are deterministic + # for (attachment_id,pipeline_version,variant), so duplicates don't multiply objects. + output = [] + for name, image, fmt, mime, options in transform(raw): + buf = io.BytesIO() + image.save(buf, format=fmt, **options) + encoded = buf.getvalue() + key = f"variants/{attachment_id}/v{pipeline_version}/{name}" + client.put_object(Bucket=BUCKET, Key=key, Body=encoded, ContentType=mime) + output.append({"name": name, "content_type": mime, + "size_bytes": len(encoded), "sha256": hashlib.sha256(encoded).hexdigest(), + "width": image.width, "height": image.height, "object_key": key}) + + # Only after derivatives exist, publish unchanged primary and recovery copy. + client.copy_object(Bucket=BUCKET, Key=row["object_key"], + CopySource={"Bucket": BUCKET, "Key": row["staging_key"]}, + MetadataDirective="REPLACE", ContentType=row["content_type"]) + client.copy_object(Bucket=BUCKET, Key=row["backup_key"], + CopySource={"Bucket": BUCKET, "Key": row["object_key"]}, + MetadataDirective="REPLACE", ContentType=row["content_type"]) + return output + + +def main(): + import uuid + if len(sys.argv) != 3: + raise SystemExit(2) + try: + ident = str(uuid.UUID(sys.argv[1])) + version = int(sys.argv[2]) + if version < 1: + raise ValueError("invalid version") + ot.init("worker", child=True) + with ot.span("image.transform", context=ot.extract(json.loads(os.getenv("LAB6_PARENT_CONTEXT", "{}")))): + out = run(ident, version) + ot.event("image.transformed") + print(json.dumps({"variants": out}, ensure_ascii=False)) + except (ValueError, UnidentifiedImageError, Image.DecompressionBombError, Image.DecompressionBombWarning) as exc: + print("Permanent image processing failure", file=sys.stderr) + raise SystemExit(20) from None + except (BotoCoreError, ClientError, OSError): + print("Transient object storage failure", file=sys.stderr) + raise SystemExit(30) from None + +if __name__ == "__main__": + try: + main() + finally: + ot.flush() diff --git a/app/jobs.py b/app/jobs.py new file mode 100644 index 0000000..504800d --- /dev/null +++ b/app/jobs.py @@ -0,0 +1,470 @@ +"""Durable RabbitMQ delivery + PostgreSQL transactional outbox and worker leases. + +There is no exactly-once transport guarantee. We guarantee eventual recovery of +committed intent and idempotent DB results under at-least-once redelivery. +Commands: `python -m app.jobs dispatch`, `worker`, `replay --id UUID`, `status`. +""" +import argparse +from contextlib import contextmanager +import json +import logging +import os +import random +import subprocess +import sys +import time +import threading +from . import telemetry as ot +from opentelemetry.trace import SpanKind, Status, StatusCode +import uuid +from datetime import datetime, timezone, timedelta + +import pika +import psycopg +from pika.exceptions import AMQPError +from psycopg.rows import dict_row + +log = logging.getLogger("lab5.jobs") +logging.basicConfig(level=logging.INFO, format="%(asctime)s %(levelname)s %(message)s") +QUEUE = "attachment-processing.v1" +MAX_ATTEMPTS = int(os.getenv("JOB_MAX_ATTEMPTS", "5")) +JOB_TIMEOUT = int(os.getenv("JOB_TIMEOUT_SECONDS", "60")) +LEASE_SECONDS = JOB_TIMEOUT + 45 + + +@contextmanager +def connect_db(): + # No credentials, SQL text, or parameters in spans. + with ot.dependency_span('db.job.transaction', kind=SpanKind.CLIENT, attrs={'db.system.name':'postgresql'}): + with psycopg.connect(os.environ["DATABASE_URL"], row_factory=dict_row, connect_timeout=5, options='-c statement_timeout=5000') as conn: + yield conn + + +def job_payload(job_id, attachment_id, version, attempt): + return { + "schema_version": 1, "job_id": str(job_id), "type": "attachment.process.v1", + "attachment_id": str(attachment_id), "pipeline_version": version, + "attempt": attempt, "created_at": datetime.now(timezone.utc).isoformat(), + **ot.inject(), + } + + +@contextmanager +def connection(): + params = pika.ConnectionParameters( + host=os.getenv("BROKER_HOST", "broker"), port=5672, + credentials=pika.PlainCredentials(os.environ["BROKER_USER"], os.environ["BROKER_PASSWORD"]), + heartbeat=max(120, JOB_TIMEOUT + 60), blocked_connection_timeout=120, + socket_timeout=5, connection_attempts=3, retry_delay=1) + mq = pika.BlockingConnection(params) + try: + yield mq + finally: + try: + if mq.is_open: + mq.close() + except AMQPError: + pass + + +def setup_channel(conn): + ch = conn.channel() + ch.queue_declare(queue=QUEUE, durable=True) + return ch + + +def queue_outbox(db, job_id, attachment_id, version, attempt, available_at=None): + payload = job_payload(job_id, attachment_id, version, attempt) + if not payload.get('traceparent'): + # Lease rescue/replay has no active consumer context. Preserve the first + # acceptance context rather than inventing a new disconnected trace. + previous = db.execute("SELECT payload FROM job_outbox WHERE job_id=%s ORDER BY created_at,id LIMIT 1", (job_id,)).fetchone() + if previous: + payload.update({k: previous['payload'][k] for k in ('traceparent','tracestate') if k in previous['payload']}) + db.execute(""" + INSERT INTO job_outbox(id,job_id,payload,available_at) + VALUES (%s,%s,%s::jsonb,COALESCE(%s,now())) + """, (str(uuid.uuid4()), job_id, json.dumps(payload), available_at)) + + +def cleanup_abandoned_staging(): + """Best effort cleanup of retained stages; never delete current processing work.""" + from .attachments import BUCKET, s3_client + client = s3_client() + retention = max(3600, int(os.getenv("STAGING_RETENTION_SECONDS", "86400"))) + with connect_db() as db: + rows = db.execute(""" + SELECT id,staging_key FROM attachments + WHERE staging_key IS NOT NULL AND + ((status='ready' AND updated_at < now()-interval '300 seconds') OR + (status='failed' AND updated_at < now()-(%s*interval '1 second'))) + LIMIT 50 + """, (retention,)).fetchall() + for row in rows: + with connect_db() as db: + with db.transaction(): + # Row-level lock serializes against operator replay. + current = db.execute("SELECT status,staging_key,updated_at FROM attachments WHERE id=%s FOR UPDATE", (row["id"],)).fetchone() + if not current or current["staging_key"] != row["staging_key"]: + continue + age = (datetime.now(timezone.utc) - current["updated_at"]).total_seconds() + if not (current["status"] == "ready" and age >= 300 or current["status"] == "failed" and age >= retention): + continue + client.delete_object(Bucket=BUCKET, Key=row["staging_key"]) + db.execute("UPDATE attachments SET staging_key=NULL WHERE id=%s AND staging_key=%s", (row["id"], row["staging_key"])) + # Also prune staging uploads whose DB COMMIT failed, after a long retention. + from botocore.exceptions import ClientError + for page in client.get_paginator("list_objects_v2").paginate(Bucket=BUCKET, Prefix="staging/"): + for obj in page.get("Contents", []): + if (datetime.now(timezone.utc) - obj["LastModified"]).total_seconds() < retention: + continue + key = obj["Key"] + with connect_db() as db: + with db.transaction(): + referenced = db.execute("SELECT 1 FROM attachments WHERE staging_key=%s", (key,)).fetchone() + if not referenced: + client.delete_object(Bucket=BUCKET, Key=key) + +def rescue_expired_jobs(conn): + """Requeue leased jobs whose worker died (durably, no manual task recreation).""" + with conn.transaction(): + rows = conn.execute(""" + SELECT j.id,j.attachment_id,j.pipeline_version,j.attempt + FROM processing_jobs j + WHERE j.status='processing' AND j.leased_until < now() + FOR UPDATE SKIP LOCKED LIMIT 20 + """).fetchall() + for row in rows: + if row["attempt"] >= MAX_ATTEMPTS: + conn.execute("""UPDATE processing_jobs + SET status='failed',error_code='retry_exhausted',lease_token=NULL,leased_until=NULL,updated_at=now() + WHERE id=%s""", (row["id"],)) + conn.execute("""UPDATE attachments SET status='failed',error_code='retry_exhausted',updated_at=now() + WHERE id=%s""", (row["attachment_id"],)) + else: + attempt = row["attempt"] + 1 + conn.execute("""UPDATE processing_jobs SET status='queued',attempt=%s, + lease_token=NULL,leased_until=NULL,next_run_at=now(),updated_at=now() + WHERE id=%s""", (attempt, row["id"])) + conn.execute("UPDATE attachments SET status='queued',updated_at=now() WHERE id=%s", (row["attachment_id"],)) + queue_outbox(conn, row["id"], row["attachment_id"], row["pipeline_version"], attempt) + log.warning("reclaimed timed-out job %s attempt %s", row["id"], attempt) + + +def sample_backlog(): + # Query durable *queued* jobs, including delayed retries and unpublished outbox. + # No broker membership scan; oldest age is wall clock since initial acceptance. + while True: + try: + with psycopg.connect(os.environ['DATABASE_URL'], row_factory=dict_row, connect_timeout=3, options='-c statement_timeout=2000') as db: + row = db.execute("SELECT count(*) AS depth, COALESCE(EXTRACT(EPOCH FROM now()-min(created_at)),0) AS age FROM processing_jobs WHERE status='queued'").fetchone() + ot.backlog_depth, ot.backlog_age = row['depth'], float(row['age']) + except psycopg.Error: + ot.backlog_depth = ot.backlog_age = None + time.sleep(3) + + +def dispatch_loop(): + """Publish outbox rows with publisher confirm, mark only AFTER confirm.""" + threading.Thread(target=sample_backlog, daemon=True).start() + while True: + try: + with connection() as mq: + ch = setup_channel(mq) + ch.confirm_delivery() + last_clean = time.monotonic() + last_queue_sample = 0 + while True: + # Periodic lease recovery works even if original message was consumed. + with connect_db() as conn: + rescue_expired_jobs(conn) + with conn.transaction(): + rows = conn.execute(""" + SELECT id,payload FROM job_outbox + WHERE published_at IS NULL AND available_at<=now() + ORDER BY available_at,created_at + FOR UPDATE SKIP LOCKED LIMIT 20 + """).fetchall() + for row in rows: + if os.getenv("LAB5_FAULT_BEFORE_PUBLISH") == "once": + # Persist one-time fault before hard exit; outbox still + # unmarked and dispatcher will publish on restart. + with connect_db() as faultdb: + inserted = faultdb.execute(""" + INSERT INTO job_fault_once(job_id,fault) VALUES (%s,'before_publish') + ON CONFLICT DO NOTHING RETURNING job_id + """, (row["payload"]["job_id"],)).fetchone() + if inserted: + os._exit(78) + payload = row['payload'] + with ot.span('rabbitmq.publish', kind=SpanKind.PRODUCER, context=ot.extract(payload), + attrs={'messaging.system':'rabbitmq','messaging.destination.name':QUEUE,'job.attempt':payload['attempt']}) as producer: + # Propagate actual producer span, while DB retains the original intent. + raw = json.dumps({**payload, **ot.inject()}, separators=(",", ":")) + ch.basic_publish(exchange="", routing_key=QUEUE, body=raw.encode("utf-8"), + mandatory=True, properties=pika.BasicProperties(content_type="application/json", delivery_mode=2)) + conn.execute("UPDATE job_outbox SET published_at=now() WHERE id=%s", (row["id"],)) + ot.event('job.published', job_id=payload['job_id'], attempt=payload['attempt']) + if time.monotonic() - last_queue_sample > 3: + q = ch.queue_declare(queue=QUEUE, passive=True).method + ot.broker_ready, ot.broker_consumers = q.message_count, q.consumer_count + last_queue_sample = time.monotonic() + if time.monotonic() - last_clean > 60: + try: + cleanup_abandoned_staging() + except Exception: + log.warning("staging janitor failed; retry later") + last_clean = time.monotonic() + if not rows: + mq.sleep(1) + except (AMQPError, OSError, psycopg.Error) as exc: + ot.broker_ready = ot.broker_consumers = None + log.warning("dispatcher reconnect after %s", type(exc).__name__) + time.sleep(2) + + +def claim_job(db, message): + job_id = message["job_id"] + with db.transaction(): + job = db.execute("SELECT * FROM processing_jobs WHERE id=%s FOR UPDATE", (job_id,)).fetchone() + if job is None or job["status"] in ("ready", "failed") or job["attempt"] != message["attempt"] or job["pipeline_version"] != message["pipeline_version"]: + return "ignore", None + if job["status"] == "processing": + return "busy", None + if job["next_run_at"] > datetime.now(timezone.utc): + return "busy", None + lease = str(uuid.uuid4()) + db.execute("""UPDATE processing_jobs SET status='processing',lease_token=%s, + leased_until=now()+(%s*interval '1 second'),updated_at=now() + WHERE id=%s""", (lease, LEASE_SECONDS, job_id)) + db.execute("UPDATE attachments SET status='processing',updated_at=now() WHERE id=%s", (job["attachment_id"],)) + return "claimed", {"job": job, "lease": lease} + + +def publish_result(db, *, job, lease, variants): + """Final result is committed atomically; stale leases/versions cannot publish.""" + with db.transaction(): + current = db.execute("SELECT * FROM processing_jobs WHERE id=%s FOR UPDATE", (job["id"],)).fetchone() + if current["status"] != "processing" or str(current["lease_token"]) != lease or current["pipeline_version"] != job["pipeline_version"]: + log.warning("stale worker result ignored %s", job["id"]) + return False + for v in variants: + db.execute(""" + INSERT INTO attachment_variants(attachment_id,pipeline_version,name,object_key,content_type,size_bytes,sha256,width,height) + VALUES (%s,%s,%s,%s,%s,%s,%s,%s,%s) + ON CONFLICT(attachment_id,pipeline_version,name) DO UPDATE SET + object_key=EXCLUDED.object_key,content_type=EXCLUDED.content_type, + size_bytes=EXCLUDED.size_bytes,sha256=EXCLUDED.sha256, + width=EXCLUDED.width,height=EXCLUDED.height + """, (job["attachment_id"], job["pipeline_version"], v["name"], v["object_key"], + v["content_type"], v["size_bytes"], v["sha256"], v["width"], v["height"])) + db.execute("""UPDATE attachments SET status='ready',error_code=NULL,updated_at=now() + WHERE id=%s AND pipeline_version=%s""", (job["attachment_id"], job["pipeline_version"])) + db.execute("""UPDATE processing_jobs SET status='ready',lease_token=NULL,leased_until=NULL, + error_code=NULL,updated_at=now() WHERE id=%s""", (job["id"],)) + return True + + +def fail_job(db, job, lease, *, permanent=False, code="processing_failed"): + with db.transaction(): + current = db.execute("SELECT * FROM processing_jobs WHERE id=%s FOR UPDATE", (job["id"],)).fetchone() + if current["status"] != "processing" or str(current["lease_token"]) != lease: + return "stale" + if permanent or job["attempt"] >= MAX_ATTEMPTS: + code = code if permanent else "retry_exhausted" + db.execute("""UPDATE processing_jobs SET status='failed',error_code=%s,lease_token=NULL, + leased_until=NULL,updated_at=now() WHERE id=%s""", (code, job["id"])) + db.execute("UPDATE attachments SET status='failed',error_code=%s,updated_at=now() WHERE id=%s", (code, job["attachment_id"])) + return "failed" + else: + attempt = job["attempt"] + 1 + delay = min(60.0, 2.0 * (2 ** (attempt - 2))) + random.uniform(0, 1.0) + run_at = datetime.now(timezone.utc) + timedelta(seconds=delay) + db.execute("""UPDATE processing_jobs SET status='queued',attempt=%s,next_run_at=%s, + lease_token=NULL,leased_until=NULL,updated_at=now() WHERE id=%s""", (attempt, run_at, job["id"])) + db.execute("UPDATE attachments SET status='queued',updated_at=now() WHERE id=%s", (job["attachment_id"],)) + queue_outbox(db, job["id"], job["attachment_id"], job["pipeline_version"], attempt, run_at) + log.warning("job %s scheduled retry %s after %.1fs", job["id"], attempt, delay) + return "retry" + + +def cleanup_staging(job): + from .attachments import BUCKET, s3_client + from botocore.exceptions import BotoCoreError, ClientError + try: + with connect_db() as conn: + row = conn.execute("SELECT staging_key,status FROM attachments WHERE id=%s", (job["attachment_id"],)).fetchone() + if row and row["status"] == "ready" and row["staging_key"]: + s3_client().delete_object(Bucket=BUCKET, Key=row["staging_key"]) + with connect_db() as conn: + conn.execute("UPDATE attachments SET staging_key=NULL WHERE id=%s AND status='ready' AND staging_key=%s", + (job["attachment_id"], row["staging_key"])) + except (BotoCoreError, ClientError, psycopg.Error, OSError): + log.warning("staging cleanup deferred for %s", job["id"]) + + +def process_message(raw): + try: + carrier = json.loads(raw) + if not isinstance(carrier, dict): carrier = {} + except (ValueError, TypeError): + carrier = {} + with ot.span('rabbitmq.consume', kind=SpanKind.CONSUMER, context=ot.extract(carrier), + attrs={'messaging.system':'rabbitmq','messaging.destination.name':QUEUE}) as consumer: + return process_message_inner(raw, consumer) + + +def process_message_inner(raw, consumer): + try: + msg = json.loads(raw) + assert msg["schema_version"] == 1 and msg["type"] == "attachment.process.v1" + uuid.UUID(msg["job_id"]) + uuid.UUID(msg["attachment_id"]) + assert type(msg["attempt"]) is int and msg["attempt"] >= 1 + except (ValueError, KeyError, AssertionError, TypeError): + log.error("invalid internal broker message discarded") + return "ack" # no secrets printed, does not touch DB + with connect_db() as db: + status, state = claim_job(db, msg) + if status == "ignore": + return "ack" + if status == "busy": + return "requeue" + job, lease = state["job"], state["lease"] + consumer.set_attribute('job.attempt',job['attempt']) + consumer.set_attribute('job.id',str(job['id'])) + ot.event('job.claimed', job_id=str(job['id']), attempt=job['attempt']) + start = time.monotonic() + ot.worker_busy = 1 + def done(outcome): + attrs = {'job_type':'attachment.process.v1','outcome':outcome} + ot.count('lab_jobs',attrs) + ot.observe('lab_job_duration',time.monotonic()-start,attrs) + if outcome == 'retry': + ot.count('lab_job_retries',{'job_type':'attachment.process.v1'}) + if outcome in ('retry','failed','requeue'): + consumer.set_status(Status(StatusCode.ERROR)) + consumer.set_attribute('job.outcome',outcome) + ot.event('job.'+outcome, level=logging.ERROR if outcome in ('failed','retry','requeue') else logging.INFO, job_id=str(job['id']), attempt=job['attempt']) + try: + if os.getenv('LAB6_FAULT_RETRY_ONCE') == 'once': + with connect_db() as db: + inserted = db.execute("INSERT INTO job_fault_once(job_id,fault) VALUES (%s,'lab6_retry') ON CONFLICT DO NOTHING RETURNING job_id", (job['id'],)).fetchone() + if inserted: + raise RuntimeError('injected transient retry') + cmd = [sys.executable, "-m", "app.image_worker", str(job["attachment_id"]), str(job["pipeline_version"])] + with ot.span('image.subprocess'): + env = {**os.environ, 'LAB6_PARENT_CONTEXT': json.dumps(ot.inject())} + proc = subprocess.run(cmd, capture_output=True, timeout=JOB_TIMEOUT, check=False, env=env) + if proc.returncode != 0: + with connect_db() as db: + outcome = fail_job(db, job, lease, permanent=(proc.returncode == 20), + code="invalid_image" if proc.returncode == 20 else "processing_failed") + done(outcome) + return "ack" # next attempt is already safely in DB outbox + result = json.loads(proc.stdout) + variants = result["variants"] + if sorted(v["name"] for v in variants) != ["crop", "optimized", "thumbnail"]: + raise ValueError("incomplete variants") + if os.getenv("LAB5_FAULT_AFTER_S3") == "once": + # One-time operator-only injected hard death, after all S3 writes and + # before DB result commit/ack; SQL PK prevents endless failure loop. + with connect_db() as db: + with db.transaction(): + inserted = db.execute(""" + INSERT INTO job_fault_once(job_id,fault) VALUES (%s,'after_s3') + ON CONFLICT DO NOTHING RETURNING job_id + """, (job["id"],)).fetchone() + if inserted: + os._exit(77) + with ot.span("db.publish_result", kind=SpanKind.CLIENT, attrs={"db.system.name":"postgresql"}): + with connect_db() as db: + ok = publish_result(db, job=job, lease=lease, variants=variants) + if ok: + ot.observe('lab_ready_duration',(datetime.now(timezone.utc)-job['created_at']).total_seconds(), {'job_type':'attachment.process.v1'}) + cleanup_staging(job) + done('ready' if ok else 'stale') + return "ack" + except subprocess.TimeoutExpired: + with connect_db() as db: + outcome = fail_job(db, job, lease, code="processing_timeout") + done(outcome) + return "ack" + except Exception: + log.exception("job processing failure (internal details not sent to API)") + # Leave lease for dispatcher recovery if even DB unavailable. + try: + with connect_db() as db: + outcome = fail_job(db, job, lease) + done(outcome) + return "ack" + except psycopg.Error: + done("requeue") + return "requeue" + finally: + ot.worker_busy = 0 + + +def worker_loop(): + while True: + try: + with connection() as mq: + ch = setup_channel(mq) + ch.basic_qos(prefetch_count=max(1, int(os.getenv("WORKER_PREFETCH", "1")))) + + def callback(channel, method, props, body): + outcome = process_message(body) + if outcome == "ack": + channel.basic_ack(method.delivery_tag) + else: + channel.basic_nack(method.delivery_tag, requeue=True) + time.sleep(2) # prevent tight redelivery spin on an active lease + + ch.basic_consume(queue=QUEUE, on_message_callback=callback, auto_ack=False) + log.info("worker ready; max attempts=%d timeout=%ds", MAX_ATTEMPTS, JOB_TIMEOUT) + ch.start_consuming() + except (AMQPError, OSError, psycopg.Error) as exc: + log.warning("worker reconnect after %s", type(exc).__name__) + time.sleep(2) + + +def replay_failed(ident): + with connect_db() as db: + with db.transaction(): + row = db.execute("SELECT * FROM processing_jobs WHERE attachment_id=%s FOR UPDATE", (ident,)).fetchone() + if not row or row["status"] != "failed": + raise RuntimeError("Only failed jobs may be explicitly replayed") + attachment = db.execute("SELECT staging_key FROM attachments WHERE id=%s", (ident,)).fetchone() + if not attachment or not attachment["staging_key"]: + raise RuntimeError("Retained staging is required for replay") + db.execute("""UPDATE processing_jobs SET status='queued',attempt=1,next_run_at=now(), + lease_token=NULL,leased_until=NULL,error_code=NULL,updated_at=now() WHERE id=%s""", (row["id"],)) + db.execute("UPDATE attachments SET status='queued',error_code=NULL,updated_at=now() WHERE id=%s", (ident,)) + queue_outbox(db, row["id"], ident, row["pipeline_version"], 1) + db.execute("INSERT INTO job_replay_audit(id,job_id) VALUES (%s,%s)", (str(uuid.uuid4()), row["id"])) + print("Replayed failed job", ident) + + +def main(): + parser = argparse.ArgumentParser() + parser.add_argument("mode", choices=["dispatch", "worker", "replay", "status"]) + parser.add_argument("--id", help="UUID for explicit operator replay/status") + args = parser.parse_args() + if args.mode == "dispatch": + ot.init("dispatcher") + dispatch_loop() + elif args.mode == "worker": + ot.init("worker") + worker_loop() + elif args.mode in ("replay", "status"): + if not args.id: + parser.error("--id is required") + ident = str(uuid.UUID(args.id)) + if args.mode == "replay": + replay_failed(ident) + else: + with connect_db() as db: + print(json.dumps(db.execute("SELECT status,attempt,error_code FROM processing_jobs WHERE attachment_id=%s", (ident,)).fetchone(), default=str)) + +if __name__ == "__main__": + main() diff --git a/app/main.py b/app/main.py new file mode 100644 index 0000000..1fe53e6 --- /dev/null +++ b/app/main.py @@ -0,0 +1,117 @@ +"""FastAPI process: one stateless replica. No auto-migration on startup.""" +import logging +import uuid +import time +from starlette.routing import Match +from opentelemetry.trace import SpanKind, Status, StatusCode +from . import telemetry as ot +from contextlib import asynccontextmanager + +import psycopg +from fastapi import FastAPI, Request +from fastapi.exceptions import RequestValidationError +from fastapi.responses import JSONResponse +from starlette.concurrency import run_in_threadpool +from redis.exceptions import RedisError + +from .api import router +from .attachments import router as attachment_router +from .auth import challenge, current_user +from .core import APIError, INSTANCE_ID, error_body, invalid, request_id +from .storage import start, stop + +logging.basicConfig(level="INFO") +logger = logging.getLogger("lab5") + +@asynccontextmanager +async def lifespan(app: FastAPI): + ot.init("api") + start() + try: + yield + finally: + stop() + ot.flush() + +app = FastAPI(title="MTUCI Messenger Lab 6", docs_url=None, redoc_url=None, openapi_url=None, lifespan=lifespan) +app.include_router(router) +app.include_router(attachment_router) + +PROTECTED = ("/api/v1/chats", "/api/v1/attachments", "/api/v1/users/me", "/api/v1/auth/sessions/current") +JSON_POST = ("/api/v1/users", "/api/v1/chats") + + +@app.middleware("http") +async def request_context(req: Request, call_next): + # Match the registered template even when early authentication fails. + route = next((r.path for r in app.routes if r.matches(req.scope)[0] == Match.FULL), 'unmatched') + method = req.method if req.method in ('GET','POST','DELETE','PUT','PATCH','HEAD','OPTIONS') else 'OTHER' + attrs = {'method': method, 'route': route} + start_at = time.monotonic() + if route in ("/health/live", "/health/ready"): + response = await handle_request(req, call_next) + attrs["status_class"] = str(response.status_code//100)+"xx" + ot.count("lab_http_requests", attrs) + ot.observe("lab_http_duration", time.monotonic()-start_at, attrs) + return response + with ot.span(method+' '+route, kind=SpanKind.SERVER, attrs={'http.request.method':method,'http.route':route}) as span: + response = await handle_request(req, call_next) + attrs['status_class'] = str(response.status_code//100)+'xx' + span.set_attribute('http.response.status_code', response.status_code) + if response.status_code >= 500: + span.set_status(Status(StatusCode.ERROR)) + ot.count('lab_http_requests', attrs) + ot.observe('lab_http_duration', time.monotonic()-start_at, attrs) + ot.event('http.completed', level=logging.ERROR if response.status_code >= 500 else logging.INFO, + request_id=request_id(req), route=route, method=method, status_code=response.status_code) + if ot.trace_id(): + response.headers['X-Trace-Id'] = ot.trace_id() + return response + + +async def handle_request(req: Request, call_next): + req.state.request_id = uuid.uuid4().hex + try: + path = req.url.path + # Authenticate before parsing the request body or resource-specific fields. + if any(path == p or path.startswith(p + "/") for p in PROTECTED): + req.state.actor = await run_in_threadpool(current_user, req) + if req.method == "POST" and (path in JSON_POST or (path.startswith("/api/v1/chats/") and path.endswith("/messages"))): + if req.headers.get("content-type", "").split(";", 1)[0].strip().lower() != "application/json": + raise APIError(415, "unsupported_media_type", "Content-Type must be application/json") + if req.method == "POST" and path == "/api/v1/auth/sessions" and await req.body(): + raise invalid("Login body is not allowed") + response = await call_next(req) + except APIError as exc: + response = api_error(req, exc) + except (RedisError, psycopg.OperationalError, psycopg.InterfaceError): + response = api_error(req, APIError(503, "unavailable", "Dependency unavailable")) + except Exception: + logger.exception("unexpected request failure id=%s", request_id(req)) + response = api_error(req, APIError(500, "internal_error", "Internal server error")) + response.headers["X-Request-Id"] = request_id(req) + response.headers["X-Instance-Id"] = INSTANCE_ID + return response + + +def api_error(req: Request, exc: APIError) -> JSONResponse: + headers = {"WWW-Authenticate": challenge(req)} if exc.status == 401 else {} + return JSONResponse(status_code=exc.status, content=error_body(req, exc.code, exc.message), headers=headers) + + +@app.exception_handler(APIError) +async def api_error_handler(req: Request, exc: APIError): + return api_error(req, exc) + + +@app.exception_handler(RequestValidationError) +async def validation_error_handler(req: Request, exc: RequestValidationError): + return api_error(req, invalid()) + + +@app.exception_handler(Exception) +async def unexpected_error_handler(req: Request, exc: Exception): + logger.exception("handler failure id=%s", request_id(req)) + if isinstance(exc, (psycopg.OperationalError, psycopg.InterfaceError, RedisError)): + return api_error(req, APIError(503, "unavailable", "Dependency unavailable")) + return api_error(req, APIError(500, "internal_error", "Internal server error")) diff --git a/app/migrate.py b/app/migrate.py new file mode 100644 index 0000000..5f624e3 --- /dev/null +++ b/app/migrate.py @@ -0,0 +1,23 @@ +"""Run once before API instances; transactional and advisory-lock coordinated migrations.""" +import os +from pathlib import Path +import psycopg + +MIGRATIONS = Path(__file__).resolve().parents[1] / "db" / "migrations" + +def main(): + with psycopg.connect(os.environ["DATABASE_URL"], autocommit=False) as conn: + with conn.transaction(): + conn.execute("SELECT pg_advisory_xact_lock(62132103)") + conn.execute("CREATE TABLE IF NOT EXISTS schema_migrations(version TEXT PRIMARY KEY, applied_at TIMESTAMPTZ NOT NULL DEFAULT now())") + for path in sorted(MIGRATIONS.glob("[0-9]*.sql")): + applied = conn.execute("SELECT 1 FROM schema_migrations WHERE version=%s", (path.name,)).fetchone() + if applied: + continue + conn.execute(path.read_text(encoding="utf-8")) + conn.execute("INSERT INTO schema_migrations(version) VALUES (%s)", (path.name,)) + print("Applied", path.name, flush=True) + print("Migrations up to date", flush=True) + +if __name__ == "__main__": + main() diff --git a/app/models.py b/app/models.py new file mode 100644 index 0000000..d0018c5 --- /dev/null +++ b/app/models.py @@ -0,0 +1,77 @@ +"""HTTP request models; all strings use Unicode code point limits.""" +import re +import uuid +from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator + +USERNAME_RE = re.compile(r"^[a-z0-9_]{3,32}$") + +class StrictModel(BaseModel): + model_config = ConfigDict(extra="forbid", strict=True) + +class CreateUser(StrictModel): + username: str + display_name: str = Field(min_length=1, max_length=100) + password: str = Field(min_length=12, max_length=128) + + @field_validator("username") + @classmethod + def username_valid(cls, value: str) -> str: + if not USERNAME_RE.fullmatch(value): + raise ValueError("Invalid username") + return value + + @field_validator("display_name", "password") + @classmethod + def non_blank(cls, value: str) -> str: + if not value.strip(): + raise ValueError("Blank value") + value.encode("utf-8", errors="strict") + return value + +class CreateChat(StrictModel): + title: str = Field(min_length=1, max_length=100) + member_ids: list[str] = Field(min_length=1, max_length=100) + + @field_validator("title") + @classmethod + def non_blank(cls, value: str) -> str: + if not value.strip(): + raise ValueError("Blank title") + value.encode("utf-8", errors="strict") + return value + + @field_validator("member_ids") + @classmethod + def uuid_members(cls, value: list[str]) -> list[str]: + for member in value: + if not isinstance(member, str) or str(uuid.UUID(member)) != member: + raise ValueError("Invalid member UUID") + if len(value) != len(set(value)): + raise ValueError("Duplicate member") + return value + +class CreateMessage(StrictModel): + text: str = Field(min_length=0, max_length=4000) + attachment_ids: list[str] = Field(default_factory=list, max_length=10) + + @field_validator("text") + @classmethod + def non_blank(cls, value: str) -> str: + value.encode("utf-8", errors="strict") + return value + + @field_validator("attachment_ids") + @classmethod + def valid_attachments(cls, value: list[str]) -> list[str]: + if len(value) != len(set(value)): + raise ValueError("Duplicate attachment IDs") + for item in value: + if not isinstance(item, str) or str(uuid.UUID(item)) != item: + raise ValueError("Invalid attachment UUID") + return value + + @model_validator(mode="after") + def nonempty_message(self): + if not self.text.strip() and not self.attachment_ids: + raise ValueError("Empty message") + return self diff --git a/app/pipeline_selftest.py b/app/pipeline_selftest.py new file mode 100644 index 0000000..af559cb --- /dev/null +++ b/app/pipeline_selftest.py @@ -0,0 +1,25 @@ +"""Offline image conversion tests inside the application image; no S3 or DB.""" +import io +from PIL import Image +from .image_worker import transform + + +def main(): + source = Image.new('RGB',(320,200), (255,0,0)) + buf=io.BytesIO();source.save(buf,'PNG') + result=transform(buf.getvalue()) + items={name:(img,fmt,mime,opts) for name,img,fmt,mime,opts in result} + assert set(items)=={'thumbnail','crop','optimized'} + assert items['thumbnail'][0].size==(256,160) + assert items['crop'][0].size==(128,128) + assert items['optimized'][0].size==(320,200) + for name,(im,fmt,mime,opts) in items.items(): + data=io.BytesIO();im.save(data,format=fmt,**opts) + with Image.open(io.BytesIO(data.getvalue())) as decoded: + assert decoded.size==im.size + assert decoded.format==fmt + assert 'exif' not in decoded.info + print('PASS: PNG 320x200 -> JPEG thumb 256x160, crop 128x128, optimized WebP, metadata stripped') + +if __name__=='__main__': + main() diff --git a/app/reconcile.py b/app/reconcile.py new file mode 100644 index 0000000..0f31682 --- /dev/null +++ b/app/reconcile.py @@ -0,0 +1,132 @@ +"""Lab4 grade-5 track 2: repeatable DB/S3 reconciliation. + +Dry-run is default. Apply never drops metadata when BOTH object copies are gone: +without a trustworthy copy or external backup, deletion would destroy evidence. +""" +import argparse +import json +import sys +import time +from datetime import datetime, timezone + +import psycopg +from psycopg.rows import dict_row +from botocore.exceptions import BotoCoreError, ClientError + +from .attachments import BUCKET, s3_client + + +def inventory(client): + result = {} + for page in client.get_paginator("list_objects_v2").paginate(Bucket=BUCKET): + for obj in page.get("Contents", []): + # Only reconciliation-owned prefixes; never mutate arbitrary S3 keys. + key = obj["Key"] + if key.startswith(("attachments/", "recovery/")): + result[key] = obj["LastModified"] + return result + + +def get_db_rows(conn): + return conn.execute("SELECT id, object_key, backup_key, status FROM attachments").fetchall() + + +def current_reference(conn, key): + return conn.execute( + "SELECT 1 FROM attachments WHERE object_key=%s OR backup_key=%s", (key, key) + ).fetchone() is not None + + +def reconcile(*, apply=False, grace_seconds=300, now=None, client=None, connect=None): + if grace_seconds < 300 and apply: + raise ValueError("Apply requires >=300 s grace period to protect in-flight uploads") + started = time.monotonic() + now = now or datetime.now(timezone.utc) + client = client or s3_client() + connect = connect or (lambda: psycopg.connect(__import__('os').environ['DATABASE_URL'], row_factory=dict_row)) + objects = inventory(client) + stats = { + "mode": "apply" if apply else "dry-run", "grace_seconds": grace_seconds, + "s3_keys_scanned": len(objects), "db_rows_scanned": 0, + "orphan_keys": [], "orphan_keys_young": [], + "missing_primary_repairable": [], "missing_backup_repairable": [], + "missing_both_unrecoverable": [], "actions": [], "errors": [], + } + with connect() as conn: + rows = get_db_rows(conn) + stats["db_rows_scanned"] = len(rows) + references = {key for row in rows for key in (row["object_key"], row["backup_key"])} + for row in rows: + if row["status"] != "ready": + continue # queued/processing have durable staging, not final variants yet + primary, backup = row["object_key"], row["backup_key"] + have_primary, have_backup = primary in objects, backup in objects + rid = str(row["id"]) + if have_primary and have_backup: + continue + if not have_primary and not have_backup: + stats["missing_both_unrecoverable"].append(rid) + continue + dest, source, typ = (primary, backup, "missing_primary_repairable") if not have_primary else (backup, primary, "missing_backup_repairable") + stats[typ].append(rid) + if apply: + # Defensive recheck. Object may have reappeared after inventory. + try: + client.head_object(Bucket=BUCKET, Key=dest) + stats["actions"].append({"action": "already-restored", "key": dest}) + continue + except ClientError as exc: + code = exc.response.get("Error", {}).get("Code") + if code not in ("404", "NotFound", "NoSuchKey"): + raise + try: + client.copy_object(Bucket=BUCKET, Key=dest, + CopySource={"Bucket": BUCKET, "Key": source}) + stats["actions"].append({"action": "restore", "key": dest, "from": source}) + except (BotoCoreError, ClientError) as exc: + stats["errors"].append({"action": "restore", "key": dest, "error_type": type(exc).__name__}) + for key, modified in objects.items(): + if key in references: + continue + age = (now - modified).total_seconds() + if age < grace_seconds: + stats["orphan_keys_young"].append(key) + continue + stats["orphan_keys"].append(key) + if apply: + # Query again immediately before destructive action; never delete + # an object now referenced by a committed metadata row. + if current_reference(conn, key): + stats["actions"].append({"action": "skip-now-referenced", "key": key}) + continue + try: + client.delete_object(Bucket=BUCKET, Key=key) + stats["actions"].append({"action": "delete-old-orphan", "key": key}) + except (BotoCoreError, ClientError) as exc: + stats["errors"].append({"action": "delete-old-orphan", "key": key, "error_type": type(exc).__name__}) + stats["scan_elapsed_seconds"] = round(time.monotonic() - started, 3) + return stats + + +def main(): + parser = argparse.ArgumentParser(description="Reconcile S3 attachments vs PostgreSQL (dry-run default)") + parser.add_argument("--apply", action="store_true", help="Make safe changes; orphans older than 300 seconds only") + parser.add_argument("--grace-seconds", type=int, default=300) + parser.add_argument("--output", help="Write JSON summary (no credentials)") + args = parser.parse_args() + try: + result = reconcile(apply=args.apply, grace_seconds=args.grace_seconds) + except Exception as exc: + # No exception string: botocore errors may contain signed credentials/URLs. + print(json.dumps({"status":"failed", "error_type":type(exc).__name__}), file=sys.stderr) + raise SystemExit(2) from None + rendered = json.dumps(result, ensure_ascii=False, indent=2) + print(rendered) + if args.output: + with open(args.output, "w", encoding="utf-8") as fh: + fh.write(rendered + "\n") + if result["errors"] or result["missing_both_unrecoverable"]: + raise SystemExit(1) + +if __name__ == "__main__": + main() diff --git a/app/reconcile_fault.py b/app/reconcile_fault.py new file mode 100644 index 0000000..fce1eea --- /dev/null +++ b/app/reconcile_fault.py @@ -0,0 +1,36 @@ +"""Operator-only fault injection in a LOCAL TEST stack; never exposed as HTTP.""" +import argparse +import json +import os +import uuid +import psycopg +from psycopg.rows import dict_row +from .attachments import BUCKET, s3_client + + +def main(): + p = argparse.ArgumentParser() + p.add_argument("action", choices=["delete-primary", "delete-backup", "create-orphan"]) + p.add_argument("--id", help="Attachment UUID for the delete actions") + args = p.parse_args() + if os.environ.get("LAB4_ALLOW_FAULT_INJECTION") != "yes": + raise SystemExit("Fault injection disabled; use LAB4_ALLOW_FAULT_INJECTION=yes in isolated test") + client = s3_client() + if args.action == "create-orphan": + key = f"attachments/{uuid.uuid4()}/original" + client.put_object(Bucket=BUCKET, Key=key, Body=b"synthetic orphan") + print(json.dumps({"fault":"orphan-created", "object_key":key})) + return + if not args.id: + raise SystemExit("--id is required") + ident = str(uuid.UUID(args.id)) + with psycopg.connect(os.environ["DATABASE_URL"], row_factory=dict_row) as conn: + row = conn.execute("SELECT object_key,backup_key FROM attachments WHERE id=%s", (ident,)).fetchone() + if not row: + raise SystemExit("Attachment does not exist") + key = row["object_key"] if args.action == "delete-primary" else row["backup_key"] + client.delete_object(Bucket=BUCKET, Key=key) + print(json.dumps({"fault":args.action, "object_key":key})) + +if __name__ == "__main__": + main() diff --git a/app/reconcile_selftest.py b/app/reconcile_selftest.py new file mode 100644 index 0000000..e9d2c81 --- /dev/null +++ b/app/reconcile_selftest.py @@ -0,0 +1,61 @@ +"""Fast isolated tests for reconciliation safety; run in application image.""" +import uuid +from datetime import datetime, timezone, timedelta +from .reconcile import reconcile +from .attachments import BUCKET + +NOW = datetime.now(timezone.utc) + +class FakeConn: + def __init__(self, rows): self.rows=rows + def __enter__(self): return self + def __exit__(self,*a): return False + def execute(self, sql, args=None): + self.sql=sql + self.args=args + return self + def fetchall(self): return self.rows + def fetchone(self): + key=self.args[0] + return {'id': 1} if any(key in (row['object_key'],row['backup_key']) for row in self.rows) else None + +class FakeS3: + def __init__(self,objects): self.objects=objects + def get_paginator(self,op): return self + def paginate(self,**kwargs): + yield {'Contents':[{'Key':k,'LastModified':t} for k,t in self.objects.items()]} + def head_object(self,**kw): + if kw['Key'] not in self.objects: + from botocore.exceptions import ClientError + raise ClientError({'Error':{'Code':'404'}},'HeadObject') + def copy_object(self,**kw): + assert kw['CopySource']['Key'] in self.objects + self.objects[kw['Key']]=NOW + def delete_object(self,**kw): + self.objects.pop(kw['Key'],None) + + +def test(): + i=str(uuid.uuid4()) + primary=f'attachments/{i}/original';backup=f'recovery/{i}/original' + young=f'attachments/{uuid.uuid4()}/original' + old=f'attachments/{uuid.uuid4()}/original' + rows=[{'id':i,'object_key':primary,'backup_key':backup,'status':'ready'}] + fake=FakeS3({backup: NOW-timedelta(days=1),young:NOW-timedelta(seconds=10),old:NOW-timedelta(days=1)}) + kwargs={'now':NOW,'client':fake,'connect':lambda:FakeConn(rows)} + first=reconcile(apply=False,**kwargs) + assert first['missing_primary_repairable']==[i] + assert old in first['orphan_keys'] and young in first['orphan_keys_young'] + assert primary not in fake.objects and old in fake.objects, 'Dry run mutated objects' + second=reconcile(apply=True,**kwargs) + assert primary in fake.objects and old not in fake.objects and young in fake.objects + assert any(x['action']=='restore' for x in second['actions']) + third=reconcile(apply=True,**kwargs) + assert not third['actions'], 'Re-run unexpectedly mutated objects' + assert rows[0]['object_key']==primary, 'Metadata destroyed' + try: reconcile(apply=True, grace_seconds=0, **kwargs) + except ValueError: pass + else: raise AssertionError('Unsafe zero-grace apply accepted') + print('PASS: dry-run, orphan grace, recover primary from backup, apply idempotence') + +if __name__ == '__main__': test() diff --git a/app/s3_bootstrap.py b/app/s3_bootstrap.py new file mode 100644 index 0000000..da81f64 --- /dev/null +++ b/app/s3_bootstrap.py @@ -0,0 +1,35 @@ +"""Idempotently create the private S3 bucket with bootstrap-only credentials.""" +import os +import time +import boto3 +from botocore.config import Config +from botocore.exceptions import ClientError, BotoCoreError + + +def main(): + bucket = os.environ["S3_BUCKET"] + client = boto3.client("s3", endpoint_url=os.environ["S3_ENDPOINT"], + aws_access_key_id=os.environ["S3_ADMIN_ACCESS_KEY"], + aws_secret_access_key=os.environ["S3_ADMIN_SECRET_KEY"], + region_name="us-east-1", + config=Config(s3={"addressing_style": "path"}, + connect_timeout=2, read_timeout=4, retries={"max_attempts": 1})) + for attempt in range(70): + try: + try: + client.head_bucket(Bucket=bucket) + except ClientError as exc: + code = exc.response.get("Error", {}).get("Code", "") + if code not in ("404", "NoSuchBucket", "NotFound"): + raise + client.create_bucket(Bucket=bucket) + # PRIVATE: no public bucket policy, ACL or anonymous identity. + print(f"Private bucket {bucket} ready", flush=True) + return + except (ClientError, BotoCoreError, OSError) as exc: + if attempt == 69: + raise RuntimeError("S3 bootstrap failed; inspect S3 container") from exc + time.sleep(1) + +if __name__ == "__main__": + main() diff --git a/app/s3_policy.py b/app/s3_policy.py new file mode 100644 index 0000000..b51dead --- /dev/null +++ b/app/s3_policy.py @@ -0,0 +1,32 @@ +"""One-off creation of private SeaweedFS S3 identities; secrets stay in Docker volume.""" +import json +import os +from pathlib import Path + + +def main(): + bucket = os.environ["S3_BUCKET"] + identities = [ + {"name": "bucket-bootstrap", "credentials": [{"accessKey": os.environ["S3_ADMIN_ACCESS_KEY"], + "secretKey": os.environ["S3_ADMIN_SECRET_KEY"]}], + "actions": ["Admin", "Read", "Write", "List"]}, + {"name": "messenger-api", "credentials": [{"accessKey": os.environ["S3_ACCESS_KEY"], + "secretKey": os.environ["S3_SECRET_KEY"]}], + "actions": [f"Read:{bucket}", f"Write:{bucket}", f"List:{bucket}"]}, + ] + if len({entry["credentials"][0]["accessKey"] for entry in identities}) != 2: + raise ValueError("Admin and API credentials must differ") + path = Path("/s3-config/config.json") + path.parent.mkdir(parents=True, exist_ok=True) + tmp = path.with_suffix(".tmp") + old_umask = os.umask(0o077) + try: + tmp.write_text(json.dumps({"identities": identities}, separators=(",", ":")), encoding="utf-8") + os.chmod(tmp, 0o644) # readable by the SeaweedFS runtime UID; Docker volume stays private + os.replace(tmp, path) + finally: + os.umask(old_umask) + print("S3 identities configured (no secrets printed)", flush=True) + +if __name__ == "__main__": + main() diff --git a/app/s3_probe.py b/app/s3_probe.py new file mode 100644 index 0000000..ef6d441 --- /dev/null +++ b/app/s3_probe.py @@ -0,0 +1,40 @@ +"""Verify bucket is private at S3 boundary (not merely hidden behind HTTP API).""" +import json +import os +import boto3 +from botocore import UNSIGNED +from botocore.config import Config +from botocore.exceptions import ClientError +from .attachments import BUCKET, s3_client + + +def main(): + client = s3_client() + client.head_bucket(Bucket=BUCKET) # restricted app identity works + unauth = boto3.client("s3", endpoint_url=os.environ["S3_ENDPOINT"], + region_name="us-east-1", config=Config(signature_version=UNSIGNED, + s3={"addressing_style":"path"})) + try: + unauth.list_objects_v2(Bucket=BUCKET, MaxKeys=1) + except ClientError as exc: + status = exc.response.get("ResponseMetadata", {}).get("HTTPStatusCode") + if status not in (401,403): + raise RuntimeError("Unexpected anonymous S3 response") from None + else: + raise RuntimeError("Private bucket leaked object list to anonymous caller") + listing = client.list_objects_v2(Bucket=BUCKET, MaxKeys=1) + keys = [entry["Key"] for entry in listing.get("Contents", [])] + if keys: + try: + unauth.get_object(Bucket=BUCKET, Key=keys[0]) + except ClientError as exc: + status = exc.response.get("ResponseMetadata", {}).get("HTTPStatusCode") + if status not in (401, 403): + raise RuntimeError("Unexpected anonymous object GET response") from None + else: + raise RuntimeError("Private S3 object downloadable anonymously") + print(json.dumps({"private_bucket": True, "anonymous_listing": "denied", + "anonymous_object_get": "denied" if keys else "not_tested_empty_bucket"})) + +if __name__ == "__main__": + main() diff --git a/app/storage.py b/app/storage.py new file mode 100644 index 0000000..b776c8d --- /dev/null +++ b/app/storage.py @@ -0,0 +1,67 @@ +"""Shared external state: psycopg connection pool and Redis session store.""" +import os +from contextlib import contextmanager + +import psycopg +from psycopg.rows import dict_row +from psycopg_pool import ConnectionPool, PoolTimeout +from redis import Redis +from redis.exceptions import RedisError + +from .core import APIError +from . import telemetry as ot +from opentelemetry.trace import SpanKind + +pool: ConnectionPool | None = None +redis_client: Redis | None = None + + +def start() -> None: + global pool, redis_client + url = os.environ["DATABASE_URL"] + size = int(os.getenv("DB_POOL_MAX", "8")) + pool = ConnectionPool(conninfo=url, min_size=1, max_size=size, timeout=3, kwargs={"row_factory": dict_row, "connect_timeout": 5, "options": "-c statement_timeout=5000"}, open=False) + pool.open(wait=True, timeout=30) + redis_client = Redis.from_url(os.environ.get("REDIS_URL", "redis://redis:6379/0"), socket_connect_timeout=2, socket_timeout=2, decode_responses=True) + redis_client.ping() + + +def stop() -> None: + global pool, redis_client + if pool is not None: + pool.close() + pool = None + if redis_client is not None: + redis_client.close() + redis_client = None + + +@contextmanager +def db(): + if pool is None: + raise APIError(503, "unavailable", "Database unavailable") + try: + with ot.dependency_span("db.transaction", kind=SpanKind.CLIENT, attrs={"db.system.name":"postgresql"}): + with pool.connection() as conn: + yield conn + except (psycopg.OperationalError, psycopg.InterfaceError, psycopg.errors.QueryCanceled, PoolTimeout) as exc: + raise APIError(503, "unavailable", "Database unavailable") from exc + + +def cache() -> Redis: + if redis_client is None: + raise APIError(503, "unavailable", "Session store unavailable") + return redis_client + + +def ready() -> bool: + try: + with db() as conn: + conn.execute("SELECT 1").fetchone() + cache().ping() + # S3 is needed for the mandatory synchronous upload/download path. + from .attachments import s3_client, BUCKET + s3_client().head_bucket(Bucket=BUCKET) + return True + except Exception: + return False diff --git a/app/telemetry.py b/app/telemetry.py new file mode 100644 index 0000000..df2c06c --- /dev/null +++ b/app/telemetry.py @@ -0,0 +1,204 @@ +"""Explicit, allowlisted OTLP instrumentation; no automatic headers, SQL or bodies. +SDK exporters run asynchronously with bounded queues; telemetry is best effort. +""" +import logging +import os +import socket +import time +from contextlib import contextmanager, nullcontext +from pathlib import Path + +from opentelemetry import metrics, trace +from opentelemetry.trace import SpanKind, Status, StatusCode +from opentelemetry.trace.propagation.tracecontext import TraceContextTextMapPropagator +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.metrics.view import View, ExplicitBucketHistogramAggregation +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 + +PROP = TraceContextTextMapPropagator() +tracer = trace.get_tracer('messenger.lab6') +log = logging.getLogger('messenger.telemetry') +log.setLevel(logging.INFO) +log.propagate = False +providers = [] +started = False +m = None +instruments = {} +worker_busy = 0 +backlog_depth = None +backlog_age = None +broker_ready = None +broker_consumers = None +QUEUE = 'attachment-processing.v1' +BUCKETS = (0.005, .01, .025, .05, .1, .25, .5, 1, 2, 3, 5, 10, 15, 30, 60, 120, 300, 600) + + +def init(role, *, child=False): + global started, tracer, m + if started or os.getenv('OTEL_ENABLED', 'no') != 'yes': + return + started = True + resource = Resource.create({'service.name': 'messenger-' + role, + 'service.version': '1.6.0', 'service.instance.id': os.getenv('API_INSTANCE_ID', socket.gethostname()), + 'deployment.environment.name': 'lab'}) + base = os.getenv('OTEL_EXPORTER_OTLP_ENDPOINT', 'http://otel-collector:4318').rstrip('/') + tp = TracerProvider(resource=resource) + tp.add_span_processor(BatchSpanProcessor(OTLPSpanExporter(endpoint=base+'/v1/traces', timeout=2), + max_queue_size=512, max_export_batch_size=64, schedule_delay_millis=500, export_timeout_millis=2000)) + trace.set_tracer_provider(tp) + tracer = tp.get_tracer('messenger.lab6') + lp = LoggerProvider(resource=resource) + lp.add_log_record_processor(BatchLogRecordProcessor(OTLPLogExporter(endpoint=base+'/v1/logs', timeout=2), + max_queue_size=512, max_export_batch_size=64, schedule_delay_millis=500, export_timeout_millis=2000)) + log.addHandler(LoggingHandler(logger_provider=lp)) + providers.extend([tp, lp]) + if child: + return + reader = PeriodicExportingMetricReader(OTLPMetricExporter(endpoint=base+'/v1/metrics', timeout=2), + export_interval_millis=3000, export_timeout_millis=2000) + mp = MeterProvider(resource=resource, metric_readers=[reader], views=[View(instrument_name=n, + aggregation=ExplicitBucketHistogramAggregation(boundaries=BUCKETS)) for n in + ('lab_http_duration','lab_job_duration','lab_ready_duration')]) + metrics.set_meter_provider(mp) + providers.append(mp) + m = mp.get_meter('messenger.lab6') + for name in ('lab_http_requests','lab_jobs','lab_job_retries'): + instruments[name] = m.create_counter(name) + for name in ('lab_http_duration','lab_job_duration','lab_ready_duration'): + instruments[name] = m.create_histogram(name, unit='s') + if role == 'api': + for name, key in [('lab_db_pool_used','used'),('lab_db_pool_waiting','requests_waiting'),('lab_db_pool_capacity','pool_max')]: + m.create_observable_gauge(name, callbacks=[lambda _, key=key: pool_stats(key)]) + if role == 'worker': + m.create_observable_gauge('lab_worker_busy', callbacks=[lambda _: [metrics.Observation(worker_busy)]]) + m.create_observable_gauge('lab_worker_capacity', callbacks=[lambda _: [metrics.Observation(1)]]) + if role == 'dispatcher': + m.create_observable_gauge('lab_broker_ready', callbacks=[lambda _: queue_observation(broker_ready)]) + m.create_observable_gauge('lab_broker_consumers', callbacks=[lambda _: queue_observation(broker_consumers)]) + m.create_observable_gauge('lab_queue_depth', callbacks=[lambda _: queue_observation(backlog_depth)]) + m.create_observable_gauge('lab_queue_oldest_age', unit='s', callbacks=[lambda _: queue_observation(backlog_age)]) + m.create_observable_gauge('lab_container_memory', unit='By', callbacks=[lambda _: container_observation('memory')]) + m.create_observable_gauge('lab_container_cpu_cores', callbacks=[lambda _: container_observation('cpu')]) + + +def pool_stats(key): + from . import storage + if storage.pool is None: + return [] + stats = storage.pool.get_stats() + val = stats.get('pool_size',0)-stats.get('pool_available',0) if key=='used' else stats.get(key,0) + return [metrics.Observation(max(0,val))] + + +def queue_observation(value): + return [] if value is None else [metrics.Observation(value, {'queue': QUEUE})] + + +_cpu_previous = None + +def container_observation(kind): + global _cpu_previous + try: + if kind == 'memory': + return [metrics.Observation(int(Path('/sys/fs/cgroup/memory.current').read_text()))] + cpu = int(dict(line.split() for line in Path('/sys/fs/cgroup/cpu.stat').read_text().splitlines())['usage_usec']) / 1e6 + now = time.monotonic() + old = _cpu_previous + _cpu_previous = (now,cpu) + return [] if old is None else [metrics.Observation(max(0,(cpu-old[1])/(now-old[0])))] + except (OSError, KeyError, ValueError): + # cgroup v1 fallback, process tree (not full container accounting). + import psutil + try: + p = psutil.Process() + processes = [p]+p.children(recursive=True) + if kind == 'memory': + value = 0 + for proc in processes: + try: value += proc.memory_info().rss + except psutil.Error: pass + return [metrics.Observation(value)] + # cgroup v1 (Docker Linux) if available, CPU usage in nanoseconds. + for path in ('/sys/fs/cgroup/cpuacct/cpuacct.usage','/sys/fs/cgroup/cpu,cpuacct/cpuacct.usage'): + if Path(path).is_file(): + cpu = int(Path(path).read_text()) / 1e9 + now = time.monotonic() + old = _cpu_previous + _cpu_previous = (now,cpu) + return [] if old is None else [metrics.Observation(max(0,(cpu-old[1])/(now-old[0])))] + except (psutil.Error,OSError,ValueError): + pass + return [] + + +def count(name, attrs=None): + if name in instruments: instruments[name].add(1, attrs or {}) + + +def observe(name, value, attrs=None): + if name in instruments: instruments[name].record(max(0,value), attrs or {}) + + +def event(name, *, level=logging.INFO, **attrs): + # Callers pass fixed event names and technical ID/status only, never payloads. + if started: + log.log(level, name, extra={'event':name, **attrs}) + + +@contextmanager +def span(name, *, kind=SpanKind.INTERNAL, context=None, attrs=None): + with tracer.start_as_current_span(name, kind=kind, context=context, attributes=attrs, + record_exception=False, set_status_on_exception=False) as s: + try: + yield s + except BaseException as exc: + s.set_status(Status(StatusCode.ERROR)) + s.set_attribute('error.type', type(exc).__name__) + event('operation.error', level=logging.ERROR, operation=name, error_type=type(exc).__name__) + raise + + +def inject(): + result = {} + PROP.inject(result) + return result + + +def extract(carrier): + # Ignore baggage and all unrelated fields. + return PROP.extract({k:v for k,v in carrier.items() if k in ('traceparent','tracestate') and isinstance(v,str)}) + + +def dependency_span(name, **kwargs): + return span(name, **kwargs) if trace_id() else nullcontext() + + +def trace_id(): + ctx = trace.get_current_span().get_span_context() + return f'{ctx.trace_id:032x}' if ctx.is_valid else '' + + +def flush(): + for p in providers: + p.force_flush(timeout_millis=2500) + + +class S3Tracing: + """Only operation name is exported; bucket/key/bytes/signed URLs never exported.""" + def __init__(self, client): self.client = client + def __getattr__(self, name): + f = getattr(self.client,name) + if name not in ('upload_fileobj','get_object','put_object','copy_object','delete_object','head_object','head_bucket'): + return f + def call(*a, **kw): + with dependency_span('s3.'+name, kind=SpanKind.CLIENT, attrs={'storage.system':'s3'}): + return f(*a, **kw) + return call diff --git a/compose.yaml b/compose.yaml new file mode 100644 index 0000000..3245e2d --- /dev/null +++ b/compose.yaml @@ -0,0 +1,347 @@ +services: + postgres: + image: postgres:16.10-bookworm + environment: + POSTGRES_DB: ${POSTGRES_DB:-messenger} + POSTGRES_USER: ${POSTGRES_USER:-lab} + POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?Set POSTGRES_PASSWORD in .env} + volumes: ["postgres_data:/var/lib/postgresql/data"] + healthcheck: + test: ["CMD-SHELL", "pg_isready -U $$POSTGRES_USER -d $$POSTGRES_DB"] + interval: 2s + timeout: 2s + retries: 30 + mem_limit: 512m + cpus: 1.0 + restart: unless-stopped + networks: [storage] + + redis: + image: redis:7.4.5-alpine + command: ["redis-server", "--appendonly", "yes", "--appendfsync", "always", "--save", "60", "1"] + volumes: ["redis_data:/data"] + healthcheck: + test: ["CMD", "redis-cli", "ping"] + interval: 2s + timeout: 2s + retries: 30 + mem_limit: 256m + cpus: 0.5 + restart: unless-stopped + networks: [storage] + + broker: + image: rabbitmq:4.1.8-management-alpine + hostname: lab6-broker + environment: + RABBITMQ_DEFAULT_USER: ${BROKER_USER:-labworker} + RABBITMQ_DEFAULT_PASS: ${BROKER_PASSWORD:?Set BROKER_PASSWORD in .env} + volumes: ["rabbitmq_data:/var/lib/rabbitmq"] + healthcheck: + test: ["CMD", "rabbitmq-diagnostics", "-q", "ping"] + interval: 5s + timeout: 5s + retries: 25 + start_period: 15s + mem_limit: 512m + cpus: 0.75 + restart: unless-stopped + networks: [storage] + + s3-policy: + build: . + user: "0:0" + command: ["python", "-m", "app.s3_policy"] + environment: + S3_BUCKET: ${S3_BUCKET:-messenger-attachments} + S3_ADMIN_ACCESS_KEY: ${S3_ADMIN_ACCESS_KEY:?Set S3_ADMIN_ACCESS_KEY} + S3_ADMIN_SECRET_KEY: ${S3_ADMIN_SECRET_KEY:?Set S3_ADMIN_SECRET_KEY} + S3_ACCESS_KEY: ${S3_ACCESS_KEY:?Set S3_ACCESS_KEY} + S3_SECRET_KEY: ${S3_SECRET_KEY:?Set S3_SECRET_KEY} + volumes: ["s3_config:/s3-config"] + restart: "no" + networks: [storage] + + s3: + image: chrislusf/seaweedfs:4.53 + command: ["server", "-dir=/data", "-ip=s3", "-ip.bind=0.0.0.0", "-s3", "-s3.port=8333", "-s3.iam=false", "-s3.config=/s3-config/config.json"] + volumes: + - s3_data:/data + - s3_config:/s3-config:ro + - ./infra/filer.toml:/etc/seaweedfs/filer.toml:ro + depends_on: + s3-policy: + condition: service_completed_successfully + expose: ["8333"] + mem_limit: 640m + cpus: 1.0 + restart: unless-stopped + networks: [storage] + + s3-bootstrap: + build: . + command: ["python", "-m", "app.s3_bootstrap"] + environment: + S3_ENDPOINT: http://s3:8333 + S3_BUCKET: ${S3_BUCKET:-messenger-attachments} + S3_ADMIN_ACCESS_KEY: ${S3_ADMIN_ACCESS_KEY:?Set S3_ADMIN_ACCESS_KEY} + S3_ADMIN_SECRET_KEY: ${S3_ADMIN_SECRET_KEY:?Set S3_ADMIN_SECRET_KEY} + depends_on: + s3: + condition: service_started + restart: "no" + networks: [storage] + + migrate: + build: . + command: ["python", "-m", "app.migrate"] + environment: + DATABASE_URL: postgresql://${POSTGRES_USER:-lab}:${POSTGRES_PASSWORD:?Set POSTGRES_PASSWORD in .env}@postgres:5432/${POSTGRES_DB:-messenger} + depends_on: + postgres: + condition: service_healthy + restart: "no" + networks: [storage] + + reconcile: + profiles: [maintenance] + build: . + command: ["python", "-m", "app.reconcile"] + environment: + DATABASE_URL: postgresql://${POSTGRES_USER:-lab}:${POSTGRES_PASSWORD:?Set POSTGRES_PASSWORD in .env}@postgres:5432/${POSTGRES_DB:-messenger} + S3_ENDPOINT: http://s3:8333 + S3_BUCKET: ${S3_BUCKET:-messenger-attachments} + S3_ACCESS_KEY: ${S3_ACCESS_KEY:?Set S3_ACCESS_KEY} + S3_SECRET_KEY: ${S3_SECRET_KEY:?Set S3_SECRET_KEY} + depends_on: + postgres: + condition: service_healthy + s3-bootstrap: + condition: service_completed_successfully + migrate: + condition: service_completed_successfully + restart: "no" + networks: [storage] + + dispatcher: + build: . + command: ["python", "-m", "app.jobs", "dispatch"] + environment: &job_env + OTEL_ENABLED: ${OTEL_ENABLED:-yes} + OTEL_EXPORTER_OTLP_ENDPOINT: http://otel-collector:4318 + DATABASE_URL: postgresql://${POSTGRES_USER:-lab}:${POSTGRES_PASSWORD:?Set POSTGRES_PASSWORD in .env}@postgres:5432/${POSTGRES_DB:-messenger} + BROKER_HOST: broker + BROKER_USER: ${BROKER_USER:-labworker} + BROKER_PASSWORD: ${BROKER_PASSWORD:?Set BROKER_PASSWORD in .env} + S3_ENDPOINT: http://s3:8333 + S3_BUCKET: ${S3_BUCKET:-messenger-attachments} + S3_ACCESS_KEY: ${S3_ACCESS_KEY:?Set S3_ACCESS_KEY} + S3_SECRET_KEY: ${S3_SECRET_KEY:?Set S3_SECRET_KEY} + JOB_TIMEOUT_SECONDS: ${JOB_TIMEOUT_SECONDS:-60} + JOB_MAX_ATTEMPTS: ${JOB_MAX_ATTEMPTS:-5} + depends_on: + broker: + condition: service_healthy + migrate: + condition: service_completed_successfully + s3-bootstrap: + condition: service_completed_successfully + mem_limit: 192m + cpus: 0.5 + restart: unless-stopped + networks: [storage, telemetry] + + worker: + build: . + command: ["python", "-m", "app.jobs", "worker"] + environment: + <<: *job_env + LAB6_FAULT_RETRY_ONCE: ${LAB6_FAULT_RETRY_ONCE:-off} + WORKER_PREFETCH: ${WORKER_PREFETCH:-1} + LAB5_FAULT_AFTER_S3: ${LAB5_FAULT_AFTER_S3:-off} + depends_on: + broker: + condition: service_healthy + migrate: + condition: service_completed_successfully + s3-bootstrap: + condition: service_completed_successfully + mem_limit: 768m + cpus: 1.0 + stop_grace_period: 75s + restart: unless-stopped + networks: [storage, telemetry] + + api1: + build: . + environment: &api_env + OTEL_ENABLED: ${OTEL_ENABLED:-yes} + OTEL_EXPORTER_OTLP_ENDPOINT: http://otel-collector:4318 + APP_PORT: "8080" + API_INSTANCE_ID: api1 + DATABASE_URL: postgresql://${POSTGRES_USER:-lab}:${POSTGRES_PASSWORD:?Set POSTGRES_PASSWORD in .env}@postgres:5432/${POSTGRES_DB:-messenger} + REDIS_URL: redis://redis:6379/0 + SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-3600} + IDEMPOTENCY_TTL_SECONDS: ${IDEMPOTENCY_TTL_SECONDS:-86400} + DB_POOL_MAX: ${DB_POOL_MAX:-8} + JOB_BACKLOG_LIMIT: ${JOB_BACKLOG_LIMIT:-1000} + S3_ENDPOINT: http://s3:8333 + S3_BUCKET: ${S3_BUCKET:-messenger-attachments} + S3_ACCESS_KEY: ${S3_ACCESS_KEY:?Set S3_ACCESS_KEY} + S3_SECRET_KEY: ${S3_SECRET_KEY:?Set S3_SECRET_KEY} + depends_on: &api_depends + postgres: + condition: service_healthy + redis: + condition: service_healthy + migrate: + condition: service_completed_successfully + s3-bootstrap: + condition: service_completed_successfully + expose: ["8080"] + healthcheck: &api_health + test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8080/health/ready', timeout=2)"] + interval: 2s + timeout: 3s + retries: 15 + start_period: 10s + mem_limit: 384m + cpus: 0.75 + stop_grace_period: 12s + restart: unless-stopped + networks: [frontend, storage, telemetry] + + api2: + build: . + environment: + <<: *api_env + API_INSTANCE_ID: api2 + depends_on: *api_depends + expose: ["8080"] + healthcheck: *api_health + mem_limit: 384m + cpus: 0.75 + stop_grace_period: 12s + restart: unless-stopped + networks: [frontend, storage, telemetry] + + lb: + image: haproxy:3.1.7-alpine + volumes: ["./infra/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro"] + ports: ["127.0.0.1:8080:8080"] + depends_on: + api1: + condition: service_healthy + api2: + condition: service_healthy + healthcheck: + test: ["CMD", "haproxy", "-c", "-f", "/usr/local/etc/haproxy/haproxy.cfg"] + interval: 10s + timeout: 3s + retries: 3 + mem_limit: 128m + cpus: 0.5 + restart: unless-stopped + networks: [frontend] + + telemetry-init: + image: busybox:1.37.0 + user: "0:0" + command: ["sh", "-ec", "chown 10001:10001 /tempo /loki; chown 65534:65534 /prometheus; chown 472:472 /grafana"] + volumes: + - tempo_data:/tempo + - loki_data:/loki + - prometheus_data:/prometheus + - grafana_data:/grafana + network_mode: none + restart: "no" + + otel-collector: + image: otel/opentelemetry-collector-contrib:0.123.0 + command: ["--config=/etc/otelcol/config.yaml"] + volumes: ["./infra/otel/collector.yaml:/etc/otelcol/config.yaml:ro"] + environment: + GOMEMLIMIT: 180MiB + mem_limit: 256m + cpus: 0.75 + restart: unless-stopped + networks: [telemetry] + + prometheus: + depends_on: + telemetry-init: + condition: service_completed_successfully + image: prom/prometheus:v3.2.1 + command: ["--config.file=/etc/prometheus/prometheus.yml", "--storage.tsdb.path=/prometheus", "--storage.tsdb.retention.time=72h", "--storage.tsdb.retention.size=512MB"] + 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"] + mem_limit: 384m + restart: unless-stopped + networks: [telemetry] + + loki: + depends_on: + telemetry-init: + condition: service_completed_successfully + image: grafana/loki:3.4.2 + command: ["-config.file=/etc/loki/local-config.yaml"] + volumes: + - ./infra/otel/loki.yaml:/etc/loki/local-config.yaml:ro + - loki_data:/loki + ports: ["127.0.0.1:3100:3100"] + mem_limit: 512m + restart: unless-stopped + networks: [telemetry] + + tempo: + depends_on: + telemetry-init: + condition: service_completed_successfully + image: grafana/tempo:2.7.2 + command: ["-config.file=/etc/tempo.yaml"] + volumes: + - ./infra/otel/tempo.yaml:/etc/tempo.yaml:ro + - tempo_data:/var/tempo + ports: ["127.0.0.1:3200:3200"] + mem_limit: 512m + restart: unless-stopped + networks: [telemetry] + + grafana: + depends_on: + telemetry-init: + condition: service_completed_successfully + image: grafana/grafana:11.6.0 + environment: + GF_SECURITY_ADMIN_USER: admin + GF_SECURITY_ADMIN_PASSWORD: ${GRAFANA_ADMIN_PASSWORD:?Set GRAFANA_ADMIN_PASSWORD in .env} + GF_USERS_ALLOW_SIGN_UP: "false" + GF_AUTH_ANONYMOUS_ENABLED: "false" + GF_ANALYTICS_REPORTING_ENABLED: "false" + volumes: + - grafana_data:/var/lib/grafana + - ./infra/otel/grafana/provisioning:/etc/grafana/provisioning:ro + - ./infra/otel/grafana/dashboards:/var/lib/grafana/dashboards:ro + ports: ["127.0.0.1:3000:3000"] + mem_limit: 384m + restart: unless-stopped + networks: [telemetry] + +networks: + telemetry: + frontend: + storage: + internal: true +volumes: + postgres_data: + redis_data: + s3_data: + s3_config: + rabbitmq_data: + prometheus_data: + loki_data: + tempo_data: + grafana_data: diff --git a/db/migrations/001_initial.sql b/db/migrations/001_initial.sql new file mode 100644 index 0000000..203b012 --- /dev/null +++ b/db/migrations/001_initial.sql @@ -0,0 +1,33 @@ +CREATE TABLE IF NOT EXISTS users ( + id UUID PRIMARY KEY, + username VARCHAR(32) NOT NULL UNIQUE, + display_name BYTEA NOT NULL, + password_hash TEXT NOT NULL, + created_at TIMESTAMPTZ NOT NULL DEFAULT clock_timestamp(), + CONSTRAINT users_display_bytes CHECK (octet_length(display_name) BETWEEN 1 AND 400) +); +CREATE TABLE IF NOT EXISTS chats ( + id UUID PRIMARY KEY, + title BYTEA NOT NULL, + created_at TIMESTAMPTZ NOT NULL DEFAULT clock_timestamp(), + CONSTRAINT chats_title_bytes CHECK (octet_length(title) BETWEEN 1 AND 400) +); +CREATE TABLE IF NOT EXISTS chat_members ( + chat_id UUID NOT NULL REFERENCES chats(id), + user_id UUID NOT NULL REFERENCES users(id), + position INTEGER NOT NULL, + PRIMARY KEY (chat_id, user_id), + UNIQUE (chat_id, position) +); +CREATE INDEX IF NOT EXISTS idx_members_user ON chat_members (user_id, chat_id); +CREATE TABLE IF NOT EXISTS messages ( + id UUID PRIMARY KEY, + chat_id UUID NOT NULL REFERENCES chats(id), + sender_id UUID NOT NULL, + text BYTEA NOT NULL, + created_at TIMESTAMPTZ NOT NULL DEFAULT clock_timestamp(), + FOREIGN KEY (chat_id, sender_id) REFERENCES chat_members(chat_id, user_id), + CONSTRAINT messages_text_bytes CHECK (octet_length(text) BETWEEN 1 AND 16000) +); +CREATE INDEX IF NOT EXISTS idx_messages_chat_history ON messages (chat_id, created_at, id); +CREATE INDEX IF NOT EXISTS idx_chats_history ON chats (created_at, id); diff --git a/db/migrations/002_idempotency.sql b/db/migrations/002_idempotency.sql new file mode 100644 index 0000000..04a000a --- /dev/null +++ b/db/migrations/002_idempotency.sql @@ -0,0 +1,12 @@ +-- Same transaction creates message and idempotency receipt. Unique key arbitrates concurrent replicas. +CREATE TABLE IF NOT EXISTS message_idempotency ( + actor_id UUID NOT NULL REFERENCES users(id), + chat_id UUID NOT NULL REFERENCES chats(id), + method VARCHAR(8) NOT NULL DEFAULT 'POST', + idem_key VARCHAR(128) NOT NULL, + body_sha256 CHAR(64) NOT NULL, + message_id UUID NOT NULL REFERENCES messages(id), + created_at TIMESTAMPTZ NOT NULL DEFAULT clock_timestamp(), + PRIMARY KEY (actor_id, chat_id, method, idem_key) +); +CREATE INDEX IF NOT EXISTS idx_idempotency_age ON message_idempotency (created_at); diff --git a/db/migrations/003_attachments.sql b/db/migrations/003_attachments.sql new file mode 100644 index 0000000..ed8e0ea --- /dev/null +++ b/db/migrations/003_attachments.sql @@ -0,0 +1,25 @@ +ALTER TABLE messages DROP CONSTRAINT IF EXISTS messages_text_bytes; +ALTER TABLE messages ADD CONSTRAINT messages_text_bytes CHECK (octet_length(text) BETWEEN 0 AND 16000); +CREATE TABLE IF NOT EXISTS attachments ( + id UUID PRIMARY KEY, + chat_id UUID NOT NULL REFERENCES chats(id), + owner_id UUID NOT NULL REFERENCES users(id), + object_key TEXT NOT NULL UNIQUE, + backup_key TEXT NOT NULL UNIQUE, + filename TEXT NOT NULL, + content_type VARCHAR(32) NOT NULL CHECK(content_type IN ('image/png','image/jpeg')), + size_bytes BIGINT NOT NULL CHECK(size_bytes BETWEEN 1 AND 10485760), + sha256 CHAR(64) NOT NULL, + created_at TIMESTAMPTZ NOT NULL DEFAULT clock_timestamp(), + updated_at TIMESTAMPTZ NOT NULL DEFAULT clock_timestamp(), + FOREIGN KEY (chat_id,owner_id) REFERENCES chat_members(chat_id,user_id) +); +CREATE INDEX IF NOT EXISTS idx_attachments_chat ON attachments(chat_id); +CREATE TABLE IF NOT EXISTS message_attachments ( + message_id UUID NOT NULL REFERENCES messages(id), + attachment_id UUID NOT NULL REFERENCES attachments(id), + position INTEGER NOT NULL CHECK(position BETWEEN 0 AND 9), + PRIMARY KEY (message_id, attachment_id), + UNIQUE (message_id,position) +); +CREATE INDEX IF NOT EXISTS idx_message_attachments_attachment ON message_attachments(attachment_id); diff --git a/db/migrations/004_jobs.sql b/db/migrations/004_jobs.sql new file mode 100644 index 0000000..b709992 --- /dev/null +++ b/db/migrations/004_jobs.sql @@ -0,0 +1,58 @@ +-- Lab5: stage durably, then transact job and outbox atomically. +ALTER TABLE attachments ADD COLUMN IF NOT EXISTS status TEXT NOT NULL DEFAULT 'ready' + CHECK (status IN ('queued','processing','ready','failed')); +ALTER TABLE attachments ADD COLUMN IF NOT EXISTS error_code TEXT; +ALTER TABLE attachments ADD COLUMN IF NOT EXISTS staging_key TEXT; +ALTER TABLE attachments ADD COLUMN IF NOT EXISTS pipeline_version INTEGER NOT NULL DEFAULT 1; +CREATE UNIQUE INDEX IF NOT EXISTS idx_attachments_staging ON attachments(staging_key) WHERE staging_key IS NOT NULL; +CREATE INDEX IF NOT EXISTS idx_attachments_status ON attachments(status); + +CREATE TABLE IF NOT EXISTS attachment_variants ( + attachment_id UUID NOT NULL REFERENCES attachments(id), + pipeline_version INTEGER NOT NULL CHECK (pipeline_version >= 1), + name TEXT NOT NULL CHECK (name IN ('thumbnail','crop','optimized')), + object_key TEXT NOT NULL UNIQUE, + content_type TEXT NOT NULL, + size_bytes BIGINT NOT NULL CHECK (size_bytes > 0), + sha256 CHAR(64) NOT NULL, + width INTEGER NOT NULL CHECK (width > 0), + height INTEGER NOT NULL CHECK (height > 0), + PRIMARY KEY (attachment_id,pipeline_version,name) +); + +CREATE TABLE IF NOT EXISTS processing_jobs ( + id UUID PRIMARY KEY, + attachment_id UUID NOT NULL UNIQUE REFERENCES attachments(id), + pipeline_version INTEGER NOT NULL DEFAULT 1, + status TEXT NOT NULL DEFAULT 'queued' CHECK (status IN ('queued','processing','ready','failed')), + attempt INTEGER NOT NULL DEFAULT 1 CHECK (attempt >= 1), + next_run_at TIMESTAMPTZ NOT NULL DEFAULT now(), + lease_token UUID, + leased_until TIMESTAMPTZ, + error_code TEXT, + created_at TIMESTAMPTZ NOT NULL DEFAULT now(), + updated_at TIMESTAMPTZ NOT NULL DEFAULT now() +); +CREATE INDEX IF NOT EXISTS idx_jobs_leases ON processing_jobs(status, leased_until); + +CREATE TABLE IF NOT EXISTS job_outbox ( + id UUID PRIMARY KEY, + job_id UUID NOT NULL REFERENCES processing_jobs(id), + payload JSONB NOT NULL, + available_at TIMESTAMPTZ NOT NULL DEFAULT now(), + published_at TIMESTAMPTZ, + created_at TIMESTAMPTZ NOT NULL DEFAULT now() +); +CREATE INDEX IF NOT EXISTS idx_outbox_due ON job_outbox(available_at, created_at) WHERE published_at IS NULL; + +CREATE TABLE IF NOT EXISTS job_replay_audit ( + id UUID PRIMARY KEY, + job_id UUID NOT NULL REFERENCES processing_jobs(id), + replayed_at TIMESTAMPTZ NOT NULL DEFAULT now(), + action TEXT NOT NULL DEFAULT 'operator_replay' +); +CREATE TABLE IF NOT EXISTS job_fault_once ( + job_id UUID NOT NULL REFERENCES processing_jobs(id), + fault TEXT NOT NULL, + PRIMARY KEY (job_id,fault) +); diff --git a/evidence/attachments-concurrent.json b/evidence/attachments-concurrent.json new file mode 100644 index 0000000..d77b03d --- /dev/null +++ b/evidence/attachments-concurrent.json @@ -0,0 +1,13 @@ +{ + "concurrency": 10, + "accepted_uploads": 10, + "ready_attachments": 10, + "failed_requests": 0, + "acceptance_elapsed_seconds": 2.515, + "acceptance_rps": 3.976, + "upload_latency_p50_ms": 2296.5, + "upload_latency_max_ms": 2484.0, + "all_ready_elapsed_seconds": 36.406, + "bytes_per_file": 111817, + "note": "HTTP 202 = queued; readiness checked for all uploads. Capture API peak RSS separately via docker stats." +} \ No newline at end of file diff --git a/evidence/grafana/01-api-and-jobs.png b/evidence/grafana/01-api-and-jobs.png new file mode 100644 index 0000000000000000000000000000000000000000..ed332d9e4efc1c04ab47bb8cae388c1013dcb042 GIT binary patch literal 115639 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

d3yIO3m&vcqo4gACep{wQ7T@`H3n{259 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 literal 0 HcmV?d00001 diff --git a/evidence/grafana/02-worker-and-queue.png b/evidence/grafana/02-worker-and-queue.png new file mode 100644 index 0000000000000000000000000000000000000000..cd6ab24d263c502ad2dcffc9213cef6c581748d6 GIT binary patch literal 81200 zcmce;1zc3^_BISEDj;A1A_&qT4N8Xr(jXvR($X;0kfSI9(hQx72uk-b3?VrTsUSUc ziF6Ike0u<&^E~Ig|MR}z?~DCY2V~#-u63_fc%+TE zzxYVUFXni7*w6CPkDh~#mPS2&p3e?p*Sqs{S>7%Y>c6_`PJiLqBZ5Z;?=vn3P55is zarMX9luOZljgX;hrYP6S&sXTnc^RdwrH1}|@80F0C48nwcbUwMt&WcPU#QF;vpM7RPdBq%6IPL4lONti}Wr^AwTZtgZB z;wmkzios)s=4P47(J;mLxO;-iq_uLx`t!}$TDw2xr4N2`Nu`0am`Mz>t!)B6n{00`tX?vcG?Q}?*%SqxXfP- znO?G^PR4ZF@{!_Mmr;0gPSQUrl*MRB1B(@Lx8vc~M$+t)+^6PjXw(vut&8Ani=;?& zcswwghYAV`ELPpLW}Daa%HOw8SY}sOcMQ6Dy)3xValwo4NN=Vyp3if=ChwwtP`+E zR8&4nH|uffsJ(aRUjO>Wj5Vk2cacO^BU)8aUCx71M^6!$pOps5WG!WuvxySLs?s4> zAvI!_le%*Ymc{=aUxdS9x{IWD6kw@ zxkDrD^r|7_+?46GoQlJf_%hce3~#^R4p(~N{w>&uJ^Eyty4Tp`S8l{{=$0N`l^zUU z9!$RSWL&eRr&wmNxOpdQ_1Tm8R;3=sr9lNu>0B98CH~Uj9e3>NeRp{Q9b`d`%G%8$ z7ni$+Z-)p&ip*RFi>VP^(ZnmBP>;F1iCOP=KW#~VPBQ~LY4x5f!*az7ozAvIaSl}A z)IQAtw(25EtNbx|<8WzGZIEHy)45*eaf`L==HYt9U zw*JeHaw&n`k_#U~dD3&nC6lPqZ$!ET3`_fbVD{I~>FB`E%yOR#R36{NpoJpf3^|#Z z2_lYl^>bX*^2*CfPsiU4nBs=@aqjJ`!rk{H*op+cRFi?jYf8SKvf$nKjr?3MI3r4h zzl)@jBIfxfS14_4E?I)c6;=5;hfwe0pKc&$AB+g|Q@QoNzpxd z&Vj{uEB;=HpJX27wUv8ncj_m8`LFv)@pOIxB%v>cse3E$iiUVR#lDZX_3&QsRiYb; zRVrDv%`qiTks*{~clJeyb2qGt|J%{sXs9E1ps9BdaE}PdHv|fVo$1 zs$v4`rcmVD7yD2%aZ<`AFScm4#tzOAc%YF@E9=L;5aEb;?YvxVv0_V3*qn6h<*H`gSKDMvWt!m_=!FV^j3{rDr8?Vu_7k47D&iLhXxG z=luk$u|zJC5+zw?O92{($bM3%pe0AGwT+S7+ceZc)BgI|{8@!kMlnm1b#%4g&^$!H zpYBGCfAm_-9Xs#?Ukjh6WqifP|5U}KCw@?2lT4%TVx55~l+ z!Q$4;xnNL_t0ciKkuWQsWx4u&%7o*Vs>bAjveF&HEXidaq)SG(v>kR`scK)n=M#Pk z&92`y#|~^z3h4J3cB1ULXw#rGxdjxunm2OXI;}a)R7c%A9%kC+=#ZtowJt>l?01i_ zRgQuDlX90K{#u_L!Q#>HQ7!>qF1f4&KYZKF-|eWpmdFK9uXbNN($F6p$|` zFS6*gOY=ktXWOEyD?k1~@BED2vV*FWoNsd}ZRL8%aIz8;a;@p$7E)wwSN=Nhxbk%I;9q(1AcmYm|>i#G2EhlS0~!_bdpEJO;c_pfuu zmlp6aeVZqRFzqd!(33xG;$;08?i3hMTFm+xu6cq%C-Z7 zT9R75aeg;c#eJn1y*-%txWfl4g|Cn7Shjx2U2uI#kn7&3H02dK*QJ)oq&F;Jx5ewl z(sFH)&2m&MeS^{Z3YFMfQWFBZ)Y4G5S7zUR#YNnh46mECL$df5y|I2hEaFI)I_hST zieFU4(_cCEaiH7JYgAYBrwbq_6oP0*}D@Q7Sfn}B+3zkR?DEBXgk)&ygkt~k$JXFXJMTNS> z9|b4TPU&jb)R@YYKh00r!ppq*Y$ZpuHmhC?I*!k*%g^_+|Bxzhdn{XJer5Xiu~zNj z3&YMzz^P2K`}rB&4$l7+1S(^pFXy15G*Zm6C#UmSO@DY0VZ3~hF?N8t>ipxT1I^F1 zTO`WpmS{)698cy21MF_dp`ZC`)lPrK2ya2x%YYhh57EBnBc1TtBl6Ky;gPbBZf=6c z{SJ`HPPCheXue`UFSZUrwwjS8(I4NbzncGg+KKxmN}z45@|Ygxd8RKgpt z$;dNae`{i5qLUYQk+8KTH?>_9wU;wy@F9(Ho+xlWCjU}|m3iGwJ=v$heaZZB=2X;%qX_{23w!M7E#zCP}wz)64J+0|*_NC37 zaa`+_r(xBvNS&Pn=S@lGYSpC66`0^=j@*^MiK=4#I5c-C0SrPGDKjQwLMuQnhSy zUkZD~=9T@etGRGvmMY0HRm|z?*RQEMN86M$GxrajTvz);UZ3w`#Xgg~L`oB$fSj(k zDer-6P~PL<7(xi~wxIzaBKNCkWEm_$o6==trVTBZm**Eu{T|#Nizh<8^Ne&*)B=RR zdn3nC=z=;P$%g@soQ+l6aL>LZxNv9mk{ zw;~Otl4r`|oj?fPt54pdd42&4P+4A^HmJ`?(Fl((QN*}VG-(BYMfEnGfMlNTXq0FG z0=d&L*=9N0u^w9Gz+~o79pT|FR$NZknYxqWIH-0{Ld>#sX<;OR*Xur6hmb2BeQcV& z(E9$HPgD=QEK@^2s}D#jtsiEW+yNuVk<#7w?v&16`bdK4v=% z2)`)RlB~;i3)6dMH3LF+zi+-PFP@Edhs)OxC@U%XZd`2~H-RMT-R%U}~{~rRGED9yy=^ z>g~LiT2Sg1v17p=4UMcT%ltdY^UWlrz;vUX!NZM!X(~;DCg;)B%8%MNe~OXbp!Esp zwD`$12 z432lCidS~hyHf`u?ha{T%fqc&SR;RAPgYCJhZPPH4E9`f);t=3^j+nr`8K9mePmdJ z>CJOnyoHA`r-L_{jqX1RDNdNd4QAdHE9X;BvbaAgf%x+886FivNaU6H}Sv_|L4-de$@Ol9!T=AcXGhvB|&fcUeM#aaIDH#DD10KWu>N2E%Y{|(W~ErFFKiI&rb|r>M6_l`t?_) zsc~oJ26;!N+l5aBh+x*bFI011JS($HLzj}q)s8<(6^mN7U8&8Zawkq2JE|?RXd6Emp+<_3@(obfjBjo@v3zv*wdRJZ| z2aR4cbbMEPsY;M*Dq!_+GrA#`uK4qXy8)O7WC2opp3aQ-EsjAq3&Ki0Czv59A;?~Q z65MfCl%l_OAPK%YvS^DD>mRR}{cOx} z(J7Mtq~<*^v*(@nR+C0%_uZJNUO*_?Z!f_@XGg-L?&jSy({7COQm;IWLLK)pj*Fwt z7v52EI&WU4ihnl;Ne9M!r6j{176_?v-_0VCpthUL6d%`_UImv7Y3f^5KOME%!5G?J z|5@I~=D4=;E^@4YMM{#I1a`v@7M{xd(3QFh&tNe2CiSzjz*UkbQoi;VyK8Iw4FkWx zROR4nU*E0nMGFe!N2}W!4IuJR8>(Z4>E-@HX^?Ph4`oXwY~{s+d1&F#>^c2?V;3E334v8y581(-}sW+pc($t?~;TcLQ^{53Bkm3uTfq_j@9~@m{mwc znfbD01pVgs*I!BMx}jRrDrKx&zm$7hJZgL9{w!khp6%{&$^+PW*})&5foxDtadxIv zlWrnUbl7LM2%1hQ^jKq#M|P5v=jCpk&3tW{$u8rz(V_+q$delD!wNqNYMj2K<_dS> z*PsK3Tcvx&3e9zxg*xlSjkQQgi6+>C^L2gdkl>}ZgoB~1BmxGZX*?%%6WnllVz`6V zF=a^ot^b=)N|CW4@=b5@ulLCO+y8)sk>JH!4uuvvG2K>YmsJ`~BIKqzkD>O}P@JAr047 zu#n=!0Rg@mlfrz<*KZ^wV@a2PV>7SLx=-b}roD@;RkkP;p|yy)6BV4Vd|{-R`8-9@ z`4}4E`bJ9I9c$Kt`UB<9PY}XOu_^|$y^Aw3k-+&+FEHI8vF`0_3OLs<#=PEfQ7=miF6GWpC3I8B2Pi%#GAYGblFZvvrpt4 z;}xD;2vV1jNd;|Yreap#;dloVD{~{CtT~=?7h~^~$?~io`r+{09(mnZ2sT_Xdwrw5 zkpBpiTzQCg6)g+NSju*LK>Sdpena!PZ!ERjO8uVjQxb;Jiv`Mb{5xzAbKz7F87&hh zr~j{C{Vm*fS{!)p`pQvTUV5-_dQQ$1^rt*LN??fz$-`7Y0|osR%&xOJWzX*>=c(Fg zOXW=+(51dmr1w=9Wv4NkC3)z_UXWxTRvsN#zFo-etd*veQ55pd1r_gx>9y(vi=k%QW{x&L%_ zWoEt&VUIGHK=KpeUGJrGp!xj;GWiVAeXiEGYuCuu?|1wyc4K78{K_;&o{`FJ+Fl9b zNq}gpj}uMOcaW$a-v|rw#MCDzIE`LrK|ctKm+Hu%5xetLWe)T7r>=PI@PHj_zm8%p z#DGzYiEeD{N89&4)~>pZx%(~#9{F{WUKrCXRoeQ5V8%q(fx?8^6>~|%#q1*lj<5p_ zQYBKRf8A4DM#Hvj(}bto_8|@sFY>F+O=^sC;ZD(|rnjLj;pQDp>uAr_`w-9SeH$Z= ziZ6^tw(46^gl0M&CFKMU@726RI`_SDwTme>aqFB)6JXo<03r8LS1&1Etc->pBE^LU z>ds=OYjpBb#9$&ZlNHFpzwT{Il9$I4*GNJ@h;Y@G?R258HlmGsqSwtF{t7cMu+Za$ z(nY@HUc5mNQ|vOG)40s)`YMHtSZ8k+>XSs=bY&8QknLv{lp0!sBzXmHW<_d2O1IdR zup?Ji5YA24plB$xEdWZ2m6V&ur0>~oldtHx`Kwb6`M`7Wih37I-WBpJ&(9xVYdmhG zek9u%D%qBz{X$|IZRP1;WVXO|Qc~Z5FN?s@ zSM9xdI$N8-c&k!N6qIvh2Kz?FuB5KOt0j|4{NONGiB4C*Zgrq~6P=MH8sW^evk4P2 z6im05z#ClfbUTt#&vZH9dU88zroe*+qJb&=0{=o5Le)l4lPWGU~%d8hZYHVJs z#vgseY)EQnI8#VY_VDJwj>Dm3xYKYQHL!;afvHiR>xoHqKf8R*_~F&Ze!-?cCA!y} z&hPMLNj+pi72{nR+$g}BBv0^g^?dTJ>HLD#3v}{6^375;0S|m)hMRP0NUAWgC~z8!mcOQc|H|WYo1cPb!*$aXFA*Yd_*xl~y~u?d2*gd1qo#}dw!Qp&g-JLAf>#GaH-b5751!(UAus9XD zx$DxK=!JZ~;_XVSYMAyLa*a7`Wp_?YUA8O@13DaJlXW*ME6zK zte=O)6PK-)PS5=B&8Y|8hq-UW3=V;X6${hfPeJXq4;*fec2)+NP85#M3|%^O={unH zjU5Tx&X|8yP}YWoP%aek-;JH@wd8ecP&R-d@27z$Exm@XAUGk=+3}kXJ0;UAJ??3& zB-OV^gtLCmN*KRZo7_q1UEjax<28KOW16V{7BU5&J02P#=@(I9FXptsto?#N@%R45 z=4QeshWh5snSt^|B^K@)S0)t7es^tp#~BfkfRAJS--bfvK#kest6$`4MNz{qD=i8S z4NEZnhgkF-A4@QId%?iUY%p^&yAU#p&-MN%Zo0>MWzdE&NB*Oa+Tmhw$$~se@QW@> zgF$)3euUD(jagN{ae-8iidd77Zu3FSd=%vp0(^mI;tH|bcrseK{n=d_=}&K zj8uayq|C{l^C)l68ousN?8fz>Snt<7J7Uh6q>~%DPX+Q+X(~4CBz=#yJ9ewbzLRBd zW)EmZ=~KxBJ_7uC-(~)(<(So@AS=2AXK;hzF$-ijJ;~P{v+DBmyOJsUi}q+L@n;7g zQkJyA69Eye>@X-A!t|-&cITIm3&L%sdmH6a>oXq5CL)gLb}6aOEOc7Kw{}^9-#I_7 zC`M%Xtll$9(_P(3dk-M*-EG&og076BIS~;H1cku#$3p6OaF<`erL+`e-1VYzk#Pu( zM*HqoK(nl0T8Z(5Dvz(U1M}ciue_pa_8S*+Y>M}F4kN9OiCI;$iIUH}Ya1vuX!_;5 z@}YW&q}}d>2Hu=hBSbLnHDfICJ5m!c*31IlJ>l^LM~~f{Z>Ba%>dZb!J+==Ff3fCy z-1pte=2%@43qv0a-vgzpWs+=kYX)uyzsY##vTUJRI{`7Y@0#DBW_4-TWRx2fNRCB> zdB0V)lKj@53v@62!{yh@r-pu#YPyAM`@?2TaFnIz==rJAJ@)NSuDBSVkRxuJ7Qg!K&_1TC-C?>>F?1Y(&gSP!hXB0bX8oHMr<~Z~0+UHIoG#W-!0hKW!UP0Sm$Pd4!iY0U!B$&^U^u2GX4&M4){Wn!=fW{H za;lf#+*o0JPg+xT-72sr<%alkR>{;*()@3pL3y1+NTplIEUW0-&4hj)_SLu7y;YOh z#S#BvXCJuJ1z>CLbGH;PBsNi`HF$qLQc9iJecU-19_gFm?1VXS>FTWP?1?E7-l3hc zFZ=G@)=x;?*zoe;x)`F7NQumbUekAq5t&X*20XrI>YmtO$<8k%!kyc`;45Xt=w^b`4slolGF4JAIn{*H_;Fn*K2Q=Xw)LO@_?QnL)~>EQuQRd2=<{7f z0ZuA!yeLjp>fl!Vq7I=qZqWqVCxaR^mov+L?mER}wJ!~f47xtyr21~ z0bj*LW!gdFzDDGKfq#F`FdaUh;HP=7q9z2sSuoslQs%N!kz;~?cBV;G+S|PH^m9WT ztYtG0mdx6}JX~(|D{_*FwY=U^%pmY{RaH{;p@HPVk{MR9>=b# zsI3c19=%{>&ey*|c}I1TmpJCA3A3urzc^{#F>Zr?h%@&NC*ce>c5XpIIsj*03F*t& zxXRV@kUy}jUeDlL*Q(`agN9?tgNJFezd$1FTpZ1_M3IzCK*#Eh4zTHMu#;$Rn4xk% z3o{B>QoYl9AiXNbX_-*P=tJI&AT>46&!5Xb;Q!@nBe1^!EdKwaz=_{!S{xZ2{a8=$ zwzai&W@hG#Vx5QoD6_f-2M0^b%9@qy73<{#UqBNQF8`zQ`XS`~dw#*b@_!Ug@jLA# z`C|=7+|46^5OH?NMLzrgv`G8^eAzsRuToK2+ePDLfeFZ(?^UuH)yu3Calem$%b(o$ zzSHJ`pyDgF6#q9PdKew|Bv#HcSau)UezfqD-RgXq!=DtjWtQd3ZAF91chmGqgS=PO7nZ%uz zvn#ugof&RsW=2RBa+kwaOfilt??AWKl>Gp+`hXOdW}RIk`6}$FJ9P1K&!69PNVvtnZy7!0csDp$zU6NP_oy49pP4)i3}__NT5YzEKOFPlg?S3xl?Rjz|X9I)#k+oxXWyx~-VfaR2RD zO2D(YIe0AQyYBex{x~?qczEz`qOhNULTK;}hq=Sei`0SV0e!;jX4A$6*K-r=;Dq)0 zg~Q(iQdR>issC6tq&X0JepuOwlT%)yZClM6Lkf-ipfpsmLxUvWYIY9Ep1d>gM=mq4 zvL-*Ut+O0Lgs|Pa$4{DngNjN%ld)%z^Pz!(H~~RmXy^40Hwz~|>JU&ibKuN|`Ra6R zdc32ZD6_mgYG!H3%ue!guGWvihNYPJcq&9@!28fG<2TQrKfi@wdUawFM5OOEoSvol zKVfS^ow@e1role*#3L{2WV~Pf%fCLCz#PZ@_MzynU+?Voz7ZI#@n(&XJdP|zsOag5 zQj)>nhSny!E)6DDR~yj!9@3YTs`@z7lQ1)}q+p08L|pzkz?)Nm4uVFJ%^;=X!fDTE zW_^{&nJ9*7hdq`9?)@7(9WZaq%*9nxz$M5MzP5JxUT*lE>asFdBBBk??eh4_gE28r z@3G`2K&tU0yUzK`pTiEY34DOzddv1}UB3aXT#gfyQ&eRA6g@48f zcpetlZHypR7+F}}&CJ~N+F5!tFhBe3)#ybWKX`V%UXF=Iw~re(90oY{)_AL?`R>cm z9@Mc0hdXrU#bfJ}%8h{?Uz^oVFFhP(2DB^PO9K>Z8;XuSz|9m~Y2ES0z7GFpLisEn zUS2{eUB90W{H)O7bX^=i|7uyRVrm^6`Xn>z@kbR)#f*PAfsa>t`ex$H2m|zzxL*Iw z0k8|deVn2vt-P`iWMx94^(2734VJjw(64Y%_y3zFC26MYRB7U$+DB_*cm3o%M&V_j zh*2&BXghKDn~$g~o%zyr5yp39h)`Xg+WL}ay1pY$qg_et0TP?bv1rAgDC{wD*HZFW zh=L28-b}2$v14WBJoH%`uy+UaXWZ(`$(?FpE)?l3GkwOi*p*Wuq`QKOig*oFC~fNw z;+WehO3a5I$8i~V{4T7Uc=o#Pq8ETZLaD{@WuM=4nd_SC8!*bK8b*ELKt>KZesGRI z*#~<0)4=e}wDkN7L480slx?`!pD(YVl#x-Ag3BD@EhV}Ee`3|&j-7ZzHa`9RqYq6u zTb0MEyty=!VjSnpGQ3o`3@jNE-_ba~`2*%C1(-%CqTmLgB|`q}+G_u$s;8$-6GaN( z!l+l|(4WCkbv{Y*5U+Ud#CU21Ak(>h8bK};^)tb_w3y+u9i=0UK|!IJIXOh>WTIK_ zEPQ-~P}FlF77_NupQNd5_qa{RkJH!oeDIb=VCm>Lm*hfK8Mp;&$Bf9@e~qLE()xsE zr+cLVpE22%lI>f8mfxi`a_eN6gmvsq><%oc#v#WPMzG#N050{sI*s$MhJLGpk~{8c zGgzf{+OT%essQ?ytm8S!>XL6|uqr#Yc}M#~ls2a|>&luu6zP0^<3| zn3#?)9EG24y*wBg83`kTJ^(&4I{NxFcR0$X)Re4rdVAjqA+hTtDQUb-xTA^)6dLo1 zZD@Er4ft;S?2N6e6r+~%$i%8oR@zs z-V$CD#~oAE13%NlN@^!~N=NDrU5UHH`Mb<;uIa*LIS`1Nf-|MDYTGspVY>Dqq|&5; zNz_&Db5T(wm%h;E&^+D7QOovo%{vmh=B0YUPQpbaZbDCdfis5pTubZrsgM20?)=`q zm*iE$(MXsf=-qv06%dA9rJnxk^m8?%M=~-2#c&j0uLgZ83X0TqY}3;G2it;z_}}xB zv2}z`M_`WH(Fo?t0mR*L((6RD?=^8zUh!@V2i(lq!RsX<2lfcNYtm<6<{?Mi1Wt8$ z9XWGxcZmGcEzf2)t?Iha(Z_0F++9JjHwvvaX?CCw9i`Gj6iKDO+1zy~E=&mN4q zk4Hqd#P5!x>WL9X4P^@x1U?JW_`n3$EWiQO3q?Q0!98~UZ&+tL#Iik%X;UzeLrj79 z%kkRtKMn3SH8q*?C$53fHz_Eh02)N}>9d0T= zsyCNNCUZDs&0r%#z*>P^$ZmNk2a?`_FVEMR51%Jh}7D*BeJN3gr@g9aU07?eJ!KsBB7;$K+JvB({p{Ldegzk zd)A(19K!+dBszQbL?DogL7a><(=)I^AMmHe5=hi8K8GR*E(eGvas^M3i{H$h0K!WA z!%*$`<9LDng7{sZU|VZtkoPYmvp&c)5KF>Zbe@ zxdGMHZ;(DBpoNS?74HHb} zEd7%9e}CHjb~Ku$RO>{W3OLCdr=b-uB;S%5rg@gYM4h$2{G$Bb`4{TSr(ibf!`V}h zV$pvRnG58n?SD&wd-5)+zQ={pe?8Q;Q^5gh^QWt`Tk%|$6&zwYPEj@Cy?@P=pW{qH zdR^%h->7#Uvm&r0wpUYF`$NeOXo$dz<-%eP2E`AyN%gyzxA!M z_=c0T44>7CossV{b53q*Xcg#6;?YGx8qSlaWT=dgqb=gY&5uXgJ@-Bf0lLeVOE`rw zp^jD~U@N*D@Y$uHu;A%xmu^;W?zA_TcBVmy-~0c2Fm!vVuy$?D2>>!##!n$VJylad zuD1eD%(3ipHZ$tZjT?=>Y+FoWBcX=4q2R9uftcrd`DLz)a6?hjyz zZRSdqATKW-36$@jfLFb=UJwBwq>*oGX@Zu!1QstQn3|fl{z{eyGEk)9YuqS6S-N@d zK4ZVDAb{1TkSrKhIZqN$YN)F>?URhFsj2<=Fm73D1{(sj!5LNiYxAXfc`+p=>J5wx zL7|~`MI;Y$8xO2VGc}*zR$WPz-6qTZTJV6l1Va03G*1US!;|O3y zB^Tk0U*nLw^1&#dy*|iLi3Qa8a#U0lfXAMxt1HRN2NxeCi4dYjg<7o4vrv-$l^1hDsAZ^({bkE8dzMLkv; z8Y5H~#k?b&h4FyA_HdzI7B!UIX%>Mc%8oJPcvDiI?}j}c<0K8j7(=pH5tKcib4VU6DCqNy{>;CNArFK zuh{IYMN0t`GzNb|B{t`US?RQ#6x&?$stK)gU;t=)ogydF#s0$2+J%y#bROpcx*xuI z{G`9j9xsy#CSjWQW8x8|bK_fi*I$teCMNVi0y9_IEj4oxw)izChoAJ)H_P(tlTKeQ ze0&7J3cT3Z*cNWWyZ=lbgPe2N3WcXg8#E@*6zs#hGE}V5Lxr$n!dDKXRaD7%gMbZw zWrjOeO==auEorb`d+9!FlSH&W6Hzx<;NIK68_N!|OMQ_PY2e?*uZTcJME?f4J~Zdf zPZWn%%^LX)Rb1kkiQnj1?f#Uv`@vbKm8cAyN@yj38Z9vNZV5|l6`9|%=uR`7nVmO* z4K4IAr?y_cBxN_;N@?u(R7Qqiz(6AW%NMq}PDn_YlpWsPd>6`=u$tFFL6_%vQX1zv zsl)2d*|f!N{htD|f6+WZQs^&<8ZDLOIiAN#G*v9?10+Ns{_WVAi^R4NB+YQN~dAy3U20~6}4N8yd{nVF1@JGSsb?4qP8pz&d7K? z=Icn6s|~3SQsmBt%sr&wO6*3a`@8~-+`sct$P$=)C8kH5-01qKFc z=sbU@sYyP+wbH&l?bxKdY`y|O*IKh&=NlsLo>dCl6aH()0ELx+<6x`nuB7B^o;tl|?Obg8@M`S?2Q5}EuGEk~gU3(Dl|!LTh zETa!zhHLuIRJ&XP_$4MzO96lY%go4#R?`k+5fx2>Z;qMvL8Kn6yeGXQ%I}Ak7WGiE z8Y=P7*&G!z;C*?SQ8t_bV9houI_O#Fn^rXsA5Tt|F#~MOzo@=5RGoY{f%>AAzcy+1 z{R1(TGm1R4a)xLaw)(2^T5}|QGrl{1YneltmsAyA>^h9XICc5yN}C&2{SGeCR$}Ra%vfiAOug2ybXb_? zRZ5D4&(`{-n7BBn`Bab1VGc)uy$a)~^mJq!nHJmWYcyOcP;C&MvRPZK0WX-XF4>Dt z>Tpe>TLQ~uVlsI+*EQao?@gBGiIJ~8{OvN$0y_7f%Pfk`F?MP0YxFd41N&h&BC190 zg#+M-u*Sz)ADS1HUarKVSxw9JfRw+*v^+B2V=aL!A`d_bQIU~yk9`>S0ykQ_yBp`l z>@~2F*N8ZZ^v*S(5uPXP*5v?Uf+K~Mto@DLZr$UR>p*^Gg|Q_D10i%_tcEp&qFeif zF-Zy-vO$^_6zs*5LHF`hqol*z|2sGZJbjr?_BPSV4=cwa!>7_oT?Zqu=?4wG+&nnBQ{pwiOU0KK#KN z#lyu(M{eQDER-yNb#?m$%gMEt1`ZLH?zhM4IGF%B%IS+p{_hGVfFUx?3^m&6e7W$= z4rIdr7aS})Wk4RMbvhs|3tm+vp_3R+G4usu!+PK=;F&{>MM-V=MF|EvoM+_=hU=Vv zMpHgq+#knLAJCV>9(@8V|Q0>5Jd75Pbc0qBv$#SJSjd*N@_wgsTEBXF&4YUx^h`fgM8NodRo$^0e{^c12 z&#z$duvU&9SzLcn{PI1nNCm7Zrz-&~@JZjP2Q)=Xac%6Q6UzRxrGdP)va&-uGC=dM zsjKRes+YJ5 z&cv)99bf?6h}k{I+S*s2LnLv)cyC-vQekz>cd;cwiKXj~a8P0dHcWRHV^wa7!YhYu7l<``8+QYxn@d zGJ%b(d)9!(9ipMp^2^_YGo~1TiYsAy_oZ+D!0sg8nEy&(0tT8n`{VRr-}kP(1FY%F zxI+XrkTbXI0zTY&q~Z>x5pN9Pz_?Of?fF4CM+n`{Qp?|Qx>eafak|tifCJk9KLF}U zCn@^%o+T5(4&lY)W#_L3!6_1i>++%00`dHCY%d}(QO-&+VVjL+7To)eTUcfv)pk;mu z6gVPrwU#)%&wnxY%#l-W%QIgMgzc_EDrcYKt<5uVQzCoL{yQWr9=L|Cf~+ z6?rgNcs^Au=*NITV4tZ)7kcPs{7nHrG)bj_%3Rk0nXVWNAD}?u)(4cCMBpUE6kR5x z`{ga8eBkdgXkL@+cSJMQb#!pd$==c?*`D9DS58h&Xd`}+ZoafI&ET@2nYJ9Do5A}~ zQqnWXj4ur^GiQaL4@i_brkmBrD885@^MYy0y*7?7U%v1P3MDpP3&cftfeK1n&NsNB7I1F$-l@!A`DC~c_mSM;GxB|Li(1ML z-@~HdWPm5!(cAkWousvm9B@N!G8TY7>MG*W_nSzSaT$VPSz8ReB_O^Vbcb^Tb*!8n zT~o}Pd+wb!c(wXFT#9iWNW0=S#Q5>+ODm9|rY0t>YFL>=sG3R_t>pghc?Ctq%FQl> z=W;A8(PyL(KyzlZmpEEcBF?%vej}>o_xI^@UL>?n9<6Yf!2Fs$=PN6ZOKe2T*KY^D zPvOf!jh=h^IJM&+1bMSI5Ght!_HXoPnM`>g}%d2HET#mvNBK z$7hPAe*@`P<(zN(bdI`;&YQYJ*0sCrHzfy*jhgrE1=9{xnMO*Vc(2RdZC+4PJ7EH& z@LrS;*Xuhn!+P@xqf<1So12%=@HaS$Rp~Ke)B*6i!6_+APnj$6eI)5TJueNFxb-^k z;0U^&=awPlrOl7k94IJVN1OU6wKtEoO~gN4fTdVey*mLmmc_&CUcU!s+)a9}$m77m z%v&WEVwTcaCq(jYKX>h@`LyxsTj=MLCT~xhD1pRAX_c}r;v`!@1GWwdV$0Hi%LwRY zL`VtI4GZ!lrS_rIdg0sqrOa1g2Tt(o9_7?fd5b$IO;nofDuA3X_=?M$?k5hf6HACb zQ_n8-W~%@{eVl|cMJ|e_%oMm+omK{;au4}+8`gg6qn1Hl-+vmMjJ2tQ0;{m{#YxC0 zBCuyeL*c>u`$O!$8-5bA4(~{*TH=lKP4^jlaRfxFSoV6dF_tz&hF}hWyG(0|O6~^R zS|G91m5WCwks9R60wpgUQp&wd$&#L|-Zvd**)zlBksMRu`g<_3+_r9Z!RojHsQGU0 zFKO@2CG%L17n~nO?C?AEJXBJ;Lgg!fS`vx`O#2kO51Eut7o^X)!*9Eu{E~v!AG(|r z9hMwFNGT^imZ60o&n&$JMSEjk`yOIe#K2qYfw#+K-^xy{dpU_j_`U|WXBw{oEMvm) z_bWi{gtycvrIW`ITkf0y1ffW$%Z|uJBfZYsVLKW^9_>*MbCg>e!v4Hp{(UWFYm<2F#W0o9=}w2=zvb0&1W>QwOzG07%uRA~s=)r>&`_qHYu0uYCwzwglNL+DXMZC!*o~yHo0QM< zaGJFK^O3h4O%CtutVbZRrl-E4d}DJXOgWqBKQ(v!X7OduqN0v%Bj3L#GK;@(^+9J~7zyFk9Al@>S8hH>D|KKCwYSc4a>Oyhsq&<V=rqjW!m>NN*jayc5>AZpX%ymE*(^G6_wXp&61k9whOLDzA z;C@VGg3~b1)=bA=gvF;t-$^$EzCC$7K}hkd9V7UFaHj5kkLoIOgSKB^1LxV{bYb(I zuv&t<73GPD)mnckiRz3oijVp5X*WRt_amSu2%SV1_a#7|7y&PHxRx$~%ayq!U}) zP3)w|qhKpsQ&%6Gx&Nt^-F73J$7+@K-o1ACR!=(LLe_|!l9K6Qb3AA>3^oaZ4_14A za=!6}-Fjo!3^EJz7?lN%B?`s9wK8<6u)F;u9)bi2b4-I_t%LPQf%wh!j#;!zXMD>_ zWMBCcDgj5|^lPJ1AI)~}<)j2=OLNCZ@CfQqhn^Gzq8JmowDPp*X31$4G$Ztr)Syr_ zK%9y1>}2mQWYe@5doUIrFG``kyRm?@wEmAcL524t)G>|@2$Tcw=KbGme zlg6nhp3YOZj~2$cF_n6l)L`Xa#1Hf#^5vM1P{-h%5{6C!pUpR6sDbA^r5m zo0+1rMYT>`6{{(~ev$6Sj2=b##AtMnkBXx53cwxqAY7*(uJ{4a7WhReZKlQF^KHrS zDpm*IBd7UDqn;A|TQP7he4x^{N4JQH_|;~Y^Li(l;Pln6**IeWN-2Os=Vy=I-)OcA z3Ms(r0IxV&!t0-xy^kdxH|fR?`D5IVjG>6ywl)R9`8u>$o}{ zNQ<1}X8#d{x$=Z*NNTYue^I*cBqH$~0pyQK-GC3lxr7VQ>S_iv=*jM{*pq#}a4g?uO5esrXi&LMU(?P*OkxLeVd^7S%q~bo^9|i(=z)U9KuOelP4jo%alH7y`*qJO#45sW*Wj#`I}gUrfX(=FY< z!xvxE4V>s-aOML7Fe*yN}lqx-mrYj)r!8GOXJo{ zaV$9y0|5+WS5ge6~-<;BEbv0^4m5oazgtmDoYyW3=W~?Pia0;$VRidXz__|Ck;F zD6Sm9`~cx#H&hZOqe!ua%BCv{2zELkRG zz7&iS2Y{UK0fv!}4^_Dc#KlQhrDdhM(BsU{Zq3&gcu8@aDk7sLZlv)h7Of@Qsj%|9 z(VoHTG@S+X&O-%;x`zkl@d*MRf(JWT^QDV-|4n9eNai>U$eQ4n$Rcm0OB>i#I}70P z?_=gaUZR^`$WFt3&VEho23~!j+UoxK+Y#5H1Yr6Ao-9O$4J;d%+gBtIMvykz^(r`s zAkK_Uq`i%!ZRlv48?$^s2pg$u`)Y<%0R)%~LOXbuHbKQhOM~`;z&oozeXU@m;_pd& z9!wi2-1y%o?J7wqyL$8D31{zh@Zlzv?c0DNHfp1IRe1-I+|yCuFR8gdJ+ipG%pYNR z{AfmL!A0ew_VJPp+JO>#G$r7-Z_V?MTADM|tYkQEuyF}oBZ+n(1E`X2ZQq8Y-j&HP zA!9(e^Su&BTeivz=mS=)g{CE20YnKEmpLjfQ?J;-fc@4={D;`6+Q+Q)0$Vc&m`&?M zl>7QtVHah2c6S1|P6KE4W^x1&$GEOeyHznWGeb+~o5)BV{^;}hfnQ#*{c8-mh#Z$T zHRa!=tZtsqm23tiXt~;SEfEO(_;wW96AQdDC5WdUJ;Hxn6$~ivP3jv&^7QNaD-|!2 zRRvMAC}lhed=3y0Kpr3f=oje$t(B^#W-L(S6U>dh9C#ivYPm#Y4eaROBu9@v#^$5nS|FMT8KE~&IDP-$fQq5~O5EL>+~WGz|FIw;e#!Eh&JRX;R-4{qkNo{dn_KAV zIdF^eKs#FOq_~wTr#H`yt2fd4R+n%SruM^$2f`3h|4RG6z&c3)FT)F&q!Dx+dpVeE zY^Ox?KcxJ5-5zFrac@OZDc^wh0V&nLrYj@e%(t5~?yTZPZp`JG}|nT1h%9oAyNv`WuWvR-5@31ons*g(jd|z-4a8Gh=71J zLwCav(mnHCqwaW~|9SuS{lEV^j*sJT6B}mkd);eY>$=YCJkO;+L^pN(UQBD@9f@Bg zke3xcebymv^#!<<0U`}OK3x5jLCr9%6zWfSl+A8?gD zXeIrz^{9U=Ojs&4*$N-Jy)StZccT_^fdL}v6ijlu1J1IS{d8_~bJfav-&PHEhA*MW zlwm0Ua3VoTP2qQyj`K)bI{i!2Yjb^@p8jNh5QLYHf7#nEOD{ij35 zBLFh`J*Uj}wqtoLWYSl7wx8Pc+RwEI4|-yyQiQ(W#8Y~Ac8>EqE!?|z?dO0z$EzeIN6j zMs_sYk@c=!1I8S$s4x*d9SAH^7Ui>S5nX)_@?|MbMt$v4!0S!bD5lmF+_;FRZAF}` zelt?pN((TJP`^ls+joL+lIe}*;Rt57YF}D1tv7A6`u%H8I}^=qpdr(wSAy32g9r3l z<&LvW%wpi0v1zc;GSxuilxHw6U|?v$V|lefw_w*StX#89mB`@le)CaU#JF6x#F7oI z+}71Cb2S-lTDt8wwHL@*YqC!$9{-9Gvpe&WH`c_loGQ2BMVHIo#4ujcar}1eBl<|u8>$wZ1oG(_4+6I)qJ)}S+|iDt*>SP z=TKG73{U!E0D}S0K;Z88uY1xA#IXI*ePIkiUJpDtfXzncP*(Zhv$uOOdKU$3Yf#nn zxAe$#SX~3C_>@~qi_T`tQ<}RQok~6xwSqd~d&j3MGUX?=s^yE?vO(>^QW6p7j(i}m z^b^i~?!ra7oZ~#jgDq8uB2aP-ryb{kKJGR4l`GJ>y2`%t{%5wQ9to8$12J_3S;VQV z3#6YZ9b=~1Vy4ALEExVwc4$+}zO@kf{HT;~zwI}#Gu<3t zFa7TPiBz|aTz8YPv{~KKh48fWPfYu3daQkJd_i~#BD)_~sciG(&tlH`wLEWGsKsoJ zZQW5#I`4;mSw4^`@O3KdCsXNOK*2X$`==PLQkLDr)J3dq{I7-*rFV;IjV0$eRNmz> zeOI%0o|*zA@#Ota$SY=Ht(JJD^9AcR?ad!~l#wr5uSUB(Wbo|Pbpe8$GvPv8bL$2c>K)Z2!8a`8@rlc?4_kQ_QY17=246HB+Y&FY z)|99$XZSM^;4?0K4yu|(YOeg_v0vfSrf_l2pS-M}{~zHCu|#ik+@ZWiuSTzU z!p7BF1$bcp{x-^-%AC#~+8^KL^?fVR(iUVB!aZyi{+C?$T?_X&(oeJXrUj4lB3Jo^ zByFV%{wbS5_}1wGvcOo{;)s*93~csOk+3v5`QvfmvtIm;dMh&foy_C4GI*1B-^LtV zR(IX&6RsM?{L3u^xb*ImA6Y@m8zO5nlH%LH7<9kx_MMC}Qm+G(+jxG=#^p_|XzQ7O zUgXrfmYwh8n`O5&TE^BRm@k+R{`>pyxHGs@=TR+%e=K_XAoK zZT&rd<-4S1LCf){4e2l}feMngMn)^TKU&yWjSDQKXTd!!A*(R#JViAp;i)S?y|_@z zZn*xIro^UGHK%%Lej=U}3A)o7xAWU+!coJqXBgc>e3j8NFyUs5jskcXaz6 z<*vG@EXc-A9nKv51b@|g@bXT>E<{?Looe~!wEg{VZ|)QPMilr-FK^tQ|HyY|!EZb3 z_MV%V_yV(S#3aCrw|uMy(S39mJ55!ro#y&Re$f<-o;DhMHsF}FDX*ET)#IFWbXiT) ze0`f3-{=w6*H<`LBdeZiiq~o>Utu-usmAIqTK;c9Prr4mCT~|qoz1}!6A1LOP5QZX z`QN`M|Gr)-VA;Mtb4x(3ME`=6j%RltYii9raMwfrq2uA(yXwF94@*yaRz-s(962ye zKL2Yk$F8B#yokejV|ZhZyl$@z`#M?WYK|n?DEqh1lijAv>Mc~M1vURk=93)_dlOK_ zC(_Mlk359ERfN7j08@1}AfyGmjVFj)oNwSTbd6`OcbCAiroG+vGGq$Qb&~^VlzJ zc+#4H?GM4Q2AX~5>Pn0-P#VP%hy zY~j?yZZ>m|gx$8EP&hHAMz%aT_QQSnpNcn_Mg2?4@@|Cnmh0BnkwRNj%3-rA@*go@ z*3%z#;wKPz%W4OnN-Y=wF`R{bK$SDUu<%IV@lOf&y%Dl9ARPExy~UmJ?KP#=_3lP< ziGLTnp*6WmHHs};l&*<&q0ERttJMKSxvSTxDukT42c66(7v%Iy9=AVWK|0-H7SVhL zS?XMn?wd--qZ&mPdgB6ijm-kaL#zaV8h|L8mYe%+NT<9l>B3Hjc;+4MmJ5ael)}|6qyev9sdDc zy-aFqx*>e9;}Pd#$uOF;TXvVKc`C_3UcmlCT8WRxJ~9IXLX^J%hQ$t*0)vgEw);fF z^VT+)kd3;n5daW&K{lDURLhF3i%vg=4 zudnYLtv++dMQ#c-T1iobrt0u-lJ0`?DKr@cu^8^#vqE3ri8{5mTjTW|f`{LvE40~R zBEVqu{3_;eMc3%9PHZ}Vk2-8iUgJgiC`J8%h+u*rxz526^4;e*Nl9NOCX<7uc;#pk zw|7*zz21XMHM8rhyBV@2$N`~>)tOAtqLA}I9(RF{=}E!m=(-oZn0h1bNq|I5p0p^3 zY9QhtrG@^p-;EdIT>p|;YHHit3s@_ICXyItFAz0kP+g5XHaugte31exA_hxCC+|qw zYSioS1W!$Iv#9cVJ75Cc`}Y4w#Mj5g`!qpxp8v7Hhgpm=9rm?jj~9O+!6ZV0yd$k{ z=DEiZ|2(T6rz?Evwo^<%%7==H!k*uV!lFQTP)zV|E&HFh!2EmY5Ljw!@+?36@ZrNd z9vmwmxksMDuKWkj)=3z}ch%N}(L7eSm(TonwAAZ@H#7dx9Bm)6@s;w?-I>$ivrqG> zq^Ak(V||+yX!~_AL7;xYY?(Lq{Iifhr5C{jimIyOK*`Lzl?QQ0pCgh0s@s3)f&NE* z_Dco*FZ&nkUY-Iz$7$knc;7oGkdmel+k)|L_YhQ^oycjT>T!7)4iyxlH8ZP2y+2?UEj-TVK=tPBdZo5=sc`EStY zcu_ZXBA%k41z8;VBg>*ePgx%Mk3!MhJ86v`g8zF3BFvP5LaC{c%!WsgG^OKOaPC1X zWXqq_W;h7Xo8YsCyIenw2$JN6EP3{~aH0r=VfI(93s7!y8~*^O>Znal zN-IX-iv;$6Q~^mH((h_!YpB%-C$3oOr{tTOeNUrVh2Y-k+8zrzVl5<~{d zSL5hUO=ss-QThku(Lbx7b2lSp-dQljC_$|Z<=6VpOILrHCi?64TTg~IzUh*=6j&hUWr2kGj z>akx83yd%Qx0eO#%%$`!eV!>uexkUiSQxq=Jja*+ zmQfzbKU7ZuoT_ELV^P*G@QHa^r&nYCYJr0h4VOy*)gs*&MN;TVCqErxJrTCZ%;P9U z9NRMK%1yj*wdRVEOitAg!)Q8EKPtaEOLNj-;+tyH&a97=l)V(7IwHVV+~Pre(Wf1P zACF~N&+lJ>XCtFmqT+Tp7^!&v0P>Rh#RBbI&i*26dU&Rr&oe@6umf)X%xJ-N2<>j{V>yy#@gbtQ;mvFSWAy~Knq7a+FoN9MC#a+P zltN1NrxhJ+-UCmB>F8)S(*1?y?75qce#cMzvN$;&AudLT$9(^#HIC=KpINp2S0j_> z&C_6hf7Y;ImqvWncD_daSyt(!!C5=&jy@6V<+kN3E2-I+sQX|w9{D{rF+JmY!d0A` zBvSKXj}voWse^!_p;EmrEqD`j4`tkFO8+`4J|8G`Y{t%(e^PNDOSr67*P2BYMv7W= z8SS^{pS+azEB9L82+uVM4KXl33OxQ_x!0eBQ_(3!i#@#~pneru9L%eSGU(eSV#G!e zZ-^D*s-po*&(;l|YhoOAeLmC|yYxgDQ7i1G&bL#J`{ilST{or&%Z)Rcnd<+*vB5s$ zw3jnHX=r_BeKI{AC4kTl^lR$8A4WDi;Rs^hGNK^`_jxJpuM1B);d5@=2G`cCwpOgi zMwKM;JeE+1zkIjhShCT%;7 zbNq_;HQ(i7w~LoAG=|Whb#YrZ#}^YoAp;3Lh<5|Od`T2>p}rz07!!~lJ0H;z50we; zRjOa4ch*1gf+N@etugj*`umZR%LJD__VLoG)eVI<{O7gqZ$^wdqA%5W3f+1A(Bn7%?wb5C zYl#vwFrXX1Z~^FNpjy*g6#jpupl%Wrhw7s6emJmXZ~hHP|B%AO3Z;ZOQXOs!Nw!Oh zOJ5OTABE^3`IlZCFXOpKtNov;r{&s}dpG}Erm4(jpha4~yZM@sN**+62F*P!?pwRw z?$tIzN=i!g;{<(K%2z1~7agO4MvBG;r~W(96t8JHdJ91^O@j9yiH`pECl0ad$AO?L z(6Q1dCIAgGC-;$$9{Y|kYR?~)eE)w|R3ttU%aE9sSPuD%K6r4;3aep$pnG3yza)(v7)PYU?X#fo;`~T;s_9!6X#Cv$OK^udSqH zSrmvqXprV{l>BZ}s#(u)`myg{`Ynj*ot=}@)}nHqJ{PHfIL(u4vZdx>-h2g3W|Ob2 z>-KUpNrX;akRMz9>^dAkBH+F{JzFwtImv*ZnsRayy*b0BYfT++`iKw^-F8XPu$(jU96t1 z%0db?oS~s1G}Ok|cOgZ`Z{u{oo7wgn{Wm(FZ5@Iik0yrAsDNP`kJRD66@O}1J`7S* zVm`ipe@W|OU@ZYOn0%;l;nR&@LZzRoi674ZT3P>JPUpe5gu982qvSw=sDQMi0oR^; zpnoS4;rCx$6e7^H*;N|iT_v5Em^i{~e?1;qjb#@;T)bbaO->FrLzWe*%246rPnVF2 zs6KWFI0Sf-Y^qV9HVlNXpPyQV{Smv_N|PZk%DTJ&GeB^iWDk*0UJP$^Q*gOXh=`vaUfivjXgyjm})r$dO5uf^rSHmTY)%? zcd6J$9)wrA6;Le75(+410ood`BOP~duxRO4bc;Wh@Eo=MgNCs5n+-u{6_D?>WjCpv?}^*jnV7hj zxu>X@5f+1mvl*E=x_#{zM8%3z%F4>*;(sRI&Lv_fpx88trd0EId&l`&_ z(PR_eKez@HnGaV{BV9UK3`olNgR{sPQB^it!e7{H-6-yi4LIDz$t^@i6Lv||)41}o$QfEYCYjEjK)=r(348ZpArIQfBF^M|J!w zw5cK9SSV3enR`K?9q5kByTdpMjd8iO1;VJ{&y3o_^#@0L+;wInUF82!9W(OclQjcDJ_ln8JVrsN%SUoKmx)?{PM ztz6}ZM`BNFb(Y`S_@H}GXvOZfJ@bdtDXzxh`fv2lH}~B{CCk+!wg*&4-9rbrS?oacTk zGVlM=Y3O&Ion2^o_qO7%MEXA<*2vISH-e=>hp`wtj_YhpGlNzt1%?%#@z5?^zgPiY;uNKbT$WKiKwbBj11sPaDhc_+)qOL51)>iE=LX`D`50HzY)l zjl$-^i@eVE)c`Y7Q!%{tz}|U`^Cn6Sm`kr_<8aIZj^>F*Z6k#igH<&<>OhnKU^mN_ zrM`JOx6RWFJnd%EQ;j}4SrI}uk-(5}+kEafP*)nO zgN(;6Wikki@O?~Q%`nVU#bcR*)a*YfbWb1zgSO|^ev67)*#VXCo-;kp^N^l}lruty zyOUS*spHZ>Xa`T|wo1-pK;c(ih(>KXyX|Q2lou^AF)=+E|4{5=(zEU$0(_>68;7R( zld(kX)clkM{a>VTdjiZO8cnJ3$S)$;-P;H_s88jM>CK`l*zPtCL+*4iB(pLxEvasf z%DPxhbKF?Su9B6MX5i!VTB+7)%b)h!bw{V-8v?LvLAOD1AZbUX9ZlB7AJ7`x)nB~A zIHHvowir{}_-boOz#6eqMJed~bocDcM{uEIah|nM&fW`iT;gx1XRWNMn%Ze7aKQA~ zFT8u`fC}9n(P?#CVb@>nJc0Lj0#=7fY?lf8Mp+FuP2!8g(ttnMbiHMB^M+rnhg4d1 z70UtoLm)TSfZQ5LTTnrO`Jv=U+%_rR8Bf4(M(&Zb4>Y*uhnQMQFhLF#y!4DHxaxq# zk;+i$$xOpmlW)I!6^^ufm6T*KP{g-~#D!iAl@J$)SZozpJjM#CQf=AN#3ZpeLOur3 z^K<)S4Q>3wSGm`oC}suFeSm6uf4V-okn4uten9p&jqfxgI;C&C{ATjU_gBPaR~|+b z=A5th&Yznz26|9pR@NKCX0kk&W}|g<1>#qZ)u`gfJ@jG;%UQ!Kk(qv|4wkg-@TPiB! z_N#l|Xz-z|EW`4s^>81B^CZee6Xr01<4P;ocnE$T6zez2hO)UMMaHejYV@Av^0Trn ztE$5@xxF&#Mp`VFso0f)zBRTE>Q2l6oP@v-n$CuRy$A0*7lGX+7joM;`nYw_${I8E z8Wz-pVaE&O(Jpo&?$5Mq2S^Y*#t^i4(gH zPBH}Uhb=02FDu9+KK>zT^c(E`YY~jtKr(IDEuZi%86h%x&i>rA>$B|%_cs>M-tXSM zD--^;Vg^x|J79+aoV84|LEtxn8Cs!P@3SI{L7GkXzP{3zRXP{1J1#fr^)w@ATW|-_ z$4(K(ix2<;4TorCqMz5PuSedFBsg#)E7gKiLf@2bxyHrpI^m^gY{j9F5w30{1zS>D zC@2=$`Ix+b)CP|A1-UbUnRwaNK&4+shU7q@3G&M>Yc~lA8RfcjnU-ZnM&_-^Pv%<< z4d6q>9l7c{tf=@_K}$=fEpGPv*s(zTzjko%fgAm3-!D+H(`jcu&}|)$f(F5SH=n<$ z5trN6Vh*#=RCOqQ^t*RGknxc7oK=##9-lHp)ciz+KA>>M}IF*^6P3=K(W zJP(B11bITOdMVlBzc9sY6MX*s8Pg=dPnkW}P8R@ZiNvC&7=$Z6)$yDnbhk(0t3jAoTPuW+&>4OK*%?%BiU} z*3)oJ?t<`9NUG_SA?iIdtU3u96noO%IEg8qH zKuwR$KXR&+K$AgZ2s%P2(b~!KUXc?r-){#Hv?lqAeyh=Kw9R6 zX>`zM<50Sk62CcAOmU9b3rDvhMc@M7wb<*R4fzt)v zllJ`J_mj0B3*=@n9C=*qeSySb=irZp0J79dn83|F{z-JHHyt;e@o%G_8+&I|_z>@S z3aLf|7>t!UoLjXy4KwD#1)CkW$N!bo{Kxufb@G1=>&K{gmn^E#aySZqA{`rBfD-QT zO^XIMS6?wOf|MP;S2tr93PuJG^8F$dlE?^0{2c~L4>dD3*jC71go z7-~wF?Q&yRw^f|6{Shu(R_r#Q$AyrzCmfqJ8N1!Yd?PI*gMmemQln-2%ec=~1_sjT z;a7Ef3@j{*KI_{0GpBAhmeWWJ{DakZeAIpY!SHFD z-W(RoSixWoMp;2!kAasv#{rbYP|q=>wi(4EMO#ON&e1qB5ea|)jZBL-47Bxn7M0D!t8Vnl3v7A^5Ny*vLc+J0?QTQ zL?W(%z~CK^2t}UX^NhV<*5i3!)S0e$WKC+ISawrHdaZSoXXiytN2|Agq}1F#ea(lY zB+vr7%P!Yw;^m(Bu{!bMRgjyth+27(f|Ak$UAZH8Ia)Cy?km`nit2Xcne{vr71cwj z^1gElnt0gl7(u*m)5gZ_UL8=<$7>n6an`bGbrx##CqQCb99*d;#&b$aw~3r=R%n*N z2O`(M{0fv!5dkI7;q)ea5(?JQcfiy-TO9?hbHOW^sFTF01yKOJ6u@LRFfdrdFjY_b zGUt3K%nD=G;FeR=^nuv}S?s%mW{O?RDE1zrbsYB!2)wr}za3w$oIS!u%^w5D{lYM3 z;$0AVV;}mz?#gR*s&w6=y_P5fsKcbU3`IamG&@)f!32n5Vdx(bO*EQEVjuZ??-%@1CQwJq`LC+j$@6 zKRj2H0aAao9?KcGP0lH6jFuctRRHhpr)3VE>;SilR_!fRzlrDdjkcm{00&=#37pYN z)nsDYx=28^5qG%>h4?-4pyQ_#q)xxTefQGw`w%6|8Dprq5kfgWt`q6bMtme~1+jYt zkF8V*DSU19?wiQ_hqa$h3jRH$Wf_a@lM#P)oI8Oox*{&{RN&k7~E9>}F;5<$G|M&0c&~3sIhZ|3#T9=L)t;y$@9frq9?a#zLBwe9(C+qt554IHXfI z1eD^DtLe(vilH*~wTNNfN9rH?l)qq9(^pW|qgD5Yw?Ao>t>{QJJIjQr4cdsvFB_ z6*4X7QkY{KWA~B0UJ-A4V~|4c!8cv&_O9(FZ$Hnc}JKvVDUPGJIc!8>jF< z&7GyFRI+lN~_37$JTXD$E%2L!}IZ)gla`V=9pI6IPuarM4j8k1f zelHTV3@mdLQbQPBn(exkuY3RP407Yy)?!P?bc76g66dNs8}Agnwr+>2)zMC3c(y@I zNIB-tuTED=k&u=~x-htX$zr(dL7?!~dpImTEIvLLC%9h%BFU7hBhqD0!sFvpKem6r zzra#gU%zn2B;D6{=WUwsUOb05j8fG0h{m37V{u4Q-Kcx=E=^@_Umx#gx?xEBna0NS zvej22O_ok`uNi5wxyiZMMPvcs_6^L`=B}MLPiSwyIZZaDq!Ca{0V8$h%$bcLoKP~z z58xneQTB=*nr!X$^$U#knKwj4bZ~py_xD`TzCR~gyz_$xsP@uH#`KDzYyfbyJkSnh zdl{HZBL`h*y7VPEGyM`T1u3AWve9#y|ujd&p^qpY-Y#wsp|MF+4E<$ z7cxQ-rnz6mQ=v+`=25xB3@u}mRUTXyn42e%%E_5_?X|yVB%1y7>|&|rwCzK_O!VFJ zXU|5|F1KS3>1|7!GAv#Upe&*@Ha1!z)lL+~O%MYpprlb`-ZOhvqzlj-G;OxNf9MNk zxa8zkerAOirwGxV$s!9~vLYFjk*+WYeSQ5dk&|cm_`Hxf?tM)WT4p!c*>m%zjuD2( z#ANL3ID4!Q>m9COyqenDdILo~a@$DVSuT&%BEnSA&yJniK!5Ps8>@9$Yf3EKn$I6x zf~lA;8$%iJXmcSl0h%>UPdL%I?q~Qxy=^@9JASyIVqZA)_!Pk1CV%+gvF4imw&Pa# zHMQwnVvBrPitSsFpzr{KoQXA1?y>HcvhZ!O~T&3&~ooEo`fd;Jy_{Y1&Of~oA+l8 zRa7nn^`sAoJ~-Tq`Ox0}C>v*Jf!a!|_9ZXm+O3r-o_pO8rx1lKnvD8AlQ^>oKdXX< zmxG4K+vih>dcSjune0R+UK+fC$jhFvum5-5O()CH2#h{|a zKw)0~tJ?u1<2hasz}h)wThK}h9?23nzSPw_jVNIPP!NCZW zS+6!Us|L!@POP;ZoaY*EOGiFwA+~}cnt#(JX1o)54Q0A1+2V$iu^6@a-dz6t`O&4J z()$47n|7sG80II)V2UIq5K8dETZ_XAhJk5hxwO&QGrZ?1t)rGpF-No<8^e8H=eSs2 zpRj-4eK8fr%*#vctEJO**6hSq-bt48B6eYAP6BE$Al=!R#)aX`+z*NRaFjx7XQzB} zN|AzQ%*xqi@O*&a$P(C)2+LVH^X{86fguNWVd1;gv9|up6_eVVjdLocf`Wqgz!C3; zT{shu6*~kkj`z4LEmiw>wOs1ZFr9m&P?;opL~`KFGQH(oXe8T8Yv`fq?Rj*zt0Rw3 zL$ocQ?aS*3KGQ6iwjR6aqtjE1%If=sO<#E*Sg04v_2gp0!@AW~WGaz=mwjBSzQP>FZWwVP$2sympGuS|5LoSBD zrE2F=!D%lI#3nh-R3_IFAm_moHkZ_slQyz$e&k(xGg#hmWS(P zc7)QSNAK6$%EgNhrV0DM{SM*G&hWVaE31}O^?H=!%1CyPghe-hy1(8B`~YS`C4aqX zzWdX&`(bfC64jQfxiv2ky}QJW%x+ReGgSvj%^|{C@=Rzh#o9LAp)Z!{m|65cbNX~g zH#0I7n@ZT(miZR*f@rq!Nx}S<#!4qWnN~uUPOn*89Az?Hs`00%UEQ>-fbgs+8XKpv zRoiFauRc>byB#@OoeQmeJ%_Li?PF)poH^Tk_sA#+8+18tNXW6CZG<}`RgjR-W z{~8U(gH_Oa>?sUukn48SBeh7WQWrOenk2v52XBJa^VS$E4_h%YIt@=ZUH^a}4gpWe z)>gox?_F|tm}8mg0xG}Xyox`@rIbsX=-86fam+5s<#|P2R<4VgXU?AwXZ=#2HgqL4 zZbU+h-wEB5-LGExBpIfK1I9I<-(is@B2zlq(2(C_?lQmGm;M`UY@JS{$V89*GhB|} zO81t+%r0G??|#b~%{(~*4+OD1qQIsSshq8z-qKHj&NnRF+Z0l=v03G}elL2ta^Lhz zWMZLygCoROb`(#<@p~3o4R&oKlqiePEN!9v>sLACOH18g@;%fS3smtg3{WpKf9(&d^@z$=12n^+Z4~23ju4ORf={7*|$}t;Cs1oHEMO zL030nVsc`$UL$wTi!5GFTRW#o(@;`eTygY`0_+v^Dy32{PM(v)VPBvuhsizGTY3kK zA`8joGnH-lOWkDoC<&oZxCbR`X0L-)L%@=xw6uJ+aOw?+77yz7!+M0Z^c!L_fiA*& zVEfEd8})oWJua)a(&NE?*hoSs{!v*LYiQ?+8J!c5I^5gpT?-ePkG85(Hkp5RKgSKG z`?<9E-?L^zYsZ5cmV{Hb4YNZtL`cYg3mNi%$yHMTao9Ids@>#;Z10!Tq2VrDz#k?_ zg%iHS+pwddYp#`WJ)Ls}4L3Nh-t((IjEC+y;+1}7f)LDRPdLMUbFM?<+N=2Nyu>yo zd;2#d`(s)^mkeoltE=YrVq-^+mH;}_$jYCbPdT);THIqlCS#bdd}B%hmr*e;;xT6( zJ5-s9&$sABJX3SD5Iv=nZ7K#y3YD g#*cO1rr#ZRZXP7f+E~x@5dm#s%G?E|b*Q z9J_iM#Zlo@)BPNg;x5__pbksy~fWoa^Sd_ExIF&6&a6`P5{Q>l~lc zM=JNy+=`b6O6|NocMW3+DX#~cmdp>M+)^R42!W*QDK-_(hSKlOGV>>IkmF!UAxBR-2Nz*b6GH!>%bgeB|d4C)yrDRgVQ-* z`3G^{kc?;DQH7ew1XXjN_bYiS1jXwjA}ZD_GFbEu>-N4^uP__6vGGwRcx!Ik+HIfgmi?_~ zJw1=E)IX_ciI7Sx@FBfWWhfmJbMrQ>Z6P!}F7@8fhC6NMacFo12^|;!{Fs`dV${ss z(K66>>xir5YijJb(DLV(l(9(t`kPT~+p{}G*OVKyuQVJQC#4jH)?RS^mXp__<&o>v z(a~Yr#qfZF=Sh0fRD1Ld8&4{-`T1Blh9qNgv86}Jo5Wb>>burl0GBQL-KQphhka-3 z(J7u6GUDda%ymVk$wQTHff5qIUwy>u>gbJ;5;oa^tk$`q*JiorYVjTQ`;l&N< zP!_W&wsXp%4BAOjY^CzF+#0CqQO|wUa@BTjI1X8pBy}5HrSWSRwgt1E9FQj-%32IZ zX<3v%CZnRtHcLI!PTiomUOvng(VR^4);$p^vg!lJhAloL}(qO<3jkS1C z%K`~c!vx#}yWh4%XZsOd_%XA*fewC7tVM*B3`NJvY>IAWek?l%iCL} zUw&`1S7&2CI#o%7bTKP0H#?A090^n7HWgG2rIO8sRyqj|N|li3T58#gavS;0sr7i( zWZ=?Y;8Q{!&&^U#?aF&#N#6kn`xF8cV==UoNoRt`g8J!IZn!l+5!&6TE_CZf#JVor z0Z`@v9*oeo3T@oQ%uwL66l5<00Kn3T6T%frN^W5aYf_o%OJhlq1!-%jIJeea$nodb zz2cRr@ts#=xLN$oI27N_yt)NDbSGz6>%+vvhbGTX2}V?J#r8E9y7LC#zFi z&h~AUPWZP{uhL70`k^~_C4HcrCpF(fpOl(9Cr7KS8MAqVgF_xFA0>Cq3Oo|x;!;YN z4*n4QD?^Ryd3xzs&(YCBj|Ohm-BmaGFN_P_3a3or7_k9}{PGHeCR08g1BEs(s9mS3 zn)FGfPcPpI@TSw^nkJ7-ktx94l4@3AQBv-4ot|0hFiAbH;KM2^<#~X(j}XwRZKF(< z6+X<3+iTMwsM3$FI$Sn$zzp0MLM*3~Fh_Loog#RD+B8GLGP)&&Ew&s^Bf0lVHx23q zNlEkU&dy`})?;@J%L})t9A+*X&133x<|B>b(-w)@bXFCn(>8TeEUAR!}5*LO7nwM}TPuFBo;9Uc2|L(@TS zwLl?k5UFSB9WV>+PLZiL9eYaa8|c^jnVn1=8$2{m#lL`y!vzW-tW-2j{=9v$_a0Ms z_6G55+k{18*)^Q`H6oxhUBywweO48d@pLMy8NJ<>EsyQ-=uzS-Tl39y*y`6u*-Yjx z^q|TGsdJ^fx_!f&H$I81q_b4oj8+mcLj{a1-F$*C>;c41SALra4=8GPR!zNZ@s!X` z`zUk7HUKgj*aH>TodX4-!*A8h5vMW~GBljD6_Tok2^kbI6AftEvPqlN9wQa@0{Q4S zBZnIiBEvbG)mcitY>drM3Yh5VM1hLe0g*81?ZHkgM;mo&W{P&=wurL|xY8?57fsen zw})4kO0HCG7il}Mii9^zHRqDf4R4PqYGyhEYO*93KJ8;Rs8-8fu3;e%r>8{{WKn(a z{sj9-iqK$>nhN@Q&?NNS^Re8Rl^bj~GPdT70g4{B88j!kG=rJB+&jP4?3roT#wXi$ zINF7lL}@~aPtLQY33oIZh3nW4Z^kbb>#NP-8}EX0aw1Lg#a^naPz9SIOMAYJz7JnH z&TU%uAvaVfDEG@tI=)y$WJ>zszTd`YskZs*_0do|049=hqFnv8T{h`iwW>r3#nSTg zdsGH{X)O2rI9%gD^yA(oqcc^M*{T5`PlG9OxU@W2XtMswbny7ZtFv&_*DU2DMT1x? zslwd8c3dS{ikOc7$D9nbMe%_Qm4Kr>6gu(>vLSRX^oJ`*ow)?D<@Op+=i6ZbTX?=o>+k7sP2?c72nNZ2pKMovKaY-DVSwi4xXQ z@-W|GT@8n^eLmlR0|U8*`smz_FJ~WOz|cv#mu=X-V~Uv$cO4qmztPj9I{a|kWy|H; zx9#bE-dd%lXt9Zz>Di1D=jw~Z?n?^`#utY|x{EbRmn%}1c_bl! zoR6H1Yk#@k)-$?XB|{x323#N|Kv)X_wg+L+jT;%Rv%Cxp4{2#>^CPR;RVYJsQv-kC zUx&DNi7KvYFH&;?tB=J7`D)I7Zu~D_VPNBKS<>p5Rfy(z`zeE z;5fWUZ&YZ3)bzCF1O8a0Ef!!UG~Ybu)wkfud4_=C5pAi}2Uo9=JHbNI7D0iA&$naiMkQ=Ml-P==3>FG_G;5BfY(Au+*n@IGbMYss$Wt(>kqH4R+b zUd3FVLtmOapoy=f?h2d>wAEwB<)MVHU&ZUbbRS|LJ0l}3OVX0GPg_d(`fe<|@{_z> zQQcg&@KH}soe2W2a(LR%ds#tq`r2{Zx(*9#Sq6GcYhPu?T9u zI_LFrXD{Hw1;hg}F$_%sO%Hx#jN+m)`G`c4TVu-YR?2i{L z2#iN+tMO&*z-DF&2?i5W9tzqYPodzx2NAMotmeMM^3FO5Y%U#mz6961M8aV*bsrXEGVu0Uh0MLsa7?o4X)RivOwq)Sq#rak3GOn zncuzp?DOYqmxei%_qRwE;JQ0worW_W;55>}f?}bg0gK-`)1@Mo7kaY2ZP&M&f)d{K zDWkVM3OzNos)Koz&_*~8cih&}0VsHhfUrka~29fWJ4sAC=IeUy~ zyalL3HWq+x0^6|(K#3cj>sIqL+rl5f7XPqpJfg`0=z;0bIeJ+^9f-X>$z8d+aEjbx z>koVn;s&dbBgzZPiuJJK-9Ewk$OtOc{^~Ps+l%SS0c?znV$^{ed05ZY=WQY#@s_1> z(4c(@rTY6^Qr2!iyZBI(g89OlDq-F6s-qAUpr|Xg6%jMrd{wsn%q-tEaky;mBjncM z1+$OUf&p+|xFhlUYAifxRC{WCOYc5SRVIQ;U>>mkE_^%eR^F|>4vy2ild{4eG_2wi z;Ix}Nu=%3low`1Ioehh!m7l)jSJoF>*;JOM?P&F%o*@=ns^ox>S5cA+-B-1ah@f$t zh?j}xZn7kjOS`7%vg>k#nOVVIQxnCFFgok?>J?MS!gGMVp~d5oVOi<%Dn--5X4-(=o1&!(dU;TokdTurD&&7;H>>EA;Zwx9rS}< zD|hKIwZ*8MP%t3`Q!)+YP%?>Cc7z%7@Zrt!tq8L^4Ge0tL90h;)3$_twb*hn>x0Ms zCF+?>r`R8DKG?hNTYdVO>ZPnf5^-TdDg8{DlnPo>bQoIlRF~=}5B7++JjX+CB|#5N`)3l|`MC z9MBgI%Qh4|I9GJT-*&Gw2X%(r!+(SSAtu8$-Bs}D{Iyd9Kh{#u0@v!)YsYC46|;k# zbuOo6I{@8P=x|9Q+e4dA&AAnjkuC-D@&ofkJlF@Lp4$$n#%s78Zw&zBXj-rhEEfIw zYWUy0XHFaCvfmOODzEK1f61T1EiTS;=9b6W{6UiiMP>#u>xgGVJadH3dif~kjqbIL zuZi2t(8@%Xtg@@;*+x>kY+#$XVVfu2sFIFMte;y=rA8Nzda~|f z&SNclL==PKQ$>bt^{0#cm98{Q;&a>O>fu~cIad3&(Uo?93h5<`{J(a0Gw1eTtg1c~ zkGg1GdllGe7=b{G(IDTeXnWjU>vgN1%{c{v`viFKHqvM3j}bhr9~VUkx?EL~-gA0i zC<=FOXDBjLahhyy;%sg^wB3?;MqD58AaJ2&_RAUj)D>bB+&c`YMKtGqWRy+0r}|zc zwfo#k_+Z8ER;KGFiY)oYVg2Xl?uXMo(SfFGYsAw<8rT$2#m$ZLZR2BrL`Y|6r$d8< z6EhTt!!SS&_~zDBsM|s?-?rIwTQj``r2EMtxK&4wO6Oo|3p~<00)}4nQ9)5aLX!>xfe=WfLue|Z z0#ZYQbdgRdQbGys%%FR%z25hHJbRpR7&;t-#5;H9J?B;a^SXZ1qV}L&B;#$V9q%k? zF(81okFpvyJK^(hYpJ89uO~ln-W`c5SC1y}@149MFK=apO-Ck7Uf$c9V4x~vVAIsp z(;5?z6`0h?9GnSMr1dnxF!YhVQ!eCGMvI1^e31I|9qeyD1HLC$X;|6_g<2GsU1Oz+ z?m(`azZQ;=GJ7~T3`>Uj)Drx$dnPnTF?S(2_G!y@kdoHx_|e&WP! zGwM{D>d*qY&$Fk}4_lu>3xPfh;tUeS&C}EhEgf1r>r2AA_nq^X=XU8x%}PWdiujwh zGc5Qjd%8KBL2%YyVK;LwbpP4%NqaC-CS^@#PO&U#AQkG9@+3i(1xMm&PVSYE{gvAa z_kr}Hn^5IpNZr#u%fQeNhQWDZ)|aXbjqSZNL#%5NEn2?t&9=2;O@Zb}6-d1bthgZH zXeSYF2+$l~Pzw;Kk$0|Gmw~HmU0c}1N9>j3s=zaYY?)UNcMsGr+_-%k0=3$(l*url zY{-r6y$5Jx`#_6fO3oV{mA8$CQ5VE)dc|b9s@XYu)owQ-odgH%%qLGHOwE&=%NI*0lBZ9+&7YEWVJtU6{ zAaJ00F2_1_Pc`3vHt(O0yB1D3hRJ}h;nW8pAn4WrH_0{apSa+>F!3+N_L?zQJn-%# z5@hbp&(TfuqdQB+1u?Km0e`ltrev@w2hQ5A+{nK?xtBNOxt#_MY0H*d&g6%<4qUe| zZ^B?Jvsk~boMvEv?rh8rHil}IY~F}AfyJu-RmxD&1a!!MZ0sODr*vu&XJusSDnnX& zoBi0=*48S6$ZZyKj;nf6WsZwQ*~<^9G8|Y?3`2A0CId7K{WhkXM}HlEq70^DX;hUPRcV`w%Pc@t!a991IuynT9YoudnaE#7a!eE#~93+hkMP^|odg66H$ zlL5ys?kMkote@tKW;f5jq|n0im!~wrFCR^yP)UMRfi#8>oZb58=Rv~%Te|8WAvyK_ zRidi8e*Xse8p=ilY0BqA?YFy_T7!JEeS z?>vSR3|ePLKn(Z%)tm44{;g7xbxtnoP{+RSoN(v zF;>FKaFb|@3U^fD6(Rf7S4`j`E3Zwh1XN((=|4Mhf@q@7lk4wKddnq>7_8!=3g(X- zTW`^+s>wQt>3}kob{yqARo;(&3B7Ztv90}>Ruolh*P(8{3R$WN`s>Af*u{GYVN5GAmh{2VgR)mX3&fWf1XQV13dU$ zDP|Ge+9PC9>3THee_GB@ZTV?RY zGq(benYH(y+e$U&oT-*~g9X2$?|H@N==$Jc(rE3klMR2vLa$rx7LLmB!D`1kh<%Y) z%==BD$yJY~i96_c<=D{d#h7Zkj)3_i^lqibdREdZ9A;2-TX6N@N71RJZ$vCw2_NY@ z;}WQ_L=kTCZ{)4$BJ{^vzdhAhg((sKRW%_&nwpzu;`c}i&&LE_9~#V#in^*{7?-4^ z1Sy}k9NK!-K&IDO98btg#d7LQvJCy`Z?ypXT=;?9&xH;zuY&3xm}Ql{TmKRpBJa~D zNl@HlU}$)a@$%$c^Y*eE*o!2>Xq-RBfTPY(3HOb};l1a{u2Ttjxf3T{$(vXb*@3k5mFdkE+6?-X?HLh_CUT@=Bvd}oTOh@~JOw9NA zD~7y3&)sdu;aoRy6J8_Bt%-@&a?^c)rUY;PP%5}MJ8H znk7BR zYCcmAbQ(Qlk|wpH*x#bWK3iH!y>@T-RiGWM;Dun{n*Y%|c(G4WRX{jlf$h}nKP+WE zadxL}j0hj@pIF(&iq(x!)t;}5!u_-&3TRL(V3B4Flxg*bU%ll%b?p)$j&_9~ljiNk z)R`FVeA2{ZSnU3!(_zm-ota_ipCmbw;!7M1?WJI0J2&aeJ-wHM=m$`53LY2X)ak9~DZxgz$NVqYVNsK2;YLV5Y)Q^BPp;jQY2xsdN?BUcG!> z+m5J?N@qE1FeHx4(Rl+7bsm16d3Gl-j(CMItV>*T>H7;_F*QGvI(jOOnMKY6hsg?g zEUHd#SobsE!e><{ahdQ;(9fb;`qNWdtPysLRVZ{xMhN4xZ(_7ED%3&z>3_vFKD-qD zAma)y$klL+c$QWKkMw6MdaH5Ie)Rz?Y^0;n_g&IjQP%*p&`mp~DrD{PS-q4TW+M?o z4NI)c$Y4yv90aC>`k5+fEyiAN9*VG?dZ-ce{R4|^u`NuMuB}3_KwHReP(ac)N72eq z-@yx&8nkFKKX@HVD$m=hneTs1f!VqJP-2MW@x-qd`i9P|xtMge%BIua4&|MjM~7pz zI+U;2UE^SYUP116vV>I) z=2!KD;@_SKdUFCXLvdXj)Rq|e`L)Oy4mO21wY9bNRkpW+{7=dL8jX$-s1AB|!UQ`a zL3>#HX1bP~B=MsDo|qR4GQct}X?I6+gnY+u$_b29ZsU$u(qOub6<>h`uGlA8 z=2%w)f`GsgD}TWgy-Fp{&;h2a1!6l${))d7n`{DWx|G|)ii*aU>6j(7s;#{rRH4;+CfP)e5QjP{OG{Fb5$A>c^yCvRXWBWe4X$^7Z>;8ibgH?c+8mC3~0D&#l(w! zi}OTF_Giy{yu&0J?@nt`g0R>p(hsy-dd+wW3Iv53GA^PkF=nH%*4vEj=`4Z3&+HWN zvk>`U{2oS$M33jZ!|UmpHFoue=LRHShibaSa}dh?_4>ab8A%`toAA%=N%+jWE9`uK zNJirV>94DQ>l4%K?0pJePRhhocs9egGh$uM=()rb!(J?fQ;z6d6T1f+DiFwr;V98> zkmh=d1umgQ6(73&Y-i?>yMmonepAL$J}Q2HC;s3-%)M^aK-xc#9PuEkiZ#|ozW zb90(*{kXOm?g26JnO1X_p)b|36^bdTelzi@*5plx&c1Ih$+Q2sh>>?bm?Uw${kf&r zn;q5UGJAQ%ckGu+JJ+YYA~&6Iy_VH=W0Q#Y2SIXl4bXC=Ly-+(u~(#LPfw|Ud1gD- ze8@PT+}hVCH|^TVm^1_D;h!FEW-qr;b#(oF$yZ|S=lFc`(o3EGBk|%Br8DAg+K+N= zk8O{@0~83O$>1KfmXUX6I(lDru{T<&Pd;J}`r87DLw<3c;qzUO!6rPQFUrzu9P6>+ zDp1HyW=}^}6zK?#)^SmwRo8Y3YH{Jt>SJy?80$NAjw$m=3$M?H_aG99@FRoJJkf28 z2BV&Eo=%u?m!c%z|6CP1$XWpfW`?S0R-ZyL{bmzG=$G{YKF2<30pZtGFBXfejVuHu z6ksp*x9;(>2Q|dy38BN|vT?%ND@(6_g|kMP;Ur^Hawu*gl*)4bRcMBR;c-xj_w&6GGZD}Em(t~0G_jY#Zu4&NVB7l+xr^bYGPcf;jZ%P0p3RJERF<>hK$0GR4F%&D#QMRa(CWioVc4=$~%*?(fQlc2yDI=KFjd`(PCZ#a%! zxwVGITJNvWkIIxhi8D1>7He)H8>1KI|6ZK2JlJpk1d@s$_fFqv%}Big85sPP1BX3Z zuJF@J;f}P84~Z`#w01M6%HD)*?B)lJSFNNzxR3m-8>p*mg^-S;6 ziNm;u`iyapw%L-fEqp{M>cvbJ7x2w8%-jF`CC)6y#;fl%qg0sOfDVm)y{s=QmtW(Ge#}J;k&=u z)><7ix|EfoqYha_j zR|cy6oJ>Edx9a1iRK>8G(G{h?-i>>Vm8N=xP6kX}ANzE_RYknEE!w*YqLOf(-)kV` zfP|j^ZezzKSD-bfh&DHha9gN2wXOo|eAa0sUUl$cv+F6Xn8bJ)Gv%*3Z4e}uCiYLr zTJg<@bg$lpl!%HKTi8w=wOMTnKsAOe-ddi^?Y>@=PsdEH5s_z)g;!?oHSv+Zl_!zV z+@RRsW2g*NgaQqbNT50Y?v4wjOiN%CSFsA=LI3oUbSvNn7-A@?O%q+9e*nX}Pp zTr_vccVOLk`ND!NM=zkmBbin7JNIiv7oDSv1;h;&X!V@mted>>3J5O?n`jWj``(Gq zyPQqAwT(bB>%8o*qaLd`lz|tRzjgnMS$VNf;bn#f+J>PR;AN{(Y)A48u?9cIxP>^0q zgLN9d>=ycq-k&HwB_WV%`ATKWsQjO{HX%wiP6%Erc?fE z{q;4Le4DpB2a*t%4N;GP9R|vTTck+F54o&7p{x<_UkxC?a#Sc&4n$nsv8Q-B3U|AV zup-LHD@yF$KO0sX{KwMAy1;FafR|WgD3_Qi4NMgi zH8D&fhO9hQI&w>|9P_nrlD`SR5H*o!6}n0mVAP7zUT_{jRZP8nf~^jivKpaK3~RZ0 z{Mf>Nr5CCX;Zh2CNKxD^Mg7c-{U7&Phzh2Ln56KPjQoa}E(yOcM@M{@t%L>yQ8gMZ za2Y0IN6$KKB&lp{FK4iFt;L~HlB-+|@II4F1|(7QY{Yv{ij;pEkb;?k z{g*!dSL-6vsODp16@J+t%ah05pZ5-J$sRzSaP+00%97t&{zh!<^t(IH$rT)%2lYX4 zw+>9j5;nJYmV9vBs@0g#JnbO2vD|>Va-kQ=H%q>|Gkbg=ItXyE_a8AMZ^{RtakA~) zEds5E7USJ<@@p0M3%Ggs$=wChZqouqjj^H!9*~;cLA$4eY5DZQXklsNe#u6}$}D4zwUeyLMJyotESz>r zT-`JKz7iWJ65qJ9T?i?B6z)%hE%+H)>-J>I%&Ch2z7aug%*isw1fjO?5rtFJ3>;I+ zw#-xt`Df?Hb^=;RP>38IzWSy7r=z2D(Q<=jjk%kUj?(w@&K~v!YJS>@2_={ZH6xnnX5?=@;ydEf9?CX#b3tz*MHVDoDRt7)$AoMuMg@Gi6*S=ZVQj!&O7MM zhX_kgE!?t7wvp1>RNBg85BF=dE=$@(wZjd25mJr#E0Eg_f{pf|NiK*R(nerdKDBiM zqEOQY`t}yREuj!Z=T*O?PFBf}VA>g*PS@r8*SU>ep_#ufD%p&i)yIe~mJ6fxlS!T+ z@Stt7p5GZ}k=GJwkcav%y+OIeM+)XoGYoT~+sDjLsS~QPI`6-@)F3WRl2nQ@qmehl zhQ=Zbb1inBwyah7MS|yAighr_4(&~4EzPpnaVuWnGr6E4|MMnQ1ZUMd!d)vRSltc1 zCR^$A^pO$&h-e?$AE%U)T9nzU3vp;0@p10JH~VfKoQ<>{qPTuy+hr0|hoo4wI3#ju z9d)SQ4wJPo-%R0l3QV!$afp1SQJ5UXbv4s|TLGncHWBp+iZHcp+HB-OxgMQh*=L$`)L4G*qE+(;?317<=oavHhFn zCR#^Up+LKL)@dNfmD8Nqt*7YV>E5=TqbyXNlCm z)u9p^@E=T}Ykn=yJ+@u%jwWR!nmNZ_Q4om5M zH#!o^MS?bleWicfwbJ;RxMKDETi+|b(e8^P7MX0yK6?+!Z2DJA z5Ek~%X2?9nW`f}B$peGI%JxlpP1}DQ*pDa$Ydl}rNJXP~dA2=&_%AE2PNHe_(>VNg zFj=K%Mu2f)iC?-#POVchL6R{|xOKgz)cm>4hMbmbzC7xPUJ70R_m@udD@ zx-#MQ;g=oaWM5^Vf|o)JefPz!=6zARkfh1BUWUgp)5YsAo2(yV!UFoBTuZOR@s4h# z@N%y2CO@>kyKldX*n_=6onacyW-7jB^1ZyPA5ta95co|vN42FQAdJyNs>z^v`Pbgg zL_0ysdy9is;f6_^-?l6+_$FHSQIws7zlE1Q;_@X=^M~4W{m<;gF1rZ!A__3;1k1*S zi#knHFb~v}+FR={?nZGwJT7DYxTc62?V4LgMjRIQBlG9g_eUN#v5%Gd36z$T&Ey!( zC!)1MN*s)s4oMRnz)Os8SnysiGWJ&F;qRe*cePjNseGL$x;SPswbgg)pBfvhzb@%& zvc%^+tTV1(krS%MpiSadlY|JX4qBDF+v*{)$J8C2KN3vZ9?&%yUkaAa|G2#V3En8X z7mwY~*q09X6|xDCx$Gj8mOj6(bKIn?%h0bt*n`Anxm^5hgRs98`hrsFuZba0ezpv% zec@Pkb06t^_I0g`@Q!${wrs|Qm@s}AuhuR3r&jj)Fj*&)^0@geMZzjAgk=bon-9ox zTq?ICb@n-~O-%_;&CKv~en@_Yc?rrQr>2)oK$S0?k>+^umeJU(WpMR{RO^Xkf-dYq zkpBSBREeej&WsBTQwLwjnhxE2>NqCdDrM8m!QL&`?$_q<(xi#Dpl{oyO?EE>{=hhN zXYhDPx&Q?#vCbLviMX0DFurXat5V8mzVoy>@w;Z@hciih0>w%k*p2N-KCYm_RL1_N}IqXlQEZtn*wtw8BH`o)LPaCeLl2 zP0y9cfpmV8zwEjk=2=-4$Axrxr}Vh8zENzG@D*j9V)QT&DdJd(k~ckuG||dN>agWJ zB+;l>@ABC9N>r7V7;#0i?)w|}cP6_FZL4Z278_>f>V?Bg^1+d1G3FbfBnoQyFhb2V zIyapq7@vzfNMcTXkf$zpi~=TS=9A@ienJd<@{M`W#?*%Ee8e95jDT&q`hKUbr;Rr$BOujq-6lcE}g}bW<-_3zY%)`qqAhg)M(2Knm zM!;S>Cv>duc0)M;qf`KZ1WACVFm1t!JYIGkf?^5WagQ#Rq*pFJIr6Jecz)rvl{sZS zI(6Ff7rGrT^<&=!@p<%D;j}!t5V?|G!oW^DP-@XdYO7PZxUYWX{BX-M^Ih^c?XyW+jRwZ#a`F zrupPl#@oEvq^K9Clbbnf{cd)P`8Q?T2&x|k9BBC4lRR>XeZlDw=|K@{(W!-6Y88eC zjYgf%MLo8sO@sz-df1HXf0ki(jhEHPJ(Y*jan*C6OUrZnLT{*P=*E1_x@VX11bnc- z%>-lE$%;AWQRnvQYo;b-;cezIQ3-OCHe5%;wEZ7dN)vVu|H-n}v<==XO|R*JlHB{u z&n0t*jq<8r0vcmnZ_W$0>*^&$ocDcfhU%+w#fw!e;cT+HBSV#@1?(!~t5Q%G`(*A) z7xV0vE|ET7$h?9slYew#`z6d$vl`mSwhRZ%oRsc2{XG7u(4C4U>)C@e$!e2>HL=Sa zJ(~QB_&(C4nUF=9uB()G{K?9AuJB6h{X)&veA_^msw+(s2caqD;!YMwQ3}~;NXX0C zK&Y7qhHmTQ^nGq;+ z?Z;qsWh=AaHsiH zZp|@M9+Y!0_H~`=6@MEp*TT)vTRUT&N88n8%#=A|#3Scl3Z@QxCVU)d1+uxd)h2+ewyTOa9J6RE}Z|oWok)@=P zoOMwojUUyv)AUCVm%pGOG5<|i(;W{};qB_4wAO{xQkJ%d$lH!%*do25D7Pr?KwM1k zulRHy-gRTmAfjEelv{uQ^NC&u>#B?~2%X>W;jdRRORC!8kVSZxM#aCo z8dbzMq*CTt9OB)`bvUOFnzgQbbj2HYLqX2QUeFloN&3J-kTAW?rpE94UO&T|C=Cno z4CimUr|Xp1_2W@&d_|~b!pU@kk$35cgsoYk;ytNIE6Fr>;=YbVuUH@VKt+)c(XQ6#AeFZBAb=nwg5FG zrLzEB#6hH!`0)!E1sf9=%D_#XI)4oITmd&q!HF#D33ba*oSIOC^q2+%DFtrX{u;U$5+D546)i6s*GRC2zTbYA!-5}f()S1^4Fnh zQK89;CdBceFis(`~KSFqfwW1`?1J5@Ic5pC*w zdzb)2j`U>APcJ98)dt$jDZ@H*-iAve=*oN|(>QpuvCG={AgdbsVLm^pyD9(5<2@b4 zxYm(`q6L~5twq~jv4r{JsQ^N@aCnwU%d!CNjiku4lm7j48rh|ACYlR$~Toa%{?B}&(w6F%CcUgBF5Tu{p-aq$gN6^1Q^ zU+%8e_a32}+%r!m*~g{?O)rgW-n7a)B`mkD^?rh%C!g9zmYXDG3qTl>RDhJ6zen=@ zR84K?5>TEC+Kvpu?qn)bwp2U@esX+d$Tt7o4y&%Xocq?|EBm~@_sRu~e`V3END_OM zp0^pic8MJoZjn>g6!NqQEu8f@smb@d(3-g2Bcp4h?3lT({_c%8n~QddL^;#INDm{< z_Y=n3GC`o_g7Bat#2b0C@<#8^Q(rhJ`9W+uPam&C+zboCTqW@0PNUrUgpC2V2jJl< z8v)Ko0=hzbXT!Yd4i=n`JyP;ArZ5b$q|zsGfuMZ?A$?r;4L5z79~v2>(TmmF(=AtA z87o$EbRHaYa&s?Iv7EL+xn&m0JXYA~+)gFdX}nxc%Ns~ajguy(wn<2uaxDkw;&-GI zHwoIXjUV@2yV&^-3!b{?=D(xLEvjB6ajGCD6QR#eY+F=^l{8xKGREs1?dX1?acCP7?aTJ3NmUw|3 zVjylBCqrhf1ttBdMZ8IqYRVcuxp5F?G0Sr7680(tbMb)d)49k6$<|7{M)s7A_c^)n zM?t?r`G00TxEUTdZ6&9b)pvh=VCC=ffy+!xeAPp__4QV@Bc5RScASPRO<>J=YxnlT zAwCWrgmoqPp@8^LC{VbB0fkFKHnkN#5YBT0iwG+@a%;Ml_!rr;Y@qQtIGU%G?fa*A zY01I$zDLfnRmC=W)Q$cAqkLB5BDCwRMMo=Nc>;u#5Tj>&lphw~+r^Gw+^jFEB+@?$ zf|x8nZnzBp3o6$y(v2_Y=>EvnwdgktObTe{bOR)VzR{BpSot#VJxf{)E^3%~R0a*p zZc!J$Gb&y&hdR6l?t7ykH-sU$ec$S4RzTch{<RvAHUG}KOMYEv$GYfu9p;O0iy26j+n$Pu&t*q*kgm>*c>HNyEpu28c+ZY!U<~JGZlgb6%{|=NSdIwl-f29{H}q8 zg}SQRJ&QEzRMk0o$Z_~_9PskajwtN-0luQjAP)YLyOrHG8DMbwC*p=+m`_jdVeXBDw{}K`xX2W_&$Hl{w7VZ zC|jYA>!jZ@r}o-_5*a#=kt)@fP3C#&=_66kpX-|i)BrS&v6-3kNQEiq#(9~$Y*ZYQ zh(BnBpGT|O%yx-+^@8F(BWvr-KNn_(cnoc4hThA)$iz{gAQKGc-q#ENeOgK+*YI$2 zyS7hv5L+UjN4ata7peec1E@K@a^(sVU=Ola0AA<3<#SLl&%=26igWL$my|=&+ z(um)l?KxOC1S`)QX)HglggiF~3+BU%niB=n7po(*eW22I-_2RVJCE=EYTg8M#fM5L z0t^DL`t35n?zBQA5F4L>rkA*n&COKcjw^XSkvO8UU&aHD!7w>6I#uLb;8`}LvflG$ znY70+W&(N`D`i~u4bC|N3r#d}wtsH&;4j?|kHHa0KQGItsuTl0NtzE2c%<*oh(CDm zf&*PlhkOZMSt8B?L50Yrr^BLN#2DPY`&GyHWmg-8iIX`(;)lD{msnY zG;aIFQQ-vu`&nLj-!2INdhWb9Q&Q4Ft%A;0KV+gvKR$bw7IZ)Y?$rerImdbc0V^(7 zOD`z}OBR%04_Hd_2eTM# z>5}u`OUu<_*|9G!3F~7snE_t%$!PEan}b71wdX$;fcFnUv`>{`?sBOV|1qyrqu0Y~ z3n*a!Ur5FC)Zu7jUsU)&-+x$Yup}gmb(WGqLBFu@9niuJ=tJt(%Q>*M*RRh5jzrrP zTO-}hB@4dT;88H6OX&h;05PuB}pz|~p0ZPI)-QaWb zFM-Sg00`AEf$HW{2|tp!!S@C095me$?r&1jG~y@zXRtJ>(JKt}MlY*$Nw(lqXq3+% z7WSu}XcnJ*6{~;m;Txc?gP*^i9~z~Of9|t1W=W16wkas%m8o-2oEE9n>Oq^ca|qVa zIpZG)h!N(6S3h`k?@;?h9`QaK0UsRt7#_AV5*u4+nfwD*G@JcCST%cK_Q&1Rr)RBiqMM6S!hWv31LP zXuxPIf?N{mHRlpNv^6XV_bE%C=nro<&4oqOJ%a8wm;l`YeLKQfXsn`-nksb>yL_0* znjP|LBKmeI0lbMJnG{@9DFdd~6H!5RA7AxzG|HjONPCtDEUT0`cs^VP%iNp$2-{Xt zV)J;Rl_SHMxcgT@uj4xlOE7s(&NN-X-mnBA#eCp9vS|Tnt{Ei!UIo@@#IYUnSnO!EBEu>Jq!it@^(Nac%ADYQ7V!83pQ<{~Z6W?}*tML`DHh&i01ip{-$0eRKY_#Y zG!PrhV_vXlY7u4`W-BmTg701RT9{`^h@4ii)TCuv-}6I9#QNOmm-D&Os8Z{U;+V|T8NY_A>O0Z#8O|Ws=Qw9CuB~|oCnV2~Izj=*5*!_2q zK+jfP@fg7IM9}NqWsO0*F*-y-p{mN4#d{!tL{C338U*(4l3=NuAUXZJ!BjrDpWud# zU5mdx47tGZkI#*$E;3i)OV0oqRX%jzvKwX2K70jXne3^On zXK1p$3;hwnQ*91WFJ2J(1Pk~9P!zC)aO1c%xX)%L1>PLw;KUKg4W{?|7q)|;BkXl0 z)(oZKf)G*e6r@+cHJSgKWR}bI7=Xh=>1N2fb*kvi*B;cr73;c+0#qzCm5TNIk(Who zA%-~jv%qp$(oUP}@(yMO%iLLfJ_GpIk)ZLG1LxJ23HTzt(fSu9z5ea^FU}id%f?}0 ze_x`S#q=AToQ>DK1&WT)=!Zviymq0G5?@c8q!GUeMjV=$(O?c5D-c7ARTwa*oi78c z6!~4AXaY>Ea>RX&swhJqd#d?pzJ1u*B<{z#&t2X8nI0@4vcq?}lzj*v{gaD-gH`+Z zx8V|KOSlDAAuvrkt?yD^0V^afKy?+$<$ss&gb!YYp9J=g>^%I;A4!(B{`gfR$6`y7SvhaPGh06GV(qhZUI6xi0R*QMvNx zUe`8*?$Z6a>fDaL1l^OHz})rxv9Q6F~b@KQ}t$U0}ddJo)nmybbb` zr`@4vaCn29l$az3qyU56?fl1YJa6i^yF|6Q^X(N7>%b{^a43%!82{tczQsq5AFlj7 zaM8yc2g4|;tr7veuU6$n8s*$Sw+=>1hwA@+ID_-21LY3~nf>>TpZ|$%@rbwN%-O#W zzS>`ZBVE2;v28P2iW|0W%|3n=Oy56uXbD_bvtaY*uVUaP+TJlEI;7_EuvTZX3jX~p zLF4Z*vY$)rX`0XBn^HvSRhE3P@>ABD;5JzfO)qe*=>dl9DZJHFz-=VDZ1HBU*C_nQ zbI0C<{!D_@UZgH0$FJ|0S8)xiLG_b0U|JpKO5HcVyYFYMwiVy#2L9`)V`_vKcl8&+ zSj)q!undm_vEA{5xI$xAMC1#;Bf!Tri`%D0)K9SoDzH=iqS})`b8kAeqP64DyM4Gt z->QTdBE`K41jBCjAQBkg)DvkPq#gd)S5dEkr#k)SzL@>swjp#-t>k)T!JjJt#5RU}FG?#EQod-aw zUM5;40>HNQMlrT00K)Ez7cYP*FY=wiM4gW94qk33>9-DtEO!PQt&Ik&fV5U2c*8U# zMu}7{7UI*tY&w)(3{gV$KYBz6g&v^%jf|w}zGj-no z{`TLsvF8$oxDPbMvvV#lix5BSTm#9uBuEyu5QCL+5GpvdACp1ldHU6GM=}awWjTdI_|#5}+>|yR)1|^O$B73+n6TNxYyYI7;M&!W82~ z&9?jr8u4>#hC_ardt9IX{5erUb?>)XWd4<>qH-oSKGF*H;X)z@D`m4+7_y2bY!=>0 z-l1oa_2kn88Df?Ds5>m=IXJ_hEK(LoD)ulF5i0%pM7*#;NXXmK5RyY^rE^ZbH5Laa z<$%Bq(Qbn59}7?gE$8tdx2)>PTN5$1wRLMCZ=k7NZ6sj{YF6sJ>YxdMm;jZ4SPUxx zWF>7uQ(-*7<`#GGK)?weQP1Tc+6VXo&Ymzt0C18Hvnk#5H|GpogI(+EJ!9$8P`lAP z733jSw{n&X|I(DAg-jhBgcC0_wNHho{xSnc9f1G@8Mga6WayIl3G#i zu)d_ke~*Yfmb7$LnWhTuNPD;+V|;D{U$|?J^>lm78L(V$&G?<9=kyNxcb_^4g@RKd z@ur$&PNWP{%K2e{e74!gp6{rOqrdohu2FBON z$B&;^Rt+d@qI6@yQv4`z)*ir8b$Kq1Sgy^sg8QSA?bE!N=9V}2bQl!HEw4#B&gJ>B zCA{e#9Au?A>O^TztWjt@kh&^%ipH5WMxd1qAU;#VYgLx(x8tbMzE?fvF%lN~#9eYM zPZvZZ(a&50Oe~g26zK(G<@*=$01!{*VpMzbxy|)*0Ir1}e9@;&G-%TZQ0D>p8<5Cm zTnY1uK8eYs^wOERZ(@MdbwownaXo-auHL2Q=7TOHl~m45+n7~;O7$=bADNCa1$_Md zymJ6c)DJ@WL{?|k*tVmmbwOsh2;Xt@*=c%oj3zs0;CFS&NpQ5%9N=ia%~S{?#p@lQ z!O6i8>NysZ6?j10GO!C(J}!J+^esfGt=srNLQh(ecjy2wl;MOXdA#VJhjl~O;Bg7( z*_w;0hHo!SVmc#D+$%W@-;T zBMY-F{AY#pgmHTnfRPTDMGhDv!j*%iSholHe_j^`2TKU9f8Kr&Fk4FtN74bA|dd%5kzcnp^D z$Ylep9oXamfIuQR`ye5{JngvDBfF2{I<2=RQ8%Hs9w3Zu2I0TlZB9u3DNUd(wgx#Y z$&Vbw%25B^bNRdodIbL@dXh#0LTe+@atp(WAlZXP@PmZ1+V&@8CGad*DMbArS6P{DVdt?39YQyvSk!?zT8;1z7hgh-L}n$)%r#W@qEX?8Ha`rG}JYR%5) zB*fFsQl}9IqBzg9B%!)i`8G-@Aq`dt=kO@||5+hdpMJU4&>^94qo5$Zy~WI-iu)?2 zl~apD{@oe=UB-SJabB18%cn(Kjf_-=|6#a&xCbF&KTOx$UEq~MnH8%>#(X1;G5O)w z7?vv}Rp?nnJ^3y|Jk2B`(|VErm}N+_>FSx@O*S2@yKPg-S7{vPmqSEMdK&&~GE?(8 z5)5PC{P`wOW&zO0Zb}rCVgcE#sD3yf*g01!w1Fk+z9v#$z@OPCSm)XIVj+;T#a%^; zJo_QExmD!7)1C}Ok#6v)_Q!sTBqnE}wM1$SbJb!DzN`!5rn<@#09$1&^q}Lu7Dzv6 z(lsJF68N!Jp0UH$Dt?ibAT^gpM7`is@Wj?@%blTdz6Y+<**RJquC)IyYJ+i(;^x(> z!k~y$WDX^RdK$u-$o>~#R)H+?MzU4B-Y5B*PcW6eXaWM%M~)p8%m~iFVQc1npTEHr zJ_*t{t=_UJrMbatNar>aCQ@v8CI-S3gTJJwAW%Kz;Xws8JfOovF`tAIgS7`#ib0qQ zzFq`>AblWEftcHCeW*)A6WQ^Lr?#D^ni>z%^hJ(m;otgj|5ir4 zwW(qYO>_!STc#50tOPb$s3CebJ6+nGAoS26!B7sp{b3cVUMpL4rB6f z;@qu*UbV}<2~>6H^KYeVRXdFn|GKR`RHC-y{GpbUcz=zjQUL__4IxQKU*lfMLK-@k z^SW{O!jX;#@Sq-%gY^je|UON=>=hKqkZzA@2z?yGA}B{hycd%-#l#i+=@X^3I1x=-S@v$qcgRG6{$ z%^B}tAdyd%Ty5?67O!0H@Fqe#%?sh5l6SS|UBIcMK-cZ^+>D;wr~yY_*oy^LvCuri z-O^EspbPw8jC}=AmEE`gAw;@Cx;rGKLpmj;yBjI#F6lg^ga{}dA|l--AS%+`BHdm8 zef0b8{oR@W+_{W1I_i1PyZ2u4tY@vg)-7eeaWzLfAkM(5loa?ZoYYA%pc%s8u>fjqcfnZn-VlX^2o|&dSes^r&aJl% zFuphm20>s-3}Sl!Drwj5sV_Zj%k_K1KSeCF+92}KIe}Yn;wg`CSGL`o=OYZAsvQd$ zU`Mr{@w`FGzOJr}>bCF-oNM>rz!0{)}~t(%9g znyy~wXi)5sj8jJmD)&@EB(*AX|2wGrY5mZ6oR8ogTQ=z<&7 zIKmBKIAd5qH!&NXmW0Sz;?LrNXc?_X7_LK^6P2v<5Fu19pJR#(TFS1pxc&-`iIG$H z34Jp-&v~GmwnvhVZL_ZR25yaX*~@3jseqV=H_w8iSFfF>v6hw$D5sO!wkZJ)hI07D z&w5#ezX4zi=(L!o;Nix%aFnc=si*f;2 z(}WW9$7qSo;GGcoLw;4c{Zz;v(16=FP%!S*xDVA=&k(Yk(c#Gk?d9-lMpL=ix`SXmjrHm+8Z%?2X^1V&SJpp(04El?5T zfrIBMq_%xZqx^^O(4~-wWqCLkLV?2=sGUalX=%HE%$g#J?zL_)2@+yol(IQquUB4( zrv;jLW*EtRrQy z))p8>&z>)eORel-!t7K+QW$OHkWrgee*X9@px$RLadj5}T@xRJvQhEpScj7)cUdi9 zw(TF85y@t5yggrgZ`GDZO+B6kKGc0^gT(@!118>BJ@S$5H~)1-f0IC0c5x|ThCdz9 z+rJ0uQhqgf%Uazq(?kOHL}JZPE8Cvc(Ekb{M?oU^~2+62;z%`|$F#sIYarGaML z8X-7~UqjYkw$nt`*APYy5`+eF)6=U!k424%>UP_pfxvBhSfaruOUvHvTJEi22`mM* zbaU$2dUs_KF{zV~O~wx_Z4ou_C0>pDLmY3Z$+e)fAciRz$QZDGa=K}AOb@G~36^E* z`IXkcc>eepM1r&Bpfeq$4)`1(mTm1vj0#R~r-6}od-ldH@hkSI$po@3k=*H?FlZEb zy7M|8>t0wDba4iEiGjzLjIt|f0WjbXWeM_%1FSwQ)^2Au^?-}!F^K@JBol{NyG?+$ zFacb`$iQGXmx(gd;2O5zyW#O?J+j?AlqZe{-V(|Pa0`wgxY6L?bzyuUKU+-@L`bVo?gTLohgDyvRVbgFqo|Y9x#Kd1e!39bcJIFyJ=tvGcF@q}v7EyMQ_U#03kso0NhR#r z{05IGX;{i$?c`&ELMJ_){OIVYs3f}G#qTXr@#Hl^T)s;38Bd-{vMyZ8^a|2%2{9c(K1@?3ME`5TJ!qzjyaChEUanG~KMzCqBx{N~%Jc!RejZZBOU^acz|a7#n^s76bW$N?yrUB}|Fgl;BX8@gR z{H3{^OwTJ&1%WpBX=V4+ZI`2-@5Ka(R7FC4A9SrsrxE%)oy)Cx9yaX-HhW;%CIQ6g z#RE=WB@P)*pxM}FOpLwRJS^WQky%viwxXcGa-M~nZwP3v5H1YB=^J~EyV18v(u163 z7UQTj$bk76Qh;9|Eth$!_yoRRx^*D{3<)(c^6kCM@*fdQyWhL*&t+kruEu(rQ%o8d zlm@2F+yDKF@J!iW(MGy~Ro=A^FLf{>;#5l6Ao~i&bc#^iKP>AvNy$#sc&i7}g#dXv zH|i|7E%v0WHH;*AgY(Ong`q>6r|Bht!7f(?ENt7JF5CUa;`C-f6>@Gv?6+8i1ouIK@XOgcw6&vx`m}0y5r#`8nEty8v9eb zwPCSKNxXBYpaw;~+yVf6t>`OAS+z0Sq3$j;`rT_~!4Xohm*w%{8!dEm9tUXxM`|Sz zkg%ar3c`R_P5Ws=aH>cIY=bJnguiON;}^d)fF_7+qAdHD-0CPYIf zNO8cBiU5esy>@*BM(dEk{qqUpH}>m_gYyxRl4YMEBr2fB&8guI%l9@7%l&?lQeAex z4ch)~7qo)?-R4I*(d-;h;o}@s5H#$gZxc`S9t=d?c7iN5a4BmXU8U#+f)FW7a5TyC z%XYemF~b|_e?W*xHg#h;`W!fBK_;D0B<2oWi-Sp4N$`S^aC$kF5)A6*I$EeYoS z(?6S01OWBJlsTt*=H>xqK@!kwrW8zqe1CJ}zs)keiz&F{nU+qWW@l%&egvjSvark) z1CAXOOlr=`LcyGuamK>Df*chvji)fn|Il0X=7;D|D^Jp{twl20yN#$ z@)2vNWH&n}z8HWXvR8)V!7Cc}!Z>KaO6M*Bp$ZgK1(17r$Ez9o=bWwW)I64@mHSVw zg|KaNq~#T+=t;Gk!p~K#sWBQp=?o=70ZBq$hc6Ae@_-he`RG&YaY$Y8PsO-vGH4dM zIaU+PVB!)D{Fv|VX@;i0cG3TZ+pqdlarVD)`$5k|X^ws*FAwVhnw+lm-MgM9)Ohq7 zp}Uplex@3mI5+KeyGhi=467Gcz0992&|ch|CA!rn+*pzQ<8~tidOe)--#vAmspSKy z;1aE3+uaM-#Iq`n4}bkt84K&n(svEIRc?y`BQ@CnmZFni)>5hcFA0FY-Ez>T|F~9d z*k^9?wci>gwW1;?@8#e>5JKf$U;5f(rY~SrC`bC}<`}7STLmaz%bkVs$?V$s0cU0J42!IXu1tXHPch0Z_P7beOldiPXI)-hiSOzDx>x43<#NRsIcxsgwzP;r}_Y*UpMdTuw z>o$q2l@}c+69|;s7j+-SQ)~AdfF`~m@PircqO!@g#~l3l=E4F#gg>Uh=yhgBn+(_- z)TAU`y>ssW%midx%qtx+HgtD&oebBC3zb${NB3GN%bc!3F#vz$@_ zY3wp35$5V@2Cv>z6!BwofSDs&0QcpjU@XOer&<7axCbIX2MmG>0a8bW>z1nv2?E(|(^!Sa|?PWyjc zg|U$15gb56U-&8 zTRK*)14F#38h^=xF)j{SZtMH7`5jL$-P=Ap3c4u}LOztq8~T*{o3S}#pg2Q@VJYnW zrlnI~I-ddV0txk$=4AWFryT!L30g|M`gtuEA?vtEgX8Pz_}Uu}hmtEV4y|9k6X_r9 zVH${GlydDNDJhwXoyTMl1xBhgJLHOdWa;Jv*958?v=3*%3{$_ewJ*;k%T%(YFopp! zN*?qNF?w}6E+jB5|1$PdT5VKreyX~Q)_d5-p7>4MWyE!c{D7OxLTcGOdGa$(L%c=pQ zjX6<7%jqj{PB6cV_~p}P58)JQpFN1xgNlTVZaN3uYCm6YB>xC;*}g{>$+U^U!B6m+}F^Yba^Bers42lT=Mc@7r=LgjvC|ERnGLFW^Ds~a&q1T9SPId!I z1wowq5s^23tw;p!2OBXcJWK?{&+zam1S9SbpYju6N)3uM9d@0Sv*)n-4Tu(9WBJ4y z-&z_+W$y;_53<)0n|=iV0<5+Zf&veWsDC~-nyO6EX!J0nQ89pC3C7c2%G&q_46un+ zqX(5`za#v?Hcdwi^DS+NUcHaZ#ijmoA3URb*PAS24HYeOZ((>Ej#J451-^RL;00a% ziVDTb0q&pQbxzFr% za=o8Jsin~W!0`jo<>m5$-9ynu7$qwH_wWeK&*zgeGRO^ox%pTyN;+(17gmDt3H!b)feS?aloQ-)1k;ioY| z_mme7)}H*?^CynJ@>JnJQ1bbif8t0#AUH|QJN@Qq)3`ss>7y*V|4rCW_;kl8hKGP4 zsUQ?p9t#nf9)(&o`*Xm?dA}pyG!z>uKDD!b>3wjJldG2)ueu zSa&hLdoB(&{QdwBJ%@F$A7YcY07u?`l}1z%cbw+6}twDwNU)r@E)+M<5Nck z@3>2PN^TCZ4^?HGFZkgZ5$%GU2Q<8SzkxE~>ZJFGfO5GyQ6xOi^CtN9lV7F-81=sU zDzH7EAG2RCnA>yAa-FRhK8_N*7g_jD`1(xAN)%q9#W7Y^zGwHpatUGSDz1BVN_;2=w$$yX^l`PIH+ ztgNErXKe&Dfj(ms#h9m1s!TTNz(;iP2&xZ){OTWYjL?1#Vv2hX?xoX*zWpRXvxN%Q zKq(f8e}8pOd*Qu#y}$wX1ILI*lf|lF*H(Mr#fzPRVLE;s9QATU1x?=+Z!I^3syB0{ zlCey`8~of@cNHy*KVH0}LdBlRwWHh0^b9&xV!%7wT?_*=#LquJEB-1jDT#YVIkjB_ zd$PKYD`R6e5XHJinZB!@ZP5 zEl-ADvh6;@?`(U<$<}s;gpdEG>*qS9ce~Qxy@k4|FSG!{N!>TYc5DwOIBStVes-no z2{|orGNAH>QZZq9H@rD;8C2{tz()Mcn*W%VuIQcL{qx+~xHu(|lSt5enBsoJBsni= z%+*_g&kTE5%?`^jIHhM7Lx)e+2T<+2nh)Z z_;W0}g-2lTd91{~LMhWgrTASs&G}hFg{`H^UdYcD7P48*CD%ByI1N+N9C#_6er6iI z#E@g(!lDw2hZ7WG?~*y!29-)A$EVKiD89;;pHoYems@yH|2{SQpjS~+S$P;(I`0;N zd9vWHO|IfrTvW8|g>{3ItUls>_lmK`VgqZTSxuN|1wA+LPFr%z*Lh3D(OE|^t5`^{qr|r#IA4f`;BT)n!s!$iBC%m|@4}LXtkW!x#n4PL zvYZnR(^J`0X-KHEs*_H-0rrJ~BCvD{nlneNLvuilT!eD45g8gww?7FF%$M6RT%D3b zT2&HBof`-e?{-c0#M)c$so%YO=SwLG#L~S}p#Z%&Po`$;1xtA3Q?_jOkHLf)b7A4~pkb!XweevAtJgn^c-p=EU|FLL92I6C00?Ej;z4$?YWMPBsvY(v<(1IqZR((11bhJcL_x6`3P zs8}m{yz1902UDN;63t+#vs}kX1N!jo?C)QJ>G+cUe4z3Z%|V}{QvubwZ)%At?978Dwsevw@`KZzPqRBWZf7Yn!tn{ymJ{I zxufZOdc29b#nPtZ557-&K1vZ6QoL{3{8=K{_^)AckVd&Vogd>plb+9I&1P!ugA?Bz zzyN20_FqoqWHDt{mz7G>915hUgjZ43DG0c&-nq8+57J}vjn09*eoQ}^UoIBY)hg-%gsk?8DSPVG=nN;aA0v~A!7#-LQLcAul{J+iX1%K z!=Yd)d~{QIy|m)F_4?r<%YFvTHOoMy#m@{)F(Fi6up!8XK2WCLJPaR23Ez1%?fHY1 z8TFjUB*MOyR9(S*RY-t>g*8>dM~SUi3T!gF`qeh-Q=%prnE}W_V5smG6t>jE6oAAaO&;Fz zAyxC$E+5p$;p@O%ka={8FkV{9VxdvA)bvCqgt6(z#V{>cpp!E00|D{{0|JI@RGj4n z10e9o5a~4N2e+%zwFow;;0~DBgUJGld)6-!cr1q|AZW1Yky*_>7RHaT_S` zwg~GeSdKh(6b+(+o?#VN$hbTbl@!usE*emF_;O|VB&%X>Zq8A8qi_?^zdNTM zQTWQHbej#A=ERUQ7MwJtgqxO|u*jp#uyT+v1Co+L#mwI*GLt5d&n7a!71D(K&vygk zA&1sG zNvl5}+^=)qQEj3eg4Ypz2R(O^#$OwQH+9a}ZT@T=Z2aPUL23B6R1VQpb{-HwPF#AN zP&#qXtFtvv9XB-PTc2nq0pzMzj3XigyDq%j8{Xo73=XPp>vahn#JSzBtLgjKk~#;o zsMCemsL)(Rx2}b*lri2@_!ANa7Xyt^sscGlG%pmGI^xMlC|LWQt|A#4DO%EB?xsK( z3!Eys5_eB*bymXBU#HEDSpiR05IkO997hs4AzE5hQ)U+R3o$!N1cheF{UXni)FDJ| z;8*MGtWpQ;WRmZm^wQFu@=1u|YQAoM4mVb5ngvjF#)7wRQIp^PEHkYaTK>Q{jFV<2 z8T{oRv%qBfo*s^%NbS6xbeKh2?!!z{l!!v;&Zyicb*;KMwPc08iA*+{=fFfuAr-yG%U)0VF_{YuX=ylC=81@( zGexf$%C|M6CZ6C(Nx#v=HTAm6bJWp+W9fv;{dT{NnEAB=KzLN`(04aauN-vXCnaAh zK8b7v8~l9_CfaLYTC%U^rU=DL?-hEhWk^SId{kC4)peyf zLhzLkqa|cSeW6;7mRMY`E()IkAn#BW4f=Wj7pChJ{MrCPGeV+rY4(ZrYqva0O*{Eb@OH1l{1B{x4oSwLfQyr9aa3%$u8p&+h zg|-`O7(7~I=^x(<$IOmW!uiVAk(F6H&=PM&4~T~{qQqGP^{>hW7HXO}t-(rW7J}q1 zMJJkqx1&>4(w-N0NXQ@21=6(Xxl{C|C8XBN*3LEuc9YVYO}@HmJo+OE&!1Odysx9C znEh%^Y^@i6A&@u>Oa+|;c$4OZGD*u!=T{`W%q%#`B#VQQ@&GqL0Vp|{IsJ9Fj-Q%N zFO5&8NrIDPHDzG0)3qG@$425O;nMChl^s-0Rnx@ zUpBCll8!e0J#_d(aoYO~W~6N}-&Q}6B5L{6WdJp1!eQ9@e#=)91nAAzyw&q~S&aER@X z7nGzWl)~}�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 OLYC)9rq6$IjrtD@g2Jl+ literal 0 HcmV?d00001 diff --git a/evidence/grafana/03-pool-and-resources.png b/evidence/grafana/03-pool-and-resources.png new file mode 100644 index 0000000000000000000000000000000000000000..d4e35e80ba862c175ef3e644dc39d67d31f9094c GIT binary patch literal 153721 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 literal 0 HcmV?d00001 diff --git a/evidence/grafana/04-collector-alerts-slo.png b/evidence/grafana/04-collector-alerts-slo.png new file mode 100644 index 0000000000000000000000000000000000000000..36bcf07db98c72c7435e0dd7a24a241d559a5ebb GIT binary patch literal 113901 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

8HSXjbJ@A4duLv-FBdBEC+UOlN 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 99%. No data if no traffic.", + "gridPos": { + "x": 12, + "y": 56, + "w": 12, + "h": 8 + }, + "datasource": { + "type": "prometheus", + "uid": "prometheus" + }, + "fieldConfig": { + "defaults": { + "unit": "percentunit" + }, + "overrides": [] + }, + "options": { + "legend": { + "displayMode": "list", + "placement": "bottom", + "showLegend": true + } + }, + "targets": [ + { + "refId": "A", + "expr": "1 - ((sum(increase(lab_http_requests_total{route=~\"/api/.*\",status_class=\"5xx\"}[5m])) or vector(0)) / sum(increase(lab_http_requests_total{route=~\"/api/.*\"}[5m])))", + "legendFormat": "actual SLI", + "datasource": { + "type": "prometheus", + "uid": "prometheus" + }, + "editorMode": "code" + }, + { + "refId": "B", + "expr": "vector(0.99)", + "legendFormat": "SLO target 99%", + "datasource": { + "type": "prometheus", + "uid": "prometheus" + }, + "editorMode": "code" + } + ] + } + ] +} diff --git a/infra/otel/grafana/provisioning/dashboards/dashboards.yml b/infra/otel/grafana/provisioning/dashboards/dashboards.yml new file mode 100644 index 0000000..7c561d8 --- /dev/null +++ b/infra/otel/grafana/provisioning/dashboards/dashboards.yml @@ -0,0 +1,11 @@ +apiVersion: 1 +providers: + - name: Lab6 + orgId: 1 + folder: MTUCI + type: file + disableDeletion: true + allowUiUpdates: false + updateIntervalSeconds: 10 + options: + path: /var/lib/grafana/dashboards diff --git a/infra/otel/grafana/provisioning/datasources/datasources.yml b/infra/otel/grafana/provisioning/datasources/datasources.yml new file mode 100644 index 0000000..afdb5a8 --- /dev/null +++ b/infra/otel/grafana/provisioning/datasources/datasources.yml @@ -0,0 +1,36 @@ +apiVersion: 1 +datasources: + - name: Prometheus + type: prometheus + uid: prometheus + access: proxy + url: http://prometheus:9090 + isDefault: true + editable: false + - name: Loki + type: loki + uid: loki + access: proxy + url: http://loki:3100 + jsonData: + derivedFields: + - name: TraceID + matcherType: label + matcherRegex: trace_id + datasourceUid: tempo + url: '$${__value.raw}' + - name: Tempo + type: tempo + uid: tempo + access: proxy + url: http://tempo:3200 + jsonData: + tracesToLogsV2: + datasourceUid: loki + spanStartTimeShift: '-2s' + spanEndTimeShift: '2s' + filterByTraceID: true + filterBySpanID: false + tags: + - key: service.name + value: service_name diff --git a/infra/otel/loki.yaml b/infra/otel/loki.yaml new file mode 100644 index 0000000..a40f88a --- /dev/null +++ b/infra/otel/loki.yaml @@ -0,0 +1,32 @@ +auth_enabled: false +server: + http_listen_port: 3100 +common: + instance_addr: 127.0.0.1 + path_prefix: /loki + storage: + filesystem: + chunks_directory: /loki/chunks + rules_directory: /loki/rules + replication_factor: 1 + ring: + kvstore: + store: inmemory +schema_config: + configs: + - from: 2024-01-01 + store: tsdb + object_store: filesystem + schema: v13 + index: + prefix: index_ + period: 24h +limits_config: + allow_structured_metadata: true + retention_period: 72h +compactor: + working_directory: /loki/compactor + retention_enabled: true + delete_request_store: filesystem +analytics: + reporting_enabled: false diff --git a/infra/otel/prometheus/alerts.yml b/infra/otel/prometheus/alerts.yml new file mode 100644 index 0000000..988a93a --- /dev/null +++ b/infra/otel/prometheus/alerts.yml @@ -0,0 +1,19 @@ +groups: + - name: messenger-lab + rules: + - alert: LabAPIHighErrorRate + expr: (sum(rate(lab_http_requests_total{route=~"/api/.*",status_class="5xx"}[30s])) or vector(0)) / clamp_min(sum(rate(lab_http_requests_total{route=~"/api/.*"}[30s])), 0.001) > 0.05 + for: 9s + labels: + severity: warning + annotations: + summary: Business HTTP 5xx rate exceeds 5% over 30 seconds + runbook: REPORT.md#инциденты-и-runbook + - alert: LabQueueLag + expr: max(lab_queue_oldest_age_seconds) > 15 and max(lab_queue_depth) > 0 + for: 12s + labels: + severity: warning + annotations: + summary: Oldest queued job exceeds 15 seconds (sustained 12 seconds) + runbook: REPORT.md#инциденты-и-runbook diff --git a/infra/otel/prometheus/prometheus.yml b/infra/otel/prometheus/prometheus.yml new file mode 100644 index 0000000..39e607a --- /dev/null +++ b/infra/otel/prometheus/prometheus.yml @@ -0,0 +1,12 @@ +global: + scrape_interval: 3s + evaluation_interval: 3s +rule_files: + - /etc/prometheus/alerts.yml +scrape_configs: + - job_name: lab-otlp + static_configs: + - targets: ['otel-collector:8889'] + - job_name: collector-self + static_configs: + - targets: ['otel-collector:8888'] diff --git a/infra/otel/tempo.yaml b/infra/otel/tempo.yaml new file mode 100644 index 0000000..bf255a3 --- /dev/null +++ b/infra/otel/tempo.yaml @@ -0,0 +1,22 @@ +server: + http_listen_port: 3200 +distributor: + receivers: + otlp: + protocols: + grpc: + endpoint: 0.0.0.0:4317 + http: + endpoint: 0.0.0.0:4318 +storage: + trace: + backend: local + wal: + path: /var/tempo/wal + local: + path: /var/tempo/blocks +compactor: + compaction: + block_retention: 72h +usage_report: + reporting_enabled: false diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..d0da58e --- /dev/null +++ b/requirements.txt @@ -0,0 +1,18 @@ +fastapi==0.115.12 +uvicorn==0.34.2 +pydantic==2.11.4 +psycopg[binary]==3.2.6 +psycopg-pool==3.2.6 +redis==5.2.1 +argon2-cffi==23.1.0 + +boto3==1.40.0 +Pillow==11.3.0 +pika==1.3.2 + +opentelemetry-api==1.42.1 +opentelemetry-sdk==1.42.1 +opentelemetry-exporter-otlp-proto-http==1.42.1 +psutil==7.2.2 + +PyYAML==6.0.2 diff --git a/scripts/check_lab6.py b/scripts/check_lab6.py new file mode 100644 index 0000000..573eeb2 --- /dev/null +++ b/scripts/check_lab6.py @@ -0,0 +1,46 @@ +#!/usr/bin/env python3 +"""Additional static checks (not the teacher's make check and not a live deploy).""" +import ast,json,re +from pathlib import Path +import yaml +ROOT=Path(__file__).resolve().parents[1] + +def main(): + count=0 + for path in (ROOT/'app').glob('*.py'): + tree=ast.parse(path.read_text(encoding='utf-8')) + for n in ast.walk(tree): + if isinstance(n,ast.Call) and isinstance(n.func,ast.Attribute) and n.func.attr=='execute' and len(n.args)>1 and isinstance(n.args[0],ast.Constant) and isinstance(n.args[0].value,str) and isinstance(n.args[1],(ast.Tuple,ast.List)): + assert n.args[0].value.count('%s')==len(n.args[1].elts),f'SQL binding mismatch: {path.name}:{n.lineno}' + count+=1 + compose=yaml.safe_load((ROOT/'compose.yaml').read_text()) + for name,svc in compose['services'].items(): + if 'image' in svc:assert ':' in svc['image'] and not svc['image'].endswith(':latest'),name + for port in svc.get('ports',[]):assert port.startswith('127.0.0.1:'),name + for mount in svc.get('volumes',[]): + src=mount.split(':')[0] + assert (ROOT/src).exists() if src.startswith('./') else src in compose['volumes'],f'missing mount {src}' + for network in svc.get('networks',[]):assert network in compose['networks'] + for dep in svc.get('depends_on',{}):assert dep in compose['services'] + for p in (ROOT/'infra/otel').rglob('*'): + if p.suffix in ('.yml','.yaml'):yaml.safe_load(p.read_text()) + services=compose['services']; assert all('telemetry' in services[s]['networks'] for s in ('api1','api2','dispatcher','worker','otel-collector','prometheus','loki','tempo','grafana')) + for v in ('prometheus_data','loki_data','tempo_data','grafana_data'):assert v in compose['volumes'] + collector=yaml.safe_load((ROOT/'infra/otel/collector.yaml').read_text()) + for signal in ('metrics','logs','traces'): + pipe=collector['service']['pipelines'][signal] + assert pipe['receivers']==['otlp'] and pipe['processors']==['memory_limiter','batch'] + assert all(e in collector['exporters'] for e in pipe['exporters']) + for exp in ('otlp/tempo','otlphttp/loki'): + conf=collector['exporters'][exp];assert conf['sending_queue']['queue_size']==64 and conf['retry_on_failure']['max_elapsed_time']=='10s' + dashboard=json.loads((ROOT/'infra/otel/grafana/dashboards/messenger.json').read_text()) + expressions='\n'.join(t['expr'] for p in dashboard['panels'] for t in p['targets']) + for metric in ('lab_http_requests_total','lab_http_duration_seconds_bucket','lab_jobs_total','lab_job_duration_seconds_bucket','lab_ready_duration_seconds_bucket','lab_queue_depth','lab_queue_oldest_age_seconds','lab_broker_ready','lab_db_pool_used','lab_db_pool_waiting','lab_worker_busy','lab_worker_capacity','lab_container_cpu_cores','lab_container_memory_bytes'): + assert metric in expressions,metric + assert all(f'histogram_quantile({q}' in expressions for q in (.5,.95,.99)) + rules=yaml.safe_load((ROOT/'infra/otel/prometheus/alerts.yml').read_text()) + assert {x['alert'] for g in rules['groups'] for x in g['rules']}=={'LabAPIHighErrorRate','LabQueueLag'} + assert all(x.get('for') and x['annotations'].get('runbook') for g in rules['groups'] for x in g['rules']) + print(f'PASS: {count} literal SQL bindings; pinned Compose images, mounts and networks; 3 OTLP pipelines, dashboards and alert rules (static only)') + +if __name__=='__main__':main() diff --git a/scripts/restart.cmd b/scripts/restart.cmd new file mode 100644 index 0000000..d80a2a8 --- /dev/null +++ b/scripts/restart.cmd @@ -0,0 +1,11 @@ +@echo off +setlocal +cd /d "%~dp0.." +docker compose --env-file .env stop --timeout 5 lb api1 api2 worker dispatcher broker s3 redis postgres grafana otel-collector prometheus loki tempo +if errorlevel 1 exit /b 1 +docker compose --env-file .env up -d --wait postgres redis broker s3 s3-bootstrap prometheus loki tempo otel-collector grafana +if errorlevel 1 exit /b 1 +docker compose --env-file .env up -d --no-deps api1 api2 lb dispatcher worker +if errorlevel 1 exit /b 1 +python scripts\wait_ready.py +exit /b %ERRORLEVEL% diff --git a/scripts/restart.sh b/scripts/restart.sh new file mode 100644 index 0000000..6ff2770 --- /dev/null +++ b/scripts/restart.sh @@ -0,0 +1,21 @@ +#!/bin/sh +set -eu +cd "$(dirname "$0")/.." +# Preserve named volumes. Restart all state stores and both API processes. +docker compose --env-file .env stop --timeout 5 lb api1 api2 worker dispatcher broker s3 redis postgres grafana otel-collector prometheus loki tempo +docker compose --env-file .env up -d --wait postgres redis broker s3 s3-bootstrap prometheus loki tempo otel-collector grafana +docker compose --env-file .env up -d --no-deps api1 api2 lb dispatcher worker +python - <<'PY' +import time, urllib.request +for i in range(120): + try: + with urllib.request.urlopen('http://localhost:8080/health/ready', timeout=2) as response: + if response.status == 200: + print('[restart] all services ready') + break + except Exception: + pass + time.sleep(.5) +else: + raise SystemExit('[restart] health timeout') +PY diff --git a/scripts/stop-one.cmd b/scripts/stop-one.cmd new file mode 100644 index 0000000..e3f21f0 --- /dev/null +++ b/scripts/stop-one.cmd @@ -0,0 +1,10 @@ +@echo off +setlocal +cd /d "%~dp0.." +if "%TARGET_INSTANCE_ID%"=="api1" goto stop +if "%TARGET_INSTANCE_ID%"=="api2" goto stop +echo Unexpected TARGET_INSTANCE_ID 1>&2 +exit /b 2 +:stop +docker compose --env-file .env stop --timeout 1 %TARGET_INSTANCE_ID% +exit /b %ERRORLEVEL% diff --git a/scripts/stop-one.sh b/scripts/stop-one.sh new file mode 100644 index 0000000..344d690 --- /dev/null +++ b/scripts/stop-one.sh @@ -0,0 +1,8 @@ +#!/bin/sh +# The public failover test sets TARGET_INSTANCE_ID from the actual response header. +set -eu +cd "$(dirname "$0")/.." +case "${TARGET_INSTANCE_ID:?missing TARGET_INSTANCE_ID}" in + api1|api2) docker compose --env-file .env stop --timeout 1 "$TARGET_INSTANCE_ID" ;; + *) echo 'Unexpected instance alias' >&2; exit 2 ;; +esac diff --git a/scripts/wait_ready.py b/scripts/wait_ready.py new file mode 100644 index 0000000..86d0318 --- /dev/null +++ b/scripts/wait_ready.py @@ -0,0 +1,14 @@ +"""Operator-facing readiness wait after container replacement.""" +import time +import urllib.request +for _ in range(120): + try: + with urllib.request.urlopen("http://localhost:8080/health/ready", timeout=2) as response: + if response.status == 200: + print("[restart] all services ready") + break + except Exception: + pass + time.sleep(.5) +else: + raise SystemExit("[restart] health timeout") diff --git a/tests/attachments_concurrent.py b/tests/attachments_concurrent.py new file mode 100644 index 0000000..91f6d6d --- /dev/null +++ b/tests/attachments_concurrent.py @@ -0,0 +1,90 @@ +#!/usr/bin/env python3 +"""Concurrent Lab5 uploads (HTTP 202) and eventual processing completion. + +Admission metrics measure upload/enqueue requests, not worker throughput. +Completion is checked separately so an accepted-but-stuck job cannot pass. +""" +import argparse +import concurrent.futures +import json +import statistics +import time +from pathlib import Path + +from client import Client, check, run + + +def main(): + parser = argparse.ArgumentParser() + parser.add_argument('--concurrency', type=int, default=10) + parser.add_argument('--output', default='evidence/attachments-concurrent.json') + parser.add_argument('--base-url', default='http://localhost:8080') + parser.add_argument('--wait-seconds', type=int, default=180) + args = parser.parse_args() + check(args.concurrency > 0, 'concurrency must be positive') + check(args.wait_seconds > 0, 'wait-seconds must be positive') + + client = Client(args.base_url) + alice, bob, eve, chat = client.bootstrap() + source = (Path(__file__).parent / 'fixtures/sample.png').read_bytes() + path = '/api/v1/chats/' + chat['id'] + '/attachments?filename=parallel.png' + + def upload(_): + cli = Client(args.base_url) + response = cli.call('POST', path, 202, actor=alice, raw=source, + headers={'Content-Type': 'image/png'}, schema='Attachment') + att = response['json'] + check(att['status'] == 'queued', '202 must return a queued attachment') + check(att['size_bytes'] == len(source), 'size mismatch') + check(att['chat_id'] == chat['id'] and att['owner_id'] == alice['id'], + 'incorrect attachment ownership') + return att['id'], response['elapsed'] + + started = time.monotonic() + with concurrent.futures.ThreadPoolExecutor(max_workers=args.concurrency) as pool: + results = list(pool.map(upload, range(args.concurrency))) + accepted_seconds = time.monotonic() - started + ids = [att_id for att_id, _ in results] + timings = [duration for _, duration in results] + check(len(set(ids)) == args.concurrency, 'duplicate attachment IDs') + + # A 202 response alone only proves acceptance, not successful processing. + pending = set(ids) + deadline = time.monotonic() + args.wait_seconds + while pending and time.monotonic() < deadline: + for att_id in list(pending): + att = client.call('GET', '/api/v1/attachments/' + att_id, + actor=alice, schema='Attachment')['json'] + check(att['status'] != 'failed', 'attachment reached failed: ' + att_id) + if att['status'] == 'ready': + variants = [v['name'] for v in att['variants']] + check(len(variants) == 3 and set(variants) == {'thumbnail', 'crop', 'optimized'}, + 'missing/duplicate image variants: ' + att_id) + pending.remove(att_id) + if pending: + time.sleep(0.5) + check(not pending, 'attachments not ready before deadline: ' + str(len(pending))) + complete_seconds = time.monotonic() - started + + data = { + 'concurrency': args.concurrency, + 'accepted_uploads': len(results), + 'ready_attachments': args.concurrency, + 'failed_requests': 0, + 'acceptance_elapsed_seconds': round(accepted_seconds, 3), + 'acceptance_rps': round(len(results) / accepted_seconds, 3), + 'upload_latency_p50_ms': round(statistics.median(timings) * 1000, 1), + 'upload_latency_max_ms': round(max(timings) * 1000, 1), + 'all_ready_elapsed_seconds': round(complete_seconds, 3), + 'bytes_per_file': len(source), + 'note': 'HTTP 202 = queued; readiness checked for all uploads. Capture API peak RSS separately via docker stats.', + } + output = Path(args.output) + output.parent.mkdir(exist_ok=True, parents=True) + output.write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding='utf-8') + print('PASS: %d concurrent HTTP 202 uploads -> ready, 3 variants each' % args.concurrency) + print(json.dumps(data, ensure_ascii=False, indent=2)) + + +if __name__ == '__main__': + run(main) diff --git a/tests/attachments_negative.py b/tests/attachments_negative.py new file mode 100644 index 0000000..594f103 --- /dev/null +++ b/tests/attachments_negative.py @@ -0,0 +1,48 @@ +#!/usr/bin/env python3 +"""Lab5 negative API tests with isolated synthetic users (requires live stack).""" +from urllib.parse import quote +import uuid +from client import Client, arguments, run, check +from pathlib import Path + + +def main(): + args = arguments('Lab5 negative file/ACL/security tests') + c = Client(args.base_url, args.ca_file) + alice, bob, eve, chat = c.bootstrap() + base = '/api/v1/chats/' + chat['id'] + '/attachments?filename=' + data = (Path(__file__).parent / 'fixtures/sample.png').read_bytes() + c.call('POST', base+'big.png', 413, actor=alice, raw=data+b'\x00'*(10*1024*1024+1-len(data)), headers={'Content-Type':'image/png'}) + c.call('POST', base+'bad.png', 415, actor=alice, raw=b'not-an-image', headers={'Content-Type':'image/png'}) + c.call('POST', base+'fake.jpg', 415, actor=alice, raw=data, headers={'Content-Type':'image/jpeg'}) + c.call('POST', base+quote('../escape.png',safe=''), 400, actor=alice, raw=data, headers={'Content-Type':'image/png'}) + c.call('POST', base+'x.png', 404, actor=eve, raw=data, headers={'Content-Type':'image/png'}) + c.call('POST', base+'x.png', 401, raw=data, headers={'Content-Type':'image/png'}) + uploaded = c.attachment(alice,chat)[0] + ready = c.wait_ready(alice, uploaded) + unknown = str(uuid.uuid4()) + c.call('GET','/api/v1/attachments/'+unknown,404,actor=alice) + c.call('GET','/api/v1/attachments/'+uploaded['id'],404,actor=eve) + c.call('GET','/api/v1/attachments/'+uploaded['id']+'/content',404,actor=eve) + # A ready Lab5 attachment has a downloadable thumbnail for chat members. + # A non-member still gets 404, and an unknown variant must not resolve. + c.call('GET','/api/v1/attachments/'+uploaded['id']+'/content?variant=thumbnail',404,actor=eve) + c.call('GET','/api/v1/attachments/'+uploaded['id']+'/content?variant=nonexistent',404,actor=alice) + check(any(v['name'] == 'thumbnail' for v in ready['variants']), 'missing thumbnail variant') + thumb = c.call('GET','/api/v1/attachments/'+uploaded['id']+'/content?variant=thumbnail',200,actor=alice) + check(thumb['headers'].get_content_type() == 'image/jpeg', 'wrong thumbnail MIME') + other_chat = c.call('POST','/api/v1/chats',201,actor=alice, + body={'title':'Другой чат','member_ids':[alice['id'],bob['id']]},schema='Chat')['json'] + path = '/api/v1/chats/'+other_chat['id']+'/messages' + c.call('POST',path,404,actor=alice, + body={'text':'cross-chat','attachment_ids':[uploaded['id']]}, + headers={'Idempotency-Key':uuid.uuid4().hex}) + c.call('POST','/api/v1/chats/'+chat['id']+'/messages',404,actor=alice, + body={'text':'unknown','attachment_ids':[unknown]}, + headers={'Idempotency-Key':uuid.uuid4().hex}) + ok = c.message(bob,chat,'',attachments=[uploaded['id']])['json'] + check(ok['attachment_ids']==[uploaded['id']], 'valid attachment not linked') + print('PASS: lab5 negative image, MIME, size, filename, ACL, variants and cross-chat checks') + +if __name__=='__main__': + run(main) diff --git a/tests/idempotency_parallel.py b/tests/idempotency_parallel.py new file mode 100644 index 0000000..3edffd7 --- /dev/null +++ b/tests/idempotency_parallel.py @@ -0,0 +1,38 @@ +#!/usr/bin/env python3 +"""Lab3 own test: 30 requests using identical actor/chat/key/body across both replicas.""" +import concurrent.futures +import sys +import uuid +from client import Client, Failure, arguments, check, run + + +def main(): + args = arguments("Check atomic idempotency across API replicas") + c = Client(args.base_url, args.ca_file) + alice, bob, _, chat = c.bootstrap() + key = uuid.uuid4().hex + body = {"text": "Concurrent replay " + key} + path = f"/api/v1/chats/{chat['id']}/messages" + + def worker(_): + # Independent request client; one shared bearer token and idempotency key. + client = Client(args.base_url, args.ca_file) + return client.call("POST", path, expected=201, actor=alice, body=body, + headers={"Idempotency-Key": key}, schema="Message") + + with concurrent.futures.ThreadPoolExecutor(max_workers=12) as executor: + results = list(executor.map(worker, range(30))) + ids = {result["json"]["id"] for result in results} + instances = {result["headers"]["X-Instance-Id"] for result in results} + check(len(ids) == 1, "parallel replay created different messages") + check(len(instances) >= 2, "LB did not serve requests via both API replicas") + check(all(r["json"] == results[0]["json"] for r in results), "replay returned altered result") + c.call("POST", path, 409, actor=alice, body={"text": "different body"}, headers={"Idempotency-Key": key}) + c.call("POST", path, 201, actor=bob, body=body, headers={"Idempotency-Key": key}, schema="Message") + history = c.call("GET", path + "?limit=100", actor=bob, schema="MessagePage")["json"]["items"] + check(sum(x["id"] in ids for x in history) == 1, "message duplicated in history") + print("PASS: parallel idempotency across", len(instances), "replicas; one message, replay 201, conflicting body 409") + + +if __name__ == "__main__": + run(main) diff --git a/tests/jobs_sql_contract.py b/tests/jobs_sql_contract.py new file mode 100644 index 0000000..6d1b82f --- /dev/null +++ b/tests/jobs_sql_contract.py @@ -0,0 +1,30 @@ +#!/usr/bin/env python3 +"""Prevent a mismatch between SQL placeholders and parameter tuple in worker result persistence.""" +import ast +from pathlib import Path +import re + +source = (Path(__file__).resolve().parents[1] / "app" / "jobs.py").read_text(encoding="utf-8") +tree = ast.parse(source) +fn = next(x for x in tree.body if isinstance(x, ast.FunctionDef) and x.name == "publish_result") +matches = [] +for node in ast.walk(fn): + if not isinstance(node, ast.Call) or not isinstance(node.func, ast.Attribute): + continue + if node.func.attr != "execute" or len(node.args) < 2: + continue + if not isinstance(node.args[0], ast.Constant) or not isinstance(node.args[0].value, str): + continue + sql = node.args[0].value + if "INSERT INTO attachment_variants" not in sql: + continue + assert isinstance(node.args[1], ast.Tuple), "Expected literal parameters tuple" + placeholders = sql.count("%s") + params = len(node.args[1].elts) + columns_match = re.search(r"INSERT INTO attachment_variants\s*\(([^)]*)\)", sql, re.I | re.S) + assert columns_match, "Columns missing in INSERT" + columns = len(columns_match.group(1).split(",")) + assert placeholders == columns == params, f"SQL mismatch: {columns} columns, {placeholders} placeholders, {params} parameters" + matches.append((columns, placeholders, params)) +assert len(matches) == 1, "Expected exactly one attachment_variants INSERT" +print("PASS: attachment_variants INSERT has 9 columns, 9 placeholders, 9 arguments") diff --git a/tests/observability_live.py b/tests/observability_live.py new file mode 100644 index 0000000..cf692e5 --- /dev/null +++ b/tests/observability_live.py @@ -0,0 +1,341 @@ +#!/usr/bin/env python3 +"""Lab6 live evidence. Only synthetic test stack; no volume removal. +Run scenarios separately. Queries stored in evidence, no HTTP auth or payloads. +""" +import argparse +import base64 +import math +import concurrent.futures +import json +import os +import subprocess +import time +import urllib.parse +import urllib.request +import urllib.error +from pathlib import Path +from client import Client, Failure, check, run +from pipeline_extended import compose, pg, scalar, wait_for +from pipeline_resilience import verify_ready + +ROOT=Path(__file__).resolve().parents[1] +PROM='http://127.0.0.1:9090' +LOKI='http://127.0.0.1:3100' +TEMPO='http://127.0.0.1:3200' +GRAFANA='http://127.0.0.1:3000' +ERR='(sum(rate(lab_http_requests_total{route=~"/api/.*",status_class="5xx"}[30s])) or vector(0)) / clamp_min(sum(rate(lab_http_requests_total{route=~"/api/.*"}[30s])),0.001)' +LAG='max(lab_queue_oldest_age_seconds)' +DEPTH='max(lab_queue_depth)' +FAILED='sum(otelcol_exporter_send_failed_spans) or sum(otelcol_exporter_send_failed_spans_total) or vector(0)' +# Explicit Prometheus readers can append unit suffixes to Collector self-metrics. +# Missing gauges are not zero: absent telemetry must fail the outage test. +QUEUE='max({job="collector-self",exporter="otlp/tempo",__name__=~"otelcol_exporter_queue_size(_batches|_requests|_items)?"})' +QUEUE_CAPACITY='max({job="collector-self",exporter="otlp/tempo",__name__=~"otelcol_exporter_queue_capacity(_batches|_requests|_items)?"})' +RSS='max({job="collector-self",__name__=~"otelcol_process_memory_rss(_bytes)?"})' + + +def get(url, params=None, *, as_json=True): + try: + with urllib.request.urlopen(url+('?' + urllib.parse.urlencode(params) if params else ''),timeout=8) as r: + raw=r.read(32*1024*1024) + return json.loads(raw) if as_json else raw.decode('utf-8',errors='replace') + except (urllib.error.URLError,TimeoutError,ValueError) as exc: + raise Failure('diagnostic endpoint unavailable: '+url.split('?')[0]+' ('+type(exc).__name__+')') from None + + +def prom(expr): + data=get(PROM+'/api/v1/query',{'query':expr}) + check(data.get('status')=='success','PromQL query failed') + return data['data']['result'] + + +def val(expr): + rows=prom(expr) + return float(rows[0]['value'][1]) if rows else None + + +def alert_state(name): + rules=get(PROM+'/api/v1/rules')['data']['groups'] + for group in rules: + for rule in group['rules']: + if rule['name']==name: + check(rule.get('health')=='ok','alert rule is not healthy: '+name) + return rule['state'] + raise Failure('alert rule missing: '+name) + + +def wait_alert(name,state,seconds=100): + return wait_for(name+' '+state,lambda:alert_state(name),lambda x:x==state,seconds=seconds,interval=2) + + +def ready(): + for url in (PROM+'/-/ready',LOKI+'/ready',TEMPO+'/ready'): + wait_for(url,lambda:get(url,as_json=False),lambda x:bool(x),seconds=100,interval=2) + wait_for('Grafana',lambda:get(GRAFANA+'/api/health'),lambda x:x.get('database')=='ok',seconds=100) + wait_for('Collector scrape',lambda:val('up{job="collector-self"}'),lambda v:v==1,seconds=40) + wait_for('OTLP metrics scrape',lambda:val('up{job="lab-otlp"}'),lambda v:v==1,seconds=40) + + +def trace_spans(tid): + raw=get(TEMPO+'/api/traces/'+tid) + spans=[] + def walk(obj): + if isinstance(obj,dict): + if {'spanId','traceId','name'}<=set(obj): spans.append(obj) + else: + for v in obj.values():walk(v) + elif isinstance(obj,list): + for v in obj:walk(v) + walk(raw) + return spans + + +def logs(tid,service,request_id=None): + expr='{service_name="%s"} | trace_id="%s"' % (service,tid) + if request_id: expr+=' | request_id="%s"'%request_id + data=get(LOKI+'/loki/api/v1/query_range',{'query':expr,'start':str(int((time.time()-900)*1e9)), 'end':str(time.time_ns()),'limit':100}) + return data['data']['result'] + + +def upload(c,alice,chat): + raw=(ROOT/'tests/fixtures/sample.png').read_bytes() + r=c.call('POST','/api/v1/chats/'+chat['id']+'/attachments?filename=sample.png',202,actor=alice,raw=raw,headers={'Content-Type':'image/png'},schema='Attachment') + tid=r['headers'].get('X-Trace-Id','') + check(len(tid)==32 and int(tid,16)>0,'missing active API trace ID: check SDK enablement') + return r['json'],raw,tid,r['headers']['X-Request-Id'] + + +def span_attrs(s): + attrs={} + for a in s.get('attributes',[]): + value=a.get('value',{}) + attrs[a['key']]=next(iter(value.values()),None) + return attrs + + +def chain_ok(spans): + names={s['name'] for s in spans} + required={'POST /api/v1/chats/{chat_id}/attachments','rabbitmq.publish','rabbitmq.consume','s3.upload_fileobj','s3.get_object','s3.put_object','db.publish_result'} + if not required<=names:return False + producers={s['spanId'] for s in spans if s['name']=='rabbitmq.publish'} + consumers=[s for s in spans if s['name']=='rabbitmq.consume'] + outcomes={span_attrs(s).get('job.outcome') for s in consumers} + return len(producers)>=2 and {'retry','ready'}<=outcomes and all(s.get('parentSpanId') in producers for s in consumers) + + +def trace_retry(c): + alice,bob,_,chat=c.bootstrap() + compose('stop','worker') + try: + att,raw,tid,rid=upload(c,alice,chat) + # Override only worker, never a public endpoint; reset in finally. + env={**os.environ,'LAB6_FAULT_RETRY_ONCE':'once'} + subprocess.run(['docker','compose','--env-file','.env','up','-d','--no-deps','--force-recreate','worker'],cwd=ROOT,env=env,check=True,timeout=180) + verify_ready(c,bob,att,raw,seconds=180) + spans=wait_for('stored retry trace',lambda:trace_spans(tid),chain_ok,seconds=100,interval=3) + wait_for('API log joined by request/trace ID',lambda:logs(tid,'messenger-api',rid),bool,seconds=90) + def worker_events(streams): + return {v[1] for row in streams for v in row.get('values',[])} + wlogs=wait_for('worker retry and ready logs',lambda:logs(tid,'messenger-worker'),lambda rows:{'job.retry','job.ready'}<=worker_events(rows),seconds=90) + # Keep only allowlisted names/IDs, not arbitrary span values or log payloads. + summary=[{'name':s['name'],'id':s['spanId'],'parent':s.get('parentSpanId'),'attempt':span_attrs(s).get('job.attempt'),'outcome':span_attrs(s).get('job.outcome')} for s in spans] + result={'trace_id':tid,'request_id':rid,'spans':summary,'worker_log_streams':len(wlogs),'worker_events':sorted(worker_events(wlogs)&{'job.claimed','job.retry','job.ready','image.transformed'}),'retry_chain':True} + print('PASS trace-retry: API/producer/consumer/S3/DB with retry, correlated logs',tid) + return result + finally: + subprocess.run(['docker','compose','--env-file','.env','up','-d','--no-deps','--force-recreate','worker'],cwd=ROOT,env={**os.environ,'LAB6_FAULT_RETRY_ONCE':'off'},check=True,timeout=180) + + +def queue_lag(c): + alice,bob,_,chat=c.bootstrap() + wait_alert('LabQueueLag','inactive') + compose('stop','worker') + try: + att,raw,tid,rid=upload(c,alice,chat) + t=time.monotonic() + wait_alert('LabQueueLag','firing') + lag=val(LAG);depth=val(DEPTH) + check(lag is not None and lag>15 and depth>=1,'firing not supported by actual backlog metrics') + detected=time.monotonic()-t + print('Queue alert firing: oldest age',lag,'s, queued',depth,flush=True) + compose('up','-d','worker') + verify_ready(c,bob,att,raw,seconds=180) + wait_alert('LabQueueLag','inactive',seconds=120) + wait_for('queue drained',lambda:val(DEPTH),lambda v:v==0,seconds=60,interval=2) + print('PASS queue-lag: firing -> ready -> resolved') + return {'trace_id':tid,'firing_lag_seconds':lag,'firing_depth':depth,'detected_seconds':round(detected,3),'resolved_depth':val(DEPTH)} + finally:compose('up','-d','worker') + + +def db_error(c): + alice,_,_,_=c.bootstrap() + wait_alert('LabAPIHighErrorRate','inactive') + user=compose('exec','-T','postgres','printenv','POSTGRES_USER') + db=compose('exec','-T','postgres','printenv','POSTGRES_DB') + # Bounded, isolated table lock. Health SELECT 1 works, authenticated business + # read times out at statement_timeout. Never stop DB (LB would hide API 5xx). + cmd=['docker','compose','--env-file','.env','exec','-T','postgres','psql','-X','-q','-v','ON_ERROR_STOP=1','-U',user,'-d',db,'-c','BEGIN; LOCK TABLE users IN ACCESS EXCLUSIVE MODE; SELECT pg_sleep(60); COMMIT;'] + lock=subprocess.Popen(cmd,cwd=ROOT,stdout=subprocess.DEVNULL,stderr=subprocess.DEVNULL) + try: + wait_for('users lock held',lambda:scalar("SELECT count(*) FROM pg_locks WHERE relation='users'::regclass AND mode='AccessExclusiveLock' AND granted"),lambda v:int(v)>0,seconds=15) + start=time.monotonic(); traces=[]; codes=[] + while time.monotonic()-start < 43: + with concurrent.futures.ThreadPoolExecutor(max_workers=3) as pool: + def get_user(_): + r=Client(timeout=12).call('GET','/api/v1/users/me',[200,503],actor=alice,schema='User') + return r['status'],r['headers'].get('X-Trace-Id'),r['headers'].get('X-Request-Id') + for code,tid,rid in pool.map(get_user,range(3)): + codes.append(code) + if code==503 and tid:traces.append((tid,rid)) + if traces and alert_state('LabAPIHighErrorRate')=='firing':break + check(bool(traces),'no real HTTP 503 from DB lock') + wait_alert('LabAPIHighErrorRate','firing',seconds=20) + ratio=val(ERR) + check(ratio is not None and ratio>0.05,'error ratio below threshold') + tid,rid=traces[0] + spans=wait_for('DB timeout trace',lambda:trace_spans(tid),lambda v:any(s['name']=='db.transaction' and span_attrs(s).get('error.type')=='QueryCanceled' for s in v),seconds=60,interval=2) + wait_for('error log',lambda:logs(tid,'messenger-api',rid),bool,seconds=60) + print('Error alert firing, database QueryCanceled visible; ratio',ratio,flush=True) + finally: + # SQL transaction has server-side 60s bound; wait for normal COMMIT. + try:lock.wait(timeout=75) + except subprocess.TimeoutExpired: + lock.terminate();lock.wait(timeout=10) + # Keep successful business traffic in the evaluation window to prove recovery. + t=time.monotonic() + while time.monotonic()-t<65: + c.call('GET','/api/v1/users/me',200,actor=alice,schema='User') + if alert_state('LabAPIHighErrorRate')=='inactive' and val(ERR) is not None and val(ERR)<=.05:break + time.sleep(1) + wait_alert('LabAPIHighErrorRate','inactive',seconds=40) + print('PASS db-error: lock -> QueryCanceled/503 -> firing -> resolved') + return {'trace_id':tid,'request_id':rid,'http_codes':codes,'firing_error_ratio':ratio,'resolved_error_ratio':val(ERR),'error_spans':[{'name':s['name'],'error_type':span_attrs(s).get('error.type')} for s in spans if span_attrs(s).get('error.type')]} + + +def collector_sample(): + check(val('up{job="collector-self"}')==1,'Collector self-metrics scrape down') + rss,queue,capacity=val(RSS),val(QUEUE),val(QUEUE_CAPACITY) + check(rss is not None and math.isfinite(rss) and rss>0, + 'Collector RSS metric absent or invalid; query otelcol_process_memory_rss(_bytes)? in Prometheus') + check(queue is not None and math.isfinite(queue) and queue>=0, + 'Tempo exporter queue size metric absent or invalid; inspect collector-self metrics') + check(capacity is not None and math.isfinite(capacity) and capacity==64, + 'Tempo exporter queue capacity absent or differs from configured 64: '+str(capacity)) + return rss,queue,capacity + + +def backend_down(c): + alice,bob,_,chat=c.bootstrap() + baseline=val(FAILED) or 0 + cid=compose('ps','-q','otel-collector') + before=subprocess.check_output(['docker','inspect','--format','{{.RestartCount}} {{.State.OOMKilled}}',cid],text=True).strip() + memory_limit=int(subprocess.check_output(['docker','inspect','--format','{{.HostConfig.Memory}}',cid],text=True).strip()) + check(memory_limit==256*1024*1024,'unexpected Collector container memory limit: '+str(memory_limit)) + rss,queue,capacity=collector_sample() + print(f'Collector baseline: RSS={rss/1024**2:.2f} MiB, queue={queue:g}/{capacity:g}, limit={memory_limit/1024**2:g} MiB',flush=True) + compose('stop','tempo') + try: + start=time.monotonic();n=0;memory=[];queues=[];failures=[] + att,raw,tid,_=upload(c,alice,chat) + while time.monotonic()-start<40: + c.message(alice,chat,'telemetry-backend-offline') + n+=1 + rss,queue,capacity=collector_sample() + memory.append(rss);queues.append(queue) + x=val(FAILED) + if x is not None:failures.append(x) + time.sleep(.3) + verify_ready(c,bob,att,raw,seconds=180) + check(n>0,'no successful writes during backend outage') + check(failures and max(failures)>baseline,'no recorded exporter failure; inspect Collector internal metrics') + rss,queue,capacity=collector_sample() + memory.append(rss);queues.append(queue) + print(f'Collector outage: sampled RSS max={max(memory)/1024**2:.2f} MiB, queue max={max(queues):g}/{capacity:g}, successful writes={n}',flush=True) + after=subprocess.check_output(['docker','inspect','--format','{{.RestartCount}} {{.State.OOMKilled}}',cid],text=True).strip() + check(after==before and after.endswith('false'),'Collector restarted or OOM-killed: '+before+' -> '+after) + check(max(memory)=15,'provisioned dashboard incomplete') + check({'prometheus','loki','tempo'}<={d['uid'] for d in grafana_json('/api/datasources')},'provisioned datasources missing') + queries={'api_rps':'sum(rate(lab_http_requests_total{route=~"/api/.*"}[30s]))','error_ratio':ERR, + 'p50':'histogram_quantile(0.5,sum by(le)(rate(lab_http_duration_seconds_bucket{route=~"/api/.*"}[30s])))', + 'p95':'histogram_quantile(0.95,sum by(le)(rate(lab_http_duration_seconds_bucket{route=~"/api/.*"}[30s])))', + 'p99':'histogram_quantile(0.99,sum by(le)(rate(lab_http_duration_seconds_bucket{route=~"/api/.*"}[30s])))', + 'jobs':'lab_jobs_total','job_histogram':'lab_job_duration_seconds_count','ready_histogram':'lab_ready_duration_seconds_count', + 'depth':DEPTH,'oldest':LAG,'broker_ready':'lab_broker_ready','broker_consumers':'lab_broker_consumers','pool_used':'lab_db_pool_used','pool_waiting':'lab_db_pool_waiting', + 'capacity':'lab_worker_capacity','busy':'lab_worker_busy','cpu':'lab_container_cpu_cores','memory':'lab_container_memory_bytes'} + output={} + for key,expr in queries.items(): + rows=wait_for('metric '+key,lambda:prom(expr),bool,seconds=45,interval=2) + if key in ('p50','p95','p99'): check(math.isfinite(float(rows[0]['value'][1])),'percentile has no finite datapoints; repeat after active load') + output[key]={'query':expr,'result':rows} + forbidden={'user_id','request_id','chat_id','message_id','attachment_id','filename','job_id','trace_id','span_id'} + for item in output.values(): + check(all(not forbidden.intersection(r.get('metric',{})) for r in item['result']),'high-cardinality metric labels') + print('PASS metrics snapshot: all expected series present, no forbidden ID labels') + return output + + +def history(c): + alice,bob,_,chat=c.bootstrap() + att,raw,tid,rid=upload(c,alice,chat) + verify_ready(c,bob,att,raw,seconds=150) + wait_for('stored trace',lambda:trace_spans(tid),lambda spans:any(s['name']=='db.publish_result' for s in spans),seconds=90) + wait_for('stored API log',lambda:logs(tid,'messenger-api',rid),bool,seconds=90) + time.sleep(6) + historic_time=time.time() + expr='sum(lab_http_requests_total{route=~"/api/.*"})' + def historic(): + rows=get(PROM+'/api/v1/query',{'query':expr,'time':str(historic_time)})['data']['result'] + return float(rows[0]['value'][1]) if rows else None + before=historic();check(before is not None and before>0,'no historic metric') + compose('restart','--timeout','20','prometheus','loki','tempo',timeout=180) + ready() + wait_for('historical trace',lambda:trace_spans(tid),lambda spans:any(s['name']=='db.publish_result' for s in spans),seconds=100) + wait_for('historical log',lambda:logs(tid,'messenger-api',rid),bool,seconds=100) + after=historic();check(after==before,'historic metric changed or disappeared') + print('PASS history: saved metrics, logs and traces survive backend restart') + return {'trace_id':tid,'historical_query_timestamp':historic_time,'metric_before':before,'metric_after':after} + + +def main(): + p=argparse.ArgumentParser();p.add_argument('--scenario',choices=['trace-retry','queue-lag','db-error','backend-down','metrics','history'],required=True);args=p.parse_args() + check(os.getenv('LAB6_ALLOW_FAILURE_TEST')=='yes','Set LAB6_ALLOW_FAILURE_TEST=yes on isolated synthetic stack') + ready();c=Client(timeout=12) + fun={'trace-retry':trace_retry,'queue-lag':queue_lag,'db-error':db_error,'backend-down':backend_down,'metrics':metrics_snapshot,'history':history}[args.scenario] + result=fun(c) + file=ROOT/'evidence'/('lab6-'+args.scenario+'.json');file.write_text(json.dumps({'scenario':args.scenario,'status':'PASS','result':result},indent=2,ensure_ascii=False)+'\n',encoding='utf-8') + print('Saved',file.relative_to(ROOT)) + +if __name__=='__main__':run(main) diff --git a/tests/own_unit.py b/tests/own_unit.py new file mode 100644 index 0000000..bad78c1 --- /dev/null +++ b/tests/own_unit.py @@ -0,0 +1,42 @@ +#!/usr/bin/env python3 +"""Fast non-Docker checks for input contracts and cursor scoping.""" +import sys +from pathlib import Path +from datetime import datetime, timezone +import uuid + +sys.path.insert(0, str(Path(__file__).resolve().parents[1])) +from app.core import make_cursor, read_cursor, parse_limit, APIError +from app.models import CreateUser, CreateChat, CreateMessage +from pydantic import ValidationError + + +def reject(fn): + try: + fn() + except (APIError, ValidationError, ValueError): + return + raise AssertionError("Expected invalid input") + + +def main(): + token = str(uuid.uuid4()) + dt = datetime.now(timezone.utc) + cursor = make_cursor("messages", token, dt, str(uuid.uuid4())) + assert read_cursor(cursor, "messages", token)[0] == dt + reject(lambda: read_cursor(cursor, "messages", str(uuid.uuid4()))) + reject(lambda: read_cursor(cursor, "chats", token)) + assert parse_limit(None) == 50 + reject(lambda: parse_limit("0")) + reject(lambda: parse_limit("101")) + reject(lambda: CreateUser(username="user_name", display_name=" \t", password="Long-enough-secret")) + reject(lambda: CreateUser(username="user_name", display_name="Test", password=" " * 3)) + assert CreateMessage(text="A\u0000B").text == "A\u0000B" + reject(lambda: CreateMessage(text=" \t")) + reject(lambda: CreateChat(title="title", member_ids=[token] * 2)) + reject(lambda: CreateChat(title="title", member_ids=[token] * 101)) + print("PASS: models, cursor scoping, limits, Unicode U+0000") + + +if __name__ == "__main__": + main() diff --git a/tests/pipeline_extended.py b/tests/pipeline_extended.py new file mode 100644 index 0000000..d120644 --- /dev/null +++ b/tests/pipeline_extended.py @@ -0,0 +1,233 @@ +#!/usr/bin/env python3 +"""Additional *live* Lab5 fault tests; operator-controlled, synthetic records only. + +broker-persistence: require a publisher-confirmed RabbitMQ message to survive +broker restart without a running dispatcher or worker. This differs from the +outbox-restoration tests where dispatcher publishes *after* broker recovery. + +failed-replay: safely inject a deterministic checksum mismatch into one fresh +synthetic attachment's DB metadata, verify permanent failure, restore the +original hash, replay via the operator-only CLI, and verify success plus audit. + +staging-cleanup: verify the staged S3 object is absent after ready (with a +matching cleared staging_key in the DB). + +No volumes are deleted. The test may stop/restart worker/dispatcher/broker; +run only against a disposable LAB5 environment and never concurrently. +""" +import argparse +import hashlib +import os +import re +import subprocess +import time +import uuid + +from client import Client, Failure, check, run +from pipeline_resilience import verify_ready, wait_api + +from pathlib import Path +ROOT = Path(__file__).resolve().parents[1] + + +def compose(*args, expected=(0,), timeout=240): + proc = subprocess.run( + ['docker', 'compose', '--env-file', '.env', *args], cwd=ROOT, + capture_output=True, text=True, encoding='utf-8', errors='replace', timeout=timeout, + ) + if proc.returncode not in expected: + # Don't print env vars, tokens or command stdout/stderr by default. + raise Failure('docker compose %s failed (exit %d); inspect ps/logs' % + (' '.join(args[:2]), proc.returncode)) + return proc.stdout.strip() + + +def pg(sql): + """Read-only or deliberately scoped fault SQL; UUIDs never user-supplied here.""" + user = compose('exec', '-T', 'postgres', 'printenv', 'POSTGRES_USER').strip() + dbname = compose('exec', '-T', 'postgres', 'printenv', 'POSTGRES_DB').strip() + return compose('exec', '-T', 'postgres', 'psql', '-X', '-q', '-A', '-t', + '-v', 'ON_ERROR_STOP=1', '-U', user, '-d', dbname, '-c', sql) + + +def scalar(sql): + return pg(sql).splitlines()[-1].strip() + + +def wait_for(label, action, predicate, seconds=30, interval=0.5): + deadline = time.monotonic() + seconds + last = None + while time.monotonic() < deadline: + try: + last = action() + if predicate(last): + return last + except Failure: + pass + time.sleep(interval) + raise Failure('timed out waiting for ' + label + ', last=' + str(last)[:100]) + + +def job_query(att_id, fields): + uuid.UUID(att_id) + return scalar('SELECT %s FROM processing_jobs WHERE attachment_id = \'%s\'' % + (fields, att_id)) + + +def queue_ready(): + out = compose('exec', '-T', 'broker', 'rabbitmqctl', '-q', 'list_queues', + 'name', 'messages_ready', 'messages_unacknowledged') + for line in out.splitlines(): + parts = re.split(r'\s+', line.strip()) + if parts[0] == 'attachment-processing.v1' and len(parts) >= 3: + return int(parts[1]), int(parts[2]) + raise Failure('RabbitMQ durable queue missing') + + +def make_upload(c): + alice, bob, _eve, chat = c.bootstrap() + att, original = c.attachment(alice, chat) + check(att['status'] == 'queued', 'upload must return 202 queued') + uuid.UUID(att['id']) + return alice, bob, att, original + + +def wait_staging_cleared(att_id, seconds=20): + return wait_for('staging_key cleared after ready', + lambda: scalar("SELECT COALESCE(staging_key,'') FROM attachments WHERE id='%s'" % att_id), + lambda value: value == '', seconds=seconds) + + +def verify_staging_absent(att_id): + # This executes *inside* the worker container with its normal S3 credentials. + # Never expose S3 secrets to the host or write them to evidence files. + code = '''import sys +from botocore.exceptions import ClientError +from app.attachments import s3_client, BUCKET +key='staging/'+sys.argv[1]+'/original' +try: + s3_client().head_object(Bucket=BUCKET,Key=key) +except ClientError as exc: + if exc.response.get('ResponseMetadata',{}).get('HTTPStatusCode')==404: + print('ABSENT') + else: + raise +else: + print('STILL_PRESENT')''' + result = compose('exec', '-T', 'worker', 'python', '-c', code, att_id) + check(result == 'ABSENT', 'staging S3 object still present: ' + result[:70]) + + +def broker_persistence(c): + compose('stop', 'worker') + compose('up', '-d', 'dispatcher') + baseline = queue_ready()[0] + alice, _bob, att, original = make_upload(c) + print('202 queued:', att['id'], flush=True) + sql = "SELECT COALESCE(bool_and(published_at IS NOT NULL),false) FROM job_outbox WHERE job_id=(SELECT id FROM processing_jobs WHERE attachment_id='%s')" % att['id'] + wait_for('outbox publisher confirm', lambda: scalar(sql), lambda v: v == 't', seconds=30) + wait_for('message in RabbitMQ ready queue', lambda: queue_ready()[0], + lambda n: n >= baseline + 1, seconds=15) + compose('stop', 'dispatcher') + before = queue_ready()[0] + check(before >= baseline + 1, 'published message disappeared before restart') + print('Publisher confirmed; dispatcher and worker stopped; broker queue ready=%d' % before, flush=True) + compose('restart', 'broker') + compose('up', '-d', '--wait', 'broker') + after = wait_for('RabbitMQ queue restoration', lambda: queue_ready()[0], + lambda n: n >= before, seconds=40, interval=1) + check(scalar(sql) == 't', 'outbox publish confirmation lost') + print('Broker restarted; ready messages persisted=%d' % after, flush=True) + # CRITICAL: do NOT restart dispatcher yet; only the restored RabbitMQ message + # can deliver this job to the worker. + compose('up', '-d', 'worker') + verify_ready(c, alice, att, original, seconds=180) + check(job_query(att['id'], 'status') == 'ready', 'job not committed ready') + print('PASS: broker-persistence, confirmed RabbitMQ message survives broker restart without outbox republish') + + +def failed_replay(c): + compose('stop', 'worker', 'dispatcher') + alice, _bob, att, original = make_upload(c) + ident = att['id'] + original_sha = hashlib.sha256(original).hexdigest() + check(original_sha == att['sha256'], 'fixture hash mismatch') + check(scalar("SELECT sha256 FROM attachments WHERE id='%s'" % ident) == original_sha, + 'DB hash unexpected before controlled fault') + fault_sha = '0' * 64 if original_sha != '0' * 64 else 'f' * 64 + changed = False + try: + updated = pg("UPDATE attachments SET sha256='%s' WHERE id='%s' AND status='queued' RETURNING id" % + (fault_sha, ident)) + check(ident in updated, 'failed to inject synthetic checksum mismatch') + changed = True + compose('up', '-d', 'dispatcher', 'worker') + + def get_state(): + return c.call('GET', '/api/v1/attachments/' + ident, actor=alice, schema='Attachment')['json'] + failed = wait_for('permanent failed status', get_state, + lambda a: a['status'] == 'failed', seconds=90) + check(failed['error_code'] == 'invalid_image', + 'expected permanent invalid_image, got ' + str(failed['error_code'])) + check(job_query(ident, 'status') == 'failed', 'processing job must fail') + check(job_query(ident, 'attempt') == '1', 'permanent error must not retry') + check(scalar("SELECT count(*) FROM attachment_variants WHERE attachment_id='%s'" % ident) == '0', + 'failed job created variants') + print('Permanent invalid_image confirmed; no retry and no variant rows', flush=True) + # Repair only the generated synthetic row before explicit operator replay. + restored = pg("UPDATE attachments SET sha256='%s' WHERE id='%s' AND status='failed' RETURNING id" % + (original_sha, ident)) + check(ident in restored, 'synthetic metadata could not be restored') + changed = False + compose('exec', '-T', 'dispatcher', 'python', '-m', 'app.jobs', 'replay', '--id', ident) + verify_ready(c, alice, att, original, seconds=180) + audit = scalar("SELECT count(*) FROM job_replay_audit WHERE job_id=(SELECT id FROM processing_jobs WHERE attachment_id='%s')" % ident) + check(audit == '1', 'operator replay audit count incorrect: ' + audit) + check(job_query(ident, 'status') == 'ready', 'replayed job not ready') + attempt = job_query(ident, 'attempt') + check(attempt == '1', 'replay did not reset attempt: ' + attempt) + invalid = compose('exec', '-T', 'dispatcher', 'python', '-m', 'app.jobs', + 'replay', '--id', ident, expected=(1,)) + print('PASS: failed-replay; permanent failure → metadata repaired → replay → ready; audit=1; replay of ready rejected') + finally: + if changed: + # Never leave the synthetic attachment with altered metadata. + pg("UPDATE attachments SET sha256='%s' WHERE id='%s'" % (original_sha, ident)) + + +def staging_cleanup(c): + compose('up', '-d', 'dispatcher', 'worker') + alice, _bob, att, original = make_upload(c) + verify_ready(c, alice, att, original, seconds=180) + wait_staging_cleared(att['id'], seconds=30) + verify_staging_absent(att['id']) + print('PASS: staging-cleanup; ready, DB staging_key=NULL, original staging object absent in S3') + + +def main(): + parser = argparse.ArgumentParser() + parser.add_argument('--scenario', required=True, + choices=['broker-persistence', 'failed-replay', 'staging-cleanup']) + args = parser.parse_args() + if os.getenv('LAB5_ALLOW_FAILURE_TEST') != 'yes': + raise Failure('Set LAB5_ALLOW_FAILURE_TEST=yes; run only on your isolated Lab5 stack') + c = Client('http://localhost:8080') + try: + wait_api() + if args.scenario == 'broker-persistence': + broker_persistence(c) + elif args.scenario == 'failed-replay': + failed_replay(c) + else: + staging_cleanup(c) + finally: + # Restore normal services even when an assertion fails. NO volume deletion. + try: + compose('up', '-d', '--wait', 'broker') + compose('up', '-d', 'dispatcher', 'worker') + except Failure: + print('WARNING: inspect docker compose ps and restore dispatcher/worker manually') + + +if __name__ == '__main__': + run(main) diff --git a/tests/pipeline_resilience.py b/tests/pipeline_resilience.py new file mode 100644 index 0000000..68be85d --- /dev/null +++ b/tests/pipeline_resilience.py @@ -0,0 +1,108 @@ +#!/usr/bin/env python3 +"""Explicit operator evidence for Lab5 queue durability and failure windows. + +Runs only on an isolated lab5 Compose stack. Never resets named volumes. The test +preserves user/session secrets strictly in process memory and prints no tokens. +""" +import argparse +import hashlib +import os +import subprocess +import sys +import time +from pathlib import Path + +from client import Client, Failure, check, run + +ROOT = Path(__file__).resolve().parents[1] + + +def compose(*args, expected=(0,)): + p = subprocess.run(['docker', 'compose', '--env-file', '.env', *args], cwd=ROOT, + stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True, timeout=240) + if p.returncode not in expected: + raise Failure('docker compose command failed: %s (exit %s); inspect docker compose ps/logs' + % (' '.join(args[:2]), p.returncode)) + return p + + +def wait_api(timeout=60): + import urllib.request + deadline=time.monotonic()+timeout + while time.monotonic()ready; original/3 variants verified; no duplicates') + finally: + # Restore the normal topology even after an assertion failure. + compose('up','-d','dispatcher','worker') + + +if __name__=='__main__': + run(main) diff --git a/tests/telemetry_unit.py b/tests/telemetry_unit.py new file mode 100644 index 0000000..d020826 --- /dev/null +++ b/tests/telemetry_unit.py @@ -0,0 +1,62 @@ +#!/usr/bin/env python3 +"""Real Python OTLP SDK wire-format test against a local in-process receiver. +Requires requirements.txt (does not require Docker or external services). +This is not a Collector/backend integration test. +""" +import os +import sys +import time +import threading +from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer +from pathlib import Path +sys.path.insert(0,str(Path(__file__).resolve().parents[1])) +from opentelemetry.trace import SpanKind +from opentelemetry.proto.collector.trace.v1.trace_service_pb2 import ExportTraceServiceRequest +from opentelemetry.proto.collector.logs.v1.logs_service_pb2 import ExportLogsServiceRequest +from opentelemetry.proto.collector.metrics.v1.metrics_service_pb2 import ExportMetricsServiceRequest +from app import telemetry as ot + +received={k:[] for k in ('/v1/traces','/v1/logs','/v1/metrics')} +class Receiver(BaseHTTPRequestHandler): + def do_POST(self): + data=self.rfile.read(int(self.headers['Content-Length'])) + received[self.path].append(data) + self.send_response(200);self.send_header('Content-Type','application/x-protobuf');self.send_header('Content-Length','0');self.end_headers() + def log_message(self,*args): pass + +def main(): + server=ThreadingHTTPServer(('127.0.0.1',0),Receiver) + threading.Thread(target=server.serve_forever,daemon=True).start() + os.environ['OTEL_ENABLED']='yes' + os.environ['OTEL_EXPORTER_OTLP_ENDPOINT']='http://127.0.0.1:'+str(server.server_port) + ot.init('worker') + with ot.span('POST /api/v1/chats/{chat_id}/attachments',kind=SpanKind.SERVER) as root: + stored=ot.inject(); trace_id=ot.trace_id() + with ot.span('rabbitmq.publish',kind=SpanKind.PRODUCER,context=ot.extract(stored)) as producer: + sent=ot.inject() + with ot.span('rabbitmq.consume',kind=SpanKind.CONSUMER,context=ot.extract(sent)) as consumer: + ot.event('job.ready',job_id='synthetic-id',attempt=2) + ot.count('lab_jobs',{'job_type':'attachment.process.v1','outcome':'ready'}) + ot.observe('lab_job_duration',2.5,{'job_type':'attachment.process.v1','outcome':'ready'}) + ot.observe('lab_ready_duration',5.0,{'job_type':'attachment.process.v1'}) + class FakeS3: + def put_object(self,**kw): return True + ot.S3Tracing(FakeS3()).put_object(Key='SECRET_FILENAME_SENTINEL',Body=b'SECRET_CONTENT_SENTINEL') + ot.flush() + for provider in reversed(ot.providers): provider.shutdown() + server.shutdown() + spans=[s for raw in received['/v1/traces'] for r in ExportTraceServiceRequest.FromString(raw).resource_spans for scope in r.scope_spans for s in scope.spans] + byname={s.name:s for s in spans} + assert byname['rabbitmq.publish'].parent_span_id==root.get_span_context().span_id.to_bytes(8,'big') + assert byname['rabbitmq.consume'].parent_span_id==producer.get_span_context().span_id.to_bytes(8,'big') + assert all(s.trace_id.hex()==trace_id for s in spans) + assert 's3.put_object' in byname + logs=[l for raw in received['/v1/logs'] for r in ExportLogsServiceRequest.FromString(raw).resource_logs for scope in r.scope_logs for l in scope.log_records] + assert any(l.trace_id.hex()==trace_id and l.span_id==consumer.get_span_context().span_id.to_bytes(8,'big') and l.body.string_value=='job.ready' for l in logs) + points=[m for raw in received['/v1/metrics'] for r in ExportMetricsServiceRequest.FromString(raw).resource_metrics for scope in r.scope_metrics for m in scope.metrics] + assert any(m.name=='lab_jobs' and m.sum.data_points[0].as_int==1 for m in points) + assert any(m.name=='lab_job_duration' and list(m.histogram.data_points[0].explicit_bounds)==list(ot.BUCKETS) for m in points) + for raw in sum(received.values(),[]): assert b'SECRET_FILENAME_SENTINEL' not in raw and b'SECRET_CONTENT_SENTINEL' not in raw + print('PASS: real OTLP trace/log/metric encoding, parent links, histogram buckets, safe S3 attributes') + +if __name__=='__main__': main() -- 2.54.0