/api/tree/notmatched
При обработке TSMeta, если в дереве включена функция strictMatch, и метаданные не соответствуют ни одному правилу на любом уровне набора, будет записана запись не соответствует. Этот конечный пункт позволяет получить список TSUID, которые не соответствуют набору правил. Это полезно для отладки, так как, если вы найдете TSUID в этом списке, вы можете передать его через конечный пункт /tree/test, чтобы получить подробности о том, почему метаданные не соответствуют.
Примечание
Вызов этого конечного пункта без списка одного или нескольких TSUID вернёт все несоответствующие TSUID в дереве. Если у вас большое количество временных рядов в вашей системе, ответ может быть очень большим. Поэтому лучше использовать этот конечный пункт со специфическими TSUID.
Примечание
Если storeFailures отключена для дерева, этот конечный пункт не вернёт никаких данных. Записи "Не соответствует" всё равно будут отображаться в журналах TSD.
Глаголы
- GET
Запросы
Для этого конечного пункта используются следующие поля
| Имя | Тип данных | Обязательно | Описание | Значение по умолчанию | QS | RW | Пример |
|---|---|---|---|---|---|---|---|
| treeId | Целое число | Обязательно | Идентификатор дерева, через которое нужно передать объекты TSMeta | treeid | 1 | ||
| tsuids | Строка | Обязательно | Список одного или нескольких TSUID для поиска записей "не соответствует". Если запрашивается проверка более одного TSUID, они должны быть разделены запятыми. | tsuids | 000001000001000001,00000200000200002 |
Ответ
Успешный ответ вернёт карту пар ключ-значение, где необработанный TSUID является ключом, а сообщение о том, какое правило не соответствует, является значением. Ответ вернёт только найденные записи "не соответствует". Если один или несколько запрошенных TSUID не привели к записи "не соответствует", они не будут возвращены в результате. Это может означать, что TSMeta ещё не обработана. Обратите внимание, что если не произошло неудачных соответствий или дерево ещё не обработало никаких данных, результат будет пустым. Если запрошенного дерева не было в системе, будет возвращён 404 с сообщением об ошибке. Если были предоставлены неверные данные, будет возвращена ошибка 400.
Пример ответа
{
"010101": "Failed rule 0:0",
"020202": "Failed rule 1:1"
}
© 2010–2016 The OpenTSDB Authors
Licensed under the GNU LGPLv2.1+ and GPLv3+ licenses.
http://opentsdb.net/docs/build/html/api_http/tree/notmatched.html
