› › ›

Отправка данных в API для работы с задачами

Устарело в версии 7.11.0.

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

Отправляет данные в задачу обнаружения аномалий для анализа.

Запрос

POST _ml/anomaly_detectors/<job_id>/_data

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

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

Описание

Задача должна иметь состояние open, чтобы получать и обрабатывать данные.

Данные, которые вы отправляете в задачу, должны быть в формате JSON. Можно отправлять несколько документов JSON, либо рядом друг с другом без разделителей, либо с разделителями пробелов. Разделение по новой строке (NDJSON) — это возможный вариант разделителя пробелами, и для этого заголовок Content-Type должен быть установлен на application/x-ndjson.

Размеры загрузок ограничены размером буфера приёма HTTP Elasticsearch (по умолчанию 100 Мб). Если ваши данные больше, разбейте их на несколько частей и загружайте каждую часть по отдельности в последовательном временном порядке. При работе в реальном времени обычно рекомендуется выполнять множество небольших загрузок, а не накапливать данные для загрузки больших файлов.

При загрузке данных проверяйте количество данных задачи для отслеживания прогресса. Следующие документы не будут обработаны:

Документы, не упорядоченные по времени, и вне окна задержек
Записи с недействительной меткой времени

Для каждой задачи данные могут приниматься только с одного соединения за раз. В настоящее время невозможно отправлять данные в несколько задач с помощью подстановочных знаков или запятой.

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

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

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

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

Тело запроса

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

Примеры

В следующем примере данные из файла it_ops_new_kpi.json отправляются в задачу it_ops_new_kpi:

$ curl -s -H "Content-type: application/json"
-X POST http:\/\/localhost:9200/_ml/anomaly_detectors/it_ops_new_kpi/_data
--data-binary @it_ops_new_kpi.json

При отправке данных вы получаете информацию о ходе выполнения задачи. Например:

{
	"job_id":"it_ops_new_kpi",
	"processed_record_count":21435,
	"processed_field_count":64305,
	"input_bytes":2589063,
	"input_field_count":85740,
	"invalid_date_count":0,
	"missing_field_count":0,
	"out_of_order_timestamp_count":0,
	"empty_bucket_count":16,
	"sparse_bucket_count":0,
	"bucket_count":2165,
	"earliest_record_timestamp":1454020569000,
	"latest_record_timestamp":1455318669000,
	"last_data_time":1491952300658,
	"latest_empty_bucket_timestamp":1454541600000,
	"input_record_count":21435
}

Дополнительную информацию об этих свойствах см. в Теле ответа.

© 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-post-data.html