This documentation contains work-in-progress information for future Elastic Stack and Cloud releases. Use the version selector to view supported release docs. It also contains some Elastic Cloud serverless information. Check out our serverless docs for more details.
Get data stream lifecycle stats
editGet data stream lifecycle stats
editGets stats about the execution of data stream lifecycle.
Prerequisites
edit-
If the Elasticsearch security features are enabled, you must have the
monitorormanagecluster privilege to use this API.
Request
editGET _lifecycle/stats
Description
editGets stats about the execution of the data stream lifecycle. The data stream level stats include only stats about data streams managed by the data stream lifecycle.
Response body
edit-
last_run_duration_in_millis - (Optional, long) The duration of the last data stream lifecycle execution.
-
time_between_starts_in_millis -
(Optional, long)
The time passed between the start of the last two data stream lifecycle executions. This should amount approximately to
data_streams.lifecycle.poll_interval. -
data_stream_count - (integer) The count of data streams currently being managed by the data stream lifecycle.
-
data_streams -
(array of objects) Contains information about the retrieved data stream lifecycles.
Properties of objects in
data_streams-
name - (string) The name of the data stream.
-
backing_indices_in_total - (integer) The count of the backing indices of this data stream that are managed by the data stream lifecycle.
-
backing_indices_in_error - (integer) The count of the backing indices of this data stream that are managed by the data stream lifecycle and have encountered an error.
-
Examples
editLet’s retrieve the data stream lifecycle stats of a cluster that has already executed the lifecycle more than once:
GET _lifecycle/stats?human&pretty
The response will look like the following:
{
"last_run_duration_in_millis": 2,
"last_run_duration": "2ms",
"time_between_starts_in_millis": 9998,
"time_between_starts": "9.99s",
"data_streams_count": 2,
"data_streams": [
{
"name": "my-data-stream",
"backing_indices_in_total": 2,
"backing_indices_in_error": 0
},
{
"name": "my-other-stream",
"backing_indices_in_total": 2,
"backing_indices_in_error": 1
}
]
}