summaryrefslogtreecommitdiff
path: root/docs/reference/cluster/nodes-stats.asciidoc
blob: 82d7b3830532f37c9a74502cbcd9bbc6202272e3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
[[cluster-nodes-stats]]
== Nodes Stats

[float]
=== Nodes statistics

The cluster nodes stats API allows to retrieve one or more (or all) of
the cluster nodes statistics.

[source,js]
--------------------------------------------------
curl -XGET 'http://localhost:9200/_nodes/stats'
curl -XGET 'http://localhost:9200/_nodes/nodeId1,nodeId2/stats'
--------------------------------------------------

The first command retrieves stats of all the nodes in the cluster. The
second command selectively retrieves nodes stats of only `nodeId1` and
`nodeId2`. All the nodes selective options are explained
<<cluster-nodes,here>>.

By default, all stats are returned. You can limit this by combining any
of `indices`, `os`, `process`, `jvm`, `network`, `transport`, `http`,
`fs`, `breaker` and `thread_pool`. For example:

[horizontal]
`indices`:: 
	Indices stats about size, document count, indexing and
	deletion times, search times, field cache size , merges and flushes

`fs`:: 
	File system information, data path, free disk space, read/write
	stats

`http`:: 
	HTTP connection information

`jvm`:: 
	JVM stats, memory pool information, garbage collection, buffer
	pools

`network`:: 
	TCP information

`os`:: 
	Operating system stats, load average, cpu, mem, swap

`process`:: 
	Process statistics, memory consumption, cpu usage, open
	file descriptors

`thread_pool`:: 
	Statistics about each thread pool, including current
	size, queue and rejected tasks

`transport`:: 
	Transport statistics about sent and received bytes in
	cluster communication

`breaker`::
	Statistics about the field data circuit breaker

`clear`:: 
	Clears all the flags (first). Useful, if you only want to
	retrieve specific stats.

[source,js]
--------------------------------------------------
# return indices and os
curl -XGET 'http://localhost:9200/_nodes/stats/os'
# return just os and process
curl -XGET 'http://localhost:9200/_nodes/stats/os,process'
# specific type endpoint
curl -XGET 'http://localhost:9200/_nodes/stats/process'
curl -XGET 'http://localhost:9200/_nodes/10.0.0.1/stats/process'
--------------------------------------------------

The `all` flag can be set to return all the stats.

[float]
[[field-data]]
=== Field data statistics

You can get information about field data memory usage on node
level or on index level.

[source,js]
--------------------------------------------------
# Node Stats
curl localhost:9200/_nodes/stats/indices/field1,field2?pretty

# Indices Stat
curl localhost:9200/_stats/fielddata/field1,field2?pretty

# You can use wildcards for field names
curl localhost:9200/_stats/fielddata/field*?pretty
curl localhost:9200/_nodes/stats/indices/field*?pretty
--------------------------------------------------