Discovery and gateway settings
출처: 문서
본문
디스커버리 및 게이트웨이 설정
다음은 디스커버리 및 로컬 게이트웨이와 관련된 설정이에요.
이 설정을 적용하는 방법을 알아보려면 OpenSearch 구성을 참조하세요.
디스커버리 설정
디스커버리 프로세스는 클러스터가 형성될 때 사용돼요. 이는 노드를 발견하고 클러스터 관리자 노드를 선출하는 과정으로 구성되어 있어요. 디스커버리 및 클러스터 형성 설정에 대한 자세한 내용은 디스커버리 및 클러스터 형성 설정을 참조하세요.
-
discovery.find_peers_interval_during_decommission(Static, time unit): 노드가 디커미셔닝(decommissioned) 상태일 때 모든 피어를 찾기 위한 시도 간의 시간 간격을 설정해요. 노드가 디커미셔닝되는 동안 이 간격으로 다른 노드를 계속 발견하여 디커미셔닝 프로세스 중 클러스터 멤버십 정보를 유지해요. 이는 통제된 노드 제거 시 적절한 조정을 보장하는 데 도움을 줘요. 기본값은120s(2분)이고, 최소값은1000ms예요. -
discovery.unconfigured_bootstrap_timeout(Static, time unit): 클러스터 형성 중 구성되지 않은 부트스트랩 프로세스의 타임아웃 기간을 설정해요. 이 설정은 클러스터가 제대로 구성되지 않았을 때(예:cluster.initial_cluster_manager_nodes가 설정되지 않은 경우) 부트스트랩 단계에서 노드가 대기하는 시간을 제어해요. 타임아웃 후 노드는 부트스트랩 작업을 진행하거나 적절히 실패해요. 이 설정은 노드가 구성되지 않은 상태에서 무한정 대기하는 것을 방지하는 데 도움을 줘요. 기본값은3s이고, 최소값은1ms예요.
게이트웨이 설정
로컬 게이트웨이는 클러스터가 재시작될 때 사용되는 디스크 상의 클러스터 상태와 샤드 데이터를 저장해요. 다음 로컬 게이트웨이 설정이 지원돼요.
-
gateway.recover_after_data_nodes(Static, integer): 전체 클러스터 재시작 후 복구가 시작되기 전에 실행 중이어야 하는 최소 데이터 노드 수예요.- 기본값:
0 - 권장 사항: 조기 복구를 방지하기 위해 데이터 노드의 상당 부분(전체 데이터 노드의 약 50~70%)으로 설정하세요.
- 기본값:
-
gateway.expected_data_nodes(Static, integer): 클러스터에서 예상되는 데이터 노드 수예요. 모두 존재하면 로컬 샤드의 복구가 즉시 시작될 수 있어요.- 기본값:
0 - 권장 사항: 모든 데이터 노드가 실행되면 복구가 즉시 시작될 수 있도록 클러스터의 실제 데이터 노드 수로 설정하세요.
- 기본값:
-
gateway.recover_after_time(Static, time unit): 예상 데이터 노드 수에 도달하지 않은 경우 복구까지 대기하는 최대 시간이에요. 이 시간이 지나면 복구가 진행돼요.- 기본값:
expected_data_nodes또는recover_after_nodes가 설정된 경우5m이고, 그렇지 않으면 비활성화돼요. - 권장 사항: 일반적인 노드 조인 시간보다 약간 높게 설정하세요. 대규모 클러스터는 복구에 더 오랜 시간이 필요한 경우가 많으며 관찰된 시작 동작에 따라 조정돼요.
- 기본값:
-
gateway.write_dangling_indices_info(Static, Boolean): OpenSearch가 클러스터 상태 유지 중에 댕글링 인덱스(dangling indexes)에 대한 정보를 디스크에 쓸지 여부를 제어해요. 활성화되면 시스템은 디스크에 존재하지만 현재 클러스터 상태의 일부가 아닌 인덱스에 대한 메타데이터를 유지하여 복구 및 문제 해결 시나리오에 도움을 줄 수 있어요. 기본값은true예요. -
gateway.auto_import_dangling_indices(Static, Boolean): OpenSearch가 클러스터 시작 중에 발견된 댕글링 인덱스를 자동으로 가져올지 여부를 제어해요. 댕글링 인덱스는 디스크에 존재하지만 현재 클러스터 상태의 일부가 아닌 인덱스로, 일반적으로 부적절한 클러스터 종료나 노드 제거 후에 남겨져요. 활성화되면 이러한 고아 인덱스는 시작 중에 자동으로 클러스터 상태로 다시 가져와져요. 비활성화되면 댕글링 인덱스는 디스크에 남아 있지만 자동으로 가져오지 않으며, Dangling Indices API를 통한 수동 개입이 필요해요. 이 설정은 잠재적으로 손실된 데이터를 복구하는 데 도움이 되지만 원치 않는 인덱스를 가져오지 않도록 주의해서 사용해야 해요. 기본값은true예요.