Hilfe & Wissen 📘 Events Query Dokumentation

📘 Events Query Dokumentation

Diese Dokumentation erklärt, wie man Ereignisse mithilfe einer flexiblen, filterbaren Abfragesyntax abfragt. Sie beschreibt außerdem verfügbare Parameter, Gruppierungsoptionen und Aggregationsmethoden.

🔍 So fragst du Ereignisse ab

Um Ereignisse abzufragen, verwende folgende Syntax:

query=events{<Filter>}

✅ Beispielabfragen

# Ereignisse abfragen, bei denen die Aktion "open" ist und die mailing_id 31699 ist
query=events{action="open", mailing_id="31699"}

# Alle Aktionen für eine bestimmte mailing_id abfragen
query=events{action="*", mailing_id="31699"}

🪰 Verfügbare Filterparameter

Du kannst Ereignisse mit den folgenden Parametern filtern:

Parameter	Typ	Beschreibung	Beispiel
`mailing_id`	`int`	ID der Aussendung oder Nachricht	`31699`
`created`	`str`	Zeitstempel, wann das Ereignis erstellt wurde	`"2025-01-15T12:34:56"`
`ip_hash`	`str`	Gehashte IP-Adresse (MD5)	`"d41d8cd98f00b204e9800998ecf8427e"`
`category`	`str`	Ereigniskategorie	`"KJMTrack"`
`action`	`str`	Ereignistyp (z. B. open, click)	`"open"`
`label`	`str`	Zusätzliches Label, das dem Ereignis zugeordnet ist	`"cta-1"`
`value`	`int`	Numerischer Wert des Labels (falls zutreffend)	`1`
`user_id`	`int`	ID des Benutzers, dem das Ereignis zugeordnet ist	`7890`
`domain`	`str`	Domain der E-Mail des Benutzers, kleingeschrieben	`"example.com"`
`age_range`	`str`	Altersgruppe des Benutzers (basierend auf Geburtsdatum)	`"25-34"`
`click_url`	`str`	Klick-URL (nur bei Klick-Ereignissen in der Kategorie KJMTrack)	`"https://example.com/offer"`
`__from`	`str`	Startzeitpunkt für den Filterzeitraum	`"2025-01-01T00:00:00"`
`__to`	`str`	Endzeitpunkt für den Filterzeitraum	`"2025-01-31T23:59:59"`

📊 Gruppierung und Aggregation

Du kannst Ereignisse ähnlich wie bei Prometheus-Abfragen gruppieren und aggregieren.

📉 Unterstützte Aggregationen

count(events) – Gesamtanzahl der Ereignisse
sum(events) – Gesamtwert (wenn value numerisch ist)

🧩 Gruppierung

Verwende by (<Felder>), um die Ergebnisse zu gruppieren:

# Alle Ereignisse nach Aktion und mailing_id gruppiert zählen
count(events) by (action, mailing_id)

# Wert-Feld für Klick-Ereignisse nach Domain summieren
sum(events{action="click"}) by (domain)

🕓 Zeitbereich filtern

Um Ereignisse nach Zeit zu filtern, verwende __from und __to:

# Ereignisse zwischen zwei Zeitpunkten
query=events{__from="2025-01-01T00:00:00", __to="2025-01-31T23:59:59"}

🧪 Tipps

Verwende action="*", um alle Aktionen einzuschließen.
Du kannst beliebig viele Filter innerhalb von {} kombinieren.
Wenn keine Gruppierung angegeben ist, wird die Aggregation global (für alle passenden Ereignisse) durchgeführt.