запрос

Инструмент командной строки запроса предназначен для быстрого отладки при извлечении данных из OpenTSDB. HTTP-API обычно будет гораздо быстрее при запросе данных, так как он включает кэширование и открытые подключения к хранилищу. Результаты выводятся в стандартный вывод в текстовом формате с одной точкой данных в строке.

Обратите внимание, что запрос может возвращать точки данных до и после запрошенного временного интервала. Они используются в усреднении и построении графиков.

Параметры

query [Gnuplot opts] START-DATE [END-DATE] <aggregator> [rate] [counter,max,reset] [downsample N FUNC] <metric> [<tagk=tagv>] [...<tagk=tagv>] [...queries]

Имя	Тип данных	Описание	По умолчанию	Пример
Опции Gnuplot	Строки	Дополнительные значения, используемые для генерации скриптов и графиков Gnuplot. Обратите внимание, что фактическая PNG-графика не будет сгенерирована, только файлы (записанные в временную директорию)		+wxh=1286x836
НАЧАЛЬНАЯ ДАТА	Строка или целое число	Начальное время для запроса. Это может быть абсолютное или относительное время. Подробности см. в разделе Даты и время		1 час назад
КОНЕЧНАЯ ДАТА	Строка или целое число	Необязательное конечное время для запроса. Если не указано, используется текущее время. Это может быть абсолютное или относительное время. Подробности см. в разделе Даты и время	Текущая метка времени	2014/01/01-00:00:00
агрегатор	Строка	Функция, используемая при включении нескольких временных рядов в результатах		сумма
скорость	Строка	Буквальное `rate` значение, если временной ряд представляет счётчик, и результаты должны быть возвращены как изменение за секунду		скорость
счётчик	Строка	Необязательное буквальное `counter` значение, которое указывает, что основанные данные — это монотонно возрастающий счётчик, который может переполняться		счётчик
макс	Целое число	Положительное целое число, представляющее максимальное значение для счётчика	Java Long.MaxValue	65535
значение сброса	Целое число	Необязательное значение, которое, при превышении, заставит агрегатор вернуть 0 вместо рассчитанного значения. Полезно, когда источники данных часто сбрасываются, чтобы избежать ложных пиков.		65000
усреднение N FUNC	Строка	Необязательный спецификатор усреднения для группировки данных по более крупным временным интервалам и уменьшения объёма возвращаемых данных. Формат — буквальное `downsample` значение, за которым следует интервал времени в миллисекундах и имя функции агрегации		усреднение 300000 среднее
метрика	Строка	Обязательное имя метрики для запроса		sys.cpu.user
меткаk=меткаv	Строка	Необязательные пары имён и значений меток		host=web01
дополнительные запросы	Строка	Необязательные дополнительные запросы для выполнения. Каждый запрос должен иметь тот же формат, начиная с агрегатора. Все запросы используют одни и те же начальное и конечное время.		сумма tsd.hbase.rpcs тип=scan

Дополнительную информацию о запросах см. в разделе Запрос или чтение данных.

Пример:

query 1h-ago now sum tsd.hbase.rpcs type=put sum tsd.hbase.rpcs type=scan

Формат вывода

Данные выводятся в стандартный вывод по одной точке данных в строке. Если были указаны одна или несколько опций Gnuplot, то скрипты и файлы данных для каждого запроса будут записаны в указанную временную директорию.

<метрика> <метка времени> <значение> {<меткаk=меткаv>[,..<меткаkN=меткаvN>]}

Где:

метрика — имя запрошенной метрики

метка времени — абсолютная метка времени точки данных в секундах или миллисекундах

значение — значение точки данных

меткаk=меткаv — список общих пар имён и значений меток для всех временных рядов, представленных в запросе

Пример:

tsd.hbase.rpcs 1393376401000 28067146491 {type=put, fqdn=tsdb-data-1}
tsd.hbase.rpcs 1393376461000 28067526510 {type=put, fqdn=tsdb-data-1}
tsd.hbase.rpcs 1393376521000 28067826659 {type=put, fqdn=tsdb-data-1}
tsd.hbase.rpcs 1393376581000 28068126093 {type=put, fqdn=tsdb-data-1}

© 2010–2016 The OpenTSDB Authors
Licensed under the GNU LGPLv2.1+ and GPLv3+ licenses.
http://opentsdb.net/docs/build/html/user_guide/cli/query.html