2017-04-11 21:52:47 -04:00
|
|
|
//lcawley: Verified example output 2017-04-11
|
2017-04-04 18:26:39 -04:00
|
|
|
[[ml-post-data]]
|
|
|
|
==== Post Data to Jobs
|
|
|
|
|
2017-04-26 18:29:55 -04:00
|
|
|
The post data API enables you to send data to an anomaly detection job for analysis.
|
2017-04-04 18:26:39 -04:00
|
|
|
|
2017-04-25 17:08:29 -04:00
|
|
|
|
2017-04-04 18:26:39 -04:00
|
|
|
===== Request
|
|
|
|
|
2017-04-06 10:56:46 -04:00
|
|
|
`POST _xpack/ml/anomaly_detectors/<job_id>/_data --data-binary @<data-file.json>`
|
2017-04-04 18:26:39 -04:00
|
|
|
|
2017-04-25 17:08:29 -04:00
|
|
|
|
2017-04-04 18:26:39 -04:00
|
|
|
===== Description
|
|
|
|
|
2017-04-28 11:04:08 -04:00
|
|
|
The job must have a state of `open` to receive and process the data.
|
|
|
|
|
|
|
|
The data that you send to the job must use the JSON format.
|
|
|
|
|
|
|
|
File sizes are limited to 100 Mb. If your file is larger, split it into multiple
|
|
|
|
files and upload each one separately in sequential time order. When running in
|
|
|
|
real time, it is generally recommended that you perform many small uploads,
|
2017-04-27 14:17:06 -04:00
|
|
|
rather than queueing data to upload larger files.
|
2017-04-04 18:26:39 -04:00
|
|
|
|
2017-04-27 13:51:48 -04:00
|
|
|
When uploading data, check the <<ml-datacounts,job data counts>> for progress.
|
|
|
|
The following records will not be processed:
|
|
|
|
|
|
|
|
* Records not in chronological order and outside the latency window
|
|
|
|
* Records with an invalid timestamp
|
|
|
|
|
|
|
|
//TBD link to Working with Out of Order timeseries concept doc
|
|
|
|
|
2017-04-27 14:17:06 -04:00
|
|
|
IMPORTANT: Data can only be accepted from a single connection. Use a single
|
|
|
|
connection synchronously to send data, close, flush, or delete a single job.
|
2017-04-11 21:52:47 -04:00
|
|
|
It is not currently possible to post data to multiple jobs using wildcards
|
2017-04-27 14:17:06 -04:00
|
|
|
or a comma-separated list.
|
2017-04-04 18:26:39 -04:00
|
|
|
|
2017-04-18 18:13:21 -04:00
|
|
|
|
2017-04-04 18:26:39 -04:00
|
|
|
===== Path Parameters
|
|
|
|
|
|
|
|
`job_id` (required)::
|
2017-04-18 18:13:21 -04:00
|
|
|
(string) Identifier for the job
|
2017-04-04 18:26:39 -04:00
|
|
|
|
2017-04-25 17:08:29 -04:00
|
|
|
|
2017-04-04 18:26:39 -04:00
|
|
|
===== Request Body
|
|
|
|
|
|
|
|
`reset_start`::
|
2017-04-11 22:26:18 -04:00
|
|
|
(string) Specifies the start of the bucket resetting range
|
2017-04-04 18:26:39 -04:00
|
|
|
|
|
|
|
`reset_end`::
|
2017-04-18 18:13:21 -04:00
|
|
|
(string) Specifies the end of the bucket resetting range
|
2017-04-04 18:26:39 -04:00
|
|
|
|
|
|
|
|
2017-04-25 17:08:29 -04:00
|
|
|
===== Authorization
|
|
|
|
|
|
|
|
You must have `manage_ml`, or `manage` cluster privileges to use this API.
|
|
|
|
For more information, see <<privileges-list-cluster>>.
|
2017-04-04 18:26:39 -04:00
|
|
|
|
|
|
|
|
|
|
|
===== Examples
|
|
|
|
|
2017-04-06 10:56:46 -04:00
|
|
|
The following example posts data from the farequote.json file to the `farequote` job:
|
|
|
|
|
2017-04-04 18:26:39 -04:00
|
|
|
[source,js]
|
|
|
|
--------------------------------------------------
|
2017-04-06 10:56:46 -04:00
|
|
|
$ curl -s -H "Content-type: application/json"
|
2017-04-11 21:52:47 -04:00
|
|
|
-X POST http:\/\/localhost:9200/_xpack/ml/anomaly_detectors/it_ops_new_kpi/_data
|
|
|
|
--data-binary @it_ops_new_kpi.json
|
2017-04-04 18:26:39 -04:00
|
|
|
--------------------------------------------------
|
2017-04-06 10:56:46 -04:00
|
|
|
|
2017-04-11 21:52:47 -04:00
|
|
|
//TBD: Create example of how to post a small data example in Kibana?
|
|
|
|
|
2017-04-06 10:56:46 -04:00
|
|
|
When the data is sent, you receive information about the operational progress of the job.
|
|
|
|
For example:
|
2017-04-21 11:23:27 -04:00
|
|
|
|
|
|
|
[source,js]
|
2017-04-06 10:56:46 -04:00
|
|
|
----
|
|
|
|
{
|
2017-04-11 21:52:47 -04:00
|
|
|
"job_id":"it_ops_new_kpi",
|
|
|
|
"processed_record_count":21435,
|
|
|
|
"processed_field_count":64305,
|
|
|
|
"input_bytes":2589063,
|
|
|
|
"input_field_count":85740,
|
2017-04-06 10:56:46 -04:00
|
|
|
"invalid_date_count":0,
|
|
|
|
"missing_field_count":0,
|
|
|
|
"out_of_order_timestamp_count":0,
|
2017-04-11 21:52:47 -04:00
|
|
|
"empty_bucket_count":16,
|
2017-04-06 10:56:46 -04:00
|
|
|
"sparse_bucket_count":0,
|
2017-04-11 21:52:47 -04:00
|
|
|
"bucket_count":2165,
|
|
|
|
"earliest_record_timestamp":1454020569000,
|
|
|
|
"latest_record_timestamp":1455318669000,
|
|
|
|
"last_data_time":1491952300658,
|
|
|
|
"latest_empty_bucket_timestamp":1454541600000,
|
|
|
|
"input_record_count":21435
|
2017-04-06 10:56:46 -04:00
|
|
|
}
|
|
|
|
----
|
|
|
|
|
2017-04-19 13:52:30 -04:00
|
|
|
For more information about these properties, see <<ml-jobstats,Job Stats>>.
|