Метрики и аналитика

можно. собирает метрики использования фиче-флагов: сколько раз флаг оценивался и какой результат вернул. Метрики визуализируются в веб-панели через sparkline-графики и доступны через REST API.

Как собираются метрики

SDK накапливает счётчики оценок каждого флага в памяти и отправляет их на сервер с заданным интервалом (по умолчанию — 60 секунд):

sequenceDiagram
    participant App
    participant SDK
    participant Server

    loop Оценка флагов
        App->>SDK: isEnabled("new-checkout", ctx)
        SDK-->>App: true/false
        Note over SDK: trueCount++ или falseCount++
    end

    loop Каждые 60 секунд
        SDK->>Server: POST /api/client/metrics
        Note over Server: Сохраняет в flag_metrics
    end

Каждая запись содержит:

Поле	Описание
flagId	ID флага
environmentId	ID окружения
evaluationTrueCount	Количество возвратов true
evaluationFalseCount	Количество возвратов false
timeBucket	Временной интервал (округление до минуты)
instanceId	Идентификатор экземпляра SDK
appName	Имя приложения

Просмотр метрик в веб-панели

На странице флага отображается sparkline-график — миниатюрный график, показывающий тренд оценки флага за выбранный период. Зелёная линия — true, серая — false.

При клике на sparkline открывается диалог «Метрики флага» с полным графиком и фильтрами:

Фильтр	Описание
Окружение	Development / Production
Экземпляр	Конкретный instance SDK
Приложение	Имя приложения
Период	Последний час / 24 часа / 7 дней / 30 дней

REST API для метрик

Метрики флага

GET /api/v1/flags/{flagId}/metrics

Параметр	Тип	Описание
environmentId	long	ID окружения
instanceId	string	ID экземпляра SDK
appName	string	Имя приложения

curl "http://localhost:8080/api/v1/flags/42/metrics?environmentId=3" \
  -H "Authorization: Bearer $JWT_TOKEN"

Ответ:

{
  "metrics": [
    {
      "timeBucket": "2026-06-21T13:41:00Z",
      "trueCount": 150,
      "falseCount": 50,
      "instanceId": "instance-1",
      "appName": "web-app"
    }
  ]
}

Метрики проекта

GET /api/v1/metrics

Параметр	Тип	Описание
environmentId	long	ID окружения

Возвращает агрегированные метрики по всем флагам проекта.

Отключение метрик

Если метрики не нужны, отключите их в SDK:

MozhnoConfig config = MozhnoConfig.builder()
    .appName("my-app")
    .instanceId("instance-1")
    .mozhnoUrl("http://localhost:8080")
    .apiKey("<api-key>")
    .disableMetrics(true)
    .build();

Экспорт метрик через SPI

Через MetricsSinkSpi метрики можно направить во внешние системы:

Назначение	Реализация
Prometheus	Стандартный эндпоинт /actuator/prometheus
Datadog, New Relic	Enterprise-реализация MetricsSinkSpi
Локальное хранение	JdbcMetricsSinkProvider (по умолчанию)

Что значат метрики

Паттерн	Интерпретация
trueCount растёт	Флаг включается для всё большей аудитории — роллаут работает
falseCount растёт, trueCount = 0	Флаг выключен или никто не подпадает под правила
Резкий скачок falseCount	Возможная проблема: флаг внезапно перестал включаться
Нет метрик	SDK не отправляет данные — проверьте подключение

Лимиты

Параметр	По умолчанию	Описание
Интервал отправки (SDK)	60 секунд	sendMetricsInterval / metricsInterval
Макс. метрик на API-ключ	1000	CLIENT_MAX_METRICS_PER_KEY

Что дальше?

• SDK: Обзор — как SDK отправляет метрики
• Мониторинг — Prometheus, health checks
• Таргетинг — правила и сегменты