Cluster stats

Introduced 1.0

The cluster stats API operation returns statistics about your cluster.

Examples

  1. GET _cluster/stats/nodes/_master

Path and HTTP methods

  1. GET _cluster/stats
  2. GET _cluster/stats/nodes/<node-filters>

URL parameters

All cluster stats parameters are optional.

ParameterTypeDescription
<node-filters>ListA comma-separated list of node-filters that OpenSearch uses to filter results. Available options are all, _local, _master, a node name or ID, master:true, master:false, data:true, data:false, ingest:true, ingest:false, voting_only:true, voting_only:false, ml:true, ml:false, coordinating_only:true, coordinating_only:false, and <custom node attributes> : <attribute values> pairs.

Response

  1. {
  2.     "_nodes": {
  3.         "total": 1,
  4.         "successful": 1,
  5.         "failed": 0
  6.     },
  7.     "cluster_name": "opensearch-cluster",
  8.     "cluster_uuid": "QravFieJS_SlZJyBMcDMqQ",
  9.     "timestamp": 1644607845054,
  10.     "status": "yellow",
  11.     "indices": {
  12.         "count": 114,
  13.         "shards": {
  14.             "total": 121,
  15.             "primaries": 60,
  16.             "replication": 1.0166666666666666,
  17.             "index": {
  18.                 "shards": {
  19.                     "min": 1,
  20.                     "max": 2,
  21.                     "avg": 1.0614035087719298
  22.                 },
  23.                 "primaries": {
  24.                     "min": 0,
  25.                     "max": 2,
  26.                     "avg": 0.5263157894736842
  27.                 },
  28.                 "replication": {
  29.                     "min": 0.0,
  30.                     "max": 1.0,
  31.                     "avg": 0.008771929824561403
  32.                 }
  33.             }
  34.         },
  35.         "docs": {
  36.             "count": 134263,
  37.             "deleted": 115
  38.         },
  39.         "store": {
  40.             "size_in_bytes": 70466547,
  41.             "reserved_in_bytes": 0
  42.         },
  43.         "fielddata": {
  44.             "memory_size_in_bytes": 664,
  45.             "evictions": 0
  46.         },
  47.         "query_cache": {
  48.             "memory_size_in_bytes": 0,
  49.             "total_count": 1,
  50.             "hit_count": 0,
  51.             "miss_count": 1,
  52.             "cache_size": 0,
  53.             "cache_count": 0,
  54.             "evictions": 0
  55.         },
  56.         "completion": {
  57.             "size_in_bytes": 0
  58.         },
  59.         "segments": {
  60.             "count": 341,
  61.             "memory_in_bytes": 3137244,
  62.             "terms_memory_in_bytes": 2488992,
  63.             "stored_fields_memory_in_bytes": 167672,
  64.             "term_vectors_memory_in_bytes": 0,
  65.             "norms_memory_in_bytes": 346816,
  66.             "points_memory_in_bytes": 0,
  67.             "doc_values_memory_in_bytes": 133764,
  68.             "index_writer_memory_in_bytes": 0,
  69.             "version_map_memory_in_bytes": 0,
  70.             "fixed_bit_set_memory_in_bytes": 1112,
  71.             "max_unsafe_auto_id_timestamp": 1644269449096,
  72.             "file_sizes": {}
  73.         },
  74.         "mappings": {
  75.             "field_types": [
  76.                 {
  77.                     "name": "alias",
  78.                     "count": 1,
  79.                     "index_count": 1
  80.                 },
  81.                 {
  82.                     "name": "binary",
  83.                     "count": 1,
  84.                     "index_count": 1
  85.                 },
  86.                 {
  87.                     "name": "boolean",
  88.                     "count": 87,
  89.                     "index_count": 22
  90.                 },
  91.                 {
  92.                     "name": "date",
  93.                     "count": 185,
  94.                     "index_count": 91
  95.                 },
  96.                 {
  97.                     "name": "double",
  98.                     "count": 5,
  99.                     "index_count": 2
  100.                 },
  101.                 {
  102.                     "name": "float",
  103.                     "count": 4,
  104.                     "index_count": 1
  105.                 },
  106.                 {
  107.                     "name": "geo_point",
  108.                     "count": 4,
  109.                     "index_count": 3
  110.                 },
  111.                 {
  112.                     "name": "half_float",
  113.                     "count": 12,
  114.                     "index_count": 1
  115.                 },
  116.                 {
  117.                     "name": "integer",
  118.                     "count": 144,
  119.                     "index_count": 29
  120.                 },
  121.                 {
  122.                     "name": "ip",
  123.                     "count": 2,
  124.                     "index_count": 1
  125.                 },
  126.                 {
  127.                     "name": "keyword",
  128.                     "count": 1939,
  129.                     "index_count": 109
  130.                 },
  131.                 {
  132.                     "name": "knn_vector",
  133.                     "count": 1,
  134.                     "index_count": 1
  135.                 },
  136.                 {
  137.                     "name": "long",
  138.                     "count": 158,
  139.                     "index_count": 92
  140.                 },
  141.                 {
  142.                     "name": "nested",
  143.                     "count": 25,
  144.                     "index_count": 10
  145.                 },
  146.                 {
  147.                     "name": "object",
  148.                     "count": 420,
  149.                     "index_count": 91
  150.                 },
  151.                 {
  152.                     "name": "text",
  153.                     "count": 1768,
  154.                     "index_count": 102
  155.                 }
  156.             ]
  157.         },
  158.         "analysis": {
  159.             "char_filter_types": [],
  160.             "tokenizer_types": [],
  161.             "filter_types": [],
  162.             "analyzer_types": [],
  163.             "built_in_char_filters": [],
  164.             "built_in_tokenizers": [],
  165.             "built_in_filters": [],
  166.             "built_in_analyzers": [
  167.                 {
  168.                     "name": "english",
  169.                     "count": 1,
  170.                     "index_count": 1
  171.                 }
  172.             ]
  173.         }
  174.     },
  175.     "nodes": {
  176.         "count": {
  177.             "total": 1,
  178.             "coordinating_only": 0,
  179.             "data": 1,
  180.             "ingest": 1,
  181.             "master": 1,
  182.             "remote_cluster_client": 1
  183.         },
  184.         "versions": [
  185.             "1.2.4"
  186.         ],
  187.         "os": {
  188.             "available_processors": 6,
  189.             "allocated_processors": 6,
  190.             "names": [
  191.                 {
  192.                     "name": "Linux",
  193.                     "count": 1
  194.                 }
  195.             ],
  196.             "pretty_names": [
  197.                 {
  198.                     "pretty_name": "Amazon Linux 2",
  199.                     "count": 1
  200.                 }
  201.             ],
  202.             "mem": {
  203.                 "total_in_bytes": 6232674304,
  204.                 "free_in_bytes": 1452658688,
  205.                 "used_in_bytes": 4780015616,
  206.                 "free_percent": 23,
  207.                 "used_percent": 77
  208.             }
  209.         },
  210.         "process": {
  211.             "cpu": {
  212.                 "percent": 0
  213.             },
  214.             "open_file_descriptors": {
  215.                 "min": 970,
  216.                 "max": 970,
  217.                 "avg": 970
  218.             }
  219.         },
  220.         "jvm": {
  221.             "max_uptime_in_millis": 108800629,
  222.             "versions": [
  223.                 {
  224.                     "version": "15.0.1",
  225.                     "vm_name": "OpenJDK 64-Bit Server VM",
  226.                     "vm_version": "15.0.1+9",
  227.                     "vm_vendor": "AdoptOpenJDK",
  228.                     "bundled_jdk": true,
  229.                     "using_bundled_jdk": true,
  230.                     "count": 1
  231.                 }
  232.             ],
  233.             "mem": {
  234.                 "heap_used_in_bytes": 178956256,
  235.                 "heap_max_in_bytes": 536870912
  236.             },
  237.             "threads": 112
  238.         },
  239.         "fs": {
  240.             "total_in_bytes": 62725623808,
  241.             "free_in_bytes": 28442726400,
  242.             "available_in_bytes": 25226010624
  243.         },
  244.         "plugins": [
  245.             {
  246.                 "name": "opensearch-index-management",
  247.                 "version": "1.2.4.0",
  248.                 "opensearch_version": "1.2.4",
  249.                 "java_version": "1.8",
  250.                 "description": "OpenSearch Index Management Plugin",
  251.                 "classname": "org.opensearch.indexmanagement.IndexManagementPlugin",
  252.                 "custom_foldername": "",
  253.                 "extended_plugins": [
  254.                     "opensearch-job-scheduler"
  255.                 ],
  256.                 "has_native_controller": false
  257.             },
  258.             {
  259.                 "name": "opensearch-security",
  260.                 "version": "1.2.4.0",
  261.                 "opensearch_version": "1.2.4",
  262.                 "java_version": "1.8",
  263.                 "description": "Provide access control related features for OpenSearch 1.0.0",
  264.                 "classname": "org.opensearch.security.OpenSearchSecurityPlugin",
  265.                 "custom_foldername": "opensearch-security",
  266.                 "extended_plugins": [],
  267.                 "has_native_controller": false
  268.             },
  269.             {
  270.                 "name": "opensearch-cross-cluster-replication",
  271.                 "version": "1.2.4.0",
  272.                 "opensearch_version": "1.2.4",
  273.                 "java_version": "1.8",
  274.                 "description": "OpenSearch Cross Cluster Replication Plugin",
  275.                 "classname": "org.opensearch.replication.ReplicationPlugin",
  276.                 "custom_foldername": "",
  277.                 "extended_plugins": [],
  278.                 "has_native_controller": false
  279.             },
  280.             {
  281.                 "name": "opensearch-job-scheduler",
  282.                 "version": "1.2.4.0",
  283.                 "opensearch_version": "1.2.4",
  284.                 "java_version": "1.8",
  285.                 "description": "OpenSearch Job Scheduler plugin",
  286.                 "classname": "org.opensearch.jobscheduler.JobSchedulerPlugin",
  287.                 "custom_foldername": "",
  288.                 "extended_plugins": [],
  289.                 "has_native_controller": false
  290.             },
  291.             {
  292.                 "name": "opensearch-anomaly-detection",
  293.                 "version": "1.2.4.0",
  294.                 "opensearch_version": "1.2.4",
  295.                 "java_version": "1.8",
  296.                 "description": "OpenSearch anomaly detector plugin",
  297.                 "classname": "org.opensearch.ad.AnomalyDetectorPlugin",
  298.                 "custom_foldername": "",
  299.                 "extended_plugins": [
  300.                     "lang-painless",
  301.                     "opensearch-job-scheduler"
  302.                 ],
  303.                 "has_native_controller": false
  304.             },
  305.             {
  306.                 "name": "opensearch-performance-analyzer",
  307.                 "version": "1.2.4.0",
  308.                 "opensearch_version": "1.2.4",
  309.                 "java_version": "1.8",
  310.                 "description": "OpenSearch Performance Analyzer Plugin",
  311.                 "classname": "org.opensearch.performanceanalyzer.PerformanceAnalyzerPlugin",
  312.                 "custom_foldername": "",
  313.                 "extended_plugins": [],
  314.                 "has_native_controller": false
  315.             },
  316.             {
  317.                 "name": "opensearch-reports-scheduler",
  318.                 "version": "1.2.4.0",
  319.                 "opensearch_version": "1.2.4",
  320.                 "java_version": "1.8",
  321.                 "description": "Scheduler for Dashboards Reports Plugin",
  322.                 "classname": "org.opensearch.reportsscheduler.ReportsSchedulerPlugin",
  323.                 "custom_foldername": "",
  324.                 "extended_plugins": [
  325.                     "opensearch-job-scheduler"
  326.                 ],
  327.                 "has_native_controller": false
  328.             },
  329.             {
  330.                 "name": "opensearch-asynchronous-search",
  331.                 "version": "1.2.4.0",
  332.                 "opensearch_version": "1.2.4",
  333.                 "java_version": "1.8",
  334.                 "description": "Provides support for asynchronous search",
  335.                 "classname": "org.opensearch.search.asynchronous.plugin.AsynchronousSearchPlugin",
  336.                 "custom_foldername": "",
  337.                 "extended_plugins": [],
  338.                 "has_native_controller": false
  339.             },
  340.             {
  341.                 "name": "opensearch-knn",
  342.                 "version": "1.2.4.0",
  343.                 "opensearch_version": "1.2.4",
  344.                 "java_version": "1.8",
  345.                 "description": "OpenSearch k-NN plugin",
  346.                 "classname": "org.opensearch.knn.plugin.KNNPlugin",
  347.                 "custom_foldername": "",
  348.                 "extended_plugins": [
  349.                     "lang-painless"
  350.                 ],
  351.                 "has_native_controller": false
  352.             },
  353.             {
  354.                 "name": "opensearch-alerting",
  355.                 "version": "1.2.4.0",
  356.                 "opensearch_version": "1.2.4",
  357.                 "java_version": "1.8",
  358.                 "description": "Amazon OpenSearch alerting plugin",
  359.                 "classname": "org.opensearch.alerting.AlertingPlugin",
  360.                 "custom_foldername": "",
  361.                 "extended_plugins": [
  362.                     "lang-painless"
  363.                 ],
  364.                 "has_native_controller": false
  365.             },
  366.             {
  367.                 "name": "opensearch-observability",
  368.                 "version": "1.2.4.0",
  369.                 "opensearch_version": "1.2.4",
  370.                 "java_version": "1.8",
  371.                 "description": "OpenSearch Plugin for OpenSearch Dashboards Observability",
  372.                 "classname": "org.opensearch.observability.ObservabilityPlugin",
  373.                 "custom_foldername": "",
  374.                 "extended_plugins": [],
  375.                 "has_native_controller": false
  376.             },
  377.             {
  378.                 "name": "opensearch-sql",
  379.                 "version": "1.2.4.0",
  380.                 "opensearch_version": "1.2.4",
  381.                 "java_version": "1.8",
  382.                 "description": "OpenSearch SQL",
  383.                 "classname": "org.opensearch.sql.plugin.SQLPlugin",
  384.                 "custom_foldername": "",
  385.                 "extended_plugins": [],
  386.                 "has_native_controller": false
  387.             }
  388.         ],
  389.         "network_types": {
  390.             "transport_types": {
  391.                 "org.opensearch.security.ssl.http.netty.SecuritySSLNettyTransport": 1
  392.             },
  393.             "http_types": {
  394.                 "org.opensearch.security.http.SecurityHttpServerTransport": 1
  395.             }
  396.         },
  397.         "discovery_types": {
  398.             "zen": 1
  399.         },
  400.         "packaging_types": [
  401.             {
  402.                 "type": "tar",
  403.                 "count": 1
  404.             }
  405.         ],
  406.         "ingest": {
  407.             "number_of_pipelines": 0,
  408.             "processor_stats": {}
  409.         }
  410.     }
  411. }

Response body fields

FieldDescription
nodesHow many nodes returned in the response.
cluster_nameThe cluster’s name.
cluster_uuidThe cluster’s uuid.
timestampThe Unix epoch time of when the cluster was last refreshed.
statusThe cluster’s health status.
indicesStatistics about the indexes in the cluster.
indices.countHow many indexes are in the cluster.
indices.shardsInformation about the cluster’s shards.
indices.docsHow many documents are still in the cluster and how many documents are deleted.
indices.storeInformation about the cluster’s storage.
indices.fielddataInformation about the cluster’s field data
indices.query_cacheData about the cluster’s query cache.
indices.completionHow many bytes in memory are used to complete operations.
indices.segmentsInformation about the cluster’s segments, which are small Lucene indexes.
indices.mappingsMappings within the cluster.
indices.analysisInformation about analyzers used in the cluster.
nodesStatistics about the nodes in the cluster.
nodes.countHow many nodes were returned from the request.
nodes.versionsOpenSearch’s version number.
nodes.osInformation abotu the operating systems used in the nodes.
nodes.processThe processes the returned nodes use.
nodes.jvmStatistics about the Java Virtual Machines in use.
nodes.fsThe nodes’ file storage.
nodes.pluginsThe OpenSearch plugins integrated within the nodes.
nodes.network_typesThe transport and HTTP networks within the nodes.
nodes.discovery_typeThe method the nodes use to find other nodes within the cluster.
nodes.packaging_typesInformation about the nodes’ OpenSearch distribution.
nodes.ingestInformation about the nodes’ ingest pipelines/nodes, if there are any.