콘텐츠로 건너뛰기
Telemetry
수익 및 청구 SQL 레시피

계정별 사용 할당량 계산

각 계정에 포함된 월별 할당량을 기준으로 청구 가능 단위를 측정하고 초과분에 근접한 계정의 순위를 지정합니다.

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

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

질문에 답변됨

이번 달에 포함된 사용량을 가장 빨리 소비하는 계정은 무엇입니까?

사용량 기반 청구에는 안정적인 단위, 멱등성 미터 이벤트, 사용량 발생 시 적용된 할당량이 필요합니다. 이 쿼리는 원시 이벤트 수를 청구 가능한 사용량으로 처리하지 않고 할당량 소비를 표시합니다.

이벤트 계약

쿼리가 예상하는 필드

필드유형그것이 존재하는 이유
timestamp_utcTimestamp청구 가능한 활동이 UTC로 완료된 경우.
meter_event_idUtf8하나의 논리적 사용 레코드에 대한 멱등성 키입니다.
account_idUtf8안정적인 청구 계정 식별자입니다.
planUtf8사용량이 발생했을 때 할당량을 소유한 계획입니다.
billable_unitsFloat64이번 이벤트로 추가된 정규화된 유닛입니다.
included_unitsFloat64계정 및 계획에 대한 월별 포함 할당량입니다.
DataFusion SQL

쿼리 복사

sql
WITH deduplicated_usage AS (
  SELECT
    meter_event_id,
    account_id,
    plan,
    MAX(billable_units) AS billable_units,
    MAX(included_units) AS included_units
  FROM usage_meter_events
  WHERE timestamp_utc >= date_trunc('month', now())
  GROUP BY meter_event_id, account_id, plan
)
SELECT
  account_id,
  plan,
  COUNT(*) AS meter_events,
  SUM(billable_units) AS used_units,
  MAX(included_units) AS included_units,
  100.0 * SUM(billable_units)
    / NULLIF(MAX(included_units), 0) AS quota_used_pct,
  SUM(billable_units) - MAX(included_units) AS overage_units
FROM deduplicated_usage
GROUP BY account_id, plan
ORDER BY quota_used_pct DESC;

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

쿼리 결과

계정에서 사용하는 월별 할당량

Harbor는 포함된 할당량을 초과했으며 Lumen은 예측이나 고객 알림이 필요할 만큼 가까워졌습니다.

account_idplanmeter_eventsused_unitsincluded_unitsquota_used_pctoverage_units
account_harborgrowth18,4201,126,0001,000,000112.6126,000
account_lumengrowth12,880842,0001,000,00084.2-158,000
account_northstarter3,610168,000250,00067.2-82,000

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

Monthly quota used by account: Calculate Usage Quota Burn by Account 예제 결과의 합성 quota_used_pct 값에 대한 정적 차트
결정론적 예제 출력의 색인 생성 가능한 SVG입니다. 기사, 런북 또는 저작자가 포함된 디자인 검토를 위해 다운로드하세요.

예제 재현

공공 픽스처 다운로드

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

SQL 작동 방식

  1. 1첫 번째 CTE는 미터 이벤트 ID별로 그룹화되므로 최소 한 번 전달 시 동일한 논리적 사용량을 두 번 청구할 수 없습니다.
  2. 2하나의 요청이 다수 또는 소수 단위를 나타낼 수 있으므로 청구 가능 단위는 이벤트 수와 별도로 합산됩니다.
  3. 3할당량 비율 및 초과분은 계정 순위 및 청구 검토에 필요한 계획별 분모를 유지합니다.

결정해야 할 극단적인 경우

  • 계획 변경에는 명시적인 비례배분 정책이 필요합니다. 월별 최대 한도는 기간 중에 할당량이 변경될 수 있는 경우를 예시합니다.
  • 수정 및 부정적인 사용에는 이전 이벤트를 자동으로 변경하는 대신 추가 전용 조정 계약이 필요합니다.
  • 송장이 최종 확정되기 전에 청구 제공자와 집계를 조정합니다.

추천 대시보드

  • 바: 계정별 quota_used_pct
  • 표: 중고, 포함 및 초과 단위
  • 추세: 75%를 초과하는 계정의 일일 청구 가능 단위

알림 안내

문서화된 할당량 임계값에 따라 계정 소유자에게 알리고 측정기 전달 또는 조정이 실패한 경우에만 페이지를 표시합니다.

알림 설정 읽기

레시피를 활용해 보세요

관련 계측 및 가이드

소스 데이터 정의

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

분석 계속하기

실제 이벤트에서 실행

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

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

API 키 받기