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>
134 lines
5.5 KiB
Python
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,
|
|
)
|