Schnellstart
Leg ein Projekt an, kopiere seinen Ingest-Schlüssel, sende ein erstes Event und finde es im Dashboard.
Lyrelog ist ein gehosteter Dienst, im Early Access nur mit Einladung. Frag unter
lyrelog.com nach Zugang; mit dem Einladungslink legst du dein Konto an. Das
Dashboard findest du unter app.lyrelog.com, und Apps senden ihre Events
an https://ingest.lyrelog.com.
Benenne dein erstes Projekt
Nachdem du dein Konto angelegt hast, öffnet sich das Dashboard auf Welcome. Gib dem Projekt einen Namen und sag, woher seine Events kommen: eine iOS- oder macOS-App, eine Website, ein Node-, Python- oder Go-Service oder irgendetwas anderes über HTTP. Deine Auswahl bestimmt das Snippet, das du als Nächstes siehst, und die Plattform des Projekts.
Leg ein Projekt pro App an. Wenn die App auch eine Website und ein Backend hat, können alle an dasselbe Projekt senden (siehe Plattformen). Weitere Projekte legst du über Projects und New project an. Nur ein Inhaber der Organisation kann Projekte anlegen.
Kopiere den Ingest-Schlüssel
Direkt nach dem Anlegen des Projekts zeigt Lyrelog seinen Ingest-Schlüssel, lyr_ing_..., und die
Zeilen, die du in deine App einfügst. Kopiere den Schlüssel jetzt: Gespeichert wird nur ein
Hash davon, deshalb kann er nicht noch einmal angezeigt werden. Wenn du ihn verlierst, erstelle
auf der Seite API keys des Projekts einen neuen.
Der Ingest-Schlüssel kann nur Events senden, nie lesen, deshalb kann er bedenkenlos in einer App ausgeliefert werden. Siehe Schlüssel. Ein Backend sollte stattdessen mit einem Server-Schlüssel senden (Send events from a server auf der Seite API keys), dessen Events verifiziert sind.
Sende ein erstes Event
Die SDKs sind noch nicht veröffentlicht
Die SDKs für Swift, Android, React Native, Flutter, JavaScript, Python, Go und die JVM lassen sich noch nicht installieren. Sende dein erstes Event vorerst mit curl oder aus einer beliebigen Sprache über die HTTP-API.
Ersetze in einem macOS- oder Linux-Terminal (der Befehl nutzt uuidgen und date) lyr_ing_...
durch deinen Schlüssel und führe aus:
curl -X POST https://ingest.lyrelog.com/v1/events:batch \
-H "Authorization: Bearer lyr_ing_..." \
-H "Content-Type: application/x-ndjson" \
--data-binary "{\"event_id\":\"$(uuidgen | tr A-Z a-z)\",\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"message\":\"hello_lyrelog\",\"resource\":{\"environment\":\"production\"}}"Jedes Event braucht eine neue UUID als event_id und die aktuelle Zeit als ts. Ein Event, dessen
ts älter als die Aufbewahrungsdauer des Projekts ist oder mehr als einen Tag in der Zukunft
liegt, geht nicht verloren: Es wird mit dem Zeitpunkt seiner Ankunft gespeichert, und die
gesendete Zeit landet im Attribut _lyrelog_ts_clamped. Die Antwort sagt, wie viele Zeilen
gespeichert wurden:
{"accepted":1,"rejected":[]}Kommt etwas anderes zurück? Siehe Es kommen keine Events an.
Sieh zu, wie es ankommt
Die Seite Welcome wartet auf das erste Event und meldet, wenn es ankommt. Öffne von dort das
Projekt: Die Seite Events listet hello_lyrelog. Klick darauf, um das ganze Event zu sehen.
Nicht da?
Das Dashboard zeigt jeweils eine Umgebung und öffnet mit der Standardumgebung des Projekts,
production. Die SDKs senden development aus einem Build, den du in Xcode startest, aus dem
Simulator, von einer Seite auf localhost und aus Node, sofern nicht NODE_ENV=production
gesetzt ist. Deine ersten Events aus einem SDK liegen also unter development: Wähle diese Umgebung oder
All environments in der oberen Leiste. Der curl-Befehl oben setzt
"environment":"production"; ein Event ohne resource.environment wird ebenfalls als
production gespeichert. Siehe Umgebungen.
Lies es aus einem Skript (optional)
Wähle auf der Seite API keys des Projekts New key, setze What it can do auf
Read events und kopiere den Schlüssel lyr_read_.... Wenn deine letzte Anmeldung mehr als
10 Minuten zurückliegt, musst du dich zum Erstellen eines Lese-Schlüssels erneut anmelden. Bewahre
ihn auf einem Server auf: Er liest jedes Event des Projekts.
export LYRELOG_READ_KEY=lyr_read_...
curl -s -G https://app.lyrelog.com/v1/events \
-H "Authorization: Bearer $LYRELOG_READ_KEY" \
--data-urlencode "message=hello_lyrelog"Siehe die Read API.
Weiter
Apps
Web und Server
Alles andere
- Lerne, was ein gutes Event ausmacht: Events.
- Etwas funktioniert nicht: Es kommen keine Events an.