honeymoose
/
OpenSearch
mirror of https://github.com/honeymoose/OpenSearch.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
OpenSearch/docs/reference/cat/nodes.asciidoc

189 lines
8.7 KiB
Plaintext
Raw Normal View History

First pass at cat docs.
2013-11-14 20:14:39 -05:00
[[cat-nodes]]
[DOCS] Renamed the "cat" chapters to be more searchable
2014-05-16 15:43:35 -04:00
== cat nodes
First pass at cat docs.
2013-11-14 20:14:39 -05:00
CONSOLEify a few more _cat docs `_cat/master`, `_cat/nodeattrs`, `_cat/nodes`.
2016-10-13 16:42:21 -04:00
The `nodes` command shows the cluster topology. For example
First pass at cat docs.
2013-11-14 20:14:39 -05:00
CONSOLEify a few more _cat docs `_cat/master`, `_cat/nodeattrs`, `_cat/nodes`.
2016-10-13 16:42:21 -04:00
[source,js]
First pass at cat docs.
2013-11-14 20:14:39 -05:00
--------------------------------------------------
CONSOLEify a few more _cat docs `_cat/master`, `_cat/nodeattrs`, `_cat/nodes`.
2016-10-13 16:42:21 -04:00
GET /_cat/nodes?v
First pass at cat docs.
2013-11-14 20:14:39 -05:00
--------------------------------------------------
CONSOLEify a few more _cat docs `_cat/master`, `_cat/nodeattrs`, `_cat/nodes`.
2016-10-13 16:42:21 -04:00
// CONSOLE
First pass at cat docs.
2013-11-14 20:14:39 -05:00
CONSOLEify a few more _cat docs `_cat/master`, `_cat/nodeattrs`, `_cat/nodes`.
2016-10-13 16:42:21 -04:00
Might look like:
First pass at cat docs.
2013-11-14 20:14:39 -05:00
CONSOLEify a few more _cat docs `_cat/master`, `_cat/nodeattrs`, `_cat/nodes`.
2016-10-13 16:42:21 -04:00
[source,js]
First pass at cat docs.
2013-11-14 20:14:39 -05:00
--------------------------------------------------
CONSOLEify a few more _cat docs `_cat/master`, `_cat/nodeattrs`, `_cat/nodes`.
2016-10-13 16:42:21 -04:00
ip heap.percent ram.percent cpu load_1m load_5m load_15m node.role master name
127.0.0.1 65 99 42 3.07 mdi * mJw06l1
First pass at cat docs.
2013-11-14 20:14:39 -05:00
--------------------------------------------------
CONSOLEify a few more _cat docs `_cat/master`, `_cat/nodeattrs`, `_cat/nodes`.
2016-10-13 16:42:21 -04:00
// TESTRESPONSE[s/3.07/(\\d+\\.\\d+( \\d+\\.\\d+ (\\d+\\.\\d+)?)?)?/]
// TESTRESPONSE[s/65 99 42/\\d+ \\d+ \\d+/]
// TESTRESPONSE[s/[*]/[*]/ s/mJw06l1/.+/ _cat]
First pass at cat docs.
2013-11-14 20:14:39 -05:00
CONSOLEify a few more _cat docs `_cat/master`, `_cat/nodeattrs`, `_cat/nodes`.
2016-10-13 16:42:21 -04:00
The first few columns (`ip, `heap.percent`, `ram.percent`, `cpu, `load_*`) tell
you where your nodes live and give a quick picture of performance stats.
First pass at cat docs.
2013-11-14 20:14:39 -05:00
CONSOLEify a few more _cat docs `_cat/master`, `_cat/nodeattrs`, `_cat/nodes`.
2016-10-13 16:42:21 -04:00
The last (`node.role`, `master`, and `name`) columns provide ancillary
information that can often be useful when looking at the cluster as a whole,
particularly large ones. How many master-eligible nodes do I have?
[DOCS] Update nodes documentation with all headers Adds a table with the exhaustive list of all available headers with a brief description (mostly from `org.elasticsearch.rest.action.cat.RestNodesAction`) so that people do not need to go searching for them in the code like I did, or search through `nodes?help`.
2014-03-27 01:19:54 -04:00
[float]
=== Columns
Below is an exhaustive list of the existing headers that can be
passed to `nodes?h=` to retrieve the relevant details in ordered
columns. If no headers are specified, then those marked to Appear
by Default will appear. If any header is specified, then the defaults
are not used.
Aliases can be used in place of the full header name for brevity.
Columns appear in the order that they are listed below unless a
different order is specified (e.g., `h=pid,id` versus `h=id,pid`).
When specifying headers, the headers are not placed in the output
by default. To have the headers appear in the output, use verbose
mode (`v`). The header name will match the supplied value (e.g.,
`pid` versus `p`). For example:
CONSOLEify a few more _cat docs `_cat/master`, `_cat/nodeattrs`, `_cat/nodes`.
2016-10-13 16:42:21 -04:00
[source,js]
--------------------------------------------------
GET /_cat/nodes?v&h=id,ip,port,v,m
--------------------------------------------------
// CONSOLE
Might look like:
["source","js",subs="attributes,callouts"]
[DOCS] Update nodes documentation with all headers Adds a table with the exhaustive list of all available headers with a brief description (mostly from `org.elasticsearch.rest.action.cat.RestNodesAction`) so that people do not need to go searching for them in the code like I did, or search through `nodes?help`.
2014-03-27 01:19:54 -04:00
--------------------------------------------------
CONSOLEify a few more _cat docs `_cat/master`, `_cat/nodeattrs`, `_cat/nodes`.
2016-10-13 16:42:21 -04:00
id ip port v m
veJR 127.0.0.1 59938 {version} *
[DOCS] Update nodes documentation with all headers Adds a table with the exhaustive list of all available headers with a brief description (mostly from `org.elasticsearch.rest.action.cat.RestNodesAction`) so that people do not need to go searching for them in the code like I did, or search through `nodes?help`.
2014-03-27 01:19:54 -04:00
--------------------------------------------------
CONSOLEify a few more _cat docs `_cat/master`, `_cat/nodeattrs`, `_cat/nodes`.
2016-10-13 16:42:21 -04:00
// TESTRESPONSE[s/veJR/.+/ s/59938/\\d+/ s/[*]/[*]/ _cat]
[DOCS] Update nodes documentation with all headers Adds a table with the exhaustive list of all available headers with a brief description (mostly from `org.elasticsearch.rest.action.cat.RestNodesAction`) so that people do not need to go searching for them in the code like I did, or search through `nodes?help`.
2014-03-27 01:19:54 -04:00
Docs: Made current version, branch and jdk into asciidoc attributes
2014-07-23 05:54:53 -04:00
[cols="<,<,<,<,<",options="header",subs="normal"]
[DOCS] Update nodes documentation with all headers Adds a table with the exhaustive list of all available headers with a brief description (mostly from `org.elasticsearch.rest.action.cat.RestNodesAction`) so that people do not need to go searching for them in the code like I did, or search through `nodes?help`.
2014-03-27 01:19:54 -04:00
|=======================================================================
|Header |Alias |Appear by Default |Description |Example
|`id` |`nodeId` |No |Unique node ID |k0zy
|`pid` |`p` |No |Process ID |13061
|`ip` |`i` |Yes |IP address |127.0.1.1
|`port` |`po` |No |Bound transport port |9300
[DOCS] Cat nodes api: document recently added http column
2016-03-01 09:35:14 -05:00
|`http_address` |`http`| No | bound http address | 127.0.0.1:9200
Docs: Made current version, branch and jdk into asciidoc attributes
2014-07-23 05:54:53 -04:00
|`version` |`v` |No |Elasticsearch version |{version}
[DOCS] Update nodes documentation with all headers Adds a table with the exhaustive list of all available headers with a brief description (mostly from `org.elasticsearch.rest.action.cat.RestNodesAction`) so that people do not need to go searching for them in the code like I did, or search through `nodes?help`.
2014-03-27 01:19:54 -04:00
|`build` |`b` |No |Elasticsearch Build hash |5c03844
|`jdk` |`j` |No |Running Java version |1.8.0
|`disk.avail` |`d`, `disk`, `diskAvail` |No |Available disk space |1.8gb
Add file descriptor details to cat/nodes cat/nodes currently does not report any details related to file descriptors. This adds the current number in use, the maximum number available as well as their ratio (percentage) to cat/nodes as hidden-by-default metrics. In addition, this also adds current heap usage (as a non-percentage of ts max) and ram usage (as a non-percerntage of its max) to allow tools to provide more granularity. Closes #7652
2014-09-09 00:04:59 -04:00
|`heap.current` |`hc`, `heapCurrent` |No |Used heap |311.2mb
|`heap.percent` |`hp`, `heapPercent` |Yes |Used heap percentage |7
[DOCS] Update nodes documentation with all headers Adds a table with the exhaustive list of all available headers with a brief description (mostly from `org.elasticsearch.rest.action.cat.RestNodesAction`) so that people do not need to go searching for them in the code like I did, or search through `nodes?help`.
2014-03-27 01:19:54 -04:00
|`heap.max` |`hm`, `heapMax` |No |Maximum configured heap |1015.6mb
Add file descriptor details to cat/nodes cat/nodes currently does not report any details related to file descriptors. This adds the current number in use, the maximum number available as well as their ratio (percentage) to cat/nodes as hidden-by-default metrics. In addition, this also adds current heap usage (as a non-percentage of ts max) and ram usage (as a non-percerntage of its max) to allow tools to provide more granularity. Closes #7652
2014-09-09 00:04:59 -04:00
|`ram.current` |`rc`, `ramCurrent` |No |Used total memory |513.4mb
|`ram.percent` |`rp`, `ramPercent` |Yes |Used total memory percentage |47
[DOCS] Update nodes documentation with all headers Adds a table with the exhaustive list of all available headers with a brief description (mostly from `org.elasticsearch.rest.action.cat.RestNodesAction`) so that people do not need to go searching for them in the code like I did, or search through `nodes?help`.
2014-03-27 01:19:54 -04:00
|`ram.max` |`rm`, `ramMax` |No |Total memory |2.9gb
Add file descriptor details to cat/nodes cat/nodes currently does not report any details related to file descriptors. This adds the current number in use, the maximum number available as well as their ratio (percentage) to cat/nodes as hidden-by-default metrics. In addition, this also adds current heap usage (as a non-percentage of ts max) and ram usage (as a non-percerntage of its max) to allow tools to provide more granularity. Closes #7652
2014-09-09 00:04:59 -04:00
|`file_desc.current` |`fdc`, `fileDescriptorCurrent` |No |Used file
descriptors |123
|`file_desc.percent` |`fdp`, `fileDescriptorPercent` |Yes |Used file
descriptors percentage |1
|`file_desc.max` |`fdm`, `fileDescriptorMax` |No |Maximum number of file
descriptors |1024
Document cpu usage in _cat/nodes Closes #16775
2016-02-22 16:30:37 -05:00
|`cpu` | |No |Recent system CPU usage as percent |12
[DOC] Update /_cat/nodes doc closes #20162
2016-09-16 05:50:10 -04:00
|`load_1m` |`l` |No |Most recent load average |0.22
|`load_5m` |`l` |No |Load average for the last five minutes |0.78
|`load_15m` |`l` |No |Load average for the last fifteen minutes |1.24
[DOCS] Update nodes documentation with all headers Adds a table with the exhaustive list of all available headers with a brief description (mostly from `org.elasticsearch.rest.action.cat.RestNodesAction`) so that people do not need to go searching for them in the code like I did, or search through `nodes?help`.
2014-03-27 01:19:54 -04:00
|`uptime` |`u` |No |Node uptime |17.3m
[DOCS] Update _cat/nodes docs after recent changes
2016-03-31 10:35:57 -04:00
|`node.role` |`r`, `role`, `nodeRole` |Yes |Master eligible node (m);
adapt _cat/nodes to node.client removal _cat/nodes used to return `c` for client node or `d` for data node as part of the node.role column. This commit changes it to return `m` for master eligible, `d` for data and/or `i` for ingest. A node with no explicit roles will be a coordinating only node and marked with `-`. A node can obviously have multiple roles. The master column has been adapted to return only whether a node is the current master (`*`) or not (`-`).
2016-03-04 05:21:46 -05:00
Data node (d); Ingest node (i); Coordinating node only (-) |mdi
[DOCS] Update _cat/nodes docs after recent changes
2016-03-31 10:35:57 -04:00
|`master` |`m` |Yes |Elected master (*); Not elected master (-) |*
[DOC] Update /_cat/nodes doc closes #20162
2016-09-16 05:50:10 -04:00
|`name` |`n` |Yes |Node name |I8hydUG
[DOCS] Update nodes documentation with all headers Adds a table with the exhaustive list of all available headers with a brief description (mostly from `org.elasticsearch.rest.action.cat.RestNodesAction`) so that people do not need to go searching for them in the code like I did, or search through `nodes?help`.
2014-03-27 01:19:54 -04:00
|`completion.size` |`cs`, `completionSize` |No |Size of completion |0b
|`fielddata.memory_size` |`fm`, `fielddataMemory` |No |Used fielddata
cache memory |0b
|`fielddata.evictions` |`fe`, `fielddataEvictions` |No |Fielddata cache
evictions |0
Fix column aliases in _cat/indices, _cat/nodes and _cat/shards APIs #17101
2016-03-16 12:18:43 -04:00
|`query_cache.memory_size` |`qcm`, `queryCacheMemory` |No |Used query
[DOCS] Update nodes documentation with all headers Adds a table with the exhaustive list of all available headers with a brief description (mostly from `org.elasticsearch.rest.action.cat.RestNodesAction`) so that people do not need to go searching for them in the code like I did, or search through `nodes?help`.
2014-03-27 01:19:54 -04:00
cache memory |0b
Fix column aliases in _cat/indices, _cat/nodes and _cat/shards APIs #17101
2016-03-16 12:18:43 -04:00
|`query_cache.evictions` |`qce`, `queryCacheEvictions` |No |Query
[DOCS] Update nodes documentation with all headers Adds a table with the exhaustive list of all available headers with a brief description (mostly from `org.elasticsearch.rest.action.cat.RestNodesAction`) so that people do not need to go searching for them in the code like I did, or search through `nodes?help`.
2014-03-27 01:19:54 -04:00
cache evictions |0
Fix column aliases in _cat/indices, _cat/nodes and _cat/shards APIs #17101
2016-03-16 12:18:43 -04:00
|`request_cache.memory_size` |`rcm`, `requestCacheMemory` |No | Used request
cache memory |0b
|`request_cache.evictions` |`rce`, `requestCacheEvictions` |No |Request
cache evictions |0
|`request_cache.hit_count` |`rchc`, `requestCacheHitCount` |No | Request
cache hit count |0
|`request_cache.miss_count` |`rcmc`, `requestCacheMissCount` |No | Request
cache miss count |0
[DOCS] Update nodes documentation with all headers Adds a table with the exhaustive list of all available headers with a brief description (mostly from `org.elasticsearch.rest.action.cat.RestNodesAction`) so that people do not need to go searching for them in the code like I did, or search through `nodes?help`.
2014-03-27 01:19:54 -04:00
|`flush.total` |`ft`, `flushTotal` |No |Number of flushes |1
|`flush.total_time` |`ftt`, `flushTotalTime` |No |Time spent in flush |1
|`get.current` |`gc`, `getCurrent` |No |Number of current get
operations |0
|`get.time` |`gti`, `getTime` |No |Time spent in get |14ms
|`get.total` |`gto`, `getTotal` |No |Number of get operations |2
|`get.exists_time` |`geti`, `getExistsTime` |No |Time spent in
successful gets |14ms
|`get.exists_total` |`geto`, `getExistsTotal` |No |Number of successful
get operations |2
|`get.missing_time` |`gmti`, `getMissingTime` |No |Time spent in failed
gets |0s
|`get.missing_total` |`gmto`, `getMissingTotal` |No |Number of failed
get operations |1
|`indexing.delete_current` |`idc`, `indexingDeleteCurrent` |No |Number
of current deletion operations |0
|`indexing.delete_time` |`idti`, `indexingDeleteTime` |No |Time spent in
deletions |2ms
|`indexing.delete_total` |`idto`, `indexingDeleteTotal` |No |Number of
deletion operations |2
|`indexing.index_current` |`iic`, `indexingIndexCurrent` |No |Number
of current indexing operations |0
|`indexing.index_time` |`iiti`, `indexingIndexTime` |No |Time spent in
indexing |134ms
|`indexing.index_total` |`iito`, `indexingIndexTotal` |No |Number of
indexing operations |1
[DOC] Update /_cat/nodes doc closes #20162
2016-09-16 05:50:10 -04:00
|`indexing.index_failed` |`iif`, `indexingIndexFailed` |No |Number of
failed indexing operations |0
[DOCS] Update nodes documentation with all headers Adds a table with the exhaustive list of all available headers with a brief description (mostly from `org.elasticsearch.rest.action.cat.RestNodesAction`) so that people do not need to go searching for them in the code like I did, or search through `nodes?help`.
2014-03-27 01:19:54 -04:00
|`merges.current` |`mc`, `mergesCurrent` |No |Number of current
merge operations |0
|`merges.current_docs` |`mcd`, `mergesCurrentDocs` |No |Number of
current merging documents |0
|`merges.current_size` |`mcs`, `mergesCurrentSize` |No |Size of current
merges |0b
|`merges.total` |`mt`, `mergesTotal` |No |Number of completed merge
operations |0
|`merges.total_docs` |`mtd`, `mergesTotalDocs` |No |Number of merged
documents |0
|`merges.total_size` |`mts`, `mergesTotalSize` |No |Size of current
merges |0b
|`merges.total_time` |`mtt`, `mergesTotalTime` |No |Time spent merging
documents |0s
|`refresh.total` |`rto`, `refreshTotal` |No |Number of refreshes |16
|`refresh.time` |`rti`, `refreshTime` |No |Time spent in refreshes |91ms
Add script compilation stats This commit adds basic support to track the number of times scripts are compiled and compiled scripts are evicted from the script cache. These statistics are tracked at the node level. Closes #12673
2015-08-07 14:48:49 -04:00
|`script.compilations` |`scrcc`, `scriptCompilations` |No |Total script compilations |17
|`script.cache_evictions` |`scrce`, `scriptCacheEvictions` |No |Total compiled scripts evicted from cache |6
[DOCS] Update nodes documentation with all headers Adds a table with the exhaustive list of all available headers with a brief description (mostly from `org.elasticsearch.rest.action.cat.RestNodesAction`) so that people do not need to go searching for them in the code like I did, or search through `nodes?help`.
2014-03-27 01:19:54 -04:00
|`search.fetch_current` |`sfc`, `searchFetchCurrent` |No |Current fetch
phase operations |0
|`search.fetch_time` |`sfti`, `searchFetchTime` |No |Time spent in fetch
phase |37ms
|`search.fetch_total` |`sfto`, `searchFetchTotal` |No |Number of fetch
operations |7
|`search.open_contexts` |`so`, `searchOpenContexts` |No |Open search
contexts |0
|`search.query_current` |`sqc`, `searchFetchCurrent` |No |Current query
phase operations |0
|`search.query_time` |`sqti`, `searchFetchTime` |No |Time spent in query
phase |43ms
|`search.query_total` |`sqto`, `searchFetchTotal` |No |Number of query
operations |9
Add scroll stats to cat API Adds scroll stats at the node, shard and index levels to the cat API. Closes #12330
2015-07-19 13:41:46 -04:00
|`search.scroll_current` |`scc`, `searchScrollCurrent` |No |Open scroll contexts |2
|`search.scroll_time` |`scti`, `searchScrollTime` |No |Time scroll contexts held open|2m
|`search.scroll_total` |`scto`, `searchScrollTotal` |No |Completed scroll contexts |1
[DOCS] Update nodes documentation with all headers Adds a table with the exhaustive list of all available headers with a brief description (mostly from `org.elasticsearch.rest.action.cat.RestNodesAction`) so that people do not need to go searching for them in the code like I did, or search through `nodes?help`.
2014-03-27 01:19:54 -04:00
|`segments.count` |`sc`, `segmentsCount` |No |Number of segments |4
|`segments.memory` |`sm`, `segmentsMemory` |No |Memory used by
segments |1.4kb
Stats: Expose IndexWriter and VersionMap RAM usage to ShardStats and _cat endpoint This commit adds the RAM usage of IndexWriter and VersionMap Closes #6483
2014-07-11 17:07:38 -04:00
|`segments.index_writer_memory` |`siwm`, `segmentsIndexWriterMemory` |No
Stats: add segments.index_writer_max_memory to see index writer's max RAM usage before buffered documents must be written to a new segment Closes #7438 Closes #7440
2014-08-25 14:43:09 -04:00
|Memory used by index writer |18mb
Stats: Expose IndexWriter and VersionMap RAM usage to ShardStats and _cat endpoint This commit adds the RAM usage of IndexWriter and VersionMap Closes #6483
2014-07-11 17:07:38 -04:00
|`segments.version_map_memory` |`svmm`, `segmentsVersionMapMemory` |No
|Memory used by version map |1.0kb
[DOC] Update /_cat/nodes doc closes #20162
2016-09-16 05:50:10 -04:00
|`segments.fixed_bitset_memory` |`sfbm`, `fixedBitsetMemory` |No
|Memory used by fixed bit sets for nested object field types and type filters for types referred in _parent fields |1.0kb
|`suggest.current` |`suc`, `suggestCurrent` |No |Number of current suggest operations |0
|`suggest.time` |`suti`, `suggestTime` |No |Time spent in suggest |0
|`suggest.total` |`suto`, `suggestTotal` |No |Number of suggest operations |0
[DOCS] Update nodes documentation with all headers Adds a table with the exhaustive list of all available headers with a brief description (mostly from `org.elasticsearch.rest.action.cat.RestNodesAction`) so that people do not need to go searching for them in the code like I did, or search through `nodes?help`.
2014-03-27 01:19:54 -04:00
|=======================================================================