OpenSearch/docs/en/rest-api/ml/preview-datafeed.asciidoc

65 lines
1.4 KiB
Plaintext

//lcawley: Verified example output 2017-04-11
[[ml-preview-datafeed]]
==== Preview {dfeeds-cap}
The preview {dfeed} API enables you to preview a {dfeed}.
===== Request
`GET _xpack/ml/datafeeds/<datafeed_id>/_preview`
===== Description
The API returns the first "page" of results from the `search` that is created
by using the current {dfeed} settings. This preview shows the structure of
the data that will be passed to the anomaly detection engine.
===== Path Parameters
`datafeed_id` (required)::
(string) Identifier for the {dfeed}
===== Authorization
You must have `monitor_ml`, `monitor`, `manage_ml`, or `manage` cluster
privileges to use this API. For more information, see <<privileges-list-cluster>>.
===== Examples
The following example obtains a preview of the `datafeed-farequote` {dfeed}:
[source,js]
--------------------------------------------------
GET _xpack/ml/datafeeds/datafeed-farequote/_preview
--------------------------------------------------
// CONSOLE
// TEST[skip:todo]
The data that is returned for this example is as follows:
[source,js]
----
[
{
"@timestamp": 1454803200000,
"airline": "AAL",
"responsetime": 132.20460510253906
},
{
"@timestamp": 1454803200000,
"airline": "JZA",
"responsetime": 990.4628295898438
},
{
"@timestamp": 1454803200000,
"airline": "JBU",
"responsetime": 877.5927124023438
},
...
]
----