미터는 원시 이벤트를 청구 가능한 수량으로 변환합니다. 이벤트를 필터링하고 집계 함수(Count, Sum, Max, Last)를 적용하여 고객별 사용량을 계산합니다.
API 리소스
View Meter API References
View Meter API References
Create Meter
API를 통해 미터를 프로그램 방식으로 생성합니다.
List Meters
계정의 모든 미터를 가져옵니다.
Get Meter
ID로 특정 미터의 세부 정보를 가져옵니다.
Archive Meter
사용량 추적을 중지하려면 미터를 보관 처리합니다.
Unarchive Meter
보관 처리된 미터를 복원하여 추적을 재개합니다.
미터 생성
Aggregation
Filtering (Optional)
- AND 논리: 모든 조건이 일치해야 함
- OR 논리: 어떤 조건이든 일치할 수 있음
분석 보기
- 개요: 총 사용량 및 사용량 차트
- 이벤트: 수신된 개별 이벤트
- 고객: 고객별 사용량 및 요금
통화 대신 크레딧으로 청구
기본적으로 미터는 고객에게 단위당 달러(또는 구성된 통화)로 청구합니다. 대신 미터를 크레딧 잔액에서 차감하도록 설정할 수 있으며, 사용량이 금전적 청구를 생성하는 대신 크레딧을 소비합니다.Credit-based deduction requires a Credit Entitlement attached to the same product. Create your credit first, then link it to the meter.
크레딧 기반 차감을 사용해야 할 때
| 시나리오 | Standard (currency) | Credit-based |
|---|---|---|
| 단순한 단위당 가격 책정 ($0.01/call) | ✅ 가장 적합 | 불필요한 오버헤드 |
| 선불 크레딧 팩 (토큰 10K 구매 후 시간 경과 사용) | ❌ 표현 불가 | ✅ 가장 적합 |
| 구독과 함께 묶인 사용량 (프로 요금제에 100K 호출 포함) | 무료 임계값을 통해 가능 | ✅ 더 나음 - 크레딧은 이월되고 만료되며 포털에 표시 |
| 크레딧 풀을 공유하는 다중 미터 제품 | ❌ 각 미터가 별도 청구 | ✅ 모든 미터가 단일 잔액에서 차감 |
크레딧을 차감하도록 미터 구성하기
Create a Credit Entitlement
먼저 Products → Credits에서 크레딧을 생성하세요. 단위(예: “API Calls”, “Tokens”), 정밀도, 수명 주기 설정(만료, 이월, 초과 사용)을 정의합니다.자세한 지침은 Credit-Based Billing guide를 참조하세요.
크레딧 차감 작동 방식
구성되면 차감 파이프라인이 자동으로 실행됩니다:- 이벤트 수신 - 애플리케이션이 Event Ingestion API를 통해 사용 이벤트를 전송합니다
- 미터 집계 - 이벤트가 미터 구성(Count, Sum, Max, Last)에 따라 집계됩니다
- 백그라운드 워커 처리 - 매분 워커가 마지막 체크포인트 이후의 새 이벤트를 가져옵니다
- 크레딧 차감 - 집계된 사용량이
meter_units_per_credit요율로 크레딧으로 변환되어 FIFO 순서로 (가장 오래된 권한부터) 차감됩니다 - 초과 사용 추적 - 잔액이 0이 되고 초과 사용이 활성화된 경우, 사용량은 계속되며 설정된 동작에 따라 처리됩니다(리셋 시 면제, 다음 인보이스에 청구, 부족분으로 이월)
다중 미터, 단일 크레딧 풀
동일한 제품의 여러 미터를 동일한 크레딧 권한에 연결할 수 있습니다. 모든 미터가 하나의 공유 잔액에서 차감됩니다. 예시: 두 개의 미터를 가진 AI 플랫폼:text.generation- 1,000 토큰당 1 크레딧image.generation- 이미지당 10 크레딧
List Customer Ledger
고객의 전체 크레딧 차감 내역 보기.
Get Customer Balance
API를 통해 고객의 현재 크레딧 잔액 확인.
문제 해결
Events not appearing
Events not appearing
- 이벤트 이름은 정확히 일치해야 합니다(대소문자 구분)
- 미터 필터가 이벤트를 제외하고 있지 않은지 확인하세요
- 고객 ID가 존재하는지 확인하세요
- 테스트를 위해 필터를 일시적으로 비활성화하세요
Aggregation not working
Aggregation not working
- Over Property가 메타데이터 키와 정확히 일치하는지 확인하세요
- 숫자를 사용하세요, 문자열이 아닌:
tokens: 150not"150" - 모든 이벤트에 필수 속성을 포함하세요
Filters not working
Filters not working
- 대소문자를 정확히 일치시켜야 합니다
- 데이터 유형에 맞는 연산자를 사용하세요
- 필터링된 속성을 이벤트에 포함시켰는지 확인하세요
Wrong usage totals
Wrong usage totals
- 이벤트 탭에서 실제 수신된 이벤트 수를 확인하세요
- 집계 유형(Count vs Sum)을 확인하세요
- Sum/Max의 경우 값이 숫자인지 확인하세요
다음 단계
Send Events
애플리케이션에서 미터로 사용 이벤트 전송을 시작하세요.
View Blueprints
일반적인 사용 사례에 대해 기성 미터 구성을 사용하세요.