CAT tasks

Introduced 1.0

The CAT tasks operation lists the progress of all tasks currently running on your cluster.

Path and HTTP methods

  1. GET _cat/tasks

URL parameters

All CAT tasks URL parameters are optional.

In addition to the common URL parameters, you can specify the following parameters:

ParameterTypeDescription
nodesListA comma-separated list of node IDs or names to limit the returned information. Use _local to return information from the node you’re connecting to, specify the node name to get information from specific nodes, or keep the parameter empty to get information from all nodes.
detailedBooleanReturns detailed task information. (Default: false)
parent_task_idStringReturns tasks with a specified parent task ID (node_id:task_number). Keep empty or set to -1 to return all.
timeTimeSpecify the units for time. For example, 5d or 7h. For more information, see Supported units.

Example request

The following example request lists all tasks in progress:

  1. GET _cat/tasks?v

copy

Example response

  1. action | task_id | parent_task_id | type | start_time | timestamp | running_time | ip | node
  2. cluster:monitor/tasks/lists | 1vo54NuxSxOrbPEYdkSF0w:168062 | - | transport | 1624337809471 | 04:56:49 | 489.5ms | 172.18.0.4 | odfe-node1