이벤트 계약
쿼리가 예상하는 필드
| 필드 | 유형 | 그것이 존재하는 이유 |
|---|---|---|
| timestamp_utc | Timestamp | 브라우저 오류 시간(UTC)입니다. |
| route_template | Utf8 | 식별자가 없는 안정적인 클라이언트 측 경로입니다. |
| release | Utf8 | 프런트엔드 빌드 또는 릴리스 식별자입니다. |
| error_fingerprint | Utf8 | 정규화된 오류 클래스 및 프레임 서명. |
| session_id | Utf8 | 개인 정보가 보호되는 세션 식별자입니다. |
| environment | Utf8 | 배포 환경. |
DataFusion SQL
쿼리 복사
sql
SELECT
route_template,
release,
error_fingerprint,
COUNT(*) AS errors,
COUNT(DISTINCT session_id) AS affected_sessions
FROM frontend_error_events
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
AND environment = 'production'
GROUP BY route_template, release, error_fingerprint
ORDER BY affected_sessions DESC, errors DESC
LIMIT 20;이 읽기 전용 쿼리는 빈 유형의 테이블에 대해 계획되고 실행됩니다. 아파치 DataFusion 45.2.0. 결정론적 샘플 출력은 합성되어 별도로 검토됩니다. 자신의 데이터에 대해 필드 유형, 임계값 및 비즈니스 정의를 검증합니다. 테스트 방법론을 읽어보세요.
쿼리 결과
프런트엔드 오류로 인해 영향을 받은 세션
결제 렌더링 오류는 세션에 가장 큰 영향을 미치고 반복 횟수도 가장 높습니다.
payment-form-render
121
comparison 184
editor-state-null
74
comparison 96
result-card-image
51
comparison 58
| route_template | release | error_fingerprint | errors | affected_sessions |
|---|---|---|---|---|
| /checkout | web-103 | payment-form-render | 184 | 121 |
| /projects/:id | web-103 | editor-state-null | 96 | 74 |
| /search | web-102 | result-card-image | 58 | 51 |
합성 예제 출력. 운영 결정에 사용하기 전에 자체 이벤트 스키마 및 임계값에 대해 쿼리를 실행하세요.
예제 재현
공공 픽스처 다운로드
JSON 번들은 타입이 지정된 이벤트 계약을 포함합니다. illustrative 입력 행, 정확한 SQL, 예상 출력, 검토 참고 사항 및 엔진 버전. CSV에는 표시된 결과가 포함됩니다.
SQL 작동 방식
- 1경로 템플릿과 표준화된 지문은 URL 및 스택 라인 세부 정보가 하나의 오류로 인해 조각화되는 것을 방지합니다.
- 2개별 세션은 하나의 손상된 브라우저 세션에서 반복되는 오류와 별도로 폭발 반경을 추정합니다.
- 3릴리스 그룹화를 사용하면 최신 빌드로 인해 모든 현재 오류가 발생했다고 가정하지 않고도 회귀를 볼 수 있습니다.
결정해야 할 극단적인 경우
- 브라우저 오류 이벤트에서 원시 페이지 콘텐츠, 양식 값, 액세스 토큰 또는 전체 URL을 보내지 마세요.
- 소스 맵 및 지문 변경으로 인해 동일한 결함이 여러 릴리스에 걸쳐 분할될 수 있습니다.
- 시간이 지남에 따라 개수를 비교하는 경우 샘플링은 문서화된 비율을 유지해야 합니다.
추천 대시보드
- 막대: 오류 지문별 affected_sessions
- 추세: 릴리스별 오류
- 표: 안전한 브라우저 컨텍스트의 최신 오류
레시피를 활용해 보세요
관련 계측 및 가이드
분석 계속하기
실제 이벤트에서 실행
테이블을 만들고, 필드를 조정하고, 결과를 저장하세요.
무료로 시작하고, 구조화된 이벤트를 보내고, 쿼리 결과를 차트, 공유 대시보드 위젯 또는 알림 입력으로 사용하세요.