Der Aggregationstyp bestimmt, wie die eingehenden Events zu einem Abrechnungswert zusammengefasst werden.
Übersicht
| Typ | Braucht Feld? | Beschreibung |
|---|
| Anzahl | Nein | Zählt die Anzahl der Events |
| Summe | Ja | Addiert die Werte eines Feldes |
| Maximum | Ja | Nimmt den höchsten Wert |
| Minimum | Ja | Nimmt den niedrigsten Wert |
| Durchschnitt | Ja | Berechnet den Mittelwert |
| Eindeutig | Ja | Zählt einzigartige Werte |
| Letzter Wert | Ja | Nimmt den zuletzt gemeldeten Wert |
Anzahl (Count)
Zählt, wie oft ein Event aufgetreten ist. Kein Feld nötig.
Beispiel: API-Aufrufe zählen
| Event | Aggregation |
|---|
api_call | +1 |
api_call | +1 |
api_call | +1 |
| Ergebnis | 3 Aufrufe |
- API-Aufrufe
- Logins
- Transaktionen
- Nachrichten gesendet
Summe (Sum)
Addiert die Werte eines bestimmten Feldes.
Beispiel: Token-Verbrauch summieren (Feld: tokens)
| Event | tokens | Aggregation |
|---|
ai_request | 150 | +150 |
ai_request | 300 | +300 |
ai_request | 50 | +50 |
| Ergebnis | | 500 Tokens |
- Token-/Credit-Verbrauch
- Datenvolumen (GB)
- Transaktionsbeträge
- E-Mails versendet
Maximum (Max)
Nimmt den höchsten Wert im Abrechnungszeitraum.
Beispiel: Maximale gleichzeitige Nutzer (Feld: active_users)
| Event | active_users | Aggregation |
|---|
user_count | 10 | max = 10 |
user_count | 25 | max = 25 |
user_count | 18 | max = 25 |
| Ergebnis | | 25 Nutzer |
- Gleichzeitige Nutzer (Seats)
- Peak-Speicherverbrauch
- Maximale Bandbreite
- Höchste CPU-Auslastung
Minimum (Min)
Nimmt den niedrigsten Wert im Abrechnungszeitraum.
Beispiel: Minimaler Kontostand (Feld: balance)
| Event | balance | Aggregation |
|---|
balance_check | 1000 | min = 1000 |
balance_check | 500 | min = 500 |
balance_check | 750 | min = 500 |
| Ergebnis | | 500 |
- Mindestguthaben
- Niedrigste Verfügbarkeit
- Minimale Ressourcennutzung
Durchschnitt (Average)
Berechnet den Mittelwert aller gemeldeten Werte.
Beispiel: Durchschnittliche Response Time (Feld: response_ms)
| Event | response_ms | Aggregation |
|---|
api_call | 100 | |
api_call | 150 | |
api_call | 200 | |
| Ergebnis | | 150 ms |
- Durchschnittliche Verarbeitungszeit
- Mittlere Dateigröße
- Durchschnittlicher Verbrauch pro Request
Eindeutig (Unique Count)
Zählt, wie viele unterschiedliche Werte ein Feld hatte.
Beispiel: Aktive Nutzer im Monat (Feld: user_id)
| Event | user_id | Aggregation |
|---|
login | user-A | 1 eindeutig |
login | user-B | 2 eindeutig |
login | user-A | 2 eindeutig (bereits gezählt) |
login | user-C | 3 eindeutig |
| Ergebnis | | 3 aktive Nutzer |
- Monthly Active Users (MAU)
- Eindeutige Kunden
- Verschiedene verwendete Features
- Anzahl verschiedener Produkte
Letzter Wert (Latest)
Nimmt den zuletzt gemeldeten Wert. Setzt sich nicht zurück nach Abrechnung.
Beispiel: Aktueller Speicherverbrauch (Feld: storage_gb)
| Event | storage_gb | Aggregation |
|---|
storage_check | 50 | letzter = 50 |
storage_check | 55 | letzter = 55 |
storage_check | 52 | letzter = 52 |
| Ergebnis | | 52 GB |
- Aktueller Speicherverbrauch
- Aktuelle Seat-Anzahl
- Lizenzstand
- Persistente Werte, die nicht summiert werden
Wichtig: Bei “Letzter Wert” wird der Wert nicht nach jeder Abrechnung auf 0 zurückgesetzt. Der letzte gemeldete Wert bleibt bestehen.
Vergleich: Wann welchen Typ?
| Use Case | Aggregation | Feld |
|---|
| API-Calls zählen | Anzahl | - |
| Token summieren | Summe | tokens |
| Speicher (aktuell) | Letzter Wert | storage_gb |
| Speicher (Peak) | Maximum | storage_gb |
| Aktive User (unique) | Eindeutig | user_id |
| Seats (Peak) | Maximum | active_seats |
| Response Time (Ø) | Durchschnitt | response_ms |
