bin
Описание
Помещает непрерывные числовые значения в дискретные наборы(ячейки) по заданному полю <field>.
Синтаксис
| bin [<bin-options>...] <field> [AS <newfield>]
Обязательные аргументы
| Параметр | Синтаксис | Описание |
|---|---|---|
field | <field> | Название поля, по которому данные разделяются на ячейки. |
Опциональные аргументы
Определение лимитов и параметров для разделения данных при анализе:
| Параметр | Синтаксис | По умолчанию | Описание |
|---|---|---|---|
bins | bins=<int> | 100 | Максимальное количество отрезков для расчета. |
span | span = (+|-)<int>(s|m|h|d|w|month) | См. Предопределенные значения span. | Интервал для распределения отрезков. |
newfield | as <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 |
|---|---|
| последние 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