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

기능 출시 오류율 비교

한 릴리스에 대한 기능 플래그 출시와 제어 집단 간의 요청 오류와 평균 대기 시간을 비교합니다.

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

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

질문에 답변됨

기능 플래그 출시는 제어 코호트보다 안정성이 낮습니까?

롤아웃 결정에는 동일한 릴리스 경계에서 유사한 제어가 필요합니다. 이 쿼리는 각 기능 플래그 집단에 대한 요청, 오류, 오류율 및 대기 시간을 함께 유지하므로 작지만 중요한 안정성 회귀가 표시됩니다.

이벤트 계약

쿼리가 예상하는 필드

필드유형그것이 존재하는 이유
timestamp_utcTimestamp요청 완료 시간(UTC)입니다.
feature_flagUtf8제어되는 기능 플래그 이름입니다.
cohortUtf8롤아웃 또는 제어 할당.
releaseUtf8애플리케이션 릴리스 식별자입니다.
statusUtf8터미널 성공 또는 실패 상태.
latency_msInt64밀리초 단위의 엔드투엔드 요청 대기 시간입니다.
environmentUtf8배포 환경.
DataFusion SQL

쿼리 복사

sql
SELECT
  feature_flag,
  cohort,
  release,
  COUNT(*) AS requests,
  SUM(CASE WHEN status = 'failed' THEN 1 ELSE 0 END) AS errors,
  100.0 * SUM(CASE WHEN status = 'failed' THEN 1 ELSE 0 END)
    / NULLIF(COUNT(*), 0) AS error_rate_pct,
  AVG(latency_ms) AS avg_latency_ms
FROM feature_rollout_events
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
  AND environment = 'production'
GROUP BY feature_flag, cohort, release
ORDER BY error_rate_pct DESC, cohort;

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

쿼리 결과

동질 집단별 출시 오류율

합성 롤아웃 코호트는 실패율이 20%인 반면 대조군은 실패율이 없습니다.

feature_flagcohortreleaserequestserrorserror_rate_pctavg_latency_ms
new-checkoutrolloutapi-885120300
new-checkoutcontrolapi-88500200

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

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

예제 재현

공공 픽스처 다운로드

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

SQL 작동 방식

  1. 1기능 플래그, 집단 및 릴리스를 통해 롤아웃 경계에서 비교를 재현할 수 있습니다.
  2. 2오류율 외에 요청량은 확실한 결정을 내리기에는 너무 작은 비교를 노출시킵니다.
  3. 3출시는 오류 증가 없이 경험을 회귀할 수 있기 때문에 지연 시간은 동일한 결과로 유지됩니다.

결정해야 할 극단적인 경우

  • 할당은 동일한 계정이 비교 창 내에서 집단을 전환하지 않을 정도로 안정적이어야 합니다.
  • 동등한 트래픽과 고객 혼합을 비교하거나 검토된 제한된 차원을 기준으로 결과를 분류합니다.
  • 되돌릴 수 없는 제품 결론을 얻으려면 신뢰 구간과 더 긴 기간을 사용하십시오.

추천 대시보드

  • 막대: 코호트별 error_rate_pct
  • 추세: 출시 비율별 요청, 오류 및 지연 시간
  • 표: 릴리스별 기능 플래그 및 최소 샘플 상태

알림 안내

롤아웃이 검토된 최소 볼륨을 충족하고 승인된 오류 또는 대기 시간 가드레일을 초과한 후에만 일시 중지하거나 롤백합니다.

알림 설정 읽기

레시피를 활용해 보세요

관련 계측 및 가이드

소스 데이터 정의

이 분석을 위한 이벤트 스키마

분석 계속하기

실제 이벤트에서 실행

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

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

API 키 받기