본문으로 건너뛰기

클러스터 생성 및 관리

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

Advanced Managed Search 서비스에서 OpenSearch 클러스터를 생성하고 관리하는 방법은 다음과 같습니다.

클러스터 생성

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

안내
  • 클러스터 생성 후 볼륨을 확장하더라도 최대 IOPS는 최초 지정된 값으로 고정됩니다.
  • 안정적인 성능을 위해 적절한 볼륨 크기를 설정해 주세요.
  1. 카카오클라우드 콘솔 > Analytics > Advanced Managed Search 메뉴로 이동합니다.

  2. 클러스터 메뉴에서 [클러스터 생성] 버튼을 클릭합니다.

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

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

클러스터 관리

클러스터 목록 조회

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

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

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

    항목설명비고
    이름클러스터 생성 시 사용자가 지정한 이름클러스터 이름을 클릭해 클러스터의 상세 정보 확인 가능
    ID클러스터의 리소스 ID
    상태현재 클러스터의 상태상세 정보는 클러스터 수명주기 및 상태 참고
    - 롤백이 완료된 클러스터는 Running 옆에 경고 아이콘이 표시되며, 아이콘에 마우스를 올리면 안내 문구 확인 가능
    세부 상태현재 클러스터의 세부 상태상세 설명은 클러스터 상태 및 세부 상태 참고
    버전사용 중인 OpenSearch 버전
    가용 영역 수클러스터 생성 시 사용자가 구성한 네트워크 설정에 따른 가용 영역 수
    데이터 노드 수클러스터 생성 시 사용자가 생성한 데이터 노드 수총 데이터 노드 수: 가용 영역 수 * 데이터 노드 수
    엔드포인트OpenSearch 클러스터에 API 방식으로 접근하기 위한 접속 주소
    생성 일시클러스터 생성 일시

클러스터 상태 및 세부 상태

클러스터 확장 또는 인스턴스 유형 변경을 수행하면, 처리 단계에 따라 상태와는 별도로 세부 상태가 함께 표시되어 현재 어떤 작업이 진행 중인지 더 자세히 확인할 수 있습니다.

인스턴스 유형 변경(Scaling Up) 성공 시
상태세부 상태설명
RunningIdle클러스터 정상 동작 중
Scaling UpProvisioning New Nodes신규 노드를 프로비저닝하는 중
Scaling UpRelocating Nodes기존 노드를 allocation에서 제외한 뒤, 기존 노드의 샤드를 새 노드로 드레이닝하는 중
Scaling UpSwitching Traffic트래픽을 신규 노드로 전환하고 대시보드 호스트도 함께 동기화
Scaling UpDeleting Old Node기존 노드 삭제
Scaling UpDone인스턴스 유형 변경이 완료되면 클러스터는 다시 Running 상태가 되고, 세부 상태는 Idle이 됨
클러스터 확장(Scaling Out) 성공 시
상태세부 상태설명
RunningIdle클러스터 정상 동작 중
Scaling OutProvisioning New Nodes신규 데이터 노드를 프로비저닝 중
Scaling OutAdd Node Traffic클러스터 Health Check 및 전체 데이터 노드 기준으로 설정 업데이트
Scaling OutDone클러스터 확장이 성공하면 클러스터는 다시 Running 상태가 되고, 세부 상태는 Idle이 됨
Scaling Up/Out 진행 중 오류로 인한 Rollbacking

클러스터 확장 또는 인스턴스 유형 변경(Scaling Up/Scaling Out) 중 OpenSearch 클러스터에서 Provisioning Error가 발생하면 클러스터는 즉시 Rollbacking 상태로 전환됩니다. 이후 세부 상태가 순차적으로 변경됩니다.

상태세부 상태설명
RunningIdle클러스터가 Running 상태일 때의 세부 상태(Scaling Up/Scaling Out 진입점)
Scaling Up/Scaling OutProvisioning New Nodes인스턴스 유형 변경 또는 클러스터 확장 진행 중
RollbackingReverting Desired Spec요청한 사양을 변경 전 사양으로 되돌리는 중
RollbackingExcluding Surplus Nodes롤백으로 불필요해진 신규 노드를 allocation에서 제외하는 중
RollbackingDeleting Surplus Nodes신규 노드 삭제 중
RollbackingReverting Traffic기존 노드 기준으로 설정과 트래픽을 복구하는 중
RollbackingVerifying Cluster기존 데이터 노드가 모두 Running 상태이며 전체 노드가 정상인지 최종 확인 중
RollbackingDone롤백이 완료되어 클러스터 상태는 Running, 세부 상태는 Idle로 전환됨
안내

롤백이 완료되어 다시 Running/Idle 상태가 되면 클러스터 상태 항목의 Running 옆에 경고 아이콘이 표시됩니다. 아이콘에 마우스를 올리면 다음 안내 문구를 확인할 수 있습니다.

클러스터 확장 또는 인스턴스 유형 변경에 실패했습니다. 요청 전 상태로 되돌린 후 정상 동작 중입니다.

실패한 작업의 상세 내용은 클러스터 상세 페이지의 세부 정보 탭 > 최근 작업 이력에서 확인할 수 있습니다.

주의

클러스터가 Rollbacking 상태인 동안에는 볼륨 확장, 클러스터 확장, 인스턴스 유형 변경, 클러스터 삭제를 요청할 수 없습니다. 롤백이 완료된 후 실패 사유를 확인하고 다시 요청해 주세요.

클러스터 정보 조회

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

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

  2. 클러스터 메뉴에서 상세 정보를 확인할 클러스터 이름을 클릭합니다.

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

클러스터 정보
항목설명
이름클러스터 생성 시 사용자가 지정한 이름
ID클러스터의 리소스 ID
상태현재 클러스터의 상태
- 상세 정보는 클러스터 수명주기 및 상태 참고
- 작업 중 오류로 요청 전 구성으로 복구된 경우에만 Running 옆에 경고 아이콘과 안내 문구 표시
세부 상태현재 클러스터의 세부 상태
- 상세 정보는 클러스터 상태 및 세부 상태 참고
버전사용 중인 OpenSearch 버전
엔드포인트OpenSearch 클러스터에 API 방식으로 접근하기 위한 접속 주소
- 엔드포인트 접근 시에는 클러스터 생성 시 설정한 마스터 사용자 계정 또는 권한이 부여된 사용자 계정을 통해 인증 필요
마스터 사용자 이름클러스터 생성 시 입력된 마스터 사용자 이름
생성자클러스터 생성을 요청한 사용자
VPC클러스터 생성 시 사용자가 선택한 사용자 VPC
서브넷클러스터 생성 시 사용자가 선택한 사용자 서브넷
생성 일시클러스터 생성 일시
최근 작업 이력작업, 실패 단계, 실패 사유, 롤백 완료 일시, 변경 전 구성, 요청한 구성
- 클러스터 확장 또는 인스턴스 유형 변경이 실패하여 롤백된 경우 표시
- 자세한 설명은 최근 작업 이력 참고
데이터 노드
항목설명
인스턴스 유형클러스터 생성 시 사용자가 선택한 데이터 노드의 인스턴스 사양
가용 영역 수클러스터 생성 시 사용자가 구성한 네트워크 설정에 따른 가용 영역 수
가용 영역당 데이터 노드 수가용 영역당 배치된 데이터 노드 수와 총 데이터 노드 수
- 총 데이터 노드 수: 가용 영역 수 * 데이터 노드 수
데이터 노드당 볼륨 크기데이터 노드당 할당된 볼륨 크기와 총 볼륨 크기
클러스터 매니저
항목설명
인스턴스 유형클러스터 생성 시 사용자가 선택한 클러스터 매니저 노드의 인스턴스 사양
가용 영역당 클러스터 매니저 노드 수매니저 노드 수 및 배치된 가용 영역 확인
로그
항목설명
수집 로그수집 중인 로그 종류 확인
로그 조회Monitoring 서비스의 로그 탐색기로 이동하여 로그 조회 가능

최근 작업 이력

세부 정보 탭의 최근 작업 이력 아코디언에서는 클러스터 확장 또는 인스턴스 유형 변경에 실패하여 롤백된 가장 최근 작업의 내용을 확인할 수 있습니다.
이력이 없는 경우 아코디언은 접힌 상태로 표시되며 내용이 없습니다.

롤백 완료 안내 문구
작업안내 문구
클러스터 확장클러스터 확장에 실패하여 변경 전 구성으로 복구되었습니다. 현재 클러스터는 정상적으로 실행 중입니다.
인스턴스 유형 변경인스턴스 유형 변경에 실패하여 변경 전 구성으로 복구되었습니다. 현재 클러스터는 정상적으로 실행 중입니다.
작업 이력 항목
항목설명
작업실패한 작업의 종류
- 클러스터 확장 / 인스턴스 유형 변경
실패 단계오류가 발생한 세부 상태 단계
- 예시: ProvisioningNewNodes
실패 사유오류의 원인 메시지
- 예시: OpenSearchNode is in ProvisioningErr
롤백 완료 일시요청 전 구성으로 복구가 완료된 일시
변경 전 구성롤백으로 복구되어 현재 적용 중인 구성
- 현재 적용 중 배지 표시
요청한 구성사용자가 요청했으나 적용에 실패한 구성
- 적용 실패 배지 표시
안내

실패 사유가 OpenSearchNode is in ProvisioningErr인 경우, 클러스터 ID, 실패 단계, 실패 사유를 첨부하여 헬프데스크로 문의해 주시기 바랍니다.

볼륨 확장

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

안내

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

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

  2. 클러스터 메뉴에서 확장할 클러스터를 선택합니다.

  3. [볼륨 확장] 버튼을 클릭합니다.

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

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

클러스터 확장

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

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

  2. 클러스터 메뉴에서 확장할 클러스터를 선택합니다.

  3. [클러스터 확장] 버튼을 클릭합니다.

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

    항목설명
    클러스터선택한 클러스터의 이름 확인
    가용 영역 수선택한 클러스터의 가용 영역 수와 가용 영역 확인
    현재 가용 영역당 데이터 노드 수현재 가용 영역당 데이터 노드 수 및 총 데이터 노드 수 확인
    데이터 노드 수가용 영역당 확장할 데이터 노드 수 지정
    - 데이터 노드 쿼터(Quota): 프로젝트 내 최대 9개
안내
  • 확장이 진행되는 동안 클러스터 상태는 Scaling Out으로 표시되며, 세부 상태를 통해 진행 단계를 확인할 수 있습니다. 자세한 설명은 클러스터 상태 및 세부 상태를 참고하시기 바랍니다.
  • 새 데이터 노드 구성에 실패하면 클러스터는 Rollbacking 상태로 전환되어 확장 전 구성으로 자동 복구됩니다. 복구가 완료되면 Running 옆에 경고 아이콘이 표시되며, 실패한 작업의 내용은 세부 정보 탭의 최근 작업 이력에서 확인할 수 있습니다.

인스턴스 유형 변경

데이터 노드의 검색 처리 성능을 향상시켜야 하는 경우, 인스턴스 유형 변경을 통해 데이터 노드의 사양을 상향할 수 있습니다.
인스턴스 유형 변경은 클러스터 중단 없이 수행되며, 변경 시 클러스터 가용성은 유지되나 일시적으로 성능에 영향을 미칠 수 있습니다.

안내
  • 인스턴스 유형은 현재 유형보다 높은 사양으로만 변경할 수 있으며, 더 낮은 사양으로는 변경할 수 없습니다.
  • 현재 인스턴스 유형이 지원 중인 최고 사양(c2a.8xlarge)인 경우, 변경할 인스턴스 유형을 선택할 수 없습니다.
  1. 카카오클라우드 콘솔 > Analytics > Advanced Managed Search 메뉴로 이동합니다.

  2. 클러스터 메뉴에서 인스턴스 유형을 변경할 클러스터를 선택합니다.

  3. [인스턴스 유형 변경] 버튼을 클릭합니다.

  4. 인스턴스 유형 변경에서 변경할 인스턴스 유형을 선택하고 [저장] 버튼을 클릭합니다.

    항목설명
    클러스터선택한 클러스터의 이름 확인
    데이터 노드 수선택한 클러스터의 총 데이터 노드 수 확인
    인스턴스 유형데이터 노드에 현재 적용된 인스턴스 유형 확인
    유형 변경변경할 인스턴스 유형 선택
    - 현재 인스턴스 유형보다 높은 사양의 인스턴스 유형만 선택 가능
    - 현재 인스턴스 유형이 최고 사양(c2a.8xlarge)인 경우 선택 영역이 비활성화되며 안내 문구가 표시됨

    제공 인스턴스 유형 및 변경 정책

    현재 인스턴스 유형변경 가능한 인스턴스 유형
    c2a.2xlargec2a.4xlarge, c2a.8xlarge
    c2a.4xlargec2a.8xlarge
    c2a.8xlarge변경 불가 (지원 중인 최고 사양)
안내
  • 변경이 진행되는 동안 클러스터 상태는 Scaling Up으로 표시되며, 세부 상태를 통해 진행 단계를 확인할 수 있습니다. 자세한 설명은 클러스터 상태 및 세부 상태를 참고하시기 바랍니다.
  • 인스턴스 유형 변경이 완료된 직후에는 데이터 노드가 새 노드로 교체되면서 OpenSearch Dashboards의 헬스체크가 일시적으로 끊겨, 클러스터 상태가 잠시 Error로 표시될 수 있습니다. 이 경우 별도의 조치 없이 Running 상태로 돌아오며, Error 상태가 계속 유지되면 클러스터 ID와 함께 헬프데스크로 문의해 주시기 바랍니다.
  • 새 사양의 데이터 노드 구성에 실패하면 클러스터는 Rollbacking 상태로 전환되어 변경 전 인스턴스 유형으로 자동 복구됩니다. 복구가 완료되면 Running 옆에 경고 아이콘이 표시되며, 실패한 작업의 내용은 세부 정보 탭의 최근 작업 이력에서 확인할 수 있습니다.
  • Relocating Nodes 단계에서는 기존 노드의 샤드를 새 노드로 이동하므로, 데이터 양에 따라 시간이 오래 걸릴 수 있습니다. 진행이 멈춘 것으로 보이는 경우 문제 해결 문서를 참고하시기 바랍니다.

클러스터 삭제

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

주의

클러스터를 삭제하면 클러스터의 노드와 할당된 볼륨이 함께 삭제되며 복구할 수 없습니다.

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

  2. 클러스터 메뉴에서 삭제할 클러스터를 선택합니다.

  3. 팝업창에서 영구 삭제를 입력하고 [삭제] 버튼을 클릭합니다.