Nenhum evento chega
Os motivos mais comuns para um evento não aparecer, e como descobrir qual é o seu caso.
Primeiro, envie um evento com curl (veja o Início rápido). A resposta já diz quase tudo o que está errado.
| O que você vê | Por quê | O que fazer |
|---|---|---|
200 com "accepted":0 e uma lista rejected | Cada linha diz por que foi recusada | Corrija o campo indicado (veja os erros de linha mais comuns). Nunca reenvie linhas rejeitadas. |
401 unknown or revoked key | A chave está errada, foi revogada ou não é uma chave do Lyrelog | Copie a chave de novo ou crie uma nova em API keys |
403 this key cannot write events | É uma chave Read events | Use uma chave Send events (lyr_ing_) |
415 | O Content-Type não é application/x-ndjson | Defina o header |
429 com plan, limit e used | O mês do plano Free se esgotou | Os SDKs guardam os eventos e os enviam quando o mês virar. Veja Planos e uso |
429 com source_limit | Um endereço enviou a sua cota do dia com uma chave pública | De um servidor, use uma chave de servidor (lyr_srv_). Caso contrário, os eventos voltam a ser aceitos no dia seguinte (UTC). Veja a cota diária de um endereço |
429 rate limit for this project | Mais de 60.000 eventos por minuto | Espere o Retry-After |
425 com verification_required | O projeto aceita só eventos verificados daquela plataforma, e este lote não é verificado | O SDK guarda o lote e tenta de novo. Builds, simuladores, emuladores e dispositivos que não conseguem provar quem são nunca passam: desative a opção em Project settings enquanto eles forem importantes. Veja Eventos verificados |
503 | O servidor está ocupado ou não consegue acessar o armazenamento por um momento | Reenvie os mesmos bytes depois do Retry-After (os SDKs fazem isso) |
Um 3xx | O endpoint está errado | Use https://ingest.lyrelog.com |
| Aceito, mas não aparece no painel | O painel mostra um ambiente por vez: builds que você roda pelo Xcode, o simulador, builds de debug do Android, localhost e o Node sem NODE_ENV=production enviam development | Escolha development ou All environments na barra superior, e All platforms |
| Aceito, mas no horário errado | O ts era mais antigo que a retenção ou estava mais de um dia no futuro, então o evento foi armazenado com o horário de chegada | Veja o atributo _lyrelog_ts_clamped e envie o horário atual |
| Nada chega de um app Swift | O SDK não envia nada enquanto o consentimento for .pending ou .denied | Veja Consentimento |
| Nada chega de um app Android | O SDK não envia nada enquanto o consentimento for PENDING ou DENIED, ou o endpoint não é um que ele aceita | Veja Consentimento e Em desenvolvimento e testes |
| Nada chega de um app React Native ou Flutter | O consentimento é pending ou denied, o endpoint não é um que o SDK nativo aceita, ou o app não foi recompilado depois de adicionar o pacote | Veja Consentimento para React Native e Flutter, e Em desenvolvimento e testes do Flutter |
| Nada chega de um servidor JVM | A chave está vazia (start retorna false e não faz nada), ou o processo terminou antes que o shutdown hook conseguisse enviar | Veja Primeiros passos e Esvaziar a fila e parar |
| Eventos do seu servidor no país errado | O país vem do endereço de quem envia | Veja Países |
O que os SDKs dizem
Cada SDK informa os próprios problemas (um endpoint errado, uma chave recusada, um lote descartado) sem derrubar o seu app:
| SDK | Onde olhar |
|---|---|
| Swift | O unified log, subsystem com.lyrelog.sdk: Console.app ou o console do Xcode |
| Android | Logcat, tag Lyrelog, no nível debug |
| React Native | O log do SDK nativo: o unified log no iOS (o console do Xcode), o logcat no Android, como acima. Uma chave ou um módulo nativo ausente gera um único console.warn em builds de desenvolvimento, no Metro |
| Flutter | O log do SDK nativo: o unified log no iOS (o console do Xcode), o logcat no Android, como acima. mirrorToConsole: true também imprime ali cada evento |
| JavaScript | Linhas de console.warn que começam com [lyrelog] |
| Python | O logger lyrelog (o logging padrão) |
| Go | Config.ErrorLog; se não houver, o primeiro problema, uma vez, no stderr |
| JVM | A saída de erro padrão, linhas que começam com lyrelog: , uma vez por processo, ou Configuration.diagnostics |
Ainda sem solução?
Escreva para hello@lyrelog.com com o id do projeto (em Project settings, Details) e o horário em que você enviou o evento. Nunca envie uma chave.