› › ›

API для возврата моментальных снимков моделей

Возвращает определённый моментальный снимок.

Запрос

POST _ml/anomaly_detectors/<job_id>/model_snapshots/<snapshot_id>/_revert

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

Перед возвратом к сохранённому моментальному снимку необходимо закрыть задачу.
Требуется привилегия кластера manage_ml. Эта привилегия включена в встроенную роль machine_learning_admin.

Описание

Функции машинного обучения быстро реагируют на аномальные входные данные, изучая новые модели поведения в данных. Высокоаномальные входные данные увеличивают дисперсию в моделях, в то время как система определяет, является ли это новым существенным изменением поведения или разовым событием. Если известно, что эти аномальные данные являются разовым событием, возможно, стоит сбросить состояние модели до момента перед этим событием. Например, после «Чёрной пятницы» или критической неисправности системы можно рассмотреть возможность возврата к сохранённому моментальному снимку.

Возврат к моментальному снимку не изменяет значения data_counts задачи обнаружения аномалий, эти значения не возвращаются к предыдущему состоянию.

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

<job_id>

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

<snapshot_id>

(Обязательно, строка) Идентификатор моментального снимка модели.

Можно указать empty как значение <snapshot_id>. Возврат к empty моментальному снимку означает, что задача обнаружения аномалий начнёт обучение новой модели с нуля при её запуске.

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

delete_intervening_results: (Необязательно, логическое значение) Если значение true, удаляет результаты в промежутке времени между последними результатами и временем восстановления моментального снимка. Также сбрасывает модель для принятия записей в этот период. Значение по умолчанию — false.

Если при восстановлении моментального снимка не удалить промежуточные результаты, задача не будет принимать входные данные, которые старше текущего времени. Если необходимо повторно отправить данные, удалите промежуточные результаты.

Тело запроса

Вы также можете указать параметр запроса delete_intervening_results в теле запроса.

Примеры

resp = client.ml.revert_model_snapshot(
    job_id="low_request_rate",
    snapshot_id="1637092688",
    delete_intervening_results=True,
)
print(resp)

response = client.ml.revert_model_snapshot(
  job_id: 'low_request_rate',
  snapshot_id: 1_637_092_688,
  body: {
    delete_intervening_results: true
  }
)
puts response

const response = await client.ml.revertModelSnapshot({
  job_id: "low_request_rate",
  snapshot_id: 1637092688,
  delete_intervening_results: true,
});
console.log(response);

POST _ml/anomaly_detectors/low_request_rate/model_snapshots/1637092688/_revert
{
  "delete_intervening_results": true
}

По завершении операции вы получите следующие результаты:

{
  "model" : {
    "job_id" : "low_request_rate",
    "min_version" : "7.11.0",
    "timestamp" : 1637092688000,
    "description" : "State persisted due to job close at 2021-11-16T19:58:08+0000",
    "snapshot_id" : "1637092688",
    "snapshot_doc_count" : 1,
    "model_size_stats" : {
      "job_id" : "low_request_rate",
      "result_type" : "model_size_stats",
      "model_bytes" : 45200,
      "peak_model_bytes" : 101552,
      "model_bytes_exceeded" : 0,
      "model_bytes_memory_limit" : 11534336,
      "total_by_field_count" : 3,
      "total_over_field_count" : 0,
      "total_partition_field_count" : 2,
      "bucket_allocation_failures_count" : 0,
      "memory_status" : "ok",
      "assignment_memory_basis" : "current_model_bytes",
      "categorized_doc_count" : 0,
      "total_category_count" : 0,
      "frequent_category_count" : 0,
      "rare_category_count" : 0,
      "dead_category_count" : 0,
      "failed_category_count" : 0,
      "categorization_status" : "ok",
      "log_time" : 1637092688530,
      "timestamp" : 1641495600000
    },
    "latest_record_time_stamp" : 1641502169000,
    "latest_result_time_stamp" : 1641495600000,
    "retain" : false
  }
}

Описание этих свойств см. в API для получения моментальных снимков моделей.

© 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-revert-snapshot.html