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