Zähler wandeln Rohereignisse in abrechenbare Mengen um. Sie filtern Ereignisse und wenden Aggregationsfunktionen (Count, Sum, Max, Last) an, um die Nutzung pro Kunde zu berechnen.
API-Ressourcen
View Meter API References
View Meter API References
Create Meter
Erstellen Sie Zähler programmatisch über die API.
List Meters
Rufen Sie alle Zähler in Ihrem Konto ab.
Get Meter
Holen Sie Details für einen bestimmten Zähler anhand der ID.
Archive Meter
Archivieren Sie einen Zähler, um die Nachverfolgung der Nutzung zu stoppen.
Unarchive Meter
Stellen Sie einen archivierten Zähler wieder her, um die Nachverfolgung fortzusetzen.
Einen Zähler erstellen
Aggregation
Wählen Sie aus, wie Ereignisse aggregiert werden:
- Count: Gesamtanzahl von Ereignissen (API-Aufrufe, Uploads)
- Sum: Addition numerischer Werte (Tokens, Bytes)
- Max: Höchster Wert im Zeitraum (Spitzenbenutzer)
- Last: Aktuellster Wert
Metadaten-Schlüssel zur Aggregation (erforderlich für alle Typen außer Count). Beispiele:
tokens, bytes, duration_msEinheitenbezeichnung für Rechnungen. Beispiele:
calls, tokens, GB, hoursFiltering (Optional)
- UND-Logik: Alle Bedingungen müssen übereinstimmen
- ODER-Logik: Jede Bedingung kann übereinstimmen
Analysen anzeigen
- Übersicht: Gesamtnutzung und Nutzungsgrafik
- Ereignisse: Einzelne empfangene Ereignisse
- Kunden: Nutzung und Gebühren pro Kunde
Abrechnung in Credits statt Währung
Standardmäßig berechnen Meter Kunden pro Einheit in Dollar (oder deiner konfigurierten Währung). Du kannst stattdessen ein Meter so konfigurieren, dass es vom Credit-Guthaben abzieht – sodass Nutzung Credits verbraucht statt eine monetäre Gebühr zu erzeugen.Die kreditbasierte Abrechnung benötigt eine Credit-Berechtigung, die demselben Produkt zugeordnet ist. Lege zuerst deinen Credit an und verknüpfe ihn dann mit dem Meter.
Wann man kreditbasierte Abrechnung verwenden sollte
| Szenario | Standard (Währung) | Kreditbasiert |
|---|---|---|
| Einfache Preis pro Einheit ($0,01/Call) | ✅ Beste Wahl | Überflüssiger Mehraufwand |
| Prepaid-Credit-Pakete (10.000 Tokens kaufen, über Zeit nutzen) | ❌ Nicht darstellbar | ✅ Beste Wahl |
| Gebündelte Nutzung mit Abos (Pro-Plan enthält 100K Calls) | Möglich über kostenlosen Schwellenwert | ✅ Besser – Credits rollen über, verfallen, werden im Portal angezeigt |
| Produkte mit mehreren Metern, die einen Credit-Pool teilen | ❌ Jeder Meter rechnet separat ab | ✅ Alle Meter ziehen von einem Guthaben ab |
Konfiguration eines Meters für Credit-Abzug
Create a Credit Entitlement
Erstelle zuerst einen Credit unter Products → Credits. Definiere die Einheit (z. B. „API Calls“, „Tokens“), die Genauigkeit und Lebenszyklus-Einstellungen (Ablauf, Übertragung, Überziehung).Sieh dir den Credit-Based Billing guide für detaillierte Anleitungen an.
Create or Edit a Usage-Based Product
Gehe zu deinem nutzungsbasierten Produkt und öffne den Konfigurationsbereich Meter.
Add a Meter
Klicke auf die +-Schaltfläche, um ein Meter anzufügen. Konfiguriere wie gewohnt den Ereignisnamen, den Aggregationstyp und die Messeinheit.
Enable 'Bill Usage in Credits'
Aktiviere Bill usage in Credits in der Meter-Konfiguration. Dadurch werden die Credit-Einstellungen sichtbar:
Wähle aus, von welcher Credit-Berechtigung dieses Meter abbuchen soll.
Die Anzahl der Nutzungseinheiten, die benötigt werden, um 1 Credit abzuziehen. Beispielsweise:
1= jedes Meter-Ereignis zieht 1 Credit ab100= 100 Meter-Ereignisse ziehen 1 Credit ab1000= 1.000 API-Aufrufe verbrauchen 1 Credit
Set the Free Threshold
Der kostenlose Schwellenwert gilt weiterhin – Ereignisse unterhalb dieses Schwellenwerts ziehen keine Credits ab.Beispiel: Mit einem kostenlosen Schwellenwert von 1.000 und meter-units-per-credit von 1:
- Kunde nutzt 2.500 API-Aufrufe
- Die ersten 1.000 sind kostenlos
- Die verbleibenden 1.500 ziehen 1.500 Credits vom Guthaben ab
So funktioniert die Credit-Abrechnung
Sobald konfiguriert, läuft die Abzugs-Pipeline automatisch ab:- Ereignisse treffen ein – Deine Anwendung sendet Nutzungsevents über die Event Ingestion API
- Meter aggregiert – Ereignisse werden gemäß deiner Meter-Konfiguration aggregiert (Count, Sum, Max, Last)
- Hintergrundprozesse – Jede Minute holt ein Worker neue Ereignisse seit dem letzten Checkpoint
- Credits werden abgezogen – Aggregierte Nutzung wird mit dem
meter_units_per_creditSatz in Credits umgerechnet und nach FIFO-Reihenfolge abgebucht (älteste Grants zuerst) - Überziehungen werden erfasst – Wenn das Guthaben null erreicht und Überziehung aktiviert ist, läuft die Nutzung weiter und die Überziehung wird gemäß dem konfigurierten Verhalten behandelt (bei Reset erlassen, auf der nächsten Rechnung berechnet oder als Defizit vorgetragen)
Mehrere Meter, ein Credit-Pool
Du kannst mehrere Meter desselben Produkts mit derselben Credit-Berechtigung verknüpfen. Alle Meter ziehen von einem gemeinsamen Guthaben ab. Beispiel: Eine KI-Plattform mit zwei Metern:text.generation– 1 Credit pro 1.000 Tokensimage.generation– 10 Credits pro Bild
List Customer Ledger
Sieh dir den vollständigen Verlauf der Credit-Abzüge für einen Kunden an.
Get Customer Balance
Prüfe das aktuelle Credit-Guthaben eines Kunden über die API.
Fehlerbehebung
Events not appearing
Events not appearing
- Der Ereignisname muss exakt übereinstimmen (Groß-/Kleinschreibung)
- Überprüfe, dass Meter-Filter Ereignisse nicht ausschließen
- Verifiziere, dass Kunden-IDs existieren
- Deaktiviere Filter vorübergehend zum Testen
Aggregation not working
Aggregation not working
- Überprüfe, ob Over Property genau dem Metadaten-Schlüssel entspricht
- Verwende Zahlen, keine Strings:
tokens: 150nicht"150" - Füge erforderliche Eigenschaften in allen Ereignissen hinzu
Filters not working
Filters not working
- Achte auf exakte Groß-/Kleinschreibung
- Verwende die korrekten Operatoren für den Datentyp
- Stelle sicher, dass Ereignisse gefilterte Eigenschaften enthalten
Wrong usage totals
Wrong usage totals
- Überprüfe den Events-Tab, um die tatsächlich empfangenen Ereignisse zu zählen
- Verifiziere den Aggregationstyp (Count vs Sum)
- Stelle sicher, dass Werte für Sum/Max numerisch sind