IMPORTANT: No additional bug fixes or documentation updates
will be released for this version. For the latest information, see the
current release documentation.
Cluster Info API
editCluster Info API
editThis functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features.
Returns cluster information.
Request
editGET /_info/<target>
Prerequisites
edit-
If the Elasticsearch security features are enabled, you must have the
monitorormanagecluster privilege to use this API.
Description
editYou can use the Cluster Info API to retrieve information of a cluster.
Path parameters
edit-
<target> -
(String) Limits the information returned to the specific
target. A comma-separated list of the following options:-
_all - All the information available. Can not be mixed with other targets.
-
http - HTTP connection information.
-
ingest - Ingest information.
-
thread_pool - Statistics about each thread pool, including current size, queue size and rejected tasks.
-
script - Contains script statistics of the cluster.
-
Response body
edit-
cluster_name - (string) Name of the cluster. Based on the Cluster name setting setting.
-
http -
(object) Contains http information for the cluster.
Properties of
http-
current_open - (integer) Current number of open HTTP connections for the cluster.
-
total_opened - (integer) Total number of HTTP connections opened for the cluster.
-
clients -
(array of objects) Information on current and recently-closed HTTP client connections. Clients that have been closed longer than the http.client_stats.closed_channels.max_age setting will not be represented here.
Properties of
clients-
id - (integer) Unique ID for the HTTP client.
-
agent - (string) Reported agent for the HTTP client. If unavailable, this property is not included in the response.
-
local_address - (string) Local address for the HTTP connection.
-
remote_address - (string) Remote address for the HTTP connection.
-
last_uri - (string) The URI of the client’s most recent request.
-
x_forwarded_for -
(string)
Value from the client’s
x-forwarded-forHTTP header. If unavailable, this property is not included in the response. -
x_opaque_id -
(string)
Value from the client’s
x-opaque-idHTTP header. If unavailable, this property is not included in the response. -
opened_time_millis - (integer) Time at which the client opened the connection.
-
closed_time_millis - (integer) Time at which the client closed the connection if the connection is closed.
-
last_request_time_millis - (integer) Time of the most recent request from this client.
-
request_count - (integer) Number of requests from this client.
-
request_size_bytes - (integer) Cumulative size in bytes of all requests from this client.
-
-
-
ingest -
(object) Contains ingest information for the cluster.
Properties of
ingest-
total -
(object) Contains information about ingest operations for the cluster.
Properties of
total-
count - (integer) Total number of documents ingested across the cluster.
-
time - (time value) Total time spent preprocessing ingest documents across the cluster.
-
time_in_millis - (integer) Total time, in milliseconds, spent preprocessing ingest documents across the cluster.
-
current - (integer) Total number of documents currently being ingested.
-
failed - (integer) Total number of failed ingest operations across the cluster.
-
-
pipelines -
(object) Contains information about ingest pipelines for the cluster.
Properties of
pipelines-
<pipeline_id> -
(object) Contains information about the ingest pipeline.
Properties of
<pipeline_id>-
count - (integer) Number of documents preprocessed by the ingest pipeline.
-
time - (time value) Total time spent preprocessing documents in the ingest pipeline.
-
time_in_millis - (integer) Total time, in milliseconds, spent preprocessing documents in the ingest pipeline.
-
failed - (integer) Total number of failed operations for the ingest pipeline.
-
ingested_as_first_pipeline - (byte value) Total ingested size of all documents which were first processed by this pipeline. A document is not added to the stat value for this pipeline if it is a final pipeline after a default pipeline, a pipeline run after a reroute processor, or is within a pipeline processor. Instead, the document size is added to the stat value of the pipeline which initially ingested the document.
-
ingested_as_first_pipeline_in_bytes - (integer) Total ingested size, in bytes, of all documents which were first processed by this pipeline. A document is not added to the stat value for this pipeline if it is a final pipeline after a default pipeline, a pipeline run after a reroute processor, or is within a pipeline processor. Instead, the document size is added to the stat value of the pipeline which initially ingested the document.
-
produced_as_first_pipeline - (byte value) Total produced size of all documents which were first processed by this pipeline. A document is not added to the stat value for this pipeline if it is a final pipeline after a default pipeline, a pipeline run after a reroute processor, or is within a pipeline processor. Instead, the document size is added to the stat value of the pipeline which initially ingested the document.
-
produced_as_first_pipeline_in_bytes - (integer) Total produced size, in bytes, of all documents which were first processed by this pipeline. A document is not added to the stat value for this pipeline if it is a final pipeline after a default pipeline, a pipeline run after a reroute processor, or is within a pipeline processor. Instead, the document size is added to the stat value of the pipeline which initially ingested the document.
-
processors -
(array of objects) Contains information for the ingest processors for the ingest pipeline.
Properties of
processors-
<processor> -
(object) Contains information for the ingest processor.
Properties of
<processor>-
count - (integer) Number of documents transformed by the processor.
-
time - (time value) Time spent by the processor transforming documents.
-
time_in_millis - (integer) Time, in milliseconds, spent by the processor transforming documents.
-
current - (integer) Number of documents currently being transformed by the processor.
-
failed - (integer) Number of failed operations for the processor.
-
-
-
-
-
-
thread_pool -
(object) Contains information about the thread pools of the cluster.
Properties of
thread_pool-
<thread_pool_name> -
(object) Contains information about the thread pool of the cluster with name
<thread_pool_name>.Properties of
<thread_pool_name>-
threads - (integer) Number of threads in the thread pool.
-
queue - (integer) Number of tasks in queue for the thread pool.
-
active - (integer) Number of active threads in the thread pool.
-
rejected - (integer) Number of tasks rejected by the thread pool executor.
-
largest - (integer) Highest number of active threads in the thread pool.
-
completed - (integer) Number of tasks completed by the thread pool executor.
-
-
-
script -
(object) Contains script statistics of the cluster.
Properties of
script-
compilations - (integer) Total number of inline script compilations performed by the cluster.
-
compilations_history - (object) Contains the recent history of script compilations.
Properties of
compilations_history-
5m - (long) The number of script compilations in the last five minutes.
-
15m - (long) The number of script compilations in the last fifteen minutes.
-
24h - (long) The number of script compilations in the last twenty-four hours.
-
cache_evictions - (integer) Total number of times the script cache has evicted old data.
-
cache_evictions_history - (object) Contains the recent history of script cache evictions.
Properties of
cache_evictions-
5m - (long) The number of script cache evictions in the last five minutes.
-
15m - (long) The number of script cache evictions in the last fifteen minutes.
-
24h - (long) The number of script cache evictions in the last twenty-four hours.
-
compilation_limit_triggered - (integer) Total number of times the script compilation circuit breaker has limited inline script compilations.
-
Examples
editresp = client.cluster.info(
target="_all",
)
print(resp)
resp1 = client.cluster.info(
target="http",
)
print(resp1)
resp2 = client.cluster.info(
target="ingest",
)
print(resp2)
resp3 = client.cluster.info(
target="thread_pool",
)
print(resp3)
resp4 = client.cluster.info(
target="script",
)
print(resp4)
resp5 = client.cluster.info(
target="http,ingest",
)
print(resp5)
response = client.cluster.info( target: '_all' ) puts response response = client.cluster.info( target: 'http' ) puts response response = client.cluster.info( target: 'ingest' ) puts response response = client.cluster.info( target: 'thread_pool' ) puts response response = client.cluster.info( target: 'script' ) puts response response = client.cluster.info( target: 'http,ingest' ) puts response
const response = await client.cluster.info({
target: "_all",
});
console.log(response);
const response1 = await client.cluster.info({
target: "http",
});
console.log(response1);
const response2 = await client.cluster.info({
target: "ingest",
});
console.log(response2);
const response3 = await client.cluster.info({
target: "thread_pool",
});
console.log(response3);
const response4 = await client.cluster.info({
target: "script",
});
console.log(response4);
const response5 = await client.cluster.info({
target: "http,ingest",
});
console.log(response5);
# returns all stats info of the cluster GET /_info/_all # returns the http info of the cluster GET /_info/http # returns the http info of the cluster GET /_info/ingest # returns the thread_pool info of the cluster GET /_info/thread_pool # returns the script info of the cluster GET /_info/script # returns the http and ingest info of the cluster GET /_info/http,ingest