Справочник метрик: определения, формулы, источники данных и владельцы.
Назначение
- Единое понимание метрик в продукте, аналитике и инженерии; исключение разночтений в отчётах и дашбордах.
- Связь метрик с KPI Definitions и Dashboards Catalog; при изменении формулы или источника — обновление справочника.
Структура записи о метрике
Для каждой метрики рекомендуется фиксировать:
| Поле | Описание |
|---|---|
| Название | Уникальное имя метрики (например, registration_completed_count) |
| Описание | Что измеряет, в каких единицах |
| Формула / способ расчёта | Алгоритм или источник (событие, лог, агрегат) |
| Источник данных | Топик Kafka, таблица, метрика Prometheus, лог |
| Гранулярность | По времени (день, час), по сущности (user, org, service) |
| Владелец | Продукт, аналитика, SRE |
| Дашборды | Где отображается (ссылка на Dashboards Catalog) |
| Связь с KPI | Если метрика входит в KPI — ссылка на KPI Definitions |
Категории метрик
- Продуктовые: регистрации, входы, активность, воронки, North Star (Managed Infrastructure Coverage) — см. Product Metrics.
- Технические (SLO): доступность, латентность (p50, p95, p99), error rate по сервисам — см. SLA/SLO.
- Инфраструктурные: использование CPU/памяти, диска, Kafka lag, соединения к БД — для дашбордов платформы и capacity planning.
- События: счётчики и агрегаты по типам событий (user.created, password.changed и т.д.) — источники в Event Schema Catalog, Event Tracking Plan.
Конкретный перечень метрик ведётся по мере появления дашбордов и KPI; при масштабировании аналитики — в отдельном каталоге (таблица, wiki или инструмент каталогизации данных).
Связанные страницы
- KPI Definitions — ключевые показатели
- Event Tracking Plan — события как источник метрик
- Dashboards Catalog — где метрики отображаются
- Product Metrics — продуктовые метрики
- Observability / Metrics — технические метрики
- Event Schema Catalog — схемы событий