ADR-0009: Observability, Correlation И Tracing
Статус
Accepted
Контекст
Платформа будет распределенной: gateway, сервисы, Kafka, payment callbacks, game callbacks, background workers. Без единого correlation flow расследование финансовых и игровых инцидентов станет слишком дорогим.
Решение
Используем:
- Serilog для structured logs.
- OpenTelemetry для traces и metrics.
- Sentry для ошибок и performance incidents.
- Prometheus/Grafana для operational dashboards.
correlationId создается на gateway или принимается из доверенного upstream callback после нормализации. Он передается через HTTP headers, Kafka envelope, log scopes, traces и provider adapter logs. Для каждого запроса также фиксируются requestId, tenantId, brandId, actorId, userId если доступны.
Обратные ссылки
Автоссылки: где используется этот документ.