› › ›

API GeoIP stats

Получает статистику о geoip процессоре, включая статистику загрузок баз данных GeoIP2, используемых с ним.

resp = client.ingest.geo_ip_stats()
print(resp)

response = client.ingest.geo_ip_stats
puts response

const response = await client.ingest.geoIpStats();
console.log(response);

GET _ingest/geoip/stats

Запрос

GET _ingest/geoip/stats

Предварительные условия

Если в Elasticsearch включены функции безопасности, у вас должны быть monitor или manage права на доступ к кластеру для использования этого API.
Если ingest.geoip.downloader.enabled отключен и не настроены пользовательские базы данных, этот API возвращает нулевые значения и пустой nodes объект.

Тело ответа

stats

(объект) Статистика загрузки всех баз данных GeoIP2.

Свойства stats

successful_downloads: (целое число) Общее количество успешных загрузок баз данных.
failed_downloads: (целое число) Общее количество неудачных загрузок баз данных.
total_download_time: (целое число) Общее количество миллисекунд, затраченное на загрузку баз данных.
database_count: (целое число) Текущее количество доступных баз данных.
skipped_updates: (целое число) Общее количество пропущенных обновлений баз данных.

nodes

(объект) Статистика для каждого узла.

Свойства nodes

<node_id>

(объект) Загруженные базы данных для узла. Ключ поля — идентификатор узла.

Свойства <node_id>

databases

(массив объектов) Загруженные базы данных для узла.

Свойства объектов databases

name: (строка) Название базы данных.

cache_stats

(объект) Статистика кэша GeoIP для узла.

Свойства cache_stats

count: (длинное целое число) Количество кэшированных записей.
hits: (длинное целое число) Количество обращений к кэшу для обогащения данных.
misses: (длинное целое число) Количество случаев, когда данные не были получены из кэша.
evictions: (длинное целое число) Количество удаленных из кэша записей.
hits_time_in_millis: (длинное целое число) Время в миллисекундах, затраченное на извлечение данных из кэша при успешном попадании в кэш.
misses_time_in_millis: (длинное целое число) Время в миллисекундах, затраченное на извлечение данных из кэша и базовой базы данных GeoIP2 и обновление кэша, только при промахе в кэше.

files_in_temp

(массив строк) Загруженные файлы баз данных, включая связанные лицензионные файлы. Elasticsearch хранит эти файлы в временной папке узла: $ES_TMPDIR/geoip-databases/<node_id>.

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/8.17/geoip-stats-api.html