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

SLO에 대한 API 가용성 측정

일일 가용성을 계산하고 서비스가 명시적인 목표를 충족했는지 여부를 표시합니다.

중급api_requests검토됨 2026-07-27테스트됨 아파치 DataFusion 45.2.0

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

질문에 답변됨

각 서비스가 일일 가용성 목표를 충족했나요?

SLO는 신뢰성 비율을 결정 경계로 전환합니다. 좋은 이벤트, 전체 이벤트, 목표를 함께 유지하면 규정 준수 검토를 감사할 수 있습니다.

이벤트 계약

쿼리가 예상하는 필드

필드유형그것이 존재하는 이유
timestamp_utcTimestamp요청 완료 시간.
serviceUtf8안정적인 서비스 이름입니다.
slo_eligibleBoolean요청이 SLO 분모에 속하는지 여부입니다.
slo_goodBoolean요청이 SLO를 충족했는지 여부입니다.
DataFusion SQL

쿼리 복사

sql
SELECT
  date_trunc('day', timestamp_utc) AS day,
  service,
  SUM(CASE WHEN slo_eligible THEN 1 ELSE 0 END) AS eligible_requests,
  SUM(CASE WHEN slo_eligible AND slo_good THEN 1 ELSE 0 END)
    AS good_requests,
  100.0 * SUM(CASE WHEN slo_eligible AND slo_good THEN 1 ELSE 0 END)
    / NULLIF(SUM(CASE WHEN slo_eligible THEN 1 ELSE 0 END), 0)
    AS availability_pct,
  99.9 AS objective_pct
FROM api_requests
WHERE timestamp_utc >= now() - INTERVAL '30 days'
GROUP BY date_trunc('day', timestamp_utc), service
HAVING SUM(CASE WHEN slo_eligible THEN 1 ELSE 0 END) > 0
ORDER BY day, service;

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

쿼리 결과

일일 서비스 이용 가능 여부

7월 26일 쿼리 API는 99.9% 목표를 달성하지 못했습니다.

dayserviceeligible_requestsgood_requestsavailability_pctobjective_pct
2026-07-25query_api182,400182,27499.9399.9
2026-07-26query_api176,820176,50199.8299.9
2026-07-27ingestion_api248,100247,97699.9599.9

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

Daily service availability: Measure API Availability Against an SLO 예제 결과의 합성 availability_pct 값에 대한 정적 차트
결정론적 예제 출력의 색인 생성 가능한 SVG입니다. 기사, 런북 또는 저작자가 포함된 디자인 검토를 위해 다운로드하세요.

예제 재현

공공 픽스처 다운로드

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

SQL 작동 방식

  1. 1명시적 자격은 상태 확인이나 지원되지 않는 트래픽으로부터 분모를 보호합니다.
  2. 2slo_good는 목표에 정확성과 대기 시간이 모두 필요한 경우 정확성과 대기 시간을 모두 인코딩할 수 있습니다.
  3. 3목표는 관찰된 값 옆에 반환되므로 차트와 리뷰는 결정 경계를 유지합니다.

결정해야 할 극단적인 경우

  • 페이징 및 규정 준수 보고서에 전체 시간 버킷을 사용합니다.
  • 자동 분모 변경을 통해 SLO가 개선되지 않도록 제외된 트래픽을 문서화하세요.
  • 일일 보기는 검토에 유용합니다. 빠른 오류 예산 알림에는 일반적으로 더 짧은 창이 필요합니다.

추천 대시보드

  • 추세: 대물렌즈가 있는 availability_pct
  • 통계: 선택한 기간의 규정 준수 일수
  • 표: 놓친 서비스 날짜에 대한 나쁜 이벤트

알림 안내

페이징에는 다중 창 오류 예산 소진 알림을 사용하고 규정 준수 검토에는 이 일일 보기를 사용하세요.

알림 설정 읽기

레시피를 활용해 보세요

관련 계측 및 가이드

분석 계속하기

실제 이벤트에서 실행

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

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

API 키 받기