Workload groups
출처: 문서
본문
워크로드 그룹
워크로드 그룹은 정의된 리소스 제한이 있는 작업의 논리적 그룹이에요. Workload Group API를 사용하여 워크로드 그룹을 생성, 업데이트, 검색 및 삭제할 수 있어요.
워크로드 그룹 생성
워크로드 그룹을 생성하려면 다음 요청을 전송하세요:
PUT _wlm/workload_group
{
"name": "analytics",
"resiliency_mode": "enforced",
"resource_limits": {
"cpu": 0.4,
"memory": 0.2
}
}
{% include copy-curl.html %}
OpenSearch는 워크로드 그룹 ID가 포함된 응답을 반환해요. 이 ID를 사용하여 쿼리 요청을 그룹과 연결하고 그룹의 리소스 제한을 적용할 수 있어요:
{
"_id":"preXpc67RbKKeCyka72_Gw",
"name":"analytics",
"resiliency_mode":"enforced",
"resource_limits":{
"cpu":0.4,
"memory":0.2
},
"updated_at":1726270184642
}
자세한 내용은 워크로드 그룹 ID 사용을 참조하세요.
파라미터
워크로드 그룹을 생성하거나 업데이트할 때 다음 파라미터를 지정할 수 있어요.
| 파라미터 | 작업 | 설명 |
|---|---|---|
name |
생성 | 워크로드 그룹의 이름이에요. |
resiliency_mode |
생성 또는 업데이트 | 워크로드 그룹의 복원 모드예요. 유효한 값은 다음과 같아요: - enforced (임계값을 초과하면 쿼리가 거부돼요).- soft (리소스를 사용할 수 있으면 쿼리가 임계값을 초과할 수 있어요).- monitor (쿼리는 모니터링되지만 취소되거나 거부되지 않아요).참고: 이 설정은 클러스터 수준의 wlm.workload_group.mode 설정이 enabled인 경우에만 적용돼요. 운영 모드를 참조하세요. |
resource_limits |
생성 또는 업데이트 | 워크로드 그룹의 쿼리 요청에 대한 리소스 제한이에요. 유효한 리소스는 cpu와 memory예요. 워크로드 그룹을 생성할 때 단일 리소스(cpu 또는 memory)에 대한 리소스 제한의 합계가 1을 초과하지 않도록 하세요. |
settings |
생성 또는 업데이트 | 워크로드 그룹으로 라우팅되는 요청에 자동으로 적용되는 그룹별 설정이에요. 지원되는 설정 및 업데이트 동작은 워크로드 그룹 설정을 참조하세요. |
워크로드 그룹 업데이트
워크로드 그룹을 업데이트하려면 경로 파라미터로 워크로드 그룹 이름을 제공하고 업데이트하려는 파라미터를 요청 본문 필드로 제공하세요. 워크로드 그룹을 업데이트할 때 지정한 파라미터만 변경되고 다른 모든 파라미터는 그대로 유지돼요:
PUT _wlm/workload_group/analytics
{
"resiliency_mode": "monitor",
"resource_limits": {
"cpu": 0.41,
"memory": 0.21
},
"settings": {
"search.default_search_timeout": "1m"
}
}
{% include copy-curl.html %}
settings 필드에 대한 자세한 내용(지원되는 설정 및 업데이트 동작 포함)은 워크로드 그룹 설정을 참조하세요.
워크로드 그룹 검색
모든 워크로드 그룹을 검색하려면 다음 요청을 사용하세요:
GET /_wlm/workload_group
{% include copy-curl.html %}
특정 워크로드 그룹을 검색하려면 해당 ID를 경로 파라미터로 제공하세요:
GET /_wlm/workload_group/{name}
{% include copy-curl.html %}
워크로드 그룹 삭제
워크로드 그룹을 삭제하려면 해당 이름을 경로 파라미터로 지정하세요:
DELETE /_wlm/workload_group/{name}
{% include copy-curl.html %}