Dokumentation

Vom ersten Event zum ersten Dashboard.

Sie brauchen kein Data-Engineering-Projekt, um loszulegen.Legen Sie eine Organisation an, definieren Sie einen Event-Bucket, senden Sie ein paar Daten und bauen Sie Ihre erste Abfrage.

01

Konto anlegen

Legen Sie ein Konto und Ihre Organisation an.

Das erste Mitglied der Organisation wird Administrator und kann den Rest des Teams einladen.

Einstellungen → Organisation enthält Firmenname, Rechnungs-E-Mail und Anschrift. Unter Einstellungen → Marke legen Sie Logo und Farben fest, die Ihre Kunden auf geteilten und eingebetteten Dashboards sehen.

Das Registrierungsformular von Event Horizon DataDer Reiter Organisation in den Einstellungen, mit Firmenname, E-Mail und Anschrift

02

Daten definieren

Legen Sie einen Event-Bucket aus einem Beispiel-Event an oder definieren Sie seine Felder selbst.

Legen Sie Zeitstempel, Dimensionen und Kennzahlen fest.

Event Horizon nutzt diese Struktur, um die Daten abfragbar zu machen.

Ein Event-Bucket legt zugleich fest, was Sie senden und wie Sie es auswerten. Fügen Sie ein Beispielereignis ein, und die Spalten werden Ihnen vorgeschlagen, mit Typ, Einordnung und Begründung; Sie bestätigen oder korrigieren. Bis dahin wird nichts angelegt. Sie können sie auch von Hand deklarieren und für jede wählen, was sie ist:

Der Buckets-Bereich mit den Event-Buckets eines Arbeitsbereichs
timestamp_keyWann das Ereignis stattfand. Pflichtfeld, und die Grundlage jedes Zeitfilters.
dimensionWonach Sie gruppieren und filtern: Land, Kampagne, Abo-Tarif. Der Wert wird so gespeichert, wie er zum Zeitpunkt des Ereignisses war, also liest sich 2020 weiterhin so, wie das Unternehmen 2020 hieß.
metricWas Sie summieren oder mitteln: Umsatz, Dauer, Menge.

Geben Sie die Zeitzone an, aus der Ihre Daten stammen. Gespeichert wird stets in UTC, und eine nicht angegebene Zone gilt als UTC. Eine falsch gelesene Stunde lässt sich nachträglich nicht korrigieren.

Zeitstempel können ein ISO-8601-Text sein oder eine reine Epoch-Zahl in Sekunden oder Millisekunden. Die Einheit ergibt sich aus der Größenordnung, `1787232000` und `1787232000000` sind derselbe Zeitpunkt. Eine Zahl, die als Zeichenkette ankommt, wird genauso gelesen.

03

Quelle verbinden

Senden Sie Daten per Webhook, Änderungsstrom einer Datenbank, API-Workflow oder über eine andere unterstützte Aufnahmemethode.

Starten Sie den Workflow. Den Weg der Datenaufnahme übernimmt Event Horizon.

Der kürzeste Weg ist ein Webhook, und ein neuer Workflow öffnet bereits mit einem, der an einen Loader angeschlossen ist. Kommen Ihre Daten von woanders, tauscht die Leiste über der Arbeitsfläche ihn gegen eine andere gängige Form: eine Datenbank, der wir bei jeder Änderung folgen, oder eine API, die wir planmäßig aufrufen. Speichern Sie, und die Adresse wird für Sie erzeugt und ist nicht editierbar, da sie sich aus Ihrer Organisation und diesem Knoten ableitet und daher weder kollidieren noch gefälscht werden kann.

Die Workflow-Liste, in der Ingestion-Pipelines gebaut werden

Wählen Sie im Knoten-Inspektor Geheimnis verwalten → Erzeugen. Der Schlüssel wird einmalig angezeigt und nur als Hash gespeichert, und selbst wir können ihn nicht wiederherstellen. Geht er verloren, erzeugen Sie einen neuen. Senden Sie dann an die Adresse im URL-Feld des Knotens:

curl -X POST "https://ingest.eventhorizondata.com/webhooks/<org>/<node>" \
  -H "Authorization: Bearer <key>" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"evt-1","value":42}'

Beachten Sie den Host ingest. Die Ingestion hat einen eigenen Eingang, getrennt von der Anwendung; eine Anfrage an die Anwendungsdomain wird abgewiesen.

Starten Sie den Workflow. Ein Webhook-Knoten nimmt nur Datenverkehr an, solange sein Workflow läuft.

Senden Sie eine `event_id` im Body oder einen `Idempotency-Key`-Header, und eine Wiederholung derselben Kennung innerhalb von fünf Minuten wird verworfen statt doppelt gespeichert. Ohne beides gilt jede Anfrage als neu, denn wir raten lieber nicht, was zwei Ihrer Ereignisse zu einem macht.

Ein 401 bedeutet eines von zwei Dingen: Der Authorization-Header fehlt, oder der Schlüssel passt nicht. Ein Knoten, dessen Schlüssel nie erzeugt wurde, weist grundsätzlich alles ab.

04

Daten ansehen

Öffnen Sie den Bereich Erkunden und wählen Sie:

Was ist passiert?
Kennzahl.
Wem oder wo?
Dimension.
Wann?
Zeitraum.

Dann bauen Sie die Abfrage visuell. Ganz ohne SQL.

Der Query-Explorer braucht kein SQL: Wählen Sie einen Event-Bucket, eine Kennzahl, etwas zum Gruppieren und einen Zeitraum. Sie können die Frage auch mit Worten schreiben und auf Ask drücken: Der Entwurf kommt ausgefüllt zurück, mit einer Notiz dazu, was er abgedeckt und was er ausgelassen hat. Nichts läuft, bevor Sie es angesehen haben. Dashboards entstehen genauso und lassen sich per Link teilen oder mit Ihrer Marke in Ihr eigenes Produkt einbetten.

Der Query-Explorer, mit dem Ask-Feld über einer visuell gebauten Abfrage

05

Dashboard bauen

Machen Sie die Fragen, die Ihnen wichtig sind, zu Dashboard-Widgets. Filtern Sie die Ergebnisse und gehen Sie ins Detail.

Teilen Sie das Dashboard oder betten Sie es in Ihr eigenes Produkt ein.

06

Zugriff steuern

Laden Sie Ihr Team ein. Vergeben Sie Rollen. Nutzen Sie Zeilenbereiche, wenn jemand nur einen Teil der Daten sehen soll.

Einstellungen → Team lädt Personen ein, Rollen legt fest, was sie dürfen, und Zeilenbereiche beschränken jemanden auf einen Teil der Daten, etwa einen Kunden, der nur seine eigene Region sehen soll.

Der Reiter Team in den Einstellungen mit den Mitgliedern und ihren Rollen

Senden Sie Ihr erstes Event.

Legen Sie ein Konto an und kommen Sie in Minuten von Rohdaten zu einem Dashboard.