콘텐츠로 이동

애플리케이션 성능 지표 탐지


현재 문서 안내

이 문서는 탐지 규칙 구성 프로세스의 두 번째 단계입니다. 구성을 완료한 후 메인 문서로 돌아가 3단계: 이벤트 알림 계속하기를 진행하세요.

데이터 범위: 트레이스(T)이며, 워크스페이스 내 APM의 핵심 지표 데이터를 모니터링하는 데 사용されます。시스템은 지정된 시간 내 조건을 충족하는 트레이스 수를 집계하며, 사용자 지정 임계값을 초과하면 이상 이벤트를 생성합니다.

탐지 구성

탐지 주기

탐지를 실행하는 시간 주기를 설정합니다.

  • 사전 설정 옵션: 1분, 5분, 10분, 15분, 30분, 1시간

  • Crontab 모드: “Crontab 모드로 전환”을 클릭하여 사용자 지정 주기를 구성할 수 있으며, 초, 분, 시간, 일, 월, 주 등의 주기를 기반으로 예약 작업 실행을 구성할 수 있습니다.

탐지 구간

각 탐지 시 조회할 데이터 시간 범위를 설정합니다(❗️탐지 구간은 탐지 주기보다 크거나 같아야 하며, 실제 데이터 보고 주기와 일치해야 탐지 누락이나 오탐을 방지할 수 있습니다).

탐지 주기 탐지 구간(드롭다운 옵션)
30s 1m/5m/15m/30m/1h/3h
1m 1m/5m/15m/30m/1h/3h
5m 5m/15m/30m/1h/3h
15m 15m/30m/1h/3h/6h
30m 30m/1h/3h/6h
1h 1h/3h/6h/12h/24h
6h 6h/12h/24h
12h 12h/24h
24h 24h
  • 사용자 지정 형식: 탐지 구간을 직접 입력합니다. 예: 20m(최근 20분), 2h(최근 2시간), 1d(최근 1일).

탐지 지표

탐지 데이터의 지표를 설정하며, 두 가지 탐지 모드를 지원합니다.

  • 서비스 지표

  • 트레이스 통계

주의

고카디널리티 필드를 탐지 차원으로 선택하지 마세요. 구성이 부적절하여 트리거 조건이 지나치게 완화되면 빈번한 알림이 발생할 수 있습니다. 현재 쿼리의 최대 반환 수는 10만 개 레코드입니다.

서비스 지표

현재 워크스페이스 내의 APM 서비스를 모니터링합니다.

구성 항목 설명
서비스 현재 워크스페이스 내의 APM 서비스를 선택하며, “전체” 또는 지정된 서비스를 선택할 수 있습니다.
지표 구체적인 탐지 지표: 요청 수, 오류 요청 수, 요청 오류율, 초당 평균 요청 수, 평균 응답 시간, P50 응답 시간, P75 응답 시간, P90 응답 시간, P99 응답 시간
필터 조건 지표의 태그를 기반으로 탐지 데이터를 필터링하여 탐지 범위를 제한합니다. 하나 이상의 태그 필터를 추가할 수 있으며, 부분 일치 및 부분 불일치 필터 조건을 지원합니다.
탐지 차원 구성 데이터의 문자열 유형(keyword) 필드를 탐지 차원으로 선택할 수 있으며, 현재 최대 세 개의 필드를 선택할 수 있습니다. 여러 탐지 차원 필드의 조합을 통해 특정 탐지 대상(예: {service: svc1, host: host1})을 결정할 수 있습니다.
추가 정보 추가로 표시할 필드 정보를 선택하여 이벤트 내용을 풍부하게 합니다.

트레이스 통계

지정된 시간 내 조건을 충족하는 트레이스(Span) 수를 집계하며, 사용자 지정 임계값을 초과하면 이상 이벤트를 트리거합니다. 서비스 트레이스의 이상 오류 알림에 사용할 수 있습니다.

구성 항목 설명
소스 집계할 트레이스 데이터 소스(서비스)를 선택하며, 키워드 입력 필터를 지원합니다.
필터 조건 태그로 트레이스 span을 필터링하여 탐지할 데이터 범위를 제한합니다. 하나 이상의 태그 필터 조건을 추가할 수 있습니다.
집계 알고리즘 기본값은 *이며, 해당 집계 함수는 count(Span 수 집계)입니다. 다른 필드를 선택하면 집계 함수가 자동으로 count distinct(키워드가 나타나는 데이터 포인트 수 집계, 즉 중복 제거 집계)로 변경됩니다.
탐지 차원 구성 데이터의 문자열 유형(keyword) 필드를 탐지 차원으로 선택할 수 있으며, 현재 최대 세 개의 필드를 선택할 수 있습니다. 여러 탐지 차원 필드의 조합을 통해 특정 탐지 대상을 결정할 수 있습니다.

트리거 조건

트리거 조건 및 심각도를 구성합니다. 쿼리 결과가 여러 값인 경우, 어느 하나의 값이 트리거 조건을 충족하면 이벤트가 생성됩니다.

치명, 심각, 중요, 경고의 4단계 임계값과 정상 복구 조건을 구성할 수 있습니다.

등급 구성 설명
치명 Result >= [값]일 때 최고 등급 알림이며 즉시 처리해야 합니다.
심각 Result >= [값]일 때 높은 등급 알림이며 우선 처리해야 합니다.
중요 Result >= [값]일 때 중간 등급 알림이며 주의 깊게 확인해야 합니다.
경고 Result >= [값]일 때 낮은 등급 알림이며 유의해야 합니다.
정상 [N]회 탐지 동안 이벤트가 생성되지 않음 탐지 지표가 “치명”, “심각”, “중요”, “경고” 이상 이벤트를 트리거한 후 연속 N회 탐지가 모두 정상이면 “정상” 이벤트가 생성됩니다. 이상 이벤트가 정상으로 복구되었는지 판단하는 데 사용되며, 구성을 권장합니다.

자세한 내용은 이벤트 등급 설명을 참고하세요.

고급 옵션

연속 트리거 판단

활성화하면 트리거 조건을 지속적으로 충족할 때만 이벤트가 생성되어 순간적인 변동으로 인한 오탐을 방지합니다(❗️최대 구성 상한은 10회입니다).

대량 알림 보호

시스템에서 기본적으로 활성화됩니다.

단일 탐지에서 생성된 알림 수가 사전 설정된 임계값을 초과하면 시스템이 자동으로 상태별 요약 정책으로 전환합니다. 더 이상 알림 대상을 하나씩 처리하지 않고, 이벤트 상태에 따라 소량의 요약 알림을 생성하여 푸시합니다.

이렇게 하면 알림의 적시성을 보장하면서 알림 노이즈를 크게 줄이고, 과도한 알림 처리로 인한 타임아웃 위험을 방지할 수 있습니다.

이 스위치를 활성화하면 이후 모니터가 이상을 탐지한 후 생성되는 이러한 이벤트 상세에는 이력 및 연결된 이벤트가 표시되지 않습니다.

복구 조건

복구 조건 및 심각도를 구성합니다. 쿼리 결과가 여러 값인 경우, 임의의 값이 트리거 조건을 충족하면 복구 이벤트가 생성됩니다.

등급별로 독립적인 복구 임계값을 설정하여 단계적 복구를 구현합니다. 예: 심각 알림은 값이 70 미만으로 떨어져야 복구되고, 중요 알림은 80 미만이면 복구됩니다.

기본 복구 로직

등급별 복구 조건 구성을 활성화하지 않은 경우, 기본적으로 탐지 결과가 트리거 조건을 충족하지 않으면 자동으로 복구됩니다.

데이터 공백

탐지 지표가 탐지 구간 내에서 쿼리 결과가 비어 있을 때의 처리 정책:

옵션 설명
이벤트 트리거 안 함(기본값) 데이터가 없을 때 알림을 생성하지 않으며, 데이터 누락이 허용되는 시나리오에 적합합니다.
쿼리 결과를 0으로 간주 빈 데이터를 0 값으로 간주하여 임계값을 판정합니다.
데이터 공백 이벤트 트리거 동일 객체에 대해 매 회차 공백이 발생할 때마다 데이터 공백 이벤트를 한 번 생성하며, 복구 후 다시 공백이 발생하면 재생성할 수 있습니다.
데이터 공백 이벤트 지속 트리거 동일 객체가 공백 조건을 지속적으로 충족하면 탐지 주기에 따라 공백 이벤트를 생성하며, 데이터가 복구될 때까지 반복합니다. 구성 방법은 데이터 공백을 참고하세요.
치명 이벤트 트리거 데이터가 없을 때 치명 등급 이벤트를 트리거합니다.
심각 이벤트 트리거 데이터가 없을 때 심각 등급 이벤트를 트리거합니다.
중요 이벤트 트리거 데이터가 없을 때 중요 등급 이벤트를 트리거합니다.
경고 이벤트 트리거 데이터가 없을 때 경고 등급 이벤트를 트리거합니다.
복구 이벤트 트리거 데이터가 없을 때 복구 이벤트를 트리거합니다.

트리거 조건, 데이터 공백, 정보 생성을 동시에 구성한 경우 다음 우선순위에 따라 트리거를 판단합니다: 데이터 공백 > 트리거 조건 > 정보 이벤트 생성.

즉, 먼저 공백 여부를 판단하고, 다음으로 임계값 트리거 여부를 판단하며, 마지막으로 정보 이벤트 생성 여부를 판단합니다.

정보 생성

이 옵션을 활성화하면 정보 생성 조건을 구성해야 합니다. 탐지 결과가 “치명”, “심각”, “중요”, “경고” 중 어느 임계값도 트리거하지 않았고 정보 생성 조건을 충족하는 경우에만 시스템이 “정보” 이벤트를 기록합니다.

정상 상태 변화나 낮은 우선순위 정보를 기록해야 하는 시나리오에 적합합니다.

후속 구성

위 탐지 구성을 완료한 후 다음을 계속 구성하세요.

  1. 이벤트 알림: 이벤트 제목, 내용, 알림 대상, 데이터 공백 처리 및 연결된 인시던트를 정의합니다.
  2. 알림 구성: 알림 정책을 선택하고 알림 대상 및 음소거 주기를 설정합니다.
  3. 연결: 대시보드를 연결하여 데이터를 빠르게 이동해 확인할 수 있습니다.
  4. 권한: 작업 권한을 설정하여 이 모니터를 편집/삭제할 수 있는 사용자를 제어합니다.

문서 평가

이 페이지가 도움이 되었나요?