Kontingente & Überschreitungen

Jeder Unseenr-Plan beinhaltet ein monatliches Event-Kontingent. Zu verstehen wie Kontingente funktionieren, hilft dir Kosten zu verwalten und unerwartete Blockierungen zu vermeiden.

Wie Kontingente funktionieren

Dein Event-Kontingent wird auf einem 30-Tage-Abrechnungszyklus zurückgesetzt. Das Zyklusstartdatum wird bei der ersten Anmeldung (für bezahlte Pläne) oder bei der Organisationserstellung (für den kostenlosen Plan) festgelegt.

Was als Event zählt

• Error Events (Exceptions)
• Transaktionen (Performance-Daten)
• Log-Envelopes

Was NICHT gegen das Event-Kontingent zählt

• Session Replays (separates Replay-Kontingent)
• Uptime Monitor Checks
• Heartbeat Pings

Kontingent-Durchsetzung

Free und Starter Pläne

Bei Überschreitung des Event-Kontingents auf Free oder Starter werden neue Events hart blockiert. Der Ingest-Endpoint gibt HTTP 429 mit { "error": "quota_exceeded" } zurück. Keine Overage-Abrechnung verfügbar.

Pro, Business, Scale und Platform Pläne

Bei Kontingentüberschreitung auf bezahlten Plänen:

• Wenn Overage aktiviert (Standard für Pro+): Events werden weiterhin akzeptiert und als Overage abgerechnet
• Wenn Overage deaktiviert: Events werden hart blockiert, wie bei Free/Starter

Organisations-Owner können Overage in den Billing-Einstellungen ein-/ausschalten.

Overage-Tarife

Plan	Tarif pro 100.000 Events
Pro	2,00 EUR
Business	1,50 EUR
Scale	2,50 EUR
Platform	3,00 EUR

Overage wird täglich an Stripe gemeldet und am Ende des Abrechnungszyklus abgerechnet.

Kontingent-Warnungen

Unseenr warnt dich bevor du dein Limit erreichst:

1. Bei 75% Verbrauch: Ein X-Unseenr-Quota-Warning: true Header wird zu Ingest-Antworten hinzugefügt
2. Bei 75% Verbrauch: Ein gelbes Banner erscheint im Dashboard
3. Bei 75% Verbrauch: Eine einmalige Warn-E-Mail wird an den Organisations-Owner gesendet

Replay-Kontingent

Session Replays haben ein separates Kontingent von Events:

Plan	Replays / Monat
Free	500
Starter	5.000
Pro	50.000
Business	500.000
Scale	1.000.000
Platform	5.000.000

Wenn das Replay-Kontingent überschritten wird, werden neue Replay-Aufzeichnungen stillschweigend verworfen (HTTP 200 wird zurückgegeben, aber das Replay wird nicht gespeichert).

Abrechnungszyklus-Reset

Kontingente werden automatisch um 00:05 UTC am 30. Tag deines Abrechnungszyklus zurückgesetzt. Der Reset:

• Setzt Event- und Replay-Zähler auf Null
• Setzt das Kontingent-Warn-E-Mail-Flag zurück
• Löscht die Redis-Kontingent-Keys

Verbrauch überwachen

• Dashboard: Die Usage-Seite zeigt Echtzeit-Event- und Replay-Verbrauch mit Trendgrafiken
• Ingest-Header: Jede Ingest-Antwort enthält X-Unseenr-Usage (z.B. 4821/5000) und X-Unseenr-Usage-Percent
• Billing-Seite: Zeigt aktuellen Zyklusverbrauch, prognostizierte Overage und Historie