Admission control settings

원문 보기 위키 갱신 2026.10.14

출처: 문서

본문

OpenSearch는 다양한 유형의 작업에 대한 리소스 사용을 제한하여 클러스터 과부하를 방지하는 승인 제어 설정을 제공합니다. 승인 제어는 CPU 및 I/O 사용량을 모니터링하고 리소스 사용률이 구성된 임계값을 초과하면 요청을 거부할 수 있습니다.

이 설정을 적용하는 방법을 알아보려면 OpenSearch 구성을 참조하세요.

OpenSearch는 다음과 같은 전송 계층 승인 제어 설정을 지원합니다.

admission_control.transport.mode (Dynamic, string): 전송 계층의 전체 승인 제어 모드를 제어합니다. 유효한 값은 다음과 같습니다.
- disabled (기본값): 승인 제어가 비활성화됩니다.
- shadow: 승인 제어가 모니터링 모드로만 실행되어 메트릭을 수집하고 요청을 거부하지 않습니다.
- enforced: 승인 제어가 임계값을 초과할 때 요청을 적극적으로 거부합니다.

CPU 기반 승인 제어는 CPU 사용량을 모니터링하고 다양한 유형의 작업에 제한을 적용합니다. 모든 CPU 제한은 백분율(0--100)로 지정됩니다.

OpenSearch는 다음과 같은 동적 CPU 기반 승인 제어 설정을 지원합니다.

admission_control.cluster.admin.cpu_usage.limit (Dynamic, long): 클러스터 관리 작업에 대한 CPU 사용량 임계값입니다. CPU 사용량이 이 제한을 초과하면 클러스터 안정성을 유지하기 위해 클러스터 관리 요청이 거부될 수 있습니다. 기본값은 95입니다.
admission_control.search.cpu_usage.limit (Dynamic, long): 검색 작업에 대한 CPU 사용량 임계값입니다. CPU 사용량이 이 제한을 초과하면 클러스터 과부하를 방지하기 위해 새 검색 요청이 거부될 수 있습니다. 기본값은 95입니다.
admission_control.indexing.cpu_usage.limit (Dynamic, long): 인덱싱 작업에 대한 CPU 사용량 임계값입니다. CPU 사용량이 이 제한을 초과하면 클러스터 성능을 유지하기 위해 인덱싱 요청이 거부될 수 있습니다. 기본값은 95입니다.
admission_control.transport.cpu_usage.mode_override (Dynamic, string): CPU 기반 승인 제어에 대해 전역 전송 모드를 재정의합니다. admission_control.transport.mode와 동일한 값(disabled, shadow, enforced)을 허용합니다. 지정하지 않으면 전역 전송 모드 설정을 사용합니다.

I/O 기반 승인 제어는 디스크 I/O 사용량을 모니터링하고 다양한 유형의 작업에 제한을 적용합니다. 모든 I/O 제한은 백분율(0--100)로 지정됩니다.

OpenSearch는 다음과 같은 I/O 기반 승인 제어 설정을 지원합니다.

admission_control.search.io_usage.limit (Dynamic, long): 검색 작업에 대한 I/O 사용량 임계값입니다. I/O 사용량이 이 제한을 초과하면 검색 요청이 거부될 수 있습니다. 기본값은 95입니다.
admission_control.indexing.io_usage.limit (Dynamic, long): 인덱싱 작업에 대한 I/O 사용량 임계값입니다. I/O 사용량이 이 제한을 초과하면 인덱싱 요청이 거부될 수 있습니다. 기본값은 95입니다.
admission_control.cluster_admin.io_usage.limit (Static, long): 클러스터 관리 작업에 대한 I/O 사용량 임계값입니다. 이는 정적 설정으로 수정하려면 클러스터를 다시 시작해야 합니다. 기본값은 100입니다.
admission_control.transport.io_usage.mode_override (Dynamic, string): I/O 기반 승인 제어에 대해 전역 전송 모드를 재정의합니다. admission_control.transport.mode와 동일한 값(disabled, shadow, enforced)을 허용합니다. 지정하지 않으면 전역 전송 모드 설정을 사용합니다.