Files
mtusi2026lab6/src/main.py
T
ricoromaandClaude Opus 5.5 a4497e3f32 feat: add OpenTelemetry SDK, collector and telemetry stores
Collector (contrib), Prometheus, Loki, Tempo and Grafana with provisioning
from git; SDK in API and worker with level 3 metrics, traces and logs
carrying trace_id/span_id; telemetry off by default outside the stand;
broker healthcheck runs as the broker user so a fresh stand starts once.

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

134 lines
5.5 KiB
Python

from collections.abc import AsyncIterator
from contextlib import asynccontextmanager
import uvicorn
from fastapi import FastAPI
from src.api import errors
from src.api.middlewares import RequestContextMiddleware
from src.api.routers import health_router, v1_router
from src.config import settings
from src.infra import early_stop, telemetry
from src.infra.cache.instance import cache
from src.infra.db.session import engine
from src.infra.logger import AbstractLogger, get_logger
from src.infra.password import prepare_dummy_hash
from src.infra.s3.instance import object_storage
from src.schemas.enums import RunModeEnum
from src.utils.constants import (
SERVICE_VERSION,
TELEMETRY_SERVICE_API,
TELEMETRY_SHUTDOWN_TIMEOUT_SECONDS,
)
logger: AbstractLogger = get_logger().bind(module="startup")
@asynccontextmanager
async def lifespan(_: FastAPI) -> AsyncIterator[None]:
# первый код приложения внутри обработчиков сигналов uvicorn: ранний
# обработчик больше не нужен, а повтор сигнала после остановки uvicorn
# он должен пропустить (src/infra/early_stop.py)
early_stop.disarm()
database = settings.database
s3 = settings.s3
# выключена — ни провайдеров, ни хуков журнала (design change
# otel-telemetry, решение 8); включена — слушатели span на engine
telemetry_enabled = telemetry.start_process_telemetry(
TELEMETRY_SERVICE_API,
)
telemetry.instrument_engine(engine)
# engine, кэш и S3 подключаются лениво: без Postgres сервис стартует, а
# /health/ready отвечает 503; без Valkey запросы идут в Postgres; без
# S3 — 503 только на путях вложений. Брокера у реплик нет
if not database.password.get_secret_value():
logger.warning("Database password is empty")
if not settings.cache.password.get_secret_value():
logger.warning("Cache password is empty")
if not (
s3.access_key_id.get_secret_value()
and s3.secret_access_key.get_secret_value()
):
logger.warning("Object storage credentials are empty")
# ~30 мс CPU при старте: время ответа на вход с неизвестным username
# ровное с первого запроса
await prepare_dummy_hash()
# модели botocore грузятся при старте, а не в первом запросе; сети нет
await object_storage.start()
logger.info(
"Started API",
host=settings.app.host,
port=settings.app.port,
run_mode=settings.app.run_mode,
database_host=database.host,
database_port=database.port,
database_name=database.name,
cache_host=settings.cache.host,
cache_port=settings.cache.port,
s3_host=s3.host,
s3_port=s3.port,
s3_bucket=s3.bucket,
uploads_max_concurrent=settings.uploads.max_concurrent,
uploads_max_waiting=settings.uploads.max_waiting,
uploads_wait_timeout_seconds=settings.uploads.wait_timeout_seconds,
uploads_body_timeout_seconds=settings.uploads.body_timeout_seconds,
uploads_max_unfinished_jobs=settings.uploads.max_unfinished_jobs,
telemetry_enabled=telemetry_enabled,
telemetry_endpoint=(
settings.telemetry.otlp_endpoint if telemetry_enabled else None
),
telemetry_environment=(
settings.telemetry.environment if telemetry_enabled else None
),
)
try:
yield
finally:
await engine.dispose()
await cache.aclose()
await object_storage.aclose()
logger.info("Stopped API")
# после записи об остановке: она уходит последним пакетом, если
# Collector жив; ожидание — своим сроком внутри 10 с (решение 13)
await telemetry.shutdown(timeout=TELEMETRY_SHUTDOWN_TIMEOUT_SECONDS)
def create_app() -> FastAPI:
# версия — info.version контракта (contracts/openapi.json), она же
# service.version телеметрии
app = FastAPI(
title="MTUSI Messenger",
version=SERVICE_VERSION,
lifespan=lifespan,
)
app.add_middleware(RequestContextMiddleware)
errors.register(app)
app.include_router(health_router)
app.include_router(v1_router)
return app
app = create_app()
def main() -> None:
reload = settings.app.run_mode == RunModeEnum.CONSOLE
uvicorn.run(
"src.main:app",
host=settings.app.host,
port=settings.app.port,
reload=reload,
# без reload uvicorn пишет warning на reload_dirs при каждом старте
reload_dirs=["src"] if reload else None,
# один процесс: реплики — лаба 3, пул соединений рассчитан на один
# процесс
workers=1,
timeout_graceful_shutdown=settings.app.graceful_shutdown_seconds,
# простаивающее соединение закрывает HAProxy раньше реплики
# (design change graceful-failover, решение 3)
timeout_keep_alive=settings.app.keep_alive_seconds,
# логи uvicorn идут через наш JSON-форматтер (src/infra/logger.py)
log_config=None,
access_log=False,
)