CAT 노드 API

CAT 노드 API (CAT Nodes API)

1.0 버전에서 도입되었어요. CAT nodes 작업은 노드 역할과 로드 메트릭을 포함한 노드 수준 정보를 나열해요. 중요한 노드 메트릭 몇 가지는 pid, name, cluster_manager, ip, port, version, build, jdk와 함께 disk, heap, ram, file_desc가 있어요.

출처: 문서

본문

엔드포인트 (Endpoints)

GET /_cat/nodes

쿼리 파라미터 (Query parameters)

아래 표는 사용 가능한 쿼리 파라미터를 정리한 거예요. 모든 쿼리 파라미터는 선택 사항이에요.

파라미터 데이터 타입 설명 기본값
bytes String 바이트 값을 표시하는 데 사용하는 단위. 유효한 값은 b, kb, k, mb, m, gb, g, tb, t, pb, p예요. N/A
cluster_manager_timeout String 클러스터 매니저 노드에 연결하는 데 허용되는 시간. N/A
format String json 또는 yaml 같은 Accept 헤더의 짧은 버전. N/A
full_id Boolean 또는 String true면 전체 노드 ID를, false면 축약된 노드 ID를 반환해요. false
h List 표시할 열 이름의 쉼표로 구분된 목록. N/A
help Boolean 도움말 정보를 반환해요. false
s List 정렬 기준이 될 열 이름 또는 열 별칭의 쉼표로 구분된 목록. N/A
time String 시간 단위를 지정해요. 예: 5d 또는 7h. 자세한 내용은 Supported units 문서를 참고하세요. 유효한 값은 nanos, micros, ms, s, m, h, d예요. N/A
v Boolean 열 머리글을 표시하는 자세한(verbose) 모드를 활성화해요. false

예제 요청 (Example request)

다음 예제 요청은 노드 수준 정보를 나열해요:

GET /_cat/nodes?v

예제 응답 (Example response)

ip       |   heap.percent | ram.percent | cpu load_1m | load_5m | load_15m | node.role | node.roles |     cluster_manager |  name
10.11.1.225  |         31   |    32  | 0  |  0.00  |  0.00   | di  | data,ingest,ml  | - |  data-e5b89ad7

필요한 권한 (Required permissions)

Security 플러그인을 사용한다면 적절한 권한이 있는지 확인하세요: cluster:monitor/nodes/info와 cluster:monitor/nodes/stats

더 알아보기 (Learn more)