› › ›

API использования функций узлов

Возвращает информацию об использовании функций.

Запрос

GET /_nodes/usage

GET /_nodes/<node_id>/usage

GET /_nodes/usage/<metric>

GET /_nodes/<node_id>/usage/<metric>

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

Если включены функции безопасности Elasticsearch, для использования этого API у вас должна быть monitor или manage привилегия кластера.

Описание

API использования узлов кластера позволяет получить информацию об использовании функций для каждого узла. Все параметры выбора узлов объясняются здесь.

Параметры пути

<metric>

(Необязательно, строка) Ограничивает возвращаемую информацию до определённых метрик. Запятая, разделяющая список следующих опций:

_all: Возвращает все статистические данные.
rest_actions: Возвращает имя класса действий REST с количеством вызовов этого действия на узле.

<node_id>

(Необязательно, строка) Список идентификаторов или имён узлов, разделённых запятыми, используемый для ограничения возвращаемой информации.

Параметры запроса

timeout: (Необязательно, единицы времени) Период ожидания ответа каждого узла. Если узел не отвечает в течение заданного таймаута, информация о нём не включается в ответ. Однако, узлы с таймаутом включены в свойство ответа _nodes.failed. По умолчанию таймаут отсутствует.

Примеры

Пример действия REST:

resp = client.nodes.usage()
print(resp)

response = client.nodes.usage
puts response

const response = await client.nodes.usage();
console.log(response);

GET _nodes/usage

API возвращает следующий ответ:

{
  "_nodes": {
    "total": 1,
    "successful": 1,
    "failed": 0
  },
  "cluster_name": "my_cluster",
  "nodes": {
    "pQHNt5rXTTWNvUgOrdynKg": {
      "timestamp": 1492553961812, 
      "since": 1492553906606, 
      "rest_actions": {
        "nodes_usage_action": 1,
        "create_index_action": 1,
        "document_get_action": 1,
        "search_action": 19, 
        "nodes_info_action": 36
      },
      "aggregations": {
        ...
      }
    }
  }
}

	Отметка времени выполнения запроса использования узлов.
	Отметка времени начала записи информации об использовании. Эквивалентно времени запуска узла.
	Действие поиска вызывалось 19 раз для этого узла.

© 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/cluster-nodes-usage.html