Login
      내용 x
      Search Engine Service FAQ
        • 인쇄
        • PDF
        내용

        Search Engine Service FAQ

          • 인쇄
          • PDF
          Article Summary

          Classic/VPC 환경에서 이용 가능합니다.

          Search Engine Service FAQ에서 자주 하는 질문에 대한 답변을 제공합니다. 다음의 자주 하는 질문에서 원하는 답을 얻지 못한 경우, 사용 가이드에서 원하는 내용을 찾아서 확인해 주십시오.

          Q. 어떤 스펙의 클러스터를 사용해야 합니까?

          A. 클러스터 스펙별 데이터 처리량을 확인하고 결정해 주십시오. (클러스터 스펙별 데이터 처리량 참조) 반드시 테스트 진행 후 실 환경에서 사용해 주십시오.

          Q. 사용 중인 클러스터의 스펙을 변경할 수 있습니까?

          A. 사용 중인 클러스터의 스펙 변경 기능은 제공하지 않습니다.

          Q. 클러스터의 상태를 어떻게 확인할 수 있습니까?

          A. Search Engine Service에서 클러스터 상태는 운영중, 경고, 에러, 알수없음 4가지로 표시됩니다. 각 상태별 설명은 클러스터 상태(VPC) 또는 클러스터 상태(Classic)를 참조해 주십시오.

          Q. 샤드 개수는 몇 개가 적당합니까?

          A. 데이터 노드 메모리 크기, 인덱스 데이터량, 권장 샤드 크기를 고려하여 결정합니다.

          • 샤드 크기는 JVM Heap Size(데이터 노드 메모리 크기의 절반)를 넘지 않을 것을 권장합니다.
          • <예시> 데이터 노드 메모리 크기가 32GB, 인덱스 데이터량이 150GB인 경우
            • JVM Heap Size는 16GB입니다. 권장 샤드 크기를 약 15GB로 고려한다면 샤드 개수는 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에 너무 많은 양의 데이터가 있어서 타임아웃이 되는 경우
            • 동일한 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(VPC) 메뉴에서 대략적인 진행 상황을 확인할 수 있습니다. (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를 재시작해 주십시오.
            1. sshuser 계정으로 매니저 노드에 접속해 주십시오. (매니저 노드에 SSH 접속(VPC) 또는 매니저 노드에 SSH 접속(Classic)참조)
            2. sudo vi /etc/kibana/kibana.yml 명령어를 실행하여 kibana.yml 파일을 열어 주십시오.
            3. 파일의 맨 아래줄에 있는 metrics.enabled: false 내용을 삭제해 주십시오.
            4. sudo systemctl restart 명령어를 실행하여 Kibana를 재시작해 주십시오.
          주의
          • kibana.yml 파일을 수정하여 사용하는 경우, CVE-2020-7015 취약점에 대응이 어려울 수 있습니다.
          • CVE-2020-7015 취약점에 대한 자세한 내용은 CVE-2020-7015를 참조해 주십시오.
          이 문서가 도움이 되었습니까?
          What's Next
          Change password!
          Changing your password will log you out immediately. Use the new password to log back in.
          Change profile
          Success!
          First name must have atleast 2 characters. Numbers and special characters are not allowed.
          Last name must have atleast 1 characters. Numbers and special characters are not allowed.
          Enter a valid email
          Enter a valid password
          Your profile has been successfully updated.
          Logout