워크스페이스 - 인덱스 템플릿 구성¶
POST /api/v1/workspace/{workspace_uuid}/update_index_setting
개요¶
경로 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| workspace_uuid | string | Y | 워크스페이스 UUID |
Body 요청 매개변수¶
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| data_type | string | Y | data 유형 빈 값 허용: False 선택 가능 값: ['rum', 'logging', 'network', 'tracing', 'profiling', 'keyevent', 'security', 'backup_log', 'apm', 'dialtest'] |
| cfg_uuid | string | 기타 인덱스 구성 UUID 빈 값 허용: False 빈 문자열 허용: True |
|
| hotRetention | int | 표준 스토리지 - 핫 스토리지 빈 값 허용: False |
|
| coldRetention | int | 저빈도 스토리지 - 콜드 데이터 빈 값 허용: False |
|
| archiveRetention | int | 아카이브 스토리지 - 아카이브 데이터 빈 값 허용: False |
|
| storagePolicy | json | 장기 스토리지 정책, 로그는 scopedb 스토리지 워크스페이스만 허용; pay, enterprise, unlimited는 로그 장기 스토리지 지원, enterprise/unlimited의 logging 최대 1800d; enterprise/unlimited의 rp는 사용자 정의 장기 스토리지 기간 지원(최대 3600d), unlimited는 BossAccountSet 활성화 시 metric_point_total 과금 유형만 지원, 비활성화 시 metric_point_total로 처리; longStorageEnabled 및 longStorageDuration 포함 빈 값 허용: False |
|
| openAdvancedConfig | int | 고급 구성 활성화 여부 빈 값 허용: False |
|
| mappings | json | 기타 인덱스 구성 UUID 빈 값 허용: False |
|
| number_of_shards | int | 기본 샤드 빈 값 허용: False |
|
| number_of_replicas | int | 복제본 수 빈 값 허용: False |
|
| rollover_max_size | int | 단일 샤드 크기, 해당 필드명은 kodo 측에서 제공하며 필드명에 모호함이 있음 빈 값 허용: False |
|
| duration | string | 데이터 저장 정책, 단위 d(일) 예시: 7d 빈 값 허용: False |
매개변수 추가 설명¶
외부 인터페이스 설명입니다.
관리 백엔드에서 인덱스 구성을 업데이트하고, kodo 인터페이스를 호출하여 수정합니다.
1. kodo 인덱스 구성 업데이트 매개변수 설명
| 매개변수명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| workspace_uuid | String | 필수 | 해당 워크스페이스의 UUID |
| number_of_shards | int | 선택 | 기본 샤드 수 |
| data_type | string | 필수 | 인덱스 유형, 열거형 값 |
| number_of_replicas | int | 필수 (doris는 선택) | 복제본 수 |
| rollover_max_size | int | 선택 | 샤드 크기 |
2. 관리 백엔드 인덱스 구성 설명:
es → all (샤드/복제본/핫 데이터 보존 기간/고급 구성 포함) beaver(로그이) → no doris → 핫 스토리지 volctls(Volcengine) → 표준 스토리지 - 핫 스토리지, 저빈도 스토리지 - 콜드 데이터, 아카이브 스토리지 - 아카이브 데이터 sls → no
3. 매개변수 설명
| key | 설명 |
|---|---|
| data_type | 병합되지 않은 인덱스의 data_type 선택 가능 값: backup_log, keyevent, logging, network, rum, security, tracing, profiling. 병합된 인덱스의 data_type 선택 가능 값: apm, backup_log, keyevent, logging, network |
| rollover_max_size | 인덱스 롤오버 조건을 나타냅니다. 즉, 인덱스가 특정 크기에 도달하면 새 인덱스가 롤오버됩니다. rollover_max_size = number_of_shards * 단일 샤드 크기 |
참고:
실제 rollover_max_size는 단일 샤드 크기를 나타내며 최대 크기가 아닙니다. kodo 측에서 아직 새 필드인 샤드 크기명을 제공하지 않아 rollover_max_size를 단일 샤드 크기로 계속 사용합니다. 수정이 필요한 경우 kodo 측에서 새 필드를 제공하여 단일 샤드 크기를 표시해야 합니다.
4. Volcengine 스토리지 설명
- Volcengine 스토리지의 경우, 기존 각 유형의 총 저장 기간은 현재 표준 스토리지에 해당합니다.
- Volcengine의 저장 정책 수정은 표준, 저빈도, 아카이브 세 가지 유형 모두에 대해 수정되며, 더 이상 총 기간 수정은 없습니다. 상호 작용은 Lanhu(관리 백엔드의 인덱스 구성 저장 기간 변경 및 프런트엔드 인덱스 저장 기간 변경 관련)를 참조하세요.
- Volcengine 저장 기간 제한:
- 표준 스토리지: 핫 데이터 스토리지, 데이터 범위: 1-1800일. 저빈도 스토리지가 있는 경우 데이터 범위: 7-1800일; 아카이브 스토리지가 있는 경우 데이터 범위: 30-1800일.
- 저빈도 스토리지: 콜드 데이터 스토리지, 데이터 범위: 30-1800일.
- 아카이브 스토리지: 아카이브 데이터 등 스토리지, 데이터 범위: 60-1800일.
- Volcengine 저장 기간 제한:
- 총 저장 기간(표준 스토리지 + 저빈도 스토리지 + 아카이브 스토리지)은 1800일을 초과할 수 없습니다.