> ## 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.
# Mätare
> Transformera råanvändningsevenemang till fakturerbara kvantiteter med aggregering och filtrering.
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
Skapa mätare programmässigt via API.
Hämta alla mätare i ditt konto.
Hämta information om en viss mätare med dess ID.
Arkivera en mätare för att sluta spåra användning.
Återställ en arkiverad mätare för att börja spåra igen.
## Skapa en Mätare
Beskrivande namn (t.ex. "API Requests", "Token Usage")
Exakt händelsenamn som ska matchas (skiftlägeskänsligt). Exempel: `api.call`, `image.generated`
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_ms`
Enhetsetikett för fakturor. Exempel: `calls`, `tokens`, `GB`, `hours`
Lägg till villkor för att filtrera vilka händelser som räknas:
* **OCH-logik**: Alla villkor måste matcha
* **ELLER-logik**: Vilket som helst villkor kan matcha
**Jämförare**: lika med, inte lika med, större än, mindre än, innehåller
Aktivera filtrering, välj logik, lägg till villkor med egenskapsnyckel, jämförare och värde.
Granska konfigurationen och klicka på **Create Meter**.
## Visa Analys
Din mätardashboard visar:
* **Ö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](/features/credit-based-billing) 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
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](/features/credit-based-billing) för detaljerade instruktioner.
Gå till din användningsbaserade produkt och öppna avsnittet **Meter**.
Klicka på **+**-knappen för att fästa en mätare. Konfigurera händelsenamn, aggregeringstyp och mätenhet som vanligt.
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 kredit
* `100` = 100 mätarevenemang drar 1 kredit
* `1000` = 1 000 API-anrop förbrukar 1 kredit
Den **gratströskeln** gäller fortfarande – händelser under denna tröskel drar inte krediter.
**Exempel**: Med en gratströskel på 1 000 och mätenheter-per-kredit på 1:
* Kunden använder 2 500 API-anrop
* Första 1 000 är gratis
* Återstående 1 500 drar 1 500 krediter från deras saldo
### Hur kreditavdrag fungerar
När det är konfigurerat körs avdragsprocessen automatiskt:
1. **Händelser anländer** - Din applikation skickar användningshändelser via [Event Ingestion API](/features/usage-based-billing/event-ingestion)
2. **Mätaren aggregerar** - Händelser aggregeras enligt din mätarkonfiguration (Count, Sum, Max, Last)
3. **Bakgrundsarbetare bearbetar** - Varje minut hämtar en arbetare nya händelser sedan senaste kontrollpunkt
4. **Krediter dras** - Aggregerad användning konverteras till krediter med `meter_units_per_credit` och dras med **FIFO-ordning** (äldsta behörigheter förbrukas först)
5. **Ö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)
```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
```
Kreditavdrag körs asynkront (ungefär var minut). Det kan vara en kort fördröjning mellan händelseintag och balanseräkning. Designa din applikation för att hantera denna fördröjning – förlita dig inte på realtidskontroller av saldo för åtkomstkontroll vid enskilda förfrågningar.
### 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 tokens
* `image.generation` – 10 krediter per bild
Båda drar från samma "AI Credits"-pool. Kunden ser ett enhetligt saldo i sin portal.
Använd olika `meter_units_per_credit`-tariffer mellan mätare för att uttrycka relativa kostnader. Dyra operationer (bildgenerering) kostar färre mätenheter per kredit än billiga (textkomplettering).
Visa hela kreditavdragshistoriken för en kund.
Kontrollera en kunds aktuella kreditbalans via API.
## Felsökning
* 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
* Verifiera att Over Property matchar metadata-nyckeln exakt
* Använd siffror, inte strängar: `tokens: 150` inte `"150"`
* Inkludera obligatoriska egenskaper i alla händelser
* Matcha skiftläge exakt
* Använd rätt operatorer för datatypen
* Säkerställ att händelserna inkluderar filtrerade egenskaper
* 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
## Nästa steg
Börja skicka användningshändelser från din applikation till dina mätare.
Använd färdiga mätarkonfigurationer för vanliga användningsfall.