WARNING: Version 1.7 of Elasticsearch has passed its EOL date.

This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.

› ›

cat thread pool

edit

cat thread pool

edit

The thread_pool command shows cluster wide thread pool statistics per node. By default the active, queue and rejected statistics are returned for the bulk, index and search thread pools.

% curl 192.168.56.10:9200/_cat/thread_pool
host1 192.168.1.35 0 0 0 0 0 0 0 0 0
host2 192.168.1.36 0 0 0 0 0 0 0 0 0

The first two columns contain the host and ip of a node.

host      ip
host1 192.168.1.35
host2 192.168.1.36

The next three columns show the active queue and rejected statistics for the bulk thread pool.

bulk.active bulk.queue bulk.rejected
          0          0             0

The remaining columns show the active queue and rejected statistics of the index and search thread pool respectively.

Also other statistics of different thread pools can be retrieved by using the h (header) parameter.

% curl 'localhost:9200/_cat/thread_pool?v&h=id,host,suggest.active,suggest.rejected,suggest.completed'
host      suggest.active suggest.rejected suggest.completed
host1                  0                0                 0
host2                  0                0                 0

Here the host columns and the active, rejected and completed suggest thread pool statistic are displayed. The suggest thread pool won’t be displayed by default, so you always need to be specific about what statistic you want to display.

Available Thread Pools

edit

Currently available thread pools:

Thread Pool	Alias	Description
`bulk`	`b`	Thread pool used for bulk operations
`flush`	`f`	Thread pool used for flush operations
`generic`	`ge`	Thread pool used for generic operations (e.g. background node discovery)
`get`	`g`	Thread pool used for get operations
`index`	`i`	Thread pool used for index/delete operations
`management`	`ma`	Thread pool used for management of Elasticsearch (e.g. cluster management)
`merge`	`m`	Thread pool used for merge operations
`optimize`	`o`	Thread pool used for optimize operations
`percolate`	`p`	Thread pool used for percolator operations
`refresh`	`r`	Thread pool used for refresh operations
`search`	`s`	Thread pool used for search/count operations
`snapshot`	`sn`	Thread pool used for snapshot operations
`suggest`	`su`	Thread pool used for suggester operations
`warmer`	`w`	Thread pool used for index warm-up operations

The thread pool name (or alias) must be combined with a thread pool field below to retrieve the requested information.

Thread Pool Fields

edit

For each thread pool, you can load details about it by using the field names in the table below, either using the full field name (e.g. bulk.active) or its alias (e.g. sa is equivalent to search.active).

Field Name	Alias	Description
`type`	`t`	The current (*) type of thread pool (`cached`, `fixed` or `scaling`)
`active`	`a`	The number of active threads in the current thread pool
`size`	`s`	The number of threads in the current thread pool
`queue`	`q`	The number of tasks in the queue for the current thread pool
`queueSize`	`qs`	The maximum number of tasks in the queue for the current thread pool
`rejected`	`r`	The number of rejected threads in the current thread pool
`largest`	`l`	The highest number of active threads in the current thread pool
`completed`	`c`	The number of completed threads in the current thread pool
`min`	`mi`	The configured minimum number of active threads allowed in the current thread pool
`max`	`ma`	The configured maximum number of active threads allowed in the current thread pool
`keepAlive`	`k`	The configured keep alive time for threads

Other Fields

edit

In addition to details about each thread pool, it is also convenient to get an understanding of where those thread pools reside. As such, you can request other details like the ip of the responding node(s).

Field Name	Alias	Description
`id`	`nodeId`	The unique node ID
`pid`	`p`	The process ID of the running node
`host`	`h`	The hostname for the current node
`ip`	`i`	The IP address for the current node
`port`	`po`	The bound transport port for the current node

« cat recovery cat shards »