Search Engine Service FAQ
- 인쇄
- PDF
Search Engine Service FAQ
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
Search Engine Service FAQ에서 자주 하는 질문에 대한 답변을 제공합니다.
다음의 자주 하는 질문에서 원하는 답을 얻지 못한 경우, 사용 가이드에서 원하는 내용을 찾아서 확인해 주십시오.
Q. 어떤 스펙의 클러스터를 사용해야 합니까?
A. 클러스터 스펙별 데이터 처리량을 확인하고 결정해 주십시오(클러스터 스펙별 데이터 처리량 참고). 반드시 테스트 진행 후 실 환경에서 사용해 주십시오.
Q. 사용 중인 클러스터의 스펙을 변경할 수 있습니까?
A. 사용 중인 클러스터의 스펙 변경 기능은 제공하지 않습니다.
Q. 클러스터의 상태가 정상적으로 운영 중인 상태가 아닌 것 같습니다.
A. Search Engine Service에서 클러스터 상태는 운영중, 경고, 에러, 알수없음 4가지로 표시됩니다. 각 상태별 설명은 클러스터 상태를 참고해 주십시오.
Q. 샤드 개수는 몇 개가 적당합니까?
A. 데이터 노드 메모리 크기, 인덱스 데이터량, 권장 샤드 크기를 고려하여 결정합니다.
- 샤드 크기는 JVM Heap Size(데이터 노드 메모리 크기의 절반)를 넘지 않을 것을 권장합니다.
- <예시> 데이터 노드 메모리 크기가 32 GB, 인덱스 데이터량이 150 GB인 경우
- JVM Heap Size는 16 GB입니다. 권장 샤드 크기를 약 15 GB로 고려한다면 샤드 개수는 10개가 적당합니다.
참고
Kibana 또는 OpenSearch Dashboards의 Console에서 특정 인덱스에 대한 샤드 개수를 설정할 수 있습니다.
- 새로 생성하는 인덱스에만 적용되며 기존 인덱스에는 적용되지 않습니다.
- <예시>
logstash-로 시작하는 인덱스에 대하여 샤드 개수를 10개로 설정하는 템플릿 생성PUT _template/logstash-template { "index_patterns": ["logstash-*"], "settings": { "number_of_shards": 10 } }
Q. 데이터 노드 추가 시 현재 운영 중인 클러스터에 영향이 있습니까?
A. 데이터 노드가 추가될 경우, 운영 중인 클러스터의 설정 파일을 변경한 후 클러스터 재시작을 합니다. 이 과정에서 서비스에 일시적인 순단이 발생할 수 있습니다. 추가된 데이터 노드로 샤드가 재분배되며, 이 과정에서 리소스 사용량이 평소보다 증가할 수 있습니다.
Q. 사용하고 싶은 플러그인을 따로 설치할 수 있습니까?
A. 먼저 sshuser로 서버에 접근하고 plugin 파일을 저장하고 설치합니다.
- Elasticsearch 클러스터의 경우, 다음 명령어를 통해 플러그인을 설치할 수 있습니다.
sudo /usr/share/elasticsearch/bin/elasticsearch-plugin install "저장한 plugin 파일명" - Opensearch 클러스터의 경우, 다음 명령어를 통해 플러그인을 설치할 수 있습니다.
sudo /usr/share/opensearch/bin/opensearch-plugin install "저장한 plugin 파일명"
참고
sshuser는 암호 없이 sudo 명령어를 사용할 수 있습니다.
주의
사용자가 Search Engine Service 클러스터에 접속하여 실행한 행위로 인해 클러스터가 정상 운영되지 않을 경우 네이버 클라우드 플랫폼은 이에 대해 책임을 지지 않습니다.
Q. Elasticsearch의 OSS 라이선스에서 Basic 라이선스로 변경이 가능합니까?
A. Search Engine Service에서는 OSS 라이선스만 사용 가능하고, Basic 이상의 라이선스는 사용이 불가능합니다.
Q. 스냅샷 생성의 실패 원인이 무엇입니까?
A. 다음의 실패 원인을 참고해 주십시오.
- 스냅샷 생성 실패 원인
- 다른 스냅샷을 생성 중 또는 삭제 중인 경우
- Object Storage 관련 권한이 부족한 Sub Account의 API 인증키를 설정한 경우
- 스냅샷 정상 생성 실패 원인
- 클러스터의 사용량이 많은 경우(데이터 인입량이 많거나 검색 쿼리가 많은 경우)
- 클러스터의 사용량이 적은 시간대에 스냅샷 생성을 시도해 주십시오.
- 클러스터가 복원 중인 경우 또는 initializing 상태의 샤드가 존재하는 경우
- Snapshot repository에 너무 많은 양의 데이터가 있어서 타임아웃이 되는 경우
- Elasticsearch 및 Opensearch API를 직접 호출하여 스냅샷을 생성할 수 있습니다.(Elasticsearch 및 Opensearch API를 통해 스냅샷 생성 참고)
- 동일한 Snapshot repository(버킷명과
base_path가 동일)에 2개 이상의 클러스터가 스냅샷을 생성하는 경우 - 스냅샷 생성 도중 설정한 API 인증키를 사용 중지할 경우
- 스냅샷 생성 도중 버킷을 삭제하거나 버킷에 접근 제어를 설정할 경우
- Object Storage Plugin(s3-repository)를 삭제하거나, API 인증키(s3.client.default.access_key, s3.client.default.secret_key)를 삭제, 변경할 경우
- 클러스터의 사용량이 많은 경우(데이터 인입량이 많거나 검색 쿼리가 많은 경우)
주의
- Snapshot repository에서는 동시에 하나의 작업(스냅샷 생성, 삭제, 복원)만 수행할 수 있으며, 여러 작업을 동시에 수행하여 스냅샷 파일에 문제가 생길 경우 네이버 클라우드 플랫폼은 이에 대하여 책임지지 않습니다.
- 버킷 내 스냅샷 관련 파일을 임의로 수정 또는 삭제할 경우, 스냅샷 관련 작업이 정상적으로 이루어지지 않을 수 있으며 네이버 클라우드 플랫폼은 이에 대하여 책임지지 않습니다.
- 해당 폴더를 삭제하거나 버킷을 새로 생성하여 스냅샷을 생성해 주십시오.
Q. 생성하지 않은 스냅샷 이름이 있습니다.
A. Search Engine Service에서는 생성한 스냅샷의 상태가 PARTIAL인 경우, 기존에 생성한 스냅샷 이름+-retry 라는 이름으로 스냅샷을 재생성합니다.
Q. 스냅샷 진행 상황이 궁금합니다.
A. Snapshot 메뉴에서 대략적인 진행 상황을 확인할 수 있습니다.(Snapshot 참고) 또한 Kibana 또는 OpenSearch Dashboards의 Console에서 다음 명령어를 통해 현재 스냅샷 관련 작업 중인 인덱스 또는 완료된 인덱스의 수를 알 수 있습니다.
GET _snapshot/_status
Q. 클러스터의 로그를 수집하고 싶습니다.
A. 2022년 1월 13일 이전에 생성된 클러스터는 로그 수집이 되지 않습니다. 로그 수집을 원한다면 고객지원에 문의해 주십시오.
Q. Kibana에서 TSVB Type의 Visualization이 보이지 않습니다.
A. 다음 사항을 참고해 주십시오.
- Search Engine Service에서 제공하는 Kibana OSS 7.7.0 버전에 발생한 CVE-2020-7015 취약점으로 인해 TSVB Type의 Visualization 사용이 제한됩니다.
- 부득이하게 TSVB Type의 Visualization을 사용해야 하는 경우, 다음과 같이 kibana.yml 파일을 수정한 후 Kibana를 재시작해 주십시오.
- sshuser 계정으로 매니저 노드에 접속해 주십시오.(매니저 노드에 SSH 접속 참고)
sudo vi /etc/kibana/kibana.yml명령어를 실행하여kibana.yml파일을 열어 주십시오.- 파일의 맨 아래줄에 있는
metrics.enabled: false내용을 삭제해 주십시오. sudo systemctl restart명령어를 실행하여 Kibana를 재시작해 주십시오.
주의
kibana.yml파일을 수정하여 사용하는 경우, CVE-2020-7015 취약점에 대응이 어려울 수 있습니다.- CVE-2020-7015 취약점에 대한 자세한 내용은 CVE-2020-7015를 참고해 주십시오.
이 문서가 도움이 되었습니까?