베타: Managed ClickStack 전용이상 탐지 알림은 베타 단계이며 Managed ClickStack에서만 사용할 수 있습니다. ClickStack Open Source에서는 사용할 수 없습니다. 베타 기간 동안 동작과 기본값이 변경될 수 있습니다.
- 적절한 임계값이 서비스, 엔드포인트 또는 고객마다 다르며, 알림을 해당 차원으로 그룹화하는 경우
- 정상 값이 하루 중에도 변동하여, 고정 임계값을 사용하면 피크 시간에는 알림이 과도하게 발생하고 비피크 시간에는 문제를 감지하지 못하는 경우
- 절대적인 수준보다 오류 급증, 지연 시간 급상승, 트래픽이 0으로 떨어지는 현상 등 급격한 변화를 감지하는 것이 더 중요한 경우
지원되는 알림
이상 탐지(Anomaly detection)는 별도의 알림 유형이 아니라 기존 알림에 적용하는 탐지 모드입니다. 다음 알림에서 사용할 수 있습니다.- 검색 알림: 일치하는 이벤트 수를 기준으로 점수를 산정합니다.
- 대시보드 차트 알림: 차트 빌더로 만든 차트에서 사용할 수 있습니다.
이상 탐지 알림 생성
1
알림 편집기 열기
알림에 설명된 대로 저장된 검색 또는 대시보드 차트의 알림 편집기를 엽니다.
2
이상 탐지 선택
Alert type에서 이상 탐지를 선택합니다. 기본값은 Static threshold입니다.
3
조건 구성
조건은 하나의 문장 형태로 표시됩니다: Alert when z-score is at least
3 when value is outside expected range compared to the past 2 hours checked every 5 minute.- z-score is at least (기본값
3): 값이 예상값에서 표준편차의 몇 배만큼 벗어나야 이상치로 간주할지를 지정합니다. 최솟값은 0.5이며, 화살표를 누르면 0.5씩 증감합니다. 값이 낮을수록 민감도가 높아져 알림이 더 자주 발생합니다. - When value is (기본값
outside expected range): 알림을 보낼 방향을above expected,below expected,outside expected range중에서 지정합니다. 오류 수와 지연 시간에는above expected를, 처리량이나 가입 수에는below expected를 사용하십시오. - Compared to the past (기본값 2시간): ClickStack이 정상 변동 폭을 측정하는 데 사용하는 이력 기간으로, 30분 또는 1, 2, 4, 6, 12, 24시간 중에서 선택합니다. 기준 기간이 길수록 범위가 안정적이지만, 새로운 정상 상태에 적응하는 속도는 느려집니다.
- Checked every (기본값 5분): 알림을 평가하는 주기로, 5분, 15분, 30분 또는 1시간 중에서 선택합니다. 이상 탐지 알림에서는 이보다 짧거나 긴 인터벌을 사용할 수 없습니다.
4
백테스트 및 프리뷰 검토
요약 아래의 줄은 백테스트 결과입니다. 백테스트는 현재 설정을 최근 이력에 재적용하여 알림이 몇 번 발생했을지를 보여 줍니다. 예: “Would have notified 6 times in the past 24 hours, firing on 12 of 288 checks.” 검색 알림의 백테스트는 최근 24시간을 대상으로 합니다. 대시보드 차트 알림은 차트에서 선택한 시간 범위를 최대 24시간까지 대상으로 합니다. 알림이 하루 10회를 초과하여 발생할 것으로 예상되면 횟수가 노란색으로 표시됩니다.양식 아래의 이상 탐지 chart에는 동일한 범위가 표시됩니다:
- 실선은 시계열입니다.
- 점선은 예상 기준값입니다.
- 음영 영역은 알림 트리거 구역입니다. 값이 예상 범위를 벗어나 이 영역 안에 들어가면 알림이 발생합니다.
- Notify 표식은 알림이 전송되었을 지점을 나타냅니다.
5
알림 채널 선택 및 저장
다른 알림과 마찬가지로 웹훅 또는 다른 채널을 선택합니다. 웹훅 추가를 참조하십시오. 알림을 저장하면 평가가 시작됩니다.
적합성 경고
일부 시계열은 이상 탐지에 적합하지 않습니다. 이런 경우 저장하기 전에 프리뷰 차트 아래에 경고가 표시되지만, 저장 자체가 차단되지는 않습니다.이상 탐지 작동 방식
ClickStack은 평가할 때마다 평가 윈도우를 버킷 하나씩 차례로 점수화합니다. 각 버킷의 길이는 60초입니다. 각 버킷에 대해 다음 과정을 수행합니다.- 예상값. ClickStack은 평가 윈도우 하나만큼 이전 시점에 끝나는 7개 버킷의 이동 평균을 구합니다. 예상값은 음수가 되지 않습니다.
- 분산 정도. ClickStack은 Compared to the past에서 선택한 기준 기간 동안 시계열의 표준편차를 ClickHouse에서 계산합니다. 기준 기간은 평가 윈도우 하나보다 짧아지지 않습니다.
- z-score. z-score는
(value − expected) / standard deviation입니다. - 판정. z-score가 구성된 방향으로 구성된 임계값을 넘고, 값과 예상값의 차이가 예상값의 5% 이상(예상값이 0이면 0.01 이상)이면 해당 버킷에서 알림이 발생합니다. 이 5% 하한은 거의 일정한 시계열이 사소한 변동만으로 알림을 발생시키지 않도록 합니다.
expected ± z-score × standard deviation이며, 5% 하한만큼 더 넓어집니다. 프리뷰에서는 이 범위를 벗어난 모든 영역이 알림 트리거 구역으로 음영 처리됩니다.
평가 윈도우에 속한 버킷 중 하나라도 알림이 발생하면 해당 평가 윈도우에서 알림이 발생합니다.
빈 버킷
ClickStack이 데이터가 없는 1분 구간을 처리하는 방식은 집계 유형에 따라 다릅니다.- 개수 및 합계(검색 알림 포함): 빈 버킷은 0으로 평가됩니다. 따라서 방향이
below expected또는outside expected range인 알림은 트래픽이 완전히 끊기면 발생합니다. - 평균, 백분위수, 최솟값, 최댓값, 비율 및 메트릭 소스: 빈 버킷은 측정할 대상이 없었다는 뜻이므로 0으로 평가하지 않고 건너뜁니다.
그룹화된 알림
알림을ServiceName과 같은 필드로 그룹화하면 각 그룹은 자체 예상 범위와 알림 상태를 갖는 별도의 시계열이 됩니다. ClickStack은 알림당 최대 100개의 시계열에 점수를 매기며, 데이터가 가장 많은 시계열을 우선합니다. 이미 알림이 발생 중인 시계열은 상위 100개 밖으로 밀려나더라도 해결될 때까지 계속 점수가 매겨집니다.
알림 및 해소
이상 탐지 알림은 시계열별로 인시던트당 한 번만 전송됩니다.- 시계열이 발생(firing) 상태가 되면 ClickStack은 알림을 한 번 보내고 해당 시계열을 알림 상태로 표시합니다.
- 이후 평가에서도 시계열이 계속 발생 상태이면 추가 알림을 보내지 않습니다.
- 평가 윈도우에 발생 상태인 버킷이 하나도 없으면 시계열이 해소되고, ClickStack은 해소 알림을 보냅니다.
- 제목:
Alert for "Checkout errors" - value 142 is above the expected range (z-score 4.4) - 본문:
Value 142 is above the expected range — z-score 4.4 vs sensitivity 3; expected 120 ± 5 (expected range 105 to 135).
{{anomaly.value}}, {{anomaly.expectedValue}}, {{anomaly.expectedStddev}}, {{anomaly.lowerBound}}, {{anomaly.upperBound}}, {{anomaly.zScore}}를 사용하여 알림을 트리거한 버킷을 참조할 수 있습니다. 이 값들은 발생 알림에서만 설정되며 해소 알림에는 포함되지 않습니다. 따라서 동일한 이름이나 메시지를 두 알림에 모두 사용한다면 {{#if anomaly}}...{{/if}}로 감싸십시오.
이상 탐지 알림 모니터링
Alerts 페이지에서 Filter by type을 Anomaly로 설정하면 이상 탐지 알림만 표시됩니다. 각 행에는 “If value is above expected with z-score at least 3”과 같은 조건이 표시됩니다. 알림을 선택하면 상세 페이지가 열립니다. ClickStack은 인터벌과 기준값이 포함된 조건 요약 아래에 보존된 이력 기간 동안 알림이 몇 번 발생했는지를 “Fired 2 times in the past 2 days.”와 같은 형식으로 표시합니다. 이 범위를 선택하면 해당 기간이 차트와 평가 이력에 표시됩니다. Evaluation History 테이블에는 각 검사의 상태(state), 최신 값, 알림 상태였던 시계열 수가 나열됩니다. 알림 소요 시간이 표시된 행은 알림이 발생했을 때와 해소되었을 때 모두 알림이 전송되었음을 의미합니다. 알림이 연속된 윈도우 20개 이상 동안 알림 상태로 유지되면, 상세 페이지에는 해당 시계열이 이상 징후가 아니라 새로운 정상 상태에 도달했을 수 있다는 안내가 표시됩니다. 이 경우 z-score를 높이거나, 더 적절한 기준값과 비교하도록 알림을 수정하십시오.MCP를 활용한 백테스트
ClickStack MCP 서버를 사용하면 AI 어시스턴트가 이상 탐지 설정을 저장하기 전에 미리 백테스트할 수 있습니다.clickstack_backtest_anomaly_alert 도구는 최대 24시간 분량의 이력에 구성을 재적용한 뒤, 시계열별로 발송되었을 알림을 데이터 품질 경고와 함께 보고합니다. 이 도구는 읽기 전용입니다.
튜닝 팁
- 알림이 너무 자주 발생하는 경우: z-score를 0.5 단위로 높이거나, 방향을
outside expected range에서 중요하게 보는 쪽으로 변경하십시오. - 알림이 실제 장애를 놓친 경우: z-score를 낮추거나 기준값 기간을 줄여 범위가 최근 동작을 반영하도록 하십시오.
- 배포 후 하루 종일 알림이 발생하는 경우: 시계열의 정상 수준이 새로 바뀐 것입니다. 기준값 기간이 길수록 새로운 수준에 적응하는 데 더 오래 걸립니다.
- 데이터량이 적은 시계열: 각 시계열에 분당 최소 1개의 이벤트가 있도록 더 적은 차원(dimensions)으로 그룹화하거나, 더 넓은 범위의 검색을 대상으로 알림을 설정하십시오.