클러스터 생성 및 관리

클러스터란 여러 노드(Data Node, Cluster Manager Node)로 구성되어 대규모 데이터의 색인, 검색, 분석을 수행하는 OpenSearch 실행 단위입니다. 클러스터는 고성능 검색 처리, 데이터 내구성, 확장성, 보안 구성을 포함하는 통합 검색·분석 환경을 제공하며, 다양한 애플리케이션과 시스템에서 발생하는 데이터를 안정적으로 탐색할 수 있도록 지원합니다.
Advanced Managed Search 서비스에서 OpenSearch 클러스터를 생성하고 관리하는 방법은 다음과 같습니다.

클러스터 생성

신규 클러스터를 생성합니다. 환경에 따라 클러스터 생성 시 약 10분 정도 소요될 수 있습니다.

안내

클러스터 생성 후 볼륨을 확장하더라도 최대 IOPS는 최초 지정된 값으로 고정됩니다.
안정적인 성능을 위해 적절한 볼륨 크기를 설정해 주세요.

카카오클라우드 콘솔 > Analytics > Advanced Managed Search 메뉴로 이동합니다.
[시작하기] 버튼을 클릭하여, Advanced Managed Search 리소스에 접근하기 위한 서비스 에이전트를 생성합니다.
클러스터 메뉴에서 [클러스터 생성] 버튼을 클릭합니다.

클러스터 생성에 필요한 정보를 입력하고 [생성] 버튼을 클릭합니다.

항목	구분	설명
기본 설정	클러스터 이름	생성할 클러스터의 이름 - 같은 프로젝트 내에서 중복된 클러스터 이름 사용 불가 - 예시: my-cluster-01
	OpenSearch 버전	OpenSearch 버전 선택 - 지원 중인 OpenSearch 버전
네트워크 설정	VPC	클러스터가 구성될 네트워크 선택 - 클러스터의 고가용성 유지를 위해 2개 이상의 가용 영역을 가진 VPC 사용 권장 - 생성된 사용자 VPC 중 선택 또는 신규 생성 후 선택
	서브넷	데이터 노드가 할당될 서브넷 선택 - 생성된 사용자 서브넷 중 선택 또는 신규 생성 후 선택
	보안 그룹	클러스터에 적용할 보안 그룹 설정 - 생성된 사용자 보안 그룹 중 선택 또는 신규 생성 후 선택 - 자세한 설명은 보안 그룹 참고
데이터 노드 설정	지정된 가용 영역 수	네트워크 설정에서 선택한 서브넷의 가용 영역 수 및 가용 영역 확인
	인스턴스 유형	인스턴스 유형 선택 - 선택한 인스턴스의 사양으로 클러스터 내 각 데이터 노드 실행 - 클러스터 생성 후 인스턴스 유형 변경 불가
	가용 영역당 데이터 노드 수	지정된 가용 영역마다 분산 배치할 데이터 노드 수 입력 - 데이터 노드 쿼터(Quota): 프로젝트 내 최대 9개 - 데이터 노드 쿼터 대한 자세한 설명은 쿼터 참고 * 가용 영역 수 2개, 데이터 노드 수 3개로 지정한 경우 가용 영역 2곳에 데이터 노드 3개씩 배치 `총 데이터 노드 수: 6개`
	데이터 노드 당 볼륨 타입 / 크기	각 데이터 노드에 할당할 볼륨 타입 및 크기 지정 - 볼륨 타입: 현재 SSD 유형만 제공 - 볼륨 크기: 최소 50GB부터 1,600GB까지 입력 가능 * 데이터 노드 수 3개, 볼륨 크기 50GB로 지정한 경우 각 데이터 노드에 50GB씩 할당 `총 볼륨 크기: 150GB`
	최대 IOPS	볼륨 크기에 따라 지정되는 최대 IOPS 확인
클러스터 매니저 노드 설정	인스턴스 유형	인스턴스 유형 선택 - 선택한 인스턴스의 사양으로 클러스터 매니저 노드 실행 - 클러스터 생성 후 인스턴스 유형 변경 불가
	클러스터 매니저 노드 수	클러스터 매니저 노드 수 확인 - 안정적인 운영을 위해 노드는 항상 3개로 유지됩니다.
마스터 사용자 설정	마스터 사용자 이름	마스터 사용자 이름 확인 - 사용상 편의를 위해 마스터 사용자 이름은 `admin`으로 고정
마스터 사용자 설정	마스터 비밀번호	마스터 비밀번호 설정 - 영문 대문자를 반드시 포함해야 하며, 영문, 숫자, 특수 문자만 입력 가능 (8-16자)
마스터 사용자 설정	마스터 비밀번호 확인	마스터 비밀번호로 설정한 값 재입력

클러스터 관리

클러스터 목록 조회

프로젝트 내에 생성한 클러스터 목록을 조회할 수 있습니다.

카카오클라우드 콘솔 > Analytics > Advanced Managed Search 메뉴로 이동합니다.

클러스터 메뉴에서 현재 생성된 클러스터 목록을 확인합니다.

항목	설명	비고
이름	클러스터 생성 시 사용자가 지정한 이름	클러스터 이름을 클릭해 클러스터의 상세 정보 확인 가능
ID	클러스터의 리소스 ID
상태	현재 클러스터의 상태	상세 상태값 정보는 클러스터 수명주기 및 상태 참고
버전	사용 중인 OpenSearch 버전
가용 영역 수	클러스터 생성 시 사용자가 구성한 네트워크 설정에 따른 가용 영역 수
데이터 노드 수	클러스터 생성 시 사용자가 생성한 데이터 노드 수	총 데이터 노드 수: `가용 영역 수 * 데이터 노드 수`
생성일시	클러스터 생성 일시
생성자	클러스터 생성을 요청한 사용자

클러스터 정보 조회

프로젝트 내 생성한 클러스터 정보를 확인할 수 있습니다.

카카오클라우드 콘솔 > Analytics > Advanced Managed Search 메뉴로 이동합니다.
클러스터 메뉴에서 상세 정보를 확인할 클러스터 이름을 클릭합니다.

탭에서 상세 정보를 확인합니다.

상단 정보

항목	설명	비고
상태	현재 클러스터의 상태	상세 상태값 정보는 클러스터 수명주기 및 상태 참고
OpenSearch 버전	사용 중인 OpenSearch 버전
엔드포인트	OpenSearch 클러스터에 API 방식으로 접근하기 위한 접속 주소	엔드포인트 접근 시에는 클러스터 생성 시 설정한 마스터 사용자 계정 또는 권한이 부여된 사용자 계정을 통해 인증 필요
OpenSearch 대시보드	OpenSeach 대시보드에 접속하기 위한 주소	클러스터 생성 시 설정한 마스터 사용자 계정으로 로그인 필요 - OpenSearch Dashboard 외부 접근 (nignx) 참고

세부 정보 탭

항목	정보	설명
클러스터	클러스터 이름	클러스터 생성 시 사용자가 지정한 이름
	클러스터 ID	클러스터의 리소스 ID
	마스터 사용자 ID	클러스터 생성 시 입력된 마스터 사용자 ID
	VPC	클러스터 생성 시 사용자가 선택한 사용자 VPC
	생성자	클러스터 생성을 요청한 사용자
	서브넷	클러스터 생성 시 사용자가 선택한 사용자 서브넷
	생성일시	클러스터 생성 일시
	보안 그룹	클러스터 생성 시 사용자가 설정한 보안 그룹 목록
데이터 노드	가용 영역 수	클러스터 생성 시 사용자가 구성한 네트워크 설정에 따른 가용 영역 수
	가용 영역당 데이터 노드 수	가용 영역당 배치된 데이터 노드 수와 총 노드 수 - 총 노드 수: `가용 영역 수 * 노드 수`
	인스턴스 유형	클러스터 생성 시 사용자가 선택한 데이터 노드의 인스턴스 사양
	총 볼륨 크기(노드당 볼륨 크기)	총 볼륨 크기와 노드당 할당된 볼륨 크기
클러스터 매니저 노드	인스턴스 유형	클러스터 생성 시 사용자가 선택한 클러스터 매니저 노드의 인스턴스 사양
	클러스터 매니저 노드 수	매니저 노드 수 및 배치된 가용 영역 확인
로그	수집 로그	수집 중인 로그 종류 확인
	로그 조회	Monitoring 서비스의 로그 탐색기로 이동하여 로그 조회 가능

인스턴스 탭

항목	정보	설명
데이터 노드	이름	데이터 노드 생성 시 카카오클라우드에서 생성하는 이름 - 모니터링 탭에서 차트 조회 시 범례에서 데이터 노드 이름 확인 가능
	ID	데이터 노드의 리소스 ID
	상태	현재 데이터 노드의 상태 - 상세 상태값 정보는 데이터 노드 수명주기 및 상태 참고
	인스턴스 유형	클러스터 생성 시 사용자가 선택한 데이터 노드의 인스턴스 사양
	가용 영역	데이터 노드가 배치된 가용 영역
	볼륨 크기	데이터 노드에 할당된 볼륨 크기
클러스터 매니저 노드	이름	클러스터 매니저 노드 생성 시 카카오클라우드에서 생성하는 이름 - 모니터링 탭에서 차트 조회 시 범례에서 클러스터 매니저 노드 이름 확인 가능
	ID	클러스터 매니저 노드의 리소스 ID
	상태	현재 클러스터 매니저 노드의 상태 - 상세 상태값 정보는 클러스터 매니저 노드 수명주기 및 상태 참고
	인스턴스 유형	클러스터 생성 시 사용자가 선택한 클러스터 매니저 노드의 인스턴스 사양
	가용 영역	클러스터 매니저 노드가 배치된 가용 영역

모니터링 탭

구분	설명
데이터 기간	모니터링 그래프에 표시할 데이터 기간 - 1시간 전(기본값) / 3시간 전 / 12시간 전 / 1일 전 / 7일 전
조회 항목	모니터링 조회 항목 선택 - Cluster / Data Node / Cluster Manager Node - 전체 선택(기본값) - 항목 복수 선택 가능
보기 모드	모니터링 그래프 보기 모드 설정 - 1단 보기, 2단 보기 제공
자동 새로고침 주기	자동 새로고침 주기 설정 - 자동 새로고침 안 함(기본값) / 10초 / 30초 / 1분 / 5분
수동 새로고침	새로고침 버튼 클릭 시 모니터링 결과 새로고침

모니터링 데이터

항목	모니터링 데이터	설명
Cluster	Number of Shards by State	클러스터 내 샤드의 상태별 개수
Cluster	Active Shards Percentage	전체 샤드 중 정상적으로 활성화된 샤드의 비율
Cluster	Indexed Documents (5m Interval)	최근 5분 동안 성공적으로 인덱싱된 문서 수
Cluster	Failed Indexed Documents (5m Interval)	최근 5분 동안 인덱싱에 실패한 문서 수
Cluster	Search Queries latency	검색 쿼리의 평균 응답 지연 시간
Cluster	Search Queries per Second	초당 처리된 검색 쿼리 수
Cluster	Total Active Documents	클러스터에 저장되어 현재 검색 가능한 전체 문서 수
Cluster	Thread Pool Queue Size	OpenSearch 스레드 풀에 대기 중인 작업 수
Cluster	Thread Pool Rejected Request Count (5m Interval)	최근 5분 동안 스레드 풀 용량 초과로 인해 거부된 요청 수
Cluster	Circuit Breaker Trip Count per Second	메모리 보호를 위해 서킷 브레이커가 동작한 초당 횟수
Data Node	OpenSearch Process CPU Usage (%)	데이터 노드에서 OpenSearch 프로세스가 사용하는 CPU 사용률
Data Node	System Memory Usage (%)	데이터 노드의 전체 시스템 메모리 사용률
Data Node	System Memory Usage (Bytes)	데이터 노드가 사용하는 전체 시스템 메모리 사용량
Data Node	Heap Usage (%)	데이터 노드 JVM 힙 메모리의 사용 비율
Data Node	Heap Usage (Bytes)	데이터 노드 JVM 힙 메모리의 실제 사용량
Data Node	Young GC Count (1m Interval)	최근 1분 동안 데이터 노드에서 발생한 Young GC 횟수
Data Node	Old GC Count (1m Interval)	최근 1분 동안 데이터 노드에서 발생한 Old GC 횟수
Data Node	Disk Usage Watermark (%)	클러스터에 설정된 Disk Watermark 임계값과 데이터 노드의 현재 디스크 사용률을 퍼센트 기준으로 표시
Data Node	Disk Usage Watermark (Bytes)	클러스터에 설정된 Disk Watermark 임계값과 데이터 노드의 현재 디스크 사용량을 바이트 기준으로 표시
Cluster Manager Node	OpenSearch Process CPU Usage (%)	클러스터 매니저 노드에서 OpenSearch 프로세스의 CPU 사용률
Cluster Manager Node	System Memory Usage (%)	클러스터 매니저 노드의 시스템 메모리 사용률
Cluster Manager Node	System Memory Usage (Bytes)	클러스터 매니저 노드가 사용하는 전체 시스템 메모리 사용량
Cluster Manager Node	Heap Usage (%)	클러스터 매니저 노드 JVM 힙 메모리의 사용 비율
Cluster Manager Node	Heap Usage (Bytes)	클러스터 매니저 노드 JVM 힙 메모리의 실제 사용량
Cluster Manager Node	Young GC Count (1m Interval)	최근 1분 동안 클러스터 매니저 노드에서 발생한 Young GC 횟수
Cluster Manager Node	Old GC Count (1m Interval)	최근 1분 동안 클러스터 매니저 노드에서 발생한 Old GC 횟수

볼륨 확장

데이터 증가로 인해 저장 공간이 부족한 경우, 데이터 노드에 할당된 볼륨 크기를 확장하여 클러스터의 안정적인 운영을 유지할 수 있습니다.
볼륨 확장은 클러스터 중단이나 노드 재시작 없이 수행되며, 기존 데이터와 검색 서비스에 영향을 주지 않고 저장 공간을 동적으로 늘릴 수 있습니다.

안내

볼륨 확장은 저장 용량 증가를 의미하며, 인스턴스 사양에 따른 CPU 및 메모리 리소스는 변경되지 않습니다. 검색 성능 향상이 필요한 경우 데이터 노드 확장을 함께 고려하시기 바랍니다.

카카오클라우드 콘솔 > Analytics > Advanced Managed Search 메뉴로 이동합니다.
클러스터 메뉴에서 확장할 클러스터를 선택합니다.
우측 상단에 위치한 [볼륨 확장] 버튼을 클릭합니다.

볼륨 확장 설정에서 볼륨을 확장하고 [저장] 버튼을 클릭합니다.

항목	설명
클러스터 이름	선택한 클러스터의 이름 확인
데이터 노드 수	선택한 클러스터 내 총 데이터 노드 수 확인
현재 총 볼륨 크기	현재 총 볼륨 크기 및 데이터 노드당 볼륨 크기 확인
데이터 노드 볼륨 크기	데이터 노드당 확장할 볼륨 크기 지정

클러스터 확장

검색 트래픽 증가 또는 색인 데이터 확장에 대응하기 위해 클러스터 확장을 통해 데이터 노드 수를 늘릴 수 있습니다.
클러스터 확장 시 OpenSearch의 샤드 재배치가 자동으로 수행되며, 이 과정에서 일시적인 성능 변동이 발생할 수 있습니다.
확장을 통해 검색 처리량과 색인 성능을 향상시킬 수 있으며, 대규모 데이터 워크로드 환경에서도 안정적인 서비스 운영이 가능합니다.

카카오클라우드 콘솔 > Analytics > Advanced Managed Search 메뉴로 이동합니다.
클러스터 메뉴에서 확장할 클러스터를 선택합니다.
우측 상단에 위치한 [클러스터 확장] 버튼을 클릭합니다.

클러스터 확장 설정에서 데이터 노드 수를 확장하고 [저장] 버튼을 클릭합니다.

항목	설명
클러스터 이름	선택한 클러스터의 이름 확인
가용 영역 수	선택한 클러스터의 가용 영역 수 확인
가용 영역	선택한 클러스터의 가용 영역 확인
현재 총 데이터 노드 수	현재 총 데이터 노드 수 및 가용 영역당 데이터 노드 수 확인
데이터 노드 수	가용 영역당 확장할 데이터 노드 수 지정

클러스터 삭제

더 이상 사용하지 않는 클러스터를 삭제할 수 있습니다.

주의

삭제한 클러스터 내 노드와 할당된 볼륨이 완전히 반납되어 복구할 수 없으니 주의하시기 바랍니다.

카카오클라우드 콘솔 > Analytics > Advanced Managed Search 메뉴로 이동합니다.
클러스터 메뉴에서 삭제할 클러스터를 선택합니다.
클러스터 삭제 팝업창에서 삭제할 클러스터의 이름을 입력하고 [삭제] 버튼을 클릭합니다.