Nodes hot threads APIedit

Returns the hot threads on each selected node in the cluster.


GET /_nodes/hot_threads

GET /_nodes/<node_id>/hot_threads


  • If the Elasticsearch security features are enabled, you must have the monitor or manage cluster privilege to use this API.


This API yields a breakdown of the hot threads on each selected node in the cluster. The output is plain text with a breakdown of each node’s top hot threads.

Path parametersedit

(Optional, string) Comma-separated list of node IDs or names used to limit returned information.

Query parametersedit

(Optional, Boolean) If true, known idle threads (e.g. waiting in a socket select, or to get a task from an empty queue) are filtered out. Defaults to true.
(Optional, time units) The interval to do the second sampling of threads. Defaults to 500ms.
(Optional, integer) Number of samples of thread stacktrace. Defaults to 10.
(Optional, integer) Specifies the number of hot threads to provide information for. Defaults to 3. If you are using this API for troubleshooting, set this parameter to a large number (e.g. 9999) to get information about all the threads in the system.
(Optional, time units) Specifies how long to wait for a response from each node. If omitted, waits forever.
(Optional, string) The type to sample. Available options are block, cpu, and wait. Defaults to cpu.


response = client.nodes.hot_threads
puts response

response = client.nodes.hot_threads(
  node_id: 'nodeId1,nodeId2'
puts response
GET /_nodes/hot_threads
GET /_nodes/nodeId1,nodeId2/hot_threads