Статистика по галереям шарда
Вы можете отображать прямо в браузере статистику по галереям того или иного шарда tntapi
в JSON-формате. Данный функционал может быть использован в системах мониторинга.
Примечание
В случае если FindFace Enterprise Server развернут на одиночном физическом сервере, база данных Tarantool по умолчанию будет доступна только локально (127.0.0.1
). Если необходимо открыть доступ к базе данных Tarantool с удаленного сервера, внесите изменения в файл конфигурации findface-tarantool-server
.
В этом разделе:
Получение списка галерей
Для того чтобы отобразить список всех галерей, относящихся к шарду, введите в строке адреса браузера:
http://<tarantool_host_ip:shard_port>/stat/list/:start/:limit
:start
: номер галереи, с которой начинается список.:limit
: максимальное количество галерей в списке.Ответ будет содержать JSON со следующими полями:
next
: курсор для получения следующей страницы с результатами; передайте его как значение параметра :start_id в следующем запросеtotal
: общее количество галерей на шардеgalleries
: список галерей со следующими данными:id
: id галереиname
: имя галереиcnt_linear
: количество лиц в пространствеlinear
(лиц без быстрого индекса)cnt_preindex
: количество лиц в пространствеpreindex
(в промежуточной стадии создания быстрого индекса)cnt_indexed
: количество лиц в пространствеindexed
(лиц с быстрым индексом)
Пример
Запрос
http://127.0.0.1:8001/stat/list/1/99
or
curl http://127.0.0.1:8001/stat/list/1/99 \| jq
Ответ
HTTP/1.1 200 Ok
Content-length: 170
Server: Tarantool http (tarantool v1.7.3-673-g23cc4dc)
Connection: keep-alive
{"next":3,"galleries":[{"cnt_indexed":3,"id":1,"cnt_preindex":0,"name":"a","cnt_linear":0},{"cnt_indexed":1,"id":2,"cnt_preindex":0,"name":"b","cnt_linear":1}],"total":5}
Получение информации по галерее
Для получения информации по галерее, введите в адресной строке браузера:
http://<tarantool_host_ip:shard_port>/stat/info/:name
:name
: имя галереи.
Ответ будет содержать JSON со следующими полями:
id
: id галереиname
: имя галереиcptr
: адрес uint64_t объекта галереи в памятиcnt_linear
: количество лиц в пространствеlinear
cnt_preindex
: количество лиц в пространствеpreindex
cnt_preindex_deleted
: количество лиц, удаленных из пространстваpreindex
, которые физически еще присутствуют в Tarantoolcnt_indexed
: количество лиц в пространствеindexed
cnt_indexed_deleted
: количество лиц в пространствеindexed
, которые физически еще присутствуют в Tarantoolindex_file
: путь к файлу быстрого индексаindex_loaded
: индикатор того, был ли загружен быстрый индекс
Пример
Запрос
http://127.0.0.1:8001/stat/info/my_gal
or
curl http://127.0.0.1:8001/stat/info/my_gal | jq
Ответ
HTTP/1.1 200 Ok
Content-length: 196
Server: Tarantool http (tarantool v1.7.3-673-g23cc4dc)
Connection: keep-alive
{"cnt_indexed":2464344,"cnt_preindex_deleted":139,"index_file":"none","index_loaded":false,"cnt_preindex":8310,"cnt_linear":959,"cptr":29253696,"id":1,"name":"my_gal","cnt_indexed_deleted":78811}