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

경로별 API 요청 처리량 계산

안정적인 API 경로를 통해 관찰된 분당 요청을 계산하고 처리량 외에 오류 볼륨을 유지합니다.

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

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

질문에 답변됨

분당 가장 많은 요청을 처리하는 API 경로는 무엇입니까?

처리량은 경로 형태와 실제로 관찰된 시간을 보존할 때 가장 유용합니다. 이 쿼리는 전체 대시보드 창에서 모든 경로가 활성화되었다고 가정하는 대신 요청 볼륨을 각 경로의 관찰된 범위로 나눕니다.

이벤트 계약

쿼리가 예상하는 필드

필드유형그것이 존재하는 이유
timestamp_utcTimestamp요청 완료 시간(UTC)입니다.
route_templateUtf8제한된 경로 템플릿이며 원시 URL이 아닙니다.
status_codeInt64HTTP 응답 상태.
environmentUtf8배포 환경.
DataFusion SQL

쿼리 복사

sql
SELECT
  route_template,
  COUNT(*) AS requests,
  SUM(CASE WHEN status_code >= 500 THEN 1 ELSE 0 END) AS errors,
  60.0 * COUNT(*) / NULLIF(
    date_part('epoch', MAX(timestamp_utc) - MIN(timestamp_utc)),
    0
  ) AS requests_per_minute
FROM api_throughput_events
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
  AND environment = 'production'
GROUP BY route_template
ORDER BY requests_per_minute DESC, route_template;

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

쿼리 결과

경로별로 관찰된 요청 처리량

검색은 관찰된 요청 비율이 가장 높으며 조사할 응답도 5xx입니다.

route_templaterequestserrorsrequests_per_minute
/api/search610.2
/api/checkout400.13

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

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

예제 재현

공공 픽스처 다운로드

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

SQL 작동 방식

  1. 1제어된 경로 템플릿을 그룹화하면 리소스 식별자 또는 쿼리 문자열당 하나의 시리즈가 방지됩니다.
  2. 2분모는 각 경로에 대해 관찰된 범위를 사용합니다. 이는 전체 전환 확인 기간으로 나누는 것보다 희박한 경로의 경우 더 안전합니다.
  3. 3오류 개수는 결과에 그대로 유지되므로 트래픽 급증을 동일한 수준의 안정성과 비교할 수 있습니다.

결정해야 할 극단적인 경우

  • 프로덕션 차트의 경우 전체 고정 시간 버킷으로 집계하여 인접 기간을 직접 비교할 수 있습니다.
  • 하나의 요청이 있는 경로에는 관찰된 범위가 없습니다. NULLIF는 요율을 생성하는 대신 null을 반환합니다.
  • 고객 요구를 왜곡할 수 있는 경우 내부 상태 점검과 합성 트래픽을 분리하세요.

추천 대시보드

  • 추세: 전체 5분 버킷의 분당 요청 수
  • 바: requests_per_minute by route_template
  • 오버레이: 오류율 및 배포 마커

알림 안내

단일 대용량 경로가 아닌 검토된 기준선에서 지속적으로 벗어나는 경우 알림합니다.

알림 설정 읽기

레시피를 활용해 보세요

관련 계측 및 가이드

분석 계속하기

실제 이벤트에서 실행

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

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

API 키 받기