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

경로별 API 시간 초과 비율 계산

요청량과 구성된 시간 초과 경계를 유지하면서 시간 초과 비율을 기준으로 경로 순위를 지정합니다.

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

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

질문에 답변됨

사용자에게 영향을 미칠 만큼 자주 시간 초과되는 API 경로는 무엇입니까?

시간 초과는 여러 상태 코드 또는 클라이언트 연결 끊김으로 나타날 수 있으므로 고유한 비율을 가질 자격이 있습니다. 정규화된 결과 필드를 사용하면 비교할 수 있습니다.

이벤트 계약

쿼리가 예상하는 필드

필드유형그것이 존재하는 이유
timestamp_utcTimestamp요청 완료 시간.
route_templateUtf8안정적인 일치 경로.
outcomeUtf8성공, 오류, 시간 초과, 취소됨 또는 rate_limited.
latency_msFloat64관찰된 요청 기간.
DataFusion SQL

쿼리 복사

sql
SELECT
  route_template,
  COUNT(*) AS requests,
  SUM(CASE WHEN outcome = 'timeout' THEN 1 ELSE 0 END) AS timeouts,
  100.0 * SUM(CASE WHEN outcome = 'timeout' THEN 1 ELSE 0 END)
    / NULLIF(COUNT(*), 0) AS timeout_rate_pct,
  approx_percentile_cont(latency_ms, 0.95) AS p95_latency_ms
FROM api_requests
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
GROUP BY route_template
HAVING COUNT(*) >= 50
ORDER BY timeout_rate_pct DESC, requests DESC
LIMIT 20;

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

쿼리 결과

경로별 시간 초과 비율

보고서 내보내기에는 총 5xx 속도가 숨겨질 수 있는 시간 초과 문제가 있습니다.

route_templaterequeststimeoutstimeout_rate_pctp95_latency_ms
/api/reports/export780313.9729,400
/api/projects/:id/sync2,410220.918,420
/api/search12,14090.07680

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

Timeout rate by route: Calculate API Timeout Rate by Route 예제 결과의 합성 timeout_rate_pct 값에 대한 정적 차트
결정론적 예제 출력의 색인 생성 가능한 SVG입니다. 기사, 런북 또는 저작자가 포함된 디자인 검토를 위해 다운로드하세요.

예제 재현

공공 픽스처 다운로드

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

SQL 작동 방식

  1. 1정규화된 결과는 서버 기한, 게이트웨이 시간 초과 및 처리된 클라이언트 시간 초과 경로를 캡처합니다.
  2. 2최소 요청 임계값은 드물게 발생하는 시간 초과가 순위를 좌우하는 것을 방지합니다.
  3. 3시간 초과 비율 외에 p95 대기 시간은 갑작스러운 기한 실패와 지속적으로 느린 작업을 구별하는 데 도움이 됩니다.

결정해야 할 극단적인 경우

  • 클라이언트 연결 끊김 및 서버 기한에는 다른 결과 값이 필요할 수 있습니다.
  • 장기 실행 내보내기는 대화형 경로와 다른 서비스 목표를 가질 수 있습니다.
  • 경로나 고객이 다른 시간 초과 정책을 사용할 때 구성된 기한을 기록합니다.

추천 대시보드

  • 바: timeout_rate_pct by route_template
  • 추세: 시간 초과 볼륨 및 p95 대기 시간
  • 표: 종속성 및 릴리스 컨텍스트가 포함된 최신 시간 초과 요청

알림 안내

경로가 의미 있는 요청 볼륨에서 시간 초과 비율 목표를 초과하면 알림합니다.

알림 설정 읽기

레시피를 활용해 보세요

관련 계측 및 가이드

분석 계속하기

실제 이벤트에서 실행

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

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

API 키 받기