Files
mtusi2026lab6/.env.example
T
ricoromaandClaude Opus 5.5 509afca89e feat: telemetry cost profile with head sampling, coarse buckets and balanced tail sampling
- [telemetry] trace_sample_ratio (ParentBased(TraceIdRatioBased), 1 keeps
  ParentBased(ALWAYS_ON)) and metric_buckets (default|coarse with SLO bounds),
  export interval <= 30 s; otel.sdk.span.started, span.live dropped; startup
  records name ratio, buckets and interval
- bench: telemetry services on mtusi-bench, TELEMETRY=on switch for uploads
  and queue, make bench_telemetry[_quick] with off/full/full-aa/head/tail/
  metrics/balanced, rare events, lookup from Tempo/Loki/Prometheus, cost
  sampler, verdicts H1-H8 and B1-B5; collector layers and lean Prometheus in
  bench/otel with preflight checks
- REPORT: telemetry cost hypotheses and criteria before the label

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-14 19:17:25 +03:00

157 lines
10 KiB
Bash
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Шаблон .env: `make env_setup` создаёт из него .env и подставляет
# случайные значения в пустые POSTGRES_PASSWORD, VALKEY_PASSWORD,
# RABBITMQ_DEFAULT_PASS, секреты S3 (S3_ROOT_*, S3_JWT_SIGNING_KEY,
# S3_API_*, S3_CLEANER_*, S3_WORKER_*) и GRAFANA_ADMIN_PASSWORD.
# Существующий .env он не перезаписывает, а дописывает в конец
# переменные шаблона, которых в нём нет: секреты — случайными, остальные
# — значениями шаблона; печатает только имена.
# .env не коммитить. .env читают compose, Makefile и приложение
# (pydantic-settings); в контейнеры он не попадает.
# Параметры приложения — в формате настроек SECTION__FIELD, без секции —
# только то, что приложение не читает. Комментарии — только отдельными
# строками: make оставляет хвостовой комментарий частью значения.
# Соответствие переменным skeleton (APP_HOST, APP_PORT, APP_ENV,
# SESSION_TTL_SECONDS, DATABASE_URL_FILE, SESSION_STORE, CACHE_URL_FILE,
# с lab3 — API_REPLICAS, IDEMPOTENCY_TTL_SECONDS, с lab4 — S3_ENDPOINT,
# S3_REGION, S3_BUCKET, S3_ACCESS_KEY_ID_FILE, S3_SECRET_ACCESS_KEY_FILE,
# MAX_UPLOAD_BYTES, MAX_IMAGE_PIXELS) — в REPORT.md, «Архитектура и
# решения». Имена skeleton S3_* буквально не заводятся: S3 настраивают
# строки блока S3 ниже.
# С lab5 — BROKER_URL_FILE: [broker] мостами из RABBITMQ_* ниже (значения, а
# не файл); WORKER_CONCURRENCY: [worker] concurrency; JOB_MAX_ATTEMPTS:
# [worker] max_attempts; JOB_TIMEOUT_SECONDS: [worker] job_timeout_seconds;
# STAGING_RETENTION_SECONDS: [cleaner] staging_retention_seconds.
# С lab6 — имена OTEL_* skeleton настройками не являются, SDK их не читает
# (процесс с включённой телеметрией удаляет их из окружения и пишет warning):
# OTEL_SERVICE_NAME — константа точки входа (messenger-api,
# messenger-worker, messenger-relay); OTEL_EXPORTER_OTLP_ENDPOINT — [telemetry]
# otlp_endpoint, в compose — TELEMETRY__OTLP_ENDPOINT у api, worker и relay;
# OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf — постоянно (установлен только
# экспортёр OTLP/HTTP protobuf); OTEL_RESOURCE_ATTRIBUTES — [telemetry]
# environment (deployment.environment.name), service.* вычисляет код.
# Стандартные имена выбора трасс тоже не настройки: OTEL_TRACES_SAMPLER —
# постоянно parentbased_traceidratio (при доле 1 — parentbased_always_on),
# OTEL_TRACES_SAMPLER_ARG — [telemetry] trace_sample_ratio.
# Включает телеметрию compose (TELEMETRY__ENABLED у api, worker и relay), в .env её
# нет: консоль — без телеметрии.
# порт сервиса ([app] port): на нём слушает приложение, его же
# публикует compose, на нём же healthcheck
APP__PORT=8080
# порт на 127.0.0.1 хоста, куда публикуется балансировщик HAProxy —
# единственная точка входа; приложение его не читает
APP_OUT_PORT=8080
# число реплик сервиса api за балансировщиком (имя skeleton); читают
# compose (deploy.replicas) и Makefile, приложение — нет. Разовая
# подмена — make replicas API_REPLICAS=N
API_REPLICAS=2
# PostgreSQL. POSTGRES_USER, POSTGRES_PASSWORD и POSTGRES_DB читает и
# образ postgres; пароль задаётся только при первом создании volume.
# Пустой пароль образ postgres не принимает: make env_setup подставляет
# случайный
POSTGRES_USER=messenger
POSTGRES_PASSWORD=
POSTGRES_DB=messenger
# адрес и порт Postgres внутри сети compose: по ним ходят API и миграции
# в docker, порт слушает сам сервер (PGPORT)
POSTGRES_HOST=postgres
POSTGRES_PORT=5432
# порт на 127.0.0.1 хоста, куда публикуется Postgres: к нему подключается
# приложение в console
POSTGRES_OUT_PORT=5433
# мосты для console: приложение на хосте берёт значения отсюда, в docker
# их задаёт environment compose
DATABASE__HOST=127.0.0.1
DATABASE__PORT=${POSTGRES_OUT_PORT}
DATABASE__USER=${POSTGRES_USER}
DATABASE__PASSWORD=${POSTGRES_PASSWORD}
DATABASE__NAME=${POSTGRES_DB}
# Valkey — кэш карточек чатов. Пароль читают и сервер (--requirepass), и
# приложение; пустой make env_setup заменяет случайным
VALKEY_PASSWORD=
# адрес и порт Valkey внутри сети compose: по ним ходит API в docker,
# порт слушает сам сервер
VALKEY_HOST=valkey
VALKEY_PORT=6379
# порт на 127.0.0.1 хоста, куда публикуется Valkey: к нему подключается
# приложение в console
VALKEY_OUT_PORT=6380
# мосты для console: в docker их задаёт environment compose
CACHE__HOST=127.0.0.1
CACHE__PORT=${VALKEY_OUT_PORT}
CACHE__PASSWORD=${VALKEY_PASSWORD}
# S3 (SeaweedFS) — байты вложений. Шесть пустых секретов make env_setup
# заменяет случайными hex; без них compose не стартует. Кто какой секрет
# получает — docker-compose.yml, якоря x-s3-*
# имя bucket: читают приложение ([s3] bucket) и bootstrap S3, который его
# создаёт; 3–63 символа: строчные буквы, цифры, точка и дефис
S3__BUCKET=messenger
# административные ключ и секрет S3: только сервер s3 (без учётной
# записи он открыт анониму), ни API, ни bootstrap их не получают
S3_ROOT_ACCESS_KEY=
S3_ROOT_SECRET_KEY=
# ключ подписи служебных вызовов SeaweedFS (gRPC шлюза, IAM filer):
# сервер s3 и bootstrap
S3_JWT_SIGNING_KEY=
# ключи пользователя API (только объекты своего bucket): bootstrap
# заводит пользователя с ними, реплики API ходят с ними в S3. Новый
# секрет вступает в силу при следующем bootstrap (make run_docker)
S3_API_ACCESS_KEY=
S3_API_SECRET_KEY=
# ключи пользователя уборщика незавершённых загрузок (только чтение и
# удаление объектов своего bucket): bootstrap заводит пользователя с
# ними, сервис cleaner ходит с ними в S3; реплики API их не получают
S3_CLEANER_ACCESS_KEY=
S3_CLEANER_SECRET_KEY=
# ключи пользователя worker (только чтение и запись объектов своего
# bucket): bootstrap заводит пользователя с ними, сервис worker и make
# run_worker ходят с ними в S3; реплики API их не получают
S3_WORKER_ACCESS_KEY=
S3_WORKER_SECRET_KEY=
# адрес и порт API S3 внутри сети compose: по ним ходит API в docker,
# порт слушает сам сервер и проверяет bootstrap
S3_HOST=s3
S3_PORT=8333
# порт на 127.0.0.1 хоста, куда публикуется API S3: к нему подключается
# приложение в console (консоль и UI SeaweedFS не публикуются)
S3_OUT_PORT=8334
# мосты для console: в docker их задаёт environment compose
S3__HOST=127.0.0.1
S3__PORT=${S3_OUT_PORT}
S3__ACCESS_KEY_ID=${S3_API_ACCESS_KEY}
S3__SECRET_ACCESS_KEY=${S3_API_SECRET_KEY}
# RabbitMQ — брокер заданий обработки вложений. Пользователя и пароль читает
# и образ брокера: учётная запись создаётся при первом старте на пустом
# volume. Пустой пароль make env_setup заменяет случайным
RABBITMQ_DEFAULT_USER=messenger
RABBITMQ_DEFAULT_PASS=
# адрес и порт AMQP внутри сети compose: по ним ходят API и worker в docker,
# порт слушает сам брокер
RABBITMQ_HOST=rabbitmq
RABBITMQ_PORT=5672
# порт на 127.0.0.1 хоста, куда публикуется AMQP: к нему подключаются
# приложение и worker в console; другие порты брокера не публикуются
RABBITMQ_OUT_PORT=5673
# мосты для console: в docker их задаёт environment compose
BROKER__HOST=127.0.0.1
BROKER__PORT=${RABBITMQ_OUT_PORT}
BROKER__USER=${RABBITMQ_DEFAULT_USER}
BROKER__PASSWORD=${RABBITMQ_DEFAULT_PASS}
# Grafana — интерфейс телеметрии (с lab6). Пароль администратора получает
# только сервис grafana (GF_SECURITY_ADMIN_PASSWORD); состояние Grafana —
# tmpfs, пароль из .env действует на каждом старте. Пустой make env_setup
# заменяет случайным
GRAFANA_ADMIN_PASSWORD=
# порт на 127.0.0.1 хоста, куда публикуется Grafana; порты Collector,
# Prometheus, Loki и Tempo не публикуются
GRAFANA_OUT_PORT=3000
# make test_isolated: порт на 127.0.0.1, куда публикуется тестовый
# контейнер API
TEST_APP_PORT=18088