Aucun événement n'arrive
Les raisons habituelles pour lesquelles un événement n'apparaît pas, et comment savoir laquelle s'applique.
Commencez par envoyer un événement avec curl (voir le Démarrage rapide). La réponse vous dit l'essentiel de ce qui ne va pas.
| Ce que vous voyez | Pourquoi | Que faire |
|---|---|---|
200 avec "accepted":0 et une liste rejected | Chaque ligne indique pourquoi elle a été refusée | Corrigez le champ indiqué (voir les erreurs de ligne courantes). Ne renvoyez jamais les lignes refusées. |
401 unknown or revoked key | La clé est fausse, a été révoquée, ou n'est pas une clé Lyrelog | Recopiez la clé, ou créez-en une nouvelle sur API keys |
403 this key cannot write events | C'est une clé Read events | Utilisez une clé Send events (lyr_ing_) |
415 | Content-Type n'est pas application/x-ndjson | Définissez le header |
429 avec plan, limit et used | Le quota mensuel de l'offre Free est épuisé | Les SDK gardent les événements et les envoient au changement de mois. Voir Offres et consommation |
429 avec source_limit | Une adresse a épuisé son quota journalier avec une clé publique | Depuis un serveur, utilisez une clé serveur (lyr_srv_). Sinon, les événements reprennent le jour UTC suivant. Voir le quota journalier d'une adresse |
429 rate limit for this project | Plus de 60 000 événements par minute | Attendez Retry-After |
425 avec verification_required | Le projet n'accepte que des événements vérifiés de cette plateforme, et ce lot n'est pas vérifié | Le SDK le garde et réessaie. Les builds, simulateurs, émulateurs et appareils qui ne peuvent pas prouver leur authenticité ne passent jamais : désactivez l'option dans Project settings tant qu'ils comptent. Voir Événements vérifiés |
503 | Le serveur est occupé ou n'arrive momentanément pas à joindre son stockage | Renvoyez les mêmes octets après Retry-After (les SDK le font) |
Un 3xx | L'endpoint est faux | Utilisez https://ingest.lyrelog.com |
| Accepté, mais absent du tableau de bord | Le tableau de bord affiche un seul environnement : les builds lancés depuis Xcode, le simulateur, les builds Android de debug, localhost et Node sans NODE_ENV=production envoient development | Choisissez development ou All environments dans la barre du haut, et All platforms |
| Accepté, mais à la mauvaise heure | Le ts était plus ancien que la durée de conservation ou en avance de plus d'un jour : il a donc été stocké à son heure d'arrivée | Regardez l'attribut _lyrelog_ts_clamped, et envoyez l'heure actuelle |
| Rien du tout depuis une app Swift | Le SDK n'envoie rien tant que le consentement est .pending ou .denied | Voir Consentement |
| Rien du tout depuis une app Android | Le SDK n'envoie rien tant que le consentement est PENDING ou DENIED, ou l'endpoint n'est pas accepté par le SDK | Voir Consentement et En développement et en test |
| Rien du tout depuis une app React Native ou Flutter | Le consentement est pending ou denied, l'endpoint n'est pas accepté par le SDK natif, ou l'app n'a pas été recompilée après l'ajout du package | Voir Consentement pour React Native et Flutter, et la section En développement et en test de Flutter |
| Rien du tout depuis un serveur JVM | La clé est vide (start renvoie false et ne fait rien), ou le processus s'est terminé avant que le shutdown hook ait pu envoyer | Voir Démarrage et Vider la file et arrêter |
| Des événements de votre serveur dans le mauvais pays | Le pays vient de l'adresse de l'expéditeur | Voir Pays |
Ce que disent les SDK
Chaque SDK signale ses propres problèmes (un mauvais endpoint, une clé refusée, un lot abandonné) sans faire planter votre app :
| SDK | Où regarder |
|---|---|
| Swift | Le journal unifié, sous-système com.lyrelog.sdk : Console.app ou la console d'Xcode |
| Android | Logcat, tag Lyrelog, au niveau debug |
| React Native | Le log du SDK natif : le journal unifié sur iOS (console d'Xcode), logcat sur Android, comme ci-dessus. Une clé ou un module natif manquant donne un console.warn dans les builds de développement, dans Metro |
| Flutter | Le log du SDK natif : le journal unifié sur iOS (console d'Xcode), logcat sur Android, comme ci-dessus. mirrorToConsole: true y affiche aussi chaque événement |
| JavaScript | Des lignes console.warn qui commencent par [lyrelog] |
| Python | Le logger lyrelog (module standard logging) |
| Go | Config.ErrorLog, sinon le premier problème, une seule fois, sur stderr |
| JVM | La sortie d'erreur standard, des lignes qui commencent par lyrelog: , une fois par processus, ou Configuration.diagnostics |
Toujours bloqué ?
Écrivez à hello@lyrelog.com avec l'id du projet (dans Project settings, Details) et l'heure à laquelle vous avez envoyé l'événement. N'envoyez jamais de clé.