anchor.diff:  [[cat-thread-pool]]
   === cat thread pool
   
  -The `thread_pool` command shows cluster wide thread pool statistics per node. By default the active, queue and rejected
  -statistics are returned for all thread pools.
  +Returns thread pool statistics for each node in a cluster. Returned information
  +includes all <<modules-threadpool,built-in thread pools>> and custom thread
  +pools.
  +
  +
  +[[cat-thread-pool-api-request]]
  +==== {api-request-title}
  +
  +`GET /_cat/thread_pool/{thread_pool}`
  +
  +[[cat-thread-pool-path-params]]
  +==== {api-path-parms-title}
  +
  +`{thread_pool}`::
  +(Optional, string) Comma-separated list of thread pool names used to limit the
  +request. Accepts wildcard expressions.
  +
  +
  +[[cat-thread-pool-query-params]]
  +==== {api-query-parms-title}
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=http-format]
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=cat-h]
  ++
  +--
  +If you do not specify which columns to include, the API returns the default
  +columns in the order listed below. If you explicitly specify one or more
  +columns, it only returns the specified columns.
  +
  +Valid columns are:
  +
  +`node_name`::
  +(Default) Node name, such as `I8hydUG`.
  +
  +`name`::
  +(Default) Name of the thread pool, such as `analyze` or `generic`.
  +
  +`active`, `a`::
  +(Default) Number of active threads in the current thread pool.
  +
  +`queue`,`q`::
  +(Default) Number of tasks in the queue for the current thread pool.
  +
  +`rejected`, `r`::
  +(Default) Number of tasks rejected by the thread pool executor.
  +
  +`completed`, `c`::
  +Number of tasks completed by the thread pool executor.
  +
  +`core`, `cr`::
  +Configured core number of active threads allowed in the current thread pool.
  +
  +`ephemeral_id`,`eid`::
  +Ephemeral node ID.
  +
  +`host`, `h`::
  +Hostname for the current node.
  +
  +`ip`, `i`::
  +IP address for the current node.
  +
  +`keep_alive`, `k`::
  +Configured keep alive time for threads.
  +
  +`largest`, `l`::
  +Highest number of active threads in the current thread pool.
  +
  +`max`, `mx`::
  +Configured maximum number of active threads allowed in the current thread pool.
  +
  +`node_id`, `id`::
  +ID of the node, such as `k0zy`.
  +
  +`pid`, `p`::
  +Process ID of the running node.
  +
  +`pool_size`, `psz`::
  +Number of threads in the current thread pool.
  +
  +`port`, `po`::
  +Bound transport port for the current node.
  +
  +`queue_size`, `qs`::
  +Maximum number of tasks permitted in the queue for the current thread pool.
  +
  +`size`, `sz`::
  +Configured fixed number of active threads allowed in the current thread pool.
  +
  +`type`, `t`::
  +Type of thread pool. Returned values are `fixed` or `scaling`.
  +
  +--
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=help]
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=local]
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=master-timeout]
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=cat-s]
  +
  +`size`::
  +(Optional, <<size-units, size unit>>) Multiplier used to display quantities.
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=cat-v]
  +
  +
  +[[cat-thread-pool-api-example]]
  +==== {api-examples-title}
  +
  +[[cat-thread-pool-api-ex-default]]
  +===== Example with default columns
   
   [source,js]
   --------------------------------------------------
  
positive.code: --------------------------------------------------
  // CONSOLE
  
  which looks like:
  
  [source,txt]
  --------------------------------------------------
  
negative.code: //    know how many there will be and we just want to assert that there are
  //    numbers in the response, not *which* numbers are there.
  
  
  [[cat-thread-pool-api-ex-headings]]
  ===== Example with explicit columns
  
  The following API request returns the `id`, `name`, `active`, `rejected`, and
  `completed` columns. The request limits returned information to the `generic`
  thread pool.
  
  [source,js]
  --------------------------------------------------
  