Nodes hot threads APIedit
Returns the hot threads on each selected node in the cluster.
Prerequisitesedit
-
If the Elasticsearch security features are enabled, you must have the
monitor
ormanage
cluster privilege to use this API.
Descriptionedit
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
-
<node_id>
- (Optional, string) Comma-separated list of node IDs or names used to limit returned information.
Query parametersedit
-
ignore_idle_threads
- (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.
-
interval
-
(Optional, time units) The interval to do the second
sampling of threads. Defaults to
500ms
. -
snapshots
-
(Optional, integer) Number of samples of thread stacktrace. Defaults to
10
. -
threads
-
(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. -
master_timeout
-
(Optional, time units)
Period to wait for a connection to the master node. If no response is received
before the timeout expires, the request fails and returns an error. Defaults to
30s
. -
timeout
-
(Optional, time units)
Period to wait for a response. If no response is received before the timeout
expires, the request fails and returns an error. Defaults to
30s
. -
type
-
(Optional, string) The type to sample. Available options are
block
,cpu
, andwait
. Defaults tocpu
.
Examplesedit
GET /_nodes/hot_threads GET /_nodes/nodeId1,nodeId2/hot_threads