Es kommen keine Events an
Die üblichen Gründe, warum ein Event nicht auftaucht, und wie du herausfindest, welcher es ist.
Sende zuerst ein Event mit curl (siehe den Schnellstart). Die Antwort verrät dir das meiste von dem, was nicht stimmt.
| Was du siehst | Warum | Was zu tun ist |
|---|---|---|
200 mit "accepted":0 und einer Liste rejected | Jede Zeile sagt, warum sie abgelehnt wurde | Korrigiere das genannte Feld (siehe die häufigen Zeilenfehler). Sende abgelehnte Zeilen nie erneut. |
401 unknown or revoked key | Der Schlüssel ist falsch, wurde widerrufen oder ist kein Lyrelog-Schlüssel | Kopiere den Schlüssel erneut oder erstelle unter API keys einen neuen |
403 this key cannot write events | Es ist ein Lese-Schlüssel (Read events) | Nimm einen Schlüssel mit Send events (lyr_ing_) |
415 | Content-Type ist nicht application/x-ndjson | Setze den Header |
429 mit plan, limit und used | Das Monatskontingent des Free-Plans ist aufgebraucht | Die SDKs behalten die Events und senden sie, wenn der neue Monat beginnt. Siehe Pläne und Nutzung |
429 mit source_limit | Eine Adresse hat mit einem öffentlichen Schlüssel ihren Tagesanteil gesendet | Nimm auf einem Server einen Server-Schlüssel (lyr_srv_). Sonst geht es am nächsten UTC-Tag weiter. Siehe den Tagesanteil einer Adresse |
429 rate limit for this project | Mehr als 60.000 Events pro Minute | Warte die in Retry-After angegebene Zeit ab |
425 mit verification_required | Das Projekt akzeptiert von dieser Plattform nur verifizierte Events, und dieser Batch ist nicht verifiziert | Das SDK behält ihn und versucht es erneut. Builds, Simulatoren, Emulatoren und Geräte, die sich nicht ausweisen können, kommen nie durch: Schalte die Option in den Projekteinstellungen aus, solange du mit ihnen arbeitest. Siehe Verifizierte Events |
503 | Der Server ist ausgelastet oder erreicht kurz seinen Speicher nicht | Sende nach Retry-After dieselben Bytes erneut (die SDKs tun das) |
Ein 3xx | Der Endpoint ist falsch | Nimm https://ingest.lyrelog.com |
| Angenommen, aber nicht im Dashboard | Das Dashboard zeigt eine Umgebung: Builds, die du aus Xcode startest, der Simulator, Android-Debug-Builds, localhost und Node ohne NODE_ENV=production senden development | Wähle in der oberen Leiste development oder All environments und All platforms |
| Angenommen, aber zur falschen Zeit | Der Zeitstempel ts war älter als die Aufbewahrungsdauer oder lag mehr als einen Tag in der Zukunft, deshalb wurde das Event mit seiner Ankunftszeit gespeichert | Sieh dir das Attribut _lyrelog_ts_clamped an und sende die aktuelle Zeit |
| Gar nichts aus einer Swift-App | Das SDK sendet nichts, solange die Einwilligung .pending oder .denied ist | Siehe Einwilligung |
| Gar nichts aus einer Android-App | Das SDK sendet nichts, solange die Einwilligung PENDING oder DENIED ist, oder der Endpoint gehört nicht zu denen, die es akzeptiert | Siehe Einwilligung und In Entwicklung und Tests |
| Gar nichts aus einer React-Native- oder Flutter-App | Die Einwilligung ist pending oder denied, der Endpoint gehört nicht zu denen, die das native SDK akzeptiert, oder die App wurde nach dem Hinzufügen des Pakets nicht neu gebaut | Siehe Einwilligung für React Native und Flutter sowie bei Flutter In Entwicklung und Tests |
| Gar nichts von einem JVM-Server | Der Schlüssel ist leer (start gibt false zurück und tut nichts), oder der Prozess hat sich beendet, bevor der Shutdown-Hook senden konnte | Siehe Starten und Flush und Stopp |
| Events deines Servers im falschen Land | Das Land kommt von der Adresse des Absenders | Siehe Länder |
Was die SDKs melden
Jedes SDK meldet seine eigenen Probleme (ein falscher Endpoint, ein abgelehnter Schlüssel, ein verworfener Batch), ohne deine App abstürzen zu lassen:
| SDK | Wo du nachsiehst |
|---|---|
| Swift | Im Unified Log, Subsystem com.lyrelog.sdk: Console.app oder die Konsole von Xcode |
| Android | Logcat, Tag Lyrelog, auf Debug-Level |
| React Native | Im Log des nativen SDKs: unter iOS im Unified Log (Konsole von Xcode), unter Android in Logcat, wie oben. Ein fehlender Schlüssel oder ein fehlendes natives Modul ergibt in Entwicklungs-Builds ein einzelnes console.warn in Metro |
| Flutter | Im Log des nativen SDKs: unter iOS im Unified Log (Konsole von Xcode), unter Android in Logcat, wie oben. Mit mirrorToConsole: true wird dort zusätzlich jedes Event ausgegeben |
| JavaScript | console.warn-Zeilen, die mit [lyrelog] beginnen |
| Python | Der Logger lyrelog (Standard-logging) |
| Go | Config.ErrorLog, sonst einmalig das erste Problem auf stderr |
| JVM | stderr, Zeilen, die mit lyrelog: beginnen, einmal pro Prozess, oder Configuration.diagnostics |
Kommst du nicht weiter?
Schreib an hello@lyrelog.com mit der Projekt-ID (in Project settings, Details) und der Zeit, zu der du das Event gesendet hast. Schick nie einen Schlüssel mit.