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

View Meter API References

Create Meter

Buat meter secara program melalui API.

List Meters

Ambil semua meter dalam akun Anda.

Get Meter

Ambil detail untuk meter tertentu berdasarkan ID.

Archive Meter

Arsipkan meter untuk berhenti melacak pemakaian.

Unarchive Meter

Pulihkan meter yang diarsipkan untuk melanjutkan pelacakan.

​

Membuat Meter

1. Basic Information

   Meter Name · string · wajib

   Nama deskriptif (misalnya, “API Requests”, “Token Usage”)

   Event Name · string · wajib

   Nama event yang tepat untuk dicocokkan (sensitif terhadap huruf besar/kecil). Contoh: api.call, image.generated

2. Aggregation

   Aggregation Type · string · wajib

   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

   Over Property · string

   Kunci metadata untuk diagregasi (wajib untuk semua jenis kecuali Count). Contoh: tokens, bytes, duration_ms

   Measurement Unit · string · wajib

   Label satuan untuk faktur. Contoh: calls, tokens, GB, hours

3. Filtering (Optional)

   

   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.

4. Create

   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 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

1. Create a Credit Entitlement

   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 untuk petunjuk rinci.

2. Create or Edit a Usage-Based Product

   Buka produk berbasis penggunaan Anda dan buka bagian konfigurasi Meter.

3. Add a Meter

   Klik tombol + untuk melampirkan meter. Konfigurasikan nama acara, jenis agregasi, dan unit pengukuran seperti biasa.

4. Enable 'Bill Usage in Credits'

   Alihkan Bill usage in Credits di konfigurasi meter. Ini akan menampilkan pengaturan kredit:

   

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

   Credit Entitlement · string · wajib

   Pilih hak kredit mana yang harus dipotong oleh meter ini.

   Meter units per credit · number · wajib

   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
5. Set the Free Threshold

   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
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)

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).

List Customer Ledger

Lihat riwayat pengurangan kredit lengkap untuk pelanggan.

Get Customer Balance

Periksa saldo kredit saat ini pelanggan melalui API.

​

Pemecahan Masalah

Events not appearing

• 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

Aggregation not working

• Pastikan Over Property cocok persis dengan kunci metadata
• Gunakan angka, bukan string: tokens: 150 bukan "150"
• Sertakan properti yang diperlukan dalam semua peristiwa

Filters not working

• Cocokkan huruf besar-kecil secara tepat
• Gunakan operator yang tepat untuk tipe data
• Pastikan peristiwa menyertakan properti yang difilter

Wrong usage totals

• Periksa tab Events untuk menghitung peristiwa yang sebenarnya diterima
• Verifikasi jenis agregasi (Count vs Sum)
• Pastikan nilainya numerik untuk Sum/Max

​

Langkah Berikutnya

Send Events

Mulai kirim peristiwa penggunaan dari aplikasi Anda ke meter Anda.

View Blueprints

Gunakan konfigurasi meter siap pakai untuk kasus penggunaan umum.