Поиск
Примечание
Доступно в версии 2.1
Команда поиска позволяет искать в OpenTSDB, чтобы получить список временных рядов или связанных метаданных. Поиск не возвращает фактические данные или объекты временных рядов, хранящиеся в таблице данных. Для доступа к этим данным используйте инструменты запросов. В настоящее время реализована только команда lookup.
Поиск
Запросы поиска используют либо таблицу метаданных, либо основную таблицу данных для определения временных рядов, связанных с заданным метрикой, именем тега, значением тега, парой тегов или их комбинацией. Например, если вы хотите узнать, какие метрики доступны для пары тегов host=web01, вы можете выполнить поиск, чтобы узнать это.
Примечание
По умолчанию поиск выполняется по таблице tsdb-meta. Вам необходимо включить создание метаданных в реальном времени или выполнить metasync с использованием команды uid для получения данных из результата поиска. В качестве альтернативы вы можете выполнить поиск в таблице с сырыми данными, но это может занять очень много времени, в зависимости от количества данных в вашей системе.
Формат команды
search lookup <query>
Параметры
| Имя | Тип данных | Описание | Значение по умолчанию | Пример |
|---|---|---|---|---|
| запрос | Строка | Один или несколько запросов командной строки, аналогичных запросу в CLI для данных. Смотрите раздел "Формат запроса" ниже. | tsd.hbase.rpcs type= | |
| --use_data_table | Флаг | Необязательный флаг, который заставит поиск работать с основной таблицей tsdb-data. ПРИМЕЧАНИЕ: Это может занять очень много времени. | Не задано | --use_data_table |
Формат запроса
Подробную информацию по составлению запроса см. на странице /api/search/lookup. Запрос в командной строке похож на API-запрос, но в качестве разделителей используются пробелы, а фигурные скобки не применяются.
[<metric>] [[tagk]=[tagv]] ...[[tagk]=[tagv]]
Требуется как минимум одна метрика, имя тега или значение тега.
Пример команды
search lookup tsd.hbase.rpcs type=
Вывод
Во время поиска результаты будут выведены в стандартный вывод. Обратите внимание, что если у вас включена регистрация, сообщения могут быть перемешаны с результатами. Установите уровень ведения журнала в WARN или ERROR в настройках logback.xml для подавления этих предупреждений. Вы можете запустить поиск в фоновом режиме и перенаправить стандартный вывод в файл, особенно при выполнении поиска по таблице данных, так как это может занять длительное время.
<tsuid> <metric name> <tag/value pairs>
Где:
- tsuid — это шестнадцатеричный закодированный идентификатор временного ряда
- имя метрики — это декодированное имя метрики, которое представляет строка
- пары тег/значение — это теги, связанные с временным рядом
Пример ответа
0023E3000002017358000006017438 tsd.hbase.rpcs type=openScanner host=tsdb-1.mysite.com
Примечание
Во время сканирования, если идентификатор (UID) метрики, имени тега или значения тега не может быть разрешен в имя, будет выброшено исключение.
© 2010–2016 The OpenTSDB Authors
Licensed under the GNU LGPLv2.1+ and GPLv3+ licenses.
http://opentsdb.net/docs/build/html/user_guide/cli/search.html
