› › ›

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 в теле запроса.

Примеры

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/7.17/ml-revert-snapshot.html