Control Plane Request Limit 구성 항목 참조

Control Plane Request Limit 구성 항목 참조 (Control Plane Request Limit configuration reference)

이 주제에서는 control-plane-request-limit 구성 항목의 구성 옵션을 설명해요. 이 구성 항목은 default 파티션에만 쓸 수 있지만, 모든 파티션을 대상으로 하는 모든 클라이언트 요청에 적용돼요.

출처: 문서

본문

이 주제에서는 control-plane-request-limit 구성 항목의 구성 옵션을 설명합니다. control-plane-request-limit 구성 항목은 default 파티션에만 쓸 수 있지만 모든 파티션을 대상으로 하는 모든 클라이언트 요청에 적용됩니다.

Enterprise

이 기능은 Consul Enterprise가 필요합니다. 자세한 내용은 enterprise feature matrix를 참조하세요.

구성 모델 (Configuration model)

다음 목록은 control plane request limit 구성 항목의 필드 계층 구조, 언어별 데이터 유형 및 요구 사항을 설명합니다. 속성 이름을 클릭하면 기본값을 포함한 추가 정보를 볼 수 있습니다.

Kind: string | required | control-plane-request-limit로 설정해야 함
Mode: string | required | 기본값은 permissive
Name: string | required
ReadRate: number | 100
WriteRate: number | 100
KV: map | 기본값 없음
- ReadRate: number | 100
- WriteRate: number | 100
ACL: map | 기본값 없음
- ReadRate: number | 100
- WriteRate: number | 100
Catalog: map
- ReadRate: number | 기본값은 100
- WriteRate: number | 기본값은 100

완전한 구성 (Complete configuration)

모든 필드가 정의되면 control plane request limit 구성 항목은 다음과 같은 형식을 갖습니다:

HCL:

Kind = "control-plane-request-limit"
Name = "<name-for-the-entry>"

Mode = "permissive"

ReadRate =  100
WriteRate = 100

KV = {
  ReadRate =  100
  WriteRate = 100
}

ACL = {
  ReadRate =  100
  WriteRate = 100
}

Catalog = {
  ReadRate =  100
  WriteRate = 100
}

JSON:

{
  "Kind": "control-plane-request-limit",
  "Name": "<name-for-the-entry>",
  "Mode": "permissive",
  "ReadRate":  100,
  "WriteRate": 100,
  "KV": {
    "ReadRate": 100,
    "WriteRate": 100
    },
  "ACL": {
    "ReadRate": 100,
    "WriteRate": 100
    },
  "Catalog": {
    "ReadRate": 100,
    "WriteRate": 100
  }
}

YAML:

apiVersion: consul.hashicorp.com/v1alpha1
kind: ControlPlaneRequestLimit
metadata:
  name: <name-for-the-entry>
spec:
  mode: permissive
  # the maximum number of read requests per second that the agent allows.
  readRate: 100
  # the maximum number of write requests per second that the agent allows.
  writeRate: 100
  kv:
    readRate: 100
    writeRate: 100
  acl:
    readRate: 100
    writeRate: 100
  catalog:
    readRate: 100
    writeRate: 100

사양 (Specification)

이 섹션에서는 control plane request limit 구성 항목에서 구성할 수 있는 필드에 대한 세부 정보를 제공합니다.

`kind`

구현할 구성 항목의 유형을 지정합니다. control-plane-request-limit로 설정해야 합니다.

값 (Values)

기본값: none
필수 필드입니다.
데이터 유형: control-plane-request-limit로 설정해야 하는 문자열 값.

`mode`

요청 비율이 한도를 초과할 때 취할 조치를 지정합니다.

값 (Values)

기본값: None
필수 필드입니다.
다음 문자열 값 중 하나:
- permissive: 서버가 요청을 계속 허용하고 로그에 오류를 기록합니다. 이것이 mode의 기본값입니다.
- enforcing: 서버가 요청 수락을 중지하고 로그에 오류를 기록합니다.
- disabled: 제한이 시행되거나 추적되지 않습니다.

`name`

구성 항목의 이름을 지정합니다.

값 (Values)

기본값: none
필수 필드입니다.
데이터 유형: string

`read_rate`

에이전트가 허용하는 초당 최대 읽기 요청 수를 지정합니다.

값 (Values)

기본값: 제한 없음.
데이터 유형: number

`write_rate`

에이전트가 허용하는 초당 최대 쓰기 요청 수를 지정합니다.

값 (Values)

기본값: 제한 없음.
데이터 유형: number

`kv`

Consul 키-값 저장소에 대한 최대 읽기 및 쓰기 요청 수를 지정합니다.

값 (Values)

기본값: none
데이터 유형은 다음 매개변수를 포함하는 맵:
- read_rate
- write_rate

`kv.read_rate`

Consul 키-값 저장소에 허용되는 초당 최대 읽기 요청 수를 지정합니다.

값 (Values)

기본값: 제한 없음.
데이터 유형: number

`kv.write_rate`

Consul 키-값 저장소에 허용되는 초당 최대 쓰기 요청 수를 지정합니다.

값 (Values)

기본값: 제한 없음.
데이터 유형: number

`acl`

Consul 서버에 대한 최대 읽기 및 쓰기 ACL 요청 수를 지정합니다.

`acl.read_rate`

Consul 서버에 허용되는 초당 최대 ACL 읽기 요청 수를 지정합니다.

값 (Values)

기본값: 제한 없음.
데이터 유형: number

`acl.write_rate`

Consul 서버에 허용되는 초당 최대 ACL 쓰기 요청 수를 지정합니다.

값 (Values)

기본값: 제한 없음.
데이터 유형: number

`catalog`

Consul 카탈로그에 대한 최대 읽기 및 쓰기 요청 수를 지정합니다.

`catalog.read_rate`

Consul 카탈로그에 허용되는 초당 최대 읽기 요청 수를 지정합니다.

값 (Values)

기본값: 제한 없음.
데이터 유형: number

`catalog.write_rate`

Consul 카탈로그에 허용되는 초당 최대 쓰기 요청 수를 지정합니다.

값 (Values)

기본값: 제한 없음.
데이터 유형: number

Control Plane Request Limit 구성 항목 참조