OpenSearch/docs/en/rest-api/ml/get-datafeed-stats.asciidoc

80 lines
1.7 KiB
Plaintext

//lcawley Verified example output 2017-04-11
[[ml-get-datafeed-stats]]
==== Get {dfeed-cap} Statistics
The get {dfeed} statistics API enables you to retrieve usage information for
{dfeeds}.
===== Request
`GET _xpack/ml/datafeeds/_stats` +
`GET _xpack/ml/datafeeds/<feed_id>/_stats`
===== Description
If the {dfeed} is stopped, the only information you receive is the
`datafeed_id` and the `state`.
===== Path Parameters
`feed_id`::
(string) Identifier for the {dfeed}.
This parameter does not support wildcards, but you can specify `_all` or
omit the `feed_id` to get information about all {dfeeds}.
===== Results
The API returns the following information:
`datafeeds`::
(array) An array of {dfeed} count objects.
For more information, see <<ml-datafeed-counts>>.
===== 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 gets usage information for the
`datafeed-farequote` {dfeed}:
[source,js]
--------------------------------------------------
GET _xpack/ml/datafeeds/datafeed-farequote/_stats
--------------------------------------------------
// CONSOLE
// TEST[skip:todo]
The API returns the following results:
[source,js]
----
{
"count": 1,
"datafeeds": [
{
"datafeed_id": "datafeed-farequote",
"state": "started",
"node": {
"id": "IO_gxe2_S8mrzu7OpmK5Jw",
"name": "IO_gxe2",
"ephemeral_id": "KHMWPZoMToOzSsZY9lDDgQ",
"transport_address": "127.0.0.1:9300",
"attributes": {
"max_running_jobs": "10"
}
},
"assignment_explanation": ""
}
]
}
----