ControlRate 2025.5.31.15

번들

org.apache.nifi | nifi-standard-nar

설명

후속 프로세서로 데이터를 전송하는 속도를 제어합니다. 매우 작은 시간 지속 시간을 구성하면 스로틀의 정확도가 떨어집니다. 프로세서에 더 많은 작업이 주어지는 대신 Yield Duration을 줄임으로써 이 정확도를 향상시킬 수 있습니다.

태그

rate, rate control, throttle, throughput

입력 요구 사항

REQUIRED

민감한 동적 속성 지원

false

속성

속성

설명

Grouping Attribute

기본적으로 모든 FlowFiles 에 단일 “스로틀”이 사용됩니다. 이 값을 지정하면 이 이름을 가진 특성으로 지정된 각 값에 대해 별도의 스로틀이 사용됩니다. 이 값을 변경하면 요금 카운터가 초기화됩니다.

Maximum Data Rate

데이터가 이 프로세서를 통과해야 하는 최대 속도입니다. 이 속성의 형식은 시간 지속 시간당 바이트 수를 나타내는 데이터 크기(예: ‘1 MB’)가 될 것으로 예상됩니다.

Maximum FlowFile Rate

FlowFiles 에서 이 프로세서를 통과해야 하는 최대 속도입니다. 이 속성의 형식은 시간 지속 시간당 FlowFiles 카운트를 나타내는 양의 정수여야 합니다

Maximum Rate

데이터가 이 프로세서를 통과해야 하는 최대 속도입니다. 이 속성의 형식은 양수 정수이거나 Rate Control Criteria가 ‘data rate’로 설정된 경우 데이터 크기(예: ‘1 MB’)가 될 것으로 예상됩니다.

Rate Control Criteria

처리량 속도를 제어하는 데 사용되는 기준을 나타냅니다. 이 값을 변경하면 요금 카운터가 초기화됩니다.

Rate Controlled Attribute

요금 통제 기준이 ‘attribute value’로 설정된 경우 요금 제한에 따라 값이 쌓이는 특성의 이름입니다. 이 속성에서 참조하는 특성의 값은 양수 길이여야 하며, 그렇지 않으면 FlowFile 은 실패로 라우팅됩니다. 속도 제어 기준이 ‘attribute value’로 설정되지 않은 경우 이 값은 무시됩니다. 이 값을 변경하면 요금 카운터가 초기화됩니다.

Rate Exceeded Strategy

최대 데이터 전송률을 초과한 경우 수신되는 FlowFile 처리 방법을 지정합니다.

Time Duration

최대 요금이 적용되는 기간입니다. 이 값을 변경하면 요금 카운터가 초기화됩니다.

관계

이름

설명

실패

FlowFiles 에 필요한 요금 제어 특성이 누락되었거나 특성이 예상 형식이 아닌 경우 이 관계로 라우팅됩니다

성공

FlowFiles 은 정상적인 조건에서 이 관계로 이전됩니다

사용 사례

데이터가 다운스트림 시스템으로 전송되는 속도를 제한하여 버스트가 거의 또는 전혀 발생하지 않도록 합니다

FlowFiles 이 다운스트림 시스템으로 전송되는 속도를 제한하여 버스트가 거의 또는 전혀 발생하지 않도록 합니다

특정 속도를 초과하는 요청은 거의 또는 전혀 거부하지 않습니다

특정 속도를 초과하는 요청을 거부하여 버스트를 허용합니다