Nodes Stats API

Nodes Stats API

1.0에서 도입

Nodes Stats API는 클러스터에 대한 통계를 반환해요.

출처: 문서

본문

엔드포인트 (Endpoints)

GET /_nodes/stats
GET /_nodes/{node_id}/stats
GET /_nodes/stats/{metric}
GET /_nodes/{node_id}/stats/{metric}
GET /_nodes/stats/{metric}/{index_metric}
GET /_nodes/{node_id}/stats/{metric}/{index_metric}

경로 매개변수 (Path parameters)

다음 표는 사용 가능한 경로 매개변수예요. 모든 경로 매개변수는 선택 사항이에요.

매개변수 타입 설명
node_id String 결과를 필터링하는 데 사용하는 쉼표로 구분된 노드 ID 목록이에요. 노드 필터를 지원해요. 기본값은 _all이에요.
metric String 응답에 포함할 메트릭 그룹의 쉼표로 구분된 목록이에요. 예: jvm,fs. 아래 모든 인덱스 메트릭 목록을 참고해요. 기본값은 모든 메트릭이에요.
index_metric String 응답에 포함할 인덱스 메트릭 그룹의 쉼표로 구분된 목록이에요. 예: docs,store. 아래 모든 인덱스 메트릭 목록을 참고해요. 기본값은 모든 인덱스 메트릭이에요.

다음 표는 사용 가능한 모든 메트릭 그룹을 정리한 거예요.

메트릭 설명
indices 크기, 문서 수, 문서의 검색·색인·삭제 시간 같은 인덱스 통계예요.
os 부하, 메모리, 스와핑을 포함한 호스트 운영체제 통계예요.
process 메모리 소비, 열린 파일 디스크립터, CPU 사용을 포함한 프로세스 통계예요.
jvm 메모리 풀, 버퍼 풀, 가비지 컬렉션, 로드된 클래스 수를 포함한 JVM 통계예요.
thread_pool 노드의 각 스레드 풀 통계예요.
fs 읽기·쓰기 통계, 데이터 경로, 여유 디스크 공간 같은 파일 시스템 통계예요.
transport 클러스터 통신에서 송수신에 대한 transport 계층 통계예요.
http HTTP 계층 통계예요.
breaker 필드 데이터 서킷 브레이커 통계예요.
script 컴파일과 캐시 제거 같은 스크립트 통계예요.
discovery 클러스터 상태 통계예요.
ingest ingest 파이프라인 통계예요.
adaptive_selection 샤드 할당 인지(shard allocation awareness)로 적격 노드를 선택하는 적응형 복제본 선택 통계예요.
script_cache 스크립트 캐시 통계예요.
indexing_pressure 노드의 색인 백프레셔 통계예요.
shard_indexing_pressure 샤드 색인 백프레셔 통계예요.
search_backpressure 검색 백프레셔 관련 통계예요.
cluster_manager_throttling 클러스터 매니저 노드의 조절된(throttled) 작업 관련 통계예요.
task_cancellation 취소된 뒤에도 계속 실행되는 작업 통계예요.
weighted_routing 가중 라운드 로빈 요청 관련 통계예요.
resource_usage_stats CPU, JVM 메모리 같은 노드 수준 리소스 사용 통계예요.
admission_control 승인 제어(admission control) 통계예요.
caches 캐시 통계예요.

indices 메트릭에 대해 반환되는 정보를 필터링하려면 특정 index_metric 값을 사용할 수 있어요. 이 값들은 다음 쿼리 유형을 사용할 때만 쓸 수 있어요:

GET _nodes/stats/
GET _nodes/stats/_all
GET _nodes/stats/indices

지원되는 인덱스 메트릭은 다음과 같아요:

docs, store, indexing, get, search, merge, refresh, flush, warmer, query_cache, fielddata, completion, segments, translog, request_cache

예를 들어 다음 쿼리는 docs와 search 통계를 요청해요:

GET /_nodes/stats/indices/docs,search

Python 클라이언트로는 이렇게 호출해요:

response = client.nodes.stats(
metric = "indices",
index_metric = "docs,search"
)

caches 메트릭에서 특정 index_metric 값을 사용해 어떤 캐시가 통계를 반환할지 지정할 수도 있어요. 지원되는 인덱스 메트릭은 다음과 같아요:

request_cache

예를 들어 다음 쿼리는 request_cache 통계를 요청해요:

GET /_nodes/stats/caches/request_cache

Python 클라이언트로는 이렇게 호출해요:

response = client.nodes.stats(
metric = "caches",
index_metric = "request_cache"
)

쿼리 매개변수 (Query parameters)

다음 표는 사용 가능한 쿼리 매개변수예요. 모든 쿼리 매개변수는 선택 사항이에요.

매개변수 타입 설명
completion_fields String completion 통계에 포함할 필드예요. 쉼표로 구분된 목록과 와일드카드 표현식을 지원해요.
fielddata_fields String fielddata 통계에 포함할 필드예요. 쉼표로 구분된 목록과 와일드카드 표현식을 지원해요.
fields String 포함할 필드예요. 쉼표로 구분된 목록과 와일드카드 표현식을 지원해요.
groups String 검색 통계에 포함할 검색 그룹의 쉼표로 구분된 목록이에요.
level String indices 메트릭의 통계를 클러스터, 인덱스, 샤드 수준 중 어디서 집계할지 지정해요. 유효한 값은 indices, node, shard예요. caches 메트릭에 사용하면 indices, shard, tier가 유효해요. 계층형 스필오버 캐시(tiered spillover cache)를 사용하지 않으면 tier 값은 무시돼요.
timeout Time 노드 응답의 시간 제한을 설정해요. 기본값은 30s예요.
include_segment_file_sizes Boolean 세그먼트 통계를 요청했다면, 이 필드가 모든 Lucene 인덱스 파일의 집계된 디스크 사용량을 반환하도록 지정해요. 기본값은 false예요.

예시 요청 (Example request)

GET /_nodes/stats

Python 클라이언트로는 이렇게 호출해요:

response = client.nodes.info(
node_id_or_metric = "stats"
)

예시 응답 (Example response)

화살표를 선택해서 예시 응답을 확인해요.

{
  "_nodes" : {
    "total" : 1,
    "successful" : 1,
    "failed" : 0
  },
  "cluster_name" : "docker-cluster",
  "nodes" : {
    "F-ByTQzVQ3GQeYzQJArJGQ" : {
      "timestamp" : 1664484195257,
      "name" : "opensearch",
      "transport_address" : "127.0.0.1:9300",
      "host" : "127.0.0.1",
      "ip" : "127.0.0.1:9300",
      "roles" : [
        "cluster_manager",
        "data",
        "ingest",
        "remote_cluster_client"
      ],
      "attributes" : {
        "shard_indexing_pressure_enabled" : "true"
      },
      "indices" : {
        "docs" : {
          "count" : 13160,
          "deleted" : 12
        },
        "store" : {
          "size_in_bytes" : 6263461,
          "reserved_in_bytes" : 0
        },
        "indexing" : {
          "index_total" : 0,
          "index_time_in_millis" : 0,
          "index_current" : 0,
          "index_failed" : 0,
          "delete_total" : 204,
          "delete_time_in_millis" : 427,
          "delete_current" : 0,
          "noop_update_total" : 0,
          "is_throttled" : false,
          "throttle_time_in_millis" : 0
        },
        "get" : {
          "total" : 4,
          "time_in_millis" : 18,
          "exists_total" : 4,
          "exists_time_in_millis" : 18,
          "missing_total" : 0,
          "missing_time_in_millis" : 0,
          "current" : 0
        },
        "search" : {
          "open_contexts": 4,
          "query_total": 194,
          "query_time_in_millis": 467,
          "query_current": 0,
          "fetch_total": 194,
          "fetch_time_in_millis": 143,
          "fetch_current": 0,
          "scroll_total": 0,
          "scroll_time_in_millis": 0,
          "scroll_current": 0,
          "point_in_time_total": 0,
          "point_in_time_time_in_millis": 0,
          "point_in_time_current": 0,
          "suggest_total": 0,
          "suggest_time_in_millis": 0,
          "suggest_current": 0,
          "search_idle_reactivate_count_total": 0,
          "request" : {
            "dfs_pre_query" : {
              "time_in_millis" : 0,
              "current" : 0,
              "total" : 0
            },
            "query" : {
              "time_in_millis" : 200,
              "current" : 2,
              "total" : 12
            },
            "fetch" : {
              "time_in_millis" : 37,
              "current" : 3,
              "total" : 4
            },
            "dfs_query" : {
              "time_in_millis" : 0,
              "current" : 0,
              "total" : 0
            },
            "expand" : {
              "time_in_millis" : 9,
              "current" : 1,
              "total" : 0
            },
            "can_match" : {
              "time_in_millis" : 0,
              "current" : 0,
              "total" : 0
            }
          }
        },
        "merges" : {
          "current" : 0,
          "current_docs" : 0,
          "current_size_in_bytes" : 0,
          "total" : 1,
          "total_time_in_millis" : 5,
          "total_docs" : 12,
          "total_size_in_bytes" : 3967,
          "total_stopped_time_in_millis" : 0,
          "total_throttled_time_in_millis" : 0,
          "total_auto_throttle_in_bytes" : 251658240
        },
        "refresh" : {
          "total" : 74,
          "total_time_in_millis" : 201,
          "external_total" : 57,
          "external_total_time_in_millis" : 314,
          "listeners" : 0
        },
        "flush" : {
          "total" : 28,
          "periodic" : 28,
          "total_time_in_millis" : 1261
        },
        "warmer" : {
          "current" : 0,
          "total" : 45,
          "total_time_in_millis" : 99
        },
        "query_cache" : {
          "memory_size_in_bytes" : 0,
          "total_count" : 0,
          "hit_count" : 0,
          "miss_count" : 0,
          "cache_size" : 0,
          "cache_count" : 0,
          "evictions" : 0
        },
        "fielddata" : {
          "memory_size_in_bytes" : 356,
          "evictions" : 0,
          "item_count": 1
        },
        "completion" : {
          "size_in_bytes" : 0,
          "fields" : { }
        },
        "segments" : {
          "count" : 17,
          "memory_in_bytes" : 0,
          "terms_memory_in_bytes" : 0,
          "stored_fields_memory_in_bytes" : 0,
          "term_vectors_memory_in_bytes" : 0,
          "norms_memory_in_bytes" : 0,
          "points_memory_in_bytes" : 0,
          "doc_values_memory_in_bytes" : 0,
          "index_writer_memory_in_bytes" : 0,
          "version_map_memory_in_bytes" : 0,
          "fixed_bit_set_memory_in_bytes" : 288,
          "max_unsafe_auto_id_timestamp" : -1,
          "remote_store" : {
            "upload" : {
              "total_upload_size" : {
                "started_bytes" : 152419,
                "succeeded_bytes" : 152419,
                "failed_bytes" : 0
              },
              "refresh_size_lag" : {
                "total_bytes" : 0,
                "max_bytes" : 0
              },
              "max_refresh_time_lag_in_millis" : 0,
              "total_time_spent_in_millis" : 516,
              "pressure" : {
                "total_rejections" : 0
              }
            },
            "download" : {
              "total_download_size" : {
                "started_bytes" : 0,
                "succeeded_bytes" : 0,
                "failed_bytes" : 0
              },
              "total_time_spent_in_millis" : 0
            }
          },
          "file_sizes" : { }
        },
        "translog" : {
          "operations" : 12,
          "size_in_bytes" : 1452,
          "uncommitted_operations" : 12,
          "uncommitted_size_in_bytes" : 1452,
          "earliest_last_modified_age" : 164160,
          "remote_store" : {
            "upload" : {
              "total_uploads" : {
                "started" : 57,
                "failed" : 0,
                "succeeded" : 57
              },
              "total_upload_size" : {
                "started_bytes" : 16830,
                "failed_bytes" : 0,
                "succeeded_bytes" : 16830
              }
            }
          }
        },
        "request_cache" : {
          "memory_size_in_bytes" : 1649,
          "evictions" : 0,
          "hit_count" : 0,
          "miss_count" : 18
        },
        "recovery" : {
          "current_as_source" : 0,
          "current_as_target" : 0,
          "throttle_time_in_millis" : 0
        }
      },
      "os" : {
        "timestamp" : 1664484195263,
        "cpu" : {
          "percent" : 0,
          "load_average" : {
            "1m" : 0.0,
            "5m" : 0.0,
            "15m" : 0.0
          }
        },
        "mem" : {
          "total_in_bytes" : 13137076224,
          "free_in_bytes" : 9265442816,
          "used_in_bytes" : 3871633408,
          "free_percent" : 71,
          "used_percent" : 29
        },
        "swap" : {
          "total_in_bytes" : 4294967296,
          "free_in_bytes" : 4294967296,
          "used_in_bytes" : 0
        },
        "cgroup" : {
          "cpuacct" : {
            "control_group" : "/",
            "usage_nanos" : 338710071600
          },
          "cpu" : {
            "control_group" : "/",
            "cfs_period_micros" : 100000,
            "cfs_quota_micros" : -1,
            "stat" : {
              "number_of_elapsed_periods" : 0,
              "number_of_times_throttled" : 0,
              "time_throttled_nanos" : 0
            }
          },
          "memory" : {
            "control_group" : "/",
            "limit_in_bytes" : "9223372036854771712",
            "usage_in_bytes" : "1432346624"
          }
        }
      },
      "process" : {
        "timestamp" : 1664484195263,
        "open_file_descriptors" : 556,
        "max_file_descriptors" : 65536,
        "cpu" : {
          "percent" : 0,
          "total_in_millis" : 170870
        },
        "mem" : {
          "total_virtual_in_bytes" : 6563344384
        }
      },
      "jvm" : {
        "timestamp" : 1664484195264,
        "uptime_in_millis" : 21232111,
        "mem" : {
          "heap_used_in_bytes" : 308650480,
          "heap_used_percent" : 57,
          "heap_committed_in_bytes" : 536870912,
          "heap_max_in_bytes" : 536870912,
          "non_heap_used_in_bytes" : 147657128,
          "non_heap_committed_in_bytes" : 152502272,
          "pools" : {
            "young" : {
              "used_in_bytes" : 223346688,
              "max_in_bytes" : 0,
              "peak_used_in_bytes" : 318767104,
              "peak_max_in_bytes" : 0,
              "last_gc_stats" : {
                "used_in_bytes" : 0,
                "max_in_bytes" : 0,
                "usage_percent" : -1
              }
            },
            "old" : {
              "used_in_bytes" : 67068928,
              "max_in_bytes" : 536870912,
              "peak_used_in_bytes" : 67068928,
              "peak_max_in_bytes" : 536870912,
              "last_gc_stats" : {
                "used_in_bytes" : 34655744,
                "max_in_bytes" : 536870912,
                "usage_percent" : 6
              }
            },
            "survivor" : {
              "used_in_bytes" : 18234864,
              "max_in_bytes" : 0,
              "peak_used_in_bytes" : 32721280,
              "peak_max_in_bytes" : 0,
              "last_gc_stats" : {
                "used_in_bytes" : 18234864,
                "max_in_bytes" : 0,
                "usage_percent" : -1
              }
            }
          }
        },
        "threads" : {
          "count" : 80,
          "peak_count" : 80
        },
        "gc" : {
          "collectors" : {
            "young" : {
              "collection_count" : 18,
              "collection_time_in_millis" : 199
            },
            "old" : {
              "collection_count" : 0,
              "collection_time_in_millis" : 0
            }
          }
        },
        "buffer_pools" : {
          "mapped" : {
            "count" : 23,
            "used_in_bytes" : 6232113,
            "total_capacity_in_bytes" : 6232113
          },
          "direct" : {
            "count" : 63,
            "used_in_bytes" : 9050069,
            "total_capacity_in_bytes" : 9050068
          },
          "mapped - 'non-volatile memory'" : {
            "count" : 0,
            "used_in_bytes" : 0,
            "total_capacity_in_bytes" : 0
          }
        },
        "classes" : {
          "current_loaded_count" : 20693,
          "total_loaded_count" : 20693,
          "total_unloaded_count" : 0
        }
      },
      "thread_pool" : {
        "OPENSEARCH_ML_TASK_THREAD_POOL" : {
          "threads" : 0,
          "queue" : 0,
          "active" : 0,
          "rejected" : 0,
          "largest" : 0,
          "completed" : 0
        },
        "ad-batch-task-threadpool" : {
          "threads" : 0,
          "queue" : 0,
          "active" : 0,
          "rejected" : 0,
          "largest" : 0,
          "completed" : 0
        },
        ...
      },
      "fs" : {
        "timestamp" : 1664484195264,
        "total" : {
          "total_in_bytes" : 269490393088,
          "free_in_bytes" : 261251477504,
          "available_in_bytes" : 247490805760
        },
        "data" : [
          {
            "path" : "/usr/share/opensearch/data/nodes/0",
            "mount" : "/ (overlay)",
            "type" : "overlay",
            "total_in_bytes" : 269490393088,
            "free_in_bytes" : 261251477504,
            "available_in_bytes" : 247490805760
          }
        ],
        "io_stats" : { }
      },
      "transport" : {
        "server_open" : 0,
        "total_outbound_connections" : 0,
        "rx_count" : 0,
        "rx_size_in_bytes" : 0,
        "tx_count" : 0,
        "tx_size_in_bytes" : 0
      },
      "http" : {
        "current_open" : 5,
        "total_opened" : 1108
      },
      "breakers" : {
        "request" : {
          "limit_size_in_bytes" : 322122547,
          "limit_size" : "307.1mb",
          "estimated_size_in_bytes" : 0,
          "estimated_size" : "0b",
          "overhead" : 1.0,
          "tripped" : 0
        },
        "fielddata" : {
          "limit_size_in_bytes" : 214748364,
          "limit_size" : "204.7mb",
          "estimated_size_in_bytes" : 356,
          "estimated_size" : "356b",
          "overhead" : 1.03,
          "tripped" : 0
        },
        "in_flight_requests" : {
          "limit_size_in_bytes" : 536870912,
          "limit_size" : "512mb",
          "estimated_size_in_bytes" : 0,
          "estimated_size" : "0b",
          "overhead" : 2.0,
          "tripped" : 0
        },
        "parent" : {
          "limit_size_in_bytes" : 510027366,
          "limit_size" : "486.3mb",
          "estimated_size_in_bytes" : 308650480,
          "estimated_size" : "294.3mb",
          "overhead" : 1.0,
          "tripped" : 0
        }
      },
      "script" : {
        "compilations" : 0,
        "cache_evictions" : 0,
        "compilation_limit_triggered" : 0
      },
      "discovery" : {
        "cluster_state_queue" : {
          "total" : 0,
          "pending" : 0,
          "committed" : 0
        },
        "published_cluster_states" : {
          "full_states" : 2,
          "incompatible_diffs" : 0,
          "compatible_diffs" : 10
        },
        "cluster_state_stats" : {
          "overall" : {
            "update_count" : 9,
            "total_time_in_millis" : 807,
            "failed_count" : 0
          },
          "remote_upload" : {
            "success_count" : 9,
            "failed_count" : 0,
            "total_time_in_millis" : 116,
            "cleanup_attempt_failed_count" : 0
          }
        }
      },
      "ingest" : {
        "total" : {
          "count" : 0,
          "time_in_millis" : 0,
          "current" : 0,
          "failed" : 0
        },
        "pipelines" : { }
      },
      "search_pipeline" : {
        "total_request" : {
          "count" : 5,
          "time_in_millis" : 158,
          "current" : 0,
          "failed" : 0
        },
        "total_response" : {
          "count" : 2,
          "time_in_millis" : 1,
          "current" : 0,
          "failed" : 0
        },
        "pipelines" : {
          "public_info" : {
            "request" : {
              "count" : 3,
              "time_in_millis" : 71,
              "current" : 0,
              "failed" : 0
            },
            "response" : {
              "count" : 0,
              "time_in_millis" : 0,
              "current" : 0,
              "failed" : 0
            },
            "request_processors" : [
              {
                "filter_query:abc" : {
                  "type" : "filter_query",
                  "stats" : {
                    "count" : 1,
                    "time_in_millis" : 0,
                    "current" : 0,
                    "failed" : 0
                  }
                }
              },
            ]
              ...
            "response_processors" : [
              {
                "rename_field" : {
                  "type" : "rename_field",
                  "stats" : {
                    "count" : 2,
                    "time_in_millis" : 1,
                    "current" : 0,
                    "failed" : 0
                  }
                }
              }
            ]
          },
          ...
        }
      },
      "adaptive_selection" : {
        "F-ByTQzVQ3GQeYzQJArJGQ" : {
          "outgoing_searches" : 0,
          "avg_queue_size" : 0,
          "avg_service_time_ns" : 501024,
          "avg_response_time_ns" : 794105,
          "rank" : "0.8"
        }
      },
      "script_cache" : {
        "sum" : {
          "compilations" : 0,
          "cache_evictions" : 0,
          "compilation_limit_triggered" : 0
        },
        "contexts" : [
          {
            "context" : "aggregation_selector",
            "compilations" : 0,
            "cache_evictions" : 0,
            "compilation_limit_triggered" : 0
          },
          {
            "context" : "aggs",
            "compilations" : 0,
            "cache_evictions" : 0,
            "compilation_limit_triggered" : 0
          },
          ...
        ]
      },
      "indexing_pressure" : {
        "memory" : {
          "current" : {
            "combined_coordinating_and_primary_in_bytes" : 0,
            "coordinating_in_bytes" : 0,
            "primary_in_bytes" : 0,
            "replica_in_bytes" : 0,
            "all_in_bytes" : 0
          },
          "total" : {
            "combined_coordinating_and_primary_in_bytes" : 40256,
            "coordinating_in_bytes" : 40256,
            "primary_in_bytes" : 45016,
            "replica_in_bytes" : 0,
            "all_in_bytes" : 40256,
            "coordinating_rejections" : 0,
            "primary_rejections" : 0,
            "replica_rejections" : 0
          },
          "limit_in_bytes" : 53687091
        }
      },
      "shard_indexing_pressure" : {
        "stats" : { },
        "total_rejections_breakup_shadow_mode" : {
          "node_limits" : 0,
          "no_successful_request_limits" : 0,
          "throughput_degradation_limits" : 0
        },
        "enabled" : false,
        "enforced" : false
      },
      "resource_usage_stats": {
        "nxLWtMdXQmWA-ZBVWU8nwA": {
          "timestamp": 1698401391000,
          "cpu_utilization_percent": "0.1",
          "memory_utilization_percent": "3.9",
          "io_usage_stats": {
            "max_io_utilization_percent": "99.6"
          }
        }
      },
      "admission_control": {
        "global_cpu_usage": {
          "transport": {
            "rejection_count": {
              "search": 3,
              "indexing": 1
            }
          }
        },
        "global_io_usage": {
          "transport": {
            "rejection_count": {
              "search": 3,
              "indexing": 1
            }
          }
        }
      },
      "caches" : {
        "request_cache" : {
          "size_in_bytes" : 1649,
          "evictions" : 0,
          "hit_count" : 0,
          "miss_count" : 18,
          "item_count" : 18,
          "store_name" : "opensearch_onheap"
        }
      }
    }
  }
}

응답 본문 필드 (Response body fields)

다음 표는 모든 응답 필드를 정리한 거예요.

필드 데이터 타입 설명
_nodes Object 반환된 노드에 대한 통계예요.
_nodes.total Integer 이 요청의 총 노드 수예요.
_nodes.successful Integer 요청이 성공한 노드 수예요.
_nodes.failed Integer 요청이 실패한 노드 수예요. 실패한 노드가 있으면 실패 메시지가 포함돼요.
cluster_name String 클러스터의 이름이에요.
nodes Object 이 요청에 포함된 노드의 통계예요.

nodes

nodes 객체에는 요청이 반환한 모든 노드와 그 ID가 포함돼요. 각 노드는 다음 속성을 가져요.

필드 데이터 타입 설명
timestamp Integer 노드 통계가 수집된 시간이에요. 에포크 이후 경과한 밀리초예요.
name String 노드의 이름이에요.
transport_address IP 주소 클러스터의 노드가 내부 통신에 사용하는 transport 계층의 호스트와 포트예요.
host IP 주소 노드의 네트워크 호스트예요.
ip IP 주소 노드의 IP 주소와 포트예요.
roles Array 노드의 역할이에요(예: cluster_manager, data, ingest).
attributes Object 노드의 속성이에요(예: shard_indexing_pressure_enabled).
indices Object 노드에 샤드가 있는 각 인덱스의 인덱스 통계예요.
os Object 노드의 운영체제 통계예요.
process Object 노드의 프로세스 통계예요.
jvm Object 노드의 JVM 통계예요.
thread_pool Object 노드의 각 스레드 풀 통계예요.
fs Object 노드의 파일 저장소 통계예요.
transport Object 노드의 transport 통계예요.
http Object 노드의 HTTP 통계예요.
http.current_open Integer 노드의 현재 열려 있는 HTTP 연결 수예요.
http.total_opened Integer 노드가 시작된 이후 연 HTTP 연결의 총 수예요.
breakers Object 노드의 서킷 브레이커 통계예요.
script Object 노드의 스크립트 통계예요.
script_cache Object 노드의 스크립트 캐시 통계예요.
discovery Object 노드의 노드 발견 통계예요.
ingest Object 노드의 ingest 통계예요.
search_pipeline Object 검색 파이프라인 관련 통계예요.
adaptive_selection Object 노드의 적응형 선택 통계예요.
indexing_pressure Object 노드의 색인 백프레셔 관련 통계예요.
shard_indexing_pressure Object 샤드 수준 색인 백프레셔 관련 통계예요.
search_backpressure Object 검색 백프레셔 관련 통계예요.
cluster_manager_throttling Object 클러스터 매니저 노드의 조절된 작업 관련 통계예요.
task_cancellation Object 취소된 뒤에도 계속 실행되는 작업 통계예요.
weighted_routing Object 가중 라운드 로빈 요청 관련 통계예요.
resource_usage_stats Object 노드의 리소스 사용 관련 통계예요.
admission_control Object 노드의 승인 제어 관련 통계예요.
caches Object 노드의 캐시 관련 통계예요.

indices

indices 객체에는 이 노드에 샤드가 있는 각 인덱스의 인덱스 통계가 포함돼요. 각 인덱스는 다음 속성을 가져요.

필드 필드 타입 설명
docs Object 노드에 존재하는 모든 기본(primary) 샤드의 문서 통계예요.
docs.count Integer Lucene이 보고한 문서 수예요. 삭제된 문서와 아직 세그먼트에 배정되지 않은 최근 색인 문서는 제외돼요. 중첩 문서는 별도로 계산돼요.
docs.deleted Integer Lucene이 보고한 삭제 문서 수예요. 아직 세그먼트에 영향을 주지 않은 최근 삭제 작업은 제외돼요.
store Object 노드에 있는 샤드 크기 통계예요.
store.size_in_bytes Integer 노드의 모든 샤드 총 크기예요.
store.reserved_in_bytes Integer 스냅샷 복원과 피어 복구 같은 활동 때문에 샤드 저장소가 커질 것으로 예측되는 바이트 수예요.
indexing Object 노드의 색인 작업 통계예요.
indexing.index_total Integer 노드의 색인 작업 총 수예요.
indexing.index_time_in_millis Integer 모든 색인 작업의 총 시간(밀리초)이에요.
indexing.index_current Integer 현재 실행 중인 색인 작업 수예요.
indexing.index_failed Integer 실패한 색인 작업 수예요.
indexing.delete_total Integer 삭제 작업의 총 수예요.
indexing.delete_time_in_millis Integer 모든 삭제 작업의 총 시간(밀리초)이에요.
indexing.delete_current Integer 현재 실행 중인 삭제 작업 수예요.
indexing.noop_update_total Integer no-op 작업의 총 수예요.
indexing.is_throttled Boolean 어떤 작업이 조절되었는지 여부를 지정해요.
indexing.throttle_time_in_millis Integer 조절 작업의 총 시간(밀리초)이에요.
get Object 노드의 get 작업 통계예요.
get.total Integer get 작업의 총 수예요.
get.time_in_millis Integer 모든 get 작업의 총 시간(밀리초)이에요.
get.exists_total Integer 성공한 get 작업의 총 수예요.
get.exists_time_in_millis Integer 모든 성공한 get 작업의 총 시간(밀리초)이에요.
get.missing_total Integer 실패한 get 작업의 수예요.
get.missing_time_in_millis Integer 모든 실패한 get 작업의 총 시간(밀리초)이에요.
get.current Integer 현재 실행 중인 get 작업 수예요.
search Object 노드의 검색 작업 통계예요.
search.concurrent_avg_slice_count Integer 모든 검색 요청의 평균 슬라이스 수예요. 총 슬라이스 수를 총 동시 검색 요청 수로 나눠 계산해요.
search.concurrent_query_total Integer 동시 세그먼트 검색을 사용하는 쿼리 작업의 총 수예요.
search.concurrent_query_time_in_millis Integer 동시 세그먼트 검색을 사용하는 모든 쿼리 작업의 총 시간(밀리초)이에요.
search.concurrent_query_current Integer 동시 세그먼트 검색을 사용하는 현재 실행 중인 쿼리 작업 수예요.
search.startree_query_total Integer 검색에 star tree를 사용하는 쿼리 작업의 총 수예요.
search.startree_query_time_in_millis Integer 검색에 star tree를 사용하는 모든 쿼리 작업의 총 시간(밀리초)이에요.
search.startree_query_current Integer 검색에 star tree를 사용하는 현재 실행 중인 쿼리 작업 수예요.
search.startree_query_failed Integer 검색에 star tree를 사용하는 실패한 쿼리 작업 수예요.
search.open_contexts Integer 열려 있는 검색 컨텍스트 수예요.
search.query_total Integer 샤드 쿼리 작업의 총 수예요.
search.query_time_in_millis Integer 모든 샤드 쿼리 작업의 총 시간(밀리초)이에요.
search.query_current Integer 현재 실행 중인 샤드 쿼리 작업 수예요.
search.query_failed Integer 실패한 샤드 쿼리 작업의 총 수예요.
search.fetch_total Integer 샤드 fetch 작업의 총 수예요.
search.fetch_time_in_millis Integer 모든 샤드 fetch 작업의 총 시간(밀리초)이에요.
search.fetch_current Integer 현재 실행 중인 샤드 fetch 작업 수예요.
search.scroll_total Integer 샤드 scroll 작업의 총 수예요.
search.scroll_time_in_millis Integer 모든 샤드 scroll 작업의 총 시간(밀리초)이에요.
search.scroll_current Integer 현재 실행 중인 샤드 scroll 작업 수예요.
search.point_in_time_total Integer 노드가 마지막으로 재시작된 이후 생성된(완료·활성) 샤드 Point in Time (PIT) 컨텍스트의 총 수예요.
search.point_in_time_time_in_millis Integer 노드가 마지막으로 재시작된 이후 샤드 PIT 컨텍스트가 열려 있었던 시간(밀리초)이에요.
search.point_in_time_current Integer 현재 열려 있는 샤드 PIT 컨텍스트 수예요.
search.suggest_total Integer 샤드 suggest 작업의 총 수예요.
search.suggest_time_in_millis Integer 모든 샤드 suggest 작업의 총 시간(밀리초)이에요.
search.suggest_current Integer 현재 실행 중인 샤드 suggest 작업 수예요.
search.search_idle_reactivate_count_total Integer 모든 샤드가 유휴 상태에서 활성화된 총 횟수예요.
search.request Object 노드의 조정(coordinator) 검색 작업 통계예요.
search.request.took.time_in_millis Integer 모든 검색 요청에 걸린 총 시간(밀리초)이에요.
search.request.took.current Integer 현재 실행 중인 검색 요청 수예요.
search.request.took.total Integer 완료된 검색 요청의 총 수예요.
search.request.dfs_pre_query.time_in_millis Integer 모든 조정 DFS(깊이 우선 검색) 사전 쿼리 작업의 총 시간(밀리초)이에요.
search.request.dfs_pre_query.current Integer 현재 실행 중인 조정 DFS 사전 쿼리 작업 수예요.
search.request.dfs_pre_query.total Integer 완료된 조정 DFS 사전 쿼리 작업의 총 수예요.
search.request.query.time_in_millis Integer 모든 조정 쿼리 작업의 총 시간(밀리초)이에요.
search.request.query.current Integer 현재 실행 중인 조정 쿼리 작업 수예요.
search.request.query.total Integer 완료된 조정 쿼리 작업의 총 수예요.
search.request.fetch.time_in_millis Integer 모든 조정 fetch 작업의 총 시간(밀리초)이에요.
search.request.fetch.current Integer 현재 실행 중인 조정 fetch 작업 수예요.
search.request.fetch.total Integer 완료된 조정 fetch 작업의 총 수예요.
search.request.dfs_query.time_in_millis Integer 모든 조정 DFS 쿼리 작업의 총 시간(밀리초)이에요.
search.request.dfs_query.current Integer 현재 실행 중인 조정 DFS 쿼리 작업 수예요.
search.request.dfs_query.total Integer 완료된 조정 DFS 쿼리 작업의 총 수예요.
search.request.expand.time_in_millis Integer 모든 조정 expand 작업의 총 시간(밀리초)이에요.
search.request.expand.current Integer 현재 실행 중인 조정 expand 작업 수예요.
search.request.expand.total Integer 완료된 조정 expand 작업의 총 수예요.
search.request.can_match.time_in_millis Integer 모든 조정 can_match 작업의 총 시간(밀리초)이에요.
search.request.can_match.current Integer 현재 실행 중인 조정 can_match 작업 수예요.
search.request.can_match.total Integer 완료된 조정 can_match 작업의 총 수예요.
merges Object 노드의 병합 작업 통계예요.
merges.current Integer 현재 실행 중인 병합 작업 수예요.
merges.current_docs Integer 현재 실행 중인 문서 병합 수예요.
merges.current_size_in_bytes Integer 현재 병합 작업을 수행하는 데 사용되는 메모리 크기(바이트)예요.
merges.total Integer 병합 작업의 총 수예요.
merges.total_time_in_millis Integer 병합의 총 시간(밀리초)이에요.
merges.total_docs Integer 병합된 문서의 총 수예요.
merges.total_size_in_bytes Integer 병합된 모든 문서의 총 크기(바이트)예요.
merges.total_stopped_time_in_millis Integer 병합 작업을 중지하는 데 소요된 총 시간(밀리초)이에요.
merges.total_throttled_time_in_millis Integer 병합 작업을 조절하는 데 소요된 총 시간(밀리초)이에요.
merges.total_auto_throttle_in_bytes Integer 자동 조절된 병합 작업의 총 크기(바이트)예요.
refresh Object 노드의 새로고침 작업 통계예요.
refresh.total Integer 새로고침 작업의 총 수예요.
refresh.total_time_in_millis Integer 모든 새로고침 작업의 총 시간(밀리초)이에요.
refresh.external_total Integer 외부 새로고침 작업의 총 수예요.
refresh.external_total_time_in_millis Integer 모든 외부 새로고침 작업의 총 시간(밀리초)이에요.
refresh.listeners Integer 새로고침 리스너 수예요.
flush Object 노드의 flush 작업 통계예요.
flush.total Integer flush 작업의 총 수예요.
flush.periodic Integer 주기적 flush 작업의 총 수예요.
flush.total_time_in_millis Integer 모든 flush 작업의 총 시간(밀리초)이에요.
warmer Object 노드의 인덱스 워밍 작업 통계예요.
warmer.current Integer 현재 인덱스 워밍 작업 수예요.
warmer.total Integer 인덱스 워밍 작업의 총 수예요.
warmer.total_time_in_millis Integer 모든 인덱스 워밍 작업의 총 시간(밀리초)이에요.
query_cache Object 노드의 쿼리 캐시 작업 통계예요.
query_cache.memory_size_in_bytes Integer 노드의 모든 샤드에 대한 쿼리 캐시에 사용된 메모리 양이에요.
query_cache.total_count Integer 쿼리 캐시의 총 hit·miss 수예요.
query_cache.hit_count Integer 쿼리 캐시의 총 hit 수예요.
query_cache.miss_count Integer 쿼리 캐시의 총 miss 수예요.
query_cache.cache_size Integer 현재 쿼리 캐시에 있는 쿼리 수예요.
query_cache.cache_count Integer 이후 제거된 쿼리를 포함해 쿼리 캐시에 추가된 쿼리의 총 수예요.
query_cache.evictions Integer 쿼리 캐시에서 제거된 수예요.
fielddata Object 노드의 모든 샤드에 대한 필드 데이터 캐시 통계예요.
fielddata.memory_size_in_bytes Integer 노드의 모든 샤드에 대한 필드 데이터 캐시에 사용된 총 메모리 양이에요.
fielddata.evictions Integer 필드 데이터 캐시에서 제거된 수예요.
fielddata.item_count Integer 필드 데이터 캐시의 항목 수예요.
fielddata.fields Object 모든 필드 데이터 필드를 담고 있어요.
completion Object 노드의 모든 샤드에 대한 completion 통계예요.
completion.size_in_bytes Integer 노드의 모든 샤드에 대한 completion에 사용된 총 메모리 양(바이트)이에요.
completion.fields Object completion 필드를 담고 있어요.
segments Object 노드의 모든 샤드에 대한 세그먼트 통계예요.
segments.count Integer 총 세그먼트 수예요.
segments.memory_in_bytes Integer 총 메모리 양(바이트)이에요.
segments.terms_memory_in_bytes Integer terms에 사용된 총 메모리 양(바이트)이에요.
segments.stored_fields_memory_in_bytes Integer 저장된 필드에 사용된 총 메모리 양(바이트)이에요.
segments.term_vectors_memory_in_bytes Integer term vectors에 사용된 총 메모리 양(바이트)이에요.
segments.norms_memory_in_bytes Integer 정규화 요소에 사용된 총 메모리 양(바이트)이에요.
segments.points_memory_in_bytes Integer points에 사용된 총 메모리 양(바이트)이에요.
segments.doc_values_memory_in_bytes Integer doc values에 사용된 총 메모리 양(바이트)이에요.
segments.index_writer_memory_in_bytes Integer 모든 인덱스 라이터가 사용한 총 메모리 양(바이트)이에요.
segments.version_map_memory_in_bytes Integer 모든 버전 맵이 사용한 총 메모리 양(바이트)이에요.
segments.fixed_bit_set_memory_in_bytes Integer 고정 비트 집합(fixed bit sets)이 사용한 총 메모리 양(바이트)이에요. 고정 비트 집합은 중첩 객체와 join 필드에 사용돼요.
segments.max_unsafe_auto_id_timestamp Integer 가장 최근에 은퇴한(현재 사용되지 않는) 색인 요청의 타임스탬프예요. 에포크 이후 경과한 밀리초예요.
segments.segment_replication Object 노드에서 세그먼트 복제가 활성화된 경우 모든 기본 샤드의 세그먼트 복제 통계예요.
segments.segment_replication.max_bytes_behind long 기본 복제본보다 뒤처진 최대 바이트 수예요.
segments.segment_replication.total_bytes_behind long 기본 복제본들보다 뒤처진 총 바이트 수예요.
segments.segment_replication.max_replication_lag long 복제본이 기본 노드를 따라잡는 데 걸린 최대 시간(밀리초)이에요.
segments.remote_store Object 원격 세그먼트 저장소 작업 통계예요.
segments.remote_store.upload Object 원격 세그먼트 저장소로의 업로드 관련 통계예요.
segments.remote_store.upload.total_upload_size Object 원격 세그먼트 저장소에 업로드된 데이터 양(바이트)이에요.
segments.remote_store.upload.total_upload_size.started_bytes Integer 업로드가 시작된 후 원격 세그먼트 저장소에 업로드할 바이트 수예요.
segments.remote_store.upload.total_upload_size.succeeded_bytes Integer 원격 세그먼트 저장소에 성공적으로 업로드된 바이트 수예요.
segments.remote_store.upload.total_upload_size.failed_bytes Integer 원격 세그먼트 저장소에 업로드하지 못한 바이트 수예요.
segments.remote_store.upload.refresh_size_lag Object 업로드 중 원격 세그먼트 저장소와 로컬 저장소 사이의 지연(lag) 양이에요.
segments.remote_store.upload.refresh_size_lag.total_bytes Integer 원격 세그먼트 저장소와 로컬 저장소 사이의 업로드 새로고침 중 지연된 총 바이트 수예요.
segments.remote_store.upload.refresh_size_lag.max_bytes Integer 원격 세그먼트 저장소와 로컬 저장소 사이의 업로드 새로고침 중 최대 지연 양(바이트)이에요.
segments.remote_store.upload.max_refresh_time_lag_in_millis Integer 원격 새로고침이 로컬 새로고침보다 뒤처진 최대 기간(밀리초)이에요.
segments.remote_store.upload.total_time_spent_in_millis Integer 원격 세그먼트 저장소로의 업로드에 소요된 총 시간(밀리초)이에요.
segments.remote_store.upload.pressure Object 세그먼트 저장소 업로드 백프레셔 관련 통계예요.
segments.remote_store.upload.pressure.total_rejections Integer 세그먼트 저장소 업로드 백프레셔 때문에 거부된 요청의 총 수예요.
segments.remote_store.download Object 원격 세그먼트 저장소로부터의 다운로드 관련 통계예요.
segments.remote_store.download.total_download_size Object 원격 세그먼트 저장소에서 다운로드한 총 데이터 양이에요.
segments.remote_store.download.total_download_size.started_bytes Integer 다운로드가 시작된 후 원격 세그먼트 저장소에서 다운로드한 바이트 수예요.
segments.remote_store.download.total_download_size.succeeded_bytes Integer 원격 세그먼트 저장소에서 성공적으로 다운로드한 바이트 수예요.
segments.remote_store.download.total_download_size.failed_bytes Integer 원격 세그먼트 저장소에서 다운로드하지 못한 바이트 수예요.
segments.remote_store.download.total_time_spent_in_millis Integer 원격 세그먼트 저장소에서 다운로드에 소요된 총 기간(밀리초)이에요.
segments.file_sizes Integer 세그먼트 파일 크기 통계예요.
translog Object 노드의 트랜잭션 로그 작업 통계예요.
translog.operations Integer translog 작업 수예요.
translog.size_in_bytes Integer translog의 크기(바이트)예요.
translog.uncommitted_operations Integer 커밋되지 않은 translog 작업 수예요.
translog.uncommitted_size_in_bytes Integer 커밋되지 않은 translog 작업의 크기(바이트)예요.
translog.earliest_last_modified_age Integer translog의 가장 이른 마지막 수정 시각이에요.
translog.remote_store Object 원격 translog 저장소의 작업 관련 통계예요.
translog.remote_store.upload Object 원격 translog 저장소로의 업로드 관련 통계예요.
translog.remote_store.upload.total_uploads Object 원격 translog 저장소로의 동기화(sync) 수예요.
translog.remote_store.upload.total_uploads.started Integer 시작된 원격 translog 저장소 업로드 동기화 수예요.
translog.remote_store.upload.total_uploads.failed Integer 실패한 원격 translog 저장소 업로드 동기화 수예요.
translog.remote_store.upload.total_uploads.succeeded Integer 성공한 원격 translog 저장소 업로드 동기화 수예요.
translog.remote_store.upload.total_upload_size Object 원격 translog 저장소에 업로드된 총 데이터 양이에요.
translog.remote_store.upload.total_upload_size.started_bytes Integer 업로드가 시작된 후 원격 translog 저장소에 활발히 업로드 중인 바이트 수예요.
translog.remote_store.upload.total_upload_size.failed_bytes Integer 원격 translog 저장소에 업로드하지 못한 바이트 수예요.
translog.remote_store.upload.total_upload_size.succeeded_bytes Integer 원격 translog 저장소에 성공적으로 업로드된 바이트 수예요.
request_cache Object 노드의 요청 캐시 통계예요.
request_cache.memory_size_in_bytes Integer 요청 캐시가 사용하는 메모리 크기(바이트)예요.
request_cache.evictions Integer 요청 캐시에서 제거된 수예요.
request_cache.hit_count Integer 요청 캐시 hit 수예요.
request_cache.miss_count Integer 요청 캐시 miss 수예요.
recovery Object 노드의 복구 작업 통계예요.
recovery.current_as_source Integer 인덱스 샤드를 소스로 사용한 복구 작업 수예요.
recovery.current_as_target Integer 인덱스 샤드를 대상으로 사용한 복구 작업 수예요.
recovery.throttle_time_in_millis Integer 조절 때문에 지연된 복구 작업의 시간(밀리초)이에요.

os

os 객체에는 노드의 운영체제 통계가 있으며 다음 속성을 가져요.

필드 필드 타입 설명
timestamp Integer 운영체제 통계의 마지막 새로고침 시간이에요. 에포크 이후 경과한 밀리초예요.
cpu Object 노드의 CPU 사용 통계예요.
cpu.percent Integer 시스템의 최근 CPU 사용률이에요.
cpu.load_average Object 시스템의 로드 평균 통계예요.
cpu.load_average.1m Float 1분 동안의 시스템 로드 평균이에요.
cpu.load_average.5m Float 5분 동안의 시스템 로드 평균이에요.
cpu.load_average.15m Float 15분 동안의 시스템 로드 평균이에요.
mem Object 노드의 메모리 사용 통계예요.
mem.total_in_bytes Integer 물리 메모리의 총 양(바이트)이에요.
mem.free_in_bytes Integer 여유 물리 메모리의 총 양(바이트)이에요.
mem.used_in_bytes Integer 사용 중인 물리 메모리의 총 양(바이트)이에요.
mem.free_percent Integer 여유 메모리의 백분율이에요.
mem.used_percent Integer 사용 중인 메모리의 백분율이에요.
swap Object 노드의 스왑 공간 통계예요.
swap.total_in_bytes Integer 스왑 공간의 총 양(바이트)이에요.
swap.free_in_bytes Integer 여유 스왑 공간의 총 양(바이트)이에요.
swap.used_in_bytes Integer 사용 중인 스왑 공간의 총 양(바이트)이에요.
cgroup Object 노드의 cgroup 통계를 담고 있어요. Linux에서만 반환돼요.
cgroup.cpuacct Object 노드의 cpuacct 제어 그룹 통계예요.
cgroup.cpu Object 노드의 CPU 제어 그룹 통계예요.
cgroup.memory Object 노드의 메모리 제어 그룹 통계예요.

process

process 객체에는 노드의 프로세스 통계가 있으며 다음 속성을 가져요.

필드 필드 타입 설명
timestamp Integer 프로세스 통계의 마지막 새로고침 시간이에요. 에포크 이후 경과한 밀리초예요.
open_file_descriptors Integer 현재 프로세스와 연결된 열린 파일 디스크립터 수예요.
max_file_descriptors Integer 시스템의 최대 파일 디스크립터 수예요.
cpu Object 노드의 CPU 통계예요.
cpu.percent Integer 프로세스의 CPU 사용 백분율이에요.
cpu.total_in_millis Integer JVM이 실행 중인 프로세스가 사용한 총 CPU 시간(밀리초)이에요.
mem Object 노드의 메모리 통계예요.
mem.total_virtual_in_bytes Integer 현재 실행 중인 프로세스에 사용 가능할 것이 보장된 가상 메모리의 총 양(바이트)이에요.

jvm

jvm 객체에는 노드의 JVM 통계가 있으며 다음 속성을 가져요.

필드 필드 타입 설명
timestamp Integer JVM 통계의 마지막 새로고침 시간이에요. 에포크 이후 경과한 밀리초예요.
uptime_in_millis Integer JVM 가동 시간(밀리초)이에요.
mem Object 노드의 JVM 메모리 사용 통계예요.
mem.heap_used_in_bytes Integer 현재 사용 중인 메모리 양(바이트)이에요.
mem.heap_used_percent Integer 힙이 현재 사용 중인 메모리 백분율이에요.
mem.heap_committed_in_bytes Integer 힙이 사용할 수 있는 메모리 양(바이트)이에요.
mem.heap_max_in_bytes Integer 힙이 사용할 수 있는 최대 메모리 양(바이트)이에요.
mem.non_heap_used_in_bytes Integer 현재 사용 중인 비힙(non-heap) 메모리 양(바이트)이에요.
mem.non_heap_committed_in_bytes Integer 사용할 수 있는 최대 비힙 메모리 양(바이트)이에요.
mem.pools Object 노드의 힙 메모리 사용 통계예요.
mem.pools.young Object 노드의 young 세대 힙 메모리 사용 통계예요. 사용된 메모리 양, 사용 가능한 최대 메모리 양, 사용된 최고 메모리 양을 담고 있어요.
mem.pools.old Object 노드의 old 세대 힙 메모리 사용 통계예요. 사용된 메모리 양, 사용 가능한 최대 메모리 양, 사용된 최고 메모리 양을 담고 있어요.
mem.pools.survivor Object 노드의 survivor 공간 메모리 사용 통계예요. 사용된 메모리 양, 사용 가능한 최대 메모리 양, 사용된 최고 메모리 양을 담고 있어요.
threads Object 노드의 JVM 스레드 사용 통계예요.
threads.count Integer JVM에서 현재 활성화된 스레드 수예요.
threads.peak_count Integer JVM의 최대 스레드 수예요.
gc.collectors Object 노드의 JVM 가비지 컬렉터 통계예요.
gc.collectors.young Integer young 세대 객체를 수집하는 JVM 가비지 컬렉터 통계예요.
gc.collectors.young.collection_count Integer young 세대 객체를 수집하는 가비지 컬렉터 수예요.
gc.collectors.young.collection_time_in_millis Integer young 세대 객체의 가비지 컬렉션에 소요된 총 시간(밀리초)이에요.
gc.collectors.old Integer old 세대 객체를 수집하는 JVM 가비지 컬렉터 통계예요.
gc.collectors.old.collection_count Integer old 세대 객체를 수집하는 가비지 컬렉터 수예요.
gc.collectors.old.collection_time_in_millis Integer old 세대 객체의 가비지 컬렉션에 소요된 총 시간(밀리초)이에요.
buffer_pools Object 노드의 JVM 버퍼 풀 통계예요.
buffer_pools.mapped Object 노드의 매핑된(mapped) JVM 버퍼 풀 통계예요.
buffer_pools.mapped.count Integer 매핑된 버퍼 풀 수예요.
buffer_pools.mapped.used_in_bytes Integer 매핑된 버퍼 풀이 사용하는 메모리 양(바이트)이에요.
buffer_pools.mapped.total_capacity_in_bytes Integer 매핑된 버퍼 풀의 총 용량(바이트)이에요.
buffer_pools.direct Object 노드의 다이렉트(direct) JVM 버퍼 풀 통계예요.
buffer_pools.direct.count Integer 다이렉트 버퍼 풀 수예요.
buffer_pools.direct.used_in_bytes Integer 다이렉트 버퍼 풀이 사용하는 메모리 양(바이트)이에요.
buffer_pools.direct.total_capacity_in_bytes Integer 다이렉트 버퍼 풀의 총 용량(바이트)이에요.
classes Object 노드의 JVM이 로드한 클래스 통계예요.
classes.current_loaded_count Integer JVM이 현재 로드한 클래스 수예요.
classes.total_loaded_count Integer JVM이 시작된 이후 로드한 클래스의 총 수예요.
classes.total_unloaded_count Integer JVM이 시작된 이후 언로드한 클래스의 총 수예요.

thread_pool

thread_pool 객체에는 모든 스레드 풀의 목록이 들어 있어요. 각 스레드 풀은 ID로 지정되는 중첩 객체이며 다음 속성을 가져요.

필드 필드 타입 설명
threads Integer 풀의 스레드 수예요.
queue Integer 대기열에 있는 스레드 수예요.
active Integer 풀의 활성 스레드 수예요.
rejected Integer 거부된 작업 수예요.
largest Integer 풀의 최고 스레드 수예요.
completed Integer 완료된 작업 수예요.
total_wait_time_in_nanos Integer 작업이 스레드 풀 대기열에서 대기하는 총 시간이에요. 현재 이 메트릭을 지원하는 스레드 풀은 search, search_throttled, index_searcher뿐이에요.

fs

fs 객체는 노드의 파일 저장소 통계를 나타내며 다음 속성을 가져요.

필드 필드 타입 설명
timestamp Integer 파일 저장소 통계의 마지막 새로고침 시간이에요. 에포크 이후 경과한 밀리초예요.
total Object 노드의 모든 파일 저장소 통계예요.
total.total_in_bytes Integer 모든 파일 저장소의 총 메모리 크기(바이트)예요.
total.free_in_bytes Integer 모든 파일 저장소의 총 미할당 디스크 공간(바이트)이에요.
total.available_in_bytes Integer 모든 파일 저장소에서 JVM이 사용할 수 있는 총 디스크 공간이에요. OpenSearch가 실제로 사용할 수 있는 메모리 양(바이트)을 나타내요.
data Array 모든 파일 저장소의 목록이에요. 각 파일 저장소는 다음 속성을 가져요.
data.path String 파일 저장소의 경로예요.
data.mount String 파일 저장소의 마운트 지점이에요.
data.type String 파일 저장소의 유형이에요(예: overlay).
data.total_in_bytes Integer 파일 저장소의 총 크기(바이트)예요.
data.free_in_bytes Integer 파일 저장소의 총 미할당 디스크 공간(바이트)이에요.
data.available_in_bytes Integer 파일 저장소에서 JVM이 사용할 수 있는 총 디스크 공간(바이트)이에요.
io_stats Object 노드의 I/O 통계예요(Linux 전용). 장치, 읽기·쓰기 작업, I/O 작업 시간을 포함해요.

transport

transport 객체는 다음 속성을 가져요.

필드 필드 타입 설명
server_open Integer OpenSearch 노드가 내부 통신에 사용하는 열린 인바운드 TCP 연결 수예요.
total_outbound_connections Integer 노드가 시작된 이후 연 아웃바운드 transport 연결의 총 수예요.
rx_count Integer 노드가 내부 통신 동안 받은 RX(수신) 패킷의 총 수예요.
rx_size_in_bytes Integer 노드가 내부 통신 동안 받은 RX 패킷의 총 크기(바이트)예요.
tx_count Integer 노드가 내부 통신 동안 보낸 TX(전송) 패킷의 총 수예요.
tx_size_in_bytes Integer 노드가 내부 통신 동안 보낸 TX(전송) 패킷의 총 크기(바이트)예요.

breakers

breakers 객체는 노드의 서킷 브레이커 통계를 담고 있어요. 각 서킷 브레이커는 이름으로 나열되는 중첩 객체이며 다음 속성을 가져요.

필드 필드 타입 설명
limit_size_in_bytes Integer 서킷 브레이커의 메모리 한도(바이트)예요.
limit_size Byte value 사람이 읽을 수 있는 형식의 서킷 브레이커 메모리 한도예요(예: 307.1mb).
estimated_size_in_bytes Integer 작업에 사용된 것으로 추정되는 메모리(바이트)예요.
estimated_size Byte value 사람이 읽을 수 있는 형식의 작업 추정 메모리예요(예: 356b).
overhead Float 최종 추정치를 계산하기 위해 모든 추정치에 곱하는 계수예요.
tripped Integer 메모리 부족 오류를 막기 위해 서킷 브레이커가 활성화된 총 횟수예요.

script 및 script_cache

script와 script_cache 객체는 다음 속성을 가져요.

필드 필드 타입 설명
script Object 노드의 스크립트 통계예요.
script.compilations Integer 노드의 스크립트 컴파일 총 수예요.
script.cache_evictions Integer 스크립트 캐시가 오래된 데이터를 정리한 총 횟수예요.
script.compilation_limit_triggered Integer 서킷 브레이커에 의해 스크립트 컴파일이 제한된 총 횟수예요.
script_cache Object 노드의 스크립트 캐시 통계예요.
script_cache.sum.compilations Integer 노드의 캐시에서 스크립트 컴파일의 총 수예요.
script_cache.sum.cache_evictions Integer 스크립트 캐시가 오래된 데이터를 정리한 총 횟수예요.
script_cache.sum.compilation_limit_triggered Integer 캐시에서 서킷 브레이커에 의해 스크립트 컴파일이 제한된 총 횟수예요.
script_cache.contexts Array of objects 스크립트 캐시의 컨텍스트 목록이에요. 각 컨텍스트는 이름, 컴파일 수, 캐시 제거 수, 서킷 브레이커로 제한된 횟수를 담고 있어요.

discovery

discovery 객체는 노드 발견 통계를 담고 있으며 다음 속성을 가져요.

필드 필드 타입 설명
cluster_state_queue Object 노드의 클러스터 상태 대기열 통계예요.
cluster_state_queue.total Integer 대기열의 총 클러스터 상태 수예요.
cluster_state_queue.pending Integer 대기열의 보류 중(pending) 클러스터 상태 수예요.
cluster_state_queue.committed Integer 대기열의 커밋된 클러스터 상태 수예요.
published_cluster_states Object 노드의 게시된 클러스터 상태 통계예요.
published_cluster_states.full_states Integer 게시된 클러스터 상태 수예요.
published_cluster_states.incompatible_diffs Integer 게시된 클러스터 상태 사이의 비호환 차이 수예요.
published_cluster_states.compatible_diffs Integer 게시된 클러스터 상태 사이의 호환 차이 수예요.
cluster_state_stats Object 활성 리더가 게시한 클러스터 상태 업데이트 통계예요.
cluster_state_stats.overall Object 전체 클러스터 상태 업데이트 통계예요.
cluster_state_stats.overall.update_count Integer 성공한 클러스터 상태 업데이트의 총 수예요.
cluster_state_stats.overall.total_time_in_millis Integer 모든 클러스터 상태 업데이트에 걸린 총 시간(밀리초)이에요.
cluster_state_stats.overall.failed_count Integer 실패한 클러스터 상태 업데이트의 총 수예요.
cluster_state_stats.remote_upload Object 원격 업로드 관련 클러스터 상태 업데이트 통계예요.
cluster_state_stats.remote_upload.success_count Integer 원격 저장소에 성공적으로 업로드된 클러스터 상태 업데이트의 총 수예요.
cluster_state_stats.remote_upload.failed_count Integer 원격 저장소에 업로드하지 못한 클러스터 상태 업데이트의 총 수예요.
cluster_state_stats.remote_upload.total_time_in_millis Integer 원격 저장소에 업로드된 모든 클러스터 상태 업데이트에 걸린 총 시간(밀리초)이에요.
cluster_state_stats.remote_upload.cleanup_attempt_failed_count Integer 원격 저장소에서 오래된 클러스터 상태를 정리하는 동안 발생한 실패의 총 수예요.

ingest

ingest 객체는 ingest 통계를 담고 있으며 다음 속성을 가져요.

필드 필드 타입 설명
total Integer 노드 수명 전체의 ingest 통계예요.
total.count Integer 노드가 ingest한 문서의 총 수예요.
total.time_in_millis Integer ingest 문서를 전처리하는 총 시간(밀리초)이에요.
total.current Integer 노드가 현재 ingest 중인 문서의 총 수예요.
total.failed Integer 노드의 실패한 ingest 작업 총 수예요.
pipelines Object 노드의 ingest 파이프라인 통계예요. 각 파이프라인은 ID로 지정되는 중첩 객체이며 다음 속성을 가져요.
pipelines._id_.count Integer ingest 파이프라인이 전처리한 문서 수예요.
pipelines._id_.time_in_millis Integer ingest 파이프라인에서 문서를 전처리하는 총 시간(밀리초)이에요.
pipelines._id_.failed Integer ingest 파이프라인의 실패한 ingest 작업 총 수예요.
pipelines._id_.processors Array of objects ingest 프로세서 통계예요. 현재 변환 중인 문서 수, 변환된 총 문서 수, 실패한 변환 수, 문서 변환에 소요된 시간을 포함해요.

search_pipeline

search_pipeline 객체는 검색 파이프라인 관련 통계를 담고 있으며 다음 속성을 가져요.

필드 필드 타입 설명
total_request Object 모든 검색 요청 프로세서 관련 누적 통계예요.
total_request.count Integer 검색 요청 프로세서 실행의 총 수예요.
total_request.time_in_millis Integer 모든 검색 요청 프로세서 실행의 총 시간(밀리초)이에요.
total_request.current Integer 현재 진행 중인 검색 요청 프로세서 실행의 총 수예요.
total_request.failed Integer 실패한 검색 요청 프로세서 실행의 총 수예요.
total_response Object 모든 검색 응답 프로세서 관련 누적 통계예요.
total_response.count Integer 검색 응답 프로세서 실행의 총 수예요.
total_response.time_in_millis Integer 모든 검색 응답 프로세서 실행의 총 시간(밀리초)이에요.
total_response.current Integer 현재 진행 중인 검색 응답 프로세서 실행의 총 수예요.
total_response.failed Integer 실패한 검색 응답 프로세서 실행의 총 수예요.
pipelines Object 검색 파이프라인 통계예요. 각 파이프라인은 ID로 지정되는 중첩 객체이며 아래 행에 나열된 속성을 가져요. 프로세서에 tag가 있으면 그 프로세서의 통계는 <processor_type>:<tag>(예: filter_query:abc)라는 이름의 객체에 제공돼요. tag가 없는 같은 유형의 프로세서 통계는 모두 집계되어 <processor-type>(예: filter_query)이라는 이름의 객체에 제공돼요.
pipelines._id_.request.count Integer 검색 파이프라인이 수행한 검색 요청 프로세서 실행 수예요.
pipelines._id_.request.time_in_millis Integer 검색 파이프라인에서 검색 요청 프로세서 실행의 총 시간(밀리초)이에요.
pipelines._id_.request.current Integer 검색 파이프라인의 현재 진행 중인 검색 요청 프로세서 실행 수예요.
pipelines._id_.request.failed Integer 검색 파이프라인의 실패한 검색 요청 프로세서 실행 수예요.
pipelines._id_.request_processors Array of objects 검색 요청 프로세서 통계예요. 실행의 총 수, 실행의 총 시간, 현재 진행 중인 실행의 총 수, 실패한 실행 수를 포함해요.
pipelines._id_.response.count Integer 검색 파이프라인이 수행한 검색 응답 프로세서 실행 수예요.
pipelines._id_.response.time_in_millis Integer 검색 파이프라인에서 검색 응답 프로세서 실행의 총 시간(밀리초)이에요.
pipelines._id_.response.current Integer 검색 파이프라인의 현재 진행 중인 검색 응답 프로세서 실행 수예요.
pipelines._id_.response.failed Integer 검색 파이프라인의 실패한 검색 응답 프로세서 실행 수예요.
pipelines._id_.response_processors Array of objects 검색 응답 프로세서 통계예요. 실행의 총 수, 실행의 총 시간, 현재 진행 중인 실행의 총 수, 실패한 실행 수를 포함해요.

adaptive_selection

adaptive_selection 객체는 적응형 선택 통계를 담고 있어요. 각 항목은 노드 ID로 지정되며 다음 속성을 가져요.

필드 필드 타입 설명
outgoing_searches Integer 노드의 아웃고잉 검색 요청 수예요.
avg_queue_size Integer 노드의 검색 요청 평균 대기열 크기(지수 가중)예요.
avg_service_time_ns Integer 검색 요청의 평균 서비스 시간(나노초, 지수 가중)이에요.
avg_response_time_ns Integer 검색 요청의 평균 응답 시간(나노초, 지수 가중)이에요.
rank String 요청 라우팅 시 샤드를 선택하는 데 사용하는 노드의 순위예요.

indexing_pressure

indexing_pressure 객체는 색인 백프레셔 통계를 담고 있으며 다음 속성을 가져요.

필드 필드 타입 설명
memory Object 색인 부하의 메모리 소비 관련 통계예요.
memory.current Object 현재 색인 부하의 메모리 소비 관련 통계예요.
memory.current.combined_coordinating_and_primary_in_bytes Integer 조정(coordinating) 또는 기본(primary) 단계의 색인 요청이 사용한 총 메모리(바이트)예요. 기본 단계가 로컬에서 실행되면 조정 메모리를 재사용할 수 있으므로, 총 메모리가 조정과 기본 단계 메모리 사용의 합과 같지 않을 수 있어요.
memory.current.coordinating_in_bytes Integer 조정 단계의 색인 요청이 소비한 총 메모리(바이트)예요.
memory.current.primary_in_bytes Integer 기본 단계의 색인 요청이 소비한 총 메모리(바이트)예요.
memory.current.replica_in_bytes Integer 복제 단계의 색인 요청이 소비한 총 메모리(바이트)예요.
memory.current.all_in_bytes Integer 조정, 기본, 복제 단계의 색인 요청이 소비한 총 메모리예요.

shard_indexing_pressure

shard_indexing_pressure 객체는 샤드 색인 백프레셔 통계를 담고 있으며 다음 속성을 가져요.

필드 필드 타입 설명
stats Object 샤드 색인 백프레셔 통계예요.
total_rejections_breakup_shadow_mode Object shadow 모드로 실행 중이라면, total_rejections_breakup_shadow_mode 객체는 노드의 모든 샤드에 대한 요청 거부 기준 통계를 담고 있어요.
total_rejections_breakup_shadow_mode.node_limits Integer 노드 메모리 한도 때문에 거부된 총 수예요. 모든 샤드가 노드에 배정된 메모리 한도(예: 힙 크기의 10%)에 도달하면 그 샤드는 노드에서 더 많은 트래픽을 받을 수 없게 되어 색인 요청이 거부돼요.
total_rejections_breakup_shadow_mode.no_successful_request_limits Integer 노드 점유 수준이 소프트 한도를 넘고 샤드에 실행 대기 중인 요청이 여러 개일 때 거부된 총 수예요. 이 경우 시스템이 회복될 때까지 추가 색인 요청이 거부돼요.
total_rejections_breakup_shadow_mode.throughput_degradation_limits Integer 노드 점유 수준이 소프트 한도를 넘고 샤드 수준에서 요청 처리 시간이 계속 악화될 때 거부된 총 수예요. 이 경우 시스템이 회복될 때까지 추가 색인 요청이 거부돼요.
enabled Boolean 노드에 대해 샤드 색인 백프레셔 기능이 켜져 있는지 여부예요.
enforced Boolean true면 샤드 색인 백프레셔가 강제(enforced) 모드로 실행돼요(거부가 있음). false면 shadow 모드로 실행돼요(거부가 없지만 통계가 기록되고 total_rejections_breakup_shadow_mode 객체에서 조회할 수 있음). 샤드 색인 백프레셔가 활성화된 경우에만 적용돼요.

cluster_manager_throttling

cluster_manager_throttling 객체는 클러스터 매니저 노드의 조절된 작업 통계를 담고 있어요. 현재 클러스터 매니저로 선출된 노드에 대해서만 채워져요.

필드 필드 타입 설명
stats Object 클러스터 매니저 노드의 조절된 작업 통계예요.
stats.total_throttled_tasks Long 조절된 작업의 총 수예요.
stats.throttled_tasks_per_task_type Object 개별 작업 유형별 통계 분석이에요. 키-값 쌍으로 지정돼요. 키는 개별 작업 유형이고 값은 조절된 요청 수예요.

task_cancellation

2.9에서 도입

task_cancellation 객체는 취소로 표시된 뒤에도 계속 실행되는 작업 통계를 담고 있어요. 이는 작업 취소의 효과를 모니터링하고 취소 요청에 제대로 반응하지 않는 작업을 식별하는 데 도움을 줘요.

필드 필드 타입 설명
search_task Object 취소 후에도 계속 실행되는 부모 검색 작업 통계예요.
search_task.current_count_post_cancel Long 취소된 뒤에도 여전히 실행 중인 검색 작업 수예요.
search_task.total_count_post_cancel Long 노드가 마지막으로 재시작된 이후 취소 후에도 계속 실행된 검색 작업의 총 수예요.
search_shard_task Object 취소 후에도 계속 실행되는 검색 샤드 작업 통계예요.
search_shard_task.current_count_post_cancel Long 취소된 뒤에도 여전히 실행 중인 검색 샤드 작업 수예요.
search_shard_task.total_count_post_cancel Long 노드가 마지막으로 재시작된 이후 취소 후에도 계속 실행된 검색 샤드 작업의 총 수예요.

weighted_routing

weighted_routing 객체는 가중 라운드 로빈 요청 통계를 담고 있어요. 구체적으로, 이 노드가 "zoned out"된 동안 요청을 처리한 횟수 카운터를 담고 있어요.

필드 필드 타입 설명
stats Object 가중 라우팅 통계예요.
fail_open_count Integer 노드의 라우팅 가중치가 0으로 설정된 동안 이 노드의 샤드가 요청을 처리한 횟수예요.

resource_usage_stats

resource_usage_stats 객체는 리소스 사용 통계를 담고 있어요. 각 항목은 노드 ID로 지정되며 다음 속성을 가져요.

필드 필드 타입 설명
timestamp Integer 리소스 사용 통계의 마지막 새로고침 시간이에요. 에포크 이후 경과한 밀리초예요.
cpu_utilization_percent Float node.resource.tracker.global_cpu_usage.window_duration 설정에 설정된 시간 안의 OpenSearch 프로세스 평균 CPU 사용 통계예요.
memory_utilization_percent Float node.resource.tracker.global_jvmmp.window_duration 설정에 설정된 시간 안의 노드 JVM 메모리 사용 통계예요.
max_io_utilization_percent Float (Linux 전용) node.resource.tracker.global_io_usage.window_duration 설정에 설정된 시간 안의 OpenSearch 프로세스 평균 IO 사용 통계예요.

admission_control

admission_control 객체는 리소스 소비에 따른 검색·색인 요청의 거부 수를 담고 있으며 다음 속성을 가져요.

필드 필드 타입 설명
admission_control.global_cpu_usage.transport.rejection_count.search Integer 노드 CPU 사용 한도에 도달했을 때 transport 계층에서 거부된 검색 요청의 총 수예요. 이 경우 시스템이 회복될 때까지 추가 검색 요청이 거부돼요. CPU 사용 한도는 admission_control.search.cpu_usage.limit 설정에 설정돼요.
admission_control.global_cpu_usage.transport.rejection_count.indexing Integer 노드 CPU 사용 한도에 도달했을 때 transport 계층에서 거부된 색인 요청의 총 수예요. 시스템이 회복될 때까지 추가 색인 요청이 거부돼요. CPU 사용 한도는 admission_control.indexing.cpu_usage.limit 설정에 설정돼요.
admission_control.global_io_usage.transport.rejection_count.search Integer 노드 IO 사용 한도에 도달했을 때 transport 계층에서 거부된 검색 요청의 총 수예요. 시스템이 회복될 때까지 추가 검색 요청이 거부돼요. IO 사용 한도는 admission_control.search.io_usage.limit 설정에 설정돼요(Linux 전용).
admission_control.global_io_usage.transport.rejection_count.indexing Integer 노드 IO 사용 한도에 도달했을 때 transport 계층에서 거부된 색인 요청의 총 수예요. 시스템이 회복될 때까지 추가 색인 요청이 거부돼요. IO 사용 한도는 admission_control.indexing.io_usage.limit 설정에 설정돼요(Linux 전용).

caches

이 API는 실험적인 계층형 캐싱 기능을 지원하므로, 이 섹션의 응답은 바뀔 수 있어요. 계층형 캐싱 기능 플래그가 활성화되지 않으면 API는 모든 값에 0을 반환해요.

caches 객체는 캐시 통계(예: request_cache 통계)를 담고 있어요. 각 하위 메트릭의 total 값은 level 쿼리 매개변수의 값과 관계없이 항상 반환돼요.

필드 필드 타입 설명
request_cache Object 요청 캐시 통계예요.
request_cache.size_in_bytes Integer 요청 캐시의 총 크기(바이트)예요.
request_cache.evictions Integer 요청 캐시에서 제거된 총 수예요.
request_cache.hit_count Integer 요청 캐시의 총 hit 수예요.
request_cache.miss_count Integer 요청 캐시의 총 miss 수예요.
request_cache.item_count Integer 요청 캐시의 총 항목 수예요.
request_cache.store_name String 요청 캐시가 사용하는 저장소 유형의 이름이에요. 자세한 내용은 tiered cache를 참고해요.

level 쿼리 매개변수를 유효한 값(indices, shard, tier) 중 하나로 설정하면 caches.request_cache에 이 수준들로 값을 분류하는 추가 필드가 나타나요. 예를 들어 level=indices,tier이고 계층형 캐시를 사용 중이며 노드에 index0과 index1이라는 인덱스가 있다면, caches 객체는 다음 표처럼 각 수준 값의 조합마다 동일한 다섯 가지 메트릭을 담게 돼요.

필드 필드 타입 설명
request_cache.indices.index0.tier.on_heap Object on-heap 계층에서 index0의 다섯 가지 메트릭을 담고 있어요.
request_cache.indices.index0.tier.disk Object disk 계층에서 index0의 다섯 가지 메트릭을 담고 있어요.
request_cache.indices.index1.tier.on_heap Object on-heap 계층에서 index1의 다섯 가지 메트릭을 담고 있어요.
request_cache.indices.index1.tier.disk Object disk 계층에서 index1의 다섯 가지 메트릭을 담고 있어요.

필요한 권한 (Required permissions)

Security 플러그인을 사용한다면 적절한 권한이 있는지 확인해야 해요: cluster:monitor/nodes/stats.

더 알아보기