eventCountThreshold 요소

<eventCountThreshold> 요소는 임계값 규칙에서만 유효합니다. 이는 특정 기간에서 이벤트 선택 기준에 부합해야 하는 이벤트 개수를 정의합니다. <eventCountThreshold> 요소는 또한 시간 창에서 두 개의 가능한 시간 간격 모드(고정 또는 슬라이딩) 중 하나를 지정합니다.

세부사항

고정 간격
고정 간격은 이벤트 선택 기준에 부합하는 첫 번째 이벤트를 받을 때 시작되고 다음 중 하나가 발생하면 종료됩니다.
  • 규칙이 지정된 지속 기간 내에서 임계값에 도달할 때
  • 지정된 지속 기간이 경과된 경우
슬라이딩 간격
슬라이딩 간격은 이벤트 선택 기준에 부합하는 첫 번째 이벤트를 받을 때 시작됩니다. 그러나 규칙이 임계값에 도달하지 않고 지정된 지속 기간이 경과된 경우, 시간 창은 시작 시간을 새로운 "첫 번째" 이벤트의 시작 시간으로 조정(슬라이드)합니다. 이는 일반적으로 다음 번에 승인되는 이벤트입니다. 슬라이딩 간격은 다음 중 하나가 발생할 때까지 이러한 방법으로 계속해서 조정합니다.
  • 규칙이 지정된 지속 기간 내에서 임계값에 도달할 때
  • 시간 창을 시작한 이벤트를 받은 후에 지정된 지속 기간 내에 후속 이벤트를 받지 않은 경우
시간 창을 시작한 이벤트(새로운 "첫 번째" 이벤트가 됨)는 이 기준에 부합하는 수신 시간이 있는 이벤트입니다. 규칙의 시간 간격 지속 기간에 추가된 수신 시간은 현재 시간 이후입니다. 다음은 방정식 양식으로 된 기준입니다.
event reception time + time interval duration for rule > current time
이러한 이벤트가 없으면 슬라이딩 간격이 더 이상 시간을 조정하지 않고 간격이 종료됩니다.
임계값 규칙은 임계값에 도달하거나 기간이 종료될 때까지 각 승인된 이벤트를 셈합니다. 그런 다음 이는 <onDetection> 요소 또는 <onTimeOut> 요소 내에 정의된 조치를 적절하게 실행합니다.
<onDetection> 조치
이러한 조치는 이벤트 계수가 <eventCountThreshold> 요소의 임계값 속성에 의해 정의된 값과 동일할 때 실행됩니다. 이는 임계값에 부합됨을 표시합니다.
<onTimeOut> 조치
이러한 조치가 실행되는 시기는 시간 간격 모드가 고정 또는 슬라이딩인지 여부에 따라 다릅니다.
고정 모드
고정 모드를 사용하면 시간 창이 만기될 때 이러한 조치가 실행됩니다.
슬라이딩 모드
슬라이딩 모드를 사용하면 시간 창을 시작한 이벤트를 받은 후에 지정된 지속 기간 내에 후속 이벤트를 받지 않은 경우에 이러한 조치가 실행됩니다. 다시 말하면 규칙의 시간 간격 지속 기간에 추가된 수신 시간이 현재 시간 이후인 이벤트를 받지 않았습니다.

시간 창의 시간 간격 모드는 <eventCountThreshold> 요소의 timeIntervalMode 속성에 의해 정의되어 있습니다. 다음 시나리오는 두 개의 가능한 시간 간격 모드 간의 차이점과 작동을 설명합니다.

고정 및 슬라이딩 모드를 설명하는 시나리오

규칙이 이벤트 선택 기준에 부합하는 네 개의 이벤트를 8:00, 8:04, 8:06 및 8:07에 하나씩 받았다고 가정합니다. 이벤트 계수 임계값은 3이고 시간 창의 지속 기간은 5분입니다.
fixed 모드의 규칙 작동
이 시간 간격 모드를 사용하면 임계값 규칙은 8:00에 처리를 시작하고 8:05에 <onTimeOut> 조치를 실행합니다. 이는 5분 동안 두 개의 이벤트만을 받기 때문입니다. 그러므로 시간 창 내에서 임계값에 도달하지 않습니다. 8:06에 세 번째 이벤트를 받으면 임계값 규칙이 처리를 다시 시작하고 8:11에 <onTimeOut> 조치를 실행합니다. 이는 5분 내에 두 개의 이벤트만을 받기 때문입니다.

고정 모드는 정적입니다.

sliding 모드의 규칙 작동
이 시간 간격 모드를 사용하면 임계값 규칙은 8:00에 처리를 시작합니다. 시간 창이 완료 예약되어 있는 8:05에 규칙은 두 개의 이벤트만을 받았다고 판별합니다. 그런 다음 규칙은 8:00에 받은 이벤트를 버리고 지속 기간을 8:09에 종료하도록 다시 계산합니다(첫 번째 이벤트가 8:04에 받은 이벤트이기 때문). 규칙이 8:07에 이벤트를 받으면 <onDetection> 조치를 실행합니다. 최신 시간 창(8:04 – 8:09)에서 임계값에 도달했기 때문입니다(8:04, 8:06 및 8:07에 세 개의 이벤트).

슬라이딩 모드는 시간 창에서 임계값에 도달하기 위해 시작 시간을 계속해서 조정(슬라이드)한다는 점에서 동적입니다.

이제 규칙이 이벤트 선택 기준에 부합하는 네 개의 이벤트를 8:00, 8:04, 8:06 및 8:10에 하나씩 받았다고 가정합니다. 이벤트 계수 임계값은 3이고 시간 창의 지속 기간은 5분입니다.
sliding 모드의 규칙 작동
이 경우 임계값 규칙은 8:00에 처리를 시작합니다. 시간 창이 완료 예약되어 있는 8:05에 규칙은 두 개의 이벤트만을 받았다고 판별합니다. 그런 다음 규칙은 8:00에 받은 이벤트를 버리고 지속 기간을 8:09에 종료하도록 다시 계산합니다(첫 번째 이벤트가 8:04에 받은 이벤트이기 때문).

시간 창이 완료 예약되어 있는 8:09에 규칙은 두 개의 이벤트만을 받았다고 판별합니다. 그런 다음 규칙은 8:04에 받은 이벤트를 버리고 지속 기간을 8:11에 종료하도록 다시 계산합니다(첫 번째 이벤트가 8:06에 받은 이벤트이기 때문).

시간 창이 완료 예약되어 있는 8:11에 규칙은 두 개의 이벤트만을 받았다고 판별합니다. 그런 다음 규칙은 8:06에 받은 이벤트를 버리고 지속 기간을 8:15에 종료하도록 다시 계산합니다(첫 번째 이벤트가 8:10에 받은 이벤트이기 때문).

시간 창이 완료 예약되어 있는 8:15에는 규칙은 시간 창이 시작된 8:10의 이벤트 이후로 이벤트를 받지 않았다고 판별합니다. 그런 다음 규칙은 <onTimeOut> 조치를 실행합니다.

속성

<eventCountThreshold>에는 다음과 같은 속성이 있습니다.

표 1. <eventCountThreshold> 요소의 속성
이름 설명 데이터 유형 필수 여부
임계값 특정 기간에서 이벤트 선택 기준에 부합해야 하는 이벤트 개수를 정의합니다. 도달해야 하는 이벤트 계수 임계값입니다. 이 값은 양의 정수여야 합니다. xsd:positiveInteger
timeIntervalMode 시간 창의 시간 간격이 고정 또는 슬라이딩인지 여부를 정의합니다. 이 속성의 올바른 값은 다음과 같습니다.
  • fixed(기본값)
  • sliding
xsd:string 아니오

포함 위치

<eventCountThreshold>는 다음 요소 내에 포함되어 있습니다.

포함 요소

<eventCountThreshold>에 포함된 요소가 없습니다.