Mätare omvandlar råa händelser till fakturerbara mängder. De filtrerar händelser och tillämpar aggregeringsfunktioner (Count, Sum, Max, Last) för att beräkna användning per kund.
API-resurser
View Meter API References
View Meter API References
Skapa en Mätare
Aggregation
Välj hur händelser aggregeras:
- Count: Totalt antal händelser (API-anrop, uppladdningar)
- Sum: Lägg ihop numeriska värden (token, byte)
- Max: Högsta värde under perioden (toppanvändare)
- Last: Senaste värdet
Metadata-nyckel att aggregera (krävs för alla typer utom Count). Exempel:
tokens, bytes, duration_msEnhetsetikett för fakturor. Exempel:
calls, tokens, GB, hoursFiltering (Optional)
- OCH-logik: Alla villkor måste matcha
- ELLER-logik: Vilket som helst villkor kan matcha
Visa Analys
- Översikt: Total användning och användningsdiagram
- Händelser: Individuella händelser som mottagits
- Kunder: Användning och avgifter per kund
Fakturering i krediter istället för valuta
Som standard debiterar mätare kunder per enhet i dollar (eller din konfigurerade valuta). Du kan istället konfigurera en mätare för att dra från en kreditbalans – så användning förbrukar krediter istället för att generera en monetär avgift.Kreditbaserad avräkning kräver en Credit Entitlement kopplad till samma produkt. Skapa din kredit först, sedan länkar du den till mätaren.
När du ska använda kreditbaserad avräkning
| Scenario | Standard (valuta) | Kreditbaserad |
|---|---|---|
| Enkel prissättning per enhet ($0.01/samtal) | ✅ Bäst alternativ | Onödig överbelastning |
| Förbetalda kreditpaket (köp 10K tokens, använd över tid) | ❌ Går inte att uttrycka | ✅ Bäst alternativ |
| Bundlad användning med prenumerationer (Pro-planen inkluderar 100K samtal) | Möjligt via gratströskel | ✅ Bättre – krediter rullas över, upphör, visas i portalen |
| Produkter med flera mätare som delar en kreditpool | ❌ Varje mätare fakturerar separat | ✅ Alla mätare drar från samma balans |
Konfigurera en mätare för att dra krediter
Create a Credit Entitlement
Först skapar du en kredit i Products → Credits. Definiera enheten (t.ex. “API Calls”, “Tokens”), precision och livscykelinställningar (utgång, överföring, överanvändning).Se Credit-Based Billing guide för detaljerade instruktioner.
Create or Edit a Usage-Based Product
Gå till din användningsbaserade produkt och öppna avsnittet Meter.
Add a Meter
Klicka på +-knappen för att fästa en mätare. Konfigurera händelsenamn, aggregeringstyp och mätenhet som vanligt.
Enable 'Bill Usage in Credits'
Aktivera Bill usage in Credits i mätarkonfigurationen. Det visar kreditinställningarna:
Välj vilken krediträttighet den här mätaren ska dra från.
Antalet användningsenheter som krävs för att dra 1 kredit. Till exempel:
1= varje mätarevenemang drar 1 kredit100= 100 mätarevenemang drar 1 kredit1000= 1 000 API-anrop förbrukar 1 kredit
Hur kreditavdrag fungerar
När det är konfigurerat körs avdragsprocessen automatiskt:- Händelser anländer - Din applikation skickar användningshändelser via Event Ingestion API
- Mätaren aggregerar - Händelser aggregeras enligt din mätarkonfiguration (Count, Sum, Max, Last)
- Bakgrundsarbetare bearbetar - Varje minut hämtar en arbetare nya händelser sedan senaste kontrollpunkt
- Krediter dras - Aggregerad användning konverteras till krediter med
meter_units_per_creditoch dras med FIFO-ordning (äldsta behörigheter förbrukas först) - Överanvändning spåras - Om balansen når noll och överanvändning är aktiverat fortsätter användningen och överanvändningen hanteras enligt konfigurerat beteende (efterges vid återställning, faktureras vid nästa faktura eller förs vidare som underskott)
Flera mätare, en kreditpool
Du kan koppla flera mätare på samma produkt till samma krediträttighet. Alla mätare drar från ett gemensamt saldo. Exempel: En AI-plattform med två mätare:text.generation– 1 kredit per 1 000 tokensimage.generation– 10 krediter per bild
List Customer Ledger
Visa hela kreditavdragshistoriken för en kund.
Get Customer Balance
Kontrollera en kunds aktuella kreditbalans via API.
Felsökning
Events not appearing
Events not appearing
- Händelsenamnet måste matcha exakt (skiftlägeskänsligt)
- Kontrollera att mätarfilter inte exkluderar händelser
- Verifiera att kund-ID:n finns
- Inaktivera temporärt filter för test
Aggregation not working
Aggregation not working
- Verifiera att Over Property matchar metadata-nyckeln exakt
- Använd siffror, inte strängar:
tokens: 150inte"150" - Inkludera obligatoriska egenskaper i alla händelser
Filters not working
Filters not working
- Matcha skiftläge exakt
- Använd rätt operatorer för datatypen
- Säkerställ att händelserna inkluderar filtrerade egenskaper
Wrong usage totals
Wrong usage totals
- Kontrollera fliken Events för att räkna faktiska mottagna händelser
- Verifiera aggregeringstyp (Count vs Sum)
- Kontrollera att värden är numeriska för Sum/Max