Shard indexing backpressure settings

원문 보기 위키 갱신 2026.10.14

출처: 문서

본문

샤드 인덱싱 역압은 표준 OpenSearch 클러스터 설정에 여러 설정을 추가해요. 이 설정들은 동적이어서 클러스터를 재시작하지 않고도 이 기능의 기본 동작을 변경할 수 있어요.

상위 수준 제어를 사용하면 샤드 인덱싱 역압 기능을 켜거나 끌 수 있어요.

Setting	Default	Description
`shard_indexing_pressure.enabled`	False	`true`로 변경하여 샤드 인덱싱 역압을 활성화해요.
`shard_indexing_pressure.enforced`	False	샤드 인덱싱 역압을 섀도 모드 또는 강제 모드로 실행해요. 섀도 모드(`false`로 설정)에서는 샤드 인덱싱 역압이 모든 세분화된 수준의 메트릭을 추적하지만 실제로 인덱싱 요청을 거부하지는 않아요. 강제 모드(`true`로 설정)에서는 샤드 인덱싱 역압이 클러스터 성능 저하를 유발할 수 있는 모든 요청을 거부해요.

노드 수준 제한을 사용하면 노드의 메모리 사용량을 제어할 수 있어요.

Setting	Default	Description
`shard_indexing_pressure.primary_parameter.node.soft_limit`	70%	노드 수준 메모리 임계값의 백분율을 정의하며, 노드의 부담에 대한 소프트 표시기 역할을 해요.

샤드 수준 제한을 사용하면 샤드의 메모리 사용량을 제어할 수 있어요.

Setting	Default	Description
`shard_indexing_pressure.primary_parameter.shard.min_limit`	0.001d	새 샤드에 대해 코디네이터, 프라이머리 또는 복제본 역할에서 최소 할당 할당량을 지정해요. 샤드 인덱싱 역압은 샤드의 트래픽 유입량에 따라 이 할당된 할당량을 늘리거나 줄여요.
`shard_indexing_pressure.operating_factor.lower`	75%	샤드에 할당된 메모리 할당량의 하한 점유율을 지정해요. 샤드의 총 메모리 사용량이 이 한도보다 낮으면 샤드 인덱싱 역압이 해당 샤드의 현재 할당된 메모리를 줄여요.
`shard_indexing_pressure.operating_factor.optimal`	85%	샤드에 할당된 메모리 할당량의 최적 점유율을 지정해요. 샤드의 총 메모리 사용량이 이 수준이면 샤드 인덱싱 역압이 해당 샤드의 현재 할당된 메모리를 변경하지 않아요.
`shard_indexing_pressure.operating_factor.upper`	95%	샤드에 할당된 메모리 할당량의 상한 점유율을 지정해요. 샤드의 총 메모리 사용량이 이 한도보다 높으면 샤드 인덱싱 역압이 해당 샤드의 현재 할당된 메모리를 늘려요.

성능 저하 요인을 사용하면 샤드의 동적 성능 임계값을 제어할 수 있어요.

Setting	Default	Description
`shard_indexing_pressure.secondary_parameter.throughput.request_size_window`	2,000	샤드의 샘플링 윈도우 크기 내 요청 수예요. 샤드 인덱싱 역압은 요청의 전체 성능을 샘플 윈도우의 요청과 비교하여 성능 저하를 감지해요.
`shard_indexing_pressure.secondary_parameter.throughput.degradation_factor`	5x	요청의 단위 바이트당 저하 계수예요. 이 파라미터는 지연 시간 급증에 대한 임계값을 결정해요. 기본값은 5x이며, 이는 기록 보기에서 지연 시간이 5배 증가하면 샤드 인덱싱 역압이 이를 성능 저하로 표시한다는 의미예요.
`shard_indexing_pressure.secondary_parameter.successful_request.elapsed_timeout`	300000 ms	요청이 클러스터에서 대기 중인 시간이에요. 이 파라미터는 요청 중단 시나리오를 식별하는 데 도움을 줘요.
`shard_indexing_pressure.secondary_parameter.successful_request.max_outstanding_requests`	100	클러스터에서 대기 중인 최대 요청 수예요.

캐시 설정은 샤드 인덱싱 역압 시스템에서 사용하는 내부 캐시를 제어해요.

Setting	Default	Description
`shard_indexing_pressure.cache_store.max_size`	200	샤드 인덱싱 역압 시스템에서 콜드 스토어 캐시의 최대 크기예요. 최소 적용 값은 `100`이고, 최대 허용 값은 `1000`이에요.