Метрики

Метрика — то, что считают: выручка, число заказов, средний чек. Все шаги — в режиме редактирования.

Добавить метрику

В дереве у группы «Метрики» нажмите «+» («Добавить: метрика»).
Задайте id, например revenue, «название» и «описание». Описание видят пользователи и агент — напишите, что именно считается и что не входит.

Задайте «формат» — как показывать значение:

Формат	Пример
`currency:USD`, `currency:RUB`	деньги в валюте
`percent:1`	проценты с одним знаком после запятой
`number:0`	целое число
`date:long`	дата

Поле «пусто» задаёт, что показывать, когда у строки нет значения.

В блоке «вычисление» выберите «базовая» или «производная».

Базовая метрика

Базовая метрика считается по своим таблицам. Нажмите «добавить привязку» и заполните:

Поле	Что указать
таблица	id таблицы, по которой считать.
вид	«агрегат» или «снимок» (см. ниже).
выражение	Агрегат по строкам таблицы, например `sum(amount)` или `count(*)`.
время	Столбец, который располагает строки на временной шкале, например `placed_at`.
фильтр	Какие строки учитывать — собственный WHERE привязки, например `status = 'paid'`.

Пока привязок нет, метрику нечем считать. Привязок может быть несколько — для разных таблиц, из которых получается одно и то же число. Дефиника сама выберет подходящую для каждого запроса: Несколько привязок.

Агрегат и снимок

Агрегат — обычный случай: метрика складывается за период. Выручка за месяц — это сумма продаж всех дней месяца.

Снимок — для величин, которые уже являются состоянием на момент времени, а не суммой за период. Например, остаток на складе, баланс счёта, число вагонов в парке. Остаток за месяц — это не сумма ежедневных остатков, а остаток на определённую дату.

Для снимка укажите:

«время» — обязательно: столбец с датой каждого снимка, например placed_at или snapshot_date;
«ключ» — что именно снимается: например, warehouse_id для остатка по каждому складу.

Производная метрика

Производная метрика вычисляется из других метрик и не привязана к таблице. В поле «выражение» напишите формулу из id метрик, например revenue / orders_count для среднего чека.

Разрезы у производной метрики — те, что есть у всех метрик в формуле.

Наблюдения

Направление («↑ Больше — лучше» / «↓ Меньше — лучше»), пороги и задержка данных для метрики задаются в блоке «Наблюдения»: Настроить наблюдения.

Все поля метрики: Поля модели.