› › ›

API получения статистики обновления модели снимка задачи обнаружения аномалий

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

Запрос

GET _ml/anomaly_detectors/<job_id>/model_snapshots/<snapshot_id>/_upgrade/_stats

GET _ml/anomaly_detectors/<job_id>,<job_id>/model_snapshots/_all/_upgrade/_stats

GET _ml/anomaly_detectors/_all/model_snapshots/_all/_upgrade/_stats

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

Требуется привилегия кластера monitor_ml. Эта привилегия включена в встроенную роль machine_learning_user.

Описание

Обновления снимка модели задачи обнаружения аномалий являются временными. Будут возвращены только обновления, которые находятся в процессе выполнения на момент вызова этого API.

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

<job_id>

(строка) Идентификатор задачи обнаружения аномалий. Это может быть идентификатор задачи, имя группы или выражение с подстановкой.

<snapshot_id>

(строка) Идентификатор снимка модели.

Статистику по нескольким обновлениям снимка модели задачи обнаружения аномалий в одном запросе API можно получить, используя список идентификаторов снимков, разделенных запятыми. Также можно использовать выражения с подстановкой или _all.

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

allow_no_match

(Необязательно, логическое значение) Указывает, что делать при запросе:

Содержит выражения с подстановкой, и нет совпадающих задач.
Содержит строку _all или нет идентификаторов, и нет совпадений.
Содержит выражения с подстановкой, и есть только частичные совпадения.

Значение по умолчанию - true, которое возвращает пустой массив jobs при отсутствии совпадений и подмножество результатов при частичном совпадении. Если этот параметр равен false, запрос возвращает код состояния 404 при отсутствии совпадений или только частичном совпадении.

Тело ответа

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

assignment_explanation

(строка) Только для начатых каналов данных, содержит сообщения, относящиеся к выбору узла.

job_id

(строка) Идентификатор задачи обнаружения аномалий.

node

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

Подробности

attributes: (объект) Перечисляет атрибуты узла, такие как настройки ml.machine_memory или ml.max_open_jobs.
ephemeral_id: (строка) Временный идентификатор узла.
id: (строка) Уникальный идентификатор узла.
name: (строка) Имя узла. Например, 0-o0tOo.
transport_address: (строка) Хост и порт, где принимаются транспортные HTTP-соединения.

snapshot_id

(строка) Числовая строка, которая уникально идентифицирует снимок модели. Например, 1575402236000.

state

(строка) Одно из значений loading_old_state, saving_new_state, stopped или failed.

Коды ответов

404 (Отсутствуют ресурсы): Если allow_no_match равно false, этот код указывает, что ресурсов, соответствующих запросу, нет или есть только частичные совпадения с запросом.

Примеры

resp = client.ml.get_model_snapshot_upgrade_stats(
    job_id="low_request_rate",
    snapshot_id="_all",
)
print(resp)

response = client.ml.get_model_snapshot_upgrade_stats(
  job_id: 'low_request_rate',
  snapshot_id: '_all'
)
puts response

const response = await client.ml.getModelSnapshotUpgradeStats({
  job_id: "low_request_rate",
  snapshot_id: "_all",
});
console.log(response);

GET _ml/anomaly_detectors/low_request_rate/model_snapshots/_all/_upgrade/_stats

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

{
  "count" : 1,
  "model_snapshot_upgrades" : [
    {
      "job_id" : "low_request_rate",
      "snapshot_id" : "1828371",
      "state" : "saving_new_state",
      "node" : {
        "id" : "7bmMXyWCRs-TuPfGJJ_yMw",
        "name" : "node-0",
        "ephemeral_id" : "hoXMLZB0RWKfR9UPPUCxXX",
        "transport_address" : "127.0.0.1:9300",
        "attributes" : {
          "ml.machine_memory" : "17179869184",
          "ml.max_open_jobs" : "512"
        }
      },
      "assignment_explanation" : ""
    }
  ]
}

© 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/ml-get-job-model-snapshot-upgrade-stats.html