이벤트 계약
쿼리가 예상하는 필드
| 필드 | 유형 | 그것이 존재하는 이유 |
|---|---|---|
| timestamp_utc | Timestamp | 요청 완료 시간(UTC)입니다. |
| route_template | Utf8 | 안정적인 경로 템플릿. |
| latency_ms | Float64 | 요청 기간(밀리초)입니다. |
| status_code | Int64 | HTTP 응답 상태 코드입니다. |
DataFusion SQL
쿼리 복사
sql
SELECT
route_template,
COUNT(*) AS requests,
approx_percentile_cont(latency_ms, 0.50) AS p50_ms,
approx_percentile_cont(latency_ms, 0.95) AS p95_ms,
approx_percentile_cont(latency_ms, 0.99) AS p99_ms
FROM api_requests
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
AND status_code < 500
GROUP BY route_template
HAVING COUNT(*) >= 50
ORDER BY p95_ms DESC
LIMIT 10;이 읽기 전용 쿼리는 빈 유형의 테이블에 대해 계획되고 실행됩니다. 아파치 DataFusion 45.2.0. 결정론적 샘플 출력은 합성되어 별도로 검토됩니다. 자신의 데이터에 대해 필드 유형, 임계값 및 비즈니스 정의를 검증합니다. 테스트 방법론을 읽어보세요.
쿼리 결과
경로별 p95 대기 시간
내보내기 요청은 꼬리 지연 시간이 가장 길며 일반적인 성능과 최악의 성능 사이 격차도 가장 큽니다.
/api/reports/export
800 ms
comparison 800 ms
/api/projects/:id/sync
320 ms
comparison 320 ms
/api/search
120 ms
comparison 120 ms
| route_template | requests | p50_ms | p95_ms | p99_ms |
|---|---|---|---|---|
| /api/reports/export | 50 | 800 | 800 | 800 |
| /api/projects/:id/sync | 50 | 320 | 320 | 320 |
| /api/search | 50 | 120 | 120 | 120 |
합성 예제 출력. 운영 결정에 사용하기 전에 자체 이벤트 스키마 및 임계값에 대해 쿼리를 실행하세요.
예제 재현
공공 픽스처 다운로드
JSON 번들은 타입이 지정된 이벤트 계약을 포함합니다. reproducible 입력 행, 정확한 SQL, 예상 출력, 검토 참고 사항 및 엔진 버전. CSV에는 표시된 결과가 포함됩니다.
SQL 작동 방식
- 1approx_percentile_cont는 대규모 이벤트 테이블에 효율적인 DataFusion의 t-digest 구현을 사용합니다.
- 25xx 응답을 필터링하면 성공적인 요청 대기 시간 보기가 됩니다. 실패 기간이 중요한 경우 별도의 실패한 요청 보기를 만듭니다.
- 3p50과 p95의 차이는 두 숫자 중 하나보다 더 유용한 경우가 많습니다. 간격이 넓으면 간헐적으로 느린 경로가 있음을 나타냅니다.
결정해야 할 극단적인 경우
- 경로 컨텍스트를 유지하지 않고 근본적으로 다른 작업과 엔드포인트를 비교하지 마세요.
- 스트리밍 경로와 장기 실행 내보내기에는 별도의 서비스 수준 목표가 필요할 수 있습니다.
- 지연 시간을 일관된 단위로 유지하고 숫자 필드를 사용하세요.
추천 대시보드
- 그룹화된 막대: p50_ms 및 p95_ms by route_template
- 꺾은선형 차트: 가장 느린 경로에 대한 시간 경과에 따른 p95_ms
- 표: 경로의 p99 위의 개별 요청
레시피를 활용해 보세요
관련 계측 및 가이드
소스 데이터 정의
이 분석을 위한 이벤트 스키마
분석 계속하기
실제 이벤트에서 실행
테이블을 만들고, 필드를 조정하고, 결과를 저장하세요.
무료로 시작하고, 구조화된 이벤트를 보내고, 쿼리 결과를 차트, 공유 대시보드 위젯 또는 알림 입력으로 사용하세요.