Перейти к основному содержимому
Версия: 4.0

bin

Описание

Помещает непрерывные числовые значения в дискретные наборы(ячейки) по заданному полю <field>.

Синтаксис

| bin [<bin-options>...] <field> [AS <newfield>]

Обязательные аргументы

ПараметрСинтаксисОписание
field<field>Название поля, по которому данные разделяются на ячейки.

Опциональные аргументы

Определение лимитов и параметров для разделения данных при анализе:

ПараметрСинтаксисПо умолчаниюОписание
binsbins=<int>100Максимальное количество отрезков для расчета.
spanspan = (+|-)<int>(s|m|h|d|w|month)См. Предопределенные значения span.Интервал для распределения отрезков.
newfieldas <field>Новое название для поля.

Допустим следующий формат временных параметров: (+|-)<int>(s|m|h|d|w|month):

  • s/sec/secs/second/seconds - секунды
  • m/min/mins/minute/minutes - минуты
  • h/hr/hrs/hour/hours - часы
  • d/day/days - дни
  • w/week/weeks - недели
  • mon/month/months - месяцы
Предопределенные значения span

Если не указан параметр span для временного поля, будут действовать предопределенные параметры.

Перечень предопределенных параметров:

Временной интервалspan
последние 15 минут10 секунд
последние 60 минут1 минута
последние 4 часа5 минут
последние 24 часа30 минут
последние 7 дней1 день
последние 30 дней1 день
последний год1 месяц

Если не указан параметр span для числового поля, он рассчитывается как (максимальное значение поля) / (максимальное количество bins).

предупреждение

Нельзя указывать временной span (<int>(s|m|h|d|w|month)) для числового поля и числовой span (<int>) для временного поля.

Примеры запросов

Пример 1

Команда разделяет данные по временному полю _time на 10 ячеек в зависимости от временного интервала:

...
| bin bins=10 _time

Пример 2

Команда разделяет данные по временному полю _time на ячейки с интервалом 1 день:

...
| bin span=1d _time

Пример 3

Команда разделяет данные по числовому полю amount с интервалом 10:

...
| bin span=10 amount

Пример 4

Команда разделяет данные по числовому полю amount с интервалом 10 и меняет название поля на new_amount.

...
| bin amount as new_amount