> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Meter
> Ubah peristiwa penggunaan mentah menjadi kuantitas yang dapat ditagih dengan agregasi dan penyaringan.
Meter mengubah event mentah menjadi jumlah yang dapat ditagih. Mereka menyaring event dan menerapkan fungsi agregasi (Count, Sum, Max, Last) untuk menghitung pemakaian per pelanggan.
## Sumber Daya API
Buat meter secara program melalui API.
Ambil semua meter dalam akun Anda.
Ambil detail untuk meter tertentu berdasarkan ID.
Arsipkan meter untuk berhenti melacak pemakaian.
Pulihkan meter yang diarsipkan untuk melanjutkan pelacakan.
## Membuat Meter
Nama deskriptif (misalnya, "API Requests", "Token Usage")
Nama event yang tepat untuk dicocokkan (sensitif terhadap huruf besar/kecil). Contoh: `api.call`, `image.generated`
Pilih bagaimana event diagregasi:
* **Count**: Jumlah total event (panggilan API, unggahan)
* **Sum**: Menjumlahkan nilai numerik (token, byte)
* **Max**: Nilai tertinggi dalam periode (pengguna puncak)
* **Last**: Nilai terbaru
Kunci metadata untuk diagregasi (wajib untuk semua jenis kecuali Count). Contoh: `tokens`, `bytes`, `duration_ms`
Label satuan untuk faktur. Contoh: `calls`, `tokens`, `GB`, `hours`
Tambahkan kondisi untuk menyaring peristiwa mana yang dihitung:
* **Logika DAN**: Semua kondisi harus cocok
* **Logika ATAU**: Kondisi mana pun dapat cocok
**Pembanding**: sama dengan, tidak sama dengan, lebih besar dari, kurang dari, mengandung
Aktifkan penyaringan, pilih logika, tambahkan kondisi dengan kunci properti, pembanding, dan nilai.
Tinjau konfigurasi dan klik **Create Meter**.
## Melihat Analitik
Dasbor meter Anda menunjukkan:
* **Ikhtisar**: Total penggunaan dan grafik penggunaan
* **Peristiwa**: Peristiwa individu yang diterima
* **Pelanggan**: Penggunaan dan biaya per pelanggan
## Penagihan dalam Kredit Alih-alih Mata Uang
Secara default, meter mengenakan biaya pelanggan per unit dalam dolar (atau mata uang yang Anda konfigurasikan). Anda bisa mengonfigurasi meter untuk **memotong dari saldo kredit** - jadi penggunaan mengonsumsi kredit alih-alih menghasilkan biaya moneter.
Pengurangan berbasis kredit memerlukan sebuah [Hak Kredit](/features/credit-based-billing) yang terpasang pada produk yang sama. Buat kredit Anda terlebih dahulu, lalu tautkan ke meter.
### Kapan Menggunakan Pengurangan Berbasis Kredit
| Scenario | Standard (currency) | Credit-based |
| ---------------------------------------------------------------------- | -------------------------------------- | --------------------------------------------------------------- |
| Penetapan harga per unit sederhana (\$0,01/panggilan) | ✅ Paling tepat | Beban tambahan yang tidak perlu |
| Paket kredit prabayar (beli 10K token, gunakan seiring waktu) | ❌ Tidak bisa diekspresikan | ✅ Paling tepat |
| Penggunaan bundel dengan langganan (paket Pro mencakup 100K panggilan) | Mungkin lewat ambang bebas | ✅ Lebih baik - kredit digulirkan, kedaluwarsa, tampil di portal |
| Produk multi-meter berbagi kumpulan kredit | ❌ Setiap meter menagih secara terpisah | ✅ Semua meter memotong dari satu saldo |
### Mengonfigurasi Meter agar Memotong Kredit
Pertama, buat kredit di **Products → Credits**. Tentukan unit (misal, "API Calls", "Tokens"), presisi, dan pengaturan siklus hidup (kedaluwarsa, pengguliran, kelebihan).
Lihat panduan [Penagihan Berbasis Kredit](/features/credit-based-billing) untuk petunjuk rinci.
Buka produk berbasis penggunaan Anda dan buka bagian konfigurasi **Meter**.
Klik tombol **+** untuk melampirkan meter. Konfigurasikan nama acara, jenis agregasi, dan unit pengukuran seperti biasa.
Alihkan **Bill usage in Credits** di konfigurasi meter. Ini akan menampilkan pengaturan kredit:
Pilih hak kredit mana yang harus dipotong oleh meter ini.
Jumlah unit penggunaan yang diperlukan agar memotong 1 kredit. Misalnya:
* `1` = setiap peristiwa meter memotong 1 kredit
* `100` = 100 peristiwa meter memotong 1 kredit
* `1000` = 1.000 panggilan API mengonsumsi 1 kredit
Ambang **Free Threshold** masih berlaku - peristiwa di bawah ambang ini tidak memotong kredit.
**Contoh**: Dengan ambang bebas 1.000 dan meter-units-per-credit 1:
* Pelanggan menggunakan 2.500 panggilan API
* 1.000 pertama gratis
* Sisa 1.500 memotong 1.500 kredit dari saldo mereka
### Bagaimana Pengurangan Kredit Bekerja
Setelah dikonfigurasi, pipeline pengurangan berjalan secara otomatis:
1. **Events arrive** - Aplikasi Anda mengirimkan peristiwa penggunaan melalui [Event Ingestion API](/features/usage-based-billing/event-ingestion)
2. **Meter aggregates** - Peristiwa digabungkan sesuai konfigurasi meter Anda (Count, Sum, Max, Last)
3. **Background worker processes** - Setiap menit, seorang pekerja mengambil peristiwa baru sejak checkpoint terakhir
4. **Credits are deducted** - Penggunaan yang telah digabungkan dikonversi menjadi kredit menggunakan tarif `meter_units_per_credit` dan dipotong menggunakan **penyusunan FIFO** (hak kredit tertua dikonsumsi lebih dulu)
5. **Overage tracked** - Jika saldo mencapai nol dan overage diaktifkan, penggunaan berlanjut dan overage ditangani sesuai perilaku yang dikonfigurasi (maafkan saat reset, ditagihkan di faktur berikutnya, atau dibawa maju sebagai defisit)
```mermaid theme={null}
flowchart LR
A[Usage Event] --> B[Meter Aggregation]
B --> C{Credits Available?}
C -->|Yes| D[Deduct from Balance]
C -->|No| E{Overage Enabled?}
E -->|Yes| F[Track Overage]
E -->|No| G[Block Usage]
D --> H[Update Ledger]
F --> H
```
Pengurangan kredit berjalan secara asinkron (setiap \~1 menit). Mungkin ada jeda singkat antara ingesting peristiwa dan pemotongan saldo. Rancang aplikasi Anda untuk menangani jeda ini - jangan bergantung pada pemeriksaan saldo waktu nyata untuk kontrol akses pada permintaan individual.
### Banyak Meter, Satu Kumpulan Kredit
Anda dapat menautkan beberapa meter pada produk yang sama ke **hak kredit yang sama**. Semua meter memotong dari satu saldo bersama.
**Contoh**: Platform AI dengan dua meter:
* `text.generation` - 1 kredit per 1.000 token
* `image.generation` - 10 kredit per gambar
Keduanya memotong dari kumpulan "AI Credits" yang sama. Pelanggan melihat satu saldo terpadu di portal mereka.
Gunakan tarif `meter_units_per_credit` berbeda antar meter untuk menyatakan biaya relatif. Operasi mahal (generasi gambar) membutuhkan lebih sedikit unit meter per kredit dibanding yang murah (penyelesaian teks).
Lihat riwayat pengurangan kredit lengkap untuk pelanggan.
Periksa saldo kredit saat ini pelanggan melalui API.
## Pemecahan Masalah
* Nama peristiwa harus cocok persis (sensitif huruf besar-kecil)
* Periksa agar filter meter tidak mengecualikan peristiwa
* Pastikan ID pelanggan ada
* Nonaktifkan filter sementara untuk menguji
* Pastikan Over Property cocok persis dengan kunci metadata
* Gunakan angka, bukan string: `tokens: 150` bukan `"150"`
* Sertakan properti yang diperlukan dalam semua peristiwa
* Cocokkan huruf besar-kecil secara tepat
* Gunakan operator yang tepat untuk tipe data
* Pastikan peristiwa menyertakan properti yang difilter
* Periksa tab Events untuk menghitung peristiwa yang sebenarnya diterima
* Verifikasi jenis agregasi (Count vs Sum)
* Pastikan nilainya numerik untuk Sum/Max
## Langkah Berikutnya
Mulai kirim peristiwa penggunaan dari aplikasi Anda ke meter Anda.
Gunakan konfigurasi meter siap pakai untuk kasus penggunaan umum.