Skip to main content
Meter는 원시 이벤트를 청구 가능한 수량으로 변환합니다. 이벤트를 필터링하고 집계 함수(Count, Sum, Max, Last)를 적용하여 고객별 사용량을 계산합니다.
이벤트 이름, 집계 유형 및 필터링 옵션을 보여주는 미터 생성 인터페이스

​
API 리소스

Create Meter

API를 통해 미터를 프로그램 방식으로 생성합니다.

List Meters

계정의 모든 미터를 가져옵니다.

Get Meter

ID로 특정 미터의 세부 정보를 가져옵니다.

Archive Meter

사용량 추적을 중지하려면 미터를 보관 처리합니다.

Unarchive Meter

보관 처리된 미터를 복원하여 추적을 재개합니다.

​
미터 생성

1

Basic Information

​
string
필수
Meter를 설명하는 이름입니다(예: “API Requests”, “Token Usage”).
​
string
필수
일치시킬 정확한 이벤트 이름입니다(대소문자 구분). 예: api.call, image.generated.
2

Aggregation

​
string
필수
이벤트가 집계되는 방법을 선택하세요:
  • Count: 이벤트의 총 개수(API 호출, 업로드)
  • Sum: 숫자 값의 합계(토큰, 바이트)
  • Max: 해당 기간의 최댓값(최대 사용자 수)
  • Last: 가장 최근 값
​
string
집계할 metadata key입니다(Sum, Max, Last에 필요). 예: tokens, bytes, duration_ms.
​
string
필수
인보이스와 리포트에 표시할 단위 레이블입니다. 예: calls, tokens, GB, hours.
3

Filtering (Optional)

AND/OR 논리 및 비교 연산자를 사용하는 이벤트 필터링 인터페이스
어떤 이벤트가 계산될지를 필터링하기 위한 조건을 추가합니다:
  • AND 논리: 모든 조건이 일치해야 함
  • OR 논리: 어떤 조건이든 일치할 수 있음
사용 가능한 비교 연산자: 같음, 같지 않음, 초과, 이상, 미만, 이하, 포함, 포함하지 않음.필터링을 활성화하고 로직을 선택한 다음 property key, 비교 연산자, 값으로 조건을 추가합니다.
4

Create

설정을 검토하고 Create Meter를 클릭합니다.

​
분석 보기

사용량 개요, 이벤트 및 고객 데이터를 보여주는 Meter 분석 대시보드
Meter 대시보드에는 다음이 표시됩니다:
  • Overview: 시간에 따른 총 사용량 및 사용량 추이
  • Events: 수신된 개별 이벤트와 해당 metadata
  • Customers: 고객별 사용량 합계 및 요금

​
통화 대신 크레딧으로 청구

기본적으로 Meter는 고객에게 달러(또는 설정한 통화)로 단위당 요금을 청구합니다. 대신 고객의 credit balance에서 차감하도록 Meter를 구성할 수 있으며, 이 경우 사용량이 금전적 요금을 발생시키는 대신 credit을 소모합니다.
Credit 기반 차감에는 동일한 product에 연결된 Credit Entitlement이 필요합니다. 먼저 credit entitlement를 생성한 다음 Meter에 연결하세요.

​
크레딧 기반 차감을 사용해야 할 때

​
크레딧을 차감하도록 미터 구성하기

1

Create a Credit Entitlement

먼저 Products → Credits에서 credit entitlement를 생성합니다. 단위(예: “API Calls”, “Tokens”), precision 및 lifecycle 설정(expiry, rollover, overage)을 정의합니다.자세한 지침은 Credit-Based Billing guide를 참조하세요.
2

Create or Edit a Usage-Based Product

사용 기반 제품으로 이동하여 Meter 구성 섹션을 엽니다.
3

Add a Meter

미터를 연결하려면 + 버튼을 클릭하세요. 이벤트 이름, 집계 유형, 측정 단위를 평소처럼 구성합니다.
4

Enable 'Bill Usage in Credits'

Meter 구성에서 Bill usage in Credits를 전환하여 credit 설정을 표시합니다:
크레딧에 사용량 청구 토글이 활성화된 미터 구성

Toggle 'Bill usage in Credits' to switch from currency-based to credit-based deduction.

​
string
필수
이 Meter가 차감할 credit entitlement를 선택합니다.
​
number
필수
1 크레딧을 차감하기 위해 필요한 사용 단위 수입니다. 예를 들어:
  • 1 = 각 미터 이벤트가 1 크레딧을 차감
  • 100 = 100개의 미터 이벤트가 1 크레딧을 차감
  • 1000 = 1,000개의 API 호출이 1 크레딧을 소비
5

Free Threshold and Credits

Free Threshold는 금액으로 청구되는 Meter에 적용되며, credit으로 청구되는 Meter에는 적용되지 않습니다. Meter가 credit으로 청구되면 모든 단위가 credit 차감에 포함됩니다.예시: meter-units-per-credit가 1인 경우, API 호출을 2,500회 수행한 고객에게서 2,500 credit이 차감됩니다.

​
크레딧 차감 작동 방식

구성되면 차감 파이프라인이 자동으로 실행됩니다:
  1. 이벤트 수신 — 애플리케이션이 Event Ingestion API를 통해 사용량 이벤트를 전송합니다.
  2. Meter 집계 — Meter 구성에 따라 이벤트가 집계됩니다(Count, Sum, Max, Last).
  3. 백그라운드 worker 처리 — 매분 worker가 마지막 checkpoint 이후의 새 이벤트를 가져옵니다.
  4. Credit 차감 — 집계된 사용량이 meter_units_per_credit rate를 사용하여 credit으로 변환되고 FIFO 순서(가장 먼저 만료되는 grant부터 사용)에 따라 차감됩니다.
  5. 초과 사용량 추적 — balance가 0이 되면 이후 사용량은 overage로 기록되며 구성된 동작(reset 시 면제, 다음 invoice에서 청구 또는 deficit으로 이월)에 따라 처리됩니다. balance가 소진되어도 Dodo Payments는 사용량을 차단하지 않습니다. 잔액이 0일 때 액세스를 중지하려면 애플리케이션에서 balance를 확인하세요.
Credit 차감은 비동기적으로 실행됩니다(약 1분마다). 이벤트 수집과 balance 차감 사이에 짧은 지연이 발생할 수 있습니다. 애플리케이션이 이 지연을 처리하도록 설계하고, 개별 요청의 액세스 제어를 위해 실시간 balance 확인에 의존하지 마세요.

​
다중 미터, 단일 크레딧 풀

동일한 product의 여러 Meter를 동일한 credit entitlement에 연결할 수 있습니다. 모든 Meter가 하나의 공유 balance에서 차감됩니다. 예시: 두 개의 Meter가 있는 AI platform:
  • text.generation — 토큰 1,000개당 credit 1개
  • image.generation — 이미지당 credit 10개
둘 다 동일한 “AI Credits” 풀에서 차감되며 고객은 포털에서 하나의 통합된 잔액을 확인합니다.
미터별로 다른 meter_units_per_credit 요율을 사용하여 상대적인 비용을 표현하세요. 비용이 높은 작업(이미지 생성)은 비용이 낮은 작업(텍스트 완성)보다 크레딧당 미터 단위가 적습니다.

List Customer Ledger

고객의 전체 크레딧 차감 내역 보기.

Get Customer Balance

API를 통해 고객의 현재 크레딧 잔액 확인.

​
문제 해결

  • 이벤트 이름이 정확히 일치하는지 확인하세요(대소문자 구분)
  • Meter filter가 이벤트를 제외하고 있지 않은지 확인하세요
  • 고객 ID가 계정에 존재하는지 확인하세요
  • 테스트를 위해 일시적으로 filter를 비활성화하세요
  • Over Property가 metadata key와 정확히 일치하는지 확인하세요
  • 문자열이 아닌 숫자를 사용하세요: tokens: 150, tokens: "150"가 아님
  • 모든 이벤트에 필수 property를 포함하세요
  • 대소문자가 정확히 일치하는지 확인하세요
  • 데이터 type에 맞는 올바른 operator를 사용하세요
  • 이벤트에 filter 대상 property가 포함되어 있는지 확인하세요
  • 실제로 수신된 이벤트 수를 확인하려면 Events 탭을 확인하세요
  • aggregation type을 확인하세요(Count와 Sum)
  • Sum 및 Max에 사용되는 값이 숫자인지 확인하세요

​
다음 단계

Send Events

애플리케이션에서 미터로 사용 이벤트 전송을 시작하세요.

View Blueprints

일반적인 사용 사례에 대해 기성 미터 구성을 사용하세요.
마지막 수정일 2026년 9월 26일