콘텐츠로 건너뛰기
Telemetry
API 신뢰성 SQL 레시피

고객 영향에 따른 순위 오류 지문

하나의 재시도 루프가 사건 보기를 지배하도록 하는 대신 발생 및 영향을 받는 계정을 기준으로 정규화된 응용 프로그램 오류의 순위를 지정합니다.

초보자api_requests검토됨 2026-07-27테스트됨 아파치 DataFusion 45.2.0

검토자 Telemetry 제품 팀 . SQL 호환성, 이벤트 계약, 합성 출력 및 운영상의 주의사항. 표준 및 소유권 검토

질문에 답변됨

어떤 오류 그룹이 대부분의 고객 계정에 영향을 미치나요?

오류 지문은 동등한 오류를 그룹화합니다. 이벤트와 개별 계정을 모두 계산하면 시끄러운 반복과 광범위한 고객 영향이 분리됩니다.

이벤트 계약

쿼리가 예상하는 필드

필드유형그것이 존재하는 이유
timestamp_utcTimestamp실패 시간.
error_fingerprintUtf8안정적인 정규화된 오류 그룹.
team_idUtf8안전한 영향을 받는 계정 식별자입니다.
status_codeInt64HTTP 상태 코드.
DataFusion SQL

쿼리 복사

sql
SELECT
  error_fingerprint,
  COUNT(*) AS occurrences,
  COUNT(DISTINCT team_id) AS affected_teams
FROM api_requests
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
  AND status_code >= 500
  AND error_fingerprint IS NOT NULL
GROUP BY error_fingerprint
ORDER BY affected_teams DESC, occurrences DESC
LIMIT 20;

이 읽기 전용 쿼리는 빈 유형의 테이블에 대해 계획되고 실행됩니다. 아파치 DataFusion 45.2.0. 결정론적 샘플 출력은 합성되어 별도로 검토됩니다. 자신의 데이터에 대해 필드 유형, 임계값 및 비즈니스 정의를 검증합니다. 테스트 방법론을 읽어보세요.

쿼리 결과

오류 지문으로 인해 영향을 받는 팀

세금 서비스 시간 초과는 OAuth 오류보다 반복이 적지만 영향은 훨씬 더 넓습니다.

error_fingerprintoccurrencesaffected_teams
checkout.tax_service_timeout18473
sync.oauth_token_expired92018
report.pdf_render_failed4416

합성 예제 출력. 운영 결정에 사용하기 전에 자체 이벤트 스키마 및 임계값에 대해 쿼리를 실행하세요.

Affected teams by error fingerprint: Rank Error Fingerprints by Customer Impact 예제 결과의 합성 affected_teams 값에 대한 정적 차트
결정론적 예제 출력의 색인 생성 가능한 SVG입니다. 기사, 런북 또는 저작자가 포함된 디자인 검토를 위해 다운로드하세요.

예제 재현

공공 픽스처 다운로드

JSON 번들은 타입이 지정된 이벤트 계약을 포함합니다. illustrative 입력 행, 정확한 SQL, 예상 출력, 검토 참고 사항 및 엔진 버전. CSV에는 표시된 결과가 포함됩니다.

SQL 작동 방식

  1. 1안정적인 지문은 요청 ID 및 기타 일시적인 메시지 조각을 제거해야 합니다.
  2. 2COUNT DISTINCT team_id는 폭을 측정하고 발생은 반복을 측정합니다.
  3. 3영향을 받은 계정별로 정렬하면 첫 번째 분류 보기가 사용자 영향에 더 가까워집니다.

결정해야 할 극단적인 경우

  • 전체 원시 오류 메시지를 해싱하면 식별자가 변경될 때마다 새 그룹이 생성됩니다.
  • 익명 또는 인증되지 않은 요청에는 다른 영향 차원이 필요합니다.
  • 그룹화 필드에 원시 스택 추적이나 개인 데이터를 포함하지 마세요.

추천 대시보드

  • 바: 지문별 affected_teams
  • 표: 발생 횟수 및 최신 릴리스
  • 추세: 시간 경과에 따른 상위 지문

알림 안내

모든 개별 예외가 아닌 여러 계정에 영향을 미치는 새로운 지문에 대해 알림합니다.

알림 설정 읽기

레시피를 활용해 보세요

관련 계측 및 가이드

분석 계속하기

실제 이벤트에서 실행

테이블을 만들고, 필드를 조정하고, 결과를 저장하세요.

무료로 시작하고, 구조화된 이벤트를 보내고, 쿼리 결과를 차트, 공유 대시보드 위젯 또는 알림 입력으로 사용하세요.

API 키 받기