feat(obs): наблюдаемость Prometheus + Grafana под профилем observability

Раньше видимости в прод не было — только email-монитор (костыль). Добавлено
без нагрузки по умолчанию (профиль не поднимается, пока не попросят):

- API: /metrics через prometheus-fastapi-instrumentator (кол-во/латентность
  запросов по хендлерам);
- Prometheus (infra/prometheus/prometheus.yml) скрейпит API и Flower — из Flower
  приходят метрики Celery (задачи, время, воркеры) вообще без доп. кода;
- Grafana с автопровижном источника Prometheus (infra/grafana/provisioning),
  пароль через GRAFANA_ADMIN_PASSWORD;
- docker-compose.prod.yml: сервисы prometheus/grafana под profiles:[observability]
  + volumes; .env.example и README пополнены.

Запуск: docker compose --profile observability up -d prometheus grafana.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

services/api/app/main.py

@@ -7,6 +7,7 @@ from contextlib import asynccontextmanager
 from fastapi import Depends, FastAPI, WebSocket, WebSocketDisconnect
 from fastapi.middleware.cors import CORSMiddleware
 from fastapi.responses import JSONResponse
+from prometheus_fastapi_instrumentator import Instrumentator
 
 from app.api import admin, auth, documents, reports, search, tasks
 from app.config import settings
@@ -80,6 +81,11 @@ app.include_router(documents.router, prefix="/api")
 app.include_router(reports.router,   prefix="/api")
 app.include_router(admin.router,     prefix="/api")
 
+# ─── Метрики Prometheus ───────────────────────────────────────────────────────
+# HTTP-метрики (кол-во/латентность запросов по хендлерам) на /metrics.
+# Prometheus скрейпит их (см. infra/prometheus/prometheus.yml, профиль observability).
+Instrumentator().instrument(app).expose(app, endpoint="/metrics", include_in_schema=False)
+
 
 # ─── WebSocket ────────────────────────────────────────────────────────────────
 @app.websocket("/ws/tasks/{public_id}")

services/api/requirements.txt

@@ -16,3 +16,4 @@ minio==7.2.7
 httpx==0.27.0
 aiofiles==23.2.1
 websockets==12.0
+prometheus-fastapi-instrumentator==7.0.0  # /metrics для Prometheus (профиль observability)