ISM settings
출처: 문서
본문
ISM 설정
이 설정들을 변경하는 것은 권장하지 않아요. 기본값이 대부분의 사용 사례에 잘 맞을 거예요.
Index State Management(ISM)는 구성 정보를 .opendistro-ism-config 인덱스에 저장해요. ISM API 작업을 사용하지 않고 이 인덱스를 수정하지 마세요.
모든 설정은 OpenSearch _cluster/settings 작업을 사용하여 사용할 수 있어요. 재시작이 필요하지 않으며, 모두 persistent 또는 transient로 표시할 수 있어요. 정적 및 동적 설정에 대한 자세한 내용은 OpenSearch 구성을 참조하세요.
ISM 설정은 클러스터 설정이므로, persistent ISM 설정은 글로벌 클러스터 상태의 일부이며 include_global_state가 true로 설정된 스냅샷에 포함돼요. Transient 설정은 포함되지 않아요. ISM 정책은 클러스터 상태가 아닌 .opendistro-ism-config 인덱스에 저장되므로, 스냅샷은 해당 인덱스가 포함된 경우에만 정책을 포함해요. 자세한 내용은 글로벌 클러스터 상태를 참조하세요.
| 설정 | 기본값 | 설명 |
|---|---|---|
plugins.index_state_management.enabled |
True | ISM이 활성화되어 있는지 여부를 지정해요. |
plugins.index_state_management.job_interval |
5 | 관리 인덱스 작업이 실행되는 간격(분)이에요. |
plugins.index_state_management.jitter |
0.6 | 작업의 기본 실행 시간에 추가되는 무작위 지연 시간으로, 모든 인덱스가 동시에 활동하는 것을 방지해요. 값이 0.6이면 작업 간격의 0plugins.jobscheduler.jitter_limit를 초과할 수 없으며, 이 값의 기본값도 0.6이에요. 예를 들어 plugins.index_state_management.jitter가 0.8로 설정된 경우, ISM은 대신 plugins.jobscheduler.jitter_limit 값인 0.6을 사용해요. |
plugins.index_state_management.coordinator.sweep_period |
10m | 정기적인 백그라운드 스위프가 실행되는 주기예요. |
plugins.index_state_management.coordinator.backoff_millis |
50ms | ManagedIndexCoordinator에서 실패 시 재시도 간의 백오프 시간이에요(예: 관리 인덱스를 업데이트할 때). |
plugins.index_state_management.coordinator.backoff_count |
2 | ManagedIndexCoordinator에서 실패 시 재시도 횟수예요. |
plugins.index_state_management.history.enabled |
True | 감사 기록이 활성화되어 있는지 여부를 지정해요. ISM의 로그는 자동으로 로그 문서에 인덱싱돼요. |
plugins.index_state_management.history.max_docs |
2500000 | 감사 기록 인덱스를 롤오버하기 전의 최대 문서 수예요. |
plugins.index_state_management.history.max_age |
24h | 감사 기록 인덱스를 롤오버하기 전의 최대 기간이에요. |
plugins.index_state_management.history.rollover_check_period |
8h | 감사 기록 인덱스의 롤오버 확인 간격이에요. |
plugins.index_state_management.history.rollover_retention_period |
30d | 감사 기록 인덱스가 보관되는 기간이에요. |
plugins.index_state_management.allow_list |
alias, allocation, close, convert_index_to_remote, delete, force_merge, index_priority, notification, open, read_only, read_write, replica_count, rollover, rollup, search_only, shrink, snapshot, stop_replication, transform |
정책에서 사용할 수 있는 작업이에요. 이 목록에서 작업을 제거하면 해당 작업을 사용하는 모든 정책이 실패해요. |
plugins.index_state_management.action_validation.enabled |
False | ISM이 작업을 실행하기 전에 검증하는지 여부를 지정해요. 자세한 내용은 ISM 오류 방지를 참조하세요. |
plugins.index_state_management.coordinator.sweep_skip_period |
5m | 실패 후 코디네이터가 관리 인덱스를 다시 스위프하기 전에 대기하는 시간이에요. |
plugins.index_state_management.history.number_of_shards |
1 | 감사 기록 인덱스의 기본 샤드 수예요. |
plugins.index_state_management.history.number_of_replicas |
1 | 감사 기록 인덱스의 복제본 수예요. |
plugins.index_state_management.snapshot.deny_list |
Empty list | snapshot 작업이 쓸 수 없는 스냅샷 저장소예요. |