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

timechart

Описание

Выполняет поиск и генерацию массива данных, распределенных по временной шкале.

Синтаксис

timechart [<timefield>] [<limit>] [<span>] [<bins>] [<useother>] <functions-expression> ["," <functions-expression>] [<by_expression>]

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

functions-expression Обязательно использование хотя бы одной из функций:

ПараметрСинтаксисОписание
countcount | count(<field>)Вычисляет количество событий, содержащих поле. Если поле не указано, рассчитывает общее количество событий.
avgavg(<field>)Вычисляет среднее значение по заданному полю.
dcdc(<field>)Вычисляет количество уникальных значений в заданном поле.
maxmax(<field>)Вычисляет максимальное значение по заданному полю.
minmin(<field>)Вычисляет минимальное значение по заданному полю.
sumsum(<field>)Вычисляет сумму значений по заданному полю.
percperc(<field>, <percent>)Вычисляет персентиль по заданному полю и проценту

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

ПараметрСинтаксисПо умолчаниюОписание
spanspan=<span>см. Предопределенные значения spanОпределяет интервал для распределения отрезков.
timefieldtimefield=<field>@timestampИмя поля в котором хранится временная метка.
binsbins=<int>100Максимальное количество отрезков для расчета.
limitlimit=<int>10Максимальное количество уникальных значений by_field, которые будут использоваться в названии столбцов результата. Остальные значения объединятся в поле OTHER.
useotheruseother=<boolean>trueПри значении false параметр limit не учитывается.
by_expressionby <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 месяц

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

Пример 1:

Пример №1
... | timechart limit=5 span=1h avg(msgNums) by user

Пример 2:

Пример №2
... | timechart limit=5 span=1d avg(log.offset) by 'source'

Пример 3:

Пример №3
... | timechart span=1d count(log.offset), max(log.offset) by event

Пример 4:

Пример №4
... | timechart span=1h perc(msgNums, 95)