---
title: "Search Engine Service FAQ"
slug: "ses-searchenginefaq"
tags: ["Search Engine Service"]
updated: 2026-09-17T09:09:16Z
published: 2026-09-17T09:09:16Z
canonical: "guide-fin.ncloud-docs.com/ses-searchenginefaq"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Engine Service FAQ

Search Engine Service FAQ에서 자주 하는 질문에 대한 답변을 제공합니다.

다음의 자주 하는 질문에서 원하는 답을 얻지 못한 경우, 사용 가이드에서 원하는 내용을 찾아서 확인해 주십시오.

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

A. 클러스터 스펙별 데이터 처리량을 확인하고 결정해 주십시오([클러스터 스펙별 데이터 처리량](/docs/ses-spec#%ED%81%B4%EB%9F%AC%EC%8A%A4%ED%84%B0%EC%8A%A4%ED%8E%99%EB%B3%84%EB%8D%B0%EC%9D%B4%ED%84%B0%EC%B2%98%EB%A6%AC%EB%9F%89) 참고). 반드시 테스트 진행 후 실 환경에서 사용해 주십시오.

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

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

## Q. 클러스터의 상태가 정상적으로 운영 중인 상태가 아닌 것 같습니다.

A. Search Engine Service에서 클러스터 상태는 **운영중**, **경고**, **에러**, **알수없음** 4가지로 표시됩니다. 각 상태별 설명은 [클러스터 상태](/docs/ses-use-dashboard#%ED%81%B4%EB%9F%AC%EC%8A%A4%ED%84%B0%EC%83%81%ED%83%9C)를 참고해 주십시오.

## 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를 통해 스냅샷 생성](/docs/ses-use-dashboards#Elasticsearch%EB%B0%8FOpensearchAPI%EB%A5%BC%ED%86%B5%ED%95%B4%EC%8A%A4%EB%83%85%EC%83%B7%EC%83%9D%EC%84%B1) 참고)
  - 동일한 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](/docs/ses-use-snapshot) 참고) 또한 Kibana 또는 OpenSearch Dashboards의 Console에서 다음 명령어를 통해 현재 스냅샷 관련 작업 중인 인덱스 또는 완료된 인덱스의 수를 알 수 있습니다.

```
GET _snapshot/_status
```

## Q. 클러스터의 로그를 수집하고 싶습니다.

A. 2022년 1월 13일 이전에 생성된 클러스터는 로그 수집이 되지 않습니다. 로그 수집을 원한다면 고객지원에 [문의](https://www.fin-ncloud.com/support/question/service)해 주십시오.

## 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 접속](/docs/ses-ssh-vpc) 참고)
  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](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2020-7015)를 참고해 주십시오.